[Bf-docboard-svn] bf-manual: [9467] trunk/blender_docs/manual: Merge branch 'blender-3.3-release'
Aaron Carlisle
noreply at blender.org
Thu Aug 11 03:01:22 CEST 2022
Revision: 9467
https://developer.blender.org/rBM9467
Author: Blendify
Date: 2022-08-11 03:01:22 +0200 (Thu, 11 Aug 2022)
Log Message:
-----------
Merge branch 'blender-3.3-release'
Modified Paths:
--------------
trunk/blender_docs/manual/addons/import_export/mesh_ply.rst
trunk/blender_docs/manual/addons/import_export/mesh_stl.rst
trunk/blender_docs/manual/addons/import_export/scene_x3d.rst
trunk/blender_docs/manual/files/import_export/usd.rst
trunk/blender_docs/manual/files/import_export.rst
Added Paths:
-----------
trunk/blender_docs/manual/files/import_export/stl.rst
Property Changed:
----------------
trunk/blender_docs/
Index: trunk/blender_docs
===================================================================
--- trunk/blender_docs 2022-08-11 00:32:11 UTC (rev 9466)
+++ trunk/blender_docs 2022-08-11 01:01:22 UTC (rev 9467)
Property changes on: trunk/blender_docs
___________________________________________________________________
Modified: svn:mergeinfo
## -3,4 +3,4 ##
/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-9417
-/branches/blender-3.3-release/blender_docs:9438-9461
\ No newline at end of property
+/branches/blender-3.3-release/blender_docs:9438-9466
\ No newline at end of property
Modified: trunk/blender_docs/manual/addons/import_export/mesh_ply.rst
===================================================================
--- trunk/blender_docs/manual/addons/import_export/mesh_ply.rst 2022-08-11 00:32:11 UTC (rev 9466)
+++ trunk/blender_docs/manual/addons/import_export/mesh_ply.rst 2022-08-11 01:01:22 UTC (rev 9467)
@@ -29,7 +29,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
@@ -44,7 +46,7 @@
For example, its common for applications to use Y as the up axis, in that case -Z Forward, Y Up is needed.
Scale
- TODO.
+ Value by which to scale the exported objects in relation to the world's origin.
Geometry
Modified: trunk/blender_docs/manual/addons/import_export/mesh_stl.rst
===================================================================
--- trunk/blender_docs/manual/addons/import_export/mesh_stl.rst 2022-08-11 00:32:11 UTC (rev 9466)
+++ trunk/blender_docs/manual/addons/import_export/mesh_stl.rst 2022-08-11 01:01:22 UTC (rev 9467)
@@ -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
Modified: trunk/blender_docs/manual/addons/import_export/scene_x3d.rst
===================================================================
--- trunk/blender_docs/manual/addons/import_export/scene_x3d.rst 2022-08-11 00:32:11 UTC (rev 9466)
+++ trunk/blender_docs/manual/addons/import_export/scene_x3d.rst 2022-08-11 01:01:22 UTC (rev 9467)
@@ -40,7 +40,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.
Hierarchy
TODO.
Named Decorations
Copied: trunk/blender_docs/manual/files/import_export/stl.rst (from rev 9466, branches/blender-3.3-release/blender_docs/manual/files/import_export/stl.rst)
===================================================================
--- trunk/blender_docs/manual/files/import_export/stl.rst (rev 0)
+++ trunk/blender_docs/manual/files/import_export/stl.rst 2022-08-11 01:01:22 UTC (rev 9467)
@@ -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>`.
Modified: trunk/blender_docs/manual/files/import_export/usd.rst
===================================================================
--- trunk/blender_docs/manual/files/import_export/usd.rst 2022-08-11 00:32:11 UTC (rev 9466)
+++ trunk/blender_docs/manual/files/import_export/usd.rst 2022-08-11 01:01:22 UTC (rev 9467)
@@ -17,6 +17,7 @@
- Cameras (perspective cameras only at the moment, not orthogonal ones).
- Light (all types except area lights).
- Hair (exported as curves, and limited to parent strands).
+- Volume (both static and animated volumes).
When exporting an animation, the final, evaluated mesh is written to USD.
This means that the following meshes can be exported:
@@ -109,10 +110,15 @@
Overwrite Textures
Allow overwriting existing texture files when exporting textures.
-Relative Texture Paths
- Make texture asset paths relative to the exported USD file.
+File References
+---------------
+Relative Paths
+ Use relative paths to reference external files (i.e. textures, volumes) in the exported USD file,
+ otherwise use absolute paths.
+/home/aaron/Documents/projects/blender_foundation/blender/build_linux/bin/blender
+
Experimental
------------
@@ -329,7 +335,13 @@
Light Intensity Scale
Scale for the intensity of imported lights.
+Material Name Collision
+ Behavior when the name of an imported material conflicts with an existing material.
+ :Make Unique: Import each USD material as a unique Blender material.
+ :Reference Existing: If a material with the same name already exists, reference that instead of importing.
+
+
Experimental
------------
Modified: trunk/blender_docs/manual/files/import_export.rst
===================================================================
--- trunk/blender_docs/manual/files/import_export.rst 2022-08-11 00:32:11 UTC (rev 9466)
+++ trunk/blender_docs/manual/files/import_export.rst 2022-08-11 01:01:22 UTC (rev 9467)
@@ -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
More information about the Bf-docboard-svn
mailing list