GstBtPropertyMeta

GstBtPropertyMeta — helper interface for extended gstreamer element meta data

Synopsis

enum                GstBtPropertyMetaFlags;
gchar *             gstbt_property_meta_describe_property
                                                        (GstBtPropertyMeta *self,
                                                         glong index,
                                                         GValue *value);
extern GQuark       gstbt_property_meta_quark;
extern GQuark       gstbt_property_meta_quark_min_val;
extern GQuark       gstbt_property_meta_quark_max_val;
extern GQuark       gstbt_property_meta_quark_def_val;
extern GQuark       gstbt_property_meta_quark_no_val;
extern GQuark       gstbt_property_meta_quark_flags;

Description

This interface standardises some additional meta-data that is attached to GObject properties.

Furthermore it adds the gstbt_property_meta_describe_property() method that builds a string description of a property value.

Details

enum GstBtPropertyMetaFlags

typedef enum {
  GSTBT_PROPERTY_META_NONE=0,
  GSTBT_PROPERTY_META_WAVE=1,		/* parameter value references a wavetable slot */
  GSTBT_PROPERTY_META_STATE=2,		/* parameter is continuously changing (not used for notes and triggers) */
  GSTBT_PROPERTY_META_TICK_ON_EDIT=4 /* causes the host to send you a Tick() message immediatly after the user enters a value in the pattern or machine editor */
} GstBtPropertyMetaFlags;

Parameter flags to describe their behaviour.

GSTBT_PROPERTY_META_NONE

no special treatment needed

GSTBT_PROPERTY_META_WAVE

parameter value references a wavetable slot

GSTBT_PROPERTY_META_STATE

parameter is continuously changing (not used for notes and triggers)

GSTBT_PROPERTY_META_TICK_ON_EDIT

need to call tick after editing it

gstbt_property_meta_describe_property ()

gchar *             gstbt_property_meta_describe_property
                                                        (GstBtPropertyMeta *self,
                                                         glong index,
                                                         GValue *value);

Formats the gives value as a human readable string. The method is useful to display a property value in a user interface. It privides a default implementation.

self :

a GObject that implements GstBtPropertyMeta

index :

the property index

value :

the current property value

Returns :

a string with the value in humand readable form, free memory when done

gstbt_property_meta_quark

extern GQuark gstbt_property_meta_quark;

Only if this is set to TRUE, there is property meta data for this property..


gstbt_property_meta_quark_min_val

extern GQuark gstbt_property_meta_quark_min_val;

Minimum property value (excluding default and no-value).


gstbt_property_meta_quark_max_val

extern GQuark gstbt_property_meta_quark_max_val;

Maximum property value (excluding default and no-value).


gstbt_property_meta_quark_def_val

extern GQuark gstbt_property_meta_quark_def_val;

Default property value (used initialy).


gstbt_property_meta_quark_no_val

extern GQuark gstbt_property_meta_quark_no_val;

Property value (used in trigger style properties, when there is no current value)


gstbt_property_meta_quark_flags

extern GQuark gstbt_property_meta_quark_flags;

Application specific flags giving more hints about the property.