Skip to content

create_render_layers

Render Layer and Passes creators.

Render layer is main part which is represented by group in Harmony. All Harmony 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 Harmony layers. - Bob has 'head' which consist of 2 Harmony layers -> Render pass 'head' - Bob has 'body' which consist of 1 Harmony layer -> Render pass 'body' - Bob has 'arm' which consist of 1 Harmony 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 Harmony.

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.

AutoDetectRendeLayersPasses

Bases: HarmonyCreator

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 Harmony 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_harmony/plugins/create/create_render_layers.py
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
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
class AutoDetectRendeLayersPasses(HarmonyCreator):
    """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 Harmony 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"
    product_base_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
    default_variants = ["Main"]
    active_on_create = True

    enabled = True

    layer_name_template = {
        "enabled": False,
        "template": "G{group_index}_L{layer_index}_{variant}"
    }
    render_layer_variant_template = "G{group_index}"
    group_idx_offset = 10
    group_idx_padding = 3

    def create(self, product_name, instance_data, pre_create_data):

        project_entity = self.create_context.get_current_project_entity()
        folder_path: str = self.create_context.get_current_folder_path()
        task_name: str = self.create_context.get_current_task_name()
        folder_entity: dict[str, Any] = self.create_context.get_folder_entity(
            folder_path
        )
        task_entity: dict[str, Any] = self.create_context.get_task_entity(
            folder_path, 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_info()
        scene_groups: list[dict[str, Any]] = get_group_infos()
        for layer in scene_layers:
            group_id = layer["color"]
            layers_by_group_id[group_id].append(layer)

        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
        )
        render_target = pre_create_data.get(
            "render_target", False
        )

        only_visible_groups = pre_create_data.get(
            "only_visible_groups", False
        )
        filtered_groups = self._filter_groups(
            layers_by_group_id,
            scene_groups,
            only_visible_groups
        )
        # Make sure  all render layers are created
        for group in filtered_groups:
            instance: Union[CreatedInstance, None] = (
                self._prepare_render_layer(
                    project_entity,
                    folder_entity,
                    task_entity,
                    group.color,
                    filtered_groups,
                    mark_layers_for_review,
                    render_target,
                    render_layers_by_group_id.get(group.color),
                )
            )
            if instance is not None:
                render_layers_by_group_id[group.color] = instance

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

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

        self._wrap_nodes_in_backdrop()

    def _filter_groups(
        self,
        layers_by_group_id,
        scene_groups,
        only_visible_groups
    ):
        filtered_groups = []
        for group in scene_groups:
            layers: list[dict[str, Any]] = layers_by_group_id[group.color]
            if not layers:
                continue

            if only_visible_groups and not any(
                layer for layer in layers if layer["enabled"]
            ):
                continue
            filtered_groups.append(group)
        return filtered_groups

    @staticmethod
    def _get_render_layer_variant(
        template: str,
        group_position: int,
        group_idx_padding: int,
        group_idx_offset: int,
        log
    ) -> str:
        """Calculates render layer portion (G010)"""
        variant = None
        index_template = f"{{:0>{group_idx_padding}}}"
        group_pos = group_position * group_idx_offset
        try:
            group_index = index_template.format(group_pos)
            variant = template.format(
                group_index=group_index,
            )
        except Exception:
            log.warning(
                "Failed to create render layer variant",
                exc_info=True,
            )

        return variant

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

        task_name = task_entity["name"]
        group_idx = match_group.position
        variant: str = self._get_render_layer_variant(
            self.render_layer_variant_template,
            group_idx,
            self.group_idx_padding,
            self.group_idx_offset,
            self.log,
        )
        creator: CreateRenderLayer = self.create_context.creators[
            CreateRenderLayer.identifier
        ]
        product_name: str = creator.get_product_name(
            project_entity["name"],
            folder_entity,
            task_entity,
            variant,
            host_name=self.create_context.host_name,
            project_entity=project_entity,
        )
        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,
            "group_label": variant
        }
        pre_create_data: dict[str, Any] = {
            "group_id": group_id,
            "mark_for_review": mark_for_review,
            "render_target": render_target,
        }
        return creator.create(product_name, instance_data, pre_create_data)

    def _prepare_render_passes(
        self,
        project_entity: dict[str, Any],
        folder_entity: dict[str, Any],
        task_entity: dict[str, Any],
        render_layer_instance: CreatedInstance,
        layers: list[dict[str, Any]],
        mark_for_review: bool,
        render_target: str,
        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:
            render_pass_by_layer_name[render_pass["layer_name"]] = render_pass

        # Use renaming template to parse correct variant from existing layer
        #   names.
        name_regex = None
        if self.layer_name_template["enabled"]:
            template = self.layer_name_template["template"]
            fake_group = "___group___"
            fake_layer = "___layer___"
            fake_variant = "___variant___"
            try:
                name_regex = template.format(
                    layer_index=fake_layer,
                    group_index=fake_group,
                    variant=fake_variant,
                )
            except Exception:
                self.log.error(
                    "Failed to fill name regex template.",
                    exc_info=True
                )
                name_regex = ""

            for src, regex in (
                (fake_group, r"(?P<group>\d+)"),
                (fake_layer, r"(?P<layer>\d+)"),
                (fake_variant, r"(?P<variant>.*)"),
            ):
                name_regex = name_regex.replace(src, regex)
            name_regex = re.compile(name_regex)

        layer_positions_in_groups = get_layer_positions_in_groups(layers)

        for layer in layers:
            layer_name = layer["name"]
            variant = None
            render_pass = render_pass_by_layer_name.get(layer_name)
            if render_pass is not None and len(render_pass["layer_names"]) > 0:
                variant = render_pass["variant"]
            elif name_regex is not None:
                result = name_regex.match(layer_name)
                if result is not None:
                    variant = result.groupdict().get("variant")

            if not variant:
                variant = layer["name"]

            renderlayer = render_layer_instance["variant"]

            renderpass = get_render_pass_name(
                creator.render_pass_template,
                layer_positions_in_groups[layer["name"]],
                creator.layer_idx_padding,
                creator.layer_idx_offset,
                variant,
                self.log
            )
            if not render_pass:
                render_pass = {}

            render_pass["renderPass"] = renderpass
            render_pass["renderLayer"] = renderlayer

            product_name = creator.get_product_name(
                project_entity["name"],
                folder_entity,
                task_entity,
                variant,
                host_name=self.create_context.host_name,
                instance=render_pass,
                project_entity=project_entity,
            )

            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_name": layer_name,
                "mark_for_review": mark_for_review,
                "render_target": render_target,
            }
            creator.create(product_name, instance_data, pre_create_data)

    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
        ]
        rendering_targets = {
            "local": "Local machine rendering",
            "farm": "Farm rendering",
        }
        return [
            BoolDef(
                "only_visible_groups",
                label="Only visible color groups",
                tooltip=(
                    "Render Layers will happen only on color"
                    " groups with visible layers."
                ),
                default=True
            ),
            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,
            ),
            EnumDef(
                "render_target",
                items=rendering_targets,
                label="Render target"
            )
        ]

    def product_impl(self, name, instance_data: dict, pre_create_data: dict):
        pass

    def _wrap_nodes_in_backdrop(self):
        """Tries to wrap all nodes of a layer group into Backdrop"""
        scene_containers = harmony.get_scene_data()
        for node_name, container in scene_containers.items():
            identifier = container["creator_identifier"]
            if identifier != CreateRenderLayer.identifier:
                continue
            group_label = container["variant"]
            group_id = container["creator_attributes"]["group_id"]
            group_color = group_id
            harmony.send(
                {
                    "function": (
                        "AyonHarmony.Creators.CreateRenderLayer.formatNodes"
                    ),
                    "args": [node_name, group_label, group_color]
                }
            )

CreateRenderLayer

Bases: HarmonyRenderCreator

Mark layer group as Render layer instance.

All Harmony 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_harmony/plugins/create/create_render_layers.py
108
109
110
111
112
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
class CreateRenderLayer(HarmonyRenderCreator):
    """Mark layer group as Render layer instance.

    All Harmony 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_base_type = "render"
    product_template_product_type = "renderLayer"
    identifier = "render.layer"
    icon = "fa5.images"

    # Order to be executed before Render Pass creator
    order = 90
    description = "Mark Harmony color group as one Render Layer."
    detailed_description = RENDER_LAYER_DETAILED_DESCRIPTIONS

    # Settings
    default_variants = ["Main"]
    active_on_create = True

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

    def get_dynamic_data(
        self,
        project_name,
        folder_entity,
        task_entity,
        variant,
        host_name,
        instance
    ):
        return {
            "renderpass": self.default_pass_name,
            "renderlayer": variant,
        }

    def product_impl(self, product_name, instance_data, pre_create_data):
        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_colors()
            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]

        for instance in self.create_context.instances:
            if instance.creator_identifier != self.identifier:
                continue
            if instance["creator_attributes"]["group_id"] == group_id:
                raise CreatorError(
                    (
                        f'Group "{group_id}" is already used'
                        f' by another render layer "{instance["productName"]}"'
                    )
                )
            if instance["productName"] == product_name:
                raise CreatorError(
                    f"Product '{product_name}' already exists.")

        creator_attributes = instance_data.setdefault("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
        creator_attributes["render_target"] = pre_create_data["render_target"]

        node = self._create_nodes_for_group(group_id, product_name)
        self.log.debug(f"Created node:: {node}")
        return node

    def get_pre_create_attr_defs(self):
        enum_defs = super().get_pre_create_attr_defs()
        group_infos = get_group_infos()
        group_enum_values = [
            {"value": group.color, "label": str(group.position)}
            for group in group_infos
        ]
        group_enum_values.insert(
            0,
            {"label": "<Use selection>", "value": "-1"}
        )

        enum_defs.append(
            EnumDef("group_id", label="Group", items=group_enum_values))
        return enum_defs

    def get_instance_attr_defs(self):
        groups = get_group_infos()

        groups_enum = [
            {"value": group.color, "label": str(group.position)}
            for group in groups
        ]
        return [
            EnumDef(
                "group_id",
                label="Group",
                items=groups_enum,
                enabled=False
            ),
            BoolDef(
                "mark_for_review",
                label="Review",
                default=self.mark_for_review
            ),
            EnumDef(
                "render_target",
                items=self.rendering_targets,
                label="Render target"
            ),
        ]

    def _create_nodes_for_group(self, group_id, product_name):
        layers_data = get_layers_info()
        layers_full_names = [
            layer["fullName"]
            for layer in layers_data
            if layer["color"] == group_id
        ]

        self_name = self.__class__.__name__
        created_node = harmony.send(
            {
                "function": (
                    f"AyonHarmony.Creators.{self_name}.createLayerNodes"
                ),
                "args": [layers_full_names, product_name]
            }
        )["result"]

        return created_node

    def _get_selected_group_colors(self):
        return {
            layer["color"]
            for layer in get_layers_info()
            if layer["selected"]
        }

    def remove_instances(self, instances):
        for instance in instances:
            # There is only ever one workfile instance
            node_name = instance.transient_data["node"]
            container_data = harmony.read(node_name)
            harmony.delete_node(node_name)
            harmony.delete_node(f"{node_name}_comp")
            group_label = container_data.get("group_label")
            container_backdrop = None
            if group_label:
                container_backdrop = harmony.find_backdrop_by_name(
                    group_label
                )
            if container_backdrop:
                harmony.send(
                    {
                        "function": "AyonHarmony.removeBackdrop",
                        "args": [container_backdrop, False]
                    }
                )
            self._remove_instance_from_context(instance)

get_group_infos()

Lists all used layer colors to choose from

Source code in client/ayon_harmony/plugins/create/create_render_layers.py
925
926
927
928
929
930
931
932
933
934
935
936
937
938
def get_group_infos() -> list[GroupInfo]:
    """Lists all used layer colors to choose from"""
    # TODO cache this
    layers_data = get_layers_info()
    # to keep order
    ordered_colors = []
    for layer in layers_data:
        color = layer["color"]
        if color not in ordered_colors:
            ordered_colors.append(color)
    return [
        GroupInfo(color, idx + 1)
        for idx, color in enumerate(ordered_colors)
    ]

get_group_position(group_id, group_infos=None)

Find appropriate color for ordinal number of group

Source code in client/ayon_harmony/plugins/create/create_render_layers.py
941
942
943
944
945
946
947
948
949
950
951
952
953
def get_group_position(
    group_id: str,
    group_infos: Optional[list[GroupInfo]] = None
) -> Optional[str]:
    """Find appropriate color for ordinal number of group"""
    if not group_infos:
        group_infos = get_group_infos()
    group_position = None
    for group_item in group_infos:
        if group_item.color == group_id:
            group_position = group_item.position
            break
    return group_position

get_render_pass_name(pass_template, position_in_group, layer_idx_padding, layer_idx_offset, variant, log)

Calculates render pass portion.

It was designed to follow "L{layer_index}_{variant}" (L010_CHAR01_head)

Source code in client/ayon_harmony/plugins/create/create_render_layers.py
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
def get_render_pass_name(
    pass_template: str,
    position_in_group: int,
    layer_idx_padding: int,
    layer_idx_offset: int,
    variant: str,
    log: logging.Logger,
) -> str:
    """Calculates render pass portion.

    It was designed to follow "L{layer_index}_{variant}"
    (L010_CHAR01_head)
    """
    new_name = None
    index_template = f"{{:0>{layer_idx_padding}}}"
    layer_pos = position_in_group * layer_idx_offset
    try:
        layer_index = index_template.format(layer_pos)
        new_name = pass_template.format(
            layer_index=layer_index,
            variant=variant
        )
    except Exception:
        log.warning("Failed to create new pass name", exc_info=True)

    return new_name