Struct FieldSoaColumn 

pub struct FieldSoaColumn<T: SoaLayout> { /* private fields */ }

A field-split component column: one contiguous Vec<f32> per component field.

Stored behind Box<dyn AnyVec> exactly like an AoS Vec<T> column, so it participates in the normal page lifecycle (spawn / despawn / migration / serialization). Access is by value (get) or in bulk through the per-field field slices for SIMD kernels.

Implementations

impl<T: SoaLayout> FieldSoaColumn<T>

pub fn new() -> Self

Creates an empty column with one field array per component field.

pub fn len(&self) -> usize

The number of rows (entities) stored.

pub fn is_empty(&self) -> bool

Whether the column holds no rows.

pub fn push(&mut self, value: T)

Appends a value as a new row.

pub fn get(&self, row: usize) -> T

Reconstructs the value stored at row.

Panics

Panics if row >= len().

pub fn set(&mut self, row: usize, value: T)

Overwrites the value at row.

Panics

Panics if row >= len().

pub fn field(&self, field: usize) -> &[f32]

Read-only access to one field’s array (field < FIELD_COUNT) — the contiguous f32 stream a SIMD kernel tiles over.

pub fn field_mut(&mut self, field: usize) -> &mut [f32]

Mutable access to one field’s array.

pub fn fields(&self) -> &[Vec<f32>]

All field arrays (read-only).

pub fn fields_mut(&mut self) -> &mut [Vec<f32>]

All field arrays (mutable) — for a kernel that writes several fields.

Trait Implementations

impl<T: SoaLayout> AnyVec for FieldSoaColumn<T>

fn as_any(&self) -> &dyn Any

Casts the trait object to &dyn Any.

fn as_any_mut(&mut self) -> &mut dyn Any

Casts the trait object to &mut dyn Any.

fn swap_remove_any(&mut self, index: usize)

Performs a swap_remove on the underlying column, removing the element at index.

fn to_bytes(&self) -> Vec<u8>

Serialises the column to an owned byte buffer.

unsafe fn set_from_bytes( &mut self, bytes: &[u8], ) -> Result<(), SetFromBytesError>

Replaces the column contents from bytes previously produced by to_bytes on the same column type.

impl<T: Debug + SoaLayout> Debug for FieldSoaColumn<T>

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

Formats the value using the given formatter.

impl<T: SoaLayout> Default for FieldSoaColumn<T>

fn default() -> Self

Returns the “default value” for a type.