Struct CarvingMask 

pub struct CarvingMask {
    min_y: i32,
    height: i32,
    bits: Vec<u64>,
}

A 16 × height × 16 bitset of local block positions in a chunk.

Fields

min_y: i32

height: i32

bits: Vec<u64>

Implementations

impl CarvingMask

pub fn new(min_y: i32, max_y: i32) -> Self

Creates an empty mask covering the inclusive range [min_y, max_y].

Panics

Panics if min_y is greater than max_y.

pub fn for_worldgen_context(min_y: i32, height: i32) -> Self

Creates the range used by NoiseBasedChunkGenerator.generateCarvers.

The bottom block and the top seven blocks are protected for normal generation, matching vanilla’s non-upgrading chunk path.

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

Vanilla’s getIndex: y - min_y + (z + (x << 4)) * height.

pub fn set(&mut self, x: i32, y: i32, z: i32)

Marks (x, y, z) as carved.

pub fn set_if_unset(&mut self, x: i32, y: i32, z: i32) -> bool

Marks (x, y, z) as carved if it was not already marked.

Returns true when this call set the bit, or false when a previous carver step had already visited the position.

pub fn get(&self, x: i32, y: i32, z: i32) -> bool

Returns whether (x, y, z) has been carved.

pub fn is_empty(&self) -> bool

Returns whether no carver marked any position.

pub fn visit(&self, visitor: impl FnMut(i32, i32, i32, i32))

Visits the marked vertical ranges in vanilla’s bitset order.

fn visit_segment( &self, visitor: &mut impl FnMut(i32, i32, i32, i32), start_index: usize, end_index: usize, )

fn next_set_bit(&self, from: usize) -> Option<usize>

fn next_clear_bit(&self, from: usize) -> usize

pub const fn min_y(&self) -> i32

Y range bound at construction.

pub const fn max_y(&self) -> i32

Inclusive upper Y bound.

Trait Implementations

impl Clone for CarvingMask

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CarvingMask

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

Formats the value using the given formatter.

impl Drop for CarvingMask

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.