You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 54d0af5
Browse filesBrowse the repository at this point in the historyBrowse files
feat(engine): render sets a keyframe interval and a peak bitrate cap (#6444)
* feat(engine): encoders cap peak bitrate and place keyframes on a set interval
* style(engine): shorten the rate-cap comment
* style(engine): drop the doc lines the comment ratchet flagged
* feat(producer): mp4 renders honour a keyframe interval and a peak bitrate cap on every encoder path
* style(producer): shorten the delivery encoder file headers
* style(producer): drop a comment line from the segment manifest
* style(producer): shorten the integration test header
* test: delivery encoder tests follow the ffprobe argv contract and run in the integration lane
* feat: the render request, server and Lambda plan carry the keyframe interval and peak bitrate cap
* fix(studio): the Studio render route passes the keyframe interval and bitrate cap to the encoder
* chore(studio-server): drop a comment the helper's name already says
* feat(cli): render and lambda render take --keyframe-interval, --max-bitrate and --buffer-size
|`--crf`| from `--quality`| Override MP4/WebM encoder CRF, 0–51. Lower is better quality. Not with `--video-bitrate`; rejected for MOV. |
1498
1498
|`--video-bitrate`| from `--quality`| Target MP4/WebM bitrate, e.g. `10M` or `5000k`. Not with `--crf`; rejected for MOV. |
1499
+
|`--keyframe-interval`| encoder default | MP4 only. A keyframe at least every N seconds, e.g. `2`, so a player can seek or switch rendition at that spacing. |
1500
+
|`--max-bitrate`| uncapped | MP4 only. Peak video bitrate cap, e.g. `8M`, held alongside the `--crf` or `--quality` target rather than replacing it. |
1501
+
|`--buffer-size`| 2 × `--max-bitrate`| MP4 only. Buffer the cap is measured over, e.g. `16M`. Needs `--max-bitrate`. |
1499
1502
|`--vp9-cpu-used`| encoder default | libvpx-vp9 speed/quality trade-off for WebM, -8 to 8. Env: `PRODUCER_VP9_CPU_USED`. |
1500
1503
|`--gif-loop`|`0`| GIF loop count, `0` for forever. Range 0–65535, `--format gif` only. |
1501
1504
|`--hls-segment-seconds`|`4`| HLS target segment length in whole seconds, 1–60. `--format hls` only. Also fixes the encoder GOP so every segment starts on a keyframe. |
@@ -2277,6 +2280,9 @@ And these drive `render` and `render-batch`:
2277
2280
|`--chunk-size`| auto | Frames per chunk. By default each chunk is sized to finish inside the Lambda timeout |
2278
2281
|`--max-parallel-chunks`| auto | Chunks per render. By default one wave across the deploy's `--concurrency` (or 90% of the account's unreserved concurrency), widened when a chunk would outrun the Lambda timeout |
2279
2282
|`--target-chunk-frames`| — | Ceiling on frames per chunk. The planner adds chunks — up to `--max-parallel-chunks` — to stay under it, and short videos still collapse to fewer. Ignored when `--chunk-size` is set. |
2283
+
|`--keyframe-interval`| — | MP4 only. Longest gap between keyframes, in seconds. Chunk joins add keyframes, so this is a maximum; with a chunk shorter than the interval the chunk length wins. |
2284
+
|`--max-bitrate`| — | MP4 only. Peak video bitrate cap, e.g. `8M`. Each chunk is capped on its own, so a join between two chunks can burst up to one `--buffer-size`. |
2285
+
|`--buffer-size`| 2 × `--max-bitrate`| MP4 only. Buffer for the cap, e.g. `16M`. Needs `--max-bitrate`. |
2280
2286
|`--variables`| — | JSON object reaching every chunk worker as `window.__hfVariables`|
2281
2287
|`--variables-file`| — | Read those from a JSON file |
2282
2288
|`--strict-variables`| off | Fail instead of warn on an undeclared or mistyped key |
0 commit comments