Model - materials[]
Every method of the materials[] lane. Each step of a materials[] entry returns a material, and the lane's entries are addressed by the identity schema/lanes.ts declares for it.
| Method | Description | Arg | Type | Default | Meaning |
|---|---|---|---|---|---|
material | Material — Surface appearance record (color / PBR factors / texture slots) — materials[] lane only. Referenced by name via applyMaterial. | name | string | 'Material' | Material name (string expression; quote literals). Unique among resolved names. |
baseColor | color | Surface color, hex (e.g. '#ffffff'). Omit for default. | |||
texture | string | Base color map — an image URI (https:// or data:) or a textures[] chain key. A plain URI keeps default REPEAT+LINEAR sampling; non-default wrap/filter needs a one-node image chain declaring those builtins. | |||
normalTexture | string | Normal map — URI or textures[] chain key. Shares tileWidth/tileHeight. | |||
roughnessTexture | string | Roughness map (glTF green channel) — URI or textures[] chain key. | |||
metallicTexture | string | Metallic map (glTF blue channel) — URI or textures[] chain key. | |||
displacementTexture | string | Height map — URI or textures[] chain key. Visible only on tessellated geometry. | |||
displacementScale | length | Displacement amplitude in mm. Default 1. | |||
aoTexture | string | Ambient-occlusion map — URI or textures[] chain key. Prefer a chain with uvSet for lightmaps. | |||
tileWidth | length | Physical mm of one seamless texture tile (URI textures only — a textures[] chain's own lengthX wins). Default 1000. | |||
tileHeight | length | Physical mm of one seamless texture tile (URI textures only — a textures[] chain's own lengthY wins). Default 1000. | |||
colorFactor | number | 0 = texture only, 1 = solid baseColor. Default 1. | |||
opacity | number | 0..1. Default 1. | |||
roughness | number | 0..1. Default 1. | |||
metallic | number | 0..1. Default 0. | |||
transmission | number | KHR_materials_transmission 0..1 — glass walls (opacity alone is frosted plastic). | |||
thickness | length | KHR_materials_volume thickness mm (optical path). | |||
attenuationColor | color | KHR_materials_volume attenuation color, hex. | |||
attenuationDistance | length | KHR_materials_volume attenuation distance mm. | |||
ior | number | Index of refraction — glass ≈ 1.5 (KHR_materials_ior). | |||
clearcoat | number | Varnish / gloss paint (KHR_materials_clearcoat). | |||
clearcoatRoughness | number | Clearcoat roughness 0..1. | |||
sheenColor | color | Fabric/upholstery sheen color (KHR_materials_sheen). | |||
sheenRoughness | number | Sheen roughness 0..1. | |||
kFactor | number | Sheet-metal bend K-factor (ANSI convention, typical 0.3-0.5) — placePart's default source; a per-bend .bend.kFactor wins. Default 0.4. | |||
alphaTest | number | Alpha-cutout threshold (glTF MASK). Unset = no cutout. | |||
alphaMode | string | 'OPAQUE'|'MASK'|'BLEND' — wins over alphaTest/opacity when present. | |||
emissive | color | Self-lit color, hex. | |||
emissiveTexture | string | Emissive map — URI or textures[] chain key. | |||
emissiveIntensity | number | Emissive strength multiplier. Default 1. | |||
doubleSided | binary | 0 | Render both faces of a surface (thin imported geometry). | ||
density | number | kg/mm³ (e.g. steel 7.85e-6) — ALWAYS kg/mm³, never rescaled by the display unit. |