diff --git a/docs/examples/index.rst b/docs/examples/index.rst new file mode 100644 index 00000000..2f0b5f83 --- /dev/null +++ b/docs/examples/index.rst @@ -0,0 +1,9 @@ +Dust3D Modeling Examples +-------------------------- + +.. toctree:: + :maxdepth: 2 + :caption: Contents: + :glob: + + modeling-ant/* \ No newline at end of file diff --git a/docs/examples/modeling-ant/index.rst b/docs/examples/modeling-ant/index.rst new file mode 100644 index 00000000..24d5ddcd --- /dev/null +++ b/docs/examples/modeling-ant/index.rst @@ -0,0 +1,48 @@ +Modeling Ant using Dust3D +--------------------------- + +Prepare Reference Sheet +======================= +You can start modeling without any reference, however, if you model on top of a turnaround reference sheet, the final result would be better, it also ease the progress of modeling. +The recommended features for reference sheet in Dust3D: + +* Only one image, but include at least two profiles in the image, one for front view, one for side view. And align horizontally with the same height. +* Image size less than 1MB. Because if you save the document, the reference image will also be included in the .ds3 file. +* No blur filter, make a clean sheet, Dust3D will blur it for you when you load the image. + +.. image:: https://raw.githubusercontent.com/huxingyi/dust3d/master/docs/examples/modeling-ant/ant-reference-from-antweb-org.jpg + +The above reference is a good example. The raw picture comes from https://www.antweb.org/bigPicture.do?name=casent0103346&shot=d&number=1 Composed in GIMP. + +Modeling in Dust3D +===================== + +#. Load Reference Sheet from Menu: File > Change Turnaround... +#. Click Plus(+) Icon from Tool Box +#. Place node on the canvas acording to the reference background. +#. Use Mouse Wheel to Adjust the radius of the node, hold shift to slow down the scroll scale. +#. Use the Parts List panel to toggle the settings to make you can easily select or see nodes. +#. Use Mouse Middle button pluse Shift key to rotate and move around the Rendered Model. + +.. image:: https://raw.githubusercontent.com/huxingyi/dust3d/master/docs/examples/modeling-ant/modeling-ant-dust3d-screenshot.png + +Export Mesh +=============== + +After finished modeling, Export the result mesh from Menu: File > Export... +Only supports Wavefront(.obj) format in the current stage. + +Download +============== + +You can download all the resources including the full Dust3D Document from the following links. + +#. https://raw.githubusercontent.com/huxingyi/dust3d/master/docs/examples/modeling-ant/ant-reference-from-antweb-org.xcf +#. https://raw.githubusercontent.com/huxingyi/dust3d/master/docs/examples/modeling-ant/ant-reference-from-antweb-org.jpg +#. https://raw.githubusercontent.com/huxingyi/dust3d/master/docs/examples/modeling-ant/ant.ds3 + +Turnaround Reference Resource +============================== +#. https://www.antweb.org/ + +(If you know more resource, please edit this page in Github to share, thanks.) \ No newline at end of file diff --git a/docs/get_started.rst b/docs/get_started.rst index 7ede191c..254bc9d8 100644 --- a/docs/get_started.rst +++ b/docs/get_started.rst @@ -5,6 +5,7 @@ Getting Started :maxdepth: 2 :caption: Contents: :glob: - + + install interface/* shortcuts \ No newline at end of file diff --git a/docs/index.rst b/docs/index.rst index 834dc707..afc811c2 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -12,6 +12,7 @@ Dust3D Reference Guide :glob: get_started + examples/index.rst for_developers Indices and tables diff --git a/docs/install.rst b/docs/install.rst new file mode 100644 index 00000000..07f662a4 --- /dev/null +++ b/docs/install.rst @@ -0,0 +1,21 @@ +Download and Install Dust3D +----------------------------- +Dust3D haven't yet been released, however, you can try the latest unstable version, + +* For Windows: + + https://github.com/huxingyi/dust3d/releases/download/unstable/dust3d_unstable_x86.zip + + No need to install, unzip and run the exe. + +* For Mac OS X: + + https://github.com/huxingyi/dust3d/releases/download/unstable/dust3d_unstable.dmg + +* Other platform, please build from source: + + https://github.com/huxingyi/dust3d + +Found BUG? + +If you have any thoughts while using Dust3D, please don't hesitate to share by drop it here https://github.com/huxingyi/dust3d/issues \ No newline at end of file