flash_cut

Join two Videos with a brief white-flash transition.

Call shape

flash_cut(before: Video, after: Video, duration?: Duration) -> Video

This is call-shape notation for lookup, not ClipAsm declaration syntax.

Graph inputs

Parameters and defaults

Result and stack behavior

Outputs: Video.

Default stack access is owned. See stack binding for ownership and visibility rules.

Timeline and markers

The program places before and after in sequence. It exposes the corresponding transition regions.

Example

clipasm 1

config {
    video {
        fps = 30
    }
}

image("assets/before.png", 2s)
image("assets/after.png", 2s)
flash_cut

Expected validation result: Video with exactly 120 project frames at the example’s explicit fps = 30.

The reference checks parse and compile this exact example. Compilation does not inspect the named media files.

Behavior

• duration becomes the smallest whole project-frame count that covers the authored duration.
• The white fade is evaluated in display-linear BT.709 RGB.
• The output exposes sequential before and after timeline regions.

Requirements

• duration must cover at least one project frame.

Common diagnostics

These are the diagnostics most specific to this program.

• E_INVALID_FLASH_CUT_DURATION — Invalid flash-cut duration

See also

• crossfade
• Statements and calls
• Stack binding