Gauge

A half-dial gauge: the needle swings to the value with a little overshoot, the arc fills behind it and the number counts up in the middle, with the label under it.

  • data/gauge
  • Data
  • stat
  • Full frame
  • 6 s (3–30 s)
Style
Live in your browser
Gauge at 16:9
0.00 / 6.00 s
npx volito render data/gauge --style cream --out gauge.mov
Playing live with volito/browser, the engine a render uses. Each tab lays the item out again for that shape, not a crop.

Render it

npx volito render data/gauge --prop title="Audience retention" --prop label="watched past the first minute" --out gauge.mov

That writes ProRes 4444. The same item in another shape, brand or format:

volito render data/gauge --aspect 9:16 --style cobalt --out gauge-9x16.mov
volito render data/gauge --format mp4 --out gauge.mp4
volito still data/gauge --t 3 --out gauge.png
volito info data/gauge     # every prop and part
volito add data/gauge      # copy its source into ./motion to edit

From Node:

import { findItem, renderVideo } from "volito";

await renderVideo(findItem("data/gauge"), { props: { title: "Audience retention", label: "watched past the first minute" }, out: "gauge.mov" });

Or ask an agent with the MCP server connected: “Render the Volito gauge (data/gauge) in 9:16, in our brand.”

Props

Set each with --prop name=value, or all at once with --props and a JSON object.

PropTypeDefaultTakes
titletextAudience retention≤ 50 chars
valuenumber720 – 1000000000
max
Maximum
number1001 – 1000000000
labeltextwatched past the first minute≤ 60 chars
prefix
Before numbers
text—≤ 3 chars
suffix
After numbers
text%≤ 6 chars
decimalsnumber00 – 3
zones
Good zone
booleantrue—

Parts

Each part takes any move, ease or idle: --motion ground.in=pop.

PartWhat it is
groundthe ground
titlethe heading
dialthe dial, ticks and zone
needlethe needle
valuethe number
labelthe label

Tags: gauge, dial, meter, score, kpi

More in Data