Fill Image Motion Pin
fill-image-motion-pin
Controls whether the foreground card moves with the background during fill-image-motion. Applies only to framed background mode — fill=blur or the default embedded cover-art layout — where there is a distinct sharp card composited over a blurred backdrop.
| Value | Behavior |
|---|---|
none | The whole framed composite (card and backdrop together) zooms or pans. Default. |
card | The sharp foreground card is pinned in place. Only the blurred backdrop drifts. |
fill-image-motion-pin=card produces a calmer, ambient look: the backdrop has subtle motion but the card — which typically carries album art, a waveform, and captions — stays perfectly still and pin-sharp throughout the clip. Because the card never zooms, it is rendered once at its fit-within size and stays at full quality regardless of the fill-image-motion-amount.
fill-image-motion-pin=card is ignored under fill=image (cover-crop). Cover-crop is a single full-bleed plane with no separate card, so there is nothing to pin. The parameter is silently ignored and the cover-crop background zooms normally.