Opus Motion ★ Star on GitHub

Maps · painted-choropleth

Painted choropleth map

A painted island map: the coastline is brushed in, then regions fill with quantised watercolour bands (wobbly wash edges, three-pass look) driven by station data; the field can morph through time (e.g. 50 Ma to today) with a radial fill reveal, a huge serif year label and a band legend.

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

Painted choropleth map: three frames of the animated map, start, middle and end
Painted choropleth map — start, middle and end of the 9.0-second motion.

What Painted choropleth map is for

Climate / data stories in a warm editorial look; election or survey maps for softer brands; "how X spread" maps. Pass your own `stations` and bands.

  • map
  • choropleth
  • watercolor
  • data
  • climate
  • rainfall
  • timelapse
  • painted
  • bands
  • legend
  • island

Details

Category
Animated maps & geo graphics
Length
9.0 s (270 frames at 30 fps)
Formats
16:9, 1:1, 9:16
Weight
light
Transparent overlay
no
Seamless loop
no
Text props
title subtitle unit finalLabel
Colour props
colors background ink
Mood
3d, nature, hud, editorial
Roles
subject

Use Painted choropleth map in Remotion, React or HTML

Remotion project

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

# render an mp4 (run in the library folder)
node cli/mgl.mjs render painted-choropleth --props '{"title":"Annual rainfall","subtitle":"a painted field map","unit":"mm","finalLabel":"Today","colors":["#CF7C4F","#CDA35F","#B3B07A","#7F9A6C","#46705A","#2F5A45"],"background":"#F3EDE0","ink":"#3A3226"}'

# or export for apps / editors: mp4 | webm-alpha | prores-alpha | gif | png | poster
node cli/mgl.mjs export painted-choropleth --as mp4 --props '{"title":"Annual rainfall","subtitle":"a painted field map","unit":"mm","finalLabel":"Today","colors":["#CF7C4F","#CDA35F","#B3B07A","#7F9A6C","#46705A","#2F5A45"],"background":"#F3EDE0","ink":"#3A3226"}'

React / Next.js

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

<MotionPlayer
  motion="painted-choropleth"
  props={{
    title: 'Annual rainfall',
    subtitle: 'a painted field map',
    unit: 'mm',
    finalLabel: 'Today',
    colors: ['#CF7C4F', '#CDA35F', '#B3B07A', '#7F9A6C', '#46705A', '#2F5A45'],
    background: '#F3EDE0',
    ink: '#3A3226',
  }}
  playOnView
  loop="auto"
/>

Plain HTML / WordPress

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

<opus-motion motion="painted-choropleth"
  props='{"title":"Annual rainfall","subtitle":"a painted field map","unit":"mm","finalLabel":"Today","colors":["#CF7C4F","#CDA35F","#B3B07A","#7F9A6C","#46705A","#2F5A45"],"background":"#F3EDE0","ink":"#3A3226"}'>
</opus-motion>

Compose spec (multi-scene video)

json
{
  "width": 1920,
  "height": 1080,
  "fps": 30,
  "scenes": [
    {
      "motion": "painted-choropleth",
      "props": {
        "title": "Annual rainfall",
        "subtitle": "a painted field map",
        "unit": "mm",
        "finalLabel": "Today",
        "colors": [
          "#CF7C4F",
          "#CDA35F",
          "#B3B07A",
          "#7F9A6C",
          "#46705A",
          "#2F5A45"
        ],
        "background": "#F3EDE0",
        "ink": "#3A3226"
      }
    }
  ]
}

Painted choropleth map props

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

PropDefaultWhat it does
title"Annual rainfall"title text
subtitle"a painted field map"italic line under the title
unit"mm"unit appended to legend values
bands[150,300,650,1150,2000,4000]ascending thresholds; band k starts at bands[k]
colors["#CF7C4F","#CDA35F","#B3B07A","#7F9A6C","#46705A","#2F5A45"]band colours (same length as bands)
stations[][{x (0-1000), y (0-700), value}] data points; empty = built-in demo field
timeKeys[[90,0.25],[225,1]][[frame, multiplier]] the field is scaled by this multiplier over time
yearFrom50label number at the first time key
yearTo0label number at the last time key
yearUnit"Ma"label unit (e.g. Ma, AD, years)
finalLabel"Today"label shown once the morph ends ("" = keep number)
reveal"radial"'radial' fill reveal or 'coast'
passes2wash passes 1-3 (more = softer, slower)
background"#F3EDE0"paper colour
ink"#3A3226"ink colour
seed11island + wash seed

Notes & credits

Technique sources:

  • lemo-opuscar styles/watercolor demo/main.js map section (MIT, LemoLab) — own SVG build, procedural island