Stage Surface
stage_surfaceDisplay an image, video, text, or live camera feed on every mesh of a scene material as flat unlit surfaces; clear restores original materials.
Instructions
Show an image, a video, text or a live camera on every mesh of a material, now (page command: surface): slides on a whiteboard, a video backdrop, a teleprompter, a monitor with the camera on air, screens on desks. The meshes draw flat and unlit (a screen glows; glow 0..1 dims it) until clear=True gives them their own material back (clear without material: every surface). Not saved to the scene: a re-exported room gets its surfaces back, another scene starts with none. The surface keeps its mesh's shape (aspect measured from its UVs, or aspect= width / height); px is the long side in pixels. One source: image= or video= a file inside the scene folder (path relative to it, e.g. "slides/s01.png"), placed by fit 'contain' (whole, on background), 'cover' (filled, cropped) or 'stretch'; a video plays from start= seconds, loops unless loop=False, silent unless sound=True. text= wrapped to the width, lines= lines on the surface at once, scroll= lines a second (0: still), line= the top line to start at, color, background, align left | center | right, font. camera= a camera in the scene, rendered fps times a second at the surface's aspect with the camera's horizontal field of view (each feed costs a render of the room: keep fps low in the headset). object= instead of material: that object's one material. In a stage_capture setup (with at_song for timing) a video follows the film's time and a camera renders every frame. Errors: no such material or camera, a file that is not in the scene folder, no source. Page replies {surface, source, meshes, px, aspect, size?, text_lines?, on} or {cleared, on}. Emits: surface_set, surface_cleared, surface_lost (a reload could not put one back).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| px | No | ||
| fit | No | contain | |
| fps | No | ||
| font | No | sans-serif | |
| glow | No | ||
| line | No | ||
| loop | No | ||
| text | No | ||
| align | No | left | |
| clear | No | ||
| color | No | #ffffff | |
| image | No | ||
| lines | No | ||
| scene | Yes | ||
| sound | No | ||
| start | No | ||
| video | No | ||
| aspect | No | ||
| camera | No | ||
| object | No | ||
| scroll | No | ||
| material | No | ||
| background | No | #000000 |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |