Docs: roadmap and status after the November features

- 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
This commit is contained in:
bflatastic committed 2026-11-01 14:35:18 +07:00
1 parent 61ed084c2e
commit 052c8b2cff
4 files changed
+26 -15

No files matched your search

+1 -1
View File
@@ -179,7 +179,7 @@ The details are in [`docs/control-protocol.md`](docs/control-protocol.md).
TextureCraft is under active development. [**ROADMAP.md**](ROADMAP.md) has the parity estimate by
area, the remaining work and what's next.
**Where we are (2026-10-23):** we estimate about 91% of a texture artist's daily workflow works end
**Where we are (2026-11-01):** we estimate about 93% of a texture artist's daily workflow works end
to end, weighted by how much of the day each area carries: importing meshes, texture sets and UDIM
tiles, the layer stack with masks, effects and smart materials, every painting tool, baking, the PBR
viewport and Rendering mode, export presets and templates, and the full menu set. The interface
+10 -9
View File
@@ -4,7 +4,7 @@ TextureCraft aims for 1:1 parity with Adobe Substance 3D Painter's texturing wor
performance, a smaller footprint, every feature drivable by agents (MCP, CLI, control channel), and
builds for Windows, macOS, Linux, FreeBSD and the web.
## Honest parity estimate (2026-10-15, gaps reviewed 2026-10-23)
## Honest parity estimate (2026-11-01)
Weighted by how much of a professional's daily work each area carries. "Done" counts what works
end to end today (engine + UI + automation + tests), not what is planned.
@@ -13,16 +13,16 @@ end to end today (engine + UI + automation + tests), not what is planned.
|---|---:|---:|---|---|
| Project and files | 8 | 95% | New project from glTF/GLB, FBX (binary and ASCII, 6.x and 7.x), COLLADA, **USD (usda, usdc, usdz)**, **Alembic (Ogawa)**, OBJ, PLY, STL or built-in meshes (auto-unwrap when UVs are missing; a `.gltf`'s buffers and images and a loose USD layer's textures are read from its folder and kept in the project), **project templates** (built-in and saved from a project), `.tcraft` open/save/save as/save a copy, autosave, recent files, drag and drop, reimport mesh **with strokes preserved on the surface**, image resources, remove unused resources, OBJ, textured GLB and **USD** mesh export, browser open/save/download | HDF5 Alembic; Alembic animation (first sample only) |
| Texture sets | 6 | 95% | One set per material, **UDIM / UV tiles** (auto-detected or switched on later with resampling, **a resolution per tile**, one texture per tile at its own size, `$udim` export), list with visibility, sizes 128–8192 with resampling, add/remove channels (19 channel types incl. coat, sheen, anisotropy and scattering), height strength, normal format | Filter radii and height slopes of a tile smaller than its atlas block follow the block |
| Layer stack | 16 | 92% | Paint, fill, folder and **instance** layers; 32 per-channel blend modes and opacities; white/black/painted masks with **mask with height**; generator, fill, levels, invert/threshold, color selection, compare, blur, sharpen and HSL effects on masks and layer content; anchor points; smart masks; mask view (Alt+click); duplicate, group, drag to reorder, rename, color tags, copy/cut/paste (also as instance) across sets, flatten, instantiate across sets, save layers as smart materials | Layer effects beyond the filter library (Painter's full effect catalog) |
| Layer stack | 16 | 96% | Paint, fill, folder and **instance** layers; 32 per-channel blend modes and opacities; white/black/painted masks with **mask with height**; generator, fill, levels, invert/threshold, color selection, compare, blur, sharpen and HSL effects on masks and layer content; anchor points; smart masks; mask view (Alt+click); duplicate, group, drag to reorder, rename, color tags, copy/cut/paste (also as instance) across sets, flatten, instantiate across sets, save layers as smart materials; **27 library filters** (adjustments, blur/sharpen/high pass, bevel, glow, edge detect, warps, mosaic, baked lighting, material finishes); **geometry masks** (a layer on chosen mesh parts) | A few niche filters of the reference app's catalog |
| Painting tools | 14 | 88% | Paint, eraser, projection with image stencils, polygon fill, **path** and **lasso fill**, smudge, clone, color picker, quick mask, Shift+click lines with preview, 2D view painting; size, flow, stroke opacity, spacing, hardness, angle, follow path, jitters, alignment, angle fade, backface culling, lazy mouse, X/Y/Z symmetry, pen pressure, procedural and image alphas, **particle brush** | Pen tilt (not exposed by the windowing layer) |
| Materials and assets | 8 | 80% | 48 procedural materials (incl. car paint, velvet, brushed steel, skin, wax), 17 smart materials, 10 smart masks, **67 procedural brush alphas**, 22 procedurals, 6 environments plus imported HDR/EXR panoramas, image resources, a user smart material library, a tabbed shelf with search and **drag and drop** onto layers and the viewport | More filters (Painter ships dozens) |
| Baking | 10 | 98% | AO, curvature (also from the normal map), thickness, world normal, position, ID, normal, height, **bent normals, opacity, color map and world-space direction**; **high-poly meshes**, cage, frontal/rear distances, average normals, **match by mesh name**; per-texture-set selection, common and per-map parameters, progress and cancel; high-poly base color textures embedded or in files beside a `.gltf` or USD layer | FBX high-poly textures kept in separate files (embedded media works) |
| Viewport and display | 12 | 93% | PBR with image-based lighting, 6 procedural environments or imported HDR/EXR panoramas with exposure, rotation, blur, opacity, ACES/linear tone mapping, HDR pipeline with bloom, vignette, sharpen and grain, key-light shadows, 4× MSAA plus idle temporal accumulation, channel / mesh-map / mask / UV checker views, 3D and 2D wireframes, brush cursor, axis gizmos, subsurface scattering blur, **depth of field**, saved and glTF cameras, **path-traced Rendering mode** (F10, on the GPU or the CPU) with environment importance sampling and an edge-aware **denoiser** | Hardware ray tracing; cameras from FBX, COLLADA and USD files |
| Shader | 6 | 95% | Metallic/roughness and specular/glossiness PBR, **clear coat, sheen, anisotropy and subsurface scattering** (viewport and path tracer), height-to-normal, painted normals, parallax occlusion, emissive, opacity (dithered), AO intensity | Displacement in shadows and the path tracer (viewport only, **screen-space refraction** and **displacement** done) |
| Export | 8 | 88% | 8 presets plus **user output templates** (per-channel packing, converted maps, JSON import/export), PNG/JPEG/TGA/TIFF/BMP/WEBP/EXR/HDR, 8/16/32-bit, padding modes, size override, OpenGL/DirectX normals, `$udim` tiles, OBJ, textured GLB (with clearcoat/sheen) and USD mesh export, zip download in the browser | USD export of the new shader lobes |
| Materials and assets | 8 | 86% | 48 procedural materials (incl. car paint, velvet, brushed steel, skin, wax), 21 smart materials, 18 smart masks, **67 procedural brush alphas**, 22 procedurals, 6 environments plus imported HDR/EXR panoramas, image resources, a user smart material library, a tabbed shelf with search and **drag and drop** onto layers and the viewport | A smaller bundled library than the reference app's |
| Baking | 10 | 100% | AO, curvature (also from the normal map), thickness, world normal, position, ID, normal, height, **bent normals, opacity, color map and world-space direction**; **high-poly meshes**, cage, frontal/rear distances, average normals, **match by mesh name**; per-texture-set selection, common and per-map parameters, progress and cancel; high-poly base color textures embedded or in files beside a `.gltf`, FBX or USD layer | — |
| Viewport and display | 12 | 95% | PBR with image-based lighting, 6 procedural environments or imported HDR/EXR panoramas with exposure, rotation, blur, opacity, ACES/linear tone mapping, HDR pipeline with bloom, vignette, sharpen and grain, key-light shadows, 4× MSAA plus idle temporal accumulation, channel / mesh-map / mask / UV checker views, 3D and 2D wireframes, brush cursor, axis gizmos, subsurface scattering blur, **depth of field**, saved cameras and cameras from glTF, FBX, COLLADA and USD files, displacement (also in shadows and the path tracers), **path-traced Rendering mode** (F10, on the GPU or the CPU) with environment importance sampling and an edge-aware **denoiser** | Hardware ray tracing |
| Shader | 6 | 100% | Metallic/roughness and specular/glossiness PBR, **clear coat, sheen, anisotropy and subsurface scattering** (viewport and path tracer), height-to-normal, painted normals, parallax occlusion, emissive, opacity (dithered), AO intensity | — |
| Export | 8 | 92% | 10 presets (incl. Godot 4 and **OpenPBR** with every shading lobe) plus **user output templates** (per-channel packing, converted maps, JSON import/export), PNG/JPEG/TGA/TIFF/BMP/WEBP/EXR/HDR, 8/16/32-bit, padding modes, size override, OpenGL/DirectX normals, `$udim` tiles, OBJ, textured GLB (with clearcoat/sheen) and USD (with clear coat) mesh export, zip download in the browser | Sheen and anisotropy in USD (UsdPreviewSurface has no inputs for them; GLB and OpenPBR maps carry them) |
| UI and UX | 8 | 95% | Painter-style layout with **dockable, tabbed, floating panels**, menus, tool shelf, tool bar, asset shelf, texture set list, layer stack with context menu, properties, display/shader/history/log panels, export dialog, new project dialog, bake mode, rendering mode, settings (interface scale, autosave, viewport texture resolution), saved UI layouts, **shortcut editor** with conflict detection, tooltips with shortcuts; all menu items live ([docs/parity.md](docs/parity.md)); **9 UI languages** with CJK fonts ([docs/localization-parity.md](docs/localization-parity.md)); closed panels reopen where they were; frame-budgeted compositing and uploads keep 8K sets responsive | Native-speaker review of the translations |
| Platforms | 4 | 75% | Windows, macOS (universal, signed and notarized), Linux (AppImage, deb, rpm, tar.gz, Flatpak), FreeBSD and web release workflows | First real release run; web build polish |
| **Total** | **100** | **≈ 91%** | | |
| **Total** | **100** | **≈ 93%** | | |
Beyond the reference app: every command is available to agents through MCP, the CLI and the app's
control channel (MCP workspace tools cover every file action: projects, meshes, high polys and
@@ -55,4 +55,5 @@ parallel on separate crates:
2. Hardware ray tracing in Rendering mode (M5) waits on an owner decision: wgpu exposes ray
queries only as an experimental feature behind an `unsafe` opt-in, and the workspace forbids
`unsafe` (craftrules allows it only in an isolated, tested helper crate).
3. Cameras from FBX, COLLADA and USD files, and clear coat in USD export.
3. Pen tilt (M2) once the windowing layer reports it; Alembic files in the HDF5 container and
Alembic animation.
+9 -1
View File
@@ -59,7 +59,9 @@ covered texel it walks the stack bottom to top: paint layers are unpremultiplied
(value, coverage) tiles, fill layers evaluate uniform values, procedurals (through UV, tri-planar,
planar, spherical or cylindrical projections) or image resources; masks evaluate their effect
stack (painted bitmaps, fills, mesh-map generators, levels, filters, ID color selection,
compare); each enabled channel blends with its mode and opacity. Only dirty tiles are recomposited
compare); a layer's geometry mask (mesh part names) zeroes its mask on texels whose triangle, from
the UV G-buffer, lies in another part; each enabled channel blends with its mode and opacity. Only
dirty tiles are recomposited
(a stroke dirties the tiles it touches), then padded, converted to display formats and uploaded to
the GPU.
@@ -85,6 +87,12 @@ The 2D view draws the UV layout with the material and a wireframe. Everything is
so it runs on Vulkan, Metal, DX12, WebGPU and WebGL2. `render::headless` renders without a window
(CLI, MCP, tests).
Displacement draws a dense, flat subdivision of the mesh (wgpu has no tessellation stage) and moves
it along the normals by the height channel in the vertex shader of the 3D view and of the key-light
shadow pass (`shaders/displace.wgsl`, shared by both). Rendering mode's path tracers (`render::trace`
on the CPU, `render::gpu_trace` on the GPU) trace the same displaced copy, built on the CPU by
`render::displace` from the composited height.
## Commands and automation
Every action is a `CommandSpec` in `engine::commands` (id, label, menu path, shortcut, params doc,
+6 -4
View File
@@ -28,8 +28,9 @@ Everything TextureCraft does today, by area. What's still missing is in [`ROADMA
show a layer only on the mesh parts you pick (right-click a layer).
- **Filters and content effects** on any layer or mask: **27 filters** (HSL, levels,
contrast/luminosity, color balance, gradient map, posterize, clamp, invert, threshold,
grayscale, edge detect, normal invert, baked lighting, blur, directional and slope blur, sharpen, high pass,
bevel, glow, warp, directional warp, mosaic and four material finishes), fills and paint.
grayscale, edge detect, normal invert, baked lighting, blur, directional and slope blur,
sharpen, high pass, bevel, glow, warp, directional warp, mosaic and four material finishes),
fills and paint.
**Anchor points** record the stack at a layer so masks and fills higher up can react to it.
- **Masks** with a white or black background and a stack of effects: painted strokes, fills,
**mesh-map generators** (edge wear, dirt, thin areas, curvature, AO, position and direction
@@ -41,8 +42,9 @@ Everything TextureCraft does today, by area. What's still missing is in [`ROADMA
- **48 materials** (metals from measured reflectance, car paint, brushed anisotropic steel,
velvet, skin, wax, glass, woods, stone, plastics, fabric, leather, ceramic), **21 smart
materials** (rusted iron, worn paint, oxidized copper, bronze statue, weathered wood, mossy
brick and stone, sun-faded paint…) and **18 smart masks**, all procedural, so they work at any resolution. Drag them from
the tabbed, searchable shelf onto the layer stack or straight onto the model.
brick and stone, sun-faded paint…) and **18 smart masks**, all procedural, so they work at any
resolution. Drag them from the tabbed, searchable shelf onto the layer stack or straight onto
the model.
- **Your own library:** right-click a layer or folder, choose *Create smart material*, and it
appears under *My smart materials*, pixels and images included.