Skip to main content

Image Acquisition

The VAPIXService provides two methods for capturing images from Axis cameras, with automatic fallback.

AWF Image Acquisition (Primary)​

GetAWFImageAsync() is the preferred capture method:

AWF Advantages​

  • Returns image bytes and current PTZ position in a single request
  • Higher quality image processing on the camera
  • Consistent image format

Fallback Behavior​

If AWF capture fails (camera doesn't have AWF installed, network timeout, etc.), the client automatically falls back to the standard VAPIX image capture API:

  • Standard API provides image bytes only
  • PTZ position must be queried separately if needed

Panoramic Image Acquisition​

For panoramic captures, the VAPIXClient works with the orchestration to:

  1. Move the camera to the first pan position
  2. Capture an image
  3. Move to the next pan position
  4. Capture again
  5. Repeat for all positions (typically 6 for 360°)

The individual images are then stitched by the PanoImageStorageService.

Model Classes​

The VAPIXService includes 56 model classes representing the various VAPIX API response structures:

  • Device information models
  • PTZ position models
  • Application listing models
  • Status response models
  • Image metadata models