Class AP214SceneBuilder

constructor

• new AP214SceneBuilder(model, conwayGeometry, materials): AP214SceneBuilder

• Parameters

  • model: default
  • conwayGeometry: ConwayGeometry
  • materials: AP214MaterialCache

  Returns AP214SceneBuilder

ReadonlyconwayGeometry

Readonlymaterials

Readonlymodel

roots

currentParent

• get currentParent(): undefined | AP214SceneTransform

• Returns undefined | AP214SceneTransform

stackLength

• get stackLength(): number

• Get the current stack deoth.

  Returns number

  The current stack depth.

addGeometry

• addGeometry(localID, owningElementLocalID?, materialOverridLocalID?): AP214SceneGeometry

• Parameters

  • localID: number
  • OptionalowningElementLocalID: number
  • OptionalmaterialOverridLocalID: number

  Returns AP214SceneGeometry

addSceneListener

• addSceneListener(listener, options?): void

• Parameters

  • listener: SceneListener
  • Optionaloptions: SceneListenerOptions

  Returns void

addTransform

• addTransform(localID, transform, nativeTransform, mappedItem?): AP214SceneTransform

• Add a transform node and make the current transform stack parent its parent.

  Items added will be made the top of the transform stack.

  To prevent a node being used as a parent, pop it subsequently.

  Parameters

  • localID: number

    The local ID of the transform.
  • transform: readonly number[]

    The transform matrix.
  • nativeTransform: NativeTransform4x4

    The native transform matrix.
  • mappedItem: boolean = false

    Whether the transform is a mapped item.

  Returns AP214SceneTransform

  The added transform node.

buildPackedMeshModel

• buildPackedMeshModel(): PackedMesh<default>

• Build a packed/optimised mesh model with triangle element maps.

  Returns PackedMesh<default>

  Maps materials to a geometry object and triangle element map.

clearParentStack

• clearParentStack(): void

• Returns void

geometryOccurrences

• geometryOccurrences(): IterableIterator<[undefined | default<EntityTypesAP214>, readonly number[]], any, any>

• Walk every geometry node yielding its owning part-type element (the product_definition_shape, shared across occurrences) alongside the occurrence path (NAUO express ids) that uniquely places it. This is the seam that lets a picked mesh resolve to the right product-structure node: the owner id alone collides across reused parts; the occurrence path does not.

  Returns IterableIterator<[undefined | default<EntityTypesAP214>, readonly number[]], any, any>

  Yields

  [owning element, occurrence path] per geometry node.

getByNodeIndex

• getByNodeIndex(nodeIndex): undefined | AP214SceneNode

• Parameters

  • nodeIndex: number

  Returns undefined | AP214SceneNode

getTransform

• getTransform(localID): undefined | AP214SceneTransform

• Parameters

  • localID: number

  Returns undefined | AP214SceneTransform

hasGeometry

• hasGeometry(localID): boolean

• Does this scene have a particular piece of geometry?

  Parameters

  • localID: number

    The local ID of the geometry

  Returns boolean

  True if the scene has this geometry.

isAllSpaces

• isAllSpaces(): boolean

• Are all the geometry nodes in the scene spaces

  Returns boolean

  Are all the geometry nodes in the scene spaces

popOccurrence

• popOccurrence(): void

• Leave the most recently entered assembly occurrence.

  Returns void

popTransform

• popTransform(): void

• Returns void

pushOccurrence

• pushOccurrence(occurrenceExpressID): void

• Enter an assembly occurrence: subsequent geometry is stamped as belonging to this NAUO. Balanced by popOccurrence.

  Parameters

  • occurrenceExpressID: number

    The NAUO express id of the placement being entered.

  Returns void

pushTransform

• pushTransform(transform): void

• Parameters

  • transform: AP214SceneTransform

  Returns void

removeSceneListener

• removeSceneListener(listener): void

• Parameters

  • listener: SceneListener

  Returns void

walk

• walk(includeSpaces?): IterableIterator<[undefined | readonly number[], undefined | NativeTransform4x4, CanonicalMeshBuffer, undefined | CanonicalMaterial, undefined | default<EntityTypesAP214>], any, any>

• Walk the current scene.

  Parameters

  • includeSpaces: boolean = false

    the canonical material and the associated step element as it walks the hierarchy.

  Returns IterableIterator<[undefined | readonly number[], undefined | NativeTransform4x4, CanonicalMeshBuffer, undefined | CanonicalMaterial, undefined | default<EntityTypesAP214>], any, any>

  Yields

  Raw absolute matrix transform, the native absolute transform, the canonical mesh,

walkWithOccurrence

• walkWithOccurrence(includeSpaces?): IterableIterator<[undefined | readonly number[], undefined | NativeTransform4x4, CanonicalMeshBuffer, undefined | CanonicalMaterial, undefined | default<EntityTypesAP214>, readonly number[]], any, any>

• Same as walk, but also yields each geometry instance's occurrence path (NAUO express ids) as a 6th element. Kept separate from walk (which satisfies the shared WalkableScene contract) so the AP214 shim can attach per-instance occurrence identity to each emitted PlacedGeometry without changing the interface every scene builder implements.

  Parameters

  • includeSpaces: boolean = false

    Unused; kept for signature parity with walk.

  Returns IterableIterator<[undefined | readonly number[], undefined | NativeTransform4x4, CanonicalMeshBuffer, undefined | CanonicalMaterial, undefined | default<EntityTypesAP214>, readonly number[]], any, any>

  Yields

  walk tuple plus the occurrence path of the geometry instance.