[Bf-docboard-svn] bf-manual: [9288] trunk/blender_docs/manual/images: Merge branch 'blender-3.2-release'

Aaron Carlisle noreply at blender.org
Thu May 19 04:52:56 CEST 2022 

Revision: 9288
          https://developer.blender.org/rBM9288
Author:   Blendify
Date:     2022-05-19 04:52:56 +0200 (Thu, 19 May 2022)
Log Message:
-----------
Merge branch 'blender-3.2-release'

Modified Paths:
--------------
    trunk/blender_docs/manual/addons/mesh/3d_print_toolbox.rst

Added Paths:
-----------
    trunk/blender_docs/manual/images/3dprint_checks.jpg
    trunk/blender_docs/manual/images/3dprint_degenerate.jpg
    trunk/blender_docs/manual/images/3dprint_distorted.jpg
    trunk/blender_docs/manual/images/3dprint_intersect.jpg
    trunk/blender_docs/manual/images/3dprint_overhang.jpg
    trunk/blender_docs/manual/images/3dprint_solid.jpg
    trunk/blender_docs/manual/images/3dprint_suzanne.jpg
    trunk/blender_docs/manual/images/3dprint_thickness.jpg

Property Changed:
----------------
    trunk/blender_docs/

Index: trunk/blender_docs
===================================================================
--- trunk/blender_docs	2022-05-19 01:09:54 UTC (rev 9287)
+++ trunk/blender_docs	2022-05-19 02:52:56 UTC (rev 9288)

Property changes on: trunk/blender_docs
___________________________________________________________________
Modified: svn:mergeinfo
## -2,4 +2,4 ##
 /branches/blender-2.93-release/blender_docs:7959-8113
 /branches/blender-3.0-release/blender_docs:8543-9034
 /branches/blender-3.1-release/blender_docs:8904-9230
-/branches/blender-3.2-release/blender_docs:9236-9283
\ No newline at end of property
+/branches/blender-3.2-release/blender_docs:9236-9287
\ No newline at end of property
Modified: trunk/blender_docs/manual/addons/mesh/3d_print_toolbox.rst
===================================================================
--- trunk/blender_docs/manual/addons/mesh/3d_print_toolbox.rst	2022-05-19 01:09:54 UTC (rev 9287)
+++ trunk/blender_docs/manual/addons/mesh/3d_print_toolbox.rst	2022-05-19 02:52:56 UTC (rev 9288)
@@ -16,7 +16,7 @@
 ============
 
 - This add-on is bundled with Blender.
-- Open Blender and go to Preferences then the Add-ons tab.
+- Open Blender and go to Preferences, then the Add-ons tab.
 - Click Mesh then 3D Print Toolbox to enable the script.
 
 
@@ -23,4 +23,140 @@
 Description
 ===========
 
-- To Do
+Blender can be used to created meshes for 3D printing.
+Meshes exported from Blender are usually imported into a piece of software
+takes the mesh and "slices" it into paths that the 3D printer can execute.
+An example of such `Slicer <https://en.wikipedia.org/wiki/Slicer_(3D_printing)>`__
+software is `Cura <https://github.com/Ultimaker/Cura>`__.
+
+In order to correctly slice a mesh, it needs to be "watertight",
+meaning that the surface is closed everywhere. Additionally,
+there should be no edges or faces sticking out.
+3D Print Toolbox helps you analyze problems in your mesh that could cause slicing issues.
+
+It can be found in :menuselection:`3D Viewport --> Sidebar --> 3D-Print`, when a mesh is selected.
+
+--------------
+
+Analyze
+=======
+
+Statistics
+----------
+
+By clicking either `Volume` or `Area`, the volume or area of the mesh is calculated and shown.
+
+
+Checks
+------
+
+.. figure:: /images/3dprint_checks.jpg
+   :align: right
+
+   The Checks panel.
+
+A number of different checks can be performed to analyze
+in which ways your mesh might be invalid for use with a Slicer.
+
+Upon execution of one of the checks, the `Result` field shows which, if any, parts of your mesh are invalid.
+
+When in `Edit Mode`, clicking these results selects these parts of your mesh.
+You can use `View Selected` :kbd:`\`` to focus on these parts.
+
+Although Slicers are becoming increasingly tolerant when it comes to "tidiness"
+of meshes, it is always worth trying to provide as clean a mesh as possible.
+
+--------------
+
+Solid
+	Checks for Non-Manifold edges and Bad Contiguous edges.
+
+	Edges should connect to exactly 2 faces. In it connects to only one,
+	it means there's a hole in the mesh. More is also not allowed. These edges are considered Non-manifold.
+	If one of the faces' normals is pointing in a different direction than its neighbors,
+	its edges are marked as "Bad Contiguous".
+
+	In this screenshot, the left shape has a hole, and the right shape has one of its faces flipped.
+
+	.. figure:: /images/3dprint_solid.jpg
+
+		Left, marked in blue: Non-manifold edges. Right, marked in red: Bad contiguous edges.
+
+Intersections
+	These two cubes have intersecting faces. A Boolean modifier would help in this example.
+	It's worth noting that some slicer applications can deal with this,
+	so it's not always required to resolve this issue.
+
+	.. figure:: /images/3dprint_intersect.jpg
+
+:Degenerate:
+	Faces and edges which have 0 area or length, are considered `degenerate`.
+	In this example, the top face of a cube has been scaled down to 0,
+	but have not been merged. A :menuselection:`Merge --> By Distance` would resolve this issue.
+
+	.. figure:: /images/3dprint_degenerate.jpg
+
+		There's a hidden face here.
+
+:Distorted:
+	The vertices of a quad or ngon can be folded in such a way that the face is not flat.
+	In practice, quads are rarely ever flat. When exporting, these faces are converted to triangles.
+	If the surface is excessively deformed, this can result in unexpected shapes.
+
+	In this example, a quad has been folded into a saddle-like shape.
+	This triggers the `Distorted` check. It would be best to triangulate by hand here.
+
+	.. figure:: /images/3dprint_intersect.jpg
+
+		This quad can triangulate in unexpected ways.
+
+Thickness
+	Faces that form very thin geometry might be missed entirely by the slicer. Such faces are marked as `Thin`.
+
+	.. figure:: /images/3dprint_thickness.jpg
+
+Edge Sharp
+	Similar to `Thickness`, sharp edges can thin pieces of geometry which might be missed by the `slicer`
+
+Overhang
+	As 3D printers can't print in mid-air, parts of the model which overhang will not print correctly.
+	In practice, slicers can add additional material, `support`, to anticipate for overhanging layers.
+
+	.. figure:: /images/3dprint_overhang.jpg
+
+:Check All:
+	Performs all of the above checks at once. In this example, Suzanne shows quite a few problems.
+	This is because the eyes are separate parts, and the sockets have holes.
+	This makes the mesh not `Solid` and `Intersecting`. Some of the faces are `Distorted`.
+
+	.. figure:: /images/3dprint_suzanne.jpg
+
+
+Clean Up
+========
+
+Distorted
+  Triangulates the faces which are considered `Distorted`, as explained above.
+
+Make Manifold
+  Attempts to fix various problems which might make a mesh non-manifold,
+  such as by fixing `bad normals`, filling holes, and removing empty edges and faces.
+
+
+Transform
+=========
+
+Scale To
+--------
+
+Volume
+   Scales the model to an exact given volume.
+
+Bounds
+   Scales the model so that the biggest axis of the objects `bounds` (or `dimensions`) match the given value.
+
+
+Export
+======
+
+Provides quick access to Blender's object exporting operators found in :menuselection:`File --> Export`.

Copied: trunk/blender_docs/manual/images/3dprint_checks.jpg (from rev 9287, branches/blender-3.2-release/blender_docs/manual/images/3dprint_checks.jpg)
===================================================================
(Binary files differ)

Copied: trunk/blender_docs/manual/images/3dprint_degenerate.jpg (from rev 9287, branches/blender-3.2-release/blender_docs/manual/images/3dprint_degenerate.jpg)
===================================================================
(Binary files differ)

Copied: trunk/blender_docs/manual/images/3dprint_distorted.jpg (from rev 9287, branches/blender-3.2-release/blender_docs/manual/images/3dprint_distorted.jpg)
===================================================================
(Binary files differ)

Copied: trunk/blender_docs/manual/images/3dprint_intersect.jpg (from rev 9287, branches/blender-3.2-release/blender_docs/manual/images/3dprint_intersect.jpg)
===================================================================
(Binary files differ)

Copied: trunk/blender_docs/manual/images/3dprint_overhang.jpg (from rev 9287, branches/blender-3.2-release/blender_docs/manual/images/3dprint_overhang.jpg)
===================================================================
(Binary files differ)

Copied: trunk/blender_docs/manual/images/3dprint_solid.jpg (from rev 9287, branches/blender-3.2-release/blender_docs/manual/images/3dprint_solid.jpg)
===================================================================
(Binary files differ)

Copied: trunk/blender_docs/manual/images/3dprint_suzanne.jpg (from rev 9287, branches/blender-3.2-release/blender_docs/manual/images/3dprint_suzanne.jpg)
===================================================================
(Binary files differ)

Copied: trunk/blender_docs/manual/images/3dprint_thickness.jpg (from rev 9287, branches/blender-3.2-release/blender_docs/manual/images/3dprint_thickness.jpg)
===================================================================
(Binary files differ)

More information about the Bf-docboard-svn mailing list