Add timecode overlay
add_timecode_overlayOverlay a running HH:MM:SS:FF timecode or countdown onto a video source, with modes for clock, count up, and count down.
Instructions
Overlay a running HH:MM:SS:FF timecode (or a countdown) onto an input TOP as VISUAL pixels — a Text TOP whose text expression re-evaluates every frame, composited 'over' the source with a Composite TOP. Modes: clock (show time since project start — NOT the OS wall clock — as HH:MM:SS:FF), count_up (elapsed time since this overlay was built, from zero), count_down (counts down from target_seconds to 00:00:00:00 and clamps there). The formatter lives in a Text DAT module (mod('fmt').tc(...)) so it re-cooks live inside TD. FPS is probed live (me.time.rate -> project.cookRate -> 60 fallback) and reported. Distinct from sync_timecode, which syncs a CLOCK SIGNAL (no pixels) — this tool draws the timecode into the image. Ends with a Null TOP 'out'.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | clock: show total show time (since project start) as HH:MM:SS:FF. count_up: elapsed time since this overlay was built, from 00:00:00:00. count_down: counts down from `target_seconds` to 00:00:00:00 and clamps there. | count_up |
| name | No | Base name for the container COMP that holds the chain. | timecode_overlay |
| color | No | Timecode text color as a hex string, e.g. '#ff3366'. | #ffffff |
| position | No | Where the timecode text is anchored over the source frame. | bottom_left |
| font_size | No | Timecode font size in pixels. | |
| source_top | Yes | Path of the input TOP to overlay the timecode onto (e.g. '/project1/moviefilein1'). REQUIRED. | |
| parent_path | No | Where to build the overlay chain (a COMP path, e.g. '/project1'). | /project1 |
| target_seconds | No | count_down only: seconds to count down from. Ignored in clock/count_up modes. |