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.

What Map mask reveal is for
Location stories, store / branch reveals, travel and real-estate videos, regional news.
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
labeltitle- Colour props
lowhighaccentbackground- Image props
src- Mood
- photo
- Roles
- subject
Use Map mask reveal in Remotion, React or HTML
Remotion project
# 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
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
<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)
{
"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.
| Prop | Default | What it does |
|---|---|---|
regions | 40 | approximate number of procedural regions |
regionIndex | -1 | index 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) |
seed | 4 | map 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 |
pushAt | 70 | frame the camera push starts (1.3 s) |
maskAt | 112 | frame the photo starts growing out of the outline |
title | "Where the homes went up" | headline over the map |
Related motions

Choropleth fill (tile map + legend)
Regional comparisons (sales by state, scores by team, adoption by country) when you just need the pattern, not exact geography. Name tiles…
choropleth-fill
City zoom + label card
"We are here" / location reveals, store or event locators, travel and news establishing shots, any beat that goes from the world to one…
city-zoom-label
Flight arcs (great-circle routes)
Global reach, shipping and travel routes, network/hub-and-spoke stories, "from here to there" beats; swap `routes` for any lat/lon pairs.
flight-arcs
Painted choropleth map
Climate / data stories in a warm editorial look; election or survey maps for softer brands; "how X spread" maps. Pass your own `stations`…
painted-choropleth
Negative develop reveal
Before/after reveals: archive photos, "the real picture" moments, X-ray → product, a teaser image coming into view.
negative-develop-reveal
Coverage route (floor plan)
Robot vacuums / mowers, delivery rounds, sprinkler or cleaning coverage, "how the algorithm covers the space" payoffs.
coverage-route
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