The views' studio backdrop is a cool slate, lighter at the top, matching the panels around them (post pass, CPU and GPU path tracers), and the viewport token and its lettering follow it.
- fonts: IBM Plex Sans (one variable file at 400, 500 and 600) and IBM Plex Mono for the
interface when built with craft-fonts (its Latin catalog, opted into from build.rs); the
ui-medium and ui-semibold families always exist and fall back to the regular font; CJK
fallbacks cover them too and align to the interface font's baseline
- type scale 11 / 12.5 / 14 (headings semibold), values in the monospace face; spacing on a
2-4-6-8-12 scale (rows 4 apart, button padding 8x3, window margins 12); windows share the
card radius
- panel tabs, section captions and window titles in the medium weight, as written instead of
small capitals
- layer rows: the opacity field fits its slot (compact padding, small print)
- Settings: every section an aligned two-column form, like Export and New project
- tests/ui_snapshots.rs: renders the whole window offscreen (egui_kittest + wgpu) to PNGs for
checking layout without a visible screen; AGENTS.md says how
- ATTRIBUTION, NOTICE and packaging list the Plex faces and ship their licences
Colors near a chosen color shift towards a new one, keeping their shading and texture.
27 -> 28 library filters.
- Filter::ReplaceColor {from, to, tolerance, softness}: each color within the tolerance (RGB
distance 0..1) moves by to - from, fading out over the softness (smoothstep); far colors and
scalar channels are untouched; content only (Adjustments)
- effect.add.filter / effect.set take from and to as linear RGB or "#rrggbb"; Properties has a
swatch per color and the two sliders; translations in all eight UI languages
- tests: near, far and halfway colors, scalars; the engine filter library test adds it
48 -> 54 procedural materials on the shelf and through material.apply:
- Rust (Metal): pitted, blotchy orange-brown iron oxide, a rough dielectric
- Slate, Sandstone, Terrazzo (Stone & Masonry): layered dark stone, fine warm grains, pale
binder with polished stone chips
- Cork and Paper (Organic): granular pored cork, off-white paper with a faint tooth
The existing test applies every material on the sample and checks it changes the composite;
each was also checked on the material ball.
A Geometry mask tool (key 8) shows or hides the selected layer on the mesh part under a click,
so geometry masks can be set on the model instead of from the part list.
- Tool::GeometryMask; tool.geometryMask selects it and tool.click toggles the part under the
point ({layer, part, shown, geometryMask}); showing every part again clears the mask; one
undo step per click; refused on empty space, without a selected layer, or on a part of
another texture set
- the tool shelf, the tool bar hint and Properties (the layer's parts, shown or hidden, and Show
on all parts); the hint is translated in all eight UI languages
- test: clicks on a two-object OBJ hide, show and clear, undo, and a click on empty space
Strokes can repeat around an axis through the mesh center, 2 to 32 copies, on their own or with
the X/Y/Z mirrors (each mirror is spread too).
- Symmetry gains radial (copies) and axis (X/Y/Z, default Y), serde defaults; sanitized clamps
- symmetry copies are marked and paint where symmetry puts them: the camera visibility and
back-face tests apply to the stroke itself only, so copies on the far side of the model paint
(mirror Z included); they still only paint surfaces facing the copy
- tool.brush {symmetryRadial, symmetryAxis}, shown in its result as radialSymmetry; Properties >
Lazy mouse and symmetry: Radial copies slider and axis; translations in all eight languages
- tests: copies a quarter turn apart, with mirrors, clamping; an engine stroke paints the back of
a sphere through radial symmetry
- ROADMAP: parity estimate re-scored on 2026-11-01 (about 93%): layer stack (27 filters,
geometry masks), materials and assets (21 smart materials, 18 smart masks), baking (FBX
texture files), viewport (cameras from FBX, COLLADA and USD; displacement in shadows and the
path tracers), shader, export (Godot 4 and OpenPBR presets, clear coat in USD); remaining gaps
and current focus updated
- README: status date and estimate
- architecture: geometry masks in compositing, displacement in rendering and the path tracers
- features: filter list wrapped
- Godot 4 (ORM): albedo (A = opacity), orm (R AO, G roughness, B metal), normal (OpenGL),
emission, as StandardMaterial3D reads them
- OpenPBR (separate maps): one map per OpenPBR Surface input the set has, including the coat,
fuzz (sheen), anisotropy, transmission and subsurface lobes, geometry normal (OpenGL) and a
16-bit height; maps of channels a set lacks are skipped
- test: OpenPBR writes the lobe maps of a set that has them and skips them otherwise
17 -> 21 smart materials on the new smart masks: Stone Mossy (granite, dust in cavities, moss
from the top), Paint Sun Faded (faded where it faces the sky, sharp chipped edges), Steel Water
Stained (water stains) and Plastic Grimy (soft worn edges, grime in cavities). The existing test
applies every material on the sample and checks it changes the composite.
10 -> 18 procedural smart masks on the shelf and through mask.smart.apply: Edges Soft, Edges
Sharp, Exposed Areas, Thin Areas, Dust in Cavities, Moss from Top, Water Stains and Sun Faded,
built from the mesh-map generators and triplanar patterns like the others (any resolution).
The existing test applies each on the baked sample and checks it is not empty.
A layer or folder can show only on the mesh parts you pick: right-click a layer > Geometry mask
lists the parts of its texture set as checkboxes; Show on all parts clears it.
- Layer.geometry_mask (part names, serde default); the compositor zeroes the layer's mask on
texels whose triangle (UV G-buffer) lies in another part, so it combines with painted masks,
mask with height, folders and anchors; an instance keeps its own
- layer.set {geometryMask: [names] | null} (unknown parts refused), textureSet.parts {ts?};
inspect shows geometryMask per layer and parts per set
- translations for the menu labels in all eight UI languages
- tests: compositor split of one material into two parts; engine commands on a two-object OBJ
(parts, masked composite, refused input, inspect, undo, clear)
The shadow pass draws the dense copy and displaces it like the 3D view, so a displaced surface
shadows itself instead of being shadowed as if it were still smooth.
- shaders/displace.wgsl: displace_by_height, shared by mesh.wgsl and shadow.wgsl
- the shadow pipeline takes the set bind group (height and sampler) and a displacement vec4
(on, world units per unit of height with the height strength, vertex spacing)
- while it displaces, the cached shadow map is re-rendered when the set textures change
- test: with flat height, displaced shadows match the plain mesh's
Rendering mode traces displaced geometry when the display has displacement on, so path-traced
renders show the viewport's silhouettes and the displaced surface shadows itself.
- render::displace: the viewport's dense subdivision of the mesh, each vertex moved along its
normal by its set's height (box-filtered to the mip the vertex shader samples) times the
height strength, at the viewport's scale (world length per UV / 16)
- trace_geometry gives the GPU and CPU tracers the displaced mesh and BVH; Rendering mode,
texturecraft-cli render --samples and MCP viewport_render use it
- Rendering mode keeps the traced geometry until the mesh, a set's content or a height
strength changes (display tweaks don't rebuild it)
- subdivide::vertices shared by the renderer's mesh upload and displacement
- test: a uniform height lifts the dense plane by height x strength x world per UV / 16
An FBX whose base color textures are files (as most exporters write them) now keeps them: like
a loose USD layer becomes a .usdz, opening, importing or adding it as a high poly packages the
FBX with the texture files it names, so color map bakes see them and the project stores them.
- fbx:📦 a stored zip of the FBX (first) and the files found below its folder, by the
Texture's (or Video's) RelativeFilename, else its absolute FileName's file name next to it;
textures found nowhere are named in the log
- fbx::read opens such a package like the FBX (embedded content still wins)
- shared zip limits and entry reading for usdz and FBX packages (mesh_import::zip_entry)
- test: relative and file-name-only lookups, binary and ASCII, missing files warn, packages
re-import as they are, packages without an FBX or nested ones are errors
Paints a light into the base color for hand-painted and mobile looks: base color x (ambient x
ambient occlusion + light x max(n.l, 0)) on the mesh normals, with the light set by azimuth and
elevation. 26 -> 27 library filters.
- Filter::BakedLighting {azimuth, elevation, light, ambient, occlusion} and baked_light()
- the compositor reads the texel's normal and the baked AO (none baked: no occlusion) and
lights the base color only; content only (Adjustments)
- effect.add.filter / effect.set / filter.list; property sliders; translations in all eight UI
languages
- tests: lit from the normal side the color stays, from behind only ambient remains, roughness
untouched; occlusion weighting
The earlier {main, windows, closed} layout is no longer converted; any layout that is not a valid
workspace with a docked viewport becomes the default.
Cameras in FBX, COLLADA and USD files join the project's camera list, as glTF cameras do.
- FBX 6/7: Camera Models (looking down +X) with the lens from their Camera NodeAttribute or
the Model's own properties (focal length over film height, else FieldOfViewY /
FieldOfView; CameraProjectionType 1 = orthographic); FBX 6 Producer views skipped
- COLLADA: instance_camera in scene nodes (perspective yfov or xfov + aspect_ratio,
orthographic ymag or xmag + aspect_ratio); node transforms understand lookat
- USD: Camera prims (focalLength over verticalAperture with USD's fallbacks, orthographic
projection), through xform ops and the hierarchy
- RawCamera::placed and lens_fov shared by every reader (glTF too); an orthographic view
height follows its node's scale; at most 64 cameras per file
- tests: a camera in the FBX 7 binary/ASCII scene, a Producer view in the FBX 6 file, a
lookat camera in the COLLADA scene, a perspective and an orthographic camera in the USD scene
egui, eframe and the craft-ui pin go to the suite's egui 0.37 forks and craft-libs f8f8829c.
The panels dock through craft_ui::docking (native floating windows on desktop) in place of
egui_dock, which has no egui 0.37 release. The viewport is the protected central canvas.
Layouts saved before load into the new workspace; an unreadable one becomes the default.
egui-phosphor has no egui 0.37 release, so a copy with the egui requirement raised is vendored.
The filter library grows from 23 to 26 filters for layer content and masks.
- Bevel (Blur and sharpen): values ramp from 0 at a shape's edge up to their own level over
the width, from the coverage-weighted box blur; never raises a value
- Glow (Blur and sharpen): adds the blur of the values times the amount
- Mosaic (Distort): square cells, each the value at its center, sampled at absolute texel
positions so cells line up across tiles
- effect.add.filter / effect.set / filter.list cover them; shelf thumbnails, property sliders
and translations in all eight UI languages
- tests: compositor behaviour of each, the engine filter library test adds and composites them
The UsdPreviewSurface of each exported material gets clearcoat and clearcoatRoughness from two
more UsdUVTexture maps (Clearcoat, ClearcoatRoughness; raw), rendered from the Coat weight and
Coat roughness channels, as the GLB export already carries them.
- a set without coat channels produces no coat maps; a black coat drops both maps, like a
black emissive map
- usda, usdc and usdz; File > Export mesh, file.exportMesh and the MCP mesh_export tool
- tests: the USD round trip exports a coated and an uncoated (black) material in all three
encodings
The filter library grows from 18 to 23 filters for layer content and masks.
- High Pass (Blur and sharpen): the detail finer than the radius around mid gray (0 for
signed channels), sharing the box-blur path, premultiplied by coverage
- Edge Detect (Adjustments): gradient magnitude from coverage-weighted central differences;
a side outside the UV island reads the texel itself, so seams are not edges
- Warp Directional (Distort): the warp's noise offset along one direction
- Grayscale and Normal Invert (Adjustments, content only): luminance for colors, flipped
green for normal maps
- effect.add.filter / effect.set / filter.list cover them (CLI, control channel, MCP);
shelf thumbnails, property sliders and translations in all eight UI languages
- tests: compositor behaviour of each new filter, the engine filter library test adds and
composites them
- ROADMAP: M4 baking done (high-poly textures beside a .gltf or USD layer); viewport gaps
brought up to date (depth of field, subsurface blur and cameras landed; hardware ray tracing
and FBX/COLLADA/USD cameras remain); hardware ray tracing waits on an owner decision (wgpu's
ray queries need an unsafe opt-in); CI is green on main; the current focus is the v0.1.0
release
- README status and docs/features.md: meshes with files beside them, the MCP mesh file tools
- docs/releasing.md: the release environment and ruleset now exist; secrets and the runner
group are what's left
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>