Preserve closed-session guards and project cleanup alongside the new layer, camera and layout controls. Update the menu-order regression for the merged catalog.
Remove DDS encoding, its dependency, export options, tests and documentation. Revert the MaterialX export-dialog option and preview additions while retaining engine export support.
Evaluate material-brush and mask Clone/Smudge pickup on demand. Give mask preview and commit an explicit value image. Sample the document in solo mode and avoid redundant export cache invalidation.
Validate saved decal axes, stencil settings and smudge strength. Bound smart-mask reads, write masks atomically and reject external anchor references. Clear stale clone sources on cross-set selection. Reject moves into another set’s folder and use layer positions to detect no-op moves without cloning the project again.
Load saved materials on shelf click and route pinch gestures to viewport zoom. Add regression tests for the affected behaviors.
Combines 45 open pull requests so the Windows proof build runs once. Included:
- Fill layers can color from dark to light with a gradient map (PR #535, fixes#482)
- Front, side and top views, and F5/F6 switch between perspective and orthographic (PR #539, part of #241)
- Textures export as DDS, with compressed normal and grayscale maps for game engines (PR #543, fixes#354)
- The active layer and the eye in the Layers panel are much easier to see (PR #561, fixes#553)
- Export dialog can also write a MaterialX file for each texture set (PR #563, fixes#558)
- Layers toolbar stays on one row and cut-off layer names show on hover in small windows (PR #564, fixes#560)
- Save a layer's mask as an image file or copy it to the clipboard from the layer menu (PR #565, fixes#559)
- Shift + wheel and Ctrl + wheel change the brush size, and Ctrl+drag brush changes have a fine mode (PR #566, part of #545)
- Select several layers in the Layers panel with Shift+click, Ctrl+click and Ctrl+A (PR #567, fixes#247)
- Pressing F frames the object you are painting, so a floor plane no longer throws off the view (PR #568, fixes#478)
- Save a mask as your own smart mask and reuse it on other layers and projects (PR #569, fixes#562)
- Show one layer alone in the viewport, with or without its mask (PR #570, fixes#544)
- On-screen orbit, pan and zoom buttons let a pen tablet move the 3D and 2D views (PR #573, fixes#288)
- Decals can be mirrored to the opposite side of the mesh across X, Y or Z, with optional U or V flip (PR #576, fixes#272)
- Shift+click lines in the 3D view start at the spot you last painted, even after turning the view (PR #578, fixes#574)
- History steps now name the tool and layer and appear in the interface language (PR #580, fixes#572)
- Path tool keeps your points when you click in the other view and tells you why (PR #582, fixes#575)
- Brush, symmetry and tool settings stay when you open another project or restart the app (PR #584, fixes#571)
- Reset only the panel layout from the Window menu, and Reset UI now asks first (PR #586, fixes#577)
- Output templates ask before deleting and before dropping an unfinished edit (PR #588, fixes#579)
- Clone tool shows its source in the 2D view, forgets it when you switch texture set, and can restart at the source each stroke (PR #590, fixes#581)
- Move the symmetry plane to the model's middle or to a clicked point in one click (PR #591, fixes#585)
- Projection stencil can be dropped in from Assets, moved and reset with fields, turned in snapped steps, and the 2D view says projection works in 3D (PR #593, fixes#583)
- Smudge now shows which channels it drags and lets you switch them (PR #594, fixes#587)
- Save panel layouts under a name and switch between them from the Window menu (PR #595, fixes#589)
- Clone and Smudge now work on layer masks (PR #596, fixes#592)
- A layer image menu test no longer fails when another test switches the interface language (PR #597)
- Clicking a material in the shelf now paints with it instead of adding a layer (PR #599, fixes#305)
- Alt+click on a mask thumbnail now labels the mask view and blanks the other texture sets (PR #605, fixes#600)
- Painting on a texture set that is not active now shows a hint why nothing happens (PR #607, fixes#601)
- Ctrl+Shift+click draws straight lines that snap to 15 degree steps (PR #609, fixes#604)
- Output template channels can be inverted (PR #611, fixes#603)
- Smudge now follows the mirror and radial symmetry planes (PR #613, fixes#602)
- The shortcut list now shows the stencil, clone source, straight line and path gestures (PR #614, fixes#608)
- Symmetry now also mirrors strokes painted in the 2D view (PR #615, fixes#610)
- Decals keep their image's proportions while sizing and can be flipped (PR #617, fixes#606)
- Polygon fill now also fills the mirrored side when symmetry is on (PR #619, fixes#612)
- A decal dragged over a curved or differently facing surface now turns with it instead of tilting or flipping (PR #622, fixes#616)
- Every brush alpha now has size, roundness, contrast and invert settings (PR #623, part of #598)
- Decals placed as a mask can now be sized, turned and moved from Properties like decal layers (PR #624, fixes#618)
- Renaming effects and linking fills to mask anchor points are now tested in the interface (PR #626, fixes#621)
- Path points can be corners, so paths can have hard edges (PR #627, fixes#620)
- Layer menu can apply a layer's blending mode and opacity to all channels, and copy/paste channel blending (PR #631, fixes#629)
- Display Settings can now set glow, vignette, sharpen and film grain (PR #632, fixes#630)
- Every command a key can run can now get a keyboard shortcut (PR #633, fixes#628)
Fixes found while combining them: the named layouts window is drawn again, layer remove/duplicate/group/visibility stay bindable to keys, the Clone tool's Aligned switch is kept with the other tool settings, smudge copies in the 2D view keep their own trails, and a UI or control-channel camera command during a view glide is no longer undone by the glide.
Review fixes: --control runs still start with the sample project, headless save/export/import refuse after file.close, session.inspect reports projectOpen, web drops need a project, the template button and view buttons are disabled without a project.
Keep the reviewed brush management UI and protocol documentation repair while dropping the disabled mask anchor test that destabilizes the full UI suite.
Prevent preset file collisions, preserve trusted headless libraries across project changes, and keep untrusted sessions in memory. Support named and legacy preset files, expose session presets in the shelf, invalidate stale previews, and restore wasm integration guards.
Bound directory selection, avoid deferred thumbnail settings copies, and calculate candidate filename keys once per collision check. Split the new preset types and complete scoped cleanup.
Preserve main UI and translation changes. Bound archive indexing, directory scans and native reads; fix resolution-token overflow, unique-name replies and dialog behavior.
Avoid generated-map re-decoding and input-buffer clones, release packed sources after their final use, and borrow dialog candidates. Keep generated pixels identical to PNG reloads. Organize new types and preserve the public classifier module.
Validated with 973 release tests, focused UI and allocation probes, panic hunt, clippy, layering, wasm, formatting and diff checks.
The bent normal map packed the world-space direction while the normal map
uses the low poly's tangent frame (OpenGL green). Encode the bent normal in
the same frame on the shared CPU/GPU packing path, read imported bent
normal images in the project's normal format, and decode it with the vertex
tangent frame in the neutral material view.
Projects saved before format version 3 held world-space bent normal maps:
loading drops them, keeps the bake settings and asks for a re-bake.
Part of #538
Merge upstream main into the branch. The streamed bake now returns the same Arc buffers it handed to the preview, and the document stores those, so a preview never holds a second copy of a map. A cancel leaves the set being baked as it was; sets that finished earlier stay applied.
textureSet.meshMap.import takes its paths in files[].path, which
authorize_command did not look at, so a control client could import an
image from outside --read-root. Treat a path or dir in any files entry
like a top-level one, and document that automation imports baked maps
through resource_import plus textureSet.meshMap.set.
New project > Advanced settings gets the project's normal map format and
Import baked maps: Add lists image files, and Create imports them with the
new textureSet.meshMap.import command, which sets each file as the mesh map
of the texture set and slot its name names (Body_ambient_occlusion.png,
Body_normal.1001.png) in one undo step and reports the files it left out.
A bake started in the app bakes the set's maps one after another (BakeTask::run_streaming, one bake per map, same pixels as a single bake) and streams each finished map from the worker thread. One map is installed per UI poll into the session's bake preview (not the document); the 3D view follows the newest map raw on the model, with maps and sets not baked yet shown neutral, and the bake bar names the stage. The bake bar picks Follow Newest Map, a finished map or Material. The previous view mode comes back when the bake ends, is cancelled or Bake mode is left; painting is paused while a bake is shown. bake.preview, ui.bake.start and ui.bake.cancel expose it on the control channel. New strings are translated in every shipped language.
File > Import PBR texture folder..., drop a folder, zip or several map files,
choose between candidate files, normal convention and projection, optionally
keep the material in the library. Documented in docs/control-protocol.md.
Save the current brush (size included) and the painted channels as a named
preset kept as a .tcbrush file in the data folder's brushes folder. Use,
rename, replace and delete them from a Brush presets popover in the brush
options and from the shelf's My brushes list. New commands:
brush.preset.store, brush.preset.rename, brush.preset.delete;
brush.preset.list and brush.preset.apply now cover the user's presets too.
Older bare .tcbrush files are picked up under their file name.
Saved cameras (Project.cameras) already act as bookmarks; add camera.bookmark1..9 commands,
a short viewport glide when going to a camera from the UI, a test and a control-protocol section.
Keeps both sides of the translation tables, AGENTS rules and the formats module list;
material files in the browser load before the ask-to-save step (they add a layer, not a
new project); Arabic for the eight MaterialCraft strings; menu parity regenerated.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
An effect's context menu copies, cuts and pastes it, and Ctrl+C,
Ctrl+X and Ctrl+V act on a selected effect (pasting a copied one above
the selected effect, or on top of the selected content or mask).
Painted strokes come along, resampled to the target set; generators
and other one-stack effects go to their stack, and a fill reading an
anchor point needs one below its new layer. effect.copy, effect.cut
and effect.paste share the layer clipboard.
- core: Fill::link (MaterialLink: package resource, graph, exposed inputs, presets,
image inputs, size); BakedMap::interop_id / for_input shared mesh-map identifiers
- formats: own .mcmat reader (no MaterialCraft dependency) and 16-bit mesh-map PNGs
- engine: material.load takes .mcmat and .mcraft; material.link.set / .preset / .cook /
.saveSource; LinkJob re-cooks through materialcraft-cli at the texture set's
resolution with baked mesh maps as graph inputs; fresh resource names per cook keep
undo and the decoded-image cache consistent; packages count as used resources
- ui: linked-material section in fill properties (presets, sliders, colors, toggles,
options) cooking on a worker thread, one process per layer, stale results redone;
Open in MaterialCraft; File > Import material...; .mcmat drops; library shelf lists
.mcmat and rescans on focus; 8 new strings in every language
- tests: materialcraft_link (import, params, undo, duplicates, mesh maps, save, and a
real materialcraft-cli round trip when MATERIALCRAFT_CLI is set)
- docs: README, features, control protocol, architecture, AGENTS, ROADMAP, parity
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The History panel lists every undone step too (dimmed, next first) and
a click on any step goes back or forward to it, the current one
highlighted. edit.undo and edit.redo take {steps?} for the same jump.
Each mesh map slot of the Texture Set Settings takes an image resource:
drop one from the Assets panel on the slot, or pick it from the slot's
menu, which also clears the slot. The image is resampled to the size of
the set's other mesh maps (or its bake size), its values read as data,
a normal map in the project's normal format.
textureSet.meshMap.set {ts?, map, image} and
textureSet.meshMap.clear {ts?, map} give agents the same.
Effect rows in the layer stack can be dragged within their stack (a
drop lands above the row, or below it from its lower half), and their
context menu duplicates an effect just above itself, painted pixels
included. effect.move {effect, index} and effect.duplicate {effect}
give agents the same.
The Levels effect's properties now show a histogram of its input, the
mask below it or (on layer content) a channel picked above it, with the
input range marked. effect.histogram {effect, channel?, bins?} gives
agents the same counts. Large sets are sampled (at most 256 tiles), so
the cost stays flat up to 8K.
The baked maps are most of a sample project's size, so a 2048 sample is
as large as a 1024 one; the usage and the control protocol now say so.
Fixes#66.
resource.text draws one or more lines of text, shaped with harfrust (kerning,
ligatures, joined scripts) from the font's outlines (skrifa) and filled by a
non-zero scanline rasterizer, cropped to the ink, as an image resource: white
for the brush alpha, or a color for a decal. text.fonts lists the installed
families and styles, read from each font file's name table only (246 families in
80 ms here); Ubuntu Light and Hack from the UI's built-in fonts are always there
and are the fallback in the browser.
- Properties > Alpha > Text: the text, a font and style, Use as brush alpha and
Place as decal (in the tool's base color).
- Image alphas keep their proportions (their longer side spans the stamp), so a
line of text stays a line; image thumbnails are letterboxed and show alpha.
- harfrust 0.12 and skrifa 0.44 are the versions egui already builds, so the
lockfile gains no packages.
Fixes#40
The desktop app wrote its control token to <temp>/texturecraft-control-<port>.token with
default permissions (world-readable in a shared /tmp), from a hash-based generator, and
compared it non-constant-time with no connection limit. Any local user could read the token
and drive the app, whose command.run takes host paths.
- Token files are created new (remove, then O_EXCL) with mode 0600, so a planted file or
symlink can neither keep its permissions nor redirect the write; one that cannot be
replaced disables the server with a hint to set TEXTURECRAFT_CONTROL_TOKEN.
- Clients only read a token file that is a regular file owned by them with no group or
other permissions, opened without following symlinks or blocking on a FIFO.
- The app's control server uses the shared security module: OS-random 256-bit token,
constant-time compare, validated and trimmed env token, bounded lines and at most 16
connections.
- Connections must authenticate within 10 s (AuthDeadline) and get one attempt.
- The app and `serve --port` bind before writing the token file, so a server whose port is
busy no longer replaces the running server's token.
Regression tests cover owner-only files over an existing open file, symlink and FIFO
handling, the auth deadline, the connection limit and the app's token checks.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Replace the crate and material-ball renders in Made in TextureCraft with two
original props, modelled procedurally and textured with TextureCraft's own
materials, masks and mesh-map generators, path traced at 2048 samples.
texturecraft-cli render gains --camera <name> to look through a camera saved
in the project (camera.add), so a render can use an art-directed framing
(distance, target, field of view) rather than only yaw and pitch.
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.
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.
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>