Skip to content

Next Gen STEP AP242 Native-ish BREP Geometric Modeling Kernel

Refresh guitar presentation from current source

Yuechen Lifa7c2adb3321
diff --git a/docs/public/firmament/glb.md b/docs/public/firmament/glb.md
index 02c81eea..8adb1a92 100644
--- a/docs/public/firmament/glb.md
+++ b/docs/public/firmament/glb.md
@@ -32,6 +32,8 @@ presentation scenes. `scripts/export-presentation-scene.py` preserves product
positions and polygons, embeds the ATLAS maker label, and bakes the guitar's
existing procedural sunburst/wood base color. It does not translate general
material graphs or alter guitar geometry. Procedural grain bump is omitted.
+The presentation qualifier regenerates the guitar USD and shaded scene from
+current Firmament source on every run; it does not reuse a cached guitar `.blend`.
ATLAS is an independent Aetheris demo robot. Aetheris is not affiliated with,
endorsed by, or associated with Boston Dynamics. The shared name is coincidental.
diff --git a/docs/release/PRESENTATION-3D-X0.md b/docs/release/PRESENTATION-3D-X0.md
index 83dd9ac1..1caef660 100644
--- a/docs/release/PRESENTATION-3D-X0.md
+++ b/docs/release/PRESENTATION-3D-X0.md
@@ -1,6 +1,6 @@
# PRESENTATION-3D-X0
-Status on 2026-10-02: **Meaningful progression; desktop qualification pending.**
+Status on 2026-10-04: **Meaningful progression; desktop qualification pending.**
The C# GLB exporter and the existing C# slide writer now produce a two-slide PPTX
containing physically embedded ATLAS and guitar GLBs. Independent glTF validation
@@ -31,7 +31,7 @@ are supported and embedded in the binary buffer. Paths never enter GLB metadata.
The final polished witnesses use their established Aetheris USD-derived Blender
scenes. `export-presentation-scene.py` preserves product positions and polygons,
-exports the existing ATLAS label texture, and bakes five guitar sunburst/wood
+exports the existing ATLAS label texture, and bakes guitar sunburst/wood
base-color surfaces. This is a bounded finishing step, not a general material
graph translator. Procedural wood-grain bump is omitted; scalar PBR and supported
coat survive. No guitar geometry work was reopened. Studio floors, lights and
@@ -85,15 +85,15 @@ message for the existing 1024×192 label texture; direct display GLBs have
informational default-matrix messages. Guitar has no validator issues.
Blender **5.2.2 LTS** imports the polished assets independently. ATLAS has 61
-visible meshes using 25 mesh datablocks, including its printed label. Guitar has
-107 visible mesh objects and five embedded 1024×1024 images. Imported normals
+visible meshes using 25 mesh datablocks, including its printed label. The current
+guitar has 99 visible mesh objects and six embedded 1024×1024 images. Imported normals
are unit length and transforms are positive-handed. Measured physical bounds in
Blender's Z-up metres are approximately:
| Model | X | Y | Z |
|---|---:|---:|---:|
| ATLAS | 0.295001 | 0.130000 | 0.340774 |
-| Guitar | 0.337550 | 1.039273 | 0.066480 |
+| Guitar | 0.337550 | 1.039273 | 0.066340 |
`atlas-fallback.png` and `guitar-fallback.png` render the independently imported
GLBs. Visual inspection confirms the industrial robot, maker mark, polished
@@ -109,11 +109,11 @@ oracle live under ignored `artifacts/local/presentation-3d-x0/`.
| Artifact | Bytes |
|---|---:|
| ATLAS polished GLB | 546,680 |
-| Guitar polished GLB | 5,404,940 |
+| Guitar polished GLB, refreshed 2026-10-04 | 6,606,296 |
| Two-slide PPTX before models | 6,526 |
-| Embedded two-slide PPTX | 4,779,099 |
+| Refreshed two-slide PPTX, 2026-10-04 | 5,870,858 |
-Direct .NET GLB lowering took about 60 ms for ATLAS and 96 ms for guitar after
+Original October 2 timings: direct .NET GLB lowering took about 60 ms for ATLAS and 96 ms for guitar after
display preparation. Compilation and tessellation took about 4.29 s and 8.90 s
respectively. Polished finishing took approximately 0.70 s and 2.09 s. C# slide
compilation took approximately 116 ms. Desktop PowerPoint load time is unmeasured.
@@ -126,7 +126,7 @@ witnesses. CLI tests cover valid export and preservation of output after invalid
options. Three existing/new PPTX tests pass, including Office 2019 validation,
exact embedding, multiple model relationships, fallback, deterministic packages,
oracle structure and existing drawing functionality. Release build succeeds;
-the fast core lane passes 1,005 tests. The complete serial solution lane passes
+the fast core lane passes 1,005 tests. The October 2 complete serial solution lane passes
4,042 tests with zero failures (`full-tests-closeout.log`), including 1,138 core,
1,736 Firmament and 455 CLI tests.
@@ -143,12 +143,53 @@ Reproduce the generated assets with:
pwsh -File scripts/qualify-presentation-3d-x0.ps1
```
-This requires the existing qualified `.blend` scenes. If absent, run the existing
-industrial ATLAS and guitar qualification scripts with `-Render` first. The
-qualifier builds both direct GLBs, finishes both polished scenes, imports/renders
-them independently, runs pinned Khronos validation, and calls the C# deck compiler.
+This requires the existing qualified ATLAS `.blend` scene. If absent, run the
+industrial ATLAS qualification script with `-Render` first. The qualifier rebuilds
+the guitar USD from current Firmament code and invokes the existing sunburst
+renderer to recreate `guitar-source/guitar-studio.blend` on every run. It builds
+both direct GLBs, finishes both polished scenes, imports/renders them independently,
+runs pinned Khronos validation, and calls the C# deck compiler.
It does not claim desktop acceptance.
+## Current-source refresh, 2026-10-04
+
+The original presentation guitar used a September 30 cached studio scene. It
+predated the source-owned semicircular tailpiece/string rail and the repaired
+headstock/neck connection. The presentation qualifier now recompiles and reshades
+the guitar before GLB finishing, so cached geometry cannot conceal those fixes.
+The material binding for the widened headstock root was also corrected to its
+current full definition identity. Guitar geometry source was not changed.
+
+The current source has 99 visible part occurrences and 56 shared display
+definitions, rather than the old scene's 107 visible parts. Refresh evidence is
+retained in `guitar-source/` and `refresh-2026-10-04.log` beneath local artifacts.
+The refreshed polished GLB imports as 99 mesh objects and 145,728 triangles;
+Khronos validation reports zero errors and zero warnings. Its embedded copy in
+`interactive-3d-demo-2026-10-04.pptx` matches the current GLB byte-for-byte. The
+dated filename avoids overwriting the original deck while it is open in Office.
+Use `-DeckName interactive-3d-demo-2026-10-04.pptx` with the qualifier to choose
+this output name. Blender invocations now use `--python-exit-code 1`, ensuring
+failed finishing cannot silently pass by retaining an old output file.
+The refresh log records the original filename's Office lock; the separate
+`deck-compile-2026-10-04.json` records successful dated compilation (136 ms).
+The dated deck's media are embedded and its relationships are all internal.
+
+`guitar-bridge-detail.png` and `guitar-head-join-detail.png` are closeups rendered
+from an independent import of the refreshed GLB. They show the authored 5 mm
+semicircular string rail and the solid scarf/neck-to-headstock transition. The
+existing engineering witness tests verify the rail diameter sits at z=60 mm
+and the string crown at z=65 mm; no presentation-only repair geometry was added.
+
+October 4 validation: the solution Release build succeeds (zero errors, nine
+warnings), and the fast core lane passes all 1,005 tests. The full serial lane
+records 4,265 passes and one failure in
+`ProfileBoundaryAuthoringTests.OverlapIsRejectedAndDisjointEditOrderDoesNotChangeGeometry`
+at line 73. It reproduces in isolation using inline rectangular-panel source,
+without referencing guitar files, appearances or presentation artifacts. No C#
+compiler code was modified in this refresh. Both the full failure and focused
+diagnostic are retained as `refresh-full-tests.log` and
+`refresh-profile-boundary-diagnostic.log`; the full suite is not claimed green.
+
## ATLAS disclaimer
ATLAS is an independent Aetheris demo robot. Aetheris is not affiliated with,
diff --git a/fixtures/Canonical/AssemblyInterfaces/GuitarX0/preview-materials.json b/fixtures/Canonical/AssemblyInterfaces/GuitarX0/preview-materials.json
index dbc10781..98e227c2 100644
--- a/fixtures/Canonical/AssemblyInterfaces/GuitarX0/preview-materials.json
+++ b/fixtures/Canonical/AssemblyInterfaces/GuitarX0/preview-materials.json
@@ -48,7 +48,7 @@
"metallic": 0,
"roughness": 0.4
},
- "Head<H:14mm>": {
+ "Head<H:14mm,RootStart:16mm,RootHalfWidth:26.5mm,RootWidth:53mm>": {
"red": 0.15,
"green": 0.025,
"blue": 0.012,
diff --git a/scripts/export-presentation-scene.py b/scripts/export-presentation-scene.py
index 085b9a69..a730c3a8 100644
--- a/scripts/export-presentation-scene.py
+++ b/scripts/export-presentation-scene.py
@@ -39,7 +39,7 @@ def object_geometry(obj):
tuple(tuple(p.vertices) for p in obj.data.polygons))
product_geometry = {o.name: object_geometry(o) for o in products}
if kind == 'guitar':
- assert len(products) == 107, len(products)
+ assert len(products) in (99, 107), len(products)
scene.render.engine = 'CYCLES'
scene.cycles.samples = 1
scene.cycles.device = 'CPU'
diff --git a/scripts/inspect-presentation-glb.py b/scripts/inspect-presentation-glb.py
index cbd45601..cdc3256a 100644
--- a/scripts/inspect-presentation-glb.py
+++ b/scripts/inspect-presentation-glb.py
@@ -67,4 +67,15 @@ scene.render.filepath=str(output/(source.stem+'-fallback.png'))
scene.view_settings.view_transform='AgX'
bpy.ops.wm.save_as_mainfile(filepath=str(output/(source.stem+'-imported.blend')))
bpy.ops.render.render(write_still=True)
+if source.stem == 'guitar':
+ # Evidence from the imported deliverable, not from a cached source scene.
+ for name, position, target, scale in [
+ ('bridge-detail', (.30, -.28, .22), (0, -.055, .060), .21),
+ ('head-join-detail', (.5, .67, .050), (0, .67, .050), .11),
+ ]:
+ camera.location = position
+ camera.rotation_euler = (Vector(target)-camera.location).to_track_quat('-Z','Y').to_euler()
+ camera_data.ortho_scale = scale
+ scene.render.filepath = str(output/(source.stem+'-'+name+'.png'))
+ bpy.ops.render.render(write_still=True)
print(json.dumps({k:v for k,v in report.items() if k not in ('materials','hierarchy')}), flush=True)
diff --git a/scripts/qualify-presentation-3d-x0.ps1 b/scripts/qualify-presentation-3d-x0.ps1
index d4ef5b79..1a99ef7d 100644
--- a/scripts/qualify-presentation-3d-x0.ps1
+++ b/scripts/qualify-presentation-3d-x0.ps1
@@ -1,6 +1,7 @@
[CmdletBinding()]
param(
[string]$OutDir = 'artifacts/local/presentation-3d-x0',
+ [string]$DeckName = 'interactive-3d-demo.pptx',
[string]$Blender = 'C:/Program Files/Blender Foundation/Blender 5.2/blender.exe'
)
$ErrorActionPreference = 'Stop'
@@ -8,9 +9,10 @@ $repoRoot = Split-Path -Parent $PSScriptRoot
Push-Location $repoRoot
try {
$out = [IO.Path]::GetFullPath($OutDir)
+ if ([IO.Path]::GetFileName($DeckName) -ne $DeckName -or [IO.Path]::GetExtension($DeckName) -ne '.pptx') { throw 'DeckName must be a .pptx filename.' }
New-Item -ItemType Directory -Force $out | Out-Null
- foreach ($scene in @('artifacts/local/usd-industrial/atlas-hero.blend','artifacts/local/guitar-x0/guitar-studio.blend')) {
- if (!(Test-Path -LiteralPath $scene)) { throw "Missing qualified presentation scene: $scene. Run the existing qualify-industrial-atlas.ps1 -Render and qualify-guitar-x0.ps1 -Render first." }
+ foreach ($scene in @('artifacts/local/usd-industrial/atlas-hero.blend')) {
+ if (!(Test-Path -LiteralPath $scene)) { throw "Missing qualified presentation scene: $scene. Run the existing qualify-industrial-atlas.ps1 -Render first." }
}
function Invoke-Logged([string]$Program, [string[]]$Arguments, [string]$Log) {
& $Program @Arguments *> $Log
@@ -20,10 +22,16 @@ try {
$cli = 'Aetheris.CLI/bin/Release/net10.0/aetheris.dll'
Invoke-Logged 'dotnet' @($cli,'asm','export-glb','fixtures/Canonical/AssemblyInterfaces/IndustrialAtlas/atlas-industrial.firmament',"$out/atlas-display.glb",'--materials','fixtures/Canonical/AssemblyInterfaces/IndustrialAtlas/appearance.json','--state','Shoulder=-75','--state','Elbow=-140','--state','GripLeft=10','--state','GripRight=10','--json') "$out/atlas-display-export.json"
Invoke-Logged 'dotnet' @($cli,'asm','export-glb','fixtures/Canonical/AssemblyInterfaces/GuitarX0/guitar.firmasm',"$out/guitar-display.glb",'--materials','fixtures/Canonical/AssemblyInterfaces/GuitarX0/preview-materials.json','--json') "$out/guitar-display-export.json"
+ # Rebuild the shaded guitar from current compiled geometry, never a cached
+ # studio scene: neck/bridge fixes can otherwise disappear from the deck.
+ $guitarRoot = "$out/guitar-source"
+ New-Item -ItemType Directory -Force $guitarRoot | Out-Null
+ Invoke-Logged 'dotnet' @($cli,'asm','export-usd','fixtures/Canonical/AssemblyInterfaces/GuitarX0/guitar.firmasm',"$guitarRoot/guitar.usda",'--materials','fixtures/Canonical/AssemblyInterfaces/GuitarX0/preview-materials.json','--evidence',"$guitarRoot/display.json",'--json') "$guitarRoot/export.json"
+ Invoke-Logged $Blender @('--background','--factory-startup','--python-exit-code','1','--python','scripts/render-guitar-x0.py','--',"$guitarRoot/guitar.usda",$guitarRoot,'--preview','--view=hero') "$guitarRoot/render.log"
foreach ($kind in @('atlas','guitar')) {
- $scene = if ($kind -eq 'atlas') { 'artifacts/local/usd-industrial/atlas-hero.blend' } else { 'artifacts/local/guitar-x0/guitar-studio.blend' }
- Invoke-Logged $Blender @('--background','--python','scripts/export-presentation-scene.py','--',$kind,$scene,"$out/$kind.glb") "$out/$kind-polish.log"
- Invoke-Logged $Blender @('--background','--python','scripts/inspect-presentation-glb.py','--',"$out/$kind.glb",$out) "$out/$kind-blender.log"
+ $scene = if ($kind -eq 'atlas') { 'artifacts/local/usd-industrial/atlas-hero.blend' } else { "$guitarRoot/guitar-studio.blend" }
+ Invoke-Logged $Blender @('--background','--python-exit-code','1','--python','scripts/export-presentation-scene.py','--',$kind,$scene,"$out/$kind.glb") "$out/$kind-polish.log"
+ Invoke-Logged $Blender @('--background','--python-exit-code','1','--python','scripts/inspect-presentation-glb.py','--',"$out/$kind.glb",$out) "$out/$kind-blender.log"
}
$toolsRoot = "$out/tools"
Invoke-Logged 'npm' @('install','--prefix',$toolsRoot,'[email protected]') "$out/validator-install.log"
@@ -36,7 +44,7 @@ try {
}
$manifest = "$out/deck.json"
$deck | ConvertTo-Json -Depth 20 | Set-Content -LiteralPath $manifest -Encoding utf8
- Invoke-Logged 'dotnet' @($cli,'presentation','compile',$manifest,"$out/interactive-3d-demo.pptx",'--json') "$out/deck-compile.json"
+ Invoke-Logged 'dotnet' @($cli,'presentation','compile',$manifest,"$out/$DeckName",'--json') "$out/deck-compile.json"
$empty = $deck | ConvertTo-Json -Depth 20 | ConvertFrom-Json
foreach ($slide in $empty.slides) { $slide.models = @() }
$empty | ConvertTo-Json -Depth 20 | Set-Content -LiteralPath "$out/deck-without-models.json" -Encoding utf8