Files
makeCAD/examples/studio
brett19 054392abbe Wave 509/509: Kernel rig: assembly cases for mass properties, align, find limits and moving items between parts (and 38 more)
39 commits, squashed; the originals stay reachable from tag archive/merge-main-develop. These commits sit on several merged branches, so the wave holds their combined result.

- 1b17dd7f5 brett19: Merge fixes: every crate and test target compiles on the merged tree, but for crates/geom's hlr
- 8f2c11da2 brett19: Drawings hidden lines: read develop's B-rep records
- c30ca0216 brett19: Hidden-line fixtures: build develop's records from the fixtures' data
- 5dd2509ae brett19: Hidden lines: tests of the bounded edges, face charts and placed revolutions
- 1642df0ea brett19: drawing-hlr doc: what is drawn and refused on develop's records
- ddcb80c8e brett19: hlr tests: a placed revolution is refused when its placement is not rigid
- e4977721f brett19: Hidden lines: a traced intersection is drawn only where its spline lies on both surfaces
- b3ef6ae52 brett19: Hidden lines: kernel bodies through the production prepare against closed forms
- 4cd2ae062 brett19: Tests from main: the world state is a Result here
- 51d7ad09e brett19: A blend's pick measures close edges on their curves, not their polylines
- 11a89713c brett19: Merge fixes from the first SMLib test pass
- 48fcb7aac brett19: Merge fixes from the ui test pass and the gates
- abd739855 brett19: A silhouette takes its facing from the surface's normals
- 85114c5a2 brett19: Clippy and rustfmt on the merged tree
- 55a46569f brett19: Stepwise open checks every feature under the session's mode
- 4627402e4 brett19: Clippy without SMLib: the planar-sheet edge reader is built only with it
- 5fbece0ac brett19: STEP import: a ball's halves whose seams are off each other's quarter lines each form within one turn
- eb78d20b0 brett19: Lid ring sketch test: find the ring under the pick, not by main's kernel's name
- 3048d8c49 brett19: Viewport culling test: each box's triangles from its mesh, not 12
- dc88b80e2 brett19: Timeline chip test: a fillet that really reduces
- 876203621 brett19: Edge names: a seam names its one face once; the curve-id test reads every edge kernel-neutrally
- 900635710 brett19: rustfmt on the merged tree
- b7e83cd7c brett19: Known failing on SMLib: two of main's new tests assume truck's box mesh and fillet torus
- 63bde053a jyviko: Locales: Vietnamese for the setback-too-short refusal, now that vi is a complete catalog
- 967a1caa6 brett19: Kernel rig: exact volumes for 1213's bent-tube round and 4782's bar round, rel 1e-6
- 82c821d2a brett19: After the merge: clippy's auto-deref, and the mesh-decisions list for the merged tree
- 5862ee223 brett19: After the merge: main's new tests on the SMLib kernel
- be78372b2 brett19: Twisted sweep: circles about a straight path are exact cylinders (solidcore#2184)
- 312d14500 jyviko: After the merge: a hole that misses is found by exact boxes; a face is a one-face patch; main's mesh-box helpers gone
- 6f7e51acb jyviko: After the merge: split_move's Result reaches its callers; to_local's duplicated move check goes
- 8f0c79b20 jyviko: After the merge: main's two new tests take world_state's Result, as the rest of their files do
- 5f4d70061 jyviko: After the merge with main: its new code on develop's exact bounds, types and thread fields
- 2b2ab6627 jyviko: Cargo.lock: develop's profile, smlib and step crates at main's 0.30.1
- e6a4b0a9a jyviko: Kernel rig: main's six new sketch-only commands are exempt from a kernel case
- 5acbd2e71 jyviko: Cuts leave the bodies their tools can't reach, by exact boxes (#10225 on exact geometry)
- d2b202307 jyviko: Kernel rig: main's new view, rendering, appearance and settings commands are exempt from a case
- 21db090ba jyviko: Kernel rig: construct.plane.axis_point gets construction cases
- c1f45cae2 jyviko: Kernel rig: assembly cases for mass properties, align, find limits and moving items between parts
- 084695416 jyviko: Kernel rig: export and print face cases in the import area

Co-authored-by: jyviko <2501648+jyviko@users.noreply.github.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DtL5M41G8Nua7HvuFPZkmJ
2026-11-02 17:34:24 -05:00
..

Original SolidCraft studio scenes

These are editable command recipes, not imported models or triangle meshes. Every part is authored here from sketches, extrusions, primitive solids, boolean cuts and swept pipes. There are no manufacturer logos, copied product assets or external textures. author_scene.py is the optional local authoring tool; the application reads the emitted JSON without Python.

Lighting study

stage1.json is a five-body study of a hollow rounded black shell, an exploded lid, a chrome sphere and puck over a real floor. stage1-render.json supplies three rectangular softboxes and a neutral environment, with no clear-coat or transmission overrides. This separates lighting review from material review.

Exploded coffee machine

coffee-exploded.json contains 32 named B-rep bodies. The cylindrical brewing head has an open horizontal bore, separate collar, recessed shower screen and capsule slot in its floating roof. A round swept chrome lever has ball ends. Other parts include a hollow D tank and detached matte lid, a hollow ribbed bin, D drip tray, a 42-hole stainless grate, rounded cap, nine-slot/four-hole service panel, eight slotted zinc screws and an S cable ending in a two-pin plug.

The tank is cut from one extruded solid, leaving 3 mm walls and a 4 mm base. Its semicircle is a 64-chord editable sketch: maximum outer radial deviation from the ideal 43 mm circle is 43*(1-cos(pi/128)) = 0.01295 mm. This is a deliberate geometry fixture approximation. The analytic-arc version produced unpaired tessellation edges at the current 1e-6 mm dielectric topology check; we did not relax that check or repair the renderer mesh silently. The emitted tank has 532 triangles with paired opposite directed edges; the bin has 178. Both pass an independent OBJ edge check at the same 1e-6 mm position precision. These counts describe the baseline CLI and are to be rechecked after integration.

coffee-exploded-render.json adds seven coated-plastic bodies and two closed dielectric bodies. Body indices and names are both explicit and must match render.scene; editing the body list requires regenerating those indices. Smoky brown tank absorption is [0.045, 0.075, 0.12] per mm at IOR 1.586; the bin is nearly colourless at IOR 1.49. The black lid is opaque and matte. Metal is isotropic GGX; the grate is satin, not a claim of anisotropic brushed shading.

Both render requests are 1920 by 1080, use an explicit front-left camera 30 degrees above horizontal, and have no lens override or depth of field. Three large area lights and a neutral environment illuminate a real white-grey floor. The floor extends beyond the camera's horizon intersection and fills the image; it is a finite large studio floor, not an infinite-plane/shadow-catcher feature.

For a true cyclorama, stage1-sweep.json and coffee-exploded-sweep.json replace only that floor with an extruded, closed YZ cross-section. Its exact circular inner curve is tangent to the horizontal floor and vertical wall; the concentric outer curve gives constant thickness. There is no geometric crease or separate floor/wall overlap at either join. author_sweep.py regenerates these variants from the baseline recipes. Use the corresponding baseline render request; all object, light and camera coordinates, appearances, body names and body ordinals are unchanged.

The stage1 sweep is 3000 mm wide, with a 4 mm thickness, a floor starting at y=-1500, a 200 mm inner radius starting at y=250,z=0, and a rear wall at y=450 rising to z=1500. The coffee sweep scales these dimensions by 2.8: 8400 mm width, 11.2 mm thickness, floor start y=-4200, a 560 mm curve starting at y=700,z=0, and wall y=1260 rising to z=4200. Both are real shadow-receiving opaque CAD solids, not image backplates. Integrated GPU comparison determines the final lighting presentation; existing flat-floor evidence remains separate.

materials.json maps semantic names to intended material classes. Saved appearances remain the opaque PBR preview. Runtime optical controls belong to the render request, independently of engineering material properties.

Geometry review

The recipes were initially replayed and saved with the compatible pre-existing CLI during authoring. The integrating worker rebuilds the exact source and repeats replay, geometry checks and GPU preflight before publishing render evidence. Reference volumes below are calculated from the authored dimensions; the measurement command integrates a tessellation, so a relative tolerance of 0.0003 is appropriate for these isolated checks.

Body Analytic volume, mm³
Coated curved shell 65805.30723760049
Floating coated lid 25908.18530717959
Chrome sphere 102160.40430453529
Chrome floating puck 12666.901579274047
Open brewing head 265024.75625683495
Perforated stainless grate 15815.487854690262

For the tank use the polygon area, not the ideal circle: with D(r,b)=2*r*b+32*r*r*sin(pi/64), its volume is 171*D(43,45)-167*D(40,42). Every body must have positive finite measured volume and one kernel shell; transparent boundaries additionally require paired opposite edges, one connected triangle shell and positive signed volume.

Example replay (outputs belong outside the repository):

solidcraft-cli run examples/studio/coffee-exploded.json --save coffee.sc
solidcraft-cli eval coffee.sc --json-out coffee-measurements.json

Use the evidence runner with the paired render-request JSON to capture runtime lighting/material controls. The plain render CLI does not load that JSON as its request automatically.

Thick tumblers in an original room

tumblers.json is a separate 69-body scene. Two thick, open, tapered glass tumblers rest on a dark walnut table, with a filleted upholstered sofa, soft rectangular cushions, a potted plant, and a real slatted window behind them. author_tumblers.py defines every dimension. The glass is made by revolving closed radial sections: tall outer radii 36/42 mm and height 112 mm, 4.5 mm walls and a 9 mm bottom; short radii 37/43 mm and height 94 mm, 5 mm walls and a 10 mm bottom. These are analytic curved B-reps, not polygon replacements.

tumblers-render.json supplies a warm small area light behind the blind slats, two broad fill panels, two closed dielectric overrides and a thin lens. It is 1920 by 1080, with a 5.5 mm aperture radius and 670 mm axial focus distance. The blind shadows require real light transport; the recipe contains no painted shadow texture. tumblers-materials.json lists semantic material classes and suggested world-coordinate texture projections. The scene's saved walnut and linen appearances are plain colours: grain, woven texture and normal-map transport must be provided by the integrating renderer and are not implied by these material names.

tumblers-sun.json and tumblers-sun-render.json are a separate daylight variation; the original studio-lit recipe and request are unchanged. The only geometry change is a real 1850 by 1080 mm opening through the rear wall at x = -1450..400, z = 760..1840. Without this opening, the intact rear wall would occlude the infinite sun even where rays passed between the modelled blinds. The sun points toward [-0.4, 1, 0.4], has a finite 0.00465 rad angular radius, and uses warm radiance [18000, 16500, 14000]. An original procedural sky gradient supplies cooler fill; it is an artistic gradient, not an atmospheric simulation or an imported environment photograph. No extra area lights are used in this variation. The camera, lens, glass and sample settings are retained.

From the table point [0, 0, 480], the central sun ray reaches [-576, 1440, 1056] at the blind front and [-800, 2000, 1280] at the rear-wall opening. The ray is above the sofa; the blind slats, 12 mm thick and 45 mm apart, therefore produce real directional shadow stripes on the table. Their 52 mm depth also affects the occluded band width. Finite-disk softness and the final visible pattern must be checked in a GPU render; these analytic coordinates do not substitute for it.

On the authoring baseline the two tumbler meshes have 4856 and 4160 triangles. Independent topology checks using Euclidean 1e-6 mm seam matching find zero unpaired directed edges. Rounded integer keys alone rejected a few points on opposite sides of a quantization boundary despite their sub-tolerance distance. The accompanying renderer fix searches adjacent cells at the same tolerance; it preserves original vertices, winding and connected-shell checks. Integration must rerun those tests and GPU admission before claiming this scene rendered.

All three scenes have positive finite measured volume and one kernel shell per body on the authoring baseline. The evidence report must state the exact rebuilt source and backend; the initial CPU snapshots are composition checks only.

Runtime showcase requests (render validation pending)

First generate the original local resource files from the repository root:

python examples/studio/author_showcase.py

The source tree contains generators, editable scenes and runtime requests only. The four PNG maps and RGBE gradient are generated on demand into ignored paths in examples/studio/textures; they are not committed source assets. A fresh checkout must run this command before replaying a textured or HDR showcase request. The script uses only Python's standard library and downloads nothing.

Run the production studio_evidence example from the repository root so its scoped VFS resolves these generated relative resource paths. Rendered outputs belong outside the source tree and may be published only as evidence on the results branch. Use these pairs:

Scene recipe Runtime request Lighting
tumblers.json tumblers-textures-render.json Three finite studio panels and constant fill
tumblers-sun.json tumblers-sun-textures-render.json Finite sun through actual window/blinds and original procedural sky
tumblers-sun.json tumblers-hdr-textures-render.json Same finite sun and authored RGBE sky fixture

These requested settings are not a completed visual milestone. The requests use 1920x1080, 2048 samples, depth16, seed1948, one final aces_fitted output transform, 5.5mm aperture radius and 670mm axial focus. The two closed glass tumblers explicitly enable shadow_transmission. Their matching *-blocked-render.json controls differ only by setting those two flags false. This isolates the optional straight shadow connection; it is not a refracted-caustic solver. Physical camera/reflection/refraction paths remain active.

Thirteen opaque body bindings add the original walnut and woven-linen colour and OpenGL normal maps. Their 26MiB normalized pixels are below the32MiB texture cap. Mapping uses explicit planar world frames; the normal maps do not model yarn geometry and the side faces are not triplanar. Glass stays smooth and unmapped. See texture provenance and textures/manifest.json.

The locally generated HDR file contains only an original analytic gradient, sampled at512x256 and quantized to Radiance RGBE with declared linear-sRGB/D65 primaries. It contains no sun disk or downloaded imagery. The separate finite sun remains identical between the procedural-sky and HDR requests. RGBE quantization means these two inputs need not produce byte-identical renders. textures/environment-manifest.json records its hash, dimensions and authoring parameters.

Regenerate the original room with python examples/studio/author_tumblers.py and the textures/HDR/portable requests with python examples/studio/author_showcase.py. These scripts use Python's standard library. They do not modify the coffee or stage1 recipes. Source validation and asset hashes do not constitute GPU evidence: the final report must include the actual backend, rebuilt source, full-resolution image, metadata and matched blocked-shadow control.