Back to Aurora Vision Library Lite website

You are here: Start » Camera Support » AXIS » AXIS_StartAcquisition

AXIS_StartAcquisition


Header: ThirdPartySdk.h
Namespace: avl

Starts acquisition using AXIS.

Syntax

void avl::AXIS_StartAcquisition
(
	AXIS_State& ioState,
	const atl::String& inAddress,
	int inCameraID,
	int inOutputQueueSize,
	atl::Optional<const atl::String&> inLogin,
	atl::Optional<const atl::String&> inPassword,
	atl::Optional<const atl::String&> inStreamProfile,
	atl::Optional<avl::AXISResolution::Type> inResolution,
	atl::Optional<avl::AXISRotation::Type> inRotation,
	atl::Optional<int> inCompression,
	atl::Optional<const atl::String&> inTextString,
	atl::Optional<bool> inUseSquarePixel
)

Parameters

Name Type Range Default Description
Input will be modified ioState AXIS_State& Object used to maintain state of the function.
Input value inAddress const String& Source device host or ip address
Input value inCameraID int 1 - 4 ID of camera
Input value inOutputQueueSize int 5 - 200 Capacity of output frames queue
Input value inLogin Optional<const String&> NIL Login for Basic authorization
Input value inPassword Optional<const String&> NIL Login for Basic authorization
Input value inStreamProfile Optional<const String&> NIL Profile configuration name.
Input value inResolution Optional<AXISResolution::Type> NIL Resolution of the returned image
Input value inRotation Optional<AXISRotation::Type> NIL Rotates the image clockwise
Input value inCompression Optional<int> 0 - 100 NIL Compression level of the image
Input value inTextString Optional<const String&> NIL
Input value inUseSquarePixel Optional<bool> NIL Square pixel (aspect ratio) correction

Remarks

Camera identification

Camera is identified by two inputs:

  • inAddress - server name or IP address of camera. It is not a http address using to view image by website. For example:
    http://my.camera.com/folder/view/viewer_index.shtml?id=217
    
    inAddress is
    http://my.camera.com
    
  • inCameraID - camera source. Applies only to video servers with more than one video input.
Changing parameters

AXIS Camera support is based on MJPEG streaming, and after changing any parameter the connection must be reset.

The simplest way to reset connection is to stop and restart the program.

Aurora Vision Studio support only basic authentication, please check your device setting.
In order to change authentication method you need to right-click device on the list in AXIS Device Manager and go to Configure Device. There you need to change "Authentication Policy" parameter to "Basic"

HTTPS is not supported.

Configuring the settings in the manufacturer's application may take priority.

New camera models use a global rotation setting.

Errors

List of possible exceptions:

Error type Description
DomainError Empty inAddress in AXIS_StartAcquisition.

See Also