ShotNew
Pull back to reveal the town
The camera starts tight on a place with a narrow lens, then pulls back and up to show the whole town and the horizon.
- 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 tight on; point uses `target` |
| target | vec2 | 0, -1 | -3000 to 3000 | the point it starts tight on when place is point: along and inland, in metres |
| bearing | number | 210 | -360 to 360 deg | the compass bearing it pulls back along from the place (210 is out over the sea) |
| startDistance | number | 16 | 4 to 1500 m | how far from the place it starts |
| endDistance | number | 400 | 20 to 5000 m | how far from the place it ends |
| startHeight | number | 2.5 | 2 to 1500 m | the camera height over the ground where it starts |
| endHeight | number | 190 | 5 to 3000 m | the camera height over the ground where it ends |
| lookHeight | number | 3 | 0 to 500 m | the height over the ground of the point it looks at |
| horizonLift | number | 10 | 0 to 45 deg | how far the view tilts up from the place by the end, so the horizon and sky come in |
| fov | number | 26 | 4 to 110 deg | the lens where it starts: narrow, tight on the place |
| endFov | number | 62 | 8 to 110 deg | the lens where it ends |
| growth | choice | geometric | geometric, linear | geometric pulls out by equal ratios, gentle near the roofs; linear by equal steps and wants 20 s or more |
| ease | choice | cruise | cruise, inOut, linear, in, out | cruise holds a steady speed with soft ends; inOut starts and ends at rest |
Use it in a film
film.js
move: element('pull-back', { 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.