[Bf-docboard-svn] bf-manual: [7840] trunk/blender_docs/manual: New Cryptomatte Workflow.
Jeroen Bakker
noreply at blender.org
Tue Mar 16 12:11:50 CET 2021
Revision: 7840
https://developer.blender.org/rBM7840
Author: jbakker
Date: 2021-03-16 12:11:49 +0100 (Tue, 16 Mar 2021)
Log Message:
-----------
New Cryptomatte Workflow.
Modified Paths:
--------------
trunk/blender_docs/manual/compositing/types/matte/cryptomatte.rst
trunk/blender_docs/manual/compositing/types/matte/index.rst
trunk/blender_docs/manual/images/compositing_node-types_CompositorNodeCryptomatte.png
Added Paths:
-----------
trunk/blender_docs/manual/compositing/types/matte/cryptomatte_legacy.rst
trunk/blender_docs/manual/images/compositing_node-types_CompositorNodeCryptomatteLegacy.png
Modified: trunk/blender_docs/manual/compositing/types/matte/cryptomatte.rst
===================================================================
--- trunk/blender_docs/manual/compositing/types/matte/cryptomatte.rst 2021-03-16 00:55:35 UTC (rev 7839)
+++ trunk/blender_docs/manual/compositing/types/matte/cryptomatte.rst 2021-03-16 11:11:49 UTC (rev 7840)
@@ -21,17 +21,31 @@
Image
Standard image input.
-Crypto Passes
- Each crypto layer will be given its own render pass;
- each of these render passes must be connected to one of these crypto layer inputs.
- By default there are only four layers, see `Adding/Removing Layers`_ to add more.
Properties
==========
-Add/Remove
- Adds/Removes an object or material from matte, by picking a color from the *Pick* output.
+Source
+ The source of the cryptomatte data.
+
+ Render
+ Use Cryptomatte data that are stored as part of the render.
+
+ Image
+ Use Cryptomatte data that are stored inside a multilayered OpenEXR image.
+
+Scene
+ Scene selector.
+ Only available when Render Source is selected.
+
+Image
+ Image selector.
+ Only available when Image Source is selected.
+
+Cryptomatte Layer
+ Selector of the Cryptomatte layer.
+
Matte ID
List of object and material crypto IDs to include in matte.
This can be used for example to quickly clear all mattes by deleting the text
@@ -46,8 +60,8 @@
Matte
A black-and-white alpha mask of the all the selected crypto layers.
Pick
- A colored representation of the Cryptomatte pass which can be used
- with a Viewer node to select which crypto passes are used to create the matte image.
+ A colored representation of the Cryptomatte pass which can be used as a higher contrast
+ image for color picking.
Usage
@@ -54,22 +68,16 @@
=====
#. Enable Cryptomatte Object render pass in the Passes panel, and render.
-#. In the compositing nodes, create a Cryptomatte node and
- link the Render Layer matching Image and Cryptomatte passes to it.
-#. Attach a Viewer node to the Pick output of the Cryptomatte node.
-#. Use the Cryptomatte Add/Remove button to sample objects in the Pick Viewer node.
+#. In the compositing nodes, create a Cryptomatte node and select the cryptomatte
+ layer.
+#. Attach a Viewer node to the combined pass of the render layers.
+#. Use the Cryptomatte Add/Remove button to sample objects from the compositor backdrop.
#. Use the Matte output of the Cryptomatte node to get the alpha mask.
+The image/uv editor, node backdrop or movie clip editor can be used to pick a cryptomatte sample.
+They don't need to show any cryptomatte layer. The node will use the sample image coordinate to
+sample in the cryptomatte layer that is selected in the node.
-Adding/Removing Layers
-----------------------
-
-By default there are only four crypto layers available as inputs to the Cryptomatte node.
-You can add or remove layer inputs through
-:menuselection:`Sidebar --> Item --> Properties --> Add/Remove Crypto Layer`.
-These operators will add/remove layers from the bottom of the pass inputs.
-
-
Example
=======
@@ -78,3 +86,9 @@
Notice how the cube on the left has a sphere shaped cut-out from a sphere that was not selected in the node.
.. figure:: /images/compositing_types_matte_cryptomatte_example.png
+
+
+Limitations
+===========
+
+* Cryptomatte sidecars are not supported.
\ No newline at end of file
Added: trunk/blender_docs/manual/compositing/types/matte/cryptomatte_legacy.rst
===================================================================
--- trunk/blender_docs/manual/compositing/types/matte/cryptomatte_legacy.rst (rev 0)
+++ trunk/blender_docs/manual/compositing/types/matte/cryptomatte_legacy.rst 2021-03-16 11:11:49 UTC (rev 7840)
@@ -0,0 +1,86 @@
+
+*************************
+Cryptomatte Node (Legacy)
+*************************
+
+.. figure:: /images/compositing_node-types_CompositorNodeCryptomatteLegacy.png
+ :align: right
+
+ Cryptomatte Node.
+
+The Cryptomatte node uses the Cryptomatte standard to efficiently create mattes for compositing.
+Cycles and Eevee output the required render passes, which can then be used in the Compositor
+or another compositor with Cryptomatte support to create masks for specified objects.
+
+Unlike the Material and Object Index passes, the objects to isolate are selected in compositing,
+and mattes will be anti-aliased and take into account effects like motion blur and transparency.
+
+
+.. note::
+
+ The Cryptomatte Legacy node is deprecated and replaced by
+ :doc:`Crytomatte Node</compositing/types/matte/cryptomatte>`.
+ The legacy node will be removed in a future Blender release.
+
+Inputs
+======
+
+Image
+ Standard image input.
+Crypto Passes
+ Each crypto layer will be given its own render pass;
+ each of these render passes must be connected to one of these crypto layer inputs.
+ By default there are only four layers, see `Adding/Removing Layers`_ to add more.
+
+
+Properties
+==========
+
+Add/Remove
+ Adds/Removes an object or material from matte, by picking a color from the *Pick* output.
+Matte ID
+ List of object and material crypto IDs to include in matte.
+ This can be used for example to quickly clear all mattes by deleting the text
+ or used to copy-and-paste crypto IDs from other software.
+
+
+Outputs
+=======
+
+Image
+ A colored output of the input image with the matte applied to only include selected layers.
+Matte
+ A black-and-white alpha mask of the all the selected crypto layers.
+Pick
+ A colored representation of the Cryptomatte pass which can be used
+ with a Viewer node to select which crypto passes are used to create the matte image.
+
+
+Usage
+=====
+
+#. Enable Cryptomatte Object render pass in the Passes panel, and render.
+#. In the compositing nodes, create a Cryptomatte node and
+ link the Render Layer matching Image and Cryptomatte passes to it.
+#. Attach a Viewer node to the Pick output of the Cryptomatte node.
+#. Use the Cryptomatte Add/Remove button to sample objects in the Pick Viewer node.
+#. Use the Matte output of the Cryptomatte node to get the alpha mask.
+
+
+Adding/Removing Layers
+----------------------
+
+By default there are only four crypto layers available as inputs to the Cryptomatte node.
+You can add or remove layer inputs through
+:menuselection:`Sidebar --> Item --> Properties --> Add/Remove Crypto Layer`.
+These operators will add/remove layers from the bottom of the pass inputs.
+
+
+Example
+=======
+
+In the example below, you can see the pass output on the right side.
+On the left side you can see a couple of objects that were selected through the *Cryptomatte* node.
+Notice how the cube on the left has a sphere shaped cut-out from a sphere that was not selected in the node.
+
+.. figure:: /images/compositing_types_matte_cryptomatte_example.png
Property changes on: trunk/blender_docs/manual/compositing/types/matte/cryptomatte_legacy.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: trunk/blender_docs/manual/compositing/types/matte/index.rst
===================================================================
--- trunk/blender_docs/manual/compositing/types/matte/index.rst 2021-03-16 00:55:35 UTC (rev 7839)
+++ trunk/blender_docs/manual/compositing/types/matte/index.rst 2021-03-16 11:11:49 UTC (rev 7840)
@@ -50,6 +50,7 @@
color_key.rst
color_spill.rst
cryptomatte.rst
+ cryptomatte_legacy.rst
difference_key.rst
distance_key.rst
double_edge_mask.rst
Modified: trunk/blender_docs/manual/images/compositing_node-types_CompositorNodeCryptomatte.png
===================================================================
(Binary files differ)
Added: trunk/blender_docs/manual/images/compositing_node-types_CompositorNodeCryptomatteLegacy.png
===================================================================
(Binary files differ)
Index: trunk/blender_docs/manual/images/compositing_node-types_CompositorNodeCryptomatteLegacy.png
===================================================================
--- trunk/blender_docs/manual/images/compositing_node-types_CompositorNodeCryptomatteLegacy.png 2021-03-16 00:55:35 UTC (rev 7839)
+++ trunk/blender_docs/manual/images/compositing_node-types_CompositorNodeCryptomatteLegacy.png 2021-03-16 11:11:49 UTC (rev 7840)
Property changes on: trunk/blender_docs/manual/images/compositing_node-types_CompositorNodeCryptomatteLegacy.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
More information about the Bf-docboard-svn
mailing list