photo-slideshow

Photo promo / slideshow

Assumes the font asset from picsart_scene_fonts (a live.fonts entry), and that picsart_scene_patch returns the patched scene you pass to the next tool.

The most common scene job: N photos, one after another, a transition at each seam, a title. Every value below was validated and rendered at 1080x1920; the whole scene is in the worked example.

Related recipes: picsart_scene_recipe scene-video-edits owns the track, transition-window and blur_fill detail; picsart_scene_recipe motion-intent chooses durations and easing.

1. Probe the photos

Call picsart_media_probe on every photo URL before authoring. Declare its width and height on the asset. Those numbers decide which fit each photo gets (section 3), and they let blur_fill skip its fill on a photo whose aspect already matches the composition.

"p2": { "type": "image", "uri": "https://…/507090463024201.jpg", "width": 2494, "height": 2560 }

Compare each photo's aspect (w/h) with the composition's (1080/1920 = 0.5625). cover crops the difference away: 2296x4080 (0.563) loses nothing visible, and a 2:3 portrait such as 2308x3462 (0.667) loses 16% of its width. A square or landscape photo such as 2494x2560 (0.974) would lose 42% of its width, so it gets a blurred fill instead.

2. A track of clips with transitions

One track layer holds the photos as clips, back to back. Each seam that should not be a hard cut gets one transitions[] entry keyed by between, the index of the gap (0 = between clips 0 and 1):

{ "id": "reel", "start": 0, "duration": 12, "content": { "kind": "track",
  "clips": [
    { "id": "c1", "duration": 3, "content": { "kind": "media", "assetId": "p1", "fit": "cover" } },
    { "id": "c2", "duration": 3, "content": { "kind": "media", "assetId": "p2" },
      "looks": [{ "look": "blur_fill", "params": { "blur": 8, "resFactor": 10, "dim": 0.25 } }] },
    { "id": "c3", "duration": 3, "content": { "kind": "media", "assetId": "p3", "fit": "cover" } },
    { "id": "c4", "duration": 3, "content": { "kind": "media", "assetId": "p4", "fit": "cover" } }
  ],
  "transitions": [
    { "between": 0, "id": "crossfade", "duration": 0.6 },
    { "between": 1, "id": "slide", "duration": 0.6, "params": { "direction": "left" } },
    { "between": 2, "id": "crossfade", "duration": 0.6 }
  ] } }