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

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

GSList* tcam_prop_get_device_serials_backend(TcamProp* self)

@self: a #TcamProp

Retrieve a list of all connected device serial numbers with the backend appended

Retrieved serials may appear multiple times but with different backends. The format will always be <serial>-<backend>

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

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.