Skip to content

create_render

Render Layer and Passes creators.

Render layer is main part which is represented by group in TVPaint. All TVPaint layers marked with that group color are part of the render layer. To be more specific about some parts of layer it is possible to create sub-sets of layer which are named passes. Render pass consist of layers in same color group as render layer but define more specific part.

For example render layer could be 'Bob' which consist of 5 TVPaint layers. - Bob has 'head' which consist of 2 TVPaint layers -> Render pass 'head' - Bob has 'body' which consist of 1 TVPaint layer -> Render pass 'body' - Bob has 'arm' which consist of 1 TVPaint layer -> Render pass 'arm' - Last layer does not belong to render pass at all

Bob will be rendered as 'beauty' of bob (all visible layers in group). His head will be rendered too but without any other parts. The same for body and arm.

What is this good for? Compositing has more power how the renders are used. Can do transforms on each render pass without need to modify a re-render them using TVPaint.

The workflow may hit issues when there are used other blending modes than default 'color' blend more. In that case it is not recommended to use this workflow at all as other blend modes may affect all layers in clip which can't be done.

There is special case for simple publishing of scene which is called 'render.scene'. That will use all visible layers and render them as one big sequence.

Todos

Add option to extract marked layers and passes as json output format for AfterEffects.

CreateRenderlayer

Bases: TVPaintCreator

Mark layer group as Render layer instance.

All TVPaint layers in the scene with the color group id are rendered in the beauty pass. To create sub passes use Render Layer creator which is dependent on existence of render layer instance.

Source code in client/ayon_tvpaint/plugins/create/create_render.py
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
class CreateRenderlayer(TVPaintCreator):
    """Mark layer group as Render layer instance.

    All TVPaint layers in the scene with the color group id are rendered in the
    beauty pass. To create sub passes use Render Layer creator which is
    dependent on existence of render layer instance.
    """

    label = "Render Layer"
    product_type = "render"
    product_template_product_type = "renderLayer"
    identifier = "render.layer"
    icon = "fa5.images"

    # George script to change color group
    rename_script_template = (
        "tv_layercolor \"setcolor\""
        " {clip_id} {group_id} {r} {g} {b} \"{name}\""
    )
    # Order to be executed before Render Pass creator
    order = 90
    description = "Mark TVPaint color group as one Render Layer."
    detailed_description = RENDER_LAYER_DETAILED_DESCRIPTIONS

    # Settings
    # - Default render pass name for beauty
    default_pass_name = "beauty"
    # - Mark by default instance for review
    mark_for_review = True

    def apply_settings(self, project_settings):
        plugin_settings = (
            project_settings["tvpaint"]["create"]["create_render_layer"]
        )
        self.default_variant = plugin_settings["default_variant"]
        self.default_variants = plugin_settings["default_variants"]
        self.default_pass_name = plugin_settings["default_pass_name"]
        self.mark_for_review = plugin_settings["mark_for_review"]

    def get_dynamic_data(
        self,
        project_name,
        folder_entity,
        task_entity,
        variant,
        host_name,
        instance
    ):
        dynamic_data = super().get_dynamic_data(
            project_name,
            folder_entity,
            task_entity,
            variant,
            host_name,
            instance
        )
        dynamic_data["renderpass"] = self.default_pass_name
        dynamic_data["renderlayer"] = variant
        return dynamic_data

    def _get_selected_group_ids(self):
        return {
            layer["group_id"]
            for layer in get_layers_data()
            if layer["selected"]
        }

    def create(self, product_name, instance_data, pre_create_data):
        self.log.debug("Query data from workfile.")

        group_name = instance_data["variant"]
        group_id = pre_create_data.get("group_id")
        # This creator should run only on one group
        if group_id is None or group_id == -1:
            selected_groups = self._get_selected_group_ids()
            selected_groups.discard(0)
            if len(selected_groups) > 1:
                raise CreatorError("You have selected more than one group")

            if len(selected_groups) == 0:
                raise CreatorError("You don't have selected any group")
            group_id = tuple(selected_groups)[0]

        self.log.debug("Querying groups data from workfile.")
        groups_data = get_groups_data()
        group_item = None
        for group_data in groups_data:
            if group_data["group_id"] == group_id:
                group_item = group_data

        for instance in self.create_context.instances:
            if (
                instance.creator_identifier == self.identifier
                and instance["creator_attributes"]["group_id"] == group_id
            ):
                raise CreatorError((
                    f"Group \"{group_item.get('name')}\" is already used"
                    f" by another render layer \"{instance['productName']}\""
                ))

        self.log.debug(f"Selected group id is \"{group_id}\".")
        if "creator_attributes" not in instance_data:
            instance_data["creator_attributes"] = {}
        creator_attributes = instance_data["creator_attributes"]
        mark_for_review = pre_create_data.get("mark_for_review")
        if mark_for_review is None:
            mark_for_review = self.mark_for_review
        creator_attributes["group_id"] = group_id
        creator_attributes["mark_for_review"] = mark_for_review

        self.log.info(f"Product name is {product_name}")
        new_instance = CreatedInstance(
            self.product_type,
            product_name,
            instance_data,
            self
        )
        self._store_new_instance(new_instance)

        if not group_id or group_item["name"] == group_name:
            return new_instance

        self.log.debug("Changing name of the group.")
        # Rename TVPaint group (keep color same)
        # - groups can't contain spaces
        rename_script = self.rename_script_template.format(
            clip_id=group_item["clip_id"],
            group_id=group_item["group_id"],
            r=group_item["red"],
            g=group_item["green"],
            b=group_item["blue"],
            name=group_name
        )
        execute_george_through_file(rename_script)

        self.log.info((
            f"Name of group with index {group_id}"
            f" was changed to \"{group_name}\"."
        ))
        return new_instance

    def _get_groups_enum(self):
        groups_enum = []
        empty_groups = []
        for group in get_groups_data():
            group_name = group["name"]
            item = {
                "label": group_name,
                "value": group["group_id"]
            }
            # TVPaint have defined how many color groups is available, but
            #   the count is not consistent across versions. It is not possible
            #   to know how many groups there is.
            #
            if group_name and group_name != "0":
                if empty_groups:
                    groups_enum.extend(empty_groups)
                    empty_groups = []
                groups_enum.append(item)
            else:
                empty_groups.append(item)
        return groups_enum

    def get_pre_create_attr_defs(self):
        groups_enum = self._get_groups_enum()
        groups_enum.insert(0, {"label": "<Use selection>", "value": -1})

        return [
            EnumDef(
                "group_id",
                label="Group",
                items=groups_enum
            ),
            BoolDef(
                "mark_for_review",
                label="Review",
                default=self.mark_for_review
            )
        ]

    def get_instance_attr_defs(self):
        groups_enum = self._get_groups_enum()
        return [
            EnumDef(
                "group_id",
                label="Group",
                items=groups_enum
            ),
            BoolDef(
                "mark_for_review",
                label="Review",
                default=self.mark_for_review
            )
        ]

    def update_instances(self, update_list):
        self._update_color_groups()
        self._update_renderpass_groups()

        super().update_instances(update_list)

    def _update_color_groups(self):
        render_layer_instances = []
        for instance in self.create_context.instances:
            if instance.creator_identifier == self.identifier:
                render_layer_instances.append(instance)

        if not render_layer_instances:
            return

        groups_by_id = {
            group["group_id"]: group
            for group in get_groups_data()
        }
        grg_script_lines = []
        for instance in render_layer_instances:
            group_id = instance["creator_attributes"]["group_id"]
            variant = instance["variant"]
            group = groups_by_id[group_id]
            if group["name"] == variant:
                continue

            grg_script_lines.append(self.rename_script_template.format(
                clip_id=group["clip_id"],
                group_id=group["group_id"],
                r=group["red"],
                g=group["green"],
                b=group["blue"],
                name=variant
            ))

        if grg_script_lines:
            execute_george_through_file("\n".join(grg_script_lines))

    def _update_renderpass_groups(self):
        render_layer_instances = {}
        render_pass_instances = collections.defaultdict(list)

        for instance in self.create_context.instances:
            if instance.creator_identifier == CreateRenderPass.identifier:
                render_layer_id = (
                    instance["creator_attributes"]["render_layer_instance_id"]
                )
                render_pass_instances[render_layer_id].append(instance)
            elif instance.creator_identifier == self.identifier:
                render_layer_instances[instance.id] = instance

        if not render_pass_instances or not render_layer_instances:
            return

        layers_data = get_layers_data()
        layers_by_name = collections.defaultdict(list)
        for layer in layers_data:
            layers_by_name[layer["name"]].append(layer)

        george_lines = []
        for render_layer_id, instances in render_pass_instances.items():
            render_layer_inst = render_layer_instances.get(render_layer_id)
            if render_layer_inst is None:
                continue
            group_id = render_layer_inst["creator_attributes"]["group_id"]
            layer_names = set()
            for instance in instances:
                layer_names |= set(instance["layer_names"])

            for layer_name in layer_names:
                george_lines.extend(
                    f"tv_layercolor \"set\" {layer['layer_id']} {group_id}"
                    for layer in layers_by_name[layer_name]
                    if layer["group_id"] != group_id
                )
        if george_lines:
            execute_george_through_file("\n".join(george_lines))

TVPaintAutoDetectRenderCreator

Bases: TVPaintCreator

Create Render Layer and Render Pass instances based on scene data.

This is auto-detection creator which can be triggered by user to create instances based on information in scene. Each used color group in scene will be created as Render Layer where group name is used as variant and each TVPaint layer as Render Pass where layer name is used as variant.

Never will have any instances, all instances belong to different creators.

Source code in client/ayon_tvpaint/plugins/create/create_render.py
 689
 690
 691
 692
 693
 694
 695
 696
 697
 698
 699
 700
 701
 702
 703
 704
 705
 706
 707
 708
 709
 710
 711
 712
 713
 714
 715
 716
 717
 718
 719
 720
 721
 722
 723
 724
 725
 726
 727
 728
 729
 730
 731
 732
 733
 734
 735
 736
 737
 738
 739
 740
 741
 742
 743
 744
 745
 746
 747
 748
 749
 750
 751
 752
 753
 754
 755
 756
 757
 758
 759
 760
 761
 762
 763
 764
 765
 766
 767
 768
 769
 770
 771
 772
 773
 774
 775
 776
 777
 778
 779
 780
 781
 782
 783
 784
 785
 786
 787
 788
 789
 790
 791
 792
 793
 794
 795
 796
 797
 798
 799
 800
 801
 802
 803
 804
 805
 806
 807
 808
 809
 810
 811
 812
 813
 814
 815
 816
 817
 818
 819
 820
 821
 822
 823
 824
 825
 826
 827
 828
 829
 830
 831
 832
 833
 834
 835
 836
 837
 838
 839
 840
 841
 842
 843
 844
 845
 846
 847
 848
 849
 850
 851
 852
 853
 854
 855
 856
 857
 858
 859
 860
 861
 862
 863
 864
 865
 866
 867
 868
 869
 870
 871
 872
 873
 874
 875
 876
 877
 878
 879
 880
 881
 882
 883
 884
 885
 886
 887
 888
 889
 890
 891
 892
 893
 894
 895
 896
 897
 898
 899
 900
 901
 902
 903
 904
 905
 906
 907
 908
 909
 910
 911
 912
 913
 914
 915
 916
 917
 918
 919
 920
 921
 922
 923
 924
 925
 926
 927
 928
 929
 930
 931
 932
 933
 934
 935
 936
 937
 938
 939
 940
 941
 942
 943
 944
 945
 946
 947
 948
 949
 950
 951
 952
 953
 954
 955
 956
 957
 958
 959
 960
 961
 962
 963
 964
 965
 966
 967
 968
 969
 970
 971
 972
 973
 974
 975
 976
 977
 978
 979
 980
 981
 982
 983
 984
 985
 986
 987
 988
 989
 990
 991
 992
 993
 994
 995
 996
 997
 998
 999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
class TVPaintAutoDetectRenderCreator(TVPaintCreator):
    """Create Render Layer and Render Pass instances based on scene data.

    This is auto-detection creator which can be triggered by user to create
    instances based on information in scene. Each used color group in scene
    will be created as Render Layer where group name is used as variant and
    each TVPaint layer as Render Pass where layer name is used as variant.

    Never will have any instances, all instances belong to different creators.
    """

    product_type = "render"
    label = "Render Layer/Passes"
    identifier = "render.auto.detect.creator"
    order = CreateRenderPass.order + 10
    description = (
        "Create Render Layers and Render Passes based on scene setup"
    )
    detailed_description = AUTODETECT_RENDER_DETAILED_DESCRIPTION

    # Settings
    enabled = False
    allow_group_rename = True
    group_name_template = "L{group_index}"
    group_idx_offset = 10
    group_idx_padding = 3

    def apply_settings(self, project_settings):
        plugin_settings = (
            project_settings
            ["tvpaint"]
            ["create"]
            ["auto_detect_render"]
        )
        self.enabled = plugin_settings.get("enabled", False)
        self.allow_group_rename = plugin_settings["allow_group_rename"]
        self.group_name_template = plugin_settings["group_name_template"]
        self.group_idx_offset = plugin_settings["group_idx_offset"]
        self.group_idx_padding = plugin_settings["group_idx_padding"]

    def _rename_groups(
        self,
        groups_order: list[int],
        scene_groups: list[dict[str, Any]]
    ):
        new_group_name_by_id: dict[int, str] = {}
        groups_by_id: dict[int, dict[str, Any]] = {
            group["group_id"]: group
            for group in scene_groups
        }
        # Count only renamed groups
        for idx, group_id in enumerate(groups_order):
            group_index_value: str = (
                "{{:0>{}}}"
                .format(self.group_idx_padding)
                .format((idx + 1) * self.group_idx_offset)
            )
            group_name_fill_values: dict[str, str] = {
                "groupIdx": group_index_value,
                "groupidx": group_index_value,
                "group_idx": group_index_value,
                "group_index": group_index_value,
            }

            group_name: str = self.group_name_template.format(
                **group_name_fill_values
            )
            group: dict[str, Any] = groups_by_id[group_id]
            if group["name"] != group_name:
                new_group_name_by_id[group_id] = group_name

        grg_lines: list[str] = []
        for group_id, group_name in new_group_name_by_id.items():
            group: dict[str, Any] = groups_by_id[group_id]
            grg_line: str = (
                "tv_layercolor \"setcolor\" {} {} {} {} {} \"{}\""
            ).format(
                group["clip_id"],
                group_id,
                group["red"],
                group["green"],
                group["blue"],
                group_name
            )
            grg_lines.append(grg_line)
            group["name"] = group_name

        if grg_lines:
            execute_george_through_file("\n".join(grg_lines))

    def _prepare_render_layer(
        self,
        project_name: str,
        folder_entity: dict[str, Any],
        task_entity: dict[str, Any],
        group_id: int,
        groups: list[dict[str, Any]],
        mark_for_review: bool,
        existing_instance: Optional[CreatedInstance] = None,
    ) -> Union[CreatedInstance, None]:
        match_group: Union[dict[str, Any], None] = next(
            (
                group
                for group in groups
                if group["group_id"] == group_id
            ),
            None
        )
        if not match_group:
            return None

        task_name = task_entity["name"]
        variant: str = match_group["name"]
        creator: CreateRenderlayer = (
            self.create_context.creators[CreateRenderlayer.identifier]
        )

        product_name: str = creator.get_product_name(
            project_name,
            folder_entity,
            task_entity,
            variant,
            host_name=self.create_context.host_name,
        )
        if existing_instance is not None:
            existing_instance["folderPath"] = folder_entity["path"]
            existing_instance["task"] = task_name
            existing_instance["productName"] = product_name
            return existing_instance

        instance_data: dict[str, str] = {
            "folderPath": folder_entity["path"],
            "task": task_name,
            "productType": creator.product_type,
            "variant": variant,
        }
        pre_create_data: dict[str, str] = {
            "group_id": group_id,
            "mark_for_review": mark_for_review
        }
        return creator.create(product_name, instance_data, pre_create_data)

    def _prepare_render_passes(
        self,
        project_name: str,
        folder_entity: dict[str, Any],
        task_entity: dict[str, Any],
        render_layer_instance: CreatedInstance,
        layers: list[dict[str, Any]],
        mark_for_review: bool,
        existing_render_passes: list[CreatedInstance]
    ):
        task_name = task_entity["name"]
        creator: CreateRenderPass = (
            self.create_context.creators[CreateRenderPass.identifier]
        )
        render_pass_by_layer_name = {}
        for render_pass in existing_render_passes:
            for layer_name in render_pass["layer_names"]:
                render_pass_by_layer_name[layer_name] = render_pass

        for layer in layers:
            layer_name = layer["name"]
            variant = layer_name
            render_pass = render_pass_by_layer_name.get(layer_name)
            if render_pass is not None:
                if (render_pass["layer_names"]) > 1:
                    variant = render_pass["variant"]

            product_name = creator.get_product_name(
                project_name,
                folder_entity,
                task_entity,
                variant,
                host_name=self.create_context.host_name,
                instance=render_pass
            )

            if render_pass is not None:
                render_pass["folderPath"] = folder_entity["path"]
                render_pass["task"] = task_name
                render_pass["productName"] = product_name
                continue

            instance_data: dict[str, str] = {
                "folderPath": folder_entity["path"],
                "task": task_name,
                "productType": creator.product_type,
                "variant": variant
            }

            pre_create_data: dict[str, Any] = {
                "render_layer_instance_id": render_layer_instance.id,
                "layer_names": [layer_name],
                "mark_for_review": mark_for_review
            }
            creator.create(product_name, instance_data, pre_create_data)

    def _filter_groups(
        self,
        layers_by_group_id,
        groups_order,
        only_visible_groups
    ):
        new_groups_order = []
        for group_id in groups_order:
            layers: list[dict[str, Any]] = layers_by_group_id[group_id]
            if not layers:
                continue

            if (
                only_visible_groups
                and not any(
                    layer
                    for layer in layers
                    if layer["visible"]
                )
            ):
                continue
            new_groups_order.append(group_id)
        return new_groups_order

    def create(self, product_name, instance_data, pre_create_data):
        project_name: str = self.create_context.get_current_project_name()
        folder_path: str = instance_data["folderPath"]
        task_name: str = instance_data["task"]
        folder_entity: dict[str, Any] = ayon_api.get_folder_by_path(
            project_name, folder_path)
        task_entity: dict[str, Any] = ayon_api.get_task_by_name(
            project_name, folder_entity["id"], task_name
        )

        render_layers_by_group_id: dict[int, CreatedInstance] = {}
        render_passes_by_render_layer_id: dict[int, list[CreatedInstance]] = (
            collections.defaultdict(list)
        )
        for instance in self.create_context.instances:
            if instance.creator_identifier == CreateRenderlayer.identifier:
                group_id = instance["creator_attributes"]["group_id"]
                render_layers_by_group_id[group_id] = instance
            elif instance.creator_identifier == CreateRenderPass.identifier:
                render_layer_id = (
                    instance
                    ["creator_attributes"]
                    ["render_layer_instance_id"]
                )
                render_passes_by_render_layer_id[render_layer_id].append(
                    instance
                )

        layers_by_group_id: dict[int, list[dict[str, Any]]] = (
            collections.defaultdict(list)
        )
        scene_layers: list[dict[str, Any]] = get_layers_data()
        scene_groups: list[dict[str, Any]] = get_groups_data()
        groups_order: list[int] = []
        for layer in scene_layers:
            group_id: int = layer["group_id"]
            # Skip 'default' group
            if group_id == 0:
                continue

            layers_by_group_id[group_id].append(layer)
            if group_id not in groups_order:
                groups_order.append(group_id)

        groups_order.reverse()

        mark_layers_for_review = pre_create_data.get(
            "mark_layers_for_review", False
        )
        mark_passes_for_review = pre_create_data.get(
            "mark_passes_for_review", False
        )
        rename_groups = pre_create_data.get("rename_groups", False)
        only_visible_groups = pre_create_data.get("only_visible_groups", False)
        groups_order = self._filter_groups(
            layers_by_group_id,
            groups_order,
            only_visible_groups
        )
        if not groups_order:
            return

        if rename_groups:
            self._rename_groups(groups_order, scene_groups)

        # Make sure  all render layers are created
        for group_id in groups_order:
            instance: Union[CreatedInstance, None] = (
                self._prepare_render_layer(
                    project_name,
                    folder_entity,
                    task_entity,
                    group_id,
                    scene_groups,
                    mark_layers_for_review,
                    render_layers_by_group_id.get(group_id),
                )
            )
            if instance is not None:
                render_layers_by_group_id[group_id] = instance

        for group_id in groups_order:
            layers: list[dict[str, Any]] = layers_by_group_id[group_id]
            render_layer_instance: Union[CreatedInstance, None] = (
                render_layers_by_group_id.get(group_id)
            )
            if not layers or render_layer_instance is None:
                continue

            self._prepare_render_passes(
                project_name,
                folder_entity,
                task_entity,
                render_layer_instance,
                layers,
                mark_passes_for_review,
                render_passes_by_render_layer_id[render_layer_instance.id]
            )

    def get_pre_create_attr_defs(self) -> list[AbstractAttrDef]:
        render_layer_creator: CreateRenderlayer = (
            self.create_context.creators[CreateRenderlayer.identifier]
        )
        render_pass_creator: CreateRenderPass = (
            self.create_context.creators[CreateRenderPass.identifier]
        )
        output = []
        if self.allow_group_rename:
            output.extend([
                BoolDef(
                    "rename_groups",
                    label="Rename color groups",
                    tooltip="Will rename color groups using studio template",
                    default=True
                ),
                BoolDef(
                    "only_visible_groups",
                    label="Only visible color groups",
                    tooltip=(
                        "Render Layers and rename will happen only on color"
                        " groups with visible layers."
                    ),
                    default=True
                ),
                UISeparatorDef()
            ])
        output.extend([
            BoolDef(
                "mark_layers_for_review",
                label="Mark RenderLayers for review",
                default=render_layer_creator.mark_for_review
            ),
            BoolDef(
                "mark_passes_for_review",
                label="Mark RenderPasses for review",
                default=render_pass_creator.mark_for_review
            )
        ])
        return output