Struct Placement 

pub struct Placement {
    pub location: DVec3,
    pub axis: DVec3,
    pub ref_direction: DVec3,
}

An object placement, modelled as IFC models it.

Stored as IfcAxis2Placement3D does — a location plus a Z axis and a reference X axis — rather than as a raw 4×4. Keeping the IFC shape avoids a lossy decomposition on every export, and it makes a non-orthogonal or mirrored transform impossible to represent by accident.

Fields

location: DVec3

axis: DVec3

Local Z. Normalised on construction.

ref_direction: DVec3

Local X. Orthogonalised against axis on construction.

Implementations

impl Placement

pub fn identity() -> Self

Identity placement at the origin.

pub fn at(location: DVec3) -> Self

pub fn new(location: DVec3, axis: DVec3, ref_direction: DVec3) -> Self

Build a placement, normalising axis and orthogonalising ref_direction against it.

Degenerate input (zero-length or parallel axes) falls back to the identity basis rather than producing a silently broken transform.

pub fn to_matrix(self) -> DMat4

The local-to-parent transform.

pub fn from_matrix(matrix: DMat4) -> Self

Recover a placement from a rigid transform.

Import needs this: IFC nests placements, so an element’s transform is the composition of its whole IfcLocalPlacement chain, and getting back to a storey-relative placement means composing, inverting, and decomposing.

Only rotation and translation survive. Scale and shear are discarded by re-orthogonalising, because Placement cannot represent them and silently keeping a scaled basis would corrupt every downstream length.

pub fn translated(self, delta: DVec3) -> Self

Translate without touching orientation.

Trait Implementations

impl Clone for Placement

fn clone(&self) -> Placement

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Placement

impl Debug for Placement

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

Formats the value using the given formatter.

impl Default for Placement

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Placement

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Placement

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Placement

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Placement