Skip to main content

Media Cues

Resources → Media → Playback cues (advanced) contains scheduled audio/video playback cues. Choose Create Cue at Keyframe on an imported video, or Create Playback Cue on an imported audio file. Video cues default to the active lifecycle keyframe; advanced audio cues start as Manual so they remain distinct from timeline Sound Events. Expand a cue under Resources → Media to change its source, trigger, trim and playback settings. Media Cues do not create Audio/Video Timeline rows or canvas objects. For video, expand the cue and choose a paintable layer under Video target; Cover, Contain, Stretch and focal position remain visual-only settings on that target.

Every cue shares one transport editor: named clip/live sources, trigger type, trim in/out, loop, speed, volume, mute and retrigger behavior. Source and trimmed durations appear in the editor. Triggers can start at a Timeline frame, an OGraf lifecycle state, a Custom Action, or manually during authoring. Custom Action payloads may select a named source before triggering the cue.

Use + Live playback cue for scheduled renderer-owned sources such as camera.program. Source changes support Cut or Crossfade, an audio transition policy, and Keep current, Use fallback, or Transparency/silence when the incoming source fails. Clip-to-clip, clip-to-live and live-to-clip changes prepare an incoming slot while the outgoing source remains active.

Test with a webcam​

For local testing, choose an Input on the selected object and press Start webcam in the same card. Advanced live Media Cues retain their Live tag field and webcam controls. Studio asks for camera permission then uses the selected camera's muted video for that tag on the canvas and in OGraf Preview. Stop live webcam releases the camera when no other preview uses it. You can switch cameras after permission has been granted. Webcam selection and footage are preview-only: they are not saved in .ogs or exported. The exported graphic still requires its renderer to provide the live tag. A fallback image remains available when no source is provided.

A webcam as the background​

For a live video bed behind the graphic, choose Webcam · local preview in Canvas Layout → Presentation background, then press Start webcam. This editor-only background appears on the main canvas when Transparent output is enabled; it is not painted into OGraf Preview or export. The background and a live Media source may share one local camera without stopping one another. Changing the presentation background away from Webcam stops its use of the camera.

Camera settings​

Camera Settings is beside Start webcam in both locations. You can open it before starting the camera and choose a requested resolution and frame rate without granting permission. Press Save settings, then Start webcam to use those preferences. Browsers and cameras may negotiate different values; check Actual in the settings window for the resolution and FPS the camera is delivering after capture starts or settings are applied. A shared or busy camera may be unable to switch to a larger capture format while it is in use.

While the camera is running, supported image controls appear with the ranges and modes reported by the device. Available controls may include brightness, contrast, saturation, sharpness, exposure, focus and white balance. Exposure time, focus distance and color temperature require the corresponding manual mode when that mode is offered. Unsupported controls remain hidden. Changing these settings affects the same camera stream used by both the live tag and presentation background. Apply changes the active track without restarting capture. If a setting is rejected, Studio keeps the active preview, reports the error and displays the actual values.

Reset clears requested resolution/FPS and restores the readable image-control values from when the current camera stream started; it does not reset the camera's factory settings. Switching cameras keeps resolution/FPS preferences and clears image settings specific to the old device. All camera choices, preferences and footage remain local to the current session and are excluded from .ogs files and exports. The camera must still be started explicitly from Studio.

Real-time only​

Media Cues are real-time-only in the initial profile. Disable Non-real-time and export with the Real-time profile. Live output uses the zd-ograf-media version 1 renderer hook. Test target codec support, browser autoplay policy, live-source readiness and audio routing on the intended playout system.