Struct ModelOptions 

#[non_exhaustive]
pub struct ModelOptions {
    pub placements: bool,
    pub inherit_type_properties: bool,
    pub attributes: bool,
}

What the export should resolve beyond the attributes it always reads.

let opts = ModelOptions::default().with_placements(true);

#[non_exhaustive] plus builders, rather than a plain struct: this will grow, and non_exhaustive forbids EVERY struct expression from outside this crate — including ..Default::default(), which is the one people reach for to survive new fields and which does not compile here. Builders are the shape that actually works for an external caller and keeps working when a field is added.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

placements: bool

Resolve each product’s ObjectPlacement into [EntityRow::placement].

Off by default because it is not free: the placement memo is ~128 B per distinct placement — one per product in most files, so O(products) on top of the entity index — and each product costs a few extra decodes of its own chain after the shared upper levels are memoized.

inherit_type_properties: bool

Merge the property/quantity sets an occurrence inherits from its IfcTypeObject into EntityRow::property_sets and EntityRow::quantity_sets, per property, occurrence wins.

Off by default, which is NOT a claim that off is more correct. It is not: authoring tools put a great deal on types, a type carrying Pset_WallCommon yields no row of its own here (it only gets one when it also has orphan geometry), and the browser has resolved inheritance this way since #1913. Off is the default only because this changes what every existing CSV/JSON/IFCX/Parquet export contains, and that is a decision to take deliberately rather than as a side effect of adding the capability.

It costs one extra IfcRelDefinesByType map in pass 1 (O(typed occurrences)) and one resolve per distinct type, memoized.

attributes: bool

Render the attributes each entity’s own IFC class declares, into EntityRow::attributes.

Off by default for the same reason as the others: it adds columns to every flattened export. It is cheap when on, though, since the row’s entity is already decoded and this only formats fields already in hand.

Implementations

impl ModelOptions

pub fn with_placements(self, yes: bool) -> Self

Resolve each product’s ObjectPlacement. See ModelOptions::placements.

pub fn with_inherit_type_properties(self, yes: bool) -> Self

Merge type-inherited property/quantity sets into each occurrence. See ModelOptions::inherit_type_properties.

pub fn with_attributes(self, yes: bool) -> Self

Render each entity class’s declared attributes into every row. See ModelOptions::attributes.

Trait Implementations

impl Clone for ModelOptions

fn clone(&self) -> ModelOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ModelOptions

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

Formats the value using the given formatter.

impl Default for ModelOptions

fn default() -> ModelOptions

Returns the “default value” for a type.