diff --git a/website/docs/artist_hosts_tvpaint.md b/website/docs/artist_hosts_tvpaint.md new file mode 100644 index 0000000000..cda70b0886 --- /dev/null +++ b/website/docs/artist_hosts_tvpaint.md @@ -0,0 +1,130 @@ +--- +id: artist_hosts_tvpaint +title: TVPaint +sidebar_label: TVPaint +--- + +- [Work Files](artist_tools.md#workfiles) +- [Load](artist_tools.md#loader) +- [Create](artist_tools.md#creator) +- [Subset Manager](artist_tools.md#subset-manager) +- [Scene Inventory](artist_tools.md#scene-inventory) +- [Publish](artist_tools.md#publisher) +- [Library](artist_tools.md#library) + + +## Setup +When you launch TVPaint with OpenPype for the very first time it is necessary to do some additional steps. Right after the TVPaint launching a few system windows will pop up. + +![permission](assets/tvp_permission.png) + +Choose `Replace the file in the destination`. Then another window shows up. + +![permission2](assets/tvp_permission2.png) + +Click on `Continue`. + +After opening TVPaint go to the menu bar: `Windows → Plugins → OpenPype`. + +![pypewindow](assets/tvp_hidden_window.gif) + +Another TVPaint window pop up. Please press `Yes`. This window will be presented in every single TVPaint launching. Unfortunately, there is no other way how to workaround it. + +![writefile](assets/tvp_write_file.png) + +Now OpenPype Tools menu is in your TVPaint work area. + +![openpypetools](assets/tvp_openpype_menu.png) + +You can start your work. + +--- + +## Usage +In TVPaint you can find the Tools in OpenPype menu extension. The OpenPype Tools menu should be available in your work area. However, sometimes it is happening that the Tools menu is hidden. You can display the extension panel by going to `Windows -> Plugins -> OpenPype`. + + +## Create +In TVPaint you can create and publish [Reviews](#review), [Render Passes](#render-pass), and [Render Layers](#render-layer). + +You have the possibility to organize your layers by using `Color group`. + +On the bottom left corner of your timeline, you will note a `Color group` button. + +![colorgroups](assets/tvp_color_groups.png) + +It allows you to choose a group by checking one of the colors of the color list. + +![colorgroups](assets/tvp_color_groups2.png) + +The timeline's animation layer can be marked by the color you pick from your Color group. Layers in the timeline with the same color are gathered into a group represents one render layer. + +![timeline](assets/tvp_timeline_color.png) + +:::important +OpenPype specifically never tries to guess what you want to publish from the scene. Therefore, you have to tell OpenPype what you want to publish. There are three ways how to publish render from the scene. +::: + +When you want to publish `review` or `render layer` or `render pass`, open the `Creator` through the Tools menu `Create` button. + +### Review +Review renders the whole file as is and sends its QuickTime to Ftrack. For the animation review select `Review` in the `Creator` and press `Create`. + +![createreview](assets/tvp_create_review.png) + +### Render Layer +Render Layer bakes all layers of one particular color group. Choose any amount of animation layers that need to be grouped together and assign them a color. Select any layer of a particular color, go to `Creator` and choose `RenderLayer`. In the `Subset`, you type what is gonna be its name *(L10, L20, etc.)* according to the naming convention in your studio. After publishing all layers within one color group will be rendered as one. + +![createlayer](assets/tvp_create_layer.png) + +### Render Pass +Render Passes are specific because they have to belong to a particular layer. If you try to create a render pass and did not do any render layer before, it will pop up an error message. + +When you need to create `RenderPass` choose one or several layers within one color group that you want to publish (*L020_colour_fx*, *L020_colour_mouth*, and *L020_colour_eye* from a yellow group of animation layers). In Creator pick `RenderPass` and the `Subset` fill out with e.g. `YellowColor`. You can check your render instances in [Subset Manager](#subset-manager) or you can start to publish. The publishing process will show you a collection of all instances. + +![createpass](assets/tvp_create_pass.png) + +It will render selected layers within the color group. E.i. the layers *L020_colour_fx*, *L020_colour_mouth*, and *L020_colour_eye* will be rendered as one pass. + +![renderpass](assets/tvp_timeline_color2.png) + +--- + +## Publish +Now you have created the required instances and you can publish them via `Publish` tool. Just click on `Publish` in OpenPype Tools menu, wait until all instances are collected correctly. You can check on the left side whether all your instances have been created and ready for publishing. Then press the `Play` button. + +![pyblish](assets/tvp_pyblish_render.png) + +Once the `Publish` window gets 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 them, right click on the item in the list and select `Remove instance`. + +![subsetmanager](assets/tvp_subset_manager.png) + +--- + +## 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: + +- `render` +- `image` +- `background` +- `plate` + +To load a family item, right-click on the subset you want and import their representations, switch among the versions, delete older versions, copy files, etc. + +![Loader](assets/tvp_loader.gif) + +--- + +## Scene Inventory +Scene Inventory shows you everything that you have loaded into your scene using OpenPype. You can reach it through the extension's `Scene Inventory` button. + +![sceneinventory](assets/tvp_scene_inventory.png) + +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_asset_loader_actions.png b/website/docs/assets/tvp_asset_loader_actions.png new file mode 100644 index 0000000000..dbc3734e10 Binary files /dev/null and b/website/docs/assets/tvp_asset_loader_actions.png differ diff --git a/website/docs/assets/tvp_asset_loader_version.png b/website/docs/assets/tvp_asset_loader_version.png new file mode 100644 index 0000000000..b8052f3c84 Binary files /dev/null and b/website/docs/assets/tvp_asset_loader_version.png differ diff --git a/website/docs/assets/tvp_color_groups.png b/website/docs/assets/tvp_color_groups.png new file mode 100644 index 0000000000..558ff687c6 Binary files /dev/null and b/website/docs/assets/tvp_color_groups.png differ diff --git a/website/docs/assets/tvp_color_groups2.png b/website/docs/assets/tvp_color_groups2.png new file mode 100644 index 0000000000..7ab6775769 Binary files /dev/null and b/website/docs/assets/tvp_color_groups2.png differ diff --git a/website/docs/assets/tvp_create_layer.png b/website/docs/assets/tvp_create_layer.png new file mode 100644 index 0000000000..9d243da17a Binary files /dev/null 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 new file mode 100644 index 0000000000..7d226ea4b5 Binary files /dev/null and b/website/docs/assets/tvp_create_pass.png differ diff --git a/website/docs/assets/tvp_create_review.png b/website/docs/assets/tvp_create_review.png new file mode 100644 index 0000000000..d6e9f63428 Binary files /dev/null and b/website/docs/assets/tvp_create_review.png differ diff --git a/website/docs/assets/tvp_hidden_window.gif b/website/docs/assets/tvp_hidden_window.gif new file mode 100644 index 0000000000..b1adaa75b8 Binary files /dev/null and b/website/docs/assets/tvp_hidden_window.gif differ diff --git a/website/docs/assets/tvp_library.gif b/website/docs/assets/tvp_library.gif new file mode 100644 index 0000000000..14de86cdb5 Binary files /dev/null and b/website/docs/assets/tvp_library.gif differ diff --git a/website/docs/assets/tvp_loader.gif b/website/docs/assets/tvp_loader.gif new file mode 100644 index 0000000000..5775460372 Binary files /dev/null and b/website/docs/assets/tvp_loader.gif differ diff --git a/website/docs/assets/tvp_openpype_menu.png b/website/docs/assets/tvp_openpype_menu.png new file mode 100644 index 0000000000..cb5c2d4aac Binary files /dev/null and b/website/docs/assets/tvp_openpype_menu.png differ diff --git a/website/docs/assets/tvp_permission.png b/website/docs/assets/tvp_permission.png new file mode 100644 index 0000000000..e47d9841b6 Binary files /dev/null and b/website/docs/assets/tvp_permission.png differ diff --git a/website/docs/assets/tvp_permission2.png b/website/docs/assets/tvp_permission2.png new file mode 100644 index 0000000000..827e85db39 Binary files /dev/null and b/website/docs/assets/tvp_permission2.png differ diff --git a/website/docs/assets/tvp_pyblish.png b/website/docs/assets/tvp_pyblish.png new file mode 100644 index 0000000000..88423a3c75 Binary files /dev/null and b/website/docs/assets/tvp_pyblish.png differ diff --git a/website/docs/assets/tvp_pyblish_render.png b/website/docs/assets/tvp_pyblish_render.png new file mode 100644 index 0000000000..7d279c3aa0 Binary files /dev/null and b/website/docs/assets/tvp_pyblish_render.png differ diff --git a/website/docs/assets/tvp_render_pass.png b/website/docs/assets/tvp_render_pass.png new file mode 100644 index 0000000000..07790af7b2 Binary files /dev/null and b/website/docs/assets/tvp_render_pass.png differ diff --git a/website/docs/assets/tvp_scene_inventory.png b/website/docs/assets/tvp_scene_inventory.png new file mode 100644 index 0000000000..25c717b331 Binary files /dev/null and b/website/docs/assets/tvp_scene_inventory.png differ diff --git a/website/docs/assets/tvp_subset_manager.png b/website/docs/assets/tvp_subset_manager.png new file mode 100644 index 0000000000..1ffbead4ba Binary files /dev/null and b/website/docs/assets/tvp_subset_manager.png differ diff --git a/website/docs/assets/tvp_timeline_color.png b/website/docs/assets/tvp_timeline_color.png new file mode 100644 index 0000000000..6d00d4c8af Binary files /dev/null and b/website/docs/assets/tvp_timeline_color.png differ diff --git a/website/docs/assets/tvp_timeline_color2.png b/website/docs/assets/tvp_timeline_color2.png new file mode 100644 index 0000000000..e20e190471 Binary files /dev/null and b/website/docs/assets/tvp_timeline_color2.png differ diff --git a/website/docs/assets/tvp_write_file.png b/website/docs/assets/tvp_write_file.png new file mode 100644 index 0000000000..109e6badc9 Binary files /dev/null and b/website/docs/assets/tvp_write_file.png differ diff --git a/website/sidebars.js b/website/sidebars.js index ec608f0a13..ed0bb75275 100644 --- a/website/sidebars.js +++ b/website/sidebars.js @@ -22,6 +22,7 @@ module.exports = { "artist_hosts_harmony", "artist_hosts_aftereffects", "artist_hosts_photoshop", + "artist_hosts_tvpaint", "artist_hosts_unreal", { type: "category",