enum GstAudioChannelPosition

typedef enum {
  GST_AUDIO_CHANNEL_POSITION_INVALID = -1,

  /* Main front speakers. Mono and left/right are mututally exclusive! */
  GST_AUDIO_CHANNEL_POSITION_FRONT_MONO,
  GST_AUDIO_CHANNEL_POSITION_FRONT_LEFT,
  GST_AUDIO_CHANNEL_POSITION_FRONT_RIGHT,

  /* rear. Left/right and center are mututally exclusive! */
  GST_AUDIO_CHANNEL_POSITION_REAR_CENTER,
  GST_AUDIO_CHANNEL_POSITION_REAR_LEFT,
  GST_AUDIO_CHANNEL_POSITION_REAR_RIGHT,

  /* subwoofer/low-frequency */
  GST_AUDIO_CHANNEL_POSITION_LFE,

  /* Center front speakers. Center and left/right_of_center cannot be
   * used together! */
  GST_AUDIO_CHANNEL_POSITION_FRONT_CENTER,
  GST_AUDIO_CHANNEL_POSITION_FRONT_LEFT_OF_CENTER,
  GST_AUDIO_CHANNEL_POSITION_FRONT_RIGHT_OF_CENTER,

  /* sides */
  GST_AUDIO_CHANNEL_POSITION_SIDE_LEFT,
  GST_AUDIO_CHANNEL_POSITION_SIDE_RIGHT,

  /* for multi-channel input and output with more than 8 channels,
   * incompatible with all other positions, either all positions
   * are defined or all positions are undefined, but can't mix'n'match  */
  GST_AUDIO_CHANNEL_POSITION_NONE,

  /* don't use - counter */
  GST_AUDIO_CHANNEL_POSITION_NUM
} GstAudioChannelPosition;

gst_audio_fixate_channel_positions ()

GstAudioChannelPosition* gst_audio_fixate_channel_positions
                                                        (GstStructure *str);

Custom fixate function. Elements that implement some sort of channel conversion algorithm should use this function for fixating on GstAudioChannelPosition properties. It will take care of equal channel positioning (left/right). Caller g_free()s the return value. The input properties may be (and are supposed to be) unfixed. Note that this function is mostly a hack because we currently have no way to add default fixation functions for new GTypes.

gst_audio_get_channel_positions ()

GstAudioChannelPosition* gst_audio_get_channel_positions
                                                        (GstStructure *str);

Retrieves a number of (fixed!) audio channel positions from the provided GstStructure and returns it as a newly allocated array. The caller should g_free() this array. The caller should also check that the members in this GstStructure are indeed "fixed" before calling this function.

gst_audio_set_caps_channel_positions_list ()

void                gst_audio_set_caps_channel_positions_list
                                                        (GstCaps *caps,
                                                         const GstAudioChannelPosition *pos,
                                                         gint num_positions);

Sets a (possibly non-fixed) list of possible audio channel positions (given in pos) on the given caps. Each of the structures of the caps, after this function has been called, will contain a "channel-positions" field with an array. Each value in the array will contain each of the values given in the pos array. Note that the size of the caps might be increased by this, since each structure with a "channel- positions" field needs to have a fixed "channels" field. The input caps is not required to have this.

gst_audio_set_channel_positions ()

void                gst_audio_set_channel_positions     (GstStructure *str,
                                                         const GstAudioChannelPosition *pos);

Adds a "channel-positions" field to the given GstStructure, which will represent the channel positions as given in the provided GstAudioChannelPosition array.

gst_audio_set_structure_channel_positions_list ()

void                gst_audio_set_structure_channel_positions_list
                                                        (GstStructure *str,
                                                         const GstAudioChannelPosition *pos,
                                                         gint num_positions);

Sets a (possibly non-fixed) list of possible audio channel positions (given in pos) on the given structure. The structure, after this function has been called, will contain a "channel-positions" field with an array of the size of the "channels" field value in the given structure (note that this means that the channels field in the provided structure should be fixed!). Each value in the array will contain each of the values given in the pos array.

gst_audio_check_channel_positions ()

gboolean            gst_audio_check_channel_positions   (const GstAudioChannelPosition *pos,
                                                         guint channels);

This functions checks if the given channel positions are valid. Channel positions are valid if:

Since 0.10.20