Opus Motion ★ Star on GitHub

Shapes · bouncing-ball

Bouncing ball (squash, anticipation, crack, hop)

A red ball over a dark dev-HUD: gravity bounces with velocity stretch and 1-frame squash, or a charge-gauge launch, an exaggerated ground-cracking drop, or beat hops that write notes on a staff.

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

Bouncing ball (squash, anticipation, crack, hop): three frames of the shape animation, start, middle and end
Bouncing ball (squash, anticipation, crack, hop) — start, middle and end of the 4.0-second motion.

What Bouncing ball (squash, anticipation, crack, hop) is for

Explaining physics / animation principles, playful logo or mascot drops, "charging then launch" beats, heavy-impact emphasis.

  • ball
  • bounce
  • squash
  • stretch
  • physics
  • hud
  • impact
  • music
  • timeline
  • timing-chart
  • spacing
  • slime
  • jelly
  • hop
  • mascot
  • ground-rings
  • burst-rays

Details

Category
Shape & geometric animations
Length
4.0 s (120 frames at 30 fps)
Formats
16:9, 1:1, 9:16
Weight
light
Transparent overlay
no
Seamless loop
no
Text props
title subtitle labels scaleLabel
Colour props
color accent accent2
Mood
dark, hud, playful, night
Roles
subject
Pairs with
HUD chrome overlay, Easing graph + compare tracks, Onion-skin arc (straight ahead vs pose to pose)

Use Bouncing ball (squash, anticipation, crack, hop) in Remotion, React or HTML

Remotion project

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

# render an mp4 (run in the library folder)
node cli/mgl.mjs render bouncing-ball --props '{"title":"","subtitle":"","labels":"","scaleLabel":"SCALE · LIVE","color":"#ED3821","accent":"#F5C518","accent2":"#E8553B"}'

# or export for apps / editors: mp4 | webm-alpha | prores-alpha | gif | png | poster
node cli/mgl.mjs export bouncing-ball --as mp4 --props '{"title":"","subtitle":"","labels":"","scaleLabel":"SCALE · LIVE","color":"#ED3821","accent":"#F5C518","accent2":"#E8553B"}'

React / Next.js

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

<MotionPlayer
  motion="bouncing-ball"
  props={{
    title: '',
    subtitle: '',
    labels: '',
    scaleLabel: 'SCALE · LIVE',
    color: '#ED3821',
    accent: '#F5C518',
    accent2: '#E8553B',
  }}
  playOnView
  loop="auto"
/>

Plain HTML / WordPress

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

<opus-motion motion="bouncing-ball"
  props='{"title":"","subtitle":"","labels":"","scaleLabel":"SCALE · LIVE","color":"#ED3821","accent":"#F5C518","accent2":"#E8553B"}'>
</opus-motion>

Compose spec (multi-scene video)

json
{
  "width": 1920,
  "height": 1080,
  "fps": 30,
  "scenes": [
    {
      "motion": "bouncing-ball",
      "props": {
        "title": "",
        "subtitle": "",
        "labels": "",
        "scaleLabel": "SCALE · LIVE",
        "color": "#ED3821",
        "accent": "#F5C518",
        "accent2": "#E8553B"
      }
    }
  ]
}

Bouncing ball (squash, anticipation, crack, hop) props

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

PropDefaultWhat it does
mode"bounce"'bounce' (gravity bounces) | 'anticipation' (charge gauge + launch) | 'crack' (exaggerated drop, impact frame, ground crack + debris) | 'hop' (beat hops, a note per landing) | 'timeline' (timing chart: ticks, dot trail, live squash readout) | 'slime' (glossy jelly hopper with eyes, puffs, chroma rim) | 'impact' (flat-vector drop: speed streaks, burst rays, ground rings, launch)
background""background colour; '' = mode default (ink / pink for hop; crack flips to cream)
color"#ED3821"ball colour
radius69.5ball radius in u (1080-short-side px)
restitution0.67velocity kept per bounce (0.67 measured)
gravity7100gravity in u/s² (7100 measured at 1080p)
maxStretch0.3max extra vertical stretch from speed
squash0.55scaleY on the hardest impact frame
notes["E","G","A","G","E","D","E","C"]hop mode: note names on the staff, one per landing (C D E F G A B C5 D5…)
bpm160beat rate (hop period, HUD beat squares)
hudtrueshow the HUD chrome + chapter title
numeral""chapter numeral ('' = mode default)
title""chapter title, \n for a second line ('' = mode default)
subtitle""small line under the title
code""live code comment typed in the footer
seed4crack / debris randomness
period0.5timeline mode: seconds per bounce (0.5 measured)
apex0.31timeline mode: apex height as a fraction of the frame height
trail"dots"timeline mode: 'dots' keeps a grey dot every 2 frames (spacing chart) | 'none'
labels""timeline mode: leader-line label text ("" = live sy / sx readout)
bounces0timeline mode: bounces across the axis (0 = fit the duration)
eyes"square"slime mode: 'square' | 'ii' | 'x' | 'closed'
puffstrueslime mode: white dust puffs at each landing
rimtrueslime mode: red / cyan chromatic rim copies
rays7impact mode: burst ray count (two colours)
rings3impact mode: expanding ground rings per impact
ground"line"impact mode: 'line' | 'band'
launchAt0impact mode: frame of the stretch launch (0 = frame 31 @30 fps)
accent"#F5C518"impact mode: first ray colour
accent2"#E8553B"impact mode: second ground-ring colour
identityNote"CIRCLE = ELLIPSE = ELLIPSE"bounce: small grey note under the scale diagram
scaleLabel"SCALE · LIVE"bounce: caption above the live scale readout
phaseLabels["ANTICIPATION","ACTION","FOLLOW-THROUGH"]anticipation: labels of the three timeline bars
chargeLabels["LOADED","CHARGING","RELEASE"]anticipation: [prefix, first-phase word, second-phase word] of the gauge caption
hopLabel"PRIMARY · HOP"hop: callout label next to the ball

Notes & credits

Technique sources:

  • video17 0:00-0:05 squash-stretch-bounce + anticipation-charge-launch
  • video17 0:21-0:24 note-per-bounce
  • video17 0:27-0:30 impact-frame + ground-crack-debris