Enum ChannelPosition 

#[non_exhaustive]
pub enum ChannelPosition {
    FrontLeft,
    FrontRight,
    FrontCenter,
    LowFrequency,
    BackLeft,
    BackRight,
    FrontLeftOfCenter,
    FrontRightOfCenter,
    BackCenter,
    SideLeft,
    SideRight,
    TopFrontLeft,
    TopFrontRight,
    TopBackLeft,
    TopBackRight,
}

A single speaker position within a multi-channel audio layout.

Names follow the WAVEFORMATEXTENSIBLE / FFmpeg / SMPTE convention. Side* and Back* are kept distinct (mirroring 7.1’s L/R + Ls/Rs + Lb/Rb separation) so codecs that surface the distinction don’t collapse it. Lr/Rr (rear / back-rear) are aliases for BackLeft/BackRight in this taxonomy — the rear pair sits behind the listener on the room’s centreline-extension, the side pair is at roughly ±90° from front. The enum is #[non_exhaustive] so additional positions (height channels for Atmos / Auro-3D, etc.) can be added without breaking downstream match arms.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

FrontLeft

Front-left (L). 30° left of centre in BS.775 listening geometry.

FrontRight

Front-right (R). 30° right of centre.

FrontCenter

Front-centre (C). Direct centre, 0°.

LowFrequency

Low-frequency effects (LFE). Sub-bass, no positional meaning.

BackLeft

Back-left (Lb / Lr). Behind the listener, ±150° in 7.1.

BackRight

Back-right (Rb / Rr). Behind the listener, mirror of BackLeft.

FrontLeftOfCenter

Front left-of-centre (Lc). Used in cinema 7.1 SDDS layouts.

FrontRightOfCenter

Front right-of-centre (Rc). Mirror of FrontLeftOfCenter.

BackCenter

Back-centre (Cs). Single rear channel for 6.1 / BS.775 4.0.

SideLeft

Side-left (Ls). ±90° on the listener’s left in 5.1 / 7.1.

SideRight

Side-right (Rs). Mirror of SideLeft.

TopFrontLeft

Top front-left. Atmos / Auro-3D height layer (placeholder).

TopFrontRight

Top front-right. Atmos / Auro-3D height layer (placeholder).

TopBackLeft

Top back-left. Atmos / Auro-3D ceiling layer (placeholder).

TopBackRight

Top back-right. Atmos / Auro-3D ceiling layer (placeholder).

Trait Implementations

impl Clone for ChannelPosition

fn clone(&self) -> ChannelPosition

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ChannelPosition

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Hash for ChannelPosition

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ChannelPosition

fn eq(&self, other: &ChannelPosition) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for ChannelPosition

impl Eq for ChannelPosition

impl StructuralPartialEq for ChannelPosition