Skip to content

SolidCraft: an open-source parametric 3D CAD application built in pure Rust. Desktop, web, and automation through MCP.

15.2 KB
Raw Blame

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

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.