Struct GltfOptions 

#[non_exhaustive]
pub struct GltfOptions {
    pub include_metadata: bool,
    pub isolated: Option<Vec<u32>>,
    pub hidden: Vec<u32>,
    pub hidden_types: Vec<String>,
    pub lit: bool,
    pub emissive: bool,
    pub model_id: Option<String>,
    pub quantize: bool,
    pub tessellation_quality: TessellationQuality,
}

Options for glTF/GLB export.

let opts = GltfOptions::default().with_tessellation_quality(TessellationQuality::Low);

#[non_exhaustive] plus builders, for the reason ModelOptions gives: this will grow, and non_exhaustive forbids EVERY struct expression from outside this crate, ..Default::default() included. Builders are the shape that keeps an external caller compiling when a field is added. The fields stay public, so reading one or assigning to one still works.

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.

include_metadata: bool

Attach asset.extras (counts) and per-node extras.expressId.

isolated: Option<Vec<u32>>

Restrict to these express ids (isolation allowlist). None ⇒ no filter, every mesh is a candidate; Some(empty) ⇒ the filter is ACTIVE and matched nothing, so every mesh is excluded. Do not collapse the two — an active isolation that matches zero elements must export nothing, not silently fall back to the whole model (matches the null-vs-empty convention already used by packages/export/src/reference-collector.ts and packages/renderer/src/entity-visibility.ts on the TS side).

hidden: Vec<u32>

Exclude these express ids (hidden in the viewer).

hidden_types: Vec<String>

Exclude meshes whose IFC type is in this set (class-level visibility toggle).

lit: bool

Emit standard (lit) PBR materials so external viewers shade the model from its normals. When false, materials are tagged KHR_materials_unlit and render flat with just the apparent base colour (the historical behaviour, kept for colour-accurate exports). Default true. (#1321)

emissive: bool

Make every material self-illuminating by setting emissiveFactor to its base colour. Targets renderers with no ambient/IBL and a single hard sun — notably Google Earth, which ignores KHR_materials_unlit and lit the model so dark that shadow-side faces went black (#1427). emissiveFactor is core glTF 2.0 (not an extension), so every compliant renderer honours it; the base colour is kept too, so a viewer that ignores emissive is no worse than today (never blacker than the lit result). Default false.

model_id: Option<String>

Per-model id stamped into every node’s extras.modelId (federation: lets a host distinguish elements from different models that share express-id space). None ⇒ single model, no modelId emitted. Requires include_metadata.

quantize: bool

Quantize geometry with KHR_mesh_quantization: 16-bit SHORT positions + normals per-mesh over each mesh’s own bbox, with the dequant on a node transform. ~2x smaller, precision-safe (sub-2 mm per-mesh on the measured corpus). Default false — the unquantized f32 output is byte-identical to before. three.js GLTFLoader decodes it natively, but a loader without the extension cannot open the file (it is extensionsRequired), so only enable when the consumer supports it.

tessellation_quality: TessellationQuality

Tessellation density. Medium is the golden-output identity; coarser levels trade curve fidelity for vertex count on tube-heavy models.

Implementations

impl GltfOptions

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

See GltfOptions::include_metadata.

pub fn with_isolated(self, ids: Option<Vec<u32>>) -> Self

See GltfOptions::isolated. None ⇒ no filter; Some(ids) (empty or not) ⇒ an active allowlist — pass Some(vec![]) deliberately to export nothing, never as a stand-in for “no filter”.

pub fn with_hidden(self, ids: Vec<u32>) -> Self

See GltfOptions::hidden.

pub fn with_hidden_types(self, types: Vec<String>) -> Self

See GltfOptions::hidden_types.

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

See GltfOptions::lit.

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

See GltfOptions::emissive.

pub fn with_model_id(self, id: Option<String>) -> Self

See GltfOptions::model_id.

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

See GltfOptions::quantize.

pub fn with_tessellation_quality(self, quality: TessellationQuality) -> Self

See GltfOptions::tessellation_quality.

Trait Implementations

impl Default for GltfOptions

fn default() -> Self

Returns the “default value” for a type.