selune
a261aaa841
Lands the Render workspace (R3), bounded preview-image jobs with cancellation and atomic PNG export (R4a), and opaque PBR looks as one change. - Render workspace: an overlay-free product preview on the installed GPU device. Returning to Design restores its camera. render.scene and render.settings.apply are added. - Image jobs: render.preflight/start/status/cancel/export run bounded CPU preview jobs. Export captures the job, overwrite choice and document, and checks the caller's file scope before writing. - Opaque PBR: looks can carry metal fraction, roughness and dielectric IOR. The product viewport and preview PNG use them; geometry and mass are unchanged. The v1 catalog export refuses PBR rather than dropping it. - Render setups and PBR looks are saved under design format 21. Labels are in en/de/ja/ko/zh/ru. Supersedes #706 and #800. Refs #620, #673, #756, #1004. Contributed by @0xlillith. Co-authored-by: lillith <[email protected]>
89 lines
5.3 KiB
Markdown
89 lines
5.3 KiB
Markdown
# Opaque product surfaces
|
||
|
||
This is the first integrated consumer slice of #1004, under #813/#620. It uses the
|
||
existing Render workspace, product geometry, appearance assignment and PNG job host.
|
||
There is no second renderer or external material dataset.
|
||
|
||
## Apply and preserve a response
|
||
|
||
```json
|
||
{"command":"appearance.assign","params":{"bodies":["Specimen"],"color":"#b47846","pbr":{"metallic":1,"roughness":0.3,"dielectric_ior":1.5}}}
|
||
```
|
||
|
||
The Appearance editor has an **Opaque PBR** checkbox and separate Metallic,
|
||
Roughness and Dielectric IOR fields. Enabling it explicitly sets opacity to one.
|
||
View the response in Render or export a product PNG; Design retains its simple
|
||
color preview. Apply/OK, swatch reuse and component/face targeting use the existing
|
||
assignment command. A later scalar face override replaces a body's PBR response
|
||
on that face; it does not inherit the optical response implicitly.
|
||
|
||
Parameters are finite and bounded: metallic [0,1], perceptual roughness [0.045,1],
|
||
relative dielectric IOR [1,3]. Unknown optical fields and nonnumeric/out-of-range
|
||
opacity refuse before changing the design. PBR requires opacity exactly one.
|
||
IOR controls the nonmetal fraction's reflection; it does not enable refraction.
|
||
Omitting `pbr` or supplying null in an appearance assignment selects the previous
|
||
scalar response. Assignment replaces a look; it is not a partial parameter patch.
|
||
|
||
`material.create/edit` accept the same optional `pbr` block alongside a default
|
||
appearance/color. A density-only edit retains the entire existing look. Visual
|
||
response changes do not modify density, geometry, placement or engineering axes.
|
||
No grade-specific optical or mechanical values are inferred from a name or color.
|
||
|
||
Format **21** saves `pbr` inside existing body/face/component and material-default
|
||
looks. Missing fields retain scalar shading. Format-20 render setups and old looks
|
||
upgrade without reinterpretation; older readers refuse newly saved files instead
|
||
of dropping their optical response. Undo/redo, copying and cold reopening use the
|
||
existing design-owned values, with no external file dependency.
|
||
|
||
The current scalar catalog v1 cannot represent PBR. Conversion/export refuses a
|
||
PBR look or physical-material default instead of silently dropping its parameters.
|
||
In-design swatches retain and reuse the response. A richer catalog version remains
|
||
a separate integration step.
|
||
|
||
## Actual consumers and color
|
||
|
||
The installed integrated `gpu-viewport` and `cpu-product` image hosts advertise the
|
||
`pbr` feature. Requests require it when the captured product scene contains PBR.
|
||
The static legacy `cpu-raster` descriptor retains its previous capabilities.
|
||
No host gains HDRI, refraction, progressive/final rendering or EXR support.
|
||
|
||
Look colors are decoded from sRGB8 to linear sRGB once in the shared document/scene
|
||
adapter. PBR GPU vertices carry linear reflectance and optical parameters. The CPU
|
||
rasterizer interpolates world position and normals with perspective correction;
|
||
the GPU uses the corresponding fragment interpolation. Both use the original
|
||
[opaque BRDF](render-surface.md) and three fixed neutral directional lights in Z-up
|
||
world coordinates. They sum BRDF × relative incident radiance × light cosine,
|
||
apply per-channel Reinhard preview tone mapping, then encode exactly once.
|
||
Linear and sRGB GPU attachments have distinct output transfer paths.
|
||
|
||
This fixed studio has no cast shadows, environment illumination, indirect bounces,
|
||
emission, anisotropy, coating, absorption or transmission. Lighting magnitudes are
|
||
relative preview values, not calibrated lux or spectral data. The single-scattering
|
||
model can darken rough metals. Transparent legacy looks retain approximate sorted
|
||
alpha blending, including when seen in front of an opaque PBR surface; that is not
|
||
glass optics. Nondefault exposure/environment controls remain explicitly unsupported.
|
||
|
||
Scene uploads keep the 128 MiB bound, accounting for the larger PBR vertices.
|
||
CPU face-map admission accounts for retained optical descriptors. Existing immutable
|
||
capture, ownership, cancellation, stale-result rejection and PNG export policies
|
||
remain in effect. Invalid/nonfinite geometry or zero input normals refuse.
|
||
|
||
## Validation and original example
|
||
|
||
`examples/render-opaque-studio.json` builds four original spheres and a base,
|
||
varying metallic fraction and roughness independently while keeping base color.
|
||
Its values are an illustrative optical study, not engineering data for real grades.
|
||
|
||
The product offscreen test uses the actual installed callback/pipelines on Vulkan,
|
||
including both linear and sRGB attachments. For four metal/roughness combinations,
|
||
each comparison checks 12,454 interior pixels against CPU PNG output; observed mean
|
||
channel error is below 0.2/255, with no pixels beyond the 12/255 outlier threshold.
|
||
Silhouettes are excluded because CPU images use 2x supersampling and that test's GPU
|
||
target uses 1x. This is a scoped parity result, not browser or universal GPU certification.
|
||
|
||
Command tests check unchanged geometry/mass, atomic refusal, undo/redo, cold reopen,
|
||
physical default/face precedence, retained scalar format-20 looks upgraded to 21 and explicit v1
|
||
catalog refusal. A clicked editor regression checks one transaction and reopening
|
||
the same selected body. Native media and exact current-head gate results belong
|
||
in the PR. wasm compilation and actual browser interaction are separate evidence.
|