Opus Motion ★ Star on GitHub

Shapes · metaball-heatmap

Metaball heat-map / goo

A liquid splat spreads and oozes, rendered as heat-map contour bands (maroon core to mint rim) on a starfield; or gooey dark blobs merge and swell with an RGB-split rim.

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

Metaball heat-map / goo: three frames of the shape animation, start, middle and end
Metaball heat-map / goo — start, middle and end of the 5.0-second motion.

What Metaball heat-map / goo is for

Heat maps, spills, thermal / density imagery, organic growth, liquid transitions, "it spreads".

  • metaball
  • heatmap
  • liquid
  • blob
  • organic
  • goo
  • merge
  • hop
  • fuse
  • loader
  • teams combine
  • marble

Details

Category
Shape & geometric animations
Length
5.0 s (150 frames at 30 fps)
Formats
16:9, 1:1, 9:16
Weight
light
Transparent overlay
no
Seamless loop
no
Text props
—
Colour props
—
Mood
dark, night
Roles
subject
Pairs with
Live chart / ECG traces, Number counter, Curl-flow swirl

Use Metaball heat-map / goo in Remotion, React or HTML

Remotion project

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

# render an mp4 (run in the library folder)
node cli/mgl.mjs render metaball-heatmap --props '{"style":"heatmap","ballCount":12,"colors":[],"background":""}'

# or export for apps / editors: mp4 | webm-alpha | prores-alpha | gif | png | poster
node cli/mgl.mjs export metaball-heatmap --as mp4 --props '{"style":"heatmap","ballCount":12,"colors":[],"background":""}'

React / Next.js

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

<MotionPlayer
  motion="metaball-heatmap"
  props={{style: 'heatmap', ballCount: 12, colors: [], background: ''}}
  playOnView
  loop="auto"
/>

Plain HTML / WordPress

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

<opus-motion motion="metaball-heatmap"
  props='{"style":"heatmap","ballCount":12,"colors":[],"background":""}'>
</opus-motion>

Compose spec (multi-scene video)

json
{
  "width": 1920,
  "height": 1080,
  "fps": 30,
  "scenes": [
    {
      "motion": "metaball-heatmap",
      "props": {
        "style": "heatmap",
        "ballCount": 12,
        "colors": [],
        "background": ""
      }
    }
  ]
}

Metaball heat-map / goo props

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

PropDefaultWhat it does
style"heatmap""heatmap" (iso-contour bands), "goo" (gooey blobs with RGB-split rim) or "merge" (puddles hop into one mass, fuse, marble, leap and splat)
ballCount12number of metaball lobes (tendrils and droplets scale with it)
colors[]heatmap: 5 bands rim->core; goo: [blob, rim A, rim B] ([] = source palette)
background""background colour ("" = starfield navy / orange)
blur34field softness in u (bigger = smoother, wider bands)
growth0.045heatmap ooze rate (fraction per second the splat keeps spreading)
rgbSplittruegoo: red/green channel-split rim
starstrueheatmap: starfield specks
seed2
puddles3merge style: number of separate puddles that hop into one central mass (area-conserving growth)
puddleColors[]merge: puddle colours ([] = coral, amber, teal, violet, mint); the first colour is the mass colour, the others marble inside it
hopAt14merge: frame the first puddle hops
hopStagger14merge: frames between hops
hopFrames22merge: frames one ballistic hop takes
leapAt-1merge: frame the fused mass leaps (a thread stretches and snaps, then it splats); -1 = no leap
leapHeight0.28merge: leap height as a fraction of the short side
snapFrames18merge: frame offset into the leap where the thread snaps
marbletruemerge: original colours swirl inside the mass
wobble14merge: wobble amplitude in % after each landing

Notes & credits

Technique sources:

  • video2 0:13.08-0:14.17 (heatmap)
  • video18 0:06.55-0:06.65 (goo)