GstParamSpec

GstParamSpec — GParamSpec implementations specific to GStreamer

Synopsis


#include <gst/gst.h>

#define             GST_PARAM_CONTROLLABLE
#define             GST_PARAM_USER_SHIFT
#define             GST_PARAM_MUTABLE_PAUSED
#define             GST_PARAM_MUTABLE_PLAYING
#define             GST_PARAM_MUTABLE_READY

                    GstParamSpecFraction;
GParamSpec*         gst_param_spec_fraction             (const gchar *name,
                                                         const gchar *nick,
                                                         const gchar *blurb,
                                                         gint min_num,
                                                         gint min_denom,
                                                         gint max_num,
                                                         gint max_denom,
                                                         gint default_num,
                                                         gint default_denom,
                                                         GParamFlags flags);

Description

GParamSpec implementations specific to GStreamer.

Last reviewed on 2008-03-11 (0.10.18)

Details

GST_PARAM_CONTROLLABLE

#define	GST_PARAM_CONTROLLABLE	(1 << (G_PARAM_USER_SHIFT + 1))

Use this flag on GObject properties to signal they can make sense to be. controlled over time. This hint is used by the GstController.


GST_PARAM_USER_SHIFT

#define	GST_PARAM_USER_SHIFT	(1 << (G_PARAM_USER_SHIFT + 8))

Bits based on GST_PARAM_USER_SHIFT can be used by 3rd party applications.


GST_PARAM_MUTABLE_PAUSED

#define GST_PARAM_MUTABLE_PAUSED  (1 << (G_PARAM_USER_SHIFT + 3))

Use this flag on GObject properties of GstElements to indicate that they can be changed when the element is in the PAUSED or lower state. This flag implies GST_PARAM_MUTABLE_READY.

Since 0.10.23


GST_PARAM_MUTABLE_PLAYING

#define GST_PARAM_MUTABLE_PLAYING  (1 << (G_PARAM_USER_SHIFT + 4))

Use this flag on GObject properties of GstElements to indicate that they can be changed when the element is in the PLAYING or lower state. This flag implies GST_PARAM_MUTABLE_PAUSED.

Since 0.10.23


GST_PARAM_MUTABLE_READY

#define GST_PARAM_MUTABLE_READY  (1 << (G_PARAM_USER_SHIFT + 2))

Use this flag on GObject properties of GstElements to indicate that they can be changed when the element is in the READY or lower state.

Since 0.10.23


GstParamSpecFraction

typedef struct {
  GParamSpec    parent_instance;
  
  gint          min_num, min_den;
  gint          max_num, max_den;
  gint          def_num, def_den;
} GstParamSpecFraction;

A GParamSpec derived structure that contains the meta data for fractional properties.

GParamSpec parent_instance; super class
gint min_num; minimal numerator
gint min_den; minimal denominator
gint max_num; maximal numerator
gint max_den; maximal denominator
gint def_num; default numerator
gint def_den; default denominator

gst_param_spec_fraction ()

GParamSpec*         gst_param_spec_fraction             (const gchar *name,
                                                         const gchar *nick,
                                                         const gchar *blurb,
                                                         gint min_num,
                                                         gint min_denom,
                                                         gint max_num,
                                                         gint max_denom,
                                                         gint default_num,
                                                         gint default_denom,
                                                         GParamFlags flags);

This function creates a fraction GParamSpec for use by objects/elements that want to expose properties of fraction type. This function is typically used in connection with g_object_class_install_property() in a GObjects's instance_init function.

name : canonical name of the property specified
nick : nick name for the property specified
blurb : description of the property specified
min_num : minimum value (fraction numerator)
min_denom : minimum value (fraction denominator)
max_num : maximum value (fraction numerator)
max_denom : maximum value (fraction denominator)
default_num : default value (fraction numerator)
default_denom : default value (fraction denominator)
flags : flags for the property specified
Returns : a newly created parameter specification

Since 0.10.14