TcamProp

This page describes the official gobject-introspection API.

Note

The current version of this API is 0.1

Base Object

All tiscamera gstreamer elements implement the TcamProp interface. This interface allows access to all properties that the camera and software offer, as well as possibilities for device discovery.

TcamProp

This object is typically a converted gstreamer element like tcambin or tcamautoexposure.

Device Discovery

The following functions can be used for device discovery. Only tcamsrc and tcambin implement these.

GSList* tcam_prop_get_device_serials(TcamProp* self)

@self: a #TcamProp

Retrieve a list of all connected device serial numbers

Returns: (element-type utf8) (transfer full): a #GSList

GSList* tcam_prop_get_device_serials (TcamProp* self)

gboolean tcam_prop_get_device_info(TcamProp* self, const char* serial, char** name, char** identifier, char** connection_type)

@self: a #TcamProp @serial: (in): serial number of camera to query @name: (out) (optional): location to store an allocated string. Use g_free() to free the returned string @identifier: (out) (optional): location to store an allocated string. Use g_free() to free the returned string @connection_type: (out) (optional): location to store an allocated string. Use g_free() to free the returned string

Get details of a given camera.

Returns: True on success

Property I/O

GSList* tcam_prop_get_tcam_property_names(TcamProp* self)

Arguments

self - Pointer to the TcamProp instance that shall be used.

Returns

Pointer to a GSList containing all property names the TcamProp object offers.

gboolean tcam_prop_get_tcam_property(TcamProp* self, const gchar* name, GValue* value, GValue* min, GValue* max, GValue* def, GValue* step, GValue* type, GValue* flags, GValue* category, GValue* group)

Arguments

Name

Type

Description

In/Out

Optional

self

TcamProp

In

No

name

const char*

identifying the property to query

In

No

value

GValue*

Out

Yes

min

GValue*

Out

Yes

max

GValue*

Out

Yes

def

GValue*

Out

Yes

step

GValue*

Out

Yes

type

GValue*

Out

Yes

flags

GValue*

Out

Yes

category

GValue*

Out

Yes

group

GValue*

Out

Yes

Returns

A gboolean. TRUE if query could be answered and values filled.

const gchar* tcam_prop_get_tcam_property_type (TcamProp* self, const gchar* name)

self: TcamProp*

Pointer to TcamProp instance that shall be queried.

name: const gchar*

Name of the property for which the property type shall be returned.

Returns

A pointer to a c-string containing the type of the requested property. Returns NULL when property does not exist.

tcam_prop_get_tcam_menu_entries

self: TcamProp*

Pointer to TcamProp instance that shall be queried.

name: const gchar*

Name of the property for which the menu entries shall be returned.

Returns:

A pointer to a GSList containing the c-strings of all entries.

tcam_prop_set_tcam_property

self: TcamProp*

Pointer to TcamProp instance that shall be queried.

name: const gchar*

Name of the property for which the property type shall be returned.

value: const GValue*

value that shall be set.

Returns

Pointer to a GSList containing all property names the TcamProp object offers.