Create video scopes monitor
create_video_scopesBuild a broadcast-style video engineering monitor with waveform, RGB parade, and vectorscope panels to analyze video signals. Supports multiple sources including test pattern, file, or live camera.
Instructions
Build a broadcast-style video engineering monitor with multiple scope panels: waveform (luma trace), RGB parade (per-channel traces), and vectorscope (UV chrominance scatter). Each panel renders as a CHOP-to-SOP scope line through an orthographic camera and Render TOP, composited into a single output TOP via layoutTOP. Companion to create_waveform (audio) and create_spectrum (audio frequency). Default source is a synthetic test pattern (no device permission needed); 'device' is opt-in for live camera. The histogram panel here is unsupported in TD 099 and silently skipped — for a working luminance/RGB histogram use the standalone create_histogram_scope instead.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gain | No | Pre-scope luma gain — zooms the trace vertically (Level TOP brightness1). | |
| layout | No | How enabled panels arrange in the output composite. | grid_2x2 |
| source | No | Video source. 'test_pattern' = synthetic Banana.tif (no permission needed). 'existing_top' = reuse a TOP you already have (provide existing_top_path). 'file' = a video/image file. 'device' = live camera (videodeviceinTOP) — may hang TD on a macOS permission modal. | test_pattern |
| parent_path | No | Parent COMP path; the scopes container is created as 'video_scopes' inside it. | /project1 |
| trace_color | No | Phosphor colour for scope lines as a hex string. | #00ff88 |
| enable_parade | No | Show the RGB parade panel. | |
| enable_waveform | No | Show the luminance waveform panel. | |
| expose_controls | No | Bind live controls: Gain, TraceColor, panel-enable toggles. | |
| video_file_path | No | Video/image file path (source='file'). | |
| enable_histogram | No | Show the luma histogram panel. Currently unsupported — TD 099 has no histogramCHOP (only histogramPOP). Pass true is accepted but the panel is silently skipped; re-enable once analyzeTOP histogram mode is confirmed. | |
| panel_resolution | No | Each scope panel's square side in pixels. | |
| existing_top_path | No | Path of an existing TOP to scope (source='existing_top'). | |
| output_resolution | No | Final composited TOP [width, height]. | |
| enable_vectorscope | No | Show the UV vectorscope panel. |