Next Gen STEP AP242 Native-ish BREP Geometric Modeling Kernel
Scenes
Model / Part describes an engineered object. Assembly describes objects and
their mechanical or semantic relationships. Scene describes independent
objects coexisting in a spatial environment. Scene placement does not create a
Mate or Interface. Engineering geometry still belongs to its part or assembly.
Scene Factory {
units: m;
Room warehouse { size: [6m, 4m, 3m]; thickness: 100mm; }
Door loadingBay { on: warehouse.southWall; width: 1.5m; height: 2.4m; along: .4m; }
Window officeGlass { on: warehouse.eastWall; width: 1.5m; height: 1m; sill: 1.2m; along: 1m; }
<Assembly robot = AssemblyFile<"robot.firmament">>
Placement { from: Origin; to: World; translateLocal: [1m, 2m, 0mm]; }
</Assembly>
Camera hero { position: [5.6m, .25m, 2.65m]; lookAt: [2.5m, 2.1m, .8m]; fov: 65deg; }
}
AssemblyFile references an independently compiled .firmament Assembly source;
it requires file/project directory context. Scenes do not merge its declarations
into the Scene or import its mechanical constraints into the Scene root.
Individual Part occurrences use ordinary typed Template specializations declared
before the Scene, for example <Part package = Package<R:100mm,H:200mm>>.
Those templates retain their existing mm geometry authoring contract.
Units and room coordinates
units: m selects scene-scale authoring; units: mm also works. Every Scene
length and coordinate still requires an explicit m or mm suffix. Binding
normalizes 1m to 1000mm; changing units never rescales explicit literals.
Kernel geometry and tolerances remain in mm. Scene Set lengths are converted
at the existing typed pattern catalog boundary before occurrence expansion.
Scene lengths also accept finite dimension-checked expressions such as
2m + 500mm and site.Y - 600mm; these use the existing scalar evaluator after
metre-literal normalization. Unitless additions, length products and division
by zero fail. Assembly translation expressions retain the mm unit contract.
A Room occupies [0,width] × [0,depth] × [0,height], optionally translated by
at: [x,y,z]. Its clear interior dimensions are size. Default enclosure
thickness is 100mm, placed outside the clear interior. Rooms are rectangular
and axis-aligned; dimensions and thickness must be positive.
Every Room publishes case-sensitive floor, ceiling, northWall, southWall,
eastWall, and westWall references. Their exact boundary frames, dimensions and
owned openings are available to inspection. These are Scene boundary references,
independent of BRep face or triangle IDs. Wall coordinates use local X for
along, local Y for vertical height. Along increases in world +X on north/south
walls and world +Y on east/west walls, always measured from the minimum corner.
These right-handed frames are coordinate charts for along and height; their
third axis is not an inward/outward wall-normal classification.
Door bottom is the floor. Window bottom is its sill. Openings must fit inside
the selected wall and cannot overlap. They lower to actual missing wall volume
by a deterministic rectangular partition. No authored subtraction is required.
Windows remain apertures by default. Optional glazingAppearance and
frameAppearance synthesize a single inset pane and four frame members from
the aperture's owned dimensions. frameWidth defaults to 40mm;
glassThickness defaults to 6mm. A frame must leave positive clear width/height,
and glass must fit within the Room's wall thickness. Dimensions require the
corresponding finish. Unknown finishes fail. Door leaves remain unsynthesized.
The semantic hierarchy is Room → boundary → opening, even when the boundary's
display consists of multiple panels. Panel names are derived display structure;
the named boundary and opening retain authority.
Placement, sharing and presentation
Room appearance is the default wall/enclosure finish. Optional
floorAppearance and ceilingAppearance override those two surfaces without
adding overlay geometry or changing engineering Material. For example:
Room main {
size: [9m, 7m, 3.1m];
appearance: plasterWhite; floorAppearance: warmOak; ceilingAppearance: ceilingWhite;
}
Window garden {
on: main.westWall; along: 1.1m; width: 4.4m; height: 2.6m; sill: .12m;
glazingAppearance: clearGlass; frameAppearance: charcoalMetal; frameWidth: 45mm;
}
The existing top-level Concept Struct Plane/Axis/DatumFrame vocabulary also
supplies Scene placement guides. The existing datum parser owns units, bases,
derivation and cycle checks; Concept coordinates retain its mm contract.
Planes may derive from a Room boundary or another same-document Concept datum.
Published engineering-port derivation remains with Assembly. Unresolved guides
fail during source analysis, including unused guides. Concepts produce no solids
or product occurrences and stay outside engineering definition cache inputs.
Concept Struct HouseLayout {
Plane floor { from: main.floor; }
DatumFrame dining { on: floor; at: [6800mm, 5350mm]; x: [1, 0]; }
}
// In the Scene:
<Assembly dining = AssemblyFile<"dining.firmament">>
Placement { from: Origin; to: HouseLayout.dining; }
</Assembly>
Scene Placement reuses the existing translateLocal, rotateLocal, normal,
up, and frame composition implementation. to may name World, a Room
boundary, or a same-document Concept datum. from: Origin is available on Parts and Assemblies; Assemblies may
also name an exact published DatumFrame. Rotation retains the existing form
rotateLocal: { axis: Z; angle: 90deg; }. There are no authored matrices.
Named Scene FrameTransform declarations and Part source-port alignment are
deferred; Scene rejects unsupported declarations with a diagnostic.
The existing Pattern name over keyedSet frontend expands Parts and Assemblies;
Scenes have no loop language. Pattern containers are spatial groups, not
engineered assemblies. Names, pattern keys, declaration spans, definition
identities and placement authority survive inspection and USD metadata.
Scenes also admit the existing Linear Sites and Mirrored Sites recipes.
They keep their ordered keys, derivation metadata, mm-only vectors and shared
validation rules. For example, Linear Sites rows { keys: [assembly, inspection]; start: [0mm, 0mm, 0mm]; step: [0mm, 7000mm, 0mm]; } supplies a normal keyed
pattern. Changing pitch preserves occurrence identity without rebuilding parts.
Each unique AssemblyFile compiles once per build. Repeated occurrences share its
part display definitions. Local Part specializations use the existing immutable
STEP definition cache. FirmamentSceneSession keeps independent retained
Assembly sessions. Camera, placement and Scene Set edits do not invalidate
unchanged geometry declarations. Cache hits still reimport fresh exact bodies;
they do not expose cached mutable topology.
Camera is presentation state: a unit-bearing position and lookAt, plus a
vertical fov in degrees. Export uses Z-up camera orientation. Cameras never
modify engineering geometry. Scene Appearance definitions and occurrence
appearance overrides reuse the existing finite preview material values.
Physical material/density selection remains in engineering definitions.
Appearance also admits optional opacity in [0,1], default one. USD emits
UsdPreviewSurface opacity; GLB emits alpha and BLEND for translucent looks.
Opacity does not encode refraction, physical glass properties, or a shader graph.
Optional emissive: [r,g,b] is finite linear RGB in [0,1], default black.
It exports as glTF emissiveFactor and USD PreviewSurface emissiveColor.
It represents a luminous appearance, not calibrated light intensity or a Scene
light object. Renderers may add presentation illumination at fixture locations.
CLI and exports
aetheris validate fixtures/Canonical/Scene/warehouse.firmament --json
aetheris inspect fixtures/Canonical/Scene/warehouse.firmament --repeat 2 --json
aetheris scene export-usd fixtures/Canonical/Scene/warehouse.firmament --json
aetheris scene export-glb fixtures/Canonical/Scene/warehouse.firmament --json
aetheris scene export-glb fixtures/Canonical/Scene/WarmModernHouse/house.firmament artifacts/local/scene/house-cutaway.glb --hide-boundary main.ceiling --hide-boundary main.southWall --hide-boundary main.eastWall --json
Default output is ignored artifacts/local/scene/. USD preserves spatial
hierarchy, shared instances, transforms, named opening metadata, cameras and
appearance overrides. GLB uses the existing display exporter and the established
mm/Z-up to m/Y-up boundary; material variants share geometry buffers. GLB is a
static presentation asset. Assembly kinematics and STEP authority remain with
the source assembly; Scene USD does not export a combined physics articulation.
The existing PowerPoint 3D pipeline can embed the generated GLB and a rendered fallback PNG. Desktop rotation/save/reopen is a separate manual qualification. Whole-scene manufacturing STEP is deliberately unsupported.
Repeated --hide-boundary room.boundary options select an explicit USD/GLB
presentation cutaway. All display geometry under those exact owned boundaries
is omitted from the projection. The compiled Scene and complete room geometry
stay unchanged; unknown boundary names fail before output is written. Inspection
always describes the full Scene. This allows an interior model to be useful in
an orbit-only viewer such as PowerPoint without deleting architecture in source.
The warm modern house demonstrates top-down Concept layout, bottom-up furniture components, then Scene composition. Its qualification report records the exact presentation and retained-session evidence.
The factory witness composes three production lines, original robot islands and a reusable logistics kit in a 42 × 28 metre hall. Its report gives reproduction commands, measured reuse, export checks and presentation qualification limits.
Completion, hover and source diagnostics use compiler-owned schemas. Scene formatting safely prefers camelCase field labels while preserving layout, comments, generic specialization spelling and authored identities. It is deterministic and idempotent; it does not rename public ports or pattern keys. Project-snapshot language analysis reads Scene syntax; compiling AssemblyFile resources from a virtual/browser project is deferred.
Nested Scenes, BIM/IFC, general walls, zones, lights, logistics, collision avoidance, path planning, physics and robotics control are outside the Scene domain.
Inventory module composition
Inventory Records organize typed dependencies without injecting
imported definitions into the Scene's source namespace. Use extensionless locators
such as Firmament("machine").Machine and place the member as an ordinary Assembly
occurrence. Part and Subassembly entries use their existing engineering owners.
A Scene entry can be placed with <Scene cell = Library.cell> ... </Scene>.
Nested Scenes retain their units, geometry, occurrence hierarchy, appearances and
source anchors. Their world transforms compose with the parent's Placement exactly
once. Place them from Origin; child cameras remain local to the child Scene.
The compiled Scene source model retains Inventory binding and source-dependency
receipts; CLI inspection exposes the composed nodes and their source anchors. A complete
multi-file witness is the Inventory factory.