Skip to content

Commit 1bbbfa2

Browse files
committed
docs(producer): chunk formulas name the minParallelChunks floor
1 parent dbf66cc commit 1bbbfa2

1 file changed

Lines changed: 4 additions & 4 deletions

File tree

  • packages/producer/src/services/distributed

‎packages/producer/src/services/distributed/plan.ts‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -221,11 +221,11 @@ export interface DistributedRenderConfig extends Pick<RenderRequestOptions, "pag
221221
* chunks whose per-chunk frame count stays at or below this bound, still
222222
* capped by `maxParallelChunks`:
223223
*
224-
* chunkCount = clamp(ceil(totalFrames / targetChunkFrames), 1, maxParallelChunks)
224+
* chunkCount = clamp(ceil(totalFrames / targetChunkFrames), minParallelChunks, maxParallelChunks)
225225
*
226226
* This bounds per-chunk render *time* (which scales with frames-per-chunk) so
227227
* a single chunk can't exceed a downstream per-chunk timeout on a long video,
228-
* while short videos still collapse to few chunks. It is a ceiling, not a
228+
* while short videos drop to `minParallelChunks` (default 1). It is a ceiling, not a
229229
* fixed size: a video short enough to fit in fewer chunks gets fewer. Ignored
230230
* when `chunkSize` is set (an explicit fixed size already pins per-chunk
231231
* frames). Mutually exclusive with `chunkSize` in intent; if both are passed,
@@ -769,8 +769,8 @@ function assertPlanSizeWithinLimit(input: {
769769
* on tiny renders). Explicit numbers, including `240`, take precedence.
770770
*
771771
* Optional `targetChunkFrames` caps per-chunk frames in the auto-sized path:
772-
* the auto-sizer then targets `clamp(ceil(totalFrames / targetChunkFrames), 1,
773-
* maxParallelChunks)` chunks, so short videos collapse to fewer chunks and long
772+
* the auto-sizer then targets `clamp(ceil(totalFrames / targetChunkFrames), minParallelChunks,
773+
* maxParallelChunks)` chunks, so short videos drop to `minParallelChunks` and long
774774
* videos add chunks (up to the cap) to keep each one under the bound. It is a
775775
* no-op when omitted, and ignored when `configChunkSize` is set.
776776
*/

0 commit comments

Comments
 (0)