PTZ Operations
The VAPIXClient provides full PTZ (Pan/Tilt/Zoom) control for Axis cameras.
Coordinate System
| Axis | Range | Description |
|---|---|---|
| Pan | 0° – 360° | Horizontal rotation |
| Tilt | -90° – 90° | Vertical angle (-90° = straight down, 90° = straight up) |
| Zoom | Camera-dependent | Optical zoom level |
Operations
Move to Position
Moves the camera to a specific pan/tilt/zoom coordinate:
- Sends absolute coordinates to the camera
- Camera reports movement completion
- Used for both manual control (LEASED mode) and automated panoramic capture
Return to Home
Moves the camera to its configured home preset:
- Home position is configured on the camera itself
- Used when a lease expires or after panoramic capture completes
Query Position
Retrieves the current PTZ coordinates:
- Used to verify camera position after a move command
- Position data is included in image metadata
RefreshPTZForFEtimer function queries this every 5 minutes
Guard Tour
Enable/disable the camera's automated patrol mode:
- When enabled, the camera cycles through preset positions automatically
- Disabled during manual control (LEASED mode) and re-enabled after
How PTZ Is Used Across the System
| Context | Operation |
|---|---|
| SINGLE mode capture | Query position for metadata only |
| PANO mode capture | Move to 6+ positions, capture at each |
| LEASED mode | Direct PTZ control from frontend commands |
| Health monitoring | Query position to verify camera responsiveness |
| Frontend map | Position data determines arrow rotation on the map |