droboticflow/docs/transcoded-pts-pairing.md
2026-09-11 04:47:13 +08:00

1.2 KiB

Transcoded video / original-named PTS

The normalizer first matches <video-stem>_pts.csv. If absent, it resolves the original name within the same Capture, camera and part. The filename suffix alone is no longer an error.

Before using that fallback, normalization reads the actual files and requires:

  1. Valid strictly increasing positive integer timestamp_us values, at least two rows.
  2. A full ffprobe decode count equal to PTS row count, without decoder errors.
  3. Matching original segment frame count when a Capture meta file exists. There is no manual frame-order declaration gate. TRANSCODE_PRESERVES_FRAME_ORDER is no longer read; old true/false values have no effect.

Original device timestamps are never generated, rescaled or rewritten. Unequal counts, invalid timestamps, decoder errors and inconsistent meta remain blocking errors. Original/exact-name PTS follows the existing downstream validation path. Successful validation records count/timestamp checks only, not a claim that frame order was independently verified.

Deploy the updated normalizer image; no workflow flag is needed. Existing failed Runs are not automatically retried by an image update.