/* GStreamer * Copyright (C) <1999> Erik Walthinsen * Library <2001> Thomas Vander Stichele * <2011> Wim Taymans * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Library General Public * License as published by the Free Software Foundation; either * version 2 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Library General Public License for more details. * * You should have received a copy of the GNU Library General Public * License along with this library; if not, write to the * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, * Boston, MA 02110-1301, USA. */ #ifndef __GST_AUDIO_AUDIO_H__ #include #endif #ifndef __GST_AUDIO_CHANNELS_H__ #define __GST_AUDIO_CHANNELS_H__ G_BEGIN_DECLS /** * GstAudioChannelPosition: * @GST_AUDIO_CHANNEL_POSITION_MONO: Mono without direction; * can only be used with 1 channel * @GST_AUDIO_CHANNEL_POSITION_FRONT_LEFT: Front left * @GST_AUDIO_CHANNEL_POSITION_FRONT_RIGHT: Front right * @GST_AUDIO_CHANNEL_POSITION_FRONT_CENTER: Front center * @GST_AUDIO_CHANNEL_POSITION_LFE1: Low-frequency effects 1 (subwoofer) * @GST_AUDIO_CHANNEL_POSITION_REAR_LEFT: Rear left * @GST_AUDIO_CHANNEL_POSITION_REAR_RIGHT: Rear right * @GST_AUDIO_CHANNEL_POSITION_FRONT_LEFT_OF_CENTER: Front left of center * @GST_AUDIO_CHANNEL_POSITION_FRONT_RIGHT_OF_CENTER: Front right of center * @GST_AUDIO_CHANNEL_POSITION_REAR_CENTER: Rear center * @GST_AUDIO_CHANNEL_POSITION_LFE2: Low-frequency effects 2 (subwoofer) * @GST_AUDIO_CHANNEL_POSITION_SIDE_LEFT: Side left * @GST_AUDIO_CHANNEL_POSITION_SIDE_RIGHT: Side right * @GST_AUDIO_CHANNEL_POSITION_TOP_FRONT_LEFT: Top front left * @GST_AUDIO_CHANNEL_POSITION_TOP_FRONT_RIGHT: Top front right * @GST_AUDIO_CHANNEL_POSITION_TOP_FRONT_CENTER: Top front center * @GST_AUDIO_CHANNEL_POSITION_TOP_CENTER: Top center * @GST_AUDIO_CHANNEL_POSITION_TOP_REAR_LEFT: Top rear left * @GST_AUDIO_CHANNEL_POSITION_TOP_REAR_RIGHT: Top rear right * @GST_AUDIO_CHANNEL_POSITION_TOP_SIDE_LEFT: Top side right * @GST_AUDIO_CHANNEL_POSITION_TOP_SIDE_RIGHT: Top rear right * @GST_AUDIO_CHANNEL_POSITION_TOP_REAR_CENTER: Top rear center * @GST_AUDIO_CHANNEL_POSITION_BOTTOM_FRONT_CENTER: Bottom front center * @GST_AUDIO_CHANNEL_POSITION_BOTTOM_FRONT_LEFT: Bottom front left * @GST_AUDIO_CHANNEL_POSITION_BOTTOM_FRONT_RIGHT: Bottom front right * @GST_AUDIO_CHANNEL_POSITION_WIDE_LEFT: Wide left (between front left and side left) * @GST_AUDIO_CHANNEL_POSITION_WIDE_RIGHT: Wide right (between front right and side right) * @GST_AUDIO_CHANNEL_POSITION_SURROUND_LEFT: Surround left (between rear left and side left) * @GST_AUDIO_CHANNEL_POSITION_SURROUND_RIGHT: Surround right (between rear right and side right) * @GST_AUDIO_CHANNEL_POSITION_NONE: used for position-less channels, e.g. * from a sound card that records 1024 channels; mutually exclusive with * any other channel position * @GST_AUDIO_CHANNEL_POSITION_INVALID: invalid position * * Audio channel positions. * * These are the channels defined in SMPTE 2036-2-2008 * Table 1 for 22.2 audio systems with the Surround and Wide channels from * DTS Coherent Acoustics (v.1.3.1) and 10.2 and 7.1 layouts. In the caps the * actual channel layout is expressed with a channel count and a channel mask, * which describes the existing channels. The positions in the bit mask correspond * to the enum values. * For negotiation it is allowed to have more bits set in the channel mask than * the number of channels to specify the allowed channel positions but this is * not allowed in negotiated caps. It is not allowed in any situation other * than the one mentioned below to have less bits set in the channel mask than * the number of channels. * * @GST_AUDIO_CHANNEL_POSITION_MONO can only be used with a single mono channel that * has no direction information and would be mixed into all directional channels. * This is expressed in caps by having a single channel and no channel mask. * * @GST_AUDIO_CHANNEL_POSITION_NONE can only be used if all channels have this position. * This is expressed in caps by having a channel mask with no bits set. * * As another special case it is allowed to have two channels without a channel mask. * This implicitely means that this is a stereo stream with a front left and front right * channel. */ typedef enum { /* These get negative indices to allow to use * the enum values of the normal cases for the * bit-mask position */ GST_AUDIO_CHANNEL_POSITION_NONE = -3, GST_AUDIO_CHANNEL_POSITION_MONO = -2, GST_AUDIO_CHANNEL_POSITION_INVALID = -1, /* Normal cases */ GST_AUDIO_CHANNEL_POSITION_FRONT_LEFT = 0, GST_AUDIO_CHANNEL_POSITION_FRONT_RIGHT, GST_AUDIO_CHANNEL_POSITION_FRONT_CENTER, GST_AUDIO_CHANNEL_POSITION_LFE1, GST_AUDIO_CHANNEL_POSITION_REAR_LEFT, GST_AUDIO_CHANNEL_POSITION_REAR_RIGHT, GST_AUDIO_CHANNEL_POSITION_FRONT_LEFT_OF_CENTER, GST_AUDIO_CHANNEL_POSITION_FRONT_RIGHT_OF_CENTER, GST_AUDIO_CHANNEL_POSITION_REAR_CENTER, GST_AUDIO_CHANNEL_POSITION_LFE2, GST_AUDIO_CHANNEL_POSITION_SIDE_LEFT, GST_AUDIO_CHANNEL_POSITION_SIDE_RIGHT, GST_AUDIO_CHANNEL_POSITION_TOP_FRONT_LEFT, GST_AUDIO_CHANNEL_POSITION_TOP_FRONT_RIGHT, GST_AUDIO_CHANNEL_POSITION_TOP_FRONT_CENTER, GST_AUDIO_CHANNEL_POSITION_TOP_CENTER, GST_AUDIO_CHANNEL_POSITION_TOP_REAR_LEFT, GST_AUDIO_CHANNEL_POSITION_TOP_REAR_RIGHT, GST_AUDIO_CHANNEL_POSITION_TOP_SIDE_LEFT, GST_AUDIO_CHANNEL_POSITION_TOP_SIDE_RIGHT, GST_AUDIO_CHANNEL_POSITION_TOP_REAR_CENTER, GST_AUDIO_CHANNEL_POSITION_BOTTOM_FRONT_CENTER, GST_AUDIO_CHANNEL_POSITION_BOTTOM_FRONT_LEFT, GST_AUDIO_CHANNEL_POSITION_BOTTOM_FRONT_RIGHT, GST_AUDIO_CHANNEL_POSITION_WIDE_LEFT, GST_AUDIO_CHANNEL_POSITION_WIDE_RIGHT, GST_AUDIO_CHANNEL_POSITION_SURROUND_LEFT, GST_AUDIO_CHANNEL_POSITION_SURROUND_RIGHT } GstAudioChannelPosition; #define GST_AUDIO_CHANNEL_POSITION_MASK(pos) (G_GUINT64_CONSTANT(1)<< GST_AUDIO_CHANNEL_POSITION_ ## pos) GST_AUDIO_API gboolean gst_audio_buffer_reorder_channels (GstBuffer * buffer, GstAudioFormat format, gint channels, const GstAudioChannelPosition * from, const GstAudioChannelPosition * to); GST_AUDIO_API gboolean gst_audio_reorder_channels (gpointer data, gsize size, GstAudioFormat format, gint channels, const GstAudioChannelPosition * from, const GstAudioChannelPosition * to); GST_AUDIO_API gboolean gst_audio_channel_positions_to_valid_order (GstAudioChannelPosition *position, gint channels); GST_AUDIO_API gboolean gst_audio_check_valid_channel_positions (const GstAudioChannelPosition *position, gint channels, gboolean force_order); GST_AUDIO_API gboolean gst_audio_channel_positions_to_mask (const GstAudioChannelPosition *position, gint channels, gboolean force_order, guint64 *channel_mask); GST_AUDIO_API gboolean gst_audio_channel_positions_from_mask (gint channels, guint64 channel_mask, GstAudioChannelPosition * position); GST_AUDIO_API gboolean gst_audio_get_channel_reorder_map (gint channels, const GstAudioChannelPosition * from, const GstAudioChannelPosition * to, gint *reorder_map); GST_AUDIO_API guint64 gst_audio_channel_get_fallback_mask (gint channels); GST_AUDIO_API gchar* gst_audio_channel_positions_to_string (const GstAudioChannelPosition * position, gint channels); G_END_DECLS #endif /* __GST_AUDIO_CHANNELS_H__ */