Skip to main content

PolygonalBoundedHalfSpace

Struct PolygonalBoundedHalfSpace 

Source
pub struct PolygonalBoundedHalfSpace<'m> { /* private fields */ }
Expand description

IfcPolygonalBoundedHalfSpace: a half space clipped by an extruded polygon.

§How the bounding actually works

This is the single most misread entity in IFC clipping, so, precisely:

  1. Position is an IfcAxis2Placement3D establishing a local coordinate system. It is independent of BaseSurface; the two need not share an origin or an orientation.
  2. PolygonalBoundary is a 2D bounded curve (an IfcPolyline or an IfcCompositeCurve, and in IFC4X3 also an IfcIndexedPolyCurve, per the schema’s BoundaryType rule) lying in the XY plane of Position. Its coordinates are 2D, so it is not a curve in world space and cannot be used without applying Position.
  3. The bounding body is that polygon extruded along +Z of Position, unbounded in that direction.
  4. The final solid is the intersection of that prism with the infinite half space defined by BaseSurface and AgreementFlag.

The consequence is that the polygon does not lie on the base surface and should never be projected onto it. Doing so produces a clip of roughly the right shape in roughly the wrong place, which is why bad wall openings look almost correct.

Implementations§

Source§

impl<'m> PolygonalBoundedHalfSpace<'m>

Source

pub fn new(id: EntityId, entity: &'m Entity) -> Self

Wrap an entity assumed to be an IfcPolygonalBoundedHalfSpace.

Source

pub fn id(&self) -> EntityId

The entity id.

Source

pub fn base(&self) -> HalfSpaceSolid<'m>

The inherited IfcHalfSpaceSolid attributes.

Source

pub fn position(&self) -> GeometryResult<EntityId>

The IfcAxis2Placement3D whose XY plane holds the boundary.

Required here, unlike the optional Position on IfcSweptAreaSolid: without it the 2D boundary cannot be placed at all.

Source

pub fn polygonal_boundary(&self) -> GeometryResult<EntityId>

The 2D IfcBoundedCurve reference bounding the half space.

Its coordinates are in the XY plane of Self::position; the clipping body is this curve extruded along that placement’s +Z.

Returned as a reference on purpose. The attribute is typed as the abstract IfcBoundedCurve, so there is no single view to resolve into: lower::halfspace dispatches on the concrete curve type (refusing the families it does not lower by name) and the typed views live in crate::curve.

Trait Implementations§

Source§

impl<'m> Clone for PolygonalBoundedHalfSpace<'m>

Source§

fn clone(&self) -> PolygonalBoundedHalfSpace<'m>

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl<'m> Copy for PolygonalBoundedHalfSpace<'m>

Source§

impl<'m> Debug for PolygonalBoundedHalfSpace<'m>

Source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.