[Bf-docboard-svn] bf-manual: [9287] branches/blender-3.2-release/blender_docs/manual: 3D Print Toolbox Documentation
Aaron Carlisle
noreply at blender.org
Thu May 19 03:09:55 CEST 2022
Revision: 9287
https://developer.blender.org/rBM9287
Author: Blendify
Date: 2022-05-19 03:09:54 +0200 (Thu, 19 May 2022)
Log Message:
-----------
3D Print Toolbox Documentation
Author: @thomaskole
Differential Revision: https://developer.blender.org/D14959
Modified Paths:
--------------
branches/blender-3.2-release/blender_docs/manual/addons/mesh/3d_print_toolbox.rst
Added Paths:
-----------
branches/blender-3.2-release/blender_docs/manual/images/3dprint_checks.jpg
branches/blender-3.2-release/blender_docs/manual/images/3dprint_degenerate.jpg
branches/blender-3.2-release/blender_docs/manual/images/3dprint_distorted.jpg
branches/blender-3.2-release/blender_docs/manual/images/3dprint_intersect.jpg
branches/blender-3.2-release/blender_docs/manual/images/3dprint_overhang.jpg
branches/blender-3.2-release/blender_docs/manual/images/3dprint_solid.jpg
branches/blender-3.2-release/blender_docs/manual/images/3dprint_suzanne.jpg
branches/blender-3.2-release/blender_docs/manual/images/3dprint_thickness.jpg
Modified: branches/blender-3.2-release/blender_docs/manual/addons/mesh/3d_print_toolbox.rst
===================================================================
--- branches/blender-3.2-release/blender_docs/manual/addons/mesh/3d_print_toolbox.rst 2022-05-17 07:24:25 UTC (rev 9286)
+++ branches/blender-3.2-release/blender_docs/manual/addons/mesh/3d_print_toolbox.rst 2022-05-19 01:09:54 UTC (rev 9287)
@@ -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`.
Added: branches/blender-3.2-release/blender_docs/manual/images/3dprint_checks.jpg
===================================================================
(Binary files differ)
Index: branches/blender-3.2-release/blender_docs/manual/images/3dprint_checks.jpg
===================================================================
--- branches/blender-3.2-release/blender_docs/manual/images/3dprint_checks.jpg 2022-05-17 07:24:25 UTC (rev 9286)
+++ branches/blender-3.2-release/blender_docs/manual/images/3dprint_checks.jpg 2022-05-19 01:09:54 UTC (rev 9287)
Property changes on: branches/blender-3.2-release/blender_docs/manual/images/3dprint_checks.jpg
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
Added: branches/blender-3.2-release/blender_docs/manual/images/3dprint_degenerate.jpg
===================================================================
(Binary files differ)
Index: branches/blender-3.2-release/blender_docs/manual/images/3dprint_degenerate.jpg
===================================================================
--- branches/blender-3.2-release/blender_docs/manual/images/3dprint_degenerate.jpg 2022-05-17 07:24:25 UTC (rev 9286)
+++ branches/blender-3.2-release/blender_docs/manual/images/3dprint_degenerate.jpg 2022-05-19 01:09:54 UTC (rev 9287)
Property changes on: branches/blender-3.2-release/blender_docs/manual/images/3dprint_degenerate.jpg
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
Added: branches/blender-3.2-release/blender_docs/manual/images/3dprint_distorted.jpg
===================================================================
(Binary files differ)
Index: branches/blender-3.2-release/blender_docs/manual/images/3dprint_distorted.jpg
===================================================================
--- branches/blender-3.2-release/blender_docs/manual/images/3dprint_distorted.jpg 2022-05-17 07:24:25 UTC (rev 9286)
+++ branches/blender-3.2-release/blender_docs/manual/images/3dprint_distorted.jpg 2022-05-19 01:09:54 UTC (rev 9287)
Property changes on: branches/blender-3.2-release/blender_docs/manual/images/3dprint_distorted.jpg
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
Added: branches/blender-3.2-release/blender_docs/manual/images/3dprint_intersect.jpg
===================================================================
(Binary files differ)
Index: branches/blender-3.2-release/blender_docs/manual/images/3dprint_intersect.jpg
===================================================================
--- branches/blender-3.2-release/blender_docs/manual/images/3dprint_intersect.jpg 2022-05-17 07:24:25 UTC (rev 9286)
+++ branches/blender-3.2-release/blender_docs/manual/images/3dprint_intersect.jpg 2022-05-19 01:09:54 UTC (rev 9287)
Property changes on: branches/blender-3.2-release/blender_docs/manual/images/3dprint_intersect.jpg
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
Added: branches/blender-3.2-release/blender_docs/manual/images/3dprint_overhang.jpg
===================================================================
(Binary files differ)
Index: branches/blender-3.2-release/blender_docs/manual/images/3dprint_overhang.jpg
===================================================================
--- branches/blender-3.2-release/blender_docs/manual/images/3dprint_overhang.jpg 2022-05-17 07:24:25 UTC (rev 9286)
+++ branches/blender-3.2-release/blender_docs/manual/images/3dprint_overhang.jpg 2022-05-19 01:09:54 UTC (rev 9287)
Property changes on: branches/blender-3.2-release/blender_docs/manual/images/3dprint_overhang.jpg
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
Added: branches/blender-3.2-release/blender_docs/manual/images/3dprint_solid.jpg
===================================================================
(Binary files differ)
Index: branches/blender-3.2-release/blender_docs/manual/images/3dprint_solid.jpg
===================================================================
--- branches/blender-3.2-release/blender_docs/manual/images/3dprint_solid.jpg 2022-05-17 07:24:25 UTC (rev 9286)
+++ branches/blender-3.2-release/blender_docs/manual/images/3dprint_solid.jpg 2022-05-19 01:09:54 UTC (rev 9287)
Property changes on: branches/blender-3.2-release/blender_docs/manual/images/3dprint_solid.jpg
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
@@ Diff output truncated at 10240 characters. @@
More information about the Bf-docboard-svn
mailing list