ArvCamera

ArvCamera — Class for generic camera control

Functions

#define ARAVIS_CHECK_VERSION()
guint arv_get_major_version ()
guint arv_get_micro_version ()
guint arv_get_minor_version ()
ArvAuto arv_auto_from_string ()
const char * arv_auto_to_string ()
ArvCamera * arv_camera_new ()
ArvCamera * arv_camera_new_with_device ()
ArvStream * arv_camera_create_stream ()
ArvDevice * arv_camera_get_device ()
const char * arv_camera_get_vendor_name ()
const char * arv_camera_get_model_name ()
const char * arv_camera_get_device_serial_number ()
const char * arv_camera_get_device_id ()
void arv_camera_get_sensor_size ()
void arv_camera_set_region ()
void arv_camera_get_region ()
void arv_camera_get_x_offset_bounds ()
gint arv_camera_get_x_offset_increment ()
void arv_camera_get_y_offset_bounds ()
gint arv_camera_get_y_offset_increment ()
void arv_camera_get_height_bounds ()
gint arv_camera_get_height_increment ()
void arv_camera_get_width_bounds ()
gint arv_camera_get_width_increment ()
gboolean arv_camera_is_binning_available ()
void arv_camera_set_binning ()
void arv_camera_get_binning ()
void arv_camera_get_x_binning_bounds ()
gint arv_camera_get_x_binning_increment ()
void arv_camera_get_y_binning_bounds ()
gint arv_camera_get_y_binning_increment ()
void arv_camera_set_pixel_format ()
ArvPixelFormat arv_camera_get_pixel_format ()
const char * arv_camera_get_pixel_format_as_string ()
void arv_camera_set_pixel_format_from_string ()
gint64 * arv_camera_dup_available_pixel_formats ()
const char ** arv_camera_dup_available_pixel_formats_as_display_names ()
const char ** arv_camera_dup_available_pixel_formats_as_strings ()
void arv_camera_start_acquisition ()
void arv_camera_stop_acquisition ()
void arv_camera_abort_acquisition ()
ArvBuffer * arv_camera_acquisition ()
void arv_camera_set_acquisition_mode ()
ArvAcquisitionMode arv_camera_get_acquisition_mode ()
void arv_camera_set_frame_count ()
gint64 arv_camera_get_frame_count ()
void arv_camera_get_frame_count_bounds ()
gboolean arv_camera_is_frame_rate_available ()
void arv_camera_set_frame_rate ()
double arv_camera_get_frame_rate ()
void arv_camera_get_frame_rate_bounds ()
void arv_camera_set_trigger ()
void arv_camera_set_trigger_source ()
const char * arv_camera_get_trigger_source ()
const char ** arv_camera_dup_available_trigger_sources ()
const char ** arv_camera_dup_available_triggers ()
void arv_camera_clear_triggers ()
gboolean arv_camera_is_software_trigger_supported ()
void arv_camera_software_trigger ()
gboolean arv_camera_is_exposure_time_available ()
gboolean arv_camera_is_exposure_auto_available ()
void arv_camera_set_exposure_time ()
double arv_camera_get_exposure_time ()
void arv_camera_get_exposure_time_bounds ()
void arv_camera_set_exposure_time_auto ()
ArvAuto arv_camera_get_exposure_time_auto ()
void arv_camera_set_exposure_mode ()
gboolean arv_camera_is_gain_available ()
gboolean arv_camera_is_gain_auto_available ()
void arv_camera_set_gain ()
double arv_camera_get_gain ()
void arv_camera_get_gain_bounds ()
void arv_camera_set_gain_auto ()
ArvAuto arv_camera_get_gain_auto ()
gboolean arv_camera_is_black_level_available ()
double arv_camera_get_black_level ()
void arv_camera_set_black_level ()
void arv_camera_get_black_level_bounds ()
gboolean arv_camera_is_black_level_auto_available ()
ArvAuto arv_camera_get_black_level_auto ()
void arv_camera_set_black_level_auto ()
guint arv_camera_get_payload ()
gboolean arv_camera_is_feature_available ()
void arv_camera_execute_command ()
gboolean arv_camera_is_enumeration_entry_available ()
gint64 * arv_camera_dup_available_enumerations ()
const char ** arv_camera_dup_available_enumerations_as_strings ()
const char ** arv_camera_dup_available_enumerations_as_display_names ()
gboolean arv_camera_get_boolean ()
double arv_camera_get_float ()
void arv_camera_get_float_bounds ()
double arv_camera_get_float_increment ()
gint64 arv_camera_get_integer ()
void arv_camera_get_integer_bounds ()
gint64 arv_camera_get_integer_increment ()
const char * arv_camera_get_string ()
void arv_camera_set_boolean ()
void arv_camera_set_float ()
void arv_camera_set_integer ()
void arv_camera_set_string ()
void arv_camera_set_range_check_policy ()
void arv_camera_set_register_cache_policy ()
gboolean arv_camera_is_gv_device ()
gint arv_camera_gv_get_n_stream_channels ()
void arv_camera_gv_select_stream_channel ()
int arv_camera_gv_get_current_stream_channel ()
gint64 arv_camera_gv_get_packet_delay ()
void arv_camera_gv_set_packet_delay ()
guint arv_camera_gv_get_packet_size ()
void arv_camera_gv_set_packet_size ()
guint arv_camera_gv_auto_packet_size ()
void arv_camera_gv_set_packet_size_adjustment ()
void arv_camera_gv_set_stream_options ()
gboolean arv_camera_is_uv_device ()
void arv_camera_uv_set_usb_mode ()
guint arv_camera_uv_get_bandwidth ()
void arv_camera_uv_get_bandwidth_bounds ()
gboolean arv_camera_uv_is_bandwidth_control_available ()
void arv_camera_uv_set_bandwidth ()
gboolean arv_camera_are_chunks_available ()
gboolean arv_camera_get_chunk_mode ()
gboolean arv_camera_get_chunk_state ()
void arv_camera_set_chunk_mode ()
void arv_camera_set_chunk_state ()
void arv_camera_set_chunks ()
ArvChunkParser * arv_camera_create_chunk_parser ()
const char * arv_acquisition_mode_to_string ()
ArvAcquisitionMode arv_acquisition_mode_from_string ()
ArvExposureMode arv_exposure_mode_from_string ()
const char * arv_exposure_mode_to_string ()

Properties

ArvDevice * device Read / Write / Construct Only
char * name Write / Construct Only

Types and Values

Object Hierarchy

    GObject
    ╰── ArvCamera

Implemented Interfaces

ArvCamera implements GInitable.

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.

Example 1. Example use of the ArvCamera API

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
#include <arv.h>
#include <stdlib.h>
#include <signal.h>
#include <stdio.h>

typedef struct {
	GMainLoop *main_loop;
	int buffer_count;
} ApplicationData;

static gboolean cancel = FALSE;

static void
set_cancel (int signal)
{
	cancel = TRUE;
}

static void
new_buffer_cb (ArvStream *stream, ApplicationData *data)
{
	ArvBuffer *buffer;

	buffer = arv_stream_try_pop_buffer (stream);
	if (buffer != NULL) {
		if (arv_buffer_get_status (buffer) == ARV_BUFFER_STATUS_SUCCESS)
			data->buffer_count++;
		/* Image processing here */
		arv_stream_push_buffer (stream, buffer);
	}
}

static gboolean
periodic_task_cb (void *abstract_data)
{
	ApplicationData *data = abstract_data;

	printf ("Frame rate = %d Hz\n", data->buffer_count);
	data->buffer_count = 0;

	if (cancel) {
		g_main_loop_quit (data->main_loop);
		return FALSE;
	}

	return TRUE;
}

static void
control_lost_cb (ArvGvDevice *gv_device)
{
	/* Control of the device is lost. Display a message and force application exit */
	printf ("Control lost\n");

	cancel = TRUE;
}

int
main (int argc, char **argv)
{
	ApplicationData data;
	ArvCamera *camera;
	ArvStream *stream;
	GError *error = NULL;
	int i;

	data.buffer_count = 0;

	/* Instantiation of the first available camera */
	camera = arv_camera_new (NULL, &error);

	if (ARV_IS_CAMERA (camera)) {
		void (*old_sigint_handler)(int);
		gint payload;

		/* Set region of interrest to a 200x200 pixel area */
		arv_camera_set_region (camera, 0, 0, 200, 200, NULL);
		/* Set frame rate to 10 Hz */
		arv_camera_set_frame_rate (camera, 10.0, NULL);
		/* retrieve image payload (number of bytes per image) */
		payload = arv_camera_get_payload (camera, NULL);

		/* Create a new stream object */
		stream = arv_camera_create_stream (camera, NULL, NULL, &error);

		if (ARV_IS_STREAM (stream)) {
			/* Push 50 buffer in the stream input buffer queue */
			for (i = 0; i < 50; i++)
				arv_stream_push_buffer (stream, arv_buffer_new (payload, NULL));

			/* Start the video stream */
			arv_camera_start_acquisition (camera, NULL);

			/* Connect the new-buffer signal */
			g_signal_connect (stream, "new-buffer", G_CALLBACK (new_buffer_cb), &data);
			/* And enable emission of this signal (it's disabled by default for performance reason) */
			arv_stream_set_emit_signals (stream, TRUE);

			/* Connect the control-lost signal */
			g_signal_connect (arv_camera_get_device (camera), "control-lost",
					  G_CALLBACK (control_lost_cb), NULL);

			/* Install the callback for frame rate display */
			g_timeout_add_seconds (1, periodic_task_cb, &data);

			/* Create a new glib main loop */
			data.main_loop = g_main_loop_new (NULL, FALSE);

			old_sigint_handler = signal (SIGINT, set_cancel);

			/* Run the main loop */
			g_main_loop_run (data.main_loop);

			signal (SIGINT, old_sigint_handler);

			g_main_loop_unref (data.main_loop);

			/* Stop the video stream */
			arv_camera_stop_acquisition (camera, NULL);

			/* Signal must be inhibited to avoid stream thread running after the last unref */
			arv_stream_set_emit_signals (stream, FALSE);

			g_object_unref (stream);
		} else {
			printf ("Can't create stream thread%s%s\n",
				error != NULL ? ": " : "",
				error != NULL ? error->message : "");

			g_clear_error (&error);
		}

		g_object_unref (camera);
	} else {
		printf ("No camera found%s%s\n",
			error != NULL ? ": " : "",
			error != NULL ? error->message : "");
		g_clear_error (&error);
	}

	return 0;
}

Functions

ARAVIS_CHECK_VERSION()

#define             ARAVIS_CHECK_VERSION(major,minor,micro)

Checks the version of the Aravis library that is being compiled against.

Parameters

major

the major version to check for

 

minor

the minor version to check for

 

micro

the micro version to check for

 

Returns

TRUE if the version of the Aravis header files is the same as or newer than the passed-in version.

Since: 0.6.0


arv_get_major_version ()

guint
arv_get_major_version (void);

Returns the major version number of the Aravis library.

For example, in Aravis version 0.8.20 this is 0.

This function is in the library, so it represents the Aravis library your code is running against. Contrast with the ARAVIS_MAJOR_VERSION macro, which represents the major version of the Aravis headers you have included when compiling your code.

Returns

the major version number of the Aravis library

Since: 0.8.20


arv_get_micro_version ()

guint
arv_get_micro_version (void);

Returns the micro version number of the Aravis library.

For example, in Aravis version 0.8.20 this is 20.

This function is in the library, so it represents the Aravis library your code is running against. Contrast with the ARAVIS_MICRO_VERSION macro, which represents the micro version of the Aravis headers you have included when compiling your code.

Returns

the micro version number of the Aravis library

Since: 0.8.20


arv_get_minor_version ()

guint
arv_get_minor_version (void);

Returns the minor version number of the Aravis library.

For example, in Aravis version 0.8.20 this is 8.

This function is in the library, so it represents the Aravis library your code is running against. Contrast with the ARAVIS_MINOR_VERSION macro, which represents the minor version of the Aravis headers you have included when compiling your code.

Returns

the minor version number of the Aravis library

Since: 0.8.20


arv_auto_from_string ()

ArvAuto
arv_auto_from_string (const char *string);

arv_auto_to_string ()

const char *
arv_auto_to_string (ArvAuto value);

arv_camera_new ()

ArvCamera *
arv_camera_new (const char *name,
                GError **error);

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

If the camera is a GigEVision, name can be either:

  • <vendor>-<model>-<serial>

  • <vendor_alias>-<serial>

  • <vendor>-<serial>

  • <user_id>

  • <ip_address>

  • <mac_address>

For example:

  • The Imaging Source Europe GmbH-DFK 33GX265-39020369

  • The Imaging Source Europe GmbH-39020369

  • TIS-39020369

  • 192.168.0.2

  • 00:07:48:af:a2:61

If the camera is a USB3Vision device, name is either:

  • <vendor_alias>-<serial>

  • <vendor>-<serial>

Parameters

name

name of the camera.

[allow-none]

error

a GError placeholder, NULL to ignore

 

Returns

a new ArvCamera.

Since: 0.8.0


arv_camera_new_with_device ()

ArvCamera *
arv_camera_new_with_device (ArvDevice *device,
                            GError **error);

Creates a new ArvCamera, using device as its internal device object.

Parameters

device

a ArvDevice.

[transfer none]

error

a GError placeholder, NULL to ignore

 

Returns

a new ArvCamera.

Since: 0.8.6


arv_camera_create_stream ()

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

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

Parameters

camera

a ArvCamera

 

callback

a frame processing callback.

[scope call][allow-none]

user_data

user data for callback .

[closure][allow-none]

error

a GError placeholder, NULL to ignore

 

Returns

a new ArvStream, to be freed after use with g_object_unref().

[transfer full]

Since: 0.2.0


arv_camera_get_device ()

ArvDevice *
arv_camera_get_device (ArvCamera *camera);

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

Parameters

camera

a ArvCamera

 

Returns

underlying device object.

[transfer none]

Since: 0.2.0


arv_camera_get_vendor_name ()

const char *
arv_camera_get_vendor_name (ArvCamera *camera,
                            GError **error);

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ignore

 

Returns

the camera vendor name.

Since: 0.8.0


arv_camera_get_model_name ()

const char *
arv_camera_get_model_name (ArvCamera *camera,
                           GError **error);

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ignore

 

Returns

the camera model name.

Since: 0.8.0


arv_camera_get_device_serial_number ()

const char *
arv_camera_get_device_serial_number (ArvCamera *camera,
                                     GError **error);

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ignore

 

Returns

the camera device serial number.

Since: 0.8.8


arv_camera_get_device_id ()

const char *
arv_camera_get_device_id (ArvCamera *camera,
                          GError **error);

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ignore

 

Returns

the camera device ID.

Since: 0.8.0


arv_camera_get_sensor_size ()

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

Parameters

camera

a ArvCamera

 

width

camera sensor width.

[out]

height

camera sensor height.

[out]

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_set_region ()

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

Defines the region of interest which will be transmitted in the video stream. Negative x or y values, or not strictly positive width or height values are ignored.

Parameters

camera

a ArvCamera

 

x

x offset

 

y

y_offset

 

width

region width

 

height

region height

 

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_get_region ()

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

Retrieves the current region of interest.

Parameters

camera

a ArvCamera

 

x

x offset.

[out]

y

y_offset.

[out]

width

region width.

[out]

height

region height.

[out]

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_get_x_offset_bounds ()

void
arv_camera_get_x_offset_bounds (ArvCamera *camera,
                                gint *min,
                                gint *max,
                                GError **error);

Retrieves the valid range for image horizontal offset.

Parameters

camera

a ArvCamera

 

min

minimum offset.

[out]

max

maximum offset.

[out]

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_get_x_offset_increment ()

gint
arv_camera_get_x_offset_increment (ArvCamera *camera,
                                   GError **error);

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ignore

 

Returns

horizontal offset value increment.

Since: 0.8.0


arv_camera_get_y_offset_bounds ()

void
arv_camera_get_y_offset_bounds (ArvCamera *camera,
                                gint *min,
                                gint *max,
                                GError **error);

Retrieves the valid range for image vertical offset.

Parameters

camera

a ArvCamera

 

min

minimum offset.

[out]

max

maximum offset.

[out]

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_get_y_offset_increment ()

gint
arv_camera_get_y_offset_increment (ArvCamera *camera,
                                   GError **error);

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ignore

 

Returns

vertical offset value increment.

Since: 0.8.0


arv_camera_get_height_bounds ()

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

Retrieves the valid range for image height.

Parameters

camera

a ArvCamera

 

min

minimum height.

[out]

max

maximum height.

[out]

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_get_height_increment ()

gint
arv_camera_get_height_increment (ArvCamera *camera,
                                 GError **error);

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ignore

 

Returns

height value increment.

Since: 0.8.0


arv_camera_get_width_bounds ()

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

Retrieves the valid range for image width.

Parameters

camera

a ArvCamera

 

min

minimum width.

[out]

max

maximum width.

[out]

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_get_width_increment ()

gint
arv_camera_get_width_increment (ArvCamera *camera,
                                GError **error);

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ignore

 

Returns

width value increment.

Since: 0.8.0


arv_camera_is_binning_available ()

gboolean
arv_camera_is_binning_available (ArvCamera *camera,
                                 GError **error);

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ingore

 

Returns

TRUE if Binning feature is available.

Since: 0.8.0


arv_camera_set_binning ()

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

Defines binning in both directions. Not all cameras support this feature. Negative dx or dy values are ignored.

Parameters

camera

a ArvCamera

 

dx

horizontal binning

 

dy

vertical binning

 

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_get_binning ()

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

Retrieves binning in both directions.

Parameters

camera

a ArvCamera

 

dx

horizontal binning placeholder.

[out]

dy

vertical binning placeholder.

[out]

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_get_x_binning_bounds ()

void
arv_camera_get_x_binning_bounds (ArvCamera *camera,
                                 gint *min,
                                 gint *max,
                                 GError **error);

Retrieves the valid range for image horizontal binning.

Parameters

camera

a ArvCamera

 

min

minimum binning.

[out]

max

maximum binning.

[out]

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_get_x_binning_increment ()

gint
arv_camera_get_x_binning_increment (ArvCamera *camera,
                                    GError **error);

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ignore

 

Returns

horizontal binning value increment.

Since: 0.8.0


arv_camera_get_y_binning_bounds ()

void
arv_camera_get_y_binning_bounds (ArvCamera *camera,
                                 gint *min,
                                 gint *max,
                                 GError **error);

Retrieves the valid range for image vertical binning.

Parameters

camera

a ArvCamera

 

min

minimum binning.

[out]

max

maximum binning.

[out]

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_get_y_binning_increment ()

gint
arv_camera_get_y_binning_increment (ArvCamera *camera,
                                    GError **error);

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ignore

 

Returns

vertical binning value increment.

Since: 0.8.0


arv_camera_set_pixel_format ()

void
arv_camera_set_pixel_format (ArvCamera *camera,
                             ArvPixelFormat format,
                             GError **error);

Defines pixel format.

Parameters

camera

a ArvCamera

 

format

pixel format

 

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_get_pixel_format ()

ArvPixelFormat
arv_camera_get_pixel_format (ArvCamera *camera,
                             GError **error);

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ignore

 

Returns

pixel format.

Since: 0.8.0


arv_camera_get_pixel_format_as_string ()

const char *
arv_camera_get_pixel_format_as_string (ArvCamera *camera,
                                       GError **error);

Retuns: pixel format as string, NULL on error.

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_set_pixel_format_from_string ()

void
arv_camera_set_pixel_format_from_string
                               (ArvCamera *camera,
                                const char *format,
                                GError **error);

Defines pixel format described by a string.

Parameters

camera

a ArvCamera

 

format

pixel format

 

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_dup_available_pixel_formats ()

gint64 *
arv_camera_dup_available_pixel_formats
                               (ArvCamera *camera,
                                guint *n_pixel_formats,
                                GError **error);

Retrieves the list of all available pixel formats.

Parameters

camera

a ArvCamera

 

n_pixel_formats

number of different pixel formats.

[out]

error

a GError placeholder, NULL to ignore

 

Returns

a newly allocated array of ArvPixelFormat, to be freed after use with g_free().

[array length=n_pixel_formats][transfer container]

Since: 0.8.0


arv_camera_dup_available_pixel_formats_as_display_names ()

const char **
arv_camera_dup_available_pixel_formats_as_display_names
                               (ArvCamera *camera,
                                guint *n_pixel_formats,
                                GError **error);

Retrieves the list of all available pixel formats as display names. In general, these human-readable strings cannot be used as settings.

Parameters

camera

a ArvCamera

 

n_pixel_formats

number of different pixel formats.

[out]

error

a GError placeholder, NULL to ignore

 

Returns

a newly allocated array of string constants, to be freed after use with g_free().

[array length=n_pixel_formats][transfer container]

Since: 0.8.0


arv_camera_dup_available_pixel_formats_as_strings ()

const char **
arv_camera_dup_available_pixel_formats_as_strings
                               (ArvCamera *camera,
                                guint *n_pixel_formats,
                                GError **error);

Retrieves the list of all available pixel formats as strings.

Parameters

camera

a ArvCamera

 

n_pixel_formats

number of different pixel formats.

[out]

error

a GError placeholder, NULL to ignore

 

Returns

a newly allocated array of strings, to be freed after use with g_free().

[array length=n_pixel_formats][transfer container]

Since: 0.8.0


arv_camera_start_acquisition ()

void
arv_camera_start_acquisition (ArvCamera *camera,
                              GError **error);

Starts video stream acquisition.

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_stop_acquisition ()

void
arv_camera_stop_acquisition (ArvCamera *camera,
                             GError **error);

Stops video stream acquisition.

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_abort_acquisition ()

void
arv_camera_abort_acquisition (ArvCamera *camera,
                              GError **error);

Aborts video stream acquisition.

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_acquisition ()

ArvBuffer *
arv_camera_acquisition (ArvCamera *camera,
                        guint64 timeout,
                        GError **error);

Acquire one image buffer.

arv_camera_acquisition() sets the camera in SingleFrame acquisition mode. You may have to put back the camera in Continuous acquisition mode for later operations, using arv_camera_set_acquisition_mode().

Parameters

camera

a ArvCamera

 

timeout

acquisition timeout in µs. Zero means no timeout.

 

error

a GError placeholder, NULL to ignore

 

Returns

A new ArvBuffer, NULL on error. The returned buffer must be freed using g_object_unref().

[transfer full]

Since: 0.8.0


arv_camera_set_acquisition_mode ()

void
arv_camera_set_acquisition_mode (ArvCamera *camera,
                                 ArvAcquisitionMode value,
                                 GError **error);

arv_camera_get_acquisition_mode ()

ArvAcquisitionMode
arv_camera_get_acquisition_mode (ArvCamera *camera,
                                 GError **error);

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ignore

 

Returns

acquisition mode.

Since: 0.8.0


arv_camera_set_frame_count ()

void
arv_camera_set_frame_count (ArvCamera *camera,
                            gint64 frame_count,
                            GError **error);

Sets the number of frames to capture in MultiFrame mode.

Parameters

camera

a ArvCamera

 

frame_count

number of frames to capture in MultiFrame mode

 

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_get_frame_count ()

gint64
arv_camera_get_frame_count (ArvCamera *camera,
                            GError **error);

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ignore

 

Returns

number of frames to capture in MultiFrame mode.

Since: 0.8.0


arv_camera_get_frame_count_bounds ()

void
arv_camera_get_frame_count_bounds (ArvCamera *camera,
                                   gint64 *min,
                                   gint64 *max,
                                   GError **error);

Retrieves allowed range for frame count.

Parameters

camera

a ArvCamera

 

min

minimal possible frame count.

[out]

max

maximum possible frame count.

[out]

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_is_frame_rate_available ()

gboolean
arv_camera_is_frame_rate_available (ArvCamera *camera,
                                    GError **error);

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ingore

 

Returns

TRUE if FrameRate feature is available

Since: 0.8.0


arv_camera_set_frame_rate ()

void
arv_camera_set_frame_rate (ArvCamera *camera,
                           double frame_rate,
                           GError **error);

Configures a fixed frame rate mode. Once acquisition start is triggered, the video stream will be acquired with the given frame rate. A negative or zero frame_rate value disables the frame rate limit.

All triggers are disabled.

Parameters

camera

a ArvCamera

 

frame_rate

frame rate, in Hz

 

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_get_frame_rate ()

double
arv_camera_get_frame_rate (ArvCamera *camera,
                           GError **error);

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ignore

 

Returns

actual frame rate, in Hz.

Since: 0.8.0


arv_camera_get_frame_rate_bounds ()

void
arv_camera_get_frame_rate_bounds (ArvCamera *camera,
                                  double *min,
                                  double *max,
                                  GError **error);

Retrieves allowed range for framerate.

Since 0.8.0

Parameters

camera

a ArvCamera

 

min

minimal possible framerate.

[out]

max

maximum possible framerate.

[out]

error

a GError placeholder, NULL to ignore

 

arv_camera_set_trigger ()

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

Configures the camera in trigger mode. Typical values for source are "Line1" or "Line2". See the camera documentation for the allowed values. Source can also be "Software". In this case, an acquisition is triggered by a call to arv_camera_software_trigger().

The trigger set is "FrameStart". "AcquisitionStart" is used as a fallback if "FrameStart" is not present. All other triggers are disabled. "TriggerActivation" is set to rising edge.

For an advanced trigger configuration, use the underlying ArvDevice object returned by arv_camera_get_device().

Parameters

camera

a ArvCamera

 

source

trigger source as string

 

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_set_trigger_source ()

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

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

Parameters

camera

a ArvCamera

 

source

source name

 

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_get_trigger_source ()

const char *
arv_camera_get_trigger_source (ArvCamera *camera,
                               GError **error);

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

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ignore

 

Returns

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

Since: 0.8.0


arv_camera_dup_available_trigger_sources ()

const char **
arv_camera_dup_available_trigger_sources
                               (ArvCamera *camera,
                                guint *n_sources,
                                GError **error);

Gets the list of all available trigger sources.

Parameters

camera

a ArvCamera

 

n_sources

number of sources.

[out]

error

a GError placeholder, NULL to ignore

 

Returns

a newly allocated array of strings, which must be freed using g_free().

[array length=n_sources][transfer container]

Since: 0.8.0


arv_camera_dup_available_triggers ()

const char **
arv_camera_dup_available_triggers (ArvCamera *camera,
                                   guint *n_triggers,
                                   GError **error);

Gets a list of all available triggers: FrameStart, ExposureActive, etc...

Parameters

camera

a ArvCamera

 

n_triggers

number of available triggers.

[out]

error

a GError placeholder, NULL to ignore

 

Returns

a newly allocated array of strings, which must be freed using g_free().

[array length=n_triggers][transfer container]

Since: 0.8.0


arv_camera_clear_triggers ()

void
arv_camera_clear_triggers (ArvCamera *camera,
                           GError **error);

Disables all triggers.

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_is_software_trigger_supported ()

gboolean
arv_camera_is_software_trigger_supported
                               (ArvCamera *camera,
                                GError **error);

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ignore

 

Returns

TRUE% if software trigger is supported.

Since: 0.8.17


arv_camera_software_trigger ()

void
arv_camera_software_trigger (ArvCamera *camera,
                             GError **error);

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

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_is_exposure_time_available ()

gboolean
arv_camera_is_exposure_time_available (ArvCamera *camera,
                                       GError **error);

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ingore

 

Returns

TRUE if Exposure Time feature is available.

Since: 0.8.0


arv_camera_is_exposure_auto_available ()

gboolean
arv_camera_is_exposure_auto_available (ArvCamera *camera,
                                       GError **error);

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ingore

 

Returns

TRUE if Exposure Auto feature is available.

Since: 0.8.0


arv_camera_set_exposure_time ()

void
arv_camera_set_exposure_time (ArvCamera *camera,
                              double exposure_time_us,
                              GError **error);

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

Parameters

camera

a ArvCamera

 

exposure_time_us

exposure time, in µs

 

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_get_exposure_time ()

double
arv_camera_get_exposure_time (ArvCamera *camera,
                              GError **error);

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ignore

 

Returns

current exposure time, in µs.

Since: 0.8.0


arv_camera_get_exposure_time_bounds ()

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

Retrieves exposure time bounds, in µs.

Parameters

camera

a ArvCamera

 

min

minimum exposure time.

[out]

max

maximum exposure time.

[out]

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_set_exposure_time_auto ()

void
arv_camera_set_exposure_time_auto (ArvCamera *camera,
                                   ArvAuto auto_mode,
                                   GError **error);

Configures automatic exposure feature.

Parameters

camera

a ArvCamera

 

auto_mode

auto exposure mode selection

 

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_get_exposure_time_auto ()

ArvAuto
arv_camera_get_exposure_time_auto (ArvCamera *camera,
                                   GError **error);

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ignore

 

Returns

auto exposure mode selection

Since: 0.8.0


arv_camera_set_exposure_mode ()

void
arv_camera_set_exposure_mode (ArvCamera *camera,
                              ArvExposureMode mode,
                              GError **error);

arv_camera_is_gain_available ()

gboolean
arv_camera_is_gain_available (ArvCamera *camera,
                              GError **error);

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ingore

 

Returns

TRUE if Gain feature is available.

Since: 0.8.0


arv_camera_is_gain_auto_available ()

gboolean
arv_camera_is_gain_auto_available (ArvCamera *camera,
                                   GError **error);

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ingore

 

Returns

TRUE if auto gain feature is available.

Since: 0.8.0


arv_camera_set_gain ()

void
arv_camera_set_gain (ArvCamera *camera,
                     double gain,
                     GError **error);

Sets the gain of the ADC converter. Negative gain is ignored.

Parameters

camera

a ArvCamera

 

gain

gain value

 

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_get_gain ()

double
arv_camera_get_gain (ArvCamera *camera,
                     GError **error);

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ignore

 

Returns

the current gain setting.

Since: 0.8.0


arv_camera_get_gain_bounds ()

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

Retrieves gain bounds.

Parameters

camera

a ArvCamera

 

min

minimum gain.

[out]

max

maximum gain.

[out]

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_set_gain_auto ()

void
arv_camera_set_gain_auto (ArvCamera *camera,
                          ArvAuto auto_mode,
                          GError **error);

Configures automatic gain feature.

Parameters

camera

a ArvCamera

 

auto_mode

auto gain mode selection

 

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_get_gain_auto ()

ArvAuto
arv_camera_get_gain_auto (ArvCamera *camera,
                          GError **error);

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ignore

 

Returns

auto gain mode selection

Since: 0.8.0


arv_camera_is_black_level_available ()

gboolean
arv_camera_is_black_level_available (ArvCamera *camera,
                                     GError **error);

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ignore

 

Returns

TRUE if BlackLevel feature is available.

Since: 0.8.19


arv_camera_get_black_level ()

double
arv_camera_get_black_level (ArvCamera *camera,
                            GError **error);

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ignore

 

Returns

the current blacklevel setting.

Since: 0.8.19


arv_camera_set_black_level ()

void
arv_camera_set_black_level (ArvCamera *camera,
                            double blacklevel,
                            GError **error);

Parameters

camera

a ArvCamera

 

blacklevel

blacklevel value

 

error

a GError placeholder, NULL to ignore

 

Since: 0.8.19


arv_camera_get_black_level_bounds ()

void
arv_camera_get_black_level_bounds (ArvCamera *camera,
                                   double *min,
                                   double *max,
                                   GError **error);

Retrieves blacklevel bounds.

Parameters

camera

a ArvCamera

 

min

minimum blacklevel.

[out]

max

maximum blacklevel.

[out]

error

a GError placeholder, NULL to ignore

 

Since: 0.8.19


arv_camera_is_black_level_auto_available ()

gboolean
arv_camera_is_black_level_auto_available
                               (ArvCamera *camera,
                                GError **error);

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ingore

 

Returns

TRUE if auto black level feature is available.

Since: 0.8.19


arv_camera_get_black_level_auto ()

ArvAuto
arv_camera_get_black_level_auto (ArvCamera *camera,
                                 GError **error);

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ignore

 

Returns

auto black level mode selection

Since: 0.8.19


arv_camera_set_black_level_auto ()

void
arv_camera_set_black_level_auto (ArvCamera *camera,
                                 ArvAuto auto_mode,
                                 GError **error);

Configures automatic black level feature.

Parameters

camera

a ArvCamera

 

auto_mode

auto black_level mode selection

 

error

a GError placeholder, NULL to ignore

 

Since: 0.8.19


arv_camera_get_payload ()

guint
arv_camera_get_payload (ArvCamera *camera,
                        GError **error);

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

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ignore

 

Returns

frame storage size, in bytes.

Since: 0.8.0


arv_camera_is_feature_available ()

gboolean
arv_camera_is_feature_available (ArvCamera *camera,
                                 const char *feature,
                                 GError **error);

Return: TRUE if feature is available, FALSE if not or on error.

Parameters

camera

a ArvCamera

 

feature

feature name

 

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_execute_command ()

void
arv_camera_execute_command (ArvCamera *camera,
                            const char *feature,
                            GError **error);

Execute a Genicam command.

Parameters

camera

a ArvCamera

 

feature

feature name

 

error

a GError placeholder, NULL to ingore

 

Since: 0.8.0


arv_camera_is_enumeration_entry_available ()

gboolean
arv_camera_is_enumeration_entry_available
                               (ArvCamera *camera,
                                const char *feature,
                                const char *entry,
                                GError **error);

Parameters

camera

a ArvCamera

 

feature

enumeration feature name

 

entry

entry name

 

error

a GError placeholder, NULL to ignore

 

Returns

TRUE if the feature and the feature entry are available

Since: 0.8.17


arv_camera_dup_available_enumerations ()

gint64 *
arv_camera_dup_available_enumerations (ArvCamera *camera,
                                       const char *feature,
                                       guint *n_values,
                                       GError **error);

Get all the available values of feature , as 64 bit integers.

Parameters

camera

a ArvCamera

 

feature

feature name

 

n_values

placeholder for the number of returned values

 

error

a GError placeholder, NULL to ignore

 

Returns

a newly created array of integers, which must freed after use using g_free, or NULL on error.

[array length=n_values][transfer container]

Since: 0.8.0


arv_camera_dup_available_enumerations_as_strings ()

const char **
arv_camera_dup_available_enumerations_as_strings
                               (ArvCamera *camera,
                                const char *feature,
                                guint *n_values,
                                GError **error);

Get all the available values of feature , as strings.

Parameters

camera

a ArvCamera

 

feature

feature name

 

n_values

placeholder for the number of returned values

 

error

a GError placeholder, NULL to ignore

 

Returns

a newly created array of const strings, which must freed after use using g_free, or NULL on error.

[array length=n_values][transfer container]

Since: 0.8.0


arv_camera_dup_available_enumerations_as_display_names ()

const char **
arv_camera_dup_available_enumerations_as_display_names
                               (ArvCamera *camera,
                                const char *feature,
                                guint *n_values,
                                GError **error);

Get display names of all the available entries of feature .

Parameters

camera

a ArvCamera

 

feature

feature name

 

n_values

placeholder for the number of returned values

 

error

a GError placeholder, NULL to ignore

 

Returns

a newly created array of const strings, to be freed after use using g_free, or NULL on error.

[array length=n_values][transfer container]

Since: 0.8.0


arv_camera_get_boolean ()

gboolean
arv_camera_get_boolean (ArvCamera *camera,
                        const char *feature,
                        GError **error);

Parameters

camera

a ArvCamera

 

feature

feature name

 

error

a GError placeholder, NULL to ignore

 

Returns

the boolean feature value, FALSE on error.

Since: 0.8.0


arv_camera_get_float ()

double
arv_camera_get_float (ArvCamera *camera,
                      const char *feature,
                      GError **error);

Parameters

camera

a ArvCamera

 

feature

feature name

 

error

a GError placeholder, NULL to ignore

 

Returns

the float feature value, 0.0 on error.

Since: 0.8.0


arv_camera_get_float_bounds ()

void
arv_camera_get_float_bounds (ArvCamera *camera,
                             const char *feature,
                             double *min,
                             double *max,
                             GError **error);

Retrieves float feature bounds.

Parameters

camera

a ArvCamera

 

feature

feature name

 

min

minimum feature value.

[out]

max

maximum feature value.

[out]

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_get_float_increment ()

double
arv_camera_get_float_increment (ArvCamera *camera,
                                const char *feature,
                                GError **error);

Parameters

camera

a ArvCamera

 

feature

feature name

 

error

a GError placeholder, NULL to ignore

 

Returns

feature value increment, or G_MINDOUBLE on error.

Since: 0.8.16


arv_camera_get_integer ()

gint64
arv_camera_get_integer (ArvCamera *camera,
                        const char *feature,
                        GError **error);

Parameters

camera

a ArvCamera

 

feature

feature name

 

error

a GError placeholder, NULL to ignore

 

Returns

the integer feature value, 0 on error.

Since: 0.8.0


arv_camera_get_integer_bounds ()

void
arv_camera_get_integer_bounds (ArvCamera *camera,
                               const char *feature,
                               gint64 *min,
                               gint64 *max,
                               GError **error);

Retrieves integer feature bounds.

Parameters

camera

a ArvCamera

 

feature

feature name

 

min

minimum feature value.

[out]

max

maximum feature value.

[out]

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_get_integer_increment ()

gint64
arv_camera_get_integer_increment (ArvCamera *camera,
                                  const char *feature,
                                  GError **error);

Parameters

camera

a ArvCamera

 

feature

feature name

 

error

a GError placeholder, NULL to ignore

 

Returns

feature value increment, or 1 on error.

Since: 0.8.0


arv_camera_get_string ()

const char *
arv_camera_get_string (ArvCamera *camera,
                       const char *feature,
                       GError **error);

Parameters

camera

a ArvCamera

 

feature

feature name

 

error

a GError placeholder, NULL to ignore

 

Returns

the string feature value, NULL on error.

Since: 0.8.0


arv_camera_set_boolean ()

void
arv_camera_set_boolean (ArvCamera *camera,
                        const char *feature,
                        gboolean value,
                        GError **error);

Set a boolean feature value.

Parameters

camera

a ArvCamera

 

feature

feature name

 

value

new feature value

 

error

a GError placeholder, NULL to ingore

 

Since: 0.8.0


arv_camera_set_float ()

void
arv_camera_set_float (ArvCamera *camera,
                      const char *feature,
                      double value,
                      GError **error);

Set a float feature value.

Parameters

camera

a ArvCamera

 

feature

feature name

 

value

new feature value

 

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_set_integer ()

void
arv_camera_set_integer (ArvCamera *camera,
                        const char *feature,
                        gint64 value,
                        GError **error);

Set an integer feature value.

Parameters

camera

a ArvCamera

 

feature

feature name

 

value

new feature value

 

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_set_string ()

void
arv_camera_set_string (ArvCamera *camera,
                       const char *feature,
                       const char *value,
                       GError **error);

Set an string feature value.

Parameters

camera

a ArvCamera

 

feature

feature name

 

value

new feature value

 

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_set_range_check_policy ()

void
arv_camera_set_range_check_policy (ArvCamera *camera,
                                   ArvRangeCheckPolicy policy);

Sets the feature range check policy. When enabled, before being set, the value of all nodes with an ArvGcFloat or ArvGcInteger interface will be checked against their Min and Max properties.

Be aware that some camera may have wrong definition of Min and Max, as this check is defined as not mandatory in the Genicam specification. If this is the case, it will not possible to set the value of the features with faulty Min or Max definition. Range check is disabled by default.

Parameters

camera

a ArvCamera

 

policy

range check policy

 

Since: 0.8.8


arv_camera_set_register_cache_policy ()

void
arv_camera_set_register_cache_policy (ArvCamera *camera,
                                      ArvRegisterCachePolicy policy);

Sets the Genicam register cache policy.

Be aware that some camera may have wrong Cachable properties defined in their Genicam metadata, which may lead to incorrect readouts. Using the debug cache policy, and activating genicam debug output (export ARV_DEBUG=genicam), can help you to check the cache validity. In this mode, every time the cache content is not in sync with the actual register value, a debug message is printed on the console.

Parameters

camera

a ArvCamera

 

policy

cache policy

 

Since: 0.8.8


arv_camera_is_gv_device ()

gboolean
arv_camera_is_gv_device (ArvCamera *camera);

Parameters

camera

a ArvCamera

 

Returns

TRUE if camera is a GigEVision device.

Since: 0.4.0


arv_camera_gv_get_n_stream_channels ()

gint
arv_camera_gv_get_n_stream_channels (ArvCamera *camera,
                                     GError **error);

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ignore

 

Returns

the number of supported stream channels.

Since: 0.8.0


arv_camera_gv_select_stream_channel ()

void
arv_camera_gv_select_stream_channel (ArvCamera *camera,
                                     gint channel_id,
                                     GError **error);

Select the current stream channel. Negative channel_id is ignored.

Parameters

camera

a ArvCamera

 

channel_id

id of the channel to select

 

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_gv_get_current_stream_channel ()

int
arv_camera_gv_get_current_stream_channel
                               (ArvCamera *camera,
                                GError **error);

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ignore

 

Returns

The current stream channel id.

Since: 0.8.0


arv_camera_gv_get_packet_delay ()

gint64
arv_camera_gv_get_packet_delay (ArvCamera *camera,
                                GError **error);

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ignore

 

Returns

The inter packet delay, in nanoseconds.

Since: 0.8.0


arv_camera_gv_set_packet_delay ()

void
arv_camera_gv_set_packet_delay (ArvCamera *camera,
                                gint64 delay_ns,
                                GError **error);

Configure the inter packet delay to insert between each packet for the current stream channel. This can be used as a crude flow-control mechanism if the application or the network infrastructure cannot keep up with the packets coming from the device. Negative delay_ns is ignored.

Parameters

camera

a ArvCamera

 

delay_ns

inter packet delay, in nanoseconds

 

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_gv_get_packet_size ()

guint
arv_camera_gv_get_packet_size (ArvCamera *camera,
                               GError **error);

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ignore

 

Returns

The stream packet size, in bytes.

Since: 0.8.0


arv_camera_gv_set_packet_size ()

void
arv_camera_gv_set_packet_size (ArvCamera *camera,
                               gint packet_size,
                               GError **error);

Specifies the stream packet size, in bytes, to send on the selected channel for a GVSP transmitter or specifies the maximum packet size supported by a GVSP receiver.

This does not include data leader and data trailer and the last data packet which might be of smaller size (since packet size is not necessarily a multiple of block size for stream channel). Negative packet_size is ignored.

Parameters

camera

a ArvCamera

 

packet_size

packet size, in bytes

 

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_gv_auto_packet_size ()

guint
arv_camera_gv_auto_packet_size (ArvCamera *camera,
                                GError **error);

Automatically determine the biggest packet size that can be used data streaming, and set GevSCPSPacketSize value accordingly. This function relies on the GevSCPSFireTestPacket feature. If this feature is not available, the packet size will be set to a default value (1500 bytes).

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ignore

 

Returns

The packet size, in bytes.

Since: 0.8.0


arv_camera_gv_set_packet_size_adjustment ()

void
arv_camera_gv_set_packet_size_adjustment
                               (ArvCamera *camera,
                                ArvGvPacketSizeAdjustment adjustment);

Sets the option for packet size adjustment that happens at stream object creation.

Parameters

camera

a ArvCamera

 

adjustment

a ArvGvPacketSizeAdjustment option

 

Since: 0.8.3


arv_camera_gv_set_stream_options ()

void
arv_camera_gv_set_stream_options (ArvCamera *camera,
                                  ArvGvStreamOption options);

Sets the options used during stream object creation. These options mus be set before the call to arv_camera_create_stream().

Parameters

camera

a ArvCamera

 

options

option for stream creation

 

Since: 0.6.0


arv_camera_is_uv_device ()

gboolean
arv_camera_is_uv_device (ArvCamera *camera);

Parameters

camera

a ArvCamera

 

Returns

TRUE if camera is a USB3Vision device.

Since: 0.6.0


arv_camera_uv_set_usb_mode ()

void
arv_camera_uv_set_usb_mode (ArvCamera *camera,
                            ArvUvUsbMode usb_mode);

Parameters

camera

a ArvCamera

 

usb_mode

a ArvUvUsbMode option

 

Since: 0.8.17


arv_camera_uv_get_bandwidth ()

guint
arv_camera_uv_get_bandwidth (ArvCamera *camera,
                             GError **error);

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ignore

 

Returns

the current bandwidth limit

Since: 0.8.0


arv_camera_uv_get_bandwidth_bounds ()

void
arv_camera_uv_get_bandwidth_bounds (ArvCamera *camera,
                                    guint *min,
                                    guint *max,
                                    GError **error);

Parameters

camera

a ArvCamera

 

min

minimum bandwidth.

[out]

max

maximum bandwidth.

[out]

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_uv_is_bandwidth_control_available ()

gboolean
arv_camera_uv_is_bandwidth_control_available
                               (ArvCamera *camera,
                                GError **error);

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ignore

 

Returns

wether bandwidth limits are available on this camera

Since: 0.8.0


arv_camera_uv_set_bandwidth ()

void
arv_camera_uv_set_bandwidth (ArvCamera *camera,
                             guint bandwidth,
                             GError **error);

Set the bandwith limit or, if bandwith is not strictly positive, disable the limit.

Parameters

camera

a ArvCamera

 

bandwidth

Bandwith limit, in megabits/sec

 

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_are_chunks_available ()

gboolean
arv_camera_are_chunks_available (ArvCamera *camera,
                                 GError **error);

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ignore

 

Returns

TRUE if chunk data are available

Since: 0.8.8


arv_camera_get_chunk_mode ()

gboolean
arv_camera_get_chunk_mode (ArvCamera *camera,
                           GError **error);

Check wether chunk data mode is active. Please see arv_camera_set_chunk_mode().

Parameters

camera

a ArvCamera

 

error

a GError placeholder, NULL to ignore

 

Returns

TRUE if chunk data mode is active.

Since: 0.8.0


arv_camera_get_chunk_state ()

gboolean
arv_camera_get_chunk_state (ArvCamera *camera,
                            const char *chunk,
                            GError **error);

Gets state of chunk data. Chunk data are be embedded in ArvBuffer only if chunk mode is active. Please see arv_camera_set_chunk_mode().

Parameters

camera

a ArvCamera

 

chunk

chunk data name

 

error

a GError placeholder, NULL to ignore

 

Returns

TRUE if chunk is enabled.

Since: 0.8.0


arv_camera_set_chunk_mode ()

void
arv_camera_set_chunk_mode (ArvCamera *camera,
                           gboolean is_active,
                           GError **error);

Controls wether chunk data mode is active. When active, chunk data are appended to image data in ArvBuffer. A ArvChunkParser must be used in order to extract chunk data.

Parameters

camera

a ArvCamera

 

is_active

wether to enable chunk data mode

 

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_set_chunk_state ()

void
arv_camera_set_chunk_state (ArvCamera *camera,
                            const char *chunk,
                            gboolean is_enabled,
                            GError **error);

Sets state of a chunk data. Chunk data are be embedded in ArvBuffer only if chunk mode is active. Please see arv_camera_set_chunk_mode().

Parameters

camera

a ArvCamera

 

chunk

chunk data name

 

is_enabled

wether to enable this chunk

 

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_set_chunks ()

void
arv_camera_set_chunks (ArvCamera *camera,
                       const char *chunk_list,
                       GError **error);

Convenience function for enabling a set of chunk data. Chunk mode is activated, or deactivated if chunk_list is NULL or empty. All chunk data not listed are disabled.

Parameters

camera

a ArvCamera

 

chunk_list

chunk data names, as a comma or space separated list

 

error

a GError placeholder, NULL to ignore

 

Since: 0.8.0


arv_camera_create_chunk_parser ()

ArvChunkParser *
arv_camera_create_chunk_parser (ArvCamera *camera);

Creates a new ArvChunkParser object, used for the extraction of chunk data from ArvBuffer.

Parameters

camera

a ArvCamera

 

Returns

a new ArvChunkParser.

[transfer full]

Since: 0.4.0


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);

arv_exposure_mode_from_string ()

ArvExposureMode
arv_exposure_mode_from_string (const char *string);

arv_exposure_mode_to_string ()

const char *
arv_exposure_mode_to_string (ArvExposureMode value);

Types and Values

ARAVIS_VERSION

#define ARAVIS_VERSION "0.8.20"

The version of the Aravis library.

Since: 0.8.0


ARAVIS_API_VERSION

#define ARAVIS_API_VERSION "0.8"

The version of the Aravis library API.

Since: 0.8.20


ARAVIS_MAJOR_VERSION

#define ARAVIS_MAJOR_VERSION 0

The major version of the Aravis library.

Since: 0.6.0


ARAVIS_MICRO_VERSION

#define ARAVIS_MICRO_VERSION 20

The micor version of the Aravis library.

Since: 0.6.0


ARAVIS_MINOR_VERSION

#define ARAVIS_MINOR_VERSION 8

The minor version of the Aravis library.

Since: 0.6.0


ARAVIS_HAS_PACKET_SOCKET

#define ARAVIS_HAS_PACKET_SOCKET 1

ARAVIS_HAS_PACKET_SOCKET is defined as 1 if aravis is compiled with packet socket support, 0 if not.

Since: 0.6.0


ARAVIS_HAS_USB

#define ARAVIS_HAS_USB 1

ARAVIS_HAS_USB is defined as 1 if aravis is compiled with USB support, 0 if not.

Since: 0.6.0


ARAVIS_HAS_FAST_HEARTBEAT

#define ARAVIS_HAS_FAST_HEARTBEAT 0

ARAVIS_HAS_FAST_HEARTBEAT is defined as 1 if aravis is compiled with fast hearbeat option, 0 if not.

Since: 0.8.0


enum ArvAuto

Members

ARV_AUTO_OFF

manual setting

 

ARV_AUTO_ONCE

automatic setting done once, then returns to manual

 

ARV_AUTO_CONTINUOUS

setting is adjusted continuously

 

ArvCamera

typedef struct _ArvCamera ArvCamera;

enum ArvGvPacketSizeAdjustment

Members

ARV_GV_PACKET_SIZE_ADJUSTMENT_NEVER

never adjust packet size

 

ARV_GV_PACKET_SIZE_ADJUSTMENT_ON_FAILURE_ONCE

adjust packet size if test packet check fails the with current packet size, only on the first stream creation

 

ARV_GV_PACKET_SIZE_ADJUSTMENT_ON_FAILURE

adjust packet size if test packet check fails with current packet size

 

ARV_GV_PACKET_SIZE_ADJUSTMENT_ONCE

adjust packet size on the first stream creation

 

ARV_GV_PACKET_SIZE_ADJUSTMENT_ALWAYS

always adjust the stream packet size

 

ARV_GV_PACKET_SIZE_ADJUSTMENT_DEFAULT

default adjustment, which is ON_FAILURE_ONCE (Since 0.8.8)

 

enum ArvAcquisitionMode

Members

ARV_ACQUISITION_MODE_CONTINUOUS

frames are captured continuously until stopped with the AcquisitionStop command.

 

ARV_ACQUISITION_MODE_SINGLE_FRAME

only one frame will be acquired

 

ARV_ACQUISITION_MODE_MULTI_FRAME

the number of frames specified by AcquisitionFrameCount is captured.

 

enum ArvExposureMode

Members

ARV_EXPOSURE_MODE_OFF

disables the Exposure and let the shutter open.

 

ARV_EXPOSURE_MODE_TIMED

timed exposure. The exposure duration time is set using the ExposureTime or ExposureAuto features and the exposure starts with the FrameStart or LineStart.

 

ARV_EXPOSURE_MODE_TRIGGER_WIDTH

uses the width of the current Frame or Line trigger signal(s) pulse to control the exposure duration. Note that if the Frame or Line TriggerActivation is RisingEdge or LevelHigh, the exposure duration will be the time the trigger stays High. If TriggerActivation is FallingEdge or LevelLow, the exposure time will last as long as the trigger stays Low.

 

ARV_EXPOSURE_MODE_TRIGGER_CONTROLLED

uses one or more trigger signal(s) to control the exposure duration independently from the current Frame or Line triggers. See ExposureStart, ExposureEnd and ExposureActive of the TriggerSelector feature.

 

Property Details

The “device” property

  “device”                   ArvDevice *

Internal device object

Owner: ArvCamera

Flags: Read / Write / Construct Only

Stability Level: Private


The “name” property

  “name”                     char *

Internal device name for object construction

Owner: ArvCamera

Flags: Write / Construct Only

Default value: NULL

Stability Level: Private