Opus Motion ★ Star on GitHub

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.

Ground-plane ruler: three frames of the animated chart, start, middle and end
Ground-plane ruler — start, middle and end of the 5.0-second motion.

What Ground-plane ruler is for

Distances, spans and heights on real photos — sports, architecture, travel, history ("the first flight covered 120 ft").

  • ruler
  • measure
  • tape
  • distance
  • perspective
  • ground plane
  • counter
  • number
  • photo
  • archive
  • span
  • length
  • sports
  • architecture
  • data
  • evidence

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
unit label
Colour props
accent
Image props
src
Mood
photo, hud, playful
Roles
subject

Use Ground-plane ruler in Remotion, React or HTML

Remotion project

terminal
# 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

tsx
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

html
<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)

json
{
  "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.

PropDefaultWhat it does
src""public/ photo with a visible ground plane (empty = procedural archive beach)
horizonY0.5horizon height as a fraction of the frame height (match your photo)
vanishX0.56vanishing point x as a fraction of the width
value260measured length in units (the counter lands here)
unit"M"unit label after the number
label"DISTANCE COVERED"caption above the counter
tickEvery10units between minor ticks
labelEvery50units between numbered major ticks
startDistance14ground distance from the camera to the tape start (bigger = flatter perspective)
startX-2.2lateral ground position of the tape start (units, negative = left)
endX9lateral ground position of the tape end
tapeWidth0.8tape width in ground units
startAt22frame the tape starts running
runFrames78frames for the tape to reach its end
accent"#FF5A1F"tape / signal colour
monotruegrade a supplied photo to silver-gelatin greys

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