ShotNew
Orbit around a place
The camera circles a place or point of the home world, looking at it, and can rise, spiral out or zoom as it turns.
- Version
- 1.1.0
- Added
- 23 October 2026
- Films
- Not used in a film yet
Parameters
| Name | Type | Default | Range | What it does |
|---|---|---|---|---|
| place | choice | door | door, across, street, green, promenade, sand, waterline, bench, pond, roof, point | the place it circles; point uses `around` |
| around | vec2 | 0, -1 | -3000 to 3000 | the point it circles when place is point: along and inland, in metres |
| radius | number | 60 | 5 to 1500 m | how far out it starts |
| endRadius | number | 0 | 0 to 1500 m | how far out it ends; 0 keeps the radius |
| height | number | 18 | 1 to 1500 m | the camera's height over the ground where it starts |
| endHeight | number | 0 | 0 to 1500 m | its height where it ends; 0 keeps the height |
| lookHeight | number | 4 | 0 to 500 m | the height of the point it looks at, over the ground |
| endLookHeight | number | 0 | 0 to 500 m | the look point's height where it ends; 0 keeps lookHeight |
| start | number | 200 | -360 to 360 deg | where it starts: the compass bearing from the place to the camera (210 is out over the sea) |
| turn | number | 70 | 0 to 720 deg | how far it turns over the shot |
| clockwise | bool | true | – | which way it turns, seen from above |
| fov | number | 55 | 8 to 110 deg | the lens where it starts |
| endFov | number | 0 | 0 to 110 deg | the lens where it ends; 0 keeps the lens |
| ease | choice | inOut | inOut, linear, in, out | how it speeds up and slows down: inOut starts and ends at rest |
| growth | choice | linear | linear, geometric | how radius and height change: linear, or geometric (tight and low at first, opening fast: a spiral climb) |
Use it in a film
film.js
move: element('orbit', { place: 'door', around: [0, -1] })Use it from your agent
Ask your agent to put it in a film. It finds the element by name.