From 3268191591e4f005cb67c30d07bdd9fc8120b862 Mon Sep 17 00:00:00 2001 From: Abdelrahman Essawy Date: Fri, 31 Jul 2026 14:05:28 +0300 Subject: [PATCH] docs: fix the three compose examples that failed as written sea.mp4 is 3 seconds, so the add-a-layer and effects examples used length 5 from a 3 second source and failed validation. The layered-title example also omitted the required font and color on the text style. The scene example carried its transition on the FIRST scene, where it is ignored (a scene's transition blends into it from the previous scene), so it rendered a hard cut. All four payloads now run verbatim, verified against production. --- jobs/compose.mdx | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/jobs/compose.mdx b/jobs/compose.mdx index 0eb1b8b..1f14675 100644 --- a/jobs/compose.mdx +++ b/jobs/compose.mdx @@ -201,11 +201,11 @@ A second track renders over the first. This lays an animated title over the vide ```json "tracks": [ { "clips": [ - { "asset": { "type": "video", "src": "https://cdn.rendobar.com/assets/examples/sea.mp4" }, "start": 0, "length": 5 } + { "asset": { "type": "video", "src": "https://cdn.rendobar.com/assets/examples/sea.mp4" }, "start": 0, "length": 3 } ] }, { "clips": [ - { "asset": { "type": "text", "text": "Coastal Escape", "style": { "size": 84 } }, - "start": 0, "length": 5 } + { "asset": { "type": "text", "text": "Coastal Escape", "style": { "font": "Inter", "size": 84, "color": "#FFFFFF" } }, + "start": 0, "length": 3 } ] } ] ``` @@ -218,7 +218,7 @@ Effects are fields on a clip. Stack as many as you like on one clip. Each exampl { "asset": { "type": "video", "src": "https://cdn.rendobar.com/assets/examples/sea.mp4" }, "start": 0, - "length": 5, + "length": 3, "color": { "saturation": 1.2, "temperature": 6800 }, "speed": 0.8, "transform": { "scale": 1.1, "animateTo": { "scale": 1.3 } } @@ -305,17 +305,18 @@ A `text` asset renders a styled title. Set the `font`, `size`, `weight`, `color` ## Scene-first authoring -Tracks give you precise multi-track control. For a sequential edit, you can instead describe a list of scenes. Each scene is a self-contained segment with its own clips and an optional transition into the next. `overlays` is a flat list of clips that sit over the whole composition, like a persistent logo or watermark. +Tracks give you precise multi-track control. For a sequential edit, you can instead describe a list of scenes. Each scene is a self-contained segment with its own clips. A scene's `transition` blends INTO it from the previous scene, so put it on the second of two scenes. `overlays` is a flat list of clips that sit over the whole composition, like a persistent logo or watermark. ```json { "scenes": [ - { "duration": 4, "transition": { "transition": "crossfade", "duration": 0.6 }, + { "duration": 4, "clips": [{ "asset": { "type": "video", "src": "https://cdn.rendobar.com/assets/examples/river.mp4" } }] }, - { "duration": 4, "clips": [{ "asset": { "type": "video", "src": "https://cdn.rendobar.com/assets/examples/forest.mp4" } }] } + { "duration": 4, "transition": { "transition": "crossfade", "duration": 0.6 }, + "clips": [{ "asset": { "type": "video", "src": "https://cdn.rendobar.com/assets/examples/forest.mp4" } }] } ], "overlays": [ - { "asset": { "type": "image", "src": "https://cdn.rendobar.com/assets/brand/logo-mark.png" }, "start": 0, "length": 8, + { "asset": { "type": "image", "src": "https://cdn.rendobar.com/assets/brand/logo-mark.png" }, "start": 0, "length": 7.4, "transform": { "scale": 0.2, "position": { "x": "88%", "y": "12%" } } } ] }