Struct DataLayer 

pub struct DataLayer {
    data: Option<Box<[u8; 2048]>>,
    default_value: u8,
}

Packed 4-bit light values for one 16x16x16 light section.

This mirrors vanilla’s DataLayer: values are indexed as y << 8 | z << 4 | x, with two light nibbles packed into each byte. A homogeneous layer stores only a default value until bytes are needed.

Fields

data: Option<Box<[u8; 2048]>>

default_value: u8

Implementations

impl DataLayer

pub const fn new() -> Self

Creates an empty all-zero layer.

pub const fn filled(value: u8) -> Self

Creates a homogeneous layer filled with value.

pub fn from_bytes(bytes: Box<[u8]>) -> Result<Self, DataLayerLengthError>

Creates a layer from packed vanilla bytes.

pub(crate) const fn from_packed_data(data: Box<[u8; 2048]>) -> Self

Creates a layer from already length-checked packed vanilla bytes.

pub fn get(&self, x: usize, y: usize, z: usize) -> u8

Returns the light value at local section coordinates.

pub fn set(&mut self, x: usize, y: usize, z: usize, value: u8)

Sets the light value at local section coordinates.

pub fn fill(&mut self, value: u8)

Fills the layer with one homogeneous value.

pub const fn is_homogeneous(&self) -> bool

Returns true when the layer is represented by one homogeneous value.

pub const fn homogeneous_value(&self) -> Option<u8>

Returns the homogeneous value when no packed data exists.

pub const fn is_filled_with(&self, value: u8) -> bool

Returns true when the layer is known to be filled with value.

pub const fn is_empty(&self) -> bool

Returns true when this layer is an all-zero homogeneous layer.

pub fn is_all_zero(&self) -> bool

Returns true when all packed values are zero.

pub fn copy(&self) -> Self

Returns a deep copy of this layer.

pub fn to_bytes(&self) -> Box<[u8; 2048]>

Returns packed bytes without changing the layer representation.

fn get_at_index(&self, index: usize) -> u8

fn set_at_index(&mut self, index: usize, value: u8)

const fn index(x: usize, y: usize, z: usize) -> usize

const fn byte_index(index: usize) -> usize

const fn nibble_index(index: usize) -> usize

const fn pack_filled(value: u8) -> u8

Trait Implementations

impl Clone for DataLayer

fn clone(&self) -> DataLayer

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DataLayer

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

Formats the value using the given formatter.

impl Default for DataLayer

fn default() -> Self

Returns the “default value” for a type.

impl Eq for DataLayer

impl PartialEq for DataLayer

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for DataLayer