+Render Layer bakes all the animation layers of one particular color group together.
-Render Layer bakes all the animation layers of one particular color group together.
+- In the **Create** tab, pick `Render Layer`
+- Fill `variant`, type in the name that the final published RenderLayer should have according to the naming convention in your studio. *(L10, BG, Hero, etc.)*
+ - Color group will be renamed to the **variant** value
+- Choose color group from combobox
+ - or select a layer of a particular color and set combobox to **<Use selection>**
+- Hit `Create` button
-- Choose any amount of animation layers that need to be rendered together and assign them a color group.
-- Select any layer of a particular color
-- Go to `Creator` and choose `RenderLayer`.
-- In the `Subset`, type in the name that the final published RenderLayer should have according to the naming convention in your studio. *(L10, BG, Hero, etc.)*
-- Press `Create`
-- When you run [publish](#publish), the whole color group will be rendered together and published as a single `RenderLayer`
+After creating a RenderLayer, choose any amount of animation layers that need to be rendered together and assign them the color group.
+
+You can change `variant` later in **Publish** tab.
@@ -97,27 +85,45 @@ Render Layer bakes all the animation layers of one particular color group togeth
+
-Render Passes are specific because they have to belong to a particular layer. If you try to create a render pass and did not create any render layers before, an error message will pop up.
-When you want to create `RenderPass`
-- choose one or several animation layers within one color group that you want to publish
-- In the Creator, pick `RenderPass`
-- Fill the `Subset` with the name of your pass, e.g. `Color`.
+When you want to create Render Pass
+- choose one or several TVPaint layers.
+- in the **Create** tab, pick `Render Pass`.
+- fill the `variant` with desired name of pass, e.g. `Color`.
+- select the Render Layer you want the Render Pass to belong to from the combobox.
+ - if you don't see new Render Layer try refresh first.
- Press `Create`
+After creating a Render Pass, selected the TVPaint layers that should be marked with color group of Render Layer.
+
+You can change `variant` or Render Layer later in **Publish** tab.
+
@@ -126,52 +132,26 @@ When you want to create `RenderPass`
+:::warning
+You cannot change TVPaint layer name once you mark it as part of Render Pass. You would have to remove created Render Pass and create it again with new TVPaint layer name.
+:::
+
-
-
-Now that you have created the required instances, you can publish them via `Publish` tool.
-- Click on `Publish` in OpenPype Tools menu.
-- wait until all instances are collected.
-- You can check on the left side whether all your instances have been created and are ready for publishing.
+Now that you have created the required instances, you can publish them.
- Fill the comment on the bottom of the window.
-- Press the `Play` button to publish
-
-
-
-
-
-
-
-
-
-Once the `Publisher` turns gets green your renders have been published.
+- Double check enabled instance and their context.
+- Press `Publish`.
+- Wait to finish.
+- Once the `Publisher` turns turns green your renders have been published.
---
-## Subset Manager
-All created instances (render layers, passes, and reviews) will be shown as a simple list. If you don't want to publish some, right click on the item in the list and select `Remove instance`.
-
-
-
----
-
-## Load
+## Load
When you want to load existing published work you can reach the `Loader` through the OpenPype Tools `Load` button.
The supported families for TVPaint are:
@@ -192,4 +172,4 @@ Scene Inventory shows you everything that you have loaded into your scene using

-You can switch to a previous version of the file or update it to the latest or delete items.
+You can switch to a previous version of the file or update it to the latest or delete items.
diff --git a/website/docs/assets/tvp_create_layer.png b/website/docs/assets/tvp_create_layer.png
index 9d243da17a..25081bdf46 100644
Binary files a/website/docs/assets/tvp_create_layer.png and b/website/docs/assets/tvp_create_layer.png differ
diff --git a/website/docs/assets/tvp_create_pass.png b/website/docs/assets/tvp_create_pass.png
index 7d226ea4b5..6c8e600af2 100644
Binary files a/website/docs/assets/tvp_create_pass.png and b/website/docs/assets/tvp_create_pass.png differ
diff --git a/website/docs/assets/tvp_openpype_menu.png b/website/docs/assets/tvp_openpype_menu.png
index cb5c2d4aac..23eaf33fc3 100644
Binary files a/website/docs/assets/tvp_openpype_menu.png and b/website/docs/assets/tvp_openpype_menu.png differ
diff --git a/website/docs/assets/tvp_publisher.png b/website/docs/assets/tvp_publisher.png
new file mode 100644
index 0000000000..e5b1f936df
Binary files /dev/null and b/website/docs/assets/tvp_publisher.png differ
diff --git a/website/docs/project_settings/assets/global_oiio_transcode.png b/website/docs/project_settings/assets/global_oiio_transcode.png
new file mode 100644
index 0000000000..d818ecfe19
Binary files /dev/null and b/website/docs/project_settings/assets/global_oiio_transcode.png differ
diff --git a/website/docs/project_settings/assets/global_oiio_transcode2.png b/website/docs/project_settings/assets/global_oiio_transcode2.png
new file mode 100644
index 0000000000..906f780830
Binary files /dev/null and b/website/docs/project_settings/assets/global_oiio_transcode2.png differ
diff --git a/website/docs/project_settings/settings_project_global.md b/website/docs/project_settings/settings_project_global.md
index 37fed93e69..b320b5502f 100644
--- a/website/docs/project_settings/settings_project_global.md
+++ b/website/docs/project_settings/settings_project_global.md
@@ -45,6 +45,25 @@ The _input pattern_ matching uses REGEX expression syntax (try [regexr.com](http
The **colorspace name** value is a raw string input and no validation is run after saving project settings. We recommend to open the specified `config.ocio` file and copy pasting the exact colorspace names.
:::
+### Extract OIIO Transcode
+OIIOTools transcoder plugin with configurable output presets. Any incoming representation with `colorspaceData` is convertable to single or multiple representations with different target colorspaces or display and viewer names found in linked **config.ocio** file.
+
+`oiiotool` is used for transcoding, eg. `oiiotool` must be present in `vendor/bin/oiio` or environment variable `OPENPYPE_OIIO_PATHS` must be provided for custom oiio installation.
+
+Notable parameters:
+- **`Delete Original Representation`** - keep or remove original representation. If old representation is kept, but there is new transcoded representation with 'Create review' tag, original representation loses its 'review' tag if present.
+- **`Extension`** - target extension. If left empty, original extension is used.
+- **`Transcoding type`** - transcoding into colorspace or into display and viewer space could be used. Cannot use both at the same time.
+- **`Colorspace`** - target colorspace, which must be available in used color config. (If `Transcoding type` is `Use Colorspace` value in configuration is used OR if empty value collected on instance from DCC).
+- **`Display & View`** - display and viewer colorspace. (If `Transcoding type` is `Use Display&View` values in configuration is used OR if empty values collected on instance from DCC).
+- **`Arguments`** - special additional command line arguments for `oiiotool`.
+
+
+Example here describes use case for creation of new color coded review of png image sequence. Original representation's files are kept intact, review is created from transcoded files, but these files are removed in cleanup process.
+
+
+Another use case is to transcode in Maya only `beauty` render layers and use collected `Display` and `View` colorspaces from DCC.
+n
## Profile filters