Data · ground-plane-ruler
Ground-plane ruler
A measuring tape is laid on the ground of a photograph in true one-point perspective, its ticks crowding toward the horizon, while a big mono counter runs and lands on the measured distance.
A free, MIT-licensed animated chart from the Opus Motion Library — 616 motions for Remotion, React and plain HTML.

What Ground-plane ruler is for
Distances, spans and heights on real photos — sports, architecture, travel, history ("the first flight covered 120 ft").
Details
- Category
- Animated charts & data visualisation
- 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
unitlabel- Colour props
accent- Image props
src- Mood
- photo, hud, playful
- Roles
- subject
Use Ground-plane ruler in Remotion, React or HTML
Remotion project
# copy this motion into your Remotion project
node cli/mgl.mjs add ground-plane-ruler --to ../my-app/src
# render an mp4 (run in the library folder)
node cli/mgl.mjs render ground-plane-ruler --props '{"unit":"M","label":"DISTANCE COVERED","accent":"#FF5A1F","src":""}'
# or export for apps / editors: mp4 | webm-alpha | prores-alpha | gif | png | poster
node cli/mgl.mjs export ground-plane-ruler --as mp4 --props '{"unit":"M","label":"DISTANCE COVERED","accent":"#FF5A1F","src":""}'React / Next.js
import {MotionPlayer} from 'opus-motion-library/web';
<MotionPlayer
motion="ground-plane-ruler"
props={{unit: 'M', label: 'DISTANCE COVERED', accent: '#FF5A1F', src: ''}}
playOnView
loop="auto"
/>Plain HTML / WordPress
<script src="opus-motion.element.js" defer></script>
<opus-motion motion="ground-plane-ruler"
props='{"unit":"M","label":"DISTANCE COVERED","accent":"#FF5A1F","src":""}'>
</opus-motion>Compose spec (multi-scene video)
{
"width": 1920,
"height": 1080,
"fps": 30,
"scenes": [
{
"motion": "ground-plane-ruler",
"props": {
"unit": "M",
"label": "DISTANCE COVERED",
"accent": "#FF5A1F",
"src": ""
}
}
]
}Ground-plane ruler props
16 parameters — change any of them to make the motion yours.
| Prop | Default | What it does |
|---|---|---|
src | "" | public/ photo with a visible ground plane (empty = procedural archive beach) |
horizonY | 0.5 | horizon height as a fraction of the frame height (match your photo) |
vanishX | 0.56 | vanishing point x as a fraction of the width |
value | 260 | measured length in units (the counter lands here) |
unit | "M" | unit label after the number |
label | "DISTANCE COVERED" | caption above the counter |
tickEvery | 10 | units between minor ticks |
labelEvery | 50 | units between numbered major ticks |
startDistance | 14 | ground distance from the camera to the tape start (bigger = flatter perspective) |
startX | -2.2 | lateral ground position of the tape start (units, negative = left) |
endX | 9 | lateral ground position of the tape end |
tapeWidth | 0.8 | tape width in ground units |
startAt | 22 | frame the tape starts running |
runFrames | 78 | frames for the tape to reach its end |
accent | "#FF5A1F" | tape / signal colour |
mono | true | grade a supplied photo to silver-gelatin greys |
Related motions

Timeline ruler with event cards
Company history, product roadmaps, "history of X" videos and about-us sections: pass `events` (date, title, body, optional image).
timeline-ruler
Crowd tracks
Footfall / mobility / network-activity explainers, smart-city and retail-analytics films, "everyone is connected" beats; drop a crowd…
crowd-tracks
Map route
Journeys, routes, foraging / delivery paths, travel distances, "from A to B" explainers.
map-route
Isotype count
Stats that feel physical — users, litres, votes, homes — for explainers, reports and pitch decks.
isotype-count
Network graph (your nodes and edges)
Explicit relationship maps: system architecture, supply chains, org or contact networks, dependency graphs, knowledge graphs, social…
network-graph
Node network
Network effects, communities, knowledge graphs, AI agents, social-proof and "everything connects" beats.
node-network
Notes & credits
Technique sources:
- lemo-opuscar styles/archive-lighttable demo/film.js measure() (MIT, LemoLab)
- analysis/sources/lemo-styles-a.md §1 ground-plane-ruler