Media and export limitations

Media import

Project.import_media(path) accepts probed video and audio files. Media assets are stored in the project pool and referenced by clips.

clip = p.import_media("footage.mp4")
main = p.add_track("video")
main.add(clip.subclip(3.0, 8.0), start=0.0)

Video clips can carry their own audio into preview and export, following the engine mixer.

Still images

Still images are deliberately deferred in the Python binding today. The model has room for image sources, but the renderer does not yet have the still-image decode path wired for this surface.

Common still formats such as PNG or JPEG raise MediaError in v1.

Frame rendering

get_frame(t) returns a NumPy uint8 RGBA array:

frame = p.get_frame(2.0)
assert frame.shape[2] == 4

Render failures surface as RenderError.

Export platforms

Cutlass.py exports through platform-native encoders. The intended MP4 format is H.264 video with AAC audio when audio clips exist.

Current boundary:

• Apple platforms use the native Apple media stack.
• Windows export support is part of the Python package target.
• Other platforms raise until their encoder backend lands.

Keep platform checks in your scripts when running exports in CI.