CLI

Current command model

pixelflow is a render-oriented CLI. Normal invocation requires script path and -o output path. version subcommand is separate and does not require script.

Render pipeline

Current CLI flow is:

1. read script source,
2. evaluate script through pixelflow_script::ScriptEngine,
3. index reachable FFMS2 sources,
4. validate final graph,
5. build built-in executors for reachable built-in filters,
6. verify all reachable graph nodes have executors,
7. render ordered frames to Y4M or rawvideo based on the final clip format.

Output limits

Current CLI output accepts only final clips with:

• fixed format,
• fixed resolution,
• finite frame count,
• constant frame rate, and
• either Y4M-compatible integer Gray/YUV format or planar RGB format.

Convert unsupported final clips explicitly before rendering.