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>
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>
A .gltf whose buffers or images are separate files, and a loose USD layer whose
UsdPreviewSurface textures sit next to it, now open, reimport and bake as high polys with
those files, and projects keep them: `self_contained_mesh` folds a .gltf's files in as data
URIs and packages a loose layer with its textures as a .usdz, so the stored mesh imports
from its bytes alone. Only files inside the mesh's folder are read (no absolute paths, URLs
or `..` above it); missing ones are named in the log.
- formats: `self_contained_mesh`, `read_mesh_file` and `MeshFile`; `import_mesh` uses them;
the glTF reader no longer reads the disk itself; USD texture lookups go through one
`Assets` source (usdz package or loose files)
- engine: file.open, file.new, file.reimportMesh, bake.highPoly.add and bake.cage.set read
meshes this way; a failed reimport no longer leaves the session pointing at the new file
- automation: mesh_import / mesh.import read the files under the same workspace rules
- CLI `info` reports a .gltf with external buffers
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The GitHub mobile app shows the relative SVG logo as a broken image.
docs/brand/ already carries PNGs of the logo (light and dark) and the
mark with the same aspect ratios, so the README points at those.
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>
Adds .coderabbit.yaml so CodeRabbit no longer reviews or comments on PRs opened by dependabot[bot].
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>
- The startup sample adds an empty paint layer on top of each stack and selects it (strokes on
the bottom layer were hidden under the smart material)
- Depth of field and subsurface blur read same-size targets by pixel, not by filtered UV, so
inert settings change nothing on any adapter (software adapters blended neighbours)
- CLI help lists .abc and builtin:udim_plane
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>