The top menu strip is now the window's title bar wherever the app draws the
frame (crates/ui-egui/src/titlebar.rs), using craft-window for the decision
and for the draggable empty area:
- Windows: no OS frame. App icon at the very left, the menus, empty space
that moves the window (double-click maximizes), the mode label, then
minimize, maximize/restore and close (46 pt wide, crisp pixel-snapped
glyphs, close turns red on hover, dimmed while inactive). Invisible edge
and corner zones resize the window. A per-frame guard ported from
VectorCraft keeps the undecorated window borderless and a maximized one
clear of the taskbar (winsafe, no unsafe), and the taskbar gets the big
app icon.
- macOS: the traffic lights over the strip (full-size content view, hidden
title), centred on it with eframe's traffic-light API, the app icon after
their inset, and AppKit's movable flag synced by craft-window.
- Linux and the BSDs: craft-window's probe decides; where the compositor
leaves the frame to the app (GNOME) the strip draws the buttons in the
desktop's button layout.
- Wherever the system draws the frame (and on the web) the strip stays the
menu bar, with the app icon at its left. No line under the strip.
TEXTURECRAFT_TITLEBAR=app|system overrides the decision. Settings ›
Interface › System title bar (applies on restart) brings the OS frame back;
it is read from the saved settings before the window opens and is settable
over the control channel as prefs.system_title_bar. ui.inspect reports
titleBar. New strings are translated in every language, and the offscreen
snapshots render the app-drawn and macOS variants.
- The interface font is Inter (regular and semibold) from craft-fonts' Latin catalog, on
VectorCraft's type scale: 11 small print, 13 body and controls, 15 semibold headings, 11.5
values. build.rs embeds it without its Private Use Area, where the icon font draws. CI and
release builds move to the craft-fonts commit with the Latin catalog.
- The tool bar, tool shelf, rail and bake panel are square tiles like the dock's groups, with
one 6 pt gutter between all of them and no separator lines.
- Selected options and selected text are lettered in the strong colour instead of the accent on
its own tint; a theme test keeps that readable in every brightness and accent.
- Section captions are semibold; the Layers action row fits one line again.
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
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
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>
Agents in a workspace can now do everything the file menu and bake panel do with mesh files:
add high polys and the bake cage, export the mesh with its textures, and reimport the
project's mesh. Paths stay below the read and write roots, as for the other workspace tools.
- MCP tools bake_mesh_add {path, cage?}, mesh_export {path, format?} and
mesh_reimport {path?, preserveStrokes?}; control-channel methods bake.mesh.add, mesh.export
and mesh.reimport (headless); bridge mode reimports the app's own copy
- engine: Session::add_bake_mesh, Session::mesh_export and Session::reimport_mesh, shared by
bake.highPoly.add, bake.cage.set, file.exportMesh and file.reimportMesh (the cage now logs
textures it could not read, like high polys)
- docs/control-protocol.md lists the new tools and methods
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Replaces the procedural octopus with the owner's original ArtCraft drawing
of an engraved zebra, vectorised with craftrules' vectorize_tile.py to the
three icon colours (ink, paper and TextureCraft's copper #c2672b, which
stays the default UI accent). texturecraft.svg is the master traced at
2048 px, texturecraft-small.svg the lighter trace for hicolor/scalable.
packaging/icons.sh now follows the other Crafting Apps: the tile is used
edge to edge on Windows and Linux, and the .icns gets Apple's exact
824/1024 margin. Regenerated the hicolor PNGs, texturecraft-1024.png, .ico
and .icns; removed icon.py, icon.svg and icon-1024.png. Adds the icon
README and LICENSE.txt, and updates ATTRIBUTION.md, docs/releasing.md and
the README icon.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Code comments, crate descriptions, the MCP stroke schema and the Linux package descriptions
describe features in their own words instead of naming the reference application or other
vendors' products (file format names stay)
- The README follows the layout the other Crafting Apps use (VectorCraft): a look around, made
in TextureCraft, why TextureCraft, quick start with the agent setup, status, downloads per
platform, the Crafting Apps, star history, license; no trademark footer
- The detailed feature list moves to docs/features.md
- A new path-traced render of the built-in crate textured with smart materials
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Workspace, bake mode, export dialog, Rendering mode and the light theme, taken over the control
channel. Labelled dropdowns share one `combo` widget that puts the label first and fills the rest
of the row, so the bake panel's Output size, Antialiasing and Match rows no longer run past the
panel's edge.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Four brightness levels (Medium dark by default) and seven accent colours (Copper, from the app
icon, by default) in Settings › Interface, saved in the UI preferences and settable over the
control channel. Panels, dock groups and bars are rounded cards; tabs are pills, buttons flat and
rounded, popups shadowed; spacing follows VectorCraft. The 3D and 2D views keep a neutral studio
grey with overlay colours that stay readable on it. Widget colours come from craft-ui.
Also: `ui.resize` sets the window size for recordings and screenshots, and TEXTURECRAFT_NO_PREFS
keeps scripted runs off the user's saved layout and settings.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Strokes pre-blend their commit while painting and recompose committed tiles at low
priority: the 8K stroke-end frame drops from 30-42 ms to 12-19 ms
- Texture set resize runs in the background (8K: 3 s to 0.5 s, UV padding map from island
borders only)
- Decal move/scale/rotate handles; FBX and USD high-poly textures for the color map;
viewport displacement from the height channel; screen-space refraction of the scene
- CI pinned to Rust 1.96.0; FreeBSD VM sized for hosted runners; release builds embed
craft-fonts; file associations for FBX, COLLADA, USD and Alembic on every platform
- README, release checklist, NOTICE and attribution brought up to date
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Baking: per-map ray settings (AO, thickness, bent normals), GPU ray-traced baking with CPU
fallback (~12x), color map from textured glTF high polys
- Files: Alembic (Ogawa) and FBX 6 import, per-tile UDIM resolution, converting a set to UV
tiles, project templates, preserving painted strokes on mesh reimport
- UI: translations (French, German, Spanish, Portuguese, Italian, Japanese, Chinese, Korean)
with a live language picker and CJK fonts, closed panels reopen where they were, viewport
texture resolution setting, frame-budgeted scene sync for 8K sets
- Web: loading screen, WebGL2 notice, app-captured shortcuts, touch navigation
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Rendering mode traces on the GPU (compute shaders, ~25x the CPU tracer) with CPU fallback;
CLI/MCP render --samples uses the GPU unless --cpu
- Depth of field in the viewport and the path tracer; multiple cameras with glTF import;
transmission/IOR, coat normal and screen-space subsurface blur; exact 8-bit normal decode
- Filter library (18 filters incl. warp, color balance, gradient map, posterize, MatFinish)
with a Filters shelf tab; geometry decals; clone from the current layer; anchors inside a
content stack; instances across texture-set resolutions; drag saved smart materials
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- UV tiles: auto-detected UDIM texture sets as one atlas per set, padding kept inside tiles,
one file per tile with the $udim export token, builtin:udim_plane
- USD: usda/usdc/usdz import (Crate reader with LZ4) and export with UsdPreviewSurface
- Shader lobes: clear coat, sheen, anisotropy and subsurface scattering channels in the
viewport and the path tracer; car paint, velvet, brushed steel, skin and wax materials;
glTF clearcoat/sheen export
- Color swatch popups no longer stay open
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Compositor caches the stack below and replays what lies above the layer being painted,
also inside folders: painting under a smart material is ~10-25x faster per frame and the
stroke commit 12-30x faster, bit-identical to a full composite
- Paint shows in the frame it is drawn; parallel stamp rasterizing and stroke commit;
camera visibility reused between strokes
- 67 procedural brush alphas with an Alphas shelf tab; drag materials, smart masks and
alphas from the shelf onto the layer stack, layers and viewport
- Export output template editor: user presets with per-channel packing, converted maps,
import/export as JSON, validated at load
- Shift+right drag turns the environment; S+drag no longer orbits while moving the stencil
- Frame profiler and scripted paint test on the control channel (debug.frames, debug.paintTest)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
An open-source, clean-room implementation of a Substance 3D Painter-style texturing
workflow, written in pure Rust with egui and wgpu.
- Layer stack with 32 blend modes, masks, generators, content effects and anchor points
- Painting, projection, smudge, clone, path, lasso fill, particle brush and quick mask
- 43 procedural materials, 17 smart materials and 10 smart masks
- Mesh map baking with high-poly, cage and match-by-name support
- PBR viewport with HDR environments, TAA and a path-traced Rendering mode
- glTF, FBX, COLLADA, OBJ, PLY and STL import; texture export presets; OBJ and GLB export
- Dockable Painter-style UI, shortcut editor, web build, MCP server and CLI
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>