Opus Motion ★ Star on GitHub

FX · frame-breakout

Frame breakout

A framed woodblock-style print sits on a tan mount; the red koi inside grows, leaps and pushes out past the top border while the rest of the picture stays clipped to the frame — the camera tilts up into the mount and widens to follow, holds the almost-frozen crest outside the frame, then falls toward the lens with a camera push and small roll, bursts into foam that fills the screen and fades to bare paper. Clip is bound left/right/bottom but open on the break edge.

A free, MIT-licensed visual effect from the Opus Motion Library — 616 motions for Remotion, React and plain HTML.

Frame breakout: three frames of the visual effect, start, middle and end
Frame breakout — start, middle and end of the 6.7-second motion.

What Frame breakout is for

Thumbnail-style "pop out of the frame" moments for any framed media: a product leaving a phone screen, a character leaping from a comic panel, a chart line breaking its axis box; dramatic climaxes.

  • frame
  • breakout
  • pop out
  • leap
  • mount
  • print
  • koi
  • ukiyo-e
  • clip
  • camera tilt
  • foam
  • climax
  • thumbnail
  • jump out of the screen

Details

Category
Visual effects & particles
Length
6.7 s (200 frames at 30 fps)
Formats
16:9, 1:1, 9:16
Weight
light
Transparent overlay
no
Seamless loop
no
Text props
—
Colour props
subjectColor mount paper ink sea sun
Image props
src
Mood
paper, photo, playful
Roles
subject

Use Frame breakout in Remotion, React or HTML

Remotion project

terminal
# copy this motion into your Remotion project
node cli/mgl.mjs add frame-breakout --to ../my-app/src

# render an mp4 (run in the library folder)
node cli/mgl.mjs render frame-breakout --props '{"subjectColor":"#E4572A","mount":"#C9B690","paper":"#EEE2C6","ink":"#231F1C","sea":"#1D3A66","sun":"#B8412F","src":""}'

# or export for apps / editors: mp4 | webm-alpha | prores-alpha | gif | png | poster
node cli/mgl.mjs export frame-breakout --as mp4 --props '{"subjectColor":"#E4572A","mount":"#C9B690","paper":"#EEE2C6","ink":"#231F1C","sea":"#1D3A66","sun":"#B8412F","src":""}'

React / Next.js

tsx
import {MotionPlayer} from 'opus-motion-library/web';

<MotionPlayer
  motion="frame-breakout"
  props={{
    subjectColor: '#E4572A',
    mount: '#C9B690',
    paper: '#EEE2C6',
    ink: '#231F1C',
    sea: '#1D3A66',
    sun: '#B8412F',
    src: '',
  }}
  playOnView
  loop="auto"
/>

Plain HTML / WordPress

html
<script src="opus-motion.element.js" defer></script>

<opus-motion motion="frame-breakout"
  props='{"subjectColor":"#E4572A","mount":"#C9B690","paper":"#EEE2C6","ink":"#231F1C","sea":"#1D3A66","sun":"#B8412F","src":""}'>
</opus-motion>

Compose spec (multi-scene video)

json
{
  "width": 1920,
  "height": 1080,
  "fps": 30,
  "scenes": [
    {
      "motion": "frame-breakout",
      "props": {
        "subjectColor": "#E4572A",
        "mount": "#C9B690",
        "paper": "#EEE2C6",
        "ink": "#231F1C",
        "sea": "#1D3A66",
        "sun": "#B8412F",
        "src": ""
      }
    }
  ]
}

Frame breakout props

16 parameters — change any of them to make the motion yours.

PropDefaultWhat it does
src""optional subject image in public/ (transparent PNG) instead of the built-in koi
breakEdge"top"which border the subject escapes: top or right
growAt14frame when the subject starts growing
riseAt52frame when it starts to rise and the camera tilts
hangAt112frame the crest hangs outside the frame (near frozen)
fallAt150frame it falls toward the lens
foamAt188frame the foam bursts
jitter1subject jitter amount (hang uses ×0.25)
endWashtruefade the foam to bare paper at the end
subjectColor"#E4572A"koi body colour
mount"#C9B690"mount colour around the print
paper"#EEE2C6"paper colour
ink"#231F1C"outline ink
sea"#1D3A66"sea blue
sun"#B8412F"sun colour
seed3texture seed

Notes & credits

Technique sources:

  • lemo-opuscar styles/ukiyoe/DEMO.md climax beats; STYLE.md §6 §8 (MIT, LemoLab) — original koi + print