Skip to content

pipeline

HarmonyHost

Bases: HostBase, IWorkfileHost, ILoadHost, IPublishHost

Source code in client/ayon_harmony/api/pipeline.py
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
class HarmonyHost(HostBase, IWorkfileHost, ILoadHost, IPublishHost):
    name = "harmony"

    _context_key = "AYON_context"

    def install(self):
        """Install Pype as host config."""
        print("Installing AYON Harmony Host ...")

        pyblish.api.register_host("harmony")
        pyblish.api.register_plugin_path(PUBLISH_PATH)
        register_loader_plugin_path(LOAD_PATH)
        register_creator_plugin_path(CREATE_PATH)

        register_event_callback("application.launched", application_launch)

    def uninstall(self):
        pyblish.api.deregister_plugin_path(PUBLISH_PATH)
        deregister_loader_plugin_path(LOAD_PATH)
        deregister_creator_plugin_path(CREATE_PATH)

    def open_workfile(self, filepath):
        return open_file(filepath)

    def save_workfile(self, filepath=None):
        return save_file(filepath)

    def work_root(self, session):
        return work_root(session)

    def get_current_workfile(self):
        return current_file()

    def workfile_has_unsaved_changes(self):
        return has_unsaved_changes()

    def get_workfile_extensions(self):
        return file_extensions()

    def get_containers(self):
        return ls()

    def get_context_data(self):
        return get_scene_data().get(self._context_key, {})

    def update_context_data(self, data, changes):
        scene_data = get_scene_data()
        context_data = scene_data.setdefault(self._context_key, {})
        context_data.update(data)
        set_scene_data(scene_data)

install()

Install Pype as host config.

Source code in client/ayon_harmony/api/pipeline.py
52
53
54
55
56
57
58
59
60
61
def install(self):
    """Install Pype as host config."""
    print("Installing AYON Harmony Host ...")

    pyblish.api.register_host("harmony")
    pyblish.api.register_plugin_path(PUBLISH_PATH)
    register_loader_plugin_path(LOAD_PATH)
    register_creator_plugin_path(CREATE_PATH)

    register_event_callback("application.launched", application_launch)

application_launch(event)

Event that is executed after Harmony is launched.

Source code in client/ayon_harmony/api/pipeline.py
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
def application_launch(event):
    """Event that is executed after Harmony is launched."""
    # fills AYON_HARMONY_JS
    ayon_harmony_path = Path(__file__).parent.parent / "js" / "AyonHarmony.js"
    ayon_harmony_js = ayon_harmony_path.read_text()

    # go through js/creators, loaders and publish folders and load all scripts
    script = ""
    for item in ["creators", "loaders", "publish"]:
        dir_to_scan = Path(__file__).parent.parent / "js" / item
        for child in dir_to_scan.iterdir():
            script += child.read_text()

    # send scripts to Harmony
    harmony.send({"script": ayon_harmony_js})
    harmony.send({"script": script})
    inject_ayon_js()

    # ensure_scene_settings()
    check_inventory()

check_inventory()

Check is scene contains outdated containers.

If it does it will colorize outdated nodes and display warning message in Harmony.

Source code in client/ayon_harmony/api/pipeline.py
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
def check_inventory():
    """Check is scene contains outdated containers.

    If it does it will colorize outdated nodes and display warning message
    in Harmony.
    """

    outdated_containers = get_outdated_containers()
    if not outdated_containers:
        return

    # Colour nodes.
    outdated_nodes = []
    for container in outdated_containers:
        if container["loader"] == "ImageSequenceLoader":
            outdated_nodes.append(
                harmony.find_node_by_name(container["name"], "READ")
            )
    harmony.send({"function": "AyonHarmony.setColor", "args": outdated_nodes})

    # Warn about outdated containers.
    msg = "There are outdated containers in the scene."
    harmony.send({"function": "AyonHarmony.message", "args": msg})

containerise(name, namespace, node, context, loader=None, suffix=None, nodes=None)

Imprint node with metadata.

Containerisation enables a tracking of version, author and origin for loaded product representations.

Parameters:

Name Type Description Default
name str

Name of resulting assembly.

required
namespace str

Namespace under which to host container.

required
node str

Node to containerise.

required
context dict

Loaded representation full context information.

required
loader str

Name of loader used to produce this container.

None
suffix str

Suffix of container, defaults to _CON.

None

Returns:

Name Type Description
container str

Path of container assembly.

Source code in client/ayon_harmony/api/pipeline.py
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
def containerise(name,
                 namespace,
                 node,
                 context,
                 loader=None,
                 suffix=None,
                 nodes=None):
    """Imprint node with metadata.

    Containerisation enables a tracking of version, author and origin
    for loaded product representations.

    Arguments:
        name (str): Name of resulting assembly.
        namespace (str): Namespace under which to host container.
        node (str): Node to containerise.
        context (dict): Loaded representation full context information.
        loader (str, optional): Name of loader used to produce this container.
        suffix (str, optional): Suffix of container, defaults to `_CON`.

    Returns:
        container (str): Path of container assembly.
    """
    if not nodes:
        nodes = []

    data = {
        "schema": "openpype:container-2.0",
        "id": AYON_CONTAINER_ID,
        "name": name,
        "namespace": namespace,
        "loader": str(loader),
        "representation": context["representation"]["id"],
        "nodes": nodes
    }

    harmony.imprint(node, data)

    return node

ensure_scene_settings()

Validate if Harmony scene has valid settings.

Source code in client/ayon_harmony/api/pipeline.py
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
def ensure_scene_settings():
    """Validate if Harmony scene has valid settings."""
    settings = get_current_context_settings()

    invalid_settings = []
    valid_settings = {}
    for key, value in settings.items():
        if value is None:
            invalid_settings.append(key)
        else:
            valid_settings[key] = value

    # Warn about missing attributes.
    if invalid_settings:
        msg = "Missing attributes:"
        for item in invalid_settings:
            msg += f"\n{item}"

        harmony.send(
            {"function": "AyonHarmony.message", "args": msg})

    set_scene_settings(valid_settings)

export_backdrop_as_template(backdrop, filepath)

Export Backdrop as Template (.tpl) file.

Parameters:

Name Type Description Default
backdrop list

Backdrop to export.

required
filepath str

Path where to save Template.

required
Source code in client/ayon_harmony/api/pipeline.py
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
def export_backdrop_as_template(backdrop, filepath):
    """Export Backdrop as Template (.tpl) file.

    Args:
        backdrop (list): Backdrop to export.
        filepath (str): Path where to save Template.
    """
    harmony.send({
        "function": "AyonHarmony.exportBackdropAsTemplate",
        "args": [
            backdrop,
            os.path.basename(filepath),
            os.path.dirname(filepath)
        ]
    })

get_current_context_settings()

Get settings on current task from server.

Returns:

Type Description

dict[str, Any]: Scene data.

Source code in client/ayon_harmony/api/pipeline.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
def get_current_context_settings():
    """Get settings on current task from server.

    Returns:
        dict[str, Any]: Scene data.

    """

    task_entity = get_current_task_entity()
    task_attributes = task_entity["attrib"]

    fps = task_attributes.get("fps")
    frame_start = task_attributes.get("frameStart")
    frame_end = task_attributes.get("frameEnd")
    handle_start = task_attributes.get("handleStart")
    handle_end = task_attributes.get("handleEnd")
    resolution_width = task_attributes.get("resolutionWidth")
    resolution_height = task_attributes.get("resolutionHeight")

    scene_data = {
        "fps": fps,
        "frameStart": frame_start,
        "frameEnd": frame_end,
        "handleStart": handle_start,
        "handleEnd": handle_end,
        "resolutionWidth": resolution_width,
        "resolutionHeight": resolution_height
    }

    return scene_data

inject_ayon_js()

Inject AyonHarmonyAPI.js into Harmony.

Source code in client/ayon_harmony/api/pipeline.py
233
234
235
236
237
238
def inject_ayon_js():
    """Inject AyonHarmonyAPI.js into Harmony."""
    ayon_harmony_js = Path(__file__).parent.joinpath("js/AyonHarmonyAPI.js")
    script = ayon_harmony_js.read_text()
    # send AyonHarmonyAPI.js to Harmony
    harmony.send({"script": script})

is_container_data(data)

Return whether data is container data.

Source code in client/ayon_harmony/api/pipeline.py
241
242
243
def is_container_data(data: dict) -> bool:
    """Return whether data is container data."""
    return data and data.get("id") in {AYON_CONTAINER_ID, AVALON_CONTAINER_ID}

ls()

Yields containers from Harmony scene.

Clean up scene data from orphaned containers.

Yields:

Name Type Description
dict

container

Source code in client/ayon_harmony/api/pipeline.py
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
def ls():
    """Yields containers from Harmony scene.

    Clean up scene data from orphaned containers.

    Yields:
        dict: container
    """
    scene_data = harmony.get_scene_data() or dict()
    all_top_names = harmony.get_all_top_names()
    cleaned_scene_data = True
    for entity_name, entity_data in scene_data.copy().items():
        if not is_container_data(entity_data):
            continue

        # Filter orphaned containers
        if entity_name not in all_top_names:
            del scene_data[entity_name]
            cleaned_scene_data = True
            continue

        if not entity_data.get("objectName"):  # backward compatibility
            entity_data["objectName"] = entity_data["name"]
        yield entity_data

    # Update scene data if cleaned
    if cleaned_scene_data:
        harmony.set_scene_data(scene_data)

set_scene_settings(settings)

Set correct scene settings in Harmony.

Parameters:

Name Type Description Default
settings dict

Scene settings.

required

Returns:

Name Type Description
dict

Dictionary of settings to set.

Source code in client/ayon_harmony/api/pipeline.py
 99
100
101
102
103
104
105
106
107
108
109
110
def set_scene_settings(settings):
    """Set correct scene settings in Harmony.

    Args:
        settings (dict): Scene settings.

    Returns:
        dict: Dictionary of settings to set.

    """
    harmony.send(
        {"function": "AyonHarmony.setSceneSettings", "args": settings})