Files
solidcraft/docs/render-materials/AGING-EFFECTS-SHOWCASE-2026-10-23.md
T
9e6e0b8df1 Render workspace: complete experimental ribbon, resources and effects integration (#5493) (#5494)
* wip(render): reconcile completed material and image pipeline source with 0.20 (#5493)

Source-only integration reference for staged review, not a merge-ready aggregate.
Donor: 0xlillith/solidcraft@aea20b0115.
Upstream: 858e5995d6.

Retain original CPU/material contracts and explicit GPU donor provenance in
docs/render-materials-lab.md (#2067, #2191, #2780, #3306). Preserve released
format migrations and current navigation/startup/shell behavior. New saved
records use pending descriptors. The physical-card descriptor follows the
maintainer's material-engineering-cards naming request, with a legacy-lab
format-29 regression. Replace raw new panel hosts with shared containers.

Repository checks, complete workspace/all-target Clippy, and the independent
physical/resource authoring checks pass for this source. The fresh full local
CI invocation has reached test compilation and is not yet complete. Do not
transfer donor native output or prior test totals to this integration.

Generated review screenshots, video, package ZIP and machine logs remain at
the immutable personal evidence pin. Uncommitted geometric displacement is
backed up separately, not silently included. No kernel/vendor change, direct
main write, release or independent contributor-branch rewrite.

Co-authored-by: Christian Svensson <blue@cmd.nu>

* test(cli): pin the Compact camera-sample admission diagnostic (#5493)

The bounded request still refuses 1024x1024x64 samples before host initialization and writes no output. Update only the stale expected diagnostic to the existing Compact budget wording; production limits and code are unchanged. Exact-tree CLI regression suite: 14 passed, 0 failed. The full repository gate has been invoked separately and is not yet complete.

* Normalize UI container violation paths across platforms

Report repository-relative paths with forward slashes so diagnostics and the existing nested-package regression assertions agree on Windows and Unix. Keep the container detection rules unchanged.

Validation: official ui-containers gate and all seven focused xtask tests passed; rustfmt and diff checks passed. Only xtask/dependencies were compiled; no application build or heavy tests.
(cherry picked from commit 44b58d8e10)

* fix(render): preserve camera contracts and correct acceptance regressions (#5493)

Preserve Design view.apply semantics with a separate strict Render camera command. Retain existing translations when English-only aliases collide; add material-axis entries and camera-specific pitch labels. Compare complete validated engineering cards and retain job handles before cancellation.

Focused and native acceptance is pinned to tree f8a423b21f. Full CI has been invoked separately and is not claimed green. Landing follows the render integration policy in #5493.

* fix(render): resolve showcase licence and upstream resource hygiene (#5493)

Record SychPL's explicit MIT OR Apache-2.0 grant, retaining source/model bytes and the Ubuntu lettering notice. Remove 80 absent attribution rows, personal fork records, dead delivery attributes and three fork/resource-only workflows. Existing xtask assets now performs bounded offline hash checks and rejects orphan render attribution; no parallel draft CI or package installation. Original authoring reproduction remains explicit. Scoped xtask tests, assets, Clippy, formatting and prepared SELENE validation pass; no application or renderer-wide result is inferred.

* fix(render): align saved bounds and progressive sample resolution (#5493)

Address review r4364211669/r4364211677/r4364211681/r4364211691/r4364211695. Persisted light/frame domains respect the existing 1e9 document bound; related LED/rectangle/direction cases use the same bound. Workstation primary resolve shares the 4096 admission cap and film counters use checked conversions. Exact candidate: 485 CPU render tests, 21 render document tests and strict scoped Clippy pass, including positive boundary round trips and 2048/4096 end-to-end checkpoints. No released format/migration edits, relaxed test limits or full-stack acceptance claim.

* wip(render): isolate optional resources and harden sample handling (#5493)

Review work in progress: opt-in encoded render library with reproducible runtime catalog exports; native-only robust dependency through the workspace; checked bloom slices; per-sample point-light diagnostics; independent area-light spatial/film keys. Resource-module binaries in both configurations, generation, Cargo production feature graphs and attribution checks pass. Full engine/render regression and combined acceptance are pending: do not merge this donor as a constituent or treat scoped resource proof as runtime acceptance.

* fix(gpu): preserve donor allocations through the scope-safety repair (#5722)

Port the native-validated #5723 scope-cleanup correction into the experimental donor, retaining its adaptive, volume, aging, photographic and bloom allocations. Same reverse-drain helper and regression cases; the donor combination still needs its own compile/test gate and is not covered retroactively by render-base results.

* claim: #1369

* Reject unknown pending concepts after format folding (#1369)

* test(render): close bounded sampling and bloom review regressions (#5493)

Validate the optional-resource/lighting/dependency donor at its exact tree. Required Vulkan GPU 127/0/3; CPU renderer 487/0; engine Render 72/0; document render 21/0; lean library 7/0; strict scoped Clippy, assets/layers/lists/containers and lean-engine WASM pass. Preserve original failed controller/typing attempts. This is the draft donor/disposition source, not a replacement for constituent render PRs or final main acceptance.

* wip(render): preserve stable aging target validation candidate

Exact staged source from prior review work on donor 3b892eab5e. This is a recovery/review checkpoint, NOT accepted delivery. An actual command-path regression currently fails because the selected executor refuses ordered surface aging. No assertion, capability or admission limit is weakened. Native/UI/full combination acceptance remains pending. Saved/runtime split adds one pending descriptor and retains original file scope; no main/render branch is changed.

* test(render): preserve numeric setup intent at the admitted coordinate bound

Follow up jyviko review on #5494 without weakening the corrected saved-coordinate contract. The positive clicked fixture uses 1e9 instead of inadmissible 2e9; explicit out-of-range cases still refuse, and the full saved setup round-trips through JSON and the native container. Exact-source Render workspace 95/0 and strict all-target UI Clippy pass. This does not incorporate the separately failing stable-aging candidate or claim full current-render acceptance.

* test(render): use the real GPU executor for saved aging

Move successful native cold-reopen Check/Start coverage from the CPU-backed protocol fixture into the production GPU executor tests. Verify capture-index changes preserve the stable target and that enabling aging changes both PNG and raw EXR output. Retain explicit, allocation-free refusal coverage for executors without aging support. Production capabilities and admission checks are unchanged.

* fix(render): persist stable identities for targeted aging (#5493)

Separate saved RenderBodyTarget identities from captured mesh ordinals. Reject legacy ambiguous targets, resolve Check/Start after visibility changes and preserve native reopening, copies and undo. Unsupported executors still refuse; real AMD Vulkan regression completes saved aging after reordered capture.

Source tree 6b84c8ad passes document 23, engine Render 75, GPU effects 5 and Render UI 95 with no failures; scoped strict Clippy, WASM and repository gates pass. Fresh CLI/native reopen and clean/aged GPU exports pass with identical physical totals and inspected actual images. Whole current-render integration is separate.

* fix(render): reconcile combined CPU/GPU contracts on current upstream

Unify captured resources/status and CPU-vs-GPU request schemas after the real two-parent integration; remove obsolete duplicate Vulkan selector and retain combined platform-filter regression. Deduplicate only identical or superseded test definitions, retaining the stronger card metadata and reserved-executor assertions. No assertions, admission limits or feature refusals are weakened.

All targets of render dependencies, GPU, engine, UI, CLI and native app pass cargo check with raytrace-cpu and bundled-render-library at tree c70d00d1. Native executable tests and full current-source acceptance remain pending. This is a private integration rehearsal for subsequent constituent PRs, not an aggregate official render/main merge.

* test(render): retain one complete host lifetime regression set

Deduplicate byte-identical DropProbe/task-lifetime tests and retain the adapted environment/texture ownership regressions with every assertion and complete memory estimate. Keep the registered-geometry admission regression once; only struct field order differed. Replace a one-element diagnostic loop with its equivalent block, preserving all wrap/width assertions.

Test-only integration repair. Formatting and diff checks pass; refreshed executable validation is required. No production behavior, limits, assertions or ignores changed.

* fix(doc): recognize the proven format-29 card descriptor alias

Normalize only the historical format-29 physical-material-cards spelling, and only when material-engineering-cards is registered. Admission and migration de-duplication use the same identity. Unknown concepts, wrong versions and incapable readers still refuse before mutation. Six controlled-history Rust regressions and actual CLI migration/no-clobber acceptance pass. No version, released migration or CI changes. Refs #5793, #1369, #5493.

* test(render): preserve grounding refusal before explicit instance moves

Update the two Render binding fixtures for upstream first-occurrence grounding. Verify grounded movement refuses without changing document/history, then explicitly unground through the public command before the intended move. Retain every target, resource, copy and persistence assertion. Refs #5493.

---------

Co-authored-by: Christian Svensson <blue@cmd.nu>
Co-authored-by: Victor Santos Oliveira <56417388+Vittuu@users.noreply.github.com>
Co-authored-by: cfaulkingham <colin.faulkingham@gmail.com>
2026-10-24 14:21:59 +00:00

12 KiB

Layered aging, photographic effects and native showcase

Owner-directed integration work on lab/render-aging-showcase, draft PR #11, based on committed 8c3f72ca from the personal lab/render-scale-resources branch. The inherited uncommitted geometric-displacement work in the previous worktree is deliberately preserved untouched. Nothing here merges upstream, updates main, publishes a release or declares the entire advanced-material roadmap complete.

Layered surface aging

The saved GPU option aging is an ordered list of at most eight original procedural optical layers. Available starting recipes are iron oxide/rust, copper-green patina, deposited dust, grime, fine scratches, chipped paint and faded coating. Layers can be enabled, disabled, reordered or removed; each retains strength, coverage, world-millimetre pattern scale, deterministic seed, origin, colour, roughness, metallic fraction and upward-facing deposition bias.

The same modified material closure feeds direct and indirect GPU transport and the native denoiser guides. An enabled layer therefore changes the raw linear master as well as the displayed PNG. It does not rewrite source textures, engineering materials, mass, CAD geometry, model visibility or pose. Passive render-stage panels and transmissive surfaces are excluded. An explicitly named glass target refuses rather than being made opaque.

Targets are all eligible opaque bodies or an exact captured ordinal/name pair. Named targets must still match. The inline name is bounded to 256 UTF-8 bytes; the stack has fixed storage rather than an unbounded JSON vector. Fields are world-anchored, not occurrence-local animation bindings. The periodic coordinate domain is explicitly rebased for the GPU and limited to 4,096 repeats across a body. Choosing an excessively small scale refuses instead of silently changing the requested detail.

These are authored optical approximations, not measured corrosion kinetics, elapsed-year prediction, true grooves, displaced silhouettes, cavity detection or curvature-derived edge wear. The scratches are a dominant-axis projected pattern. A contamination layer also covers the earlier clear-coat weight where its mask applies. Material classes refer to the captured optical metallic fraction, never chemical identification.

Airborne dust is separate transport

The Aging inspector also links the existing finite homogeneous-medium editor. This is the previously implemented Beer/HG participating volume, not an additional surface layer or an image fog overlay. All explicit volume, glass, denoising and transmission-strata compatibility checks stay active. The UI does not disable incompatible options behind the user's back and never adds a physical atmosphere to a lunar scene automatically.

Creative looks

Up to eight ordered display-linear look layers can be combined with individual strength and enable state: monochrome, sepia, cyanotype-inspired, warm, cool, teal/orange, faded print and bleach-bypass-inspired. These are original numerical transforms, not imported commercial film LUTs or calibrated camera emulations. They run after tone mapping and before the existing contrast/saturation/vignette finishing.

Photographic and lens-inspired controls

The optional finishing.photographic object provides highlight-driven flare, ghost rings, a halo, horizontal anamorphic-style streaks, radial chromatic edge offsets, radial distortion, soft focus, sharpening and deterministic grain. Flare source discovery uses at most four separated high-luminance points from the actual scene-linear image, with an explicit linear threshold. No arbitrary screen light is inserted when there is no source above that threshold.

Spatial sampling is performed in decoded display-linear RGB, not by interpolating encoded sRGB values. Source sampling extends image edges. These artistic spatial effects currently require opaque output: a transparent request is refused, not silently flattened. Original raw EXR bytes bypass the entire display path. Depth of field remains the separate physical thin-lens control; the new flare/distortion controls are not a calibrated optical-element simulation.

The processing work is split into cancellable bounded quanta. Additional output/scratch storage is explicitly admitted before rendering or retained-master regrading. The source image and original master leases are retained until publication, and partial photographic results are never exported as completed frames.

UI and commands

The shared inspector now has local Aging and Effects pages alongside the existing model/material/light/environment/camera/output sections. It reuses Nateaux's shared sections, lists, dropdowns, numeric and colour fields, buttons, icon strip and existing original SVG aliases. There is no parallel widget or icon library.

render.aging.describe and render.effects.describe are read-only registry commands with schema/recipe descriptions. Activating them from the ribbon or command search opens the corresponding editor rather than silently applying a preset. Numerical edits belong to the same draft and are persisted by the existing Save workflow. Source EXR, immutable selected result identity and the asynchronous export guards are unchanged.

The standard render.result.regrade action can apply looks and photographic effects to a selected retained master without reevaluating geometry or tracing new rays. Denoising is still not reapplied to a raw master because its geometric guides are not retained. Aging layers require a new render because they change the actual surface closure.

Showcase provenance

The requested MP4 will contain only actual native application captures and actual SolidCraft-produced renders, with clearly labeled editorial transitions, captions and before/after comparisons. No generated illustration or repainted substitute can stand in for renderer output. Any edited video camera motion is a presentation move over a still frame, not evidence of real-time rendering or a simulated model animation. Final resolutions, sample counts, immutable PNG/EXR hashes, source revision and video checksum must be recorded after execution.

Video assembly tooling remains isolated outside the application dependency graph. No fonts, executable or video tool binaries are redistributed in the showcase package. The language-neutral renderer schemas and original English source remain unchanged by localized UI labels.

Acceptance status at implementation checkpoint

Static validation of the combined path shader and denoiser-guide shader passes with a 1,168-byte parameter layout. This is not native GPU execution evidence. Tests cover bounded layer storage, hostile input, reorder/disabled identities, periodic field rebasing, look order, deterministic photographic quanta, cancellation, transparent-output refusal, exact raw-master preservation, native layer execution and UI save/reopen behavior. The numerical, native and visual results must be filled in from actual runs; they are not inferred from these test sources.

Background usability and delivery closure

The Backgrounds ribbon previously led only to physical stage controls on the Scene page, while camera colour/gradient controls were elsewhere under Environment. It now leads to a dedicated shared-kit Backgrounds page containing camera presentation, physical stage controls, an exact-master regrade action and a separate HDR-library link. Merely navigating does not change a shot, renderer or document.

The page explicitly explains that a completed image is immutable, Live Preview is a modelling view, and a large physical floor/wall can hide a camera-only backdrop. A gradient affects only uncovered camera pixels; it does not recolour the lighting, replace visible geometry or turn the HDR into a panoramic background. Transparency remains explicit. Physical-stage replacement still requires consent.

A real numerical-draft loss bug was also corrected: clearing a physical stage now forwards the current complete draft to the registered clear-stage command, rather than restoring other values from an older saved shot. Stage controls no longer nest a second same-titled section. Regression sources check navigation, nonmutation and exact preservation/reopen of unsaved camera background, exposure and output dimensions.

On the frozen native producer 9f8c3d30, actual 1920x1080 background images completed: no-stage neutral and radial-gradient presentations share an identical raw EXR; the two-panel floor/wall and 26-panel polygonal cyclorama change the raw transport and retain the same subject/camera. These are real native renders, not video-editor substitutions. Their source/header hashes and visibility limitations are retained in the delivery manifests. The new UI-only build/acceptance and the final video/package checks are recorded separately after execution.

Final delivered showcase and background acceptance

The requested MP4 is complete, decoded end-to-end and visually reviewed through encoded chapter/transition frames. It is 1920x1080 at 30 fps, 122.0 seconds, 11,467,697 bytes. SHA-256: 227ecf8d5dc15ef9b7bbafb1d56ff239ce88b5b01e9488d6a9d96c25fcf401e4. It contains actual native render output and actual UI captures, English collaborator captions, comparison wipes/crossfades and an original low-level synthesized soundtrack. This is an edited demonstration, not real-time rendering, physical animation or generated-image substitution.

The media is consumed by assets/render/showcase/aging-effects-20261023/README.md, with exact source/frame manifests, selected native PNGs and screenshots. The same directory contains the editable 43-body sample and thirteen production/background shot recipes. distribution/SolidCraft-Render-Showcase.zip packages the selected delivery. No font files, application/encoder executables, control credentials, personal preferences, draft images or raw intermediate EXR pile is distributed.

Backgrounds are shown explicitly in three chapters: solid versus radial-gradient presentation with identical EXR; floor/wall versus 24-strip cyclorama with genuine transport/shadow/reflection changes; and the new shared-kit Backgrounds control page. The interface now explains stage occlusion, frozen completed results, separate HDR illumination and transparency. The documented clear-stage draft-loss bug is fixed and covered by clicked save/reopen regression.

The new UI checkpoint 9bc71b298719bbe62e1bdbc49eba45f6863e55d0 passed the focused Render workspace suite (93 passed, zero failures), ribbon tests (27), localization (29), kit guards (16), strict workspace/all-target Clippy, a fresh application build and the official twelve-crate WASM gate. The actual new native window used the Backgrounds ribbon, changed a gradient through its real controls, regraded its exact raw master without changing EXR, and applied/cleared the physical cyclorama. Both native windows saved and reopened all thirteen canonical shots and closed normally with exit code zero, without OS termination. The older window's documented preference-hash baseline follows its control reconnection; both used isolated profiles.

The original nine render results retain producer 9f8c3d30 and the four background images use that same unchanged transport producer. Later changes were the exact-packing regression correction, Backgrounds UI and delivery/documentation. All producer and binary identities are distinguished in sources.json and the validation receipts. Core acceptance remains 482 CPU-feature passes, 271 default-feature passes and the corrected hardware GPU suite of 115 passes / zero failures / three explicit ignores. These are separate suites, not an inflated aggregate count or whole-project CI approval.

Remote Actions observations remain in validation/remote-actions.json; no enabled/disabled setting or branch protection was changed to obtain a badge. This completes the requested background review, native save/reopen/close and audiovisual delivery. It does not mark arbitrary unimplemented advanced material concepts, the entire renderer roadmap, upstream merging or a release as complete.