camera ptz-position
Specifies a shot by zoom and center coordinates.
Autoframing pauses when the camera receives this command.
The amount of pan and tilt available depend on the zoom level. A tight shot can move more than a wide
one. (See
How It Works: Digital Pan/Tilt/Zoom
.) If zoom = 1, there is no movement to the specified pan
and tilt coordinates, because the camera is fully zoomed out, leaving no room to shift the shot.
The
camera ptz-position
command specifies the coordinates where the shot is to be centered in
terms of pixel column and row, not angle. If the camera cannot center the shot as requested, it gets as
close as possible.
Pan, tilt, and zoom may be specified in any order. The camera calculates the desired shot; if the
calculated shot area would include pixel rows or columns that don't exist (for example, a wide shot
centered near the leftmost or rightmost column of pixels), the camera centers the shot as close as
possible to the requested position. When no speed is specified, the camera snaps to the shot.
Synopsis
camera ptz-position pan <position> tilt <position> zoom <position> [<speed>] [no_wait]
Options
pan
<position>
The pixel column to center the shot on.
Range is 1536 to -1536.
tilt
<position>
The pixel row to center the shot on. Range is
864 to -864.
zoom
<position>
<position> is a floating-point value 1.0 to
10.0.
<speed>
Optional; speed of movements (integer) if the
camera should not snap to the specified
position
no_wait
Optional; when speed is specified, allows the
command to return the command prompt
immediately, while the camera is still moving
to the shot.
Examples
>
camera ptz-position pan -150 tilt 200 zoom 3
OK
>
Centers the shot at pixel column -150, row 200, at a zoom level of 3. The camera snaps
to the shot, because no speed is specified. At this zoom level, the shot can be centered
exactly as requested.
>
camera ptz-position pan -1470 tilt 200 zoom 2 speed 5 no_wait
OK
>
Attempts to center the shot at pixel column -1470, row 200, at a zoom level of 2. The
camera moves at speed 5 and returns the command prompt before the motion is
finished. The shot cannot be centered exactly as requested, because it is relatively
wide and the requested center is close to the leftmost column of pixels. The shot's left
edge will be the leftmost column of pixels.
Complete Manual for the IntelliSHOT Auto-Tracking Camera
54
