conformtools 0.6.3 → 0.6.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +1 -1
- package/dist/arriraw-GUQEZ7CH.js +0 -525
- package/dist/browser/timeline_core_bg.wasm +0 -0
- package/dist/chunk-5K56Q5EX.js +0 -3
- package/dist/chunk-6FVGUJ6L.js +0 -3
- package/dist/chunk-6TM32YIJ.js +0 -7
- package/dist/chunk-7D7H6VFW.js +0 -3
- package/dist/chunk-AACY2V3L.js +0 -3
- package/dist/chunk-BK62N3ID.js +0 -3
- package/dist/chunk-BUEIRRNY.js +0 -3
- package/dist/chunk-C2ESM27Z.js +0 -3
- package/dist/chunk-CETBLAWM.js +0 -3
- package/dist/chunk-D2RXAX5C.js +0 -3
- package/dist/chunk-D5DEQ467.js +0 -3
- package/dist/chunk-DKGGJM6Z.js +0 -3
- package/dist/chunk-DRHOPOC7.js +0 -3
- package/dist/chunk-EV52G33S.js +0 -354
- package/dist/chunk-FMYTLXWN.js +0 -3
- package/dist/chunk-GIZIR52D.js +0 -3
- package/dist/chunk-GXEVALBL.js +0 -3
- package/dist/chunk-JBSH4AK3.js +0 -3
- package/dist/chunk-LO4K2ZF3.js +0 -3
- package/dist/chunk-P7OVDUA5.js +0 -3
- package/dist/chunk-PSANHDZM.js +0 -3
- package/dist/chunk-QDWB7QU7.js +0 -3
- package/dist/chunk-R7P7WVNI.js +0 -3
- package/dist/chunk-SP5RGDAM.js +0 -3
- package/dist/chunk-TK55FA56.js +0 -3
- package/dist/chunk-UCMNH6Q6.js +0 -3
- package/dist/chunk-WE4S4PEA.js +0 -3
- package/dist/chunk-Y2BEEOPB.js +0 -3
- package/dist/claude-setup-XSNTKEU7.js +0 -5
- package/dist/cli.js +0 -17
- package/dist/clip-state-B6JOX3JE.js +0 -3
- package/dist/conformtools-decode +0 -0
- package/dist/cr3-wasm-HTRSUBJK.js +0 -3
- package/dist/dng-wasm-2I7S2SN4.js +0 -3
- package/dist/dpx-wasm-AHH7D56L.js +0 -3
- package/dist/esm-SFFBP7PS.js +0 -3
- package/dist/exr-wasm-3TAN64WQ.js +0 -3
- package/dist/h264-2LU2X635.js +0 -3
- package/dist/h264-mxf-5HJUSZLL.js +0 -3
- package/dist/http.js +0 -4
- package/dist/i2o-transfer +0 -0
- package/dist/inspect-NY36WVMH.js +0 -46
- package/dist/isobmff-HSF7B3Y7.js +0 -3
- package/dist/mcp.js +0 -14
- package/dist/media_core-R5PPN3AY.js +0 -9
- package/dist/media_core_bg-5QHIWEZB.js +0 -3
- package/dist/media_core_bg-MEORQOCQ.js +0 -3
- package/dist/mxf-IQBPP3JA.js +0 -3
- package/dist/onnxruntime-web-stub-PKJ2NZBF.js +0 -3
- package/dist/ops-PFEKOSET.js +0 -3
- package/dist/premiere-uxp/icons/panel.png +0 -0
- package/dist/premiere-uxp/icons/panel@2x.png +0 -0
- package/dist/premiere-uxp/icons/plugin.png +0 -0
- package/dist/premiere-uxp/icons/plugin@2x.png +0 -0
- package/dist/premiere-uxp/index.html +0 -38
- package/dist/premiere-uxp/index.js +0 -93
- package/dist/premiere-uxp/lib/clipmeta.js +0 -170
- package/dist/premiere-uxp/lib/ctx.js +0 -62
- package/dist/premiere-uxp/lib/handles.js +0 -57
- package/dist/premiere-uxp/lib/markers.js +0 -198
- package/dist/premiere-uxp/lib/pairing.js +0 -58
- package/dist/premiere-uxp/lib/premiere.js +0 -82
- package/dist/premiere-uxp/lib/probe.js +0 -139
- package/dist/premiere-uxp/lib/protocol.js +0 -165
- package/dist/premiere-uxp/lib/render.js +0 -38
- package/dist/premiere-uxp/lib/session.js +0 -85
- package/dist/premiere-uxp/lib/sizing.js +0 -312
- package/dist/premiere-uxp/lib/time.js +0 -82
- package/dist/premiere-uxp/lib/timeline.js +0 -336
- package/dist/premiere-uxp/lib/verbs.js +0 -20
- package/dist/premiere-uxp/lib/write.js +0 -97
- package/dist/premiere-uxp/manifest.json +0 -102
- package/dist/prores-BR2YURFP.js +0 -526
- package/dist/r3d-QLV4J6YF.js +0 -3
- package/dist/r3d-YZH6X2D7.js +0 -1025
- package/dist/resolve-bridge.py +0 -979
- package/dist/resolve-presets/conform.tools.xml +0 -127
- package/dist/source-BDJAUQVR.js +0 -3
- package/dist/sscd-embed-DHFTEIOC.js +0 -3
- package/dist/sscd-sweep-OYS4XAID.js +0 -3
- package/dist/statusline-GMMCFMOA.js +0 -4
- package/dist/statusline.js +0 -3
- package/dist/still-LORP3E5C.js +0 -3
- package/dist/tiff-wasm-6XFTTCL4.js +0 -3
- package/dist/timeline_core-VK2ZWPCO.js +0 -3
- package/dist/timeline_core_bg-DFKQ7XOU.js +0 -3
- package/dist/udf_bg-ZIB3GK52.js +0 -3
- package/dist/wasm/media_core_bg.wasm +0 -0
- package/dist/wasm/udf_bg.wasm +0 -0
- package/dist/wasm-threads/media_core_bg.wasm +0 -0
- package/dist/wav-PMVKVYNP.js +0 -3
package/dist/resolve-bridge.py
DELETED
|
@@ -1,979 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env python3
|
|
2
|
-
"""The engine's door into a running DaVinci Resolve (mcp/hosts/resolve/adapter.ts).
|
|
3
|
-
|
|
4
|
-
python3 bridge.py <action> '<json args>' -> one JSON line on stdout
|
|
5
|
-
|
|
6
|
-
Resolve's scripting API exists only for Python and Lua, so this file is the one place the engine
|
|
7
|
-
speaks it. It is glue, not know-how: every decision (what to import, what to render, what the
|
|
8
|
-
findings mean) is made in TypeScript; this file performs one host action and reports exactly what
|
|
9
|
-
Resolve said. One process per action: connecting costs ~0.1 s, and a crashed call can never wedge
|
|
10
|
-
the next one.
|
|
11
|
-
|
|
12
|
-
Safety, kept by every action (see mcp/hosts/contract.ts):
|
|
13
|
-
- read-only unless the action's name says otherwise
|
|
14
|
-
- the user's project, page and Deliver settings are restored after we touch them
|
|
15
|
-
- only our render job is ever started (StartRendering([job])), never the user's queue
|
|
16
|
-
Python 3.6+ (what Resolve supports); standard library only.
|
|
17
|
-
"""
|
|
18
|
-
import json
|
|
19
|
-
import os
|
|
20
|
-
import re
|
|
21
|
-
import shutil
|
|
22
|
-
import struct
|
|
23
|
-
import sys
|
|
24
|
-
import tempfile
|
|
25
|
-
import time
|
|
26
|
-
import uuid
|
|
27
|
-
|
|
28
|
-
OK = 0
|
|
29
|
-
FAIL = 1
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
def reply(obj, code=OK):
|
|
33
|
-
sys.stdout.write(json.dumps(obj) + "\n")
|
|
34
|
-
sys.stdout.flush()
|
|
35
|
-
sys.exit(code)
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
def fail(why, detail="", **extra):
|
|
39
|
-
out = {"ok": False, "why": why, "detail": detail}
|
|
40
|
-
out.update(extra)
|
|
41
|
-
reply(out, FAIL)
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
# ── connection ────────────────────────────────────────────────────────────
|
|
45
|
-
|
|
46
|
-
def connect():
|
|
47
|
-
"""The Resolve object, or a reply naming exactly what is missing."""
|
|
48
|
-
try:
|
|
49
|
-
import DaVinciResolveScript as dvr # noqa: N813 (Resolve's own module name)
|
|
50
|
-
except Exception as e: # module not installed / paths not set
|
|
51
|
-
fail("module", "the Resolve scripting module could not be imported: %s" % e)
|
|
52
|
-
resolve = dvr.scriptapp("Resolve")
|
|
53
|
-
if not resolve:
|
|
54
|
-
fail(
|
|
55
|
-
"no_connection",
|
|
56
|
-
"Resolve is not running, or refused the connection. Start Resolve, and set "
|
|
57
|
-
"Preferences > System > General > External scripting using: Local (Studio only).",
|
|
58
|
-
)
|
|
59
|
-
return resolve
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
def project_or_fail(resolve):
|
|
63
|
-
pm = resolve.GetProjectManager()
|
|
64
|
-
p = pm.GetCurrentProject()
|
|
65
|
-
if not p:
|
|
66
|
-
fail("no_project", "no project is open in Resolve (only the Project Manager)")
|
|
67
|
-
return pm, p
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
def timelines(project):
|
|
71
|
-
return [project.GetTimelineByIndex(i + 1) for i in range(int(project.GetTimelineCount() or 0))]
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
def find_timeline(project, name):
|
|
75
|
-
if not name:
|
|
76
|
-
t = project.GetCurrentTimeline()
|
|
77
|
-
if not t:
|
|
78
|
-
fail("no_timeline", "the project %r has no timeline open" % project.GetName())
|
|
79
|
-
return t
|
|
80
|
-
for t in timelines(project):
|
|
81
|
-
if t.GetName() == name:
|
|
82
|
-
return t
|
|
83
|
-
fail("not_found", "no timeline named %r in project %r" % (name, project.GetName()),
|
|
84
|
-
timelines=[t.GetName() for t in timelines(project)])
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
# ── actions ───────────────────────────────────────────────────────────────
|
|
88
|
-
|
|
89
|
-
def a_version(resolve, _args):
|
|
90
|
-
"""Product, version and what the API offers on this install."""
|
|
91
|
-
pm = resolve.GetProjectManager()
|
|
92
|
-
p = pm.GetCurrentProject()
|
|
93
|
-
return {
|
|
94
|
-
"ok": True,
|
|
95
|
-
"product": resolve.GetProductName(),
|
|
96
|
-
"version": resolve.GetVersionString(),
|
|
97
|
-
"project": p.GetName() if p else None,
|
|
98
|
-
"page": resolve.GetCurrentPage(),
|
|
99
|
-
"db": pm.GetCurrentDatabase() or {},
|
|
100
|
-
}
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
def a_current(resolve, _args):
|
|
104
|
-
"""What is open: project, its timelines, the timeline in the viewer, the database."""
|
|
105
|
-
pm, p = project_or_fail(resolve)
|
|
106
|
-
t = p.GetCurrentTimeline()
|
|
107
|
-
return {
|
|
108
|
-
"ok": True,
|
|
109
|
-
"product": resolve.GetProductName(),
|
|
110
|
-
"version": resolve.GetVersionString(),
|
|
111
|
-
"project": p.GetName(),
|
|
112
|
-
"timelines": [x.GetName() for x in timelines(p)],
|
|
113
|
-
"timeline": t.GetName() if t else None,
|
|
114
|
-
"tracks": tracks_of(t) if t else [],
|
|
115
|
-
"page": resolve.GetCurrentPage(),
|
|
116
|
-
"db": pm.GetCurrentDatabase() or {},
|
|
117
|
-
}
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
def tracks_of(t):
|
|
121
|
-
"""Every track of a timeline: kind, 1-based index, name, enabled, locked."""
|
|
122
|
-
out = []
|
|
123
|
-
for kind in ("video", "audio", "subtitle"):
|
|
124
|
-
for i in range(1, int(t.GetTrackCount(kind) or 0) + 1):
|
|
125
|
-
out.append({"kind": kind, "index": i, "name": t.GetTrackName(kind, i),
|
|
126
|
-
"enabled": bool(t.GetIsTrackEnabled(kind, i)), "locked": bool(t.GetIsTrackLocked(kind, i))})
|
|
127
|
-
return out
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
def pool_folder(media_pool, path, create=False):
|
|
131
|
-
"""The media pool folder at "A/B/C" under the root ("" = the root). Missing folders are created
|
|
132
|
-
only when `create`; otherwise (None, the first missing name)."""
|
|
133
|
-
f = media_pool.GetRootFolder()
|
|
134
|
-
for seg in [x for x in (path or "").split("/") if x]:
|
|
135
|
-
nxt = next((x for x in f.GetSubFolderList() or [] if x.GetName() == seg), None)
|
|
136
|
-
if not nxt and create:
|
|
137
|
-
nxt = media_pool.AddSubFolder(f, seg)
|
|
138
|
-
if not nxt:
|
|
139
|
-
return None, seg
|
|
140
|
-
f = nxt
|
|
141
|
-
return f, None
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
def a_project(resolve, args):
|
|
145
|
-
"""Read-only project awareness: the media pool tree (folders, clip counts, optionally every clip
|
|
146
|
-
with its file), which pool clips match `find` (a path, or a name fragment), the render queue
|
|
147
|
-
with every job's settings as Resolve reports them, and the tracks of a timeline."""
|
|
148
|
-
_pm, p = project_or_fail(resolve)
|
|
149
|
-
mp = p.GetMediaPool()
|
|
150
|
-
want_clips = bool(args.get("clips"))
|
|
151
|
-
finds = [str(q) for q in args.get("find") or []]
|
|
152
|
-
found = dict((q, []) for q in finds)
|
|
153
|
-
|
|
154
|
-
# ponytail: GetClipProperty per clip walks the whole pool; fine for thousands, page it if it ever is not
|
|
155
|
-
def walk(folder, path):
|
|
156
|
-
clips = folder.GetClipList() or []
|
|
157
|
-
node = {"path": path, "clips": len(clips), "folders": []}
|
|
158
|
-
if want_clips or finds:
|
|
159
|
-
rows = []
|
|
160
|
-
for c in clips:
|
|
161
|
-
pr = c.GetClipProperty() or {}
|
|
162
|
-
row = {"name": c.GetName(), "file": pr.get("File Path") or "", "start_tc": pr.get("Start TC") or "",
|
|
163
|
-
"usage": pr.get("Usage") or "", "folder": path}
|
|
164
|
-
rows.append(row)
|
|
165
|
-
for q in finds:
|
|
166
|
-
if ("/" in q and row["file"] and os.path.normpath(row["file"]) == os.path.normpath(q)) or (
|
|
167
|
-
"/" not in q and (q.lower() in row["name"].lower()
|
|
168
|
-
or q.lower() in os.path.basename(row["file"]).lower())):
|
|
169
|
-
found[q].append(row)
|
|
170
|
-
if want_clips:
|
|
171
|
-
node["clip_list"] = rows
|
|
172
|
-
for sub in folder.GetSubFolderList() or []:
|
|
173
|
-
node["folders"].append(walk(sub, (path + "/" if path else "") + sub.GetName()))
|
|
174
|
-
return node
|
|
175
|
-
|
|
176
|
-
jobs = []
|
|
177
|
-
for j in p.GetRenderJobList() or []:
|
|
178
|
-
j = dict(j)
|
|
179
|
-
st = p.GetRenderJobStatus(j.get("JobId")) or {}
|
|
180
|
-
j["JobStatus"] = st.get("JobStatus", "")
|
|
181
|
-
j["CompletionPercentage"] = st.get("CompletionPercentage")
|
|
182
|
-
jobs.append(j)
|
|
183
|
-
t = find_timeline(p, args.get("timeline")) if (args.get("timeline") or p.GetCurrentTimeline()) else None
|
|
184
|
-
return {"ok": True, "project": p.GetName(), "pool": walk(mp.GetRootFolder(), ""), "found": found,
|
|
185
|
-
"jobs": jobs, "timeline": t.GetName() if t else None, "tracks": tracks_of(t) if t else [],
|
|
186
|
-
"timelines": [x.GetName() for x in timelines(p)], "page": resolve.GetCurrentPage()}
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
def a_export(resolve, args):
|
|
190
|
-
"""A timeline → Resolve's own .drt (read-only on the project). The user's current timeline
|
|
191
|
-
is left (or put back) as it was.
|
|
192
|
-
|
|
193
|
-
Resolve's Export is fussy about the target path (spaces / non-ASCII / a folder instead of a
|
|
194
|
-
file all come back as a bare False), so it always writes to a plain ASCII temp file that we
|
|
195
|
-
then move to out_path. Some builds also refuse a timeline that is not the current one: on a
|
|
196
|
-
False we retry once with it made current, then restore the user's timeline."""
|
|
197
|
-
_pm, p = project_or_fail(resolve)
|
|
198
|
-
t = find_timeline(p, args.get("timeline"))
|
|
199
|
-
out = args["out_path"]
|
|
200
|
-
if os.path.isdir(out) or not os.path.splitext(out)[1]:
|
|
201
|
-
out = os.path.join(out, safe_name(t.GetName()) + ".drt")
|
|
202
|
-
parent = os.path.dirname(os.path.abspath(out))
|
|
203
|
-
if not os.path.isdir(parent):
|
|
204
|
-
os.makedirs(parent)
|
|
205
|
-
tmp_dir = tempfile.mkdtemp(prefix="conform_export_")
|
|
206
|
-
tmp = os.path.join(tmp_dir, "timeline.drt")
|
|
207
|
-
|
|
208
|
-
def wrote():
|
|
209
|
-
return os.path.isfile(tmp) and os.path.getsize(tmp) > 0
|
|
210
|
-
|
|
211
|
-
try:
|
|
212
|
-
ok = bool(t.Export(tmp, resolve.EXPORT_DRT))
|
|
213
|
-
prev = p.GetCurrentTimeline()
|
|
214
|
-
if not wrote() and (not prev or prev.GetName() != t.GetName()):
|
|
215
|
-
p.SetCurrentTimeline(t)
|
|
216
|
-
try:
|
|
217
|
-
ok = bool(t.Export(tmp, resolve.EXPORT_DRT))
|
|
218
|
-
finally:
|
|
219
|
-
if prev:
|
|
220
|
-
p.SetCurrentTimeline(prev)
|
|
221
|
-
# Export returns True for some failures and writes a bundle for others: trust the file.
|
|
222
|
-
if not wrote():
|
|
223
|
-
fail("export_failed", "Resolve did not write the .drt for %r (Export returned %s)" % (t.GetName(), ok))
|
|
224
|
-
if os.path.exists(out):
|
|
225
|
-
os.remove(out)
|
|
226
|
-
shutil.move(tmp, out)
|
|
227
|
-
finally:
|
|
228
|
-
shutil.rmtree(tmp_dir, ignore_errors=True)
|
|
229
|
-
return {"ok": True, "path": out, "format": "drt", "project": p.GetName(), "timeline": t.GetName()}
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
def safe_name(name):
|
|
233
|
-
"""A timeline name as a file name: anything but [A-Za-z0-9._-] becomes _."""
|
|
234
|
-
return re.sub(r"[^A-Za-z0-9._-]+", "_", name).strip("_") or "timeline"
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
OUR_FOLDER = "conform.tools"
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
def unique_name(project, wanted):
|
|
241
|
-
taken = set(t.GetName() for t in timelines(project))
|
|
242
|
-
if wanted not in taken:
|
|
243
|
-
return wanted
|
|
244
|
-
n = 2
|
|
245
|
-
while "%s (%d)" % (wanted, n) in taken:
|
|
246
|
-
n += 1
|
|
247
|
-
return "%s (%d)" % (wanted, n)
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
def our_folder(media_pool):
|
|
251
|
-
"""The media pool folder our imports land in, created under the root if missing."""
|
|
252
|
-
root = media_pool.GetRootFolder()
|
|
253
|
-
for f in root.GetSubFolderList() or []:
|
|
254
|
-
if f.GetName() == OUR_FOLDER:
|
|
255
|
-
return f
|
|
256
|
-
return media_pool.AddSubFolder(root, OUR_FOLDER)
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
def a_open(resolve, args):
|
|
260
|
-
"""A timeline file -> a NEW timeline in the open project (never overwrites), inside the
|
|
261
|
-
conform.tools media pool folder, or `folder` ("000 - TIMELINES/20261006"; missing folders are
|
|
262
|
-
created only with `create_folder`). `link_existing` imports with importSourceClips False: the
|
|
263
|
-
timeline links to clips already in the pool, no duplicates. The user's timeline, folder and page
|
|
264
|
-
are restored unless `stay`. `into: scratch` switches to (or creates) our scratch project instead,
|
|
265
|
-
saving the user's project first so nothing of theirs is lost, and switches back afterwards."""
|
|
266
|
-
pm, p = project_or_fail(resolve)
|
|
267
|
-
path = args["path"]
|
|
268
|
-
if not os.path.isfile(path):
|
|
269
|
-
fail("not_found", "no file at %s" % path)
|
|
270
|
-
page = resolve.GetCurrentPage()
|
|
271
|
-
prev_project = p.GetName()
|
|
272
|
-
if args.get("into") == "scratch":
|
|
273
|
-
scratch = args.get("scratch_project") or "conform.tools scratch"
|
|
274
|
-
if prev_project != scratch:
|
|
275
|
-
pm.SaveProject()
|
|
276
|
-
if not pm.LoadProject(scratch):
|
|
277
|
-
if not pm.CreateProject(scratch):
|
|
278
|
-
fail("scratch_failed", "could not open or create the project %r" % scratch)
|
|
279
|
-
p = pm.GetCurrentProject()
|
|
280
|
-
prev_tl = p.GetCurrentTimeline()
|
|
281
|
-
mp = p.GetMediaPool()
|
|
282
|
-
prev_folder = mp.GetCurrentFolder()
|
|
283
|
-
|
|
284
|
-
def restore():
|
|
285
|
-
if prev_folder:
|
|
286
|
-
mp.SetCurrentFolder(prev_folder)
|
|
287
|
-
if prev_tl:
|
|
288
|
-
p.SetCurrentTimeline(prev_tl)
|
|
289
|
-
if args.get("into") == "scratch" and prev_project != p.GetName():
|
|
290
|
-
pm.SaveProject()
|
|
291
|
-
pm.LoadProject(prev_project)
|
|
292
|
-
if resolve.GetCurrentPage() != page:
|
|
293
|
-
resolve.OpenPage(page)
|
|
294
|
-
return True
|
|
295
|
-
|
|
296
|
-
if args.get("folder"):
|
|
297
|
-
folder, missing = pool_folder(mp, args["folder"], bool(args.get("create_folder")))
|
|
298
|
-
if not folder:
|
|
299
|
-
restore()
|
|
300
|
-
fail("no_folder", "no media pool folder %r in %r (pass create_folder to create it)" % (missing, args["folder"]))
|
|
301
|
-
folder_name = args["folder"]
|
|
302
|
-
else:
|
|
303
|
-
folder, folder_name = our_folder(mp), OUR_FOLDER
|
|
304
|
-
if folder:
|
|
305
|
-
mp.SetCurrentFolder(folder)
|
|
306
|
-
name = unique_name(p, args.get("name") or os.path.splitext(os.path.basename(path))[0])
|
|
307
|
-
link = bool(args.get("link_existing"))
|
|
308
|
-
opts = {"timelineName": name, "importSourceClips": not link}
|
|
309
|
-
if args.get("media_dir") and not link:
|
|
310
|
-
opts["sourceClipsPath"] = args["media_dir"]
|
|
311
|
-
tl = mp.ImportTimelineFromFile(path, opts)
|
|
312
|
-
if not tl and not link:
|
|
313
|
-
tl = mp.ImportTimelineFromFile(path, {"timelineName": name, "importSourceClips": False})
|
|
314
|
-
notes = []
|
|
315
|
-
if tl and tl.GetName() != name: # Resolve may name it after the file
|
|
316
|
-
tl.SetName(name)
|
|
317
|
-
got = tl.GetName() if tl else None
|
|
318
|
-
restored = restore() if (not args.get("stay") or not tl) else False
|
|
319
|
-
if not tl:
|
|
320
|
-
fail("import_failed", "Resolve refused to import %s" % path, restored=restored)
|
|
321
|
-
if not opts.get("sourceClipsPath") and args.get("media_dir"):
|
|
322
|
-
notes.append("media_dir was not used" + (" (link_existing links to clips already in the pool)" if link else ""))
|
|
323
|
-
return {"ok": True, "project": p.GetName(), "timeline": got, "folder": folder_name if folder else None,
|
|
324
|
-
"linked_existing": link, "restored": restored, "notes": notes}
|
|
325
|
-
|
|
326
|
-
|
|
327
|
-
def tc_frames(tc, fps):
|
|
328
|
-
""""HH:MM:SS:FF" (";FF" drop-frame at 29.97/59.94) -> absolute frames; None when not a timecode."""
|
|
329
|
-
m = re.match(r"^(\d+)[:;.](\d+)[:;.](\d+)([:;.])(\d+)$", str(tc).strip())
|
|
330
|
-
if not m:
|
|
331
|
-
return None
|
|
332
|
-
h, mi, se, ff = int(m.group(1)), int(m.group(2)), int(m.group(3)), int(m.group(5))
|
|
333
|
-
r = int(round(float(fps)))
|
|
334
|
-
n = (h * 3600 + mi * 60 + se) * r + ff
|
|
335
|
-
if m.group(4) == ";" and r in (30, 60):
|
|
336
|
-
total = h * 60 + mi
|
|
337
|
-
n -= (2 if r == 30 else 4) * (total - total // 10)
|
|
338
|
-
return n
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
# ── render ────────────────────────────────────────────────────────────────
|
|
342
|
-
#
|
|
343
|
-
# Stateless across calls: render_start returns what to restore, the engine keeps it in its job
|
|
344
|
-
# record and hands it back to render_finish. Settings are restored right after AddRenderJob (a
|
|
345
|
-
# queued job keeps the settings it was added with), so the user's Deliver page is theirs again
|
|
346
|
-
# while our job renders; their timeline and page come back in render_finish.
|
|
347
|
-
|
|
348
|
-
KEEP_PREFIX = "__ct_keep_"
|
|
349
|
-
|
|
350
|
-
|
|
351
|
-
def find_job(project, job_id):
|
|
352
|
-
for j in project.GetRenderJobList() or []:
|
|
353
|
-
if j.get("JobId") == job_id:
|
|
354
|
-
return j
|
|
355
|
-
return None
|
|
356
|
-
|
|
357
|
-
|
|
358
|
-
def track_matches(t, ref):
|
|
359
|
-
"""1-based video track indices named `ref` (case-insensitive, every track so named) or "V7"."""
|
|
360
|
-
r = str(ref).strip().lower()
|
|
361
|
-
return [i for i in range(1, int(t.GetTrackCount("video") or 0) + 1)
|
|
362
|
-
if (t.GetTrackName("video", i) or "").strip().lower() == r or "v%d" % i == r]
|
|
363
|
-
|
|
364
|
-
|
|
365
|
-
def video_tracks_named(t, refs):
|
|
366
|
-
"""track_matches for every ref; any ref without a track refuses before anything is touched."""
|
|
367
|
-
out = []
|
|
368
|
-
for ref in refs:
|
|
369
|
-
hit = track_matches(t, ref)
|
|
370
|
-
if not hit:
|
|
371
|
-
fail("no_track", "no video track named %r on %r" % (ref, t.GetName()),
|
|
372
|
-
tracks=[{"index": i, "name": t.GetTrackName("video", i)}
|
|
373
|
-
for i in range(1, int(t.GetTrackCount("video") or 0) + 1)])
|
|
374
|
-
out += [i for i in hit if i not in out]
|
|
375
|
-
return sorted(out)
|
|
376
|
-
|
|
377
|
-
|
|
378
|
-
def set_video_tracks(resolve, t, indices, enabled):
|
|
379
|
-
"""SetTrackEnable takes effect only on the Edit page (elsewhere it returns True and does
|
|
380
|
-
nothing; Resolve 21.1): switch to Edit, set, read every track back. Returns those that did not
|
|
381
|
-
take."""
|
|
382
|
-
if indices and resolve.GetCurrentPage() != "edit":
|
|
383
|
-
resolve.OpenPage("edit")
|
|
384
|
-
for i in indices:
|
|
385
|
-
t.SetTrackEnable("video", i, enabled)
|
|
386
|
-
return [i for i in indices if bool(t.GetIsTrackEnabled("video", i)) != enabled]
|
|
387
|
-
|
|
388
|
-
|
|
389
|
-
def a_render_start(resolve, args):
|
|
390
|
-
_pm, p = project_or_fail(resolve)
|
|
391
|
-
if p.IsRenderingInProgress():
|
|
392
|
-
fail("busy", "Resolve is already rendering; we never interrupt someone else's render")
|
|
393
|
-
target = args["target_dir"]
|
|
394
|
-
if not os.path.isdir(target):
|
|
395
|
-
os.makedirs(target)
|
|
396
|
-
page = resolve.GetCurrentPage()
|
|
397
|
-
if args.get("renderplugin") is not None or args.get("preset") or args.get("audio_tracks"):
|
|
398
|
-
_deliver_ready(resolve, p)
|
|
399
|
-
prev_tl = p.GetCurrentTimeline()
|
|
400
|
-
tl = find_timeline(p, args.get("timeline"))
|
|
401
|
-
if not prev_tl or prev_tl.GetName() != tl.GetName():
|
|
402
|
-
p.SetCurrentTimeline(tl)
|
|
403
|
-
# The documented RenderSettings have no per-job track selection ("Render All Video Tracks"):
|
|
404
|
-
# the named tracks are switched off for our job and back on when it ends (render_finish).
|
|
405
|
-
off = []
|
|
406
|
-
if args.get("disable_tracks"):
|
|
407
|
-
off = [i for i in video_tracks_named(tl, args["disable_tracks"]) if tl.GetIsTrackEnabled("video", i)]
|
|
408
|
-
bad = set_video_tracks(resolve, tl, off, False)
|
|
409
|
-
if bad:
|
|
410
|
-
set_video_tracks(resolve, tl, off, True)
|
|
411
|
-
resolve.OpenPage(page)
|
|
412
|
-
fail("tracks_not_disabled", "Resolve did not switch off video track(s) %s; nothing was queued" % bad)
|
|
413
|
-
if args.get("renderplugin") is not None or args.get("preset"):
|
|
414
|
-
resolve.OpenPage("deliver")
|
|
415
|
-
try:
|
|
416
|
-
return _queue_and_start(resolve, p, tl, args, target, page, prev_tl, off)
|
|
417
|
-
except BaseException:
|
|
418
|
-
if off:
|
|
419
|
-
set_video_tracks(resolve, tl, off, True)
|
|
420
|
-
resolve.OpenPage(page)
|
|
421
|
-
raise
|
|
422
|
-
|
|
423
|
-
|
|
424
|
-
def _queue_and_start(resolve, p, tl, args, target, page, prev_tl, off):
|
|
425
|
-
keep = "%s%d_%d" % (KEEP_PREFIX, os.getpid(), int(time.time() * 1000))
|
|
426
|
-
kept = bool(p.SaveAsNewRenderPreset(keep))
|
|
427
|
-
routed, rejected = None, []
|
|
428
|
-
if args.get("renderplugin") is not None:
|
|
429
|
-
args["preset"] = QC_PRESET
|
|
430
|
-
for f in QC_REPORTS: # a stale report from an earlier run is the classic wrong answer
|
|
431
|
-
if os.path.exists(os.path.join(target, f)):
|
|
432
|
-
os.remove(os.path.join(target, f))
|
|
433
|
-
_write_qc_config(target, args["renderplugin"])
|
|
434
|
-
try:
|
|
435
|
-
if args.get("preset"):
|
|
436
|
-
if args["preset"] not in (p.GetRenderPresetList() or []):
|
|
437
|
-
fail("no_preset", "no render preset named %r" % args["preset"], presets=p.GetRenderPresetList() or [])
|
|
438
|
-
p.LoadRenderPreset(args["preset"])
|
|
439
|
-
if args.get("audio_tracks"): # no API key for output routing: a preset carries it
|
|
440
|
-
routed = _routed_settings(resolve, p, args["audio_tracks"])
|
|
441
|
-
settings = {"TargetDir": target, "CustomName": args.get("name") or tl.GetName(),
|
|
442
|
-
"ExportVideo": True, "ExportAudio": bool(args.get("audio") or args.get("audio_tracks"))}
|
|
443
|
-
rng = args.get("range")
|
|
444
|
-
if rng:
|
|
445
|
-
settings.update({"SelectAllFrames": False, "MarkIn": int(rng["in"]), "MarkOut": int(rng["out"])})
|
|
446
|
-
else:
|
|
447
|
-
settings["SelectAllFrames"] = True
|
|
448
|
-
if not p.SetRenderSettings(settings):
|
|
449
|
-
# False when ANY key is refused, and nobody can tell what was applied: one key at a time says which
|
|
450
|
-
rejected = [k for k, v in settings.items() if not p.SetRenderSettings({k: v})]
|
|
451
|
-
job = p.AddRenderJob()
|
|
452
|
-
if not job:
|
|
453
|
-
fail("render_refused", "Resolve did not queue the job (check the format/codec and target folder)")
|
|
454
|
-
finally:
|
|
455
|
-
if routed:
|
|
456
|
-
p.DeleteRenderPreset(routed)
|
|
457
|
-
if kept:
|
|
458
|
-
p.LoadRenderPreset(keep)
|
|
459
|
-
p.DeleteRenderPreset(keep)
|
|
460
|
-
if not p.StartRendering([job]):
|
|
461
|
-
p.DeleteRenderJob(job)
|
|
462
|
-
fail("render_refused", "Resolve would not start the job")
|
|
463
|
-
return {"ok": True, "job_id": job, "timeline": tl.GetName(), "project": p.GetName(),
|
|
464
|
-
"settings_restored": kept, "disabled_tracks": off, "audio_tracks": args.get("audio_tracks") or [],
|
|
465
|
-
"rejected_settings": rejected,
|
|
466
|
-
"restore": {"timeline": prev_tl.GetName() if prev_tl else None, "page": page,
|
|
467
|
-
"rendered": tl.GetName(), "tracks": off}}
|
|
468
|
-
|
|
469
|
-
|
|
470
|
-
def a_render_status(resolve, args):
|
|
471
|
-
_pm, p = project_or_fail(resolve)
|
|
472
|
-
st = p.GetRenderJobStatus(args["job_id"]) or {}
|
|
473
|
-
status = st.get("JobStatus", "")
|
|
474
|
-
rendering = bool(p.IsRenderingInProgress())
|
|
475
|
-
if status in ("Complete", "Completed"):
|
|
476
|
-
state = "complete"
|
|
477
|
-
elif status in ("Failed",):
|
|
478
|
-
state = "failed"
|
|
479
|
-
elif status in ("Cancelled",):
|
|
480
|
-
state = "cancelled"
|
|
481
|
-
elif not rendering and status not in ("", "Rendering", "Queued", "Ready"):
|
|
482
|
-
state = "complete"
|
|
483
|
-
elif not find_job(p, args["job_id"]):
|
|
484
|
-
state = "failed"
|
|
485
|
-
st["Error"] = st.get("Error") or "the job is no longer in Resolve's render queue"
|
|
486
|
-
else:
|
|
487
|
-
state = "rendering" if rendering else "queued"
|
|
488
|
-
return {"ok": True, "job_id": args["job_id"], "state": state, "status": status,
|
|
489
|
-
"percent": int(st.get("CompletionPercentage") or 0), "error": st.get("Error")}
|
|
490
|
-
|
|
491
|
-
|
|
492
|
-
def a_render_cancel(resolve, args):
|
|
493
|
-
_pm, p = project_or_fail(resolve)
|
|
494
|
-
if p.IsRenderingInProgress():
|
|
495
|
-
st = p.GetRenderJobStatus(args["job_id"]) or {}
|
|
496
|
-
if st.get("JobStatus") == "Rendering":
|
|
497
|
-
p.StopRendering()
|
|
498
|
-
return a_render_finish(resolve, args, state="cancelled")
|
|
499
|
-
|
|
500
|
-
|
|
501
|
-
def a_render_finish(resolve, args, state=None):
|
|
502
|
-
"""Give the user back their timeline and page; a finished job stays queued, a cancelled one goes."""
|
|
503
|
-
_pm, p = project_or_fail(resolve)
|
|
504
|
-
job = find_job(p, args["job_id"])
|
|
505
|
-
out = {"ok": True, "job_id": args["job_id"], "state": state or "complete"}
|
|
506
|
-
if job:
|
|
507
|
-
out["output"] = os.path.join(job.get("TargetDir", ""), job.get("OutputFilename", ""))
|
|
508
|
-
# a finished render keeps its job, so the queue records what made each file (field report 1007);
|
|
509
|
-
# a cancelled one is taken back out
|
|
510
|
-
if out["state"] == "complete":
|
|
511
|
-
out["job_kept"] = True
|
|
512
|
-
else:
|
|
513
|
-
p.DeleteRenderJob(args["job_id"])
|
|
514
|
-
r = args.get("restore") or {}
|
|
515
|
-
if r.get("tracks"): # the tracks we switched off for this job, back on (Edit page, read back)
|
|
516
|
-
t = next((x for x in timelines(p) if x.GetName() == r.get("rendered")), None)
|
|
517
|
-
if t:
|
|
518
|
-
p.SetCurrentTimeline(t)
|
|
519
|
-
bad = set_video_tracks(resolve, t, r["tracks"], True)
|
|
520
|
-
out["tracks_restored"] = bool(t) and not bad
|
|
521
|
-
out["tracks"] = r["tracks"]
|
|
522
|
-
if r.get("timeline"):
|
|
523
|
-
for t in timelines(p):
|
|
524
|
-
if t.GetName() == r["timeline"]:
|
|
525
|
-
p.SetCurrentTimeline(t)
|
|
526
|
-
break
|
|
527
|
-
if r.get("page") and resolve.GetCurrentPage() != r["page"]:
|
|
528
|
-
resolve.OpenPage(r["page"])
|
|
529
|
-
return out
|
|
530
|
-
|
|
531
|
-
|
|
532
|
-
# ── the renderplugin (conform.tools render plugin) ───────────────────────────────────────
|
|
533
|
-
#
|
|
534
|
-
# Resolve's scripting API cannot select a plugin codec (GetRenderFormats omits it), but a saved
|
|
535
|
-
# render preset can: it stores "<pluginUUID>:<codecUUID>". We ship that preset
|
|
536
|
-
# (presets/conform.tools.xml) and import it with Resolve.ImportRenderPreset, which names the preset
|
|
537
|
-
# after the FILE and also SELECTS it, so the user's Deliver settings are snapshotted around it.
|
|
538
|
-
# Presets live per Resolve database: ensure on every QC run.
|
|
539
|
-
|
|
540
|
-
# Resolve names an imported preset after its FILE (presets/conform.tools.xml) and may cut the name at
|
|
541
|
-
# the first dot ("conform"); a cut name is renamed back below. Earlier names of ours are renamed to it.
|
|
542
|
-
QC_PRESET = "conform.tools"
|
|
543
|
-
LEGACY_PRESETS = ("CONFORM.TOOLS", "CONFORM.TOOLS QC", "Conform Tools QC")
|
|
544
|
-
QC_REPORTS = ("qc_report.json", "qc_audio.json", "qc_filmstrip.jpg")
|
|
545
|
-
|
|
546
|
-
|
|
547
|
-
def _codec_id(xml_text):
|
|
548
|
-
import re
|
|
549
|
-
m = re.search(r"<RecordFormatSubType>([^<]+)</RecordFormatSubType>", xml_text or "")
|
|
550
|
-
return m.group(1).strip().upper() if m else ""
|
|
551
|
-
|
|
552
|
-
|
|
553
|
-
def _saved_codec_id(resolve, name):
|
|
554
|
-
"""The codec a saved preset really selects (export it and read it); None when unknowable."""
|
|
555
|
-
import glob
|
|
556
|
-
import shutil
|
|
557
|
-
import tempfile
|
|
558
|
-
exporter = getattr(resolve, "ExportRenderPreset", None)
|
|
559
|
-
if exporter is None:
|
|
560
|
-
return None
|
|
561
|
-
d = tempfile.mkdtemp(prefix="ct_preset_")
|
|
562
|
-
try:
|
|
563
|
-
exporter(name, d) # the 2nd argument is a DIRECTORY; returns True regardless: trust the file
|
|
564
|
-
for f in glob.glob(os.path.join(d, "*.xml")):
|
|
565
|
-
with open(f) as fh:
|
|
566
|
-
return _codec_id(fh.read()) or None
|
|
567
|
-
return None
|
|
568
|
-
except Exception:
|
|
569
|
-
return None
|
|
570
|
-
finally:
|
|
571
|
-
shutil.rmtree(d, ignore_errors=True)
|
|
572
|
-
|
|
573
|
-
|
|
574
|
-
def _keeping_settings(project, fn):
|
|
575
|
-
"""Run fn() and put the user's Deliver settings back (import and load both SELECT a preset)."""
|
|
576
|
-
keep = "%s%d_%d" % (KEEP_PREFIX, os.getpid(), int(time.time() * 1000))
|
|
577
|
-
kept = bool(project.SaveAsNewRenderPreset(keep))
|
|
578
|
-
try:
|
|
579
|
-
return fn()
|
|
580
|
-
finally:
|
|
581
|
-
if kept:
|
|
582
|
-
project.LoadRenderPreset(keep)
|
|
583
|
-
project.DeleteRenderPreset(keep)
|
|
584
|
-
|
|
585
|
-
|
|
586
|
-
def _rename_preset(project, src, dst):
|
|
587
|
-
project.LoadRenderPreset(src)
|
|
588
|
-
if not project.SaveAsNewRenderPreset(dst):
|
|
589
|
-
return False
|
|
590
|
-
project.DeleteRenderPreset(src)
|
|
591
|
-
return True
|
|
592
|
-
|
|
593
|
-
|
|
594
|
-
def _deliver_ready(resolve, project):
|
|
595
|
-
"""Open the Deliver page and give its panel a moment before touching render presets, and sweep
|
|
596
|
-
snapshot presets an interrupted earlier run left behind (ours only: the __ct_keep_ prefix).
|
|
597
|
-
Measured 2026-10-01 on Resolve Studio 20.3.2: a first renderplugin run on a project whose Deliver
|
|
598
|
-
page had never been opened aborted Resolve inside its Deliver panel (assertion
|
|
599
|
-
GetUseProjectTimelineFilter in UiDeliverPanelTimelineController); the same calls on a project
|
|
600
|
-
whose Deliver page had been opened ran clean. This is the precaution; the exact trigger is not
|
|
601
|
-
proven. Returns the page to restore."""
|
|
602
|
-
page = resolve.GetCurrentPage()
|
|
603
|
-
if page != "deliver":
|
|
604
|
-
resolve.OpenPage("deliver")
|
|
605
|
-
time.sleep(1.0)
|
|
606
|
-
for name in project.GetRenderPresetList() or []:
|
|
607
|
-
if name.startswith((KEEP_PREFIX, ROUTE_PREFIX)):
|
|
608
|
-
project.DeleteRenderPreset(name)
|
|
609
|
-
return page
|
|
610
|
-
|
|
611
|
-
|
|
612
|
-
def a_renderplugin_preset(resolve, args):
|
|
613
|
-
"""Make sure the conform.tools render preset exists and selects OUR codec. Never deletes a preset
|
|
614
|
-
the user named; replaces ours when it is stale; renames a legacy name of ours. The user's page and
|
|
615
|
-
Deliver settings are put back."""
|
|
616
|
-
_pm, p = project_or_fail(resolve)
|
|
617
|
-
with open(args["preset_path"]) as fh:
|
|
618
|
-
expected = _codec_id(fh.read())
|
|
619
|
-
page = _deliver_ready(resolve, p)
|
|
620
|
-
try:
|
|
621
|
-
presets = p.GetRenderPresetList() or []
|
|
622
|
-
if QC_PRESET in presets:
|
|
623
|
-
got = _saved_codec_id(resolve, QC_PRESET)
|
|
624
|
-
if got is None or got == expected:
|
|
625
|
-
return {"ok": True, "preset": QC_PRESET, "imported": False}
|
|
626
|
-
_keeping_settings(p, lambda: p.DeleteRenderPreset(QC_PRESET))
|
|
627
|
-
replaced = True
|
|
628
|
-
else:
|
|
629
|
-
replaced = False
|
|
630
|
-
for legacy in LEGACY_PRESETS:
|
|
631
|
-
if legacy in presets:
|
|
632
|
-
got = _saved_codec_id(resolve, legacy)
|
|
633
|
-
if got is None or got == expected:
|
|
634
|
-
if _keeping_settings(p, lambda: _rename_preset(p, legacy, QC_PRESET)):
|
|
635
|
-
return {"ok": True, "preset": QC_PRESET, "imported": False, "renamed_from": legacy}
|
|
636
|
-
importer = getattr(resolve, "ImportRenderPreset", None)
|
|
637
|
-
if importer is None:
|
|
638
|
-
fail("no_preset_import", "this Resolve cannot import render presets (Resolve 19 or later can)")
|
|
639
|
-
before = set(p.GetRenderPresetList() or [])
|
|
640
|
-
_keeping_settings(p, lambda: importer(os.path.abspath(args["preset_path"])))
|
|
641
|
-
after = p.GetRenderPresetList() or []
|
|
642
|
-
if QC_PRESET not in after:
|
|
643
|
-
new = [x for x in after if x not in before]
|
|
644
|
-
if len(new) == 1: # Resolve may cut the name at the first dot
|
|
645
|
-
_keeping_settings(p, lambda: _rename_preset(p, new[0], QC_PRESET))
|
|
646
|
-
if QC_PRESET not in (p.GetRenderPresetList() or []):
|
|
647
|
-
fail("preset_import_failed", "Resolve did not import the conform.tools render preset")
|
|
648
|
-
return {"ok": True, "preset": QC_PRESET, "imported": True, "replaced": replaced}
|
|
649
|
-
finally:
|
|
650
|
-
if resolve.GetCurrentPage() != page:
|
|
651
|
-
resolve.OpenPage(page)
|
|
652
|
-
|
|
653
|
-
|
|
654
|
-
def _write_qc_config(folder, config):
|
|
655
|
-
"""<render folder>/qc_config.txt, flat key=value lines the codec reads at its first frame. No config:
|
|
656
|
-
remove any stale one so the codec runs every check."""
|
|
657
|
-
path = os.path.join(folder, "qc_config.txt")
|
|
658
|
-
if not config:
|
|
659
|
-
if os.path.exists(path):
|
|
660
|
-
os.remove(path)
|
|
661
|
-
return
|
|
662
|
-
lines = ["color_space=%s" % (config.get("color_space") or "sdr_rec709")]
|
|
663
|
-
if config.get("id"):
|
|
664
|
-
lines.append("template_id=%s" % config["id"])
|
|
665
|
-
for check, params in (config.get("checks") or {}).items():
|
|
666
|
-
params = params or {}
|
|
667
|
-
lines.append("%s.enabled=%d" % (check, 1 if params.get("enabled", True) else 0))
|
|
668
|
-
for k, v in params.items():
|
|
669
|
-
if k != "enabled":
|
|
670
|
-
lines.append("%s.%s=%s" % (check, k, int(v) if isinstance(v, bool) else v))
|
|
671
|
-
with open(path, "w") as fh:
|
|
672
|
-
fh.write("\n".join(lines) + "\n")
|
|
673
|
-
|
|
674
|
-
|
|
675
|
-
def a_clips(resolve, args):
|
|
676
|
-
"""The video items of a timeline (absolute frames, end exclusive) + its start frame and raster:
|
|
677
|
-
what maps a measured frame to the clip that composites it."""
|
|
678
|
-
_pm, p = project_or_fail(resolve)
|
|
679
|
-
t = find_timeline(p, args.get("timeline"))
|
|
680
|
-
out = []
|
|
681
|
-
for track in range(1, int(t.GetTrackCount("video") or 0) + 1):
|
|
682
|
-
for i, it in enumerate(t.GetItemListInTrack("video", track) or []):
|
|
683
|
-
out.append({"id": "%d:%d" % (track, i), "name": it.GetName(), "start": int(it.GetStart()),
|
|
684
|
-
"end": int(it.GetEnd()), "track": track})
|
|
685
|
-
return {"ok": True, "timeline": t.GetName(), "start_frame": int(t.GetStartFrame()),
|
|
686
|
-
"end_frame": int(t.GetEndFrame()),
|
|
687
|
-
"width": int(float(t.GetSetting("timelineResolutionWidth") or 0)),
|
|
688
|
-
"height": int(float(t.GetSetting("timelineResolutionHeight") or 0)),
|
|
689
|
-
"fps": t.GetSetting("timelineFrameRate"), "clips": out}
|
|
690
|
-
|
|
691
|
-
|
|
692
|
-
def a_markers(resolve, args):
|
|
693
|
-
"""Place or clear OUR markers on a timeline. Ours carry customData starting with the tag; a marker
|
|
694
|
-
someone else placed is never edited or deleted, and a frame they occupy is skipped and reported."""
|
|
695
|
-
_pm, p = project_or_fail(resolve)
|
|
696
|
-
t = find_timeline(p, args.get("timeline"))
|
|
697
|
-
prefix = args["tag"]
|
|
698
|
-
|
|
699
|
-
def ours_by_frame():
|
|
700
|
-
return dict((int(f), m) for f, m in (t.GetMarkers() or {}).items()
|
|
701
|
-
if str(m.get("customData") or "").startswith(prefix))
|
|
702
|
-
|
|
703
|
-
cleared = 0
|
|
704
|
-
if args.get("clear"):
|
|
705
|
-
for f in ours_by_frame():
|
|
706
|
-
if t.DeleteMarkerAtFrame(f):
|
|
707
|
-
cleared += 1
|
|
708
|
-
placed, skipped = 0, []
|
|
709
|
-
for m in args.get("place") or []:
|
|
710
|
-
f = int(m["frame"]) # relative to the timeline start, as Resolve counts markers
|
|
711
|
-
everyone = t.GetMarkers() or {}
|
|
712
|
-
if f in ours_by_frame():
|
|
713
|
-
t.DeleteMarkerAtFrame(f) # re-running replaces our own marker, never stacks a second
|
|
714
|
-
elif f in everyone or float(f) in everyone:
|
|
715
|
-
skipped.append(f) # someone else's: leave it
|
|
716
|
-
continue
|
|
717
|
-
if t.AddMarker(f, m.get("color", "Red"), m.get("name", "conform.tools"), m.get("note", ""),
|
|
718
|
-
max(1, int(m.get("duration", 1))), m.get("tag", prefix)):
|
|
719
|
-
placed += 1
|
|
720
|
-
else:
|
|
721
|
-
skipped.append(f)
|
|
722
|
-
return {"ok": True, "timeline": t.GetName(), "placed": placed, "cleared": cleared, "skipped": skipped}
|
|
723
|
-
|
|
724
|
-
|
|
725
|
-
# ── render presets: read and author what the scripting API cannot set ──────────────────────
|
|
726
|
-
#
|
|
727
|
-
# The API has no key for the Deliver page's audio OUTPUT routing (which timeline track or bus feeds
|
|
728
|
-
# each output track) — but a render preset stores it, and Resolve exports/imports presets as XML.
|
|
729
|
-
# Decoded 2026-10-06 (LITTLE DYNAMO field report, Resolve 21.1; all 60 presets round-trip
|
|
730
|
-
# byte-exact): <FieldsBlob> is a hex Qt QDataStream map — u32 version, u32 count, then (QString key,
|
|
731
|
-
# QVariant value)*; QString = u32 byte length + UTF-16BE; QVariant = u32 type + u8 null + payload
|
|
732
|
-
# (1 bool, 2 int32, 3 uint32, 10 QString, 12 QByteArray = a nested map). Routing lives in
|
|
733
|
-
# RenderAudioTracks {"0": {TrackInfoType 0 = timeline track | 1 = bus, TrackInfoValue n (1-based)}, ...},
|
|
734
|
-
# mirrored by RecordAudioNormalizationOutputTracksEnableState and ExtraInfoMap aud_src_config
|
|
735
|
-
# ("TRK0:TRK1" = timeline tracks 1 and 2, "AUX0" = bus 1).
|
|
736
|
-
|
|
737
|
-
ROUTE_PREFIX = "__ct_route_"
|
|
738
|
-
|
|
739
|
-
|
|
740
|
-
def _qs(v):
|
|
741
|
-
b = v.encode("utf-16-be")
|
|
742
|
-
return struct.pack(">I", len(b)) + b
|
|
743
|
-
|
|
744
|
-
|
|
745
|
-
def _rqs(b, i):
|
|
746
|
-
n, = struct.unpack_from(">I", b, i)
|
|
747
|
-
i += 4
|
|
748
|
-
return (None, i) if n == 0xffffffff else (b[i:i + n].decode("utf-16-be"), i + n)
|
|
749
|
-
|
|
750
|
-
|
|
751
|
-
def blob_decode(b):
|
|
752
|
-
_ver, cnt = struct.unpack_from(">II", b, 0)
|
|
753
|
-
i, d = 8, {}
|
|
754
|
-
for _ in range(cnt):
|
|
755
|
-
k, i = _rqs(b, i)
|
|
756
|
-
t, = struct.unpack_from(">I", b, i)
|
|
757
|
-
i += 5
|
|
758
|
-
if t == 1:
|
|
759
|
-
v = bool(b[i]); i += 1
|
|
760
|
-
elif t == 2:
|
|
761
|
-
v, = struct.unpack_from(">i", b, i); i += 4
|
|
762
|
-
elif t == 3:
|
|
763
|
-
v, = struct.unpack_from(">I", b, i); i += 4
|
|
764
|
-
elif t == 10:
|
|
765
|
-
v, i = _rqs(b, i)
|
|
766
|
-
elif t == 12:
|
|
767
|
-
n, = struct.unpack_from(">I", b, i); i += 4
|
|
768
|
-
raw = b[i:i + n]; i += n
|
|
769
|
-
try:
|
|
770
|
-
v = blob_decode(raw)
|
|
771
|
-
except Exception:
|
|
772
|
-
v = raw
|
|
773
|
-
else:
|
|
774
|
-
raise ValueError("QVariant type %d for %r" % (t, k))
|
|
775
|
-
d[k] = v
|
|
776
|
-
if i != len(b):
|
|
777
|
-
raise ValueError("trailing bytes in FieldsBlob")
|
|
778
|
-
return d
|
|
779
|
-
|
|
780
|
-
|
|
781
|
-
def blob_encode(d, ver=1):
|
|
782
|
-
out = struct.pack(">II", ver, len(d))
|
|
783
|
-
for k, v in d.items():
|
|
784
|
-
out += _qs(k)
|
|
785
|
-
if isinstance(v, bool):
|
|
786
|
-
out += struct.pack(">IBB", 1, 0, v)
|
|
787
|
-
elif isinstance(v, int):
|
|
788
|
-
out += struct.pack(">IBi", 2, 0, v)
|
|
789
|
-
elif isinstance(v, str):
|
|
790
|
-
out += struct.pack(">IB", 10, 0) + _qs(v)
|
|
791
|
-
elif isinstance(v, dict):
|
|
792
|
-
raw = blob_encode(v)
|
|
793
|
-
out += struct.pack(">IBI", 12, 0, len(raw)) + raw
|
|
794
|
-
elif isinstance(v, bytes):
|
|
795
|
-
out += struct.pack(">IBI", 12, 0, len(v)) + v
|
|
796
|
-
else:
|
|
797
|
-
raise TypeError(k)
|
|
798
|
-
return out
|
|
799
|
-
|
|
800
|
-
|
|
801
|
-
def _xml_field(xml, k):
|
|
802
|
-
m = re.search(r"<%s>([^<]*)</%s>" % (k, k), xml)
|
|
803
|
-
return m.group(1) if m else None
|
|
804
|
-
|
|
805
|
-
|
|
806
|
-
def _extra(xml, k):
|
|
807
|
-
m = re.search(r"<DbKey>%s</DbKey>\s*<DbVal>([^<]*)</DbVal>" % re.escape(k), xml)
|
|
808
|
-
return m.group(1) if m else None
|
|
809
|
-
|
|
810
|
-
|
|
811
|
-
def _fields(xml):
|
|
812
|
-
m = re.search(r"<FieldsBlob>([0-9a-fA-F]*)</FieldsBlob>", xml)
|
|
813
|
-
return blob_decode(bytes.fromhex(m.group(1))) if m else {}
|
|
814
|
-
|
|
815
|
-
|
|
816
|
-
def preset_summary(xml):
|
|
817
|
-
"""What a preset renders: container, codec, raster, audio codec and output routing."""
|
|
818
|
-
f = _fields(xml)
|
|
819
|
-
routing = []
|
|
820
|
-
for _k, o in sorted((f.get("RenderAudioTracks") or {}).items(), key=lambda kv: int(kv[0])):
|
|
821
|
-
if isinstance(o, dict):
|
|
822
|
-
routing.append(("Bus %d" if o.get("TrackInfoType") == 1 else "Timeline Track %d") % o.get("TrackInfoValue", 0))
|
|
823
|
-
return {"format": _xml_field(xml, "RecordFormatType"), "codec": _xml_field(xml, "RecordFormatSubType"),
|
|
824
|
-
"width": _xml_field(xml, "FormatWidth"), "height": _xml_field(xml, "FormatHeight"),
|
|
825
|
-
"audio": _xml_field(xml, "RecordAudioEnabled"), "audio_codec": _extra(xml, "aud_codec"),
|
|
826
|
-
"audio_outputs": routing, "discrete_audio": _extra(xml, "aud_discrete") == "1"}
|
|
827
|
-
|
|
828
|
-
|
|
829
|
-
def with_audio_tracks(xml, tracks):
|
|
830
|
-
"""The preset with Deliver > Audio output n fed by timeline track tracks[n] (1-based), and a fresh DbId."""
|
|
831
|
-
m = re.search(r"<FieldsBlob>([0-9a-fA-F]*)</FieldsBlob>", xml)
|
|
832
|
-
if not m:
|
|
833
|
-
raise ValueError("not a Resolve render preset (no FieldsBlob)")
|
|
834
|
-
f = blob_decode(bytes.fromhex(m.group(1)))
|
|
835
|
-
f["RenderAudioTracks"] = dict((str(i), {"TrackInfoValue": int(n), "TrackInfoType": 0}) for i, n in enumerate(tracks))
|
|
836
|
-
f["RecordAudioNormalizationOutputTracksEnableState"] = dict((str(i), 1) for i in range(len(tracks)))
|
|
837
|
-
x = xml[:m.start(1)] + blob_encode(f).hex() + xml[m.end(1):]
|
|
838
|
-
x = re.sub(r"(<DbKey>aud_src_config</DbKey>\s*<DbVal>)[^<]*(</DbVal>)",
|
|
839
|
-
lambda g: g.group(1) + ":".join("TRK%d" % (int(n) - 1) for n in tracks) + g.group(2), x)
|
|
840
|
-
x = re.sub(r"<RecordAudioEnabled>[^<]*</RecordAudioEnabled>", "<RecordAudioEnabled>true</RecordAudioEnabled>", x)
|
|
841
|
-
return re.sub(r'DbId="[^"]+"', 'DbId="%s"' % uuid.uuid4(), x, 1)
|
|
842
|
-
|
|
843
|
-
|
|
844
|
-
def _export_xml(resolve, name):
|
|
845
|
-
d = tempfile.mkdtemp(prefix="ct_preset_")
|
|
846
|
-
try:
|
|
847
|
-
resolve.ExportRenderPreset(name, d) # a DIRECTORY; returns True regardless: trust the file
|
|
848
|
-
for root, _dirs, files in os.walk(d):
|
|
849
|
-
for fn in files:
|
|
850
|
-
if fn.endswith(".xml"):
|
|
851
|
-
with open(os.path.join(root, fn), encoding="utf-8") as fh:
|
|
852
|
-
return fh.read()
|
|
853
|
-
return None
|
|
854
|
-
finally:
|
|
855
|
-
shutil.rmtree(d, ignore_errors=True)
|
|
856
|
-
|
|
857
|
-
|
|
858
|
-
def _import_xml(resolve, p, xml, name):
|
|
859
|
-
"""Import xml as preset `name` (Resolve names it after the file; no dots in ours). It also SELECTS it."""
|
|
860
|
-
d = tempfile.mkdtemp(prefix="ct_preset_")
|
|
861
|
-
try:
|
|
862
|
-
path = os.path.join(d, name + ".xml")
|
|
863
|
-
with open(path, "w", encoding="utf-8") as fh:
|
|
864
|
-
fh.write(xml)
|
|
865
|
-
resolve.ImportRenderPreset(path)
|
|
866
|
-
finally:
|
|
867
|
-
shutil.rmtree(d, ignore_errors=True)
|
|
868
|
-
return name in (p.GetRenderPresetList() or [])
|
|
869
|
-
|
|
870
|
-
|
|
871
|
-
def _routed_settings(resolve, p, tracks):
|
|
872
|
-
"""Make the Deliver page's CURRENT settings route audio output n from timeline track tracks[n]:
|
|
873
|
-
snapshot → export → rewrite the routing → import (which selects it). Returns the preset to delete."""
|
|
874
|
-
snap = "%s%d_%d" % (ROUTE_PREFIX, os.getpid(), int(time.time() * 1000))
|
|
875
|
-
if not p.SaveAsNewRenderPreset(snap):
|
|
876
|
-
fail("render_refused", "Resolve would not snapshot the render settings to set the audio routing")
|
|
877
|
-
xml = _export_xml(resolve, snap)
|
|
878
|
-
p.DeleteRenderPreset(snap)
|
|
879
|
-
if not xml:
|
|
880
|
-
fail("render_refused", "Resolve did not export the render settings, so the audio routing cannot be set")
|
|
881
|
-
if not _import_xml(resolve, p, with_audio_tracks(xml, tracks), snap) or not p.LoadRenderPreset(snap):
|
|
882
|
-
fail("render_refused", "Resolve did not take the preset with the audio routing")
|
|
883
|
-
return snap
|
|
884
|
-
|
|
885
|
-
|
|
886
|
-
def a_presets(resolve, args):
|
|
887
|
-
"""Every render preset (or `names`) with what it renders, including the audio output routing."""
|
|
888
|
-
_pm, p = project_or_fail(resolve)
|
|
889
|
-
page = _deliver_ready(resolve, p)
|
|
890
|
-
try:
|
|
891
|
-
want = args.get("names") or [n for n in (p.GetRenderPresetList() or []) if not n.startswith(("__ct_",))]
|
|
892
|
-
out = []
|
|
893
|
-
for n in want:
|
|
894
|
-
xml = _export_xml(resolve, n)
|
|
895
|
-
row = {"name": n}
|
|
896
|
-
try:
|
|
897
|
-
row.update(preset_summary(xml) if xml else {"error": "Resolve did not export it"})
|
|
898
|
-
except Exception as e:
|
|
899
|
-
row["error"] = "could not read: %s" % e
|
|
900
|
-
out.append(row)
|
|
901
|
-
return {"ok": True, "project": p.GetName(), "presets": out}
|
|
902
|
-
finally:
|
|
903
|
-
if resolve.GetCurrentPage() != page:
|
|
904
|
-
resolve.OpenPage(page)
|
|
905
|
-
|
|
906
|
-
|
|
907
|
-
def a_preset_author(resolve, args):
|
|
908
|
-
"""Save a new preset = `base` (a preset, or the Deliver page's current settings) with the audio
|
|
909
|
-
outputs fed by timeline tracks `audio_tracks`. Never replaces an existing preset."""
|
|
910
|
-
_pm, p = project_or_fail(resolve)
|
|
911
|
-
name = args["name"]
|
|
912
|
-
if "." in name:
|
|
913
|
-
fail("invalid_args", "Resolve cuts an imported preset's name at the first dot: use a name without dots")
|
|
914
|
-
if name in (p.GetRenderPresetList() or []):
|
|
915
|
-
fail("exists", "a render preset named %r already exists; pick another name (we never replace one)" % name)
|
|
916
|
-
page = _deliver_ready(resolve, p)
|
|
917
|
-
|
|
918
|
-
def go():
|
|
919
|
-
if args.get("base"):
|
|
920
|
-
if args["base"] not in (p.GetRenderPresetList() or []):
|
|
921
|
-
fail("no_preset", "no render preset named %r" % args["base"], presets=p.GetRenderPresetList() or [])
|
|
922
|
-
xml = _export_xml(resolve, args["base"])
|
|
923
|
-
else:
|
|
924
|
-
snap = "%s%d" % (ROUTE_PREFIX, os.getpid())
|
|
925
|
-
p.SaveAsNewRenderPreset(snap)
|
|
926
|
-
xml = _export_xml(resolve, snap)
|
|
927
|
-
p.DeleteRenderPreset(snap)
|
|
928
|
-
if not xml:
|
|
929
|
-
fail("render_refused", "Resolve did not export the base settings")
|
|
930
|
-
if not _import_xml(resolve, p, with_audio_tracks(xml, args["audio_tracks"]), name):
|
|
931
|
-
fail("preset_import_failed", "Resolve did not import the new preset")
|
|
932
|
-
back = _export_xml(resolve, name)
|
|
933
|
-
return {"ok": True, "preset": name, "summary": preset_summary(back) if back else None}
|
|
934
|
-
try:
|
|
935
|
-
return _keeping_settings(p, go)
|
|
936
|
-
finally:
|
|
937
|
-
if resolve.GetCurrentPage() != page:
|
|
938
|
-
resolve.OpenPage(page)
|
|
939
|
-
|
|
940
|
-
|
|
941
|
-
ACTIONS = {
|
|
942
|
-
"version": a_version,
|
|
943
|
-
"current": a_current,
|
|
944
|
-
"project": a_project,
|
|
945
|
-
"export": a_export,
|
|
946
|
-
"open": a_open,
|
|
947
|
-
"render_start": a_render_start,
|
|
948
|
-
"render_status": a_render_status,
|
|
949
|
-
"render_cancel": a_render_cancel,
|
|
950
|
-
"render_finish": a_render_finish,
|
|
951
|
-
"renderplugin_preset": a_renderplugin_preset,
|
|
952
|
-
"clips": a_clips,
|
|
953
|
-
"markers": a_markers,
|
|
954
|
-
"presets": a_presets,
|
|
955
|
-
"preset_author": a_preset_author,
|
|
956
|
-
}
|
|
957
|
-
|
|
958
|
-
|
|
959
|
-
def main():
|
|
960
|
-
if len(sys.argv) < 2 or sys.argv[1] not in ACTIONS:
|
|
961
|
-
fail("usage", "bridge.py <%s> '<json>'" % "|".join(sorted(ACTIONS)))
|
|
962
|
-
try:
|
|
963
|
-
args = json.loads(sys.argv[2]) if len(sys.argv) > 2 else {}
|
|
964
|
-
except ValueError as e:
|
|
965
|
-
fail("usage", "arguments are not JSON: %s" % e)
|
|
966
|
-
resolve = connect()
|
|
967
|
-
t0 = time.time()
|
|
968
|
-
try:
|
|
969
|
-
out = ACTIONS[sys.argv[1]](resolve, args)
|
|
970
|
-
except SystemExit:
|
|
971
|
-
raise
|
|
972
|
-
except Exception as e: # report Resolve's own failure verbatim; never a traceback on stdout
|
|
973
|
-
fail("resolve_error", "%s: %s" % (type(e).__name__, e))
|
|
974
|
-
out["ms"] = int((time.time() - t0) * 1000)
|
|
975
|
-
reply(out)
|
|
976
|
-
|
|
977
|
-
|
|
978
|
-
if __name__ == "__main__":
|
|
979
|
-
main()
|