ArvCamera

ArvCamera — Class for generic camera control

Synopsis

enum                ArvAuto;
ArvAuto             arv_auto_from_string                (const char *string);
const char *        arv_auto_to_string                  (ArvAuto value);
                    ArvCamera;
ArvCamera *         arv_camera_new                      (const char *name);
ArvStream *         arv_camera_create_stream            (ArvCamera *camera,
                                                         ArvStreamCallback callback,
                                                         void *user_data);
ArvDevice *         arv_camera_get_device               (ArvCamera *camera);
const char *        arv_camera_get_vendor_name          (ArvCamera *camera);
const char *        arv_camera_get_model_name           (ArvCamera *camera);
const char *        arv_camera_get_device_id            (ArvCamera *camera);
void                arv_camera_get_sensor_size          (ArvCamera *camera,
                                                         gint *width,
                                                         gint *height);
void                arv_camera_set_region               (ArvCamera *camera,
                                                         gint x,
                                                         gint y,
                                                         gint width,
                                                         gint height);
void                arv_camera_get_region               (ArvCamera *camera,
                                                         gint *x,
                                                         gint *y,
                                                         gint *width,
                                                         gint *height);
void                arv_camera_get_height_bounds        (ArvCamera *camera,
                                                         gint *min,
                                                         gint *max);
void                arv_camera_get_width_bounds         (ArvCamera *camera,
                                                         gint *min,
                                                         gint *max);
void                arv_camera_set_binning              (ArvCamera *camera,
                                                         gint dx,
                                                         gint dy);
void                arv_camera_get_binning              (ArvCamera *camera,
                                                         gint *dx,
                                                         gint *dy);
void                arv_camera_set_pixel_format         (ArvCamera *camera,
                                                         ArvPixelFormat format);
ArvPixelFormat      arv_camera_get_pixel_format         (ArvCamera *camera);
const char *        arv_camera_get_pixel_format_as_string
                                                        (ArvCamera *camera);
gint64 *            arv_camera_get_available_pixel_formats
                                                        (ArvCamera *camera,
                                                         guint *n_pixel_formats);
void                arv_camera_start_acquisition        (ArvCamera *camera);
void                arv_camera_stop_acquisition         (ArvCamera *camera);
void                arv_camera_set_acquisition_mode     (ArvCamera *camera,
                                                         ArvAcquisitionMode value);
ArvAcquisitionMode  arv_camera_get_acquisition_mode     (ArvCamera *camera);
void                arv_camera_set_frame_rate           (ArvCamera *camera,
                                                         double frame_rate);
double              arv_camera_get_frame_rate           (ArvCamera *camera);
void                arv_camera_set_trigger              (ArvCamera *camera,
                                                         const char *source);
void                arv_camera_set_trigger_source       (ArvCamera *camera,
                                                         const char *source);
const char *        arv_camera_get_trigger_source       (ArvCamera *camera);
void                arv_camera_software_trigger         (ArvCamera *camera);
gboolean            arv_camera_is_exposure_time_available
                                                        (ArvCamera *camera);
gboolean            arv_camera_is_exposure_auto_available
                                                        (ArvCamera *camera);
void                arv_camera_set_exposure_time        (ArvCamera *camera,
                                                         double exposure_time_us);
double              arv_camera_get_exposure_time        (ArvCamera *camera);
void                arv_camera_get_exposure_time_bounds (ArvCamera *camera,
                                                         double *min,
                                                         double *max);
void                arv_camera_set_exposure_time_auto   (ArvCamera *camera,
                                                         ArvAuto auto_mode);
ArvAuto             arv_camera_get_exposure_time_auto   (ArvCamera *camera);
gboolean            arv_camera_is_gain_available        (ArvCamera *camera);
gboolean            arv_camera_is_gain_auto_available   (ArvCamera *camera);
void                arv_camera_set_gain                 (ArvCamera *camera,
                                                         double gain);
double              arv_camera_get_gain                 (ArvCamera *camera);
void                arv_camera_get_gain_bounds          (ArvCamera *camera,
                                                         double *min,
                                                         double *max);
void                arv_camera_set_gain_auto            (ArvCamera *camera,
                                                         ArvAuto auto_mode);
ArvAuto             arv_camera_get_gain_auto            (ArvCamera *camera);
guint               arv_camera_get_payload              (ArvCamera *camera);
enum                ArvAcquisitionMode;
const char *        arv_acquisition_mode_to_string      (ArvAcquisitionMode value);
ArvAcquisitionMode  arv_acquisition_mode_from_string    (const char *string);

Object Hierarchy

  GObject
   +----ArvCamera

Properties

  "device"                   ArvDevice*            : Read / Write / Construct Only

Description

ArvCamera is a class for the generic control of cameras. It hides the complexity of the genicam interface by providing a simple API, with the drawback of not exposing all the available features. See ArvDevice and ArvGc for a more advanced use of the Aravis library.

Details

enum ArvAuto

typedef enum {
	ARV_AUTO_OFF,
	ARV_AUTO_ONCE,
	ARV_AUTO_CONTINUOUS
} ArvAuto;

ARV_AUTO_OFF

manual setting

ARV_AUTO_ONCE

automatic setting done once, then returns to manual

ARV_AUTO_CONTINUOUS

setting is adjusted continuously

arv_auto_from_string ()

ArvAuto             arv_auto_from_string                (const char *string);

arv_auto_to_string ()

const char *        arv_auto_to_string                  (ArvAuto value);

ArvCamera

typedef struct _ArvCamera ArvCamera;

arv_camera_new ()

ArvCamera *         arv_camera_new                      (const char *name);

Creates a new ArvCamera. If name is null, it will instantiate the first available camera.

name :

name of the camera. [allow-none]

Returns :

a new ArvCamera.

arv_camera_create_stream ()

ArvStream *         arv_camera_create_stream            (ArvCamera *camera,
                                                         ArvStreamCallback callback,
                                                         void *user_data);

Creates a new ArvStream for video stream handling. See ArvStreamCallback for details regarding the callback function.

camera :

a ArvCamera

callback :

a frame processing callback. [scope call][allow-none]

user_data :

user data for callback. [closure][allow-none]

Returns :

a new ArvStream. [transfer full]

arv_camera_get_device ()

ArvDevice *         arv_camera_get_device               (ArvCamera *camera);

Retrieves the ArvDevice object for more complete access to camera features.

camera :

a ArvCamera

Returns :

underlying device object. [transfer none]

arv_camera_get_vendor_name ()

const char *        arv_camera_get_vendor_name          (ArvCamera *camera);

camera :

a ArvCamera

Returns :

the camera vendor name.

arv_camera_get_model_name ()

const char *        arv_camera_get_model_name           (ArvCamera *camera);

camera :

a ArvCamera

Returns :

the camera model name.

arv_camera_get_device_id ()

const char *        arv_camera_get_device_id            (ArvCamera *camera);

camera :

a ArvCamera

Returns :

the camera device ID.

arv_camera_get_sensor_size ()

void                arv_camera_get_sensor_size          (ArvCamera *camera,
                                                         gint *width,
                                                         gint *height);

camera :

a ArvCamera

width :

camera sensor width. [out]

height :

camera sensor height. [out]

arv_camera_set_region ()

void                arv_camera_set_region               (ArvCamera *camera,
                                                         gint x,
                                                         gint y,
                                                         gint width,
                                                         gint height);

Defines the region of interest which will be transmitted in the video stream.

camera :

a ArvCamera

x :

x offset

y :

y_offset

width :

region width

height :

region height

arv_camera_get_region ()

void                arv_camera_get_region               (ArvCamera *camera,
                                                         gint *x,
                                                         gint *y,
                                                         gint *width,
                                                         gint *height);

Retrieves the current region of interest.

camera :

a ArvCamera

x :

x offset. [out]

y :

y_offset. [out]

width :

region width. [out]

height :

region height. [out]

arv_camera_get_height_bounds ()

void                arv_camera_get_height_bounds        (ArvCamera *camera,
                                                         gint *min,
                                                         gint *max);

Retrieves the valid range for image height.

camera :

a ArvCamera

min :

minimum height. [out]

max :

maximum height. [out]

arv_camera_get_width_bounds ()

void                arv_camera_get_width_bounds         (ArvCamera *camera,
                                                         gint *min,
                                                         gint *max);

Retrieves the valid range for image width.

camera :

a ArvCamera

min :

minimum width. [out]

max :

maximum width. [out]

arv_camera_set_binning ()

void                arv_camera_set_binning              (ArvCamera *camera,
                                                         gint dx,
                                                         gint dy);

Defines binning in both directions. Not all cameras support this feature.

camera :

a ArvCamera

dx :

horizontal binning

dy :

vertical binning

arv_camera_get_binning ()

void                arv_camera_get_binning              (ArvCamera *camera,
                                                         gint *dx,
                                                         gint *dy);

Retrieves binning in both directions.

camera :

a ArvCamera

dx :

horizontal binning placeholder. [out]

dy :

vertical binning placeholder. [out]

arv_camera_set_pixel_format ()

void                arv_camera_set_pixel_format         (ArvCamera *camera,
                                                         ArvPixelFormat format);

Defines pixel format.

camera :

a ArvCamera

format :

pixel format

arv_camera_get_pixel_format ()

ArvPixelFormat      arv_camera_get_pixel_format         (ArvCamera *camera);

camera :

a ArvCamera

Returns :

pixel format.

arv_camera_get_pixel_format_as_string ()

const char *        arv_camera_get_pixel_format_as_string
                                                        (ArvCamera *camera);

Retuns: pixel format as string, NULL on error.

camera :

a ArvCamera

arv_camera_get_available_pixel_formats ()

gint64 *            arv_camera_get_available_pixel_formats
                                                        (ArvCamera *camera,
                                                         guint *n_pixel_formats);

Retrieves the list of all available pixel formats.

camera :

a ArvCamera

n_pixel_formats :

number of different pixel formats. [out]

Returns :

a newly allocated array of ArvPixelFormat. [array length=n_pixel_formats][transfer full]

arv_camera_start_acquisition ()

void                arv_camera_start_acquisition        (ArvCamera *camera);

Starts video stream acquisition.

camera :

a ArvCamera

arv_camera_stop_acquisition ()

void                arv_camera_stop_acquisition         (ArvCamera *camera);

Stops video stream acquisition.

camera :

a ArvCamera

arv_camera_set_acquisition_mode ()

void                arv_camera_set_acquisition_mode     (ArvCamera *camera,
                                                         ArvAcquisitionMode value);

arv_camera_get_acquisition_mode ()

ArvAcquisitionMode  arv_camera_get_acquisition_mode     (ArvCamera *camera);

camera :

a ArvCamera

Returns :

acquisition mode.

arv_camera_set_frame_rate ()

void                arv_camera_set_frame_rate           (ArvCamera *camera,
                                                         double frame_rate);

Configures a fixed frame rate mode. Once acquisition start is triggered, the video stream will be acquired with the given frame rate.

camera :

a ArvCamera

frame_rate :

frame rate, in Hz

arv_camera_get_frame_rate ()

double              arv_camera_get_frame_rate           (ArvCamera *camera);

camera :

a ArvCamera

Returns :

actual frame rate, in Hz.

arv_camera_set_trigger ()

void                arv_camera_set_trigger              (ArvCamera *camera,
                                                         const char *source);

Configures the camera in trigger mode. Typical values for source are "Line1" or "Line2". See the camera documentation for the allowed values. Activation is set to rising edge. It can be changed by accessing the underlying device object.

Source can also be "Software". In this case, an acquisition is triggered by a call to arv_camera_software_trigger().

camera :

a ArvCamera

source :

trigger source as string

arv_camera_set_trigger_source ()

void                arv_camera_set_trigger_source       (ArvCamera *camera,
                                                         const char *source);

Sets the trigger source. This function doesn't check if the camera is configured to actually use this source as a trigger.

camera :

a ArvCamera

source :

source name

arv_camera_get_trigger_source ()

const char *        arv_camera_get_trigger_source       (ArvCamera *camera);

Gets the trigger source. This function doesn't check if the camera is configured to actually use this source as a trigger.

camera :

a ArvCamera

Returns :

a string containing the trigger source name, NULL on error.

arv_camera_software_trigger ()

void                arv_camera_software_trigger         (ArvCamera *camera);

Sends a software trigger command to camera. The camera must be previously configured to use a software trigger, using arv_camera_set_trigger().

camera :

a ArvCamera

arv_camera_is_exposure_time_available ()

gboolean            arv_camera_is_exposure_time_available
                                                        (ArvCamera *camera);

camera :

a ArvCamera Returns: TRUE if Exposure Time feature is available.

arv_camera_is_exposure_auto_available ()

gboolean            arv_camera_is_exposure_auto_available
                                                        (ArvCamera *camera);

camera :

a ArvCamera Returns: TRUE if Exposure Auto feature is available.

arv_camera_set_exposure_time ()

void                arv_camera_set_exposure_time        (ArvCamera *camera,
                                                         double exposure_time_us);

Sets exposure time. User should take care to set a value compatible with the desired frame rate.

camera :

a ArvCamera

exposure_time_us :

exposure time, in µs

arv_camera_get_exposure_time ()

double              arv_camera_get_exposure_time        (ArvCamera *camera);

camera :

a ArvCamera

Returns :

current exposure time, in µs.

arv_camera_get_exposure_time_bounds ()

void                arv_camera_get_exposure_time_bounds (ArvCamera *camera,
                                                         double *min,
                                                         double *max);

Retrieves exposure time bounds, in µs.

camera :

a ArvCamera

min :

minimum exposure time. [out]

max :

maximum exposure time. [out]

arv_camera_set_exposure_time_auto ()

void                arv_camera_set_exposure_time_auto   (ArvCamera *camera,
                                                         ArvAuto auto_mode);

Configures automatic exposure feature.

camera :

a ArvCamera

auto_mode :

auto exposure mode selection

arv_camera_get_exposure_time_auto ()

ArvAuto             arv_camera_get_exposure_time_auto   (ArvCamera *camera);

camera :

a ArvCamera

Returns :

auto exposure mode selection

arv_camera_is_gain_available ()

gboolean            arv_camera_is_gain_available        (ArvCamera *camera);

camera :

a ArvCamera Returns: TRUE if Gain feature is available.

arv_camera_is_gain_auto_available ()

gboolean            arv_camera_is_gain_auto_available   (ArvCamera *camera);

camera :

a ArvCamera Returns: TRUE if Gain feature is available.

arv_camera_set_gain ()

void                arv_camera_set_gain                 (ArvCamera *camera,
                                                         double gain);

Sets the gain of the ADC converter.

camera :

a ArvCamera

gain :

gain value

arv_camera_get_gain ()

double              arv_camera_get_gain                 (ArvCamera *camera);

camera :

a ArvCamera

Returns :

the current gain setting.

arv_camera_get_gain_bounds ()

void                arv_camera_get_gain_bounds          (ArvCamera *camera,
                                                         double *min,
                                                         double *max);

Retrieves gain bounds.

camera :

a ArvCamera

min :

minimum gain. [out]

max :

maximum gain. [out]

arv_camera_set_gain_auto ()

void                arv_camera_set_gain_auto            (ArvCamera *camera,
                                                         ArvAuto auto_mode);

Configures automatic gain feature.

camera :

a ArvCamera

auto_mode :

auto gaine mode selection

arv_camera_get_gain_auto ()

ArvAuto             arv_camera_get_gain_auto            (ArvCamera *camera);

camera :

a ArvCamera

Returns :

auto gain mode selection

arv_camera_get_payload ()

guint               arv_camera_get_payload              (ArvCamera *camera);

Retrieves the size needed for the storage of an image. This value is used for the creation of the stream buffers.

camera :

a ArvCamera

Returns :

frame storage size, in bytes.

enum ArvAcquisitionMode

typedef enum {
	ARV_ACQUISITION_MODE_CONTINUOUS,
	ARV_ACQUISITION_MODE_SINGLE_FRAME
} ArvAcquisitionMode;

ARV_ACQUISITION_MODE_CONTINUOUS

continuous acquisition

ARV_ACQUISITION_MODE_SINGLE_FRAME

only one frame will be acquired

arv_acquisition_mode_to_string ()

const char *        arv_acquisition_mode_to_string      (ArvAcquisitionMode value);

arv_acquisition_mode_from_string ()

ArvAcquisitionMode  arv_acquisition_mode_from_string    (const char *string);

Property Details

The "device" property

  "device"                   ArvDevice*            : Read / Write / Construct Only

the device associated with this camera.