Module appearance 

Opt-in appearance authoring over an effective IFC snapshot. No load-time geometry changes. Plans are applied atomically by the host mutation editor.

Structs

AnnotationPlaneFrame

AnnotationPlanePlan

AnnotationPlaneRequest

AppearanceCatalog

AppearanceCatalogProduct

AppearanceCatalogRequest

AppearanceCatalogType

AppearanceConversion

AppearanceGeneratedImage

AppearanceItem

AppearanceItemImage

AppearancePlan

AppearanceRaster

Offset into the separately supplied top-down, straight-alpha RGBA8 payload.

AppearanceRequest

AppearanceSourceRaster

CalibratedPlane

CapturedMesh

Explicit segmented surface, not a point cloud or an inferred BIM class.

CapturedMeshPlan

CapturedMeshRequest

CorrespondenceResidual

CreatedEntity

Exclusion

FaceMask

Ascending or unordered source triangle ordinals of one product’s evaluated surface. A stale fingerprint is an explicit exclusion, never a silent reuse.

MeshTransferPlan

MeshTransferRequest

MeshTransferSummary

PageAppearancePlan

PageAppearanceRequest

PdfFillAnnotationPlan

PdfFillAnnotationRequest

PdfFillRegion

PlaneCalibrationRequest

PositionalEdit

RegistrationFrame

RegistrationResiduals

RegistrationSpread

ScanCorrespondence

ScanRegistrationReport

ScanRegistrationRequest

TransferBudgetReport

Work actually charged against the fixed transfer budget, so a plan’s cost is auditable next to its coverage (#4381).

TransferCoverage

TransferFrame

TransferItemCoverage

TransferPointPayload

Binary point payload accompanying a TransferSource::Points request. Positions are source-frame metres; colors are RGB8; normals (3n f32, oriented) and stations (n indices into viewpoints) are empty when absent.

TransferSourceMesh

TransferSourcePoints

TransferSourceSummary

Which capture kind and orientation source produced a plan (#4381).

Enums

Mapping

MappingFrame

PointOrientation

Which side a point-cloud sample faces. Every plan records the source it used so the “no nearest-Gaussian shortcut” rule stays auditable (#4381).

RepresentationPolicy

TransferSource

One registered capture: a textured mesh or an RGB point cloud.

Functions

calibrate_appearance_plane

Establish one measured similarity transform for the whole source, then derive the current raster’s world rectangle. A crop/rotation/DPI change only changes raster_to_source and raster_size; it never recalibrates the measured span. This computes placement only, not clipped projection or IFC mutations.

catalog_appearance

Build class/type selectors without geometry or a TypeScript overlay policy. Input must already contain effective host edits. All IDs are model-local. A refusal returns no partial catalogue; caller validates sourceRevision.

plan_annotation_plane

Create one bounded textured annotation through the shared native product planner.

plan_appearance

schema must come from the host’s validated parser; nextExpressId is its reserved allocator watermark, strictly greater than every effective-source id. Images must already have a model-owned, collision-free relative filename. Returned UVs describe an UNSPLIT canonical item; fragment consumers must remap source corners or refuse a mismatched vertex count, never truncate UV arrays.

plan_captured_mesh

Author a bounded existing captured surface as IfcBuildingElementProxy. Decoding, reconstruction, classification and image ownership stay with callers.

plan_mesh_transfer

Textured mesh source. rgba carries the source image and the target’s existing rasters; a point source is refused here.

plan_page_appearance

Finite page composition shares target appearance preservation, charts and canonical IFC image/material planning with other surface samplers.

plan_pdf_fill_annotation

Create opaque polygonal fill pages through canonical product authoring and geometry. An exact page converts as is; a page with visible unsupported content converts only when the request quotes its fidelity report digest, and the omissions are recorded with the annotation. Raster-only pages and geometric qualification failures refuse the whole page.

plan_pdf_fill_annotation_with_clip

Plan an annotation from an optional registered rectangle in native PDF space without changing the source-compatible request struct.

plan_point_transfer

RGB point-cloud source (#4381). rgba carries only the target’s existing rasters; positions, colours and optional normals/stations arrive in points.

register_scan_correspondences

Pure fit in declared metre frames. The host must verify source bytes/frame revisions before using this report and must not promote it to an accuracy verdict without independently selected and spatially distributed checks.