ShotNew
Crane up from a place
A crane shot: the camera starts at eye height near a place, then rises and pulls back, tilting down to keep it in frame.
- Version
- 1.0.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 starts close to and keeps in frame; point uses `target` |
| target | vec2 | 0, -1 | -3000 to 3000 | the point it keeps in frame when place is point: along and inland, in metres |
| startDistance | number | 22 | 4 to 1500 m | how far from the place it starts |
| endDistance | number | 75 | 4 to 1500 m | how far from the place it ends |
| startHeight | number | 2 | 2 to 1500 m | the camera height over the ground where it starts: eye height |
| endHeight | number | 80 | 2 to 1500 m | the camera height over the ground where it ends |
| lookHeight | number | 5 | 0 to 500 m | the height over the ground of the point it keeps in frame |
| bearing | number | 210 | -360 to 360 deg | the compass bearing from the place to the camera (210 is out over the sea) |
| swing | number | 14 | 0 to 90 deg | how far the crane arm swings round the place while it rises |
| swingClockwise | bool | true | – | which way the arm swings, seen from above |
| fov | number | 52 | 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 |
Use it in a film
film.js
move: element('crane-up', { place: 'door', target: [0, -1] })Use it from your agent
Ask your agent to put it in a film. It finds the element by name.