Struct PlacementBuilder 

pub struct PlacementBuilder<'p, 'a> {
    grid: &'p mut GridPlacer<'a>,
    rect: Rect,
    container: ContainerRef,
    mapping: SlotMapping,
    kind: SectionKind,
}

A pending placement, applied only when region or result is called.

Fields

grid: &'p mut GridPlacer<'a>

rect: Rect

container: ContainerRef

mapping: SlotMapping

kind: SectionKind

Implementations

impl PlacementBuilder<'_, '_>

pub fn start_at(self, slot: usize) -> Self

Maps the rect’s first cell to container slot slot instead of 0.

pub fn at_indices(self, indices: impl IntoIterator<Item = usize>) -> Self

Maps the rect’s cells (row-major) to these container slots, in the given order. Replaces start_at.

The committing call panics if the count differs from the rect’s cell count.

pub fn kind(self, kind: impl Into<SectionKind>) -> Self

Lowers the cells through kind, e.g. a SectionKind::Custom factory. The generalization of restrict, guard and display.

pub fn restrict( self, may_place: impl Fn(usize, &ItemStack) -> bool + Send + Sync + 'static, ) -> Self

Only accepts items passing may_place. Pickup stays allowed.

pub fn guard( self, may_place: impl Fn(usize, &ItemStack) -> bool + Send + Sync + 'static, may_pickup: impl Fn(usize, &ItemStack, &ContainerLockGuard, &Player) -> bool + Send + Sync + 'static, ) -> Self

Guards both placement and pickup.

pub fn display(self) -> Self

Locks the cells as display slots. Clicks are rejected and handled in MenuKind::on_slot_clicked.

pub fn region(self) -> Region

Commits the placement and returns its region.

pub fn section(self) -> Section

Commits the placement and returns its single contiguous Section.

Shorthand for region() followed by Region::single; use region() when the rect may lower to multiple slot ranges.

Panics

Panics if the placement lowers to more than one contiguous slot range. Single-cell and single-row rects can never trip this.

pub fn result(self, handler: impl ResultHandler + 'static) -> Section

Commits a single fake result slot driven by handler, ignoring start_at and guards.

Panics

If the rect is not a single cell, or the placement container differs from ResultHandler::result_container.