[Bf-docboard-svn] bf-manual: [8986] branches/blender-3.1-release/blender_docs/manual/modeling/meshes/uv/workflows/udims.rst: UDIM: Support virtual filenames

[Aaron Carlisle]

Revision: 8986
          https://developer.blender.org/rBM8986
Author:   Blendify
Date:     2022-02-20 05:18:34 +0100 (Sun, 20 Feb 2022)
Log Message:
-----------
UDIM: Support virtual filenames

rB180b66ae8a1ffc0a1bb7d3993028240b4c7f7246

Modified Paths:
--------------
    branches/blender-3.1-release/blender_docs/manual/modeling/meshes/uv/workflows/udims.rst

Modified: branches/blender-3.1-release/blender_docs/manual/modeling/meshes/uv/workflows/udims.rst
===================================================================
--- branches/blender-3.1-release/blender_docs/manual/modeling/meshes/uv/workflows/udims.rst	2022-02-20 02:17:35 UTC (rev 8985)
+++ branches/blender-3.1-release/blender_docs/manual/modeling/meshes/uv/workflows/udims.rst	2022-02-20 04:18:34 UTC (rev 8986)
@@ -50,6 +50,27 @@
 This works for either 2D Painting or :doc:`3D Painting </sculpt_paint/texture_paint/index>`.
 
 
+File Substitution Tokens
+========================
+
+Substitution tokens are special sequences of characters in a filename
+that can be replaced with more meaningful and context aware information.
+In this case, tokens are identified by being text wrapped in angle bracket characters.
+
+This substitution is used while load loading or saving an image
+to automatically identify the tile associated with a particular texture in the UDIM array.
+
+The following tokens are supported:
+
+- ``<UDIM>``: A 4-digit notation calculated as ``1001 + u-tile + v-tile * 10``.
+- ``<UVTILE>``: A notation defined as ``u(u-tile + 1)_v(v-tile + 1)``.
+
+Examples:
+
+- ``monster-basecolor.<UDIM>.png`` will load/save files like ``monster-basecolor.1021.png`` etc.
+- ``monster-basecolor.<UVTILE>.png`` will load/save files like ``monster-basecolor.u1_v3.png`` etc.
+
+
 .. _bpy.ops.image.tile:
 .. _bpy.types.UDIMTiles: