![]() |
![]() |
![]() |
Aravis Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy |
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
); ArvPixelFormat * 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_software_trigger (ArvCamera *camera
); void arv_camera_software_trigger (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
); void arv_camera_set_gain (ArvCamera *camera
,gint gain
); gint arv_camera_get_gain (ArvCamera *camera
); void arv_camera_get_gain_bounds (ArvCamera *camera
,gint *min
,gint *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
);
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.
ArvCamera * arv_camera_new (const char *name
);
Creates a new ArvCamera. If name
is null, it will instantiate the
first available camera.
|
name of the camera. [allow-none] |
Returns : |
a new ArvCamera. |
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.
ArvDevice * arv_camera_get_device (ArvCamera *camera
);
Retrieves the ArvDevice object for more complete access to camera features.
|
a ArvCamera |
Returns : |
underlying device object. [transfer none] |
const char * arv_camera_get_vendor_name (ArvCamera *camera
);
|
a ArvCamera |
Returns : |
the camera vendor name. |
const char * arv_camera_get_model_name (ArvCamera *camera
);
|
a ArvCamera |
Returns : |
the camera model name. |
const char * arv_camera_get_device_id (ArvCamera *camera
);
|
a ArvCamera |
Returns : |
the camera device ID. |
void arv_camera_get_sensor_size (ArvCamera *camera
,gint *width
,gint *height
);
|
a ArvCamera |
|
camera sensor width. [out] |
|
camera sensor height. [out] |
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.
|
a ArvCamera |
|
x offset |
|
y_offset |
|
region width |
|
region height |
void arv_camera_get_region (ArvCamera *camera
,gint *x
,gint *y
,gint *width
,gint *height
);
Retrieves the current region of interest.
|
a ArvCamera |
|
x offset. [out] |
|
y_offset. [out] |
|
region width. [out] |
|
region height. [out] |
void arv_camera_get_height_bounds (ArvCamera *camera
,gint *min
,gint *max
);
Retrieves the valid range for image height.
|
a ArvCamera |
|
minimum height. [out] |
|
maximum height. [out] |
void arv_camera_get_width_bounds (ArvCamera *camera
,gint *min
,gint *max
);
Retrieves the valid range for image width.
|
a ArvCamera |
|
minimum width. [out] |
|
maximum width. [out] |
void arv_camera_set_binning (ArvCamera *camera
,gint dx
,gint dy
);
Defines binning in both directions. Not all cameras support this feature.
|
a ArvCamera |
|
horizontal binning |
|
vertical binning |
void arv_camera_get_binning (ArvCamera *camera
,gint *dx
,gint *dy
);
Retrieves binning in both directions.
|
a ArvCamera |
|
horizontal binning placeholder. [out] |
|
vertical binning placeholder. [out] |
void arv_camera_set_pixel_format (ArvCamera *camera
,ArvPixelFormat format
);
Defines pixel format.
|
a ArvCamera |
|
pixel format |
ArvPixelFormat arv_camera_get_pixel_format (ArvCamera *camera
);
|
a ArvCamera |
Returns : |
pixel format. |
ArvPixelFormat * arv_camera_get_available_pixel_formats (ArvCamera *camera
,guint *n_pixel_formats
);
Retrieves the list of all available pixel formats.
|
a ArvCamera |
|
number of different pixel formats. [out] |
Returns : |
a newly allocated array of ArvPixelFormat. [array length=n_pixel_formats][transfer full] |
void arv_camera_start_acquisition (ArvCamera *camera
);
Starts video stream acquisition.
|
a ArvCamera |
void arv_camera_stop_acquisition (ArvCamera *camera
);
Stops video stream acquisition.
|
a ArvCamera |
void arv_camera_set_acquisition_mode (ArvCamera *camera
,ArvAcquisitionMode value
);
ArvAcquisitionMode arv_camera_get_acquisition_mode (ArvCamera *camera
);
|
a ArvCamera |
Returns : |
acquisition mode. |
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.
|
a ArvCamera |
|
frame rate, in Hz |
double arv_camera_get_frame_rate (ArvCamera *camera
);
|
a ArvCamera |
Returns : |
actual frame rate, in Hz. |
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
.
|
a ArvCamera |
|
trigger source as string |
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
.
|
a ArvCamera |
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.
|
a ArvCamera |
|
exposure time, in µs |
double arv_camera_get_exposure_time (ArvCamera *camera
);
|
a ArvCamera |
Returns : |
current exposure time, in µs. |
void arv_camera_get_exposure_time_bounds (ArvCamera *camera
,double *min
,double *max
);
Retrieves exposure time bounds, in µs.
|
a ArvCamera |
|
minimum exposure time. [out] |
|
maximum exposure time. [out] |
void arv_camera_set_exposure_time_auto (ArvCamera *camera
,ArvAuto auto_mode
);
Configures automatic exposure feature.
|
a ArvCamera |
|
auto exposure mode selection |
ArvAuto arv_camera_get_exposure_time_auto (ArvCamera *camera
);
|
a ArvCamera |
Returns : |
auto exposure mode selection |
void arv_camera_set_gain (ArvCamera *camera
,gint gain
);
Sets the gain of the ADC converter.
|
a ArvCamera |
|
gain value |
gint arv_camera_get_gain (ArvCamera *camera
);
|
a ArvCamera |
Returns : |
the current gain setting. |
void arv_camera_get_gain_bounds (ArvCamera *camera
,gint *min
,gint *max
);
Retrieves gain bounds.
|
a ArvCamera |
|
minimum gain. [out] |
|
maximum gain. [out] |
void arv_camera_set_gain_auto (ArvCamera *camera
,ArvAuto auto_mode
);
Configures automatic gain feature.
|
a ArvCamera |
|
auto gaine mode selection |
ArvAuto arv_camera_get_gain_auto (ArvCamera *camera
);
|
a ArvCamera |
Returns : |
auto gain mode selection |
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.
|
a ArvCamera |
Returns : |
frame storage size, in bytes. |
typedef enum { ARV_ACQUISITION_MODE_CONTINUOUS, ARV_ACQUISITION_MODE_SINGLE_FRAME } ArvAcquisitionMode;
const char * arv_acquisition_mode_to_string (ArvAcquisitionMode value
);
ArvAcquisitionMode arv_acquisition_mode_from_string (const char *string
);