Enumeration (GI Enum)

GstAudio-1.0GstAudioAudioChannelPosition

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.

Index
BOTTOM_FRONT_CENTER: 21

Bottom front center

BOTTOM_FRONT_LEFT: 22

Bottom front left

BOTTOM_FRONT_RIGHT: 23

Bottom front right

FRONT_CENTER: 2

Front center

FRONT_LEFT: 0

Front left

FRONT_LEFT_OF_CENTER: 6

Front left of center

FRONT_RIGHT: 1

Front right

FRONT_RIGHT_OF_CENTER: 7

Front right of center

INVALID: -1

invalid position

LFE1: 3

Low-frequency effects 1 (subwoofer)

LFE2: 9

Low-frequency effects 2 (subwoofer)

MONO: -2

Mono without direction; can only be used with 1 channel

NONE: -3

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

REAR_CENTER: 8

Rear center

REAR_LEFT: 4

Rear left

REAR_RIGHT: 5

Rear right

SIDE_LEFT: 10

Side left

SIDE_RIGHT: 11

Side right

SURROUND_LEFT: 26

Surround left (between rear left and side left)

SURROUND_RIGHT: 27

Surround right (between rear right and side right)

TOP_CENTER: 15

Top center

TOP_FRONT_CENTER: 14

Top front center

TOP_FRONT_LEFT: 12

Top front left

TOP_FRONT_RIGHT: 13

Top front right

TOP_REAR_CENTER: 20

Top rear center

TOP_REAR_LEFT: 16

Top rear left

TOP_REAR_RIGHT: 17

Top rear right

TOP_SIDE_LEFT: 18

Top side right

TOP_SIDE_RIGHT: 19

Top rear right

TOP_SURROUND_LEFT: 28

Top surround left (between rear left and side left).

1.26

TOP_SURROUND_RIGHT: 29

Top surround right (between rear right and side right).

1.26

WIDE_LEFT: 24

Wide left (between front left and side left)

WIDE_RIGHT: 25

Wide right (between front right and side right)

Variables

$gtype