fill_level

Places a background image or ambient clip that spans the full duration of a reference step's timeline.

When to use

Use to add a solid background image or looping ambient clip that fills the entire edit. Common for portrait videos with a background behind the speaker.

In the editor

Add it from the Library (Utility group), or with + add step and a search for fill_level.

Under Inputs, add source as a file input naming the background image or clip. The step needs to know how long the finished video is, and it gets that from another step: either add a second input of type step pointing at the step that sets the length (usually your main cut), or set duration_step to that step's ID.

Set Output Level to a level that sits behind everything else. Levels and their order are in the editor's Settings, and a background level wants a low order number so the rest of the video draws on top of it.

The run timeline shows a single clip stretching the whole length of the video. A still image is held or looped to fill that time, so a background does not have to be a video.

YAML Example

- id: background
  processor: fill_level
  input:
    - id: source
      file: background-image
  cache_deps:
    - ai_cut
  params:
    duration_step: ai_cut
  output:
    timeline: background
  cache: true

Inputs

Params

Output

EditDecisions: one clip covering the full timeline duration.

Notes

• Use cache_deps: [<duration_step>] to ensure this re-runs when the duration changes (even though the source image hasn't changed).
• For images, Puffin Ship loops or holds the frame to fill the required duration.
• Place this level at a low order value so it renders behind all other content.