ArvInterface

ArvInterface — Abstract base class for camera discovery

Functions

Description

ArvInterface is an abstract base class for camera discovery. It maintains a list of the available devices and helps to instantiate the corresponding ArvDevice objects. If the user already knows the device id of the device, he should not worry about this class and just use arv_camera_new() or arv_open_device().

Functions

arv_interface_get_device_address ()

const char *
arv_interface_get_device_address (ArvInterface *interface,
                                  unsigned int index);

queries the device address (IP address in the case of an ethernet camera). Useful for constructing manual connections to devices using arv_gv_device_new

Prior to this call the arv_interface_update_device_list() function must be called.

Parameters

interface

a ArvInterface

 

index

device index

 

Returns

the device address.

[transfer none]

Since: 0.2.0


arv_interface_get_device_id ()

const char *
arv_interface_get_device_id (ArvInterface *interface,
                             unsigned int index);

Queries the unique device id corresponding to index. Prior to this call the arv_interface_update_device_list() function must be called.

Parameters

interface

a ArvInterface

 

index

device index

 

Returns

a unique device id

Since: 0.2.0


arv_interface_get_device_model ()

const char *
arv_interface_get_device_model (ArvInterface *interface,
                                unsigned int index);

Queries the device model.

Prior to this call the arv_interface_update_device_list() function must be called.

Parameters

interface

a ArvInterface

 

index

device index

 

Returns

the device model, NULL on error.

[transfer none]

Since: 0.6.0


arv_interface_get_device_physical_id ()

const char *
arv_interface_get_device_physical_id (ArvInterface *interface,
                                      unsigned int index);

Queries the physical device id corresponding to index such as the MAC address for Ethernet based devices, bus id for PCI, USB or Firewire based devices.

Prior to this call the arv_interface_update_device_list() function must be called.

Parameters

interface

a ArvInterface

 

index

device index

 

Returns

a physical device id

Since: 0.2.0


arv_interface_get_device_serial_nbr ()

const char *
arv_interface_get_device_serial_nbr (ArvInterface *interface,
                                     unsigned int index);

Queries the device serial.

Prior to this call the arv_interface_update_device_list() function must be called.

Parameters

interface

a ArvInterface

 

index

device index

 

Returns

the device serial, NULL on error.

[transfer none]

Since: 0.6.0


arv_interface_get_device_vendor ()

const char *
arv_interface_get_device_vendor (ArvInterface *interface,
                                 unsigned int index);

Queries the device vendor.

Prior to this call the arv_interface_update_device_list() function must be called.

Parameters

interface

a ArvInterface

 

index

device index

 

Returns

the device vendor, NULL on error.

[transfer none]

Since: 0.6.0


arv_interface_get_device_manufacturer_info ()

const char *
arv_interface_get_device_manufacturer_info
                               (ArvInterface *interface,
                                unsigned int index);

Queries the device manufacturer info.

Prior to this call the arv_interface_update_device_list() function must be called.

Parameters

interface

a ArvInterface

 

index

device index

 

Returns

the device manufacturer info, NULL on error.

[transfer none]

Since: 0.8.20


arv_interface_get_device_protocol ()

const char *
arv_interface_get_device_protocol (ArvInterface *interface,
                                   unsigned int index);

Queries the device protocol. Possible values are 'USB3Vision', 'GigEVision' and 'Fake'.

Prior to this call the arv_interface_update_device_list() function must be called.

Parameters

interface

a ArvInterface

 

index

device index

 

Returns

the device protocol as a string, NULL on error.

[transfer none]

Since: 0.6.0


arv_interface_get_n_devices ()

unsigned int
arv_interface_get_n_devices (ArvInterface *interface);

Queries the number of available devices on this interface. Prior to this call the arv_interface_update_device_list function must be called. The list content will not change until the next call of the update function.

Parameters

interface

a ArvInterface

 

Returns

the number of available devices

Since: 0.2.0


arv_interface_open_device ()

ArvDevice *
arv_interface_open_device (ArvInterface *interface,
                           const char *device_id,
                           GError **error);

Creates a new ArvDevice object corresponding to the given device id string. The first available device is returned if device_id is NULL.

Parameters

interface

a ArvInterface

 

device_id

device unique id.

[allow-none]

error

a GError placeholder, NULL to ignore

 

Returns

a new ArvDevice.

[transfer full]

Since: 0.2.0


arv_interface_update_device_list ()

void
arv_interface_update_device_list (ArvInterface *interface);

Updates the internal list of available devices. This may change the connection between a list index and a device ID.

Parameters

interface

a ArvInterface

 

Since: 0.2.0