From 052c8b2cffe78f452397e1a3bf0d280d89e5f36c Mon Sep 17 00:00:00 2001 From: bflatastic Date: Sun, 1 Nov 2026 14:29:08 +0700 Subject: [PATCH] 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 --- README.md | 2 +- ROADMAP.md | 19 ++++++++++--------- docs/architecture.md | 10 +++++++++- docs/features.md | 10 ++++++---- 4 files changed, 26 insertions(+), 15 deletions(-) diff --git a/README.md b/README.md index 6cf2da04..89964f0a 100644 --- a/README.md +++ b/README.md @@ -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 diff --git a/ROADMAP.md b/ROADMAP.md index fc74c8fb..cc36e362 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -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. diff --git a/docs/architecture.md b/docs/architecture.md index 0401cb09..268881be 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -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, diff --git a/docs/features.md b/docs/features.md index 7cb901b0..f9d3a4cb 100644 --- a/docs/features.md +++ b/docs/features.md @@ -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.