Struct AudioBlockPlanarView 

pub struct AudioBlockPlanarView<'a, S, V>
where
    S: Sample,
    V: AsRef<[S]>,
{ /* private fields */ }

A read-only view of planar / separate-channel audio data.

• Layout: [[ch0, ch0, ch0], [ch1, ch1, ch1]]
• Interpretation: Each channel has its own separate buffer or array.
• Terminology: Also described as “planar” or “channels first” though more specifically it’s channel-isolated buffers.
• Usage: Very common in real-time DSP, as it simplifies memory access and can improve SIMD/vectorization efficiency.

Example

use audio_blocks::*;

let data = vec![[0.0, 0.0, 0.0], [1.0, 1.0, 1.0]];

let block = AudioBlockPlanarView::from_slice(&data);

assert_eq!(block.channel(0), &[0.0, 0.0, 0.0]);
assert_eq!(block.channel(1), &[1.0, 1.0, 1.0]);

Implementations

impl<'a, S, V> AudioBlockPlanarView<'a, S, V>

where S: Sample, V: AsRef<[S]>,

pub fn from_slice(data: &'a [V]) -> AudioBlockPlanarView<'a, S, V>

Creates a new audio block from a slice of planar audio data.

Parameters

• data - The slice containing planar audio samples (one slice per channel)

Panics

Panics if the channel slices have different lengths.

pub fn from_slice_limited( data: &'a [V], num_channels_visible: u16, num_frames_visible: usize, ) -> AudioBlockPlanarView<'a, S, V>

Creates a new audio block from a slice with limited visibility.

This function allows creating a view that exposes only a subset of the allocated channels and frames, which is useful for working with a logical section of a larger buffer.

Parameters

• data - The slice containing planar audio samples (one slice per channel)
• num_channels_visible - Number of audio channels to expose in the view
• num_frames_visible - Number of audio frames to expose in the view

Panics

• Panics if num_channels_visible exceeds the number of channels in data
• Panics if num_frames_visible exceeds the length of any channel buffer
• Panics if channel slices have different lengths

pub fn channel(&self, channel: u16) -> &[S]

Returns a slice for a single channel.

Panics

Panics if channel index is out of bounds.

pub fn channels(&self) -> impl Iterator<Item = &[S]>

Returns an iterator over all channels in the block.

Each channel is represented as a slice of samples.

pub fn raw_data(&self) -> &[V]

Provides direct mutable access to the underlying memory.

This function gives access to all allocated data, including any reserved capacity beyond the active range.

pub fn view(&self) -> AudioBlockPlanarView<'_, S, V>

Trait Implementations

impl<S, V> AudioBlock<S> for AudioBlockPlanarView<'_, S, V>

where S: Sample, V: AsRef<[S]>,

type PlanarView = V

fn num_channels(&self) -> u16

Returns the number of active audio channels.

fn num_frames(&self) -> usize

Returns the number of audio frames (samples per channel).

fn num_channels_allocated(&self) -> u16

Returns the total number of channels allocated in memory.

fn num_frames_allocated(&self) -> usize

Returns the total number of frames allocated in memory.

fn layout(&self) -> BlockLayout

Returns the memory layout of this audio block (interleaved, sequential, or planar).

fn sample(&self, channel: u16, frame: usize) -> S

Returns the sample value at the specified channel and frame position.

fn channel_iter(&self, channel: u16) -> impl Iterator<Item = &S>

Returns an iterator over all samples in the specified channel.

fn channels_iter(&self) -> impl Iterator<Item = impl Iterator<Item = &S>>

Returns an iterator that yields an iterator for each channel.

fn frame_iter(&self, frame: usize) -> impl Iterator<Item = &S>

Returns an iterator over all samples in the specified frame (across all channels).

fn frame_iters(&self) -> impl Iterator<Item = impl Iterator<Item = &S>>

Returns an iterator that yields an iterator for each frame.

fn as_view(&self) -> impl AudioBlock<S>

Creates a non-owning view of this audio block.

fn as_planar_view( &self, ) -> Option<AudioBlockPlanarView<'_, S, <AudioBlockPlanarView<'_, S, V> as AudioBlock<S>>::PlanarView>>

Attempts to downcast this generic audio block to a concrete planar view. This enables access to frame slices and the underlying raw data.

fn as_interleaved_view(&self) -> Option<AudioBlockInterleavedView<'_, S>>

Attempts to downcast this generic audio block to a concrete interleaved view. This enables access to frame slices and the underlying raw data.

fn as_sequential_view(&self) -> Option<AudioBlockSequentialView<'_, S>>

Attempts to downcast this generic audio block to a concrete sequential view. This enables access to frame slices and the underlying raw data.

impl<S, V> Debug for AudioBlockPlanarView<'_, S, V>

where S: Sample + Debug, V: AsRef<[S]> + Debug,

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

Formats the value using the given formatter.