Moves an encode-time camera over a recording. The shot comes from
frame: a pz_frame() spec, or a bare locator (a CSS selector
string, a pz_loc() spec, or a list of either) promoted to one,
whose union is the shot. In a scoped context frame may be omitted
or NULL to shoot the scope's box; at the root it is required
(pz_camera_reset() returns to the home view). frame = FALSE
shoots the scope's box, or the viewport at the root, unframed. The
camera does not change the live page or still screenshots. Outside a
recording it does nothing, and each pz_record_start() begins at
the recording frame.
Arguments
- ctx
A paparazzi context.
- frame
The shot's what-and-how: a
pz_frame()spec or a bare locator promoted to one. Camera shots never inherit the staged frame: unset fields use the camera defaults (pad = 24,target_box = "element", everything else as inpz_frame()).ratioandwhenare ignored, with a warning when set.zoomis magnification relative to the recording frame:NULLfits the padded target, capped at the capture's pixel density; a number fixes the shot at the home frame divided byzoom.anchorplaces the padded target in the shot.frameis required at the root. In a scoped context, leaving it out (orNULL) shoots the scope's box. A spec without a target also frames the scope's box, or the viewport at the root, sopz_frame(zoom = 2)zooms in on the middle of the view.FALSEshoots the scope's box or the viewport with no padding.- ...
Checked empty; reserved for future use.
- duration
Movement duration in seconds.
NULLchooses a duration based on the pan and zoom distance. When the move wouldn't change the view,NULLtakes the new shot instantly, adding no video time, so the camera follows the new target if the page scrolls later. A number holds the camera still for that long.- wait
Whether to wait for the move to finish before the next step.
FALSE(the default) lets the next step run while the camera moves, so a cursor glide can happen during a zoom. Either way, a camera call first lets an earlier camera move finish, so callingpz_camera()on the same target again settles the camera there.pz_record_hold(),pz_record_pause()andpz_record_stop()always let a move finish first.