[Bf-docboard-svn] bf-manual: [9228] trunk/blender_docs/manual/editors/asset_browser.rst: Assets: Note how object/geometry orientation affects automatic-previews

[Julian Eisel]

Revision: 9228
          https://developer.blender.org/rBM9228
Author:   Severin
Date:     2022-04-28 19:07:09 +0200 (Thu, 28 Apr 2022)
Log Message:
-----------
Assets: Note how object/geometry orientation affects automatic-previews

This wasn't clear, also the fact that rotation may have to be applied for the preview render.

Modified Paths:
--------------
    trunk/blender_docs/manual/editors/asset_browser.rst

Modified: trunk/blender_docs/manual/editors/asset_browser.rst
===================================================================
--- trunk/blender_docs/manual/editors/asset_browser.rst	2022-04-28 09:46:43 UTC (rev 9227)
+++ trunk/blender_docs/manual/editors/asset_browser.rst	2022-04-28 17:07:09 UTC (rev 9228)
@@ -222,7 +222,13 @@
    Preview panel in the Asset Browser.
 
 Preview images are typically automatically generated when you
-:ref:`mark a data-block as asset <bpy.ops.asset.mark>`.
+:ref:`mark a data-block as asset <bpy.ops.asset.mark>`. The auto-generated
+preview tries to capture the object from the front. However this only works if
+the geometry is laid out so that it matches what Blender considers to be the
+front. That is, the geometry that should be the front needs to point down the -Y
+axis of the object. The rotation may have to be applied to get the expected
+result. Collection assets use the global -Y  axis as the front (instead of the
+local one, as collections themselves don't have a rotation).
 
 It's also possible to load image files from drive, to replace the auto-generated previews.