davinci-resolve-mcp 2.195.0 → 2.197.0

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/CHANGELOG.md CHANGED
@@ -2,6 +2,58 @@
2
2
 
3
3
  Release history for the DaVinci Resolve MCP Server. The latest release is summarized in the root README; older entries live here to keep the README focused.
4
4
 
5
+ ## What's New in v2.197.0 — E145: a named generator is a black leg or a named hole
6
+
7
+ ### Fixed
8
+
9
+ - **A named generator no longer refuses the whole reel.** Once E141 named
10
+ Premiere's synthetic items by their title, a Universal Counting Leader
11
+ arrived at the bridge as an event with no file and no source-map entry,
12
+ and `eventsToAssembleSpec` refused the entire 228-cut reel as an "unmapped
13
+ source reel". Now a black generator (Black Video, black, slug) authors as
14
+ the BL leg it is — a Solid Color that renders black — and any other named
15
+ generator with no Resolve equivalent is dropped with a reason in
16
+ `report.unresolvedGenerators` (name, track, record window), a hole the
17
+ ledger names, the way unresolved compounds already are. A source map that
18
+ maps the generator's name to a rendered file places it like media. An
19
+ unmapped real reel still refuses.
20
+
21
+ On the real turnover: reels 02, 03 and 04 now conform offline through the
22
+ bridge — 226 / 147 / 257 video cuts, every dissolve and retime authored,
23
+ two leaders per reel reported as holes, black authored as black.
24
+
25
+ ## What's New in v2.196.0 — E144: Resolve's own retimes decode; a flat map is a freeze
26
+
27
+ ### Fixed
28
+
29
+ - **Resolve's own retimes decode.** Every retime Resolve 19.1.3.7 makes
30
+ itself — an XMEML import, a UI speed change, an EDL `M2` freeze, a speed
31
+ ramp — writes `KeyframesBA` in the keyed-dict form (keyframes
32
+ `{interp,YOut,YIn,Y,XOut,XIn,X}` under keys `0`, `1`, …), which the DRP
33
+ time-map reader rejected ("unsupported wire type 7"), so E140 called them
34
+ unknown. The reader now decodes both forms; keyframe 0 at X=0 is the
35
+ origin and its Y the source second the map starts on (4.0 s on a real ramp
36
+ harvest). Verbatim harvest blobs: a 50% constant reads 50, a ramp reads
37
+ its two segments (0.5 then 2.0) with the right source window, both freezes
38
+ read the second they hold.
39
+ - **A source window is the map, evaluated.** A DRT event's `srcIn`/`srcOut`
40
+ now come from evaluating the piecewise-linear map at `In` and `In +
41
+ duration` (origin included), which makes ramps, reverses and rebased maps
42
+ come out right without special cases.
43
+ - **A flat map over the 60000 sentinel is a freeze even with a source-in.**
44
+ The E66 harvest (an XMEML import of a plain 100% clip) came back with a
45
+ flat map at Y=0 and `In` 24, and its render is static at the source's frame
46
+ 0: inter-frame change 0.02 against 0.42 in the source. Resolve's XMEML
47
+ importer froze the clip silently; the event now says frozen at frame 0 and
48
+ keeps the ignored `In` as `recordDomainIn`. (The first draft of this fix
49
+ called that map a harmless identity because it fit the prose; the render
50
+ said otherwise.)
51
+
52
+ ### Measured (filed in api-limitations)
53
+
54
+ - The keyed-dict keyframe form on Resolve-made retimes, and the freeze
55
+ law with a present `<In>`.
56
+
5
57
  ## What's New in v2.195.0 — E143: a retimed DRT clip's source-in is record-domain
6
58
 
7
59
  ### Fixed
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  English | [简体中文](README.zh-CN.md)
4
4
 
5
- [![Version](https://img.shields.io/badge/version-2.195.0-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
5
+ [![Version](https://img.shields.io/badge/version-2.197.0-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
6
6
  [![npm](https://img.shields.io/npm/v/davinci-resolve-mcp.svg?label=npm&color=CB3837)](https://www.npmjs.com/package/davinci-resolve-mcp)
7
7
  [![API Coverage](https://img.shields.io/badge/API%20Coverage-100%25-brightgreen.svg)](docs/reference/api-coverage.md)
8
8
  [![Tools](https://img.shields.io/badge/MCP%20Tools-36%20(353%20full)-blue.svg)](#server-modes)
package/README.zh-CN.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  [English](README.md) | 简体中文
4
4
 
5
- [![Version](https://img.shields.io/badge/version-2.195.0-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
5
+ [![Version](https://img.shields.io/badge/version-2.197.0-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
6
6
  [![npm](https://img.shields.io/npm/v/davinci-resolve-mcp.svg?label=npm&color=CB3837)](https://www.npmjs.com/package/davinci-resolve-mcp)
7
7
  [![API Coverage](https://img.shields.io/badge/API%20Coverage-100%25-brightgreen.svg)](docs/reference/api-coverage.md)
8
8
  [![Tools](https://img.shields.io/badge/MCP%20Tools-36%20(353%20full)-blue.svg)](#服务器模式)
@@ -12,7 +12,7 @@
12
12
  [![Python](https://img.shields.io/badge/python-3.10+-green.svg)](https://www.python.org/downloads/)
13
13
  [![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://opensource.org/licenses/MIT)
14
14
 
15
- > 本翻译对应 v2.195.0 版 README。如与英文原版有出入,以 [英文原版](README.md) 为准。
15
+ > 本翻译对应 v2.197.0 版 README。如与英文原版有出入,以 [英文原版](README.md) 为准。
16
16
 
17
17
  一个 Model Context Protocol (MCP) 服务器,让 AI 助手通过官方脚本 API 控制 DaVinci Resolve Studio(达芬奇)。它提供完整的 API 覆盖,外加带护栏的工作流助手,涵盖剪辑、媒体池整理、渲染设置、审阅标记、调色、Fusion、Fairlight、项目生命周期任务、扩展开发,以及不碰源媒体的媒体分析。
18
18
 
@@ -305,7 +305,7 @@ equivalent, blocking full automation.
305
305
 
306
306
  - **Object:** `Timeline`
307
307
  - **Signature:** `(filePath, EXPORT_DRT) -> bool`
308
- - **Behavior:** Measured on a Studio 19.1.3.7 export of a 229-clip reel (E139). A SeqContainer clip (Sm2TiVideoClip / Sm2TiAudioClip) carries its record window as <Start> and <Duration> (frames, absolute), its SOURCE in-point as <In> (frames) — written EMPTY (<In/>) on every audio clip and on generator tails — <MediaFilePath>, <MediaStartTime> (seconds), <MediaFrameRate> as a 16-hex blob = one little-endian IEEE double + 8 pad bytes (24.0 = 0000000000003840…), and <MediaTimemapBA>: tag byte 0x02 + one double (the media length in seconds) on a 100% clip, a keyed Sm2TimeMap opening 00000001… on a retimed clip and on generators — its KeyframesBA is the protobuf point form (NOT the keyed-dict form a 19.1.3.7 XMEML retime import writes) and decodes with the DRP library's decodeTimemap: the keyframe slope is the speed (0.79999 on all four retimed clips of a real reel = Premiere's 80 for the same cuts, srcOut = In + round(Duration × 0.8) matching Premiere's frame for frame), XMax 60000 with a zero slope is the freeze sentinel (a Black Video generator), a negative slope is a reverse (a reversed tail leader). On a retimed clip <In> is RECORD-domain (E143): the map spans the whole source stretched by 1/speed and the clip windows into that, so the first source frame shown is In × speed — two timelines of the same reel carried the same 80% map with In 52682 (bridge-authored: source 42145, Premiere's frame) and In 42145 (hand conform: source 33716, 8,429 frames early). An Sm2TiTransition sits in the same <Items> list as the clips with <Start>/<Duration> (its span), <PrettyType> (Cross Dissolve), <AlignmentType> and <Position>: type 2 centres the span on the cut, type 3 ends it at the cut (11/11 witnessed against the clip edges; the one-sided 8-frame fade-in is type 3 / Position 1). The container carries NO frame rate, start or resolution — they live in the pool folder's embedded Sm2Sequence: <FrameRate> (LE double blob), <MediaExtents> = two LE doubles, record start SECONDS then duration SECONDS (7192.0 → frame 172608 = 01:59:52:00 at 24), <Resolution> = two big-endian uint64, width then height.
308
+ - **Behavior:** Measured on a Studio 19.1.3.7 export of a 229-clip reel (E139). A SeqContainer clip (Sm2TiVideoClip / Sm2TiAudioClip) carries its record window as <Start> and <Duration> (frames, absolute), its SOURCE in-point as <In> (frames) — written EMPTY (<In/>) on every audio clip and on generator tails — <MediaFilePath>, <MediaStartTime> (seconds), <MediaFrameRate> as a 16-hex blob = one little-endian IEEE double + 8 pad bytes (24.0 = 0000000000003840…), and <MediaTimemapBA>: tag byte 0x02 + one double (the media length in seconds) on a 100% clip, a keyed Sm2TimeMap opening 00000001… on a retimed clip and on generators — its KeyframesBA is the protobuf point form on that hand-conformed export, while every retime Resolve 19.1.3.7 MAKES itself (XMEML import, UI speed change, EDL M2 freeze, speed ramp) writes the KEYED-DICT form (E144: keyframes {interp,YOut,YIn,Y,XOut,XIn,X} under keys '0','1',…; keyframe 0 at X=0 is the origin and its Y the source second the map starts on — 4.0 on a real ramp); both decode with the DRP library's decodeTimemap: the keyframe slope is the speed (0.79999 on all four retimed clips of a real reel = Premiere's 80 for the same cuts, srcOut = In + round(Duration × 0.8) matching Premiere's frame for frame), XMax 60000 with a zero slope is the freeze sentinel a FREEZE at the source second the flat map holds, even when <In> is present: an XMEML import of a 100% clip came back with that flat map at Y=0 and In 24, and its render is static at the source's frame 0 (E144, inter-frame change 0.02 vs 0.42 in the source) — Resolve's XMEML importer froze the clip silently; a negative slope is a reverse (a reversed tail leader). On a retimed clip <In> is RECORD-domain (E143): the map spans the whole source stretched by 1/speed and the clip windows into that, so the first source frame shown is In × speed — two timelines of the same reel carried the same 80% map with In 52682 (bridge-authored: source 42145, Premiere's frame) and In 42145 (hand conform: source 33716, 8,429 frames early). An Sm2TiTransition sits in the same <Items> list as the clips with <Start>/<Duration> (its span), <PrettyType> (Cross Dissolve), <AlignmentType> and <Position>: type 2 centres the span on the cut, type 3 ends it at the cut (11/11 witnessed against the clip edges; the one-sided 8-frame fade-in is type 3 / Position 1). The container carries NO frame rate, start or resolution — they live in the pool folder's embedded Sm2Sequence: <FrameRate> (LE double blob), <MediaExtents> = two LE doubles, record start SECONDS then duration SECONDS (7192.0 → frame 172608 = 01:59:52:00 at 24), <Resolution> = two big-endian uint64, width then height.
309
309
  - **Workaround / current handling:** Read record timing from Start/Duration, source in from In (null when empty — do not fake 0 silently), fps and start from the pool sequence (frames = round(seconds × fps)); decode a keyed timemap to its speed (E140) and report a map the decoder cannot read as speed null rather than 100%. The parser exposes these and editorial.parse_interchange {format:'drt', content: PATH} walks one timeline into normalized events so two timeline versions diff through turnover_changelist (v19 vs v20 of a real reel: identical, 229 of 229 retained).
310
310
  - **Tags:** timeline, export, drt, interchange
311
311
 
package/install.py CHANGED
@@ -37,7 +37,7 @@ from src.utils.update_check import (
37
37
 
38
38
  # ─── Version ──────────────────────────────────────────────────────────────────
39
39
 
40
- VERSION = "2.195.0"
40
+ VERSION = "2.197.0"
41
41
  # Only hard floor: mcp[cli] requires Python 3.10+. There is no upper bound —
42
42
  # Resolve's scripting bridge loads into newer interpreters on recent builds
43
43
  # (Python 3.14 verified against Resolve Studio 20.3.2). Older Resolve builds
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "davinci-resolve-mcp",
3
- "version": "2.195.0",
3
+ "version": "2.197.0",
4
4
  "description": "NPM bootstrapper for the DaVinci Resolve MCP Server.",
5
5
  "license": "MIT",
6
6
  "author": "Samuel Gursky <samgursky@gmail.com>",
@@ -296,6 +296,27 @@ export function eventsToAssembleSpec(events, opts = {}) {
296
296
  }
297
297
  }
298
298
  }
299
+ // NAMED GENERATORS (E145): a Premiere Universal Counting Leader / Black
300
+ // Video (E141 names them by their Media <Title>) or a DRT generator clip
301
+ // arrives as an event with generatorName and no file. Black authors as the
302
+ // BL leg it is (a Solid Color that renders black); anything else has no
303
+ // Resolve equivalent the bridge can place, so it is DROPPED with a reason
304
+ // in unresolvedGenerators — a hole the ledger names — instead of refusing
305
+ // the whole reel as an unmapped source (a real 228-cut reel refused over
306
+ // its counting leader).
307
+ const unresolvedGenerators = [];
308
+ const isBlackGenerator = (name) => /^(black|black video|black matte|slug)$/i.test(String(name || '').trim());
309
+ for (const list of [vids, auds]) {
310
+ for (let i = list.length - 1; i >= 0; i -= 1) {
311
+ const e = list[i];
312
+ if (sourceMap[e.source] || isBL(e.source)) continue;
313
+ const gen = e.generatorName || (isBlackGenerator(e.source) ? e.source : null);
314
+ if (!gen) continue;
315
+ if (isBlackGenerator(gen)) { list[i] = { ...e, source: 'BL', generatorName: gen }; continue; }
316
+ unresolvedGenerators.push({ name: gen, track: e.track, recIn: e.recIn, recOut: e.recOut, reason: 'a named generator with no media and no Resolve equivalent the bridge can author — map its name to a rendered file in sourceMap, or accept the hole' });
317
+ list.splice(i, 1);
318
+ }
319
+ }
299
320
  const unmapped = [...new Set([...vids, ...auds].map((e) => e.source).filter((srcName) => !isBL(srcName) && !sourceMap[srcName]))];
300
321
  if (unmapped.length) {
301
322
  throw new Error(
@@ -737,6 +758,7 @@ export function eventsToAssembleSpec(events, opts = {}) {
737
758
  flattenedCompounds: [...new Set(events.filter((e) => e.fromCompound).map((e) => e.fromCompound))],
738
759
  flattenedCompoundEvents: events.filter((e) => e.fromCompound).length,
739
760
  unresolvedCompounds,
761
+ unresolvedGenerators,
740
762
  authoredAudioEvents: audioPlacements.length,
741
763
  audioRetimesSkipped,
742
764
  audioLanesBeyondCeiling,
@@ -672,15 +672,29 @@ export function drtEventsFromParsed(parsed, opts = {}) {
672
672
  // Reverse: the map descends from the source tail, In measures from
673
673
  // the END — source start = sourceFrames − In×speed − duration×speed.
674
674
  let speed = 100, srcOut = srcIn + c.duration, unknown = false, srcStart = srcIn;
675
- if (kind === 'freeze') { speed = 0; srcOut = srcIn; }
675
+ if (kind === 'freeze') {
676
+ // A real freeze holds the source second in its flat map (E144); the
677
+ // clip's <In> is empty. Zero-speed in==out event on that frame.
678
+ speed = 0; srcStart = tm && tm.freezeSec != null ? Math.round(tm.freezeSec * fps) : srcIn; srcOut = srcStart;
679
+
680
+ }
676
681
  else if (kind === 'constant' || kind === 'variable') {
682
+ // E143/E144: <In> is RECORD-domain — evaluate the map (piecewise
683
+ // linear in seconds, origin included) at In and In + duration; the
684
+ // source window is the min/max of the two, which also makes a
685
+ // reversed map (descending line) come out the right way round.
677
686
  speed = Math.round(tm.speed * 10000) / 100;
678
- const span = Math.round(c.duration * tm.speed);
679
- if (tm.reverse && tm.sourceDurationSec != null) {
680
- const sourceFrames = Math.round(tm.sourceDurationSec * fps) + 1;
681
- srcStart = Math.max(0, sourceFrames - Math.round(srcIn * tm.speed) - span);
682
- } else srcStart = Math.round(srcIn * tm.speed);
683
- srcOut = srcStart + span;
687
+ const pts = tm.points && tm.points.length >= 2 ? tm.points : null;
688
+ const mapAt = (recFrames) => {
689
+ const x = recFrames / fps;
690
+ if (!pts) return x * tm.speed * (tm.reverse ? -1 : 1);
691
+ let i = 1; while (i < pts.length - 1 && x > pts[i].recordSec) i++;
692
+ const a = pts[i - 1], b = pts[i];
693
+ const slope = b.recordSec === a.recordSec ? 0 : (b.sourceSec - a.sourceSec) / (b.recordSec - a.recordSec);
694
+ return a.sourceSec + (x - a.recordSec) * slope;
695
+ };
696
+ const s0 = Math.round(mapAt(srcIn) * fps), s1 = Math.round(mapAt(srcIn + c.duration) * fps);
697
+ srcStart = Math.max(0, Math.min(s0, s1)); srcOut = Math.max(s0, s1);
684
698
  }
685
699
  else if (kind === 'unknown') { speed = null; srcOut = null; unknown = true; }
686
700
  const ev = {
@@ -689,7 +703,7 @@ export function drtEventsFromParsed(parsed, opts = {}) {
689
703
  speed, reverse: Boolean(tm && tm.reverse), transition: null, fps,
690
704
  };
691
705
  if (media) ev.sourcePath = media;
692
- if (srcStart !== srcIn) ev.recordDomainIn = srcIn;
706
+ if (srcStart !== srcIn && c.in != null) ev.recordDomainIn = srcIn;
693
707
  if (c.in == null) ev.srcInAbsent = true;
694
708
  if (unknown) ev.retimeUnknown = true;
695
709
  if (kind === 'variable') { ev.variableSpeed = true; ev.retimeSegments = tm.segments; }
@@ -86,6 +86,27 @@ function _decodeKeyframePoint(buf) {
86
86
  */
87
87
  function _decodeKeyframes(hex) {
88
88
  if (hex == null) return { origin: { recordSec: 0, sourceSec: 0 }, keyframes: [] };
89
+ // r19 KEYED-DICT form (E144): Resolve 19.1.3.7 itself writes KeyframesBA
90
+ // as a keyed dict of keyed-dict keyframes ({interp,YOut,YIn,Y,XOut,XIn,X}
91
+ // under keys '0','1',…) on every retime it makes (XMEML import, UI speed
92
+ // change, EDL M2 freeze) — the same shape buildConstantSpeedTimemapKeyed
93
+ // emits — while an EXPORT_DRT of a hand-conformed reel carried protobuf
94
+ // points. The reader used to throw on the keyed form ("unsupported wire
95
+ // type 7"), so a Resolve-made retime read as unknown. Keyframe 0 at X=0 is
96
+ // the origin (its Y = the source second the map starts on: 4.0 on a real
97
+ // ramp harvest); the rest are the points.
98
+ const kh = String(hex).replace(/[^0-9a-fA-F]/g, '');
99
+ if (kh.startsWith('00000001')) {
100
+ const pts = [];
101
+ for (const e of decodeKeyedDict(Buffer.from(kh, 'hex')).entries) {
102
+ const inner = decodeKeyedDict(Buffer.from(String(e.value), 'hex')).entries;
103
+ const get = (k) => { const f = inner.find((x) => x.key === k); return f ? Number(f.value) : 0; };
104
+ pts.push({ recordSec: get('X'), sourceSec: get('Y') });
105
+ }
106
+ pts.sort((a, b) => a.recordSec - b.recordSec);
107
+ const origin = pts.length && pts[0].recordSec === 0 ? pts.shift() : { recordSec: 0, sourceSec: 0 };
108
+ return { origin, keyframes: pts, keyed: true };
109
+ }
89
110
  const fields = decodeProtobuf(hex);
90
111
  const originField = fields.find((f) => f.field === 2 && f.wire === 1);
91
112
  const originSource = originField
@@ -120,7 +141,7 @@ function decodeTimemap(input) {
120
141
  const get = (k) => { const e = entries.find((x) => x.key === k); return e ? e.value : undefined; };
121
142
  const recordDurationSec = get('XMax');
122
143
  const sourceDurationSec = get('LastValidYOffset');
123
- const { origin, keyframes } = _decodeKeyframes(get('KeyframesBA'));
144
+ const { origin, keyframes, keyed } = _decodeKeyframes(get('KeyframesBA'));
124
145
  const segments = _segments(keyframes, origin);
125
146
  // The EXACT speed lives in the keyframe ratios (source/record per segment); XMax and
126
147
  // LastValidYOffset are frame-quantized. `speed` is the first segment's (whole clip if 1 kf);
@@ -128,7 +149,7 @@ function decodeTimemap(input) {
128
149
  const speed = segments.length ? segments[0].speed : sourceDurationSec / recordDurationSec;
129
150
  const variable = segments.length > 1;
130
151
  return {
131
- form: 'retimed', variable, speed, segments, keyframes,
152
+ form: 'retimed', variable, speed, segments, keyframes, origin, keyframeForm: keyed ? 'keyed' : 'protobuf',
132
153
  sourceDurationSec, recordDurationSec, entries,
133
154
  };
134
155
  }
@@ -79,8 +79,17 @@ function decodeTimemapField(hex) {
79
79
  }
80
80
  if (!d || d.form !== 'retimed') return { form: 'retimed', kind: 'unknown', speed: null, reverse: false };
81
81
  const slope = d.segments && d.segments.length ? d.segments[0].speed : null;
82
- const base = { form: 'retimed', recordDurationSec: d.recordDurationSec ?? null, sourceDurationSec: d.sourceDurationSec ?? null };
83
- if (d.recordDurationSec === FREEZE_XMAX_SENTINEL && slope === 0) return { ...base, kind: 'freeze', speed: 0, reverse: false };
82
+ const points = [d.origin || { recordSec: 0, sourceSec: 0 }, ...(d.keyframes || [])];
83
+ const base = { form: 'retimed', recordDurationSec: d.recordDurationSec ?? null, sourceDurationSec: d.sourceDurationSec ?? null, keyframeForm: d.keyframeForm || null, points };
84
+ if (d.recordDurationSec === FREEZE_XMAX_SENTINEL && slope === 0) {
85
+ // A flat map over the 60000 sentinel is a FREEZE at the source second the
86
+ // map holds (Y) — with or without an <In> (E144, render-witnessed: the
87
+ // E66 harvest carries Y = 0 and In 24, and its render is static at the
88
+ // source's frame 0: inter-frame change 0.02 vs 0.42 in the source). The
89
+ // EDL M2 000.0 harvest holds Y = 1.0 with an empty <In>.
90
+ const y = points[0] ? points[0].sourceSec : 0;
91
+ return { ...base, kind: 'freeze', speed: 0, reverse: false, freezeSec: y };
92
+ }
84
93
  if (!Number.isFinite(slope) || slope === 0 || Math.abs(slope) > 100) return { ...base, kind: 'unknown', speed: null, reverse: false };
85
94
  return {
86
95
  ...base,
@@ -87,7 +87,7 @@ if not logging.getLogger().handlers:
87
87
  handlers=[logging.StreamHandler()],
88
88
  )
89
89
 
90
- VERSION = "2.195.0"
90
+ VERSION = "2.197.0"
91
91
  logger = logging.getLogger("davinci-resolve-mcp")
92
92
  logger.info(f"Starting DaVinci Resolve MCP Server v{VERSION}")
93
93
  logger.info(f"Detected platform: {get_platform()}")
package/src/server.py CHANGED
@@ -11,7 +11,7 @@ Usage:
11
11
  python src/server.py --full # Start the 353-tool granular server instead
12
12
  """
13
13
 
14
- VERSION = "2.195.0"
14
+ VERSION = "2.197.0"
15
15
 
16
16
  import base64
17
17
  import os
@@ -2744,14 +2744,24 @@ API_TRUTH: List[Dict[str, Any]] = [
2744
2744
  "0000000000003840…), and <MediaTimemapBA>: tag byte 0x02 + "
2745
2745
  "one double (the media length in seconds) on a 100% clip, a "
2746
2746
  "keyed Sm2TimeMap opening 00000001… on a retimed clip and on "
2747
- "generators — its KeyframesBA is the protobuf point form "
2748
- "(NOT the keyed-dict form a 19.1.3.7 XMEML retime import "
2749
- "writes) and decodes with the DRP library's decodeTimemap: "
2747
+ "generators — its KeyframesBA is the protobuf point form on "
2748
+ "that hand-conformed export, while every retime Resolve "
2749
+ "19.1.3.7 MAKES itself (XMEML import, UI speed change, EDL "
2750
+ "M2 freeze, speed ramp) writes the KEYED-DICT form (E144: "
2751
+ "keyframes {interp,YOut,YIn,Y,XOut,XIn,X} under keys "
2752
+ "'0','1',…; keyframe 0 at X=0 is the origin and its Y the "
2753
+ "source second the map starts on — 4.0 on a real ramp); "
2754
+ "both decode with the DRP library's decodeTimemap: "
2750
2755
  "the keyframe slope is the speed (0.79999 on all four "
2751
2756
  "retimed clips of a real reel = Premiere's 80 for the same "
2752
2757
  "cuts, srcOut = In + round(Duration × 0.8) matching "
2753
2758
  "Premiere's frame for frame), XMax 60000 with a zero slope "
2754
- "is the freeze sentinel (a Black Video generator), a "
2759
+ "is the freeze sentinel a FREEZE at the source second the "
2760
+ "flat map holds, even when <In> is present: an XMEML import "
2761
+ "of a 100% clip came back with that flat map at Y=0 and In "
2762
+ "24, and its render is static at the source's frame 0 "
2763
+ "(E144, inter-frame change 0.02 vs 0.42 in the source) — "
2764
+ "Resolve's XMEML importer froze the clip silently; a "
2755
2765
  "negative slope is a reverse (a reversed tail leader). On a "
2756
2766
  "retimed clip <In> is RECORD-domain (E143): the map spans the "
2757
2767
  "whole source stretched by 1/speed and the clip windows into "