Struct Geometry3D 

pub struct Geometry3D { /* private fields */ }

A 3D box geometry that can be packed.

Implementations

impl Geometry3D

pub fn new( id: impl Into<GeometryId>, width: f64, depth: f64, height: f64, ) -> Self

Creates a new 3D box geometry with the given ID and dimensions.

pub fn box_shape( id: impl Into<GeometryId>, width: f64, depth: f64, height: f64, ) -> Self

Alias for creating a box shape.

pub fn with_quantity(self, n: usize) -> Self

Sets the quantity to place.

pub fn with_mass(self, mass: f64) -> Self

Sets the mass.

pub fn with_orientation(self, constraint: OrientationConstraint) -> Self

Sets the orientation constraint.

pub fn with_stackable(self, stackable: bool) -> Self

Sets whether items can be stacked on top.

pub fn with_max_stack_weight(self, weight: f64) -> Self

Sets the maximum weight that can be stacked on top.

pub fn dimensions(&self) -> &Vector3<f64>

Returns the dimensions (width, depth, height).

pub fn width(&self) -> f64

Returns the width.

pub fn depth(&self) -> f64

Returns the depth.

pub fn height(&self) -> f64

Returns the height.

pub fn mass(&self) -> Option<f64>

Returns the mass.

pub fn orientation_constraint(&self) -> OrientationConstraint

Returns the orientation constraint.

pub fn is_stackable(&self) -> bool

Returns whether items can be stacked on top.

pub fn allowed_orientations(&self) -> Vec<(usize, usize, usize)>

Returns the allowed orientations based on the constraint. Each orientation is (width_axis, depth_axis, height_axis).

pub fn orientation_label(&self, orientation: usize) -> String

Returns the orientation label for a given orientation index, as an axis-permutation string (e.g. "xyz", "xzy").

The permutation (x_idx, y_idx, z_idx) from allowed_orientations is mapped to the axis letters x/y/z. Out-of-range indices fall back to the identity orientation "xyz".

pub fn dimensions_for_orientation(&self, orientation: usize) -> Vector3<f64>

Returns dimensions for a given orientation index.

Trait Implementations

impl Clone for Geometry3D

fn clone(&self) -> Geometry3D

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Geometry3D

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

Formats the value using the given formatter.

impl Geometry for Geometry3D

type Scalar = f64

The coordinate type (f32 or f64).

fn id(&self) -> &GeometryId

Returns the unique identifier for this geometry.

fn quantity(&self) -> usize

Returns the quantity of this geometry to place.

fn measure(&self) -> f64

Returns the area (2D) or volume (3D) of this geometry.

fn aabb_vec(&self) -> (Vec<f64>, Vec<f64>)

Returns the axis-aligned bounding box as Vec (for generic dimension support).

fn centroid(&self) -> Vec<f64>

Returns the centroid (center of mass) of this geometry.

fn rotation_constraint(&self) -> &RotationConstraint<f64>

Returns the allowed rotations for this geometry.

fn validate(&self) -> Result<()>

Validates the geometry and returns an error if invalid.

fn aabb(&self) -> ([Self::Scalar; 2], [Self::Scalar; 2])

Returns the axis-aligned bounding box as (min, max) corners.

fn allow_mirror(&self) -> bool

Returns whether mirroring/flipping is allowed.

fn priority(&self) -> i32

Returns optional priority for placement order (higher = placed first).