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)¶
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_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.