Opus Motion ★ Star on GitHub

Maps · map-mask-reveal

Map mask reveal

A choropleth map fills in west to east; one region is outlined in the accent with a leader label, the camera pushes into it, then a photo of the place grows out of the region's own outline until it fills the frame.

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

Map mask reveal: three frames of the animated map, start, middle and end
Map mask reveal — start, middle and end of the 5.5-second motion.

What Map mask reveal is for

Location stories, store / branch reveals, travel and real-estate videos, regional news.

  • map
  • choropleth
  • region
  • location
  • mask
  • reveal
  • photo
  • push in
  • news
  • travel
  • real estate
  • geography
  • transition

Details

Category
Animated maps & geo graphics
Length
5.5 s (165 frames at 30 fps)
Formats
16:9, 1:1, 9:16
Weight
light
Transparent overlay
no
Seamless loop
no
Text props
label title
Colour props
low high accent background
Image props
src
Mood
photo
Roles
subject

Use Map mask reveal in Remotion, React or HTML

Remotion project

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

# render an mp4 (run in the library folder)
node cli/mgl.mjs render map-mask-reveal --props '{"label":"Northwind County","title":"Where the homes went up","low":"#3a3a34","high":"#FFC21A","accent":"#FF4A3D","background":"#0E0E0C","src":""}'

# or export for apps / editors: mp4 | webm-alpha | prores-alpha | gif | png | poster
node cli/mgl.mjs export map-mask-reveal --as mp4 --props '{"label":"Northwind County","title":"Where the homes went up","low":"#3a3a34","high":"#FFC21A","accent":"#FF4A3D","background":"#0E0E0C","src":""}'

React / Next.js

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

<MotionPlayer
  motion="map-mask-reveal"
  props={{
    label: 'Northwind County',
    title: 'Where the homes went up',
    low: '#3a3a34',
    high: '#FFC21A',
    accent: '#FF4A3D',
    background: '#0E0E0C',
    src: '',
  }}
  playOnView
  loop="auto"
/>

Plain HTML / WordPress

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

<opus-motion motion="map-mask-reveal"
  props='{"label":"Northwind County","title":"Where the homes went up","low":"#3a3a34","high":"#FFC21A","accent":"#FF4A3D","background":"#0E0E0C","src":""}'>
</opus-motion>

Compose spec (multi-scene video)

json
{
  "width": 1920,
  "height": 1080,
  "fps": 30,
  "scenes": [
    {
      "motion": "map-mask-reveal",
      "props": {
        "label": "Northwind County",
        "title": "Where the homes went up",
        "low": "#3a3a34",
        "high": "#FFC21A",
        "accent": "#FF4A3D",
        "background": "#0E0E0C",
        "src": ""
      }
    }
  ]
}

Map mask reveal props

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

PropDefaultWhat it does
regions40approximate number of procedural regions
regionIndex-1index of the highlighted region (-1 = an inland default)
label"Northwind County"region name (leader label and final caption)
value"+18 % new homes"figure under the name
src""public/ photo of the place (empty = procedural plate)
seed4map shape + values seed
palette"dusk"procedural photo palette
low"#3a3a34"choropleth low colour
high"#FFC21A"choropleth high colour
accent"#FF4A3D"region outline colour
background"#0E0E0C"sea / background colour
pushAt70frame the camera push starts (1.3 s)
maskAt112frame the photo starts growing out of the outline
title"Where the homes went up"headline over the map

Notes & credits

Technique sources:

  • lemo-opuscar styles/caption-news demo/main.js shotMap(); tools/map_prep.py (MIT, LemoLab)
  • analysis/sources/lemo-styles-a.md §8 map-mask-reveal