[Bf-docboard-svn] bf-manual: [9465] branches/blender-3.3-release/blender_docs/manual: STL: Add new C++ based STL importer

[Aaron Carlisle]

Revision: 9465
          https://developer.blender.org/rBM9465
Author:   Blendify
Date:     2022-08-11 02:31:48 +0200 (Thu, 11 Aug 2022)
Log Message:
-----------
STL: Add new C++ based STL importer

rB7c511f1b47d857f37aa36ee6ed8107cb88eb5c39

Modified Paths:
--------------
    branches/blender-3.3-release/blender_docs/manual/addons/import_export/mesh_stl.rst
    branches/blender-3.3-release/blender_docs/manual/files/import_export.rst

Added Paths:
-----------
    branches/blender-3.3-release/blender_docs/manual/files/import_export/stl.rst

Modified: branches/blender-3.3-release/blender_docs/manual/addons/import_export/mesh_stl.rst
===================================================================
--- branches/blender-3.3-release/blender_docs/manual/addons/import_export/mesh_stl.rst	2022-08-10 23:52:49 UTC (rev 9464)
+++ branches/blender-3.3-release/blender_docs/manual/addons/import_export/mesh_stl.rst	2022-08-11 00:31:48 UTC (rev 9465)
@@ -17,19 +17,25 @@
    and does not handle endianness, there is nothing in the STL specification about it.
 
 
+Importing
+=========
+
+.. note::
+
+   The STL importer Add-on is deprecated and being replaced with the much faster
+   :ref:`Integrated STL Importer <bpy.ops.wm.stl_import>`.
+
+
 Properties
-==========
+----------
 
-Import
-------
-
 Transform
 ^^^^^^^^^
 
 Scale
-   TODO.
+   Value by which to scale the imported objects in relation to the world's origin.
 Scene Unit
-   TODO.
+   Apply current scene's unit (as defined by unit scale) to imported data.
 Forward / Up Axis
    Since many applications use a different axis for pointing upwards, these are axis conversion for these settings,
    Forward and up axes -- By mapping these to different axes you can convert rotations
@@ -43,12 +49,15 @@
 ^^^^^^^^
 
 Facet Normals
-   TODO.
+   Use (import) facet normals (note that this will still give flat shading).
 
 
-Export
-------
+Exporting
+=========
 
+Properties
+----------
+
 ASCII
    TODO.
 Batch Mode
@@ -59,7 +68,9 @@
 ^^^^^^^
 
 Selection Only
-   TODO.
+   When checked, only selected objects are exported.
+   Instanced objects, for example collections that are instanced in the scene,
+   are considered 'selected' when their instancer is selected.
 
 
 Transform
@@ -66,9 +77,9 @@
 ^^^^^^^^^
 
 Scale
-   TODO.
+   Value by which to scale the exported objects in relation to the world's origin.
 Scene Unit
-   TODO.
+   Apply current scene's unit (as defined by unit scale) to exported data.
 Forward / Up Axis
    Since many applications use a different axis for 'Up', these are axis conversion for these settings,
    Forward and Up axes -- By mapping these to different axes you can convert rotations

Added: branches/blender-3.3-release/blender_docs/manual/files/import_export/stl.rst
===================================================================
--- branches/blender-3.3-release/blender_docs/manual/files/import_export/stl.rst	                        (rev 0)
+++ branches/blender-3.3-release/blender_docs/manual/files/import_export/stl.rst	2022-08-11 00:31:48 UTC (rev 9465)
@@ -0,0 +1,53 @@
+
+***
+STL
+***
+
+.. reference::
+
+   :Category:  Import-Export
+   :Menu:      :menuselection:`File --> Import/Export --> Stl (.stl) (experimental)`
+
+.. note::
+
+   This is the experimental STL importer designed to replace the much slower
+   :doc:`STL Importer Add-on </addons/import_export/mesh_stl>`
+
+The STL-file format is useful if you intend to import/export the files for CAD software.
+It is also commonly used for loading into 3D printing software.
+
+
+.. _bpy.ops.wm.stl_import:
+
+Importing
+=========
+
+Properties
+----------
+
+Scale
+   Value by which to scale the imported objects in relation to the world's origin.
+
+Scene Unit
+   Apply current scene's unit (as defined by unit scale) to imported data.
+
+Facet Normals
+   Use (import) facet normals (note that this will still give flat shading).
+
+Forward / Up Axis
+   Since many applications use a different axis for pointing upwards, these are axis conversion for these settings,
+   Forward and up axes -- By mapping these to different axes you can convert rotations
+   between applications default up and forward axes.
+
+   Blender uses Y forward, Z up (since the front view looks along the +Y direction).
+   For example, it is common for applications to use Y as the up axis, in that case -Z forward, Y up is needed.
+
+Validate Mesh
+   Check the imported mesh for corrupt data and fix it if necessary.
+   This option will make the importing slower but is often not necessary.
+
+
+Exporting
+=========
+
+In order to export STL-files you must currently use the :doc:`STL Add-on </addons/import_export/mesh_stl>`.


Property changes on: branches/blender-3.3-release/blender_docs/manual/files/import_export/stl.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: branches/blender-3.3-release/blender_docs/manual/files/import_export.rst
===================================================================
--- branches/blender-3.3-release/blender_docs/manual/files/import_export.rst	2022-08-10 23:52:49 UTC (rev 9464)
+++ branches/blender-3.3-release/blender_docs/manual/files/import_export.rst	2022-08-11 00:31:48 UTC (rev 9465)
@@ -24,6 +24,7 @@
    import_export/collada.rst
    import_export/usd.rst
    import_export/obj.rst
+   import_export/stl.rst
    import_export/grease_pencil_svg.rst
    import_export/grease_pencil_pdf.rst