
OverlayNew
Distance line between two points
A measured line between two points of the home world, with end marks and the distance written at its middle; it draws in as it reveals.
- Version
- 1.0.0
- Added
- 23 October 2026
- Films
- Not used in a film yet
Parameters
| Name | Type | Default | Range | What it does |
|---|---|---|---|---|
| from (Can change over time) | vec3 | -5, -4, 0.3 | -5000, -5000, -500 to 5000, 5000, 5000 | the first end: metres along the shore, inland of home’s door, and height over the groundCan change over time |
| to (Can change over time) | vec3 | 6, -4, 0.3 | -5000, -5000, -500 to 5000, 5000, 5000 | the second end, the same way; the line draws in toward itCan change over time |
| measure | choice | straight | straight, ground | the straight 3D distance between the ends, or only the distance along the ground |
| label | text | – | – to 40 | a small word over the distance, such as THE SEA CAME; empty for none |
| unit | choice | m | m, km, ft, mi | the unit the distance is written in |
| decimals | integer | -1 | -1 to 4 | decimal places of the distance; -1 picks them from its size |
| format | choice | grouped | grouped, plain, compact, scientific | how numbers are written: 12,500 / 12500 / 12.5k / 1.25×10⁴ |
| ends | choice | tick | tick, dot, arrow | what closes each end of the line |
| size | number | 0.045 | 0.03 to 0.09 | the height of the distance’s digits, a share of the frame’s height |
| thickness | number | 0.005 | 0.0025 to 0.012 | the line’s width, a share of the frame’s height |
| ink | color | #f3f0e8 | – | words, numbers, ticks and outlines |
| accent | color | #4fb8e8 | – | the live value, the fill, what is highlighted |
| font | choice | sans | sans, serif, mono | the face of the distance and its word |
| backing | number | 0.35 | 0 to 1 | how dark the panel behind the distance is; 0 for none (then the words get a soft shadow) |
| reveal | number | 0.8 | 0 to 5 s | how long the line takes to draw in from the first end to the second; 0 shows it at once |
Use it in a film
film.js
elements: { 'distance-line': { from: [-5, -4, 0.3], to: [6, -4, 0.3] } }Use it from your agent
Ask your agent to put it in a film. It finds the element by name.