[Bf-docboard-svn] bf-manual: [8960] branches/blender-3.1-release/blender_docs/manual/files/import_export/usd.rst: USD Preview Surface material export

[Aaron Carlisle]

Revision: 8960
          https://developer.blender.org/rBM8960
Author:   Blendify
Date:     2022-02-13 01:35:06 +0100 (Sun, 13 Feb 2022)
Log Message:
-----------
USD Preview Surface material export

rBc85c52f2ce478ab0e30c5e93fd5a5cb812db232f

Modified Paths:
--------------
    branches/blender-3.1-release/blender_docs/manual/files/import_export/usd.rst

Modified: branches/blender-3.1-release/blender_docs/manual/files/import_export/usd.rst
===================================================================
--- branches/blender-3.1-release/blender_docs/manual/files/import_export/usd.rst	2022-02-13 00:04:41 UTC (rev 8959)
+++ branches/blender-3.1-release/blender_docs/manual/files/import_export/usd.rst	2022-02-13 00:35:06 UTC (rev 8960)
@@ -68,9 +68,14 @@
    When checked, includes normals for exported meshes. This includes custom loop normals.
 
 Materials
-   When checked, exports the viewport materials of meshes.
+   Exports material information of the object.
+   By default the exporter approximates the :doc:`/render/shader_nodes/shader/principled`
+   node tree by converting it to USD's Preview Surface format.
+   If *To USD Preview Surface* is disabled, the material is set to the viewport materials of meshes.
+
+   Additional material properties are set in the *Material* grouping of options.
+
    When a mesh has multiple materials assigned, a geometry subset is created for each material.
-
    The first material (if any) is always applied to the mesh itself as well
    (regardless of the existence of geometry subsets),
    because the Hydra viewport does not support materials on subsets.
@@ -82,6 +87,32 @@
    or any other property that can be set for both the *Viewport* and *Render*.
 
 
+Materials
+---------
+
+Additional options when *Materials* are enabled for export.
+
+To USD Preview Surface
+   When exporting materials, approximate a :doc:`/render/shader_nodes/shader/principled`
+   node tree to by converting it to USD's Preview Surface format.
+   If disabled, the material is set to the viewport materials of meshes.
+
+   .. warning::
+
+      Not all nodes are supported; currently only Diffuse,
+      Principle, Image Textures, and UVMap nodes are support.
+
+Export Textures
+   Export textures referenced by shader nodes to a "textures"
+   folder which in the same directory as the USD file.
+
+Overwrite Textures
+   Allow overwriting existing texture files when exporting textures.
+
+Relative Texture Paths
+   Make texture asset paths relative to the exported USD file.
+
+
 Experimental
 ------------