solidcraft/assets/render/selene/materials/appearance-pack.md

SELENE original appearance pack

Forty-eight original appearance recipes are prepared for the current opaque PBR command path. Every recipe has a directly copyable, model-independent baseline and a separate advanced target specification. The pack contains no measured material dataset, external artwork, engineering material properties or runtime implementation.

Files and status

File	Purpose
appearance-pack.json	Editable authority for 48 recipes, their opaque projections and future target requirements. This is authoring data, not a native portable library file.
appearance-swatches.json	Prepared command script with 48 labeled box swatches and one neutral support base. It uses the existing file.new, solid.box and appearance.assign command shapes.
appearance-pack.md	Contract, use, limitations and recipe index.

The authoring step checked JSON structure, ID/name uniqueness, catalog and capability references, numeric admission bounds, exact runtime parameter keys, and every swatch assignment against the recipe authority. No SolidCraft runtime was executed and no rendered image was visually reviewed during authoring. The script is a prepared input whose execution and render admission must be verified on the selected build.

Runtime projection contract

Copy items[].baseline_projection.runtime_parameters, then add an existing target selection before calling appearance.assign. The projection includes appearance, color, opacity: 1 and exactly three PBR fields: metallic, roughness and dielectric_ior. Targets are deliberately absent because the improved SELENE source model must be pinned and inspected before binding.

{
  "command": "appearance.assign",
  "params": {
    "bodies": [
      "Existing target body"
    ],
    "appearance": "SELENE-AP-001 Neutral matte enclosure",
    "color": "#717882",
    "opacity": 1.0,
    "pbr": {
      "metallic": 0.0,
      "roughness": 0.68,
      "dielectric_ior": 1.5
    }
  }
}

The body name in this example is a placeholder, not a ready-to-run model binding. The current command also accepts face points and components. An occurrence name supplied as a component target resolves to its component definition; do not assume an independent occurrence override. Face overrides take precedence over broader appearances. Assigning a look replaces it: omitting pbr later restores the scalar response instead of retaining these fields.

Current bounds are metallic 0 to 1, perceptual roughness 0.045 to 1, relative dielectric IOR 1 to 3, and opacity exactly 1 for PBR. Colors are sRGB8 hex values decoded by the existing renderer. All values here are original illustrative authoring choices. The common IOR control of 1.5 is not a measured value; it controls reflection of the nonmetal fraction and does not enable transmission. The metal recipes use metallic 1 and the dielectric recipes use metallic 0; no mechanical or electrical properties follow from either choice.

The pack JSON is not solidcraft-library/1 and cannot be passed directly to library.inspect or library.apply. That scalar library format cannot preserve PBR. Use the prepared script, an explicit appearance overlay, or a native format-21 design. A future catalog importer needs its own versioned admission contract.

Prepared swatch script

The 48 swatches are 12 x 12 x 8 mm boxes in 8 columns and 6 rows with an 18 mm pitch. Their lower corners run from x = -69 mm to 57 mm and y = -51 mm to 39 mm, starting at z = 1 mm. A 144 x 108 x 1 mm base sits below them. IDs ascend along x within each row, then along y. Body names carry the recipe ID and English name; there is no text geometry, font, decal or external asset.

The script contains 99 commands: one new design, 49 boxes, and 49 appearance assignments. Flat boxes intentionally bound tessellation demand; they are an inspection grid, not a complete optical validation target. A curved reference, an angular light sweep, and close-up geometry remain necessary for validating highlights, anisotropy and layered targets when those functions exist.

Prepared commands for a built native CLI, run from the repository root:

mkdir -p target/selene-render
solidcraft-cli run assets/render/selene/materials/appearance-swatches.json --save target/selene-render/appearance-swatches.solidcraft --results --json-out target/selene-render/appearance-swatches-results.json
solidcraft-cli render target/selene-render/appearance-swatches.solidcraft --out target/selene-render/appearance-swatches.png --width 768 --height 576

These commands have been prepared, not executed. The render CLI automatically fits a camera when none is supplied. Existing output is protected unless --overwrite is explicitly provided. Keep local render evidence under ignored target/; this pack does not bundle unreviewed preview exports.

To style a pinned SELENE design, prepare a separate overlay containing only appearance.assign commands with verified target names, then run:

solidcraft-cli run target/selene-render/verified-appearance-overlay.json --in path/to/pinned-selene.solidcraft --save target/selene-render/selene-styled.solidcraft --results

Both input paths above are placeholders until the model and overlay are prepared. The overlay must contain no file.new, geometry edits, physical-material edits, joint edits or pose changes. Native save is the preservation path. timeline.export_script currently omits appearance overrides and refuses component/joint assemblies; it is not an appearance or articulated-model round-trip mechanism. A multi-command script stops at the first error and is not a whole-script transaction, so verify targets before applying it to the review copy.

What the baseline can show

The current Render consumer supports opaque direct-lit responses under three fixed neutral directional lights, with the existing preview tone mapping and PNG export. It does not implement the textured, layered, transmissive or emissive targets described here. Current consumers have no cast shadows, environment illumination, indirect bounces, surface coating, anisotropy, absorption or transmission. Saved nondefault environment/exposure intent is not executable by this baseline. These limits are documented in docs/render-opaque-pbr.md and docs/render-jobs.md.

Advanced targets remain separate authoring data. Their numeric controls are illustrative texture or geometry settings in millimetres, radians or explicitly named dimensionless units. They are not manufacturing recommendations or measurements. Optical spectra, refractive data, layer thicknesses and scattering coefficients remain unspecified where the recipe lists missing inputs. CAP references link to requirements in capabilities.json, not to a claim of implementation.

SELENE-specific fidelity boundaries

• The sample vial, optical window and diffuser recipes are explicitly opaque inspection surrogates (AP-029, AP-030 and AP-039). They do not show glass, refraction or light transmission. Transparent containers need closed wall geometry and correct interior/exterior medium handling before the advanced target can be represented.
• The unpowered LED face (AP-038) emits no light. Active LEDs require a separate emission model; spectrally excited phosphor conversion additionally requires excitation, conversion and emission data. Ordinary RGB emission must not be labelled fluorescence.
• The black and silver anodized recipes (AP-015 and AP-016) are simplified outer-response surrogates. Actual anodizing combines a dielectric or absorbing oxide with a metal substrate; a single metalness value is not that layer model.
• Blanket folds (AP-018 and AP-019), honeycomb walls (AP-040), mesh-wheel openings (AP-044), serrations and threads require geometry. Color or roughness alone cannot provide their silhouettes, empty space or self-shadowing.
• Lunar terrain and deposits (AP-041 to AP-043) are granular surfaces in vacuum. The dust-patch baseline belongs on separate deposit geometry or a deliberately bounded face. Applying it to an entire rover body does not reproduce sparse dust coverage. No terrestrial fog, wetness or aerial perspective is implied.
• Appearance assignments do not define density, stiffness, friction, thermal emissivity, electrical performance, leak tightness, cleanliness, ESD behavior or flight readiness. They must leave the improved model geometry, articulation, joint limits and motion data intact.
• The automotive rubber sidewall (AP-048) is a representative terrestrial material target. Do not substitute it for the SELENE open metal wheel (AP-044) merely because both are wheel-related.

Recipe index

All entries use opacity 1 and the illustrative IOR control 1.5. M is metallic fraction; R is perceptual roughness. The catalog link is semantic traceability to the 600-recipe planning catalog, not an imported texture or measured asset.

ID	Original recipe	Catalog source	sRGB color	M	R	Baseline role
SELENE-AP-001	Neutral matte enclosure	MAT-031	#717882	0	0.68	opaque surface
SELENE-AP-002	White thermal-coating preview	MAT-491	#d9dde0	0	0.58	opaque surface
SELENE-AP-003	Matte optical baffle	MAT-468	#141619	0	0.94	opaque surface
SELENE-AP-004	Ceramic gripper contact pad	MAT-574	#d9d7cf	0	0.32	opaque surface
SELENE-AP-005	Machined aluminium wheel rim	MAT-561	#b9c0c7	1	0.29	opaque surface
SELENE-AP-006	Serrated metal gripper jaw	MAT-573	#a6adb5	1	0.40	opaque surface
SELENE-AP-007	Linear-brushed stainless housing	MAT-002	#b8bdc2	1	0.34	opaque surface
SELENE-AP-008	Polished stainless sample cup	MAT-593	#c9ced3	1	0.16	opaque surface
SELENE-AP-009	Titanium wrist finish	MAT-572	#8b9098	1	0.43	opaque surface
SELENE-AP-010	Exposed copper conductor	MAT-164	#b97850	1	0.27	opaque surface
SELENE-AP-011	Machined brass printer nozzle	MAT-391	#b4a06b	1	0.30	opaque surface
SELENE-AP-012	Solidified solder joint	MAT-165	#bec3c6	1	0.25	opaque surface
SELENE-AP-013	Metal sampling scoop	MAT-575	#9ba4ad	1	0.44	opaque surface
SELENE-AP-014	Gold-finished contact pad	MAT-163	#bf9c49	1	0.21	opaque surface
SELENE-AP-015	Black anodized chassis surrogate	MAT-567	#252a30	0	0.56	opaque surface
SELENE-AP-016	Silver anodized cover surrogate	MAT-015	#abb3ba	1	0.39	opaque surface
SELENE-AP-017	Composite arm tube surrogate	MAT-571	#252a2e	0	0.42	opaque surface
SELENE-AP-018	Aluminized blanket metal face	MAT-501	#c3c8cd	1	0.18	opaque surface
SELENE-AP-019	Polyimide-facing blanket surrogate	MAT-502	#80602e	0	0.30	opaque surface
SELENE-AP-020	Solar-cell opaque preview	MAT-511	#172b43	0	0.24	opaque surface
SELENE-AP-021	Silicone cable jacket	MAT-333	#484d56	0	0.77	opaque surface
SELENE-AP-022	Polyimide harness wrap	MAT-332	#9d713d	0	0.46	opaque surface
SELENE-AP-023	Fluoropolymer sealing ring	MAT-598	#dbddd7	0	0.49	opaque surface
SELENE-AP-024	Elastomer seal candidate	MAT-599	#26292b	0	0.86	opaque surface
SELENE-AP-025	Opaque sample cassette body	MAT-595	#424a54	0	0.54	opaque surface
SELENE-AP-026	Textured ABS instrument shell	MAT-042	#59616b	0	0.64	opaque surface
SELENE-AP-027	Powder-printed polyamide preview	MAT-175	#abb0b1	0	0.87	opaque surface
SELENE-AP-028	FDM top-skin preview	MAT-171, MAT-361	#aab5bd	0	0.46	opaque surface
SELENE-AP-029	Sample vial opaque inspection surrogate	MAT-582	#91a2ae	0	0.35	opaque inspection surrogate
SELENE-AP-030	Window opaque inspection surrogate	MAT-583	#537286	0	0.24	opaque inspection surrogate
SELENE-AP-031	Matte ceramic sample insert	MAT-594	#c9c5bb	0	0.59	opaque surface
SELENE-AP-032	Threaded metal closure cap	MAT-596	#b6bcc3	1	0.31	opaque surface
SELENE-AP-033	Graphite thermal-sheet preview	MAT-349	#35383d	0	0.91	opaque surface
SELENE-AP-034	Solder-mask board face	MAT-161	#32624b	0	0.42	opaque surface
SELENE-AP-035	Exposed glass-epoxy board edge	MAT-162	#9b9270	0	0.77	opaque surface
SELENE-AP-036	Molded epoxy component body	MAT-166	#252727	0	0.80	opaque surface
SELENE-AP-037	Battery-can metal preview	MAT-341	#b3bbc3	1	0.35	opaque surface
SELENE-AP-038	Unpowered LED phosphor face	MAT-441	#d6bd64	0	0.65	opaque surface
SELENE-AP-039	Diffuser opaque inspection surrogate	MAT-451	#dadcdb	0	0.72	opaque inspection surrogate
SELENE-AP-040	Aluminium honeycomb cut edge	MAT-481	#a5adb6	1	0.40	opaque surface
SELENE-AP-041	Mare-style regolith surface	MAT-531	#5e5c58	0	0.96	opaque surface
SELENE-AP-042	Highland-style regolith surface	MAT-546	#8b8881	0	0.96	opaque surface
SELENE-AP-043	Tool-transferred dust patch	MAT-559	#7b766d	0	0.98	opaque deposit geometry response
SELENE-AP-044	Woven-metal wheel mesh	MAT-565	#999fa7	1	0.38	opaque surface
SELENE-AP-045	Oiled oak workshop surface	MAT-111	#a17a51	0	0.56	opaque surface
SELENE-AP-046	Varnished walnut joinery	MAT-113	#6d4d37	0	0.30	opaque surface
SELENE-AP-047	Automotive smooth clearcoat surrogate	MAT-034, MAT-204	#4e697e	0	0.21	opaque surface
SELENE-AP-048	Embossed tyre-sidewall preview	MAT-237	#282a2c	0	0.83	opaque surface

Source and contract references

• appearance.assign implementation: named custom colors, body/face/component targeting and exact PBR block admission.
• Persistable PBR parameters: appearance-owned optical values and sRGB decoding.
• Opaque product surface contract: current consumers, limits, native preservation and unsupported functions.
• Original opaque studio example: existing solid.box and appearance command shapes used for this prepared script.
• CLI render workflow and product-image jobs: bounded PNG admission, preflight/start/wait/export and overwrite behavior.
• Script executor and timeline export: replay semantics and export omissions.
• Scalar catalog contract: version-1 scalar-only fields and PBR export refusal.

Original provenance

Author: SolidCraft contributors. License: MIT OR Apache-2.0. The two JSON files are original clean-room resource data and analytic command inputs. No commercial material library, copied shader, third-party artwork, restricted CAD extraction or generated image texture is bundled. Their exact attribution rows belong in the repository root ATTRIBUTION.md; Markdown documentation is exempt from the non-Markdown asset gate.