GstAudioChannelPosition

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 implicitly means that this is a stereo stream with a front left and front right channel.

Values

ValueMeaning
None-3

used for position-less channels, e.g. from a sound card that records 1024 channels; mutually exclusive with any other channel position

Mono-2

Mono without direction; can only be used with 1 channel

Invalid-1

invalid position

FrontLeft0

Front left

FrontRight1

Front right

FrontCenter2

Front center

Lfe13

Low-frequency effects 1 (subwoofer)

RearLeft4

Rear left

RearRight5

Rear right

FrontLeftOfCenter6

Front left of center

FrontRightOfCenter7

Front right of center

RearCenter8

Rear center

Lfe29

Low-frequency effects 2 (subwoofer)

SideLeft10

Side left

SideRight11

Side right

TopFrontLeft12

Top front left

TopFrontRight13

Top front right

TopFrontCenter14

Top front center

TopCenter15

Top center

TopRearLeft16

Top rear left

TopRearRight17

Top rear right

TopSideLeft18

Top side right

TopSideRight19

Top rear right

TopRearCenter20

Top rear center

BottomFrontCenter21

Bottom front center

BottomFrontLeft22

Bottom front left

BottomFrontRight23

Bottom front right

WideLeft24

Wide left (between front left and side left)

WideRight25

Wide right (between front right and side right)

SurroundLeft26

Surround left (between rear left and side left)

SurroundRight27

Surround right (between rear right and side right)