Create interactive projection mapping
create_interactive_projection_mappingCreate an interactive projection mapping rig that turns webcam or synthetic input into projected visuals using motion tracking, blob masks, and corner pin mapping with live controls.
Instructions
Build a synthetic-safe interactive projection mapping rig for a USB webcam plus projector: camera/synthetic/existing TOP input, frame-difference motion field, placeholder blob/post-it mask, cyan dot and magenta card visual TOPs, manual Corner Pin projection mapping, debug switch, live controls, and an out1 Null TOP. Defaults to source='camera' for installations, but source='synthetic' previews without camera permission. Returns output/debug paths and explicit warnings for camera, blob tracking, and physical calibration states.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Name for the generated interactive projection mapping Base COMP. | interactive_projection_mapping |
| source | No | Input source: a USB camera, a self-animated synthetic TOP, or an existing TOP pulled through a Select TOP. | camera |
| dot_color | No | Cyan dot color as #rrggbb. | #8ff4f2 |
| max_blobs | No | Maximum blob slots reserved for the later marker-tracking branch. | |
| card_color | No | Magenta card color as #rrggbb. | #ff2f9a |
| card_count | No | Target count for magenta card blocks. This MVP uses it as visual density metadata. | |
| debug_view | No | Which branch the debug switch shows initially. | final |
| parent_path | No | Parent COMP where the interactive projection mapping system is created. | /project1 |
| trail_decay | No | Feedback persistence for visual trails. | |
| camera_index | No | USB/webcam device index used when source='camera'. | |
| output_width | No | Projection output width in pixels. | |
| repel_radius | No | Normalized radius metadata for hand/motion repulsion. | |
| output_height | No | Projection output height in pixels. | |
| blob_threshold | No | Threshold used by the placeholder blob/post-it mask branch. | |
| particle_count | No | Target count for the cyan dot field. This MVP uses it as visual density metadata. | |
| expose_controls | No | Expose live controls for calibration/debug/performance tuning. | |
| background_color | No | Dark projected background color as #rrggbb. | #05100e |
| interaction_mode | No | Interaction branch to prioritize. The first slice always keeps motion available. | hybrid |
| existing_top_path | No | Absolute TOP path required when source='existing_top'. | |
| motion_sensitivity | No | Gain over the frame-difference motion field. | |
| analysis_resolution | No | Square working resolution for cheap motion/blob analysis. | |
| fallback_to_synthetic | No | If camera creation fails, build a synthetic source so the rig remains previewable. | |
| projection_brightness | No | Final Level TOP brightness before out1. |