mirror of
https://github.com/storytold/texturecraft.git
synced 2026-11-21 06:50:43 +01:00
Neutral names in code and packaging; README in the Crafting Apps layout
- 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>
This commit is contained in:
1 parent
c155e35907
commit
2ddb156d69
36 files changed
+355
-251
No files matched your search
@@ -21,6 +21,7 @@ licensed and keep their license file next to them.
|
||||
| `docs/images/texturecraft-rendering.png` | README screenshot: Rendering mode, path traced on the GPU | TextureCraft contributors | original screenshot of TextureCraft | MIT OR Apache-2.0 |
|
||||
| `docs/images/texturecraft-light.png` | README screenshot: the light brightness level with the blue accent | TextureCraft contributors | original screenshot of TextureCraft | MIT OR Apache-2.0 |
|
||||
| `docs/images/texturecraft-materials.png` | README render: car paint, velvet and brushed steel on the material ball (`texturecraft-cli render --samples 256`, three renders side by side) | TextureCraft contributors | original render | MIT OR Apache-2.0 |
|
||||
| `docs/images/texturecraft-crate.png` | README render: the built-in crate with chipped paint on wood, rusted iron and tarnished brass smart materials (`texturecraft-cli render --samples 512`, cropped) | TextureCraft contributors | original render by TextureCraft | MIT OR Apache-2.0 |
|
||||
| `docs/brand/artcraft-*.svg`, `docs/brand/artcraft-*.png` | ArtCraft logo and mark | ArtCraft Team | storytold/craftrules `assets/brand/` | ArtCraft brand terms, not open source ([`docs/brand/LICENSE-brand.txt`](docs/brand/LICENSE-brand.txt)) |
|
||||
|
||||
## Third-party assets compiled into the binary
|
||||
|
||||
@@ -7,23 +7,32 @@
|
||||
</a>
|
||||
</p>
|
||||
|
||||
|
||||
<p align="center">
|
||||
<img src="assets/app-icon/hicolor/256x256/apps/ai.storyteller.texturecraft.png" width="128" height="128" alt="TextureCraft icon: an octopus on a rust-orange tile">
|
||||
<img src="assets/app-icon/hicolor/256x256/apps/ai.storyteller.texturecraft.png" width="128" height="128" alt="TextureCraft icon: an engraved zebra on a copper tile">
|
||||
</p>
|
||||
|
||||
<h1 align="center">TextureCraft</h1>
|
||||
|
||||
<p align="center">
|
||||
<b>3D texture painting; an open-source, clean-room reimplementation of Adobe Substance 3D Painter, rebuilt in pure Rust.</b><br>
|
||||
Paint PBR materials straight onto your models in layers with masks, bake mesh maps,<br>
|
||||
drive smart materials from them, and export textures for any engine. Open source, offline, and yours.
|
||||
<b>3D texture painting; an open-source, modern texture painting application, built in pure Rust.</b>
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
<img alt="100% Rust" src="https://img.shields.io/badge/100%25-Rust-b7410e?style=flat-square&logo=rust">
|
||||
<img alt="macOS · Windows · Linux · FreeBSD · Web" src="https://img.shields.io/badge/macOS%20%C2%B7%20Windows%20%C2%B7%20Linux%20%C2%B7%20FreeBSD%20%C2%B7%20Web-native-c2672b?style=flat-square">
|
||||
<img alt="License: MIT OR Apache-2.0" src="https://img.shields.io/badge/license-MIT%20%2F%20Apache--2.0-3a3a3a?style=flat-square">
|
||||
<img alt="Status: early alpha" src="https://img.shields.io/badge/status-early%20alpha-d69e2e?style=flat-square">
|
||||
A fast, open-source 3D texture painting workflow: paint PBR materials straight onto your models in
|
||||
layers with masks, bake mesh maps, drive smart materials from them and export textures for any
|
||||
engine. It runs natively on macOS, Windows, Linux and FreeBSD, and in the browser via WebAssembly.
|
||||
Built by the ArtCraft team.
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
<img alt="Status: in active development" src="https://img.shields.io/badge/status-in%20active%20development-c2672b?style=flat-square">
|
||||
<img alt="Written in pure Rust" src="https://img.shields.io/badge/pure-Rust-b83a24?style=flat-square&logo=rust&logoColor=white">
|
||||
<img alt="Runs on macOS, Windows, Linux, FreeBSD and the web" src="https://img.shields.io/badge/runs%20on-macOS%20%C2%B7%20Windows%20%C2%B7%20Linux%20%C2%B7%20FreeBSD%20%C2%B7%20Web-555555?style=flat-square">
|
||||
<img alt="MCP server for agents" src="https://img.shields.io/badge/agents-MCP%20server-555555?style=flat-square">
|
||||
<img alt="License: MIT OR Apache-2.0" src="https://img.shields.io/badge/license-MIT%20OR%20Apache--2.0-555555?style=flat-square">
|
||||
<br>
|
||||
<a href="https://coderabbit.ai"><img alt="Reviewed by CodeRabbit" src="https://img.shields.io/coderabbit/prs/github/storytold/texturecraft?style=flat-square&label=Reviewed%20by%20CodeRabbit&logo=coderabbit"></a>
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
@@ -40,8 +49,7 @@
|
||||
|
||||
<p align="center">
|
||||
<img src="docs/images/texturecraft-workspace.png" alt="The TextureCraft workspace: the material library on the left; the 3D viewport and the 2D UV view of a material ball in chipped red paint with grime and a hand-painted gold stripe, on a rusted iron base; and the texture set list, layer stack and brush properties on the right" width="100%">
|
||||
<br>
|
||||
<sub>The workspace: asset shelf, 3D viewport, 2D UV view, texture sets, layer stack and properties.</sub>
|
||||
<br><sub><b>The workspace</b>: asset shelf, 3D viewport, 2D UV view, texture sets, layer stack and properties</sub>
|
||||
</p>
|
||||
|
||||
> [!NOTE]
|
||||
@@ -50,223 +58,201 @@
|
||||
> a stylus last week. If you make things, you belong here. **[Come say hi on Discord](https://discord.gg/artcraft).**
|
||||
|
||||
<p align="center">
|
||||
<a href="#features">Features</a> ·
|
||||
<a href="#paint-in-3d">Painting</a> ·
|
||||
<a href="#layers-masks-and-smart-materials">Layers</a> ·
|
||||
<a href="#files-and-texture-sets">Files</a> ·
|
||||
<a href="#bake-and-export">Bake and export</a> ·
|
||||
<a href="#the-viewport">Viewport</a> ·
|
||||
<a href="#built-for-agents">Agents</a> ·
|
||||
<a href="#get-started">Get started</a> ·
|
||||
<a href="#a-look-around">A look around</a> ·
|
||||
<a href="#made-in-texturecraft">Made in TextureCraft</a> ·
|
||||
<a href="#why-texturecraft">Why TextureCraft</a> ·
|
||||
<a href="#quick-start">Quick start</a> ·
|
||||
<a href="#status">Status</a> ·
|
||||
<a href="#downloads">Downloads</a> ·
|
||||
<a href="#the-crafting-apps">Crafting Apps</a> ·
|
||||
<a href="https://discord.gg/artcraft">Discord</a>
|
||||
<a href="#the-crafting-apps">The Crafting Apps</a> ·
|
||||
<a href="#license-and-credits">License</a>
|
||||
</p>
|
||||
|
||||
<br>
|
||||
## A look around
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td width="25%" valign="top">
|
||||
<h3>🎨 Familiar by design</h3>
|
||||
Texture sets, a layer stack with per-channel blending, masks and generators, the tool shelf, the 3D and 2D views: everything sits where a Painter user expects it.
|
||||
</td>
|
||||
<td width="25%" valign="top">
|
||||
<h3>⚡ Native and fast</h3>
|
||||
A tiled, copy-on-write texel engine on every CPU core and a wgpu viewport (Vulkan, Metal, DX12, WebGPU). No Electron, no web view, no waiting.
|
||||
</td>
|
||||
<td width="25%" valign="top">
|
||||
<h3>🧵 Seamless by construction</h3>
|
||||
Brush stamps live on the 3D surface, so strokes flow across UV seams, and the camera's visibility keeps paint off the back of your model.
|
||||
</td>
|
||||
<td width="25%" valign="top">
|
||||
<h3>🤖 Agent-ready</h3>
|
||||
Every action is a command, so you can drive the same engine from the UI, the CLI, a JSON control channel or an MCP server.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="50%" valign="top">
|
||||
<img src="docs/images/texturecraft-bake.png" alt="Bake mode: the texture sets and mesh map bakers on the left, the common bake parameters below them, and the Bake selected textures button under the viewport" width="100%">
|
||||
<p align="center"><sub><b>Bake mesh maps</b>: ambient occlusion, curvature, thickness and more, ray traced on the GPU</sub></p>
|
||||
</td>
|
||||
<td width="50%" valign="top">
|
||||
<img src="docs/images/texturecraft-export.png" alt="The Export textures dialog: texture sets to export, the output directory, an output template, file type, size, padding and normal map format" width="100%">
|
||||
<p align="center"><sub><b>Export textures</b>: presets for common engines, or your own output templates with channel packing</sub></p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td width="50%" valign="top">
|
||||
<img src="docs/images/texturecraft-rendering.png" alt="Rendering mode: the material ball path traced on the GPU at 256 samples with denoising, the gold stripe catching the studio light, and the render settings in a card over the viewport" width="100%">
|
||||
<p align="center"><sub><b>Rendering mode</b> (F10): your textures path traced on the GPU, with a denoiser</sub></p>
|
||||
</td>
|
||||
<td width="50%" valign="top">
|
||||
<img src="docs/images/texturecraft-light.png" alt="TextureCraft in the light brightness level with the blue accent: the same panels as rounded cards on a light background around the dark 3D viewport" width="100%">
|
||||
<p align="center"><sub><b>Light theme</b>: four brightness levels and seven accent colours</sub></p>
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
## Features
|
||||
## Made in TextureCraft
|
||||
|
||||
### Paint in 3D
|
||||
Both pieces below were textured with TextureCraft's procedural materials and smart materials (no
|
||||
textures or models from anywhere else) and path traced on the GPU by `texturecraft-cli render`.
|
||||
|
||||
- **Brushes** with size, flow, stroke opacity, spacing, hardness, angle and follow path; size,
|
||||
angle, flow and position jitter; tangent or camera alignment, angle fade, backface culling, lazy
|
||||
mouse, X/Y/Z mirror symmetry and pen pressure. **67 procedural brush alphas** in their own shelf
|
||||
tab, or any imported image as the alpha.
|
||||
- **Tools:** paint, eraser, **projection** with image stencils (hold S to move, turn and scale the
|
||||
stencil), polygon fill (triangle, UV island or the whole mesh), **path** and **lasso fill**, a
|
||||
**particle brush**, **smudge**, **clone** (V + click sets the source), color picker, Shift+click
|
||||
straight lines, and painting directly in the **2D UV view**.
|
||||
- **Geometry decals:** drop an image on the surface, then move, scale and turn its frame; it stays
|
||||
an editable fill layer.
|
||||
- **Quick mask** (Y): paint a temporary mask (U to edit, Ctrl+Shift+I to invert) that protects
|
||||
everything outside it while you paint.
|
||||
- **Every channel at once:** base color, metallic, roughness, height, normal, emissive, opacity,
|
||||
ambient occlusion and specular level, plus clear coat, sheen, anisotropy, subsurface scattering
|
||||
and transmission, each toggled per stroke, the way Painter's material properties work.
|
||||
<table>
|
||||
<tr>
|
||||
<td width="50%" valign="top">
|
||||
<img src="docs/images/texturecraft-crate.png" alt="A path-traced crate: teal paint chipping off wooden planks, a rusted iron lid and a tarnished brass handle" width="100%">
|
||||
<p align="center"><sub><b>Crate</b>: chipped paint on wood, rusted iron and tarnished brass smart materials, one per texture set</sub></p>
|
||||
</td>
|
||||
<td width="50%" valign="top">
|
||||
<img src="docs/images/texturecraft-materials.png" alt="Three path-traced material balls: glossy red car paint with a clear coat, purple velvet with sheen, and brushed steel with anisotropic highlights" width="100%">
|
||||
<p align="center"><sub><b>Shading lobes</b>: car paint (clear coat), velvet (sheen) and brushed steel (anisotropy)</sub></p>
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
### Layers, masks and smart materials
|
||||
## Why TextureCraft
|
||||
|
||||
- **Paint, fill, folder and instance layers** with **32 blend modes per channel** (Normal through
|
||||
Normal map detail), per-channel opacity, visibility, color tags, drag-and-drop reordering,
|
||||
duplicate, group, flatten, cut, copy and paste across texture sets.
|
||||
- **Filters and content effects** on any layer or mask: **18 filters** (HSL, levels,
|
||||
contrast/luminosity, color balance, gradient map, posterize, clamp, invert, threshold, blur,
|
||||
directional and slope blur, sharpen, warp 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
|
||||
gradients, all with world-space noise), filters, ID color selection and compare. Alt+click a
|
||||
mask to view it alone.
|
||||
- **Fill layers** take uniform values, **22 procedurals** (clouds, cells, grunge, scratches, wood
|
||||
grain, bricks, fabric weave, leather grain, marble veins, Voronoi, paint chips…) or your own
|
||||
**images**, through UV, tri-planar, planar, spherical, cylindrical or decal projection.
|
||||
- **48 materials** (metals from measured reflectance, car paint, brushed anisotropic steel,
|
||||
velvet, skin, wax, glass, woods, stone, plastics, fabric, leather, ceramic), **17 smart
|
||||
materials** (rusted iron, worn paint, oxidized copper, bronze statue, weathered wood, mossy
|
||||
brick…) and **10 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.
|
||||
- **Familiar.** The layout, tools, menus, panels and shortcuts texture artists already know: texture
|
||||
sets, a layer stack with per-channel blending, masks and generators, smart materials, the tool
|
||||
shelf, the 3D and 2D views. You already know how to use it.
|
||||
- **Fast.** A tiled, copy-on-write texel engine on every CPU core and a wgpu viewport (Vulkan,
|
||||
Metal, DX12, WebGPU). Mesh maps bake on the GPU about 12× faster than on the CPU, Rendering mode
|
||||
path traces about 25× faster, and 8K texture sets stay responsive while you paint.
|
||||
- **Seamless.** Brush stamps live on the 3D surface, so strokes flow across UV seams, and the
|
||||
camera's visibility keeps paint off the back of your model.
|
||||
- **Robust.** No panics in shipped code, every command tested with hostile input, unlimited undo
|
||||
from copy-on-write snapshots, and lossless `.tcraft` projects.
|
||||
- **Open.** glTF/GLB, FBX, COLLADA, USD, Alembic, OBJ, PLY and STL in; PNG, JPEG, TGA, TIFF, BMP,
|
||||
WEBP, EXR and HDR textures out at 8, 16 or 32 bits, with UDIM tiles; OBJ, textured GLB and USD
|
||||
mesh export. Every material, environment, brush alpha and built-in mesh is procedural.
|
||||
- **Agent-native.** Every menu item and tool is a command you can drive from the CLI, a JSON
|
||||
control channel or an **MCP server**, so Claude and other agents can paint, bake and export the
|
||||
way a person does.
|
||||
- **Everywhere.** One codebase for the desktop apps and the same UI in the browser.
|
||||
|
||||
<p align="center">
|
||||
<img src="docs/images/texturecraft-materials.png" alt="Three path-traced material balls: glossy red car paint with a clear coat, purple velvet with sheen, and brushed steel with anisotropic highlights, rendered with texturecraft-cli render --samples 256" width="100%">
|
||||
<br>
|
||||
<sub>Car paint (clear coat), velvet (sheen) and brushed steel (anisotropy), path traced on the GPU by <code>texturecraft-cli render</code>.</sub>
|
||||
</p>
|
||||
The full list of what's in it is in [`docs/features.md`](docs/features.md).
|
||||
|
||||
### Files and texture sets
|
||||
|
||||
- **Open** glTF/GLB, FBX (binary and ASCII), COLLADA, **USD** (usda, usdc, usdz), **Alembic**,
|
||||
OBJ, PLY and STL, or a built-in mesh; UVs are generated when a mesh has none. Reimport a changed
|
||||
mesh and your painted strokes stay on the surface.
|
||||
- **UDIM / UV tiles:** detected on import or switched on later, with a resolution per tile and one
|
||||
texture per tile on export (`$udim`).
|
||||
- **Texture sets** from 128 to 8192 px per material, resampled when you change them, with 21
|
||||
channel types to add or remove.
|
||||
- **Projects** are a single `.tcraft` file: the mesh, every layer (sparse and lossless), baked maps
|
||||
and imported images. **Project templates** start new work from a saved setup.
|
||||
|
||||
### Bake and export
|
||||
|
||||
- **Bake mesh maps** on the GPU (ray traced, about 12× the CPU path) or on every CPU core: ambient
|
||||
occlusion, curvature, thickness, world-space normal, position, ID, bent normals, opacity, color
|
||||
and direction maps, and normal and height maps from high-poly meshes, with a cage, ray distances
|
||||
and matching by mesh name.
|
||||
- **Export presets** for glTF PBR Metal Roughness, Unreal Engine (packed), Unity HDRP (mask map),
|
||||
Unity Standard, Blender (Principled BSDF), separate maps, mesh maps and document channels, in
|
||||
PNG, JPEG, TGA, TIFF, BMP, WEBP, EXR or HDR at 8, 16 or 32 bits, with UV padding, size
|
||||
override and OpenGL or DirectX normals.
|
||||
- **Output template editor:** build your own presets with per-channel packing and converted maps,
|
||||
and share them as JSON.
|
||||
- **Mesh export** to OBJ, textured GLB (with clear coat and sheen) and USD.
|
||||
|
||||
<p align="center">
|
||||
<img src="docs/images/texturecraft-bake.png" alt="Bake mode: the texture sets and mesh map bakers on the left, the common bake parameters below them, and the Bake selected textures button under the viewport" width="49%">
|
||||
<img src="docs/images/texturecraft-export.png" alt="The Export textures dialog: texture sets to export, the output directory, an output template, file type, size, padding and normal map format" width="49%">
|
||||
</p>
|
||||
|
||||
### The viewport
|
||||
|
||||
- Physically based shading (metallic/roughness or specular/glossiness) with clear coat, sheen,
|
||||
anisotropy, subsurface scattering, transmission and parallax occlusion; image-based lighting from
|
||||
six procedural studio and outdoor environments or **your own HDR/EXR panoramas**; ACES or linear
|
||||
tone mapping, key-light shadows, bloom, vignette, sharpen, grain, **depth of field** and
|
||||
**saved cameras** (also imported from glTF).
|
||||
- **Rendering mode** (F10): a progressive, **path-traced** view of your textures with multi-bounce
|
||||
light, environment importance sampling, a denoiser and one-click PNG save, traced on the GPU
|
||||
(compute shaders, about 25× the CPU tracer, desktop and WebGPU) or on the CPU.
|
||||
- View any channel, any baked mesh map, or a UV checker; Alt+drag to orbit, middle-drag to pan,
|
||||
wheel to zoom, F to frame, M / C / B to cycle views.
|
||||
|
||||
<p align="center">
|
||||
<img src="docs/images/texturecraft-rendering.png" alt="Rendering mode: the material ball path traced on the GPU at 256 samples with denoising, the gold stripe catching the studio light, and the render settings in a card over the viewport" width="100%">
|
||||
</p>
|
||||
|
||||
### Interface
|
||||
|
||||
- A modern look in **four brightness levels** (dark, medium dark, medium light and light) with
|
||||
**seven accent colors**, set in Settings › Interface.
|
||||
- **Dockable, tabbed and floating panels**, saved layouts, and panels that reopen where you closed
|
||||
them.
|
||||
- A **shortcut editor** with conflict detection, and every shortcut shown in its tooltip.
|
||||
- **9 languages:** English, French, German, Spanish, Portuguese, Italian, Japanese, Chinese and
|
||||
Korean, switchable live.
|
||||
- **In the browser:** the same app compiled to WebAssembly, on WebGPU or WebGL2, with touch
|
||||
navigation and project open, save and download.
|
||||
|
||||
<p align="center">
|
||||
<img src="docs/images/texturecraft-light.png" alt="TextureCraft in the light brightness level with the blue accent: the same panels as rounded cards on a light background around the dark 3D viewport" width="100%">
|
||||
</p>
|
||||
|
||||
## Built for agents
|
||||
|
||||
Everything you can do in the window, an agent can do too:
|
||||
|
||||
- **CLI:** `texturecraft-cli new builtin:material_ball out.tcraft`, `bake`, `export`, `render`,
|
||||
`run <command> <params>`, `commands`.
|
||||
- **MCP server:** `texturecraft-cli mcp` gives Claude and other agents tools to create projects,
|
||||
add layers and masks, paint strokes, bake, export, render previews and inspect everything they
|
||||
changed.
|
||||
- **Control channel:** launch the app with `--control <port>` to drive the running UI: run any
|
||||
command, invoke menu items, paint, and take screenshots.
|
||||
|
||||
See [`docs/control-protocol.md`](docs/control-protocol.md) for the full protocol and examples.
|
||||
|
||||
## Get started
|
||||
|
||||
You need a recent stable Rust toolchain (1.95 or newer).
|
||||
## Quick start
|
||||
|
||||
```sh
|
||||
git clone https://github.com/storytold/texturecraft
|
||||
cd texturecraft
|
||||
cargo run --release -p texturecraft
|
||||
|
||||
cargo run --release -p texturecraft # desktop app (opens a sample project)
|
||||
cargo run --release -p texturecraft -- model.glb # a new project from a mesh
|
||||
cargo run --release -p texturecraft -- --control 7878 # + JSON control channel
|
||||
cargo run --release -p texturecraft-cli -- mcp # MCP server (stdio)
|
||||
cargo run --release -p texturecraft-cli -- new builtin:crate crate.tcraft --sample
|
||||
cargo run --release -p texturecraft-cli -- render crate.tcraft crate.png --samples 256 # path traced
|
||||
cargo run --release -p texturecraft-cli -- export crate.tcraft textures # headless export
|
||||
cd apps/texturecraft-web && trunk serve # web build
|
||||
cargo xtask ci # fmt, clippy, tests, layering, wasm
|
||||
```
|
||||
|
||||
The app opens with a baked sample project. **File ▸ New project** starts from one of the built-in
|
||||
meshes, a project template, or your own glTF, GLB, FBX, COLLADA, USD, Alembic, OBJ, PLY or STL
|
||||
file (UVs are generated if the mesh has none). For the browser build, run `trunk serve` in
|
||||
`apps/texturecraft-web`.
|
||||
You need Rust 1.95 or newer. The app opens with a baked sample project; **File ▸ New project** starts
|
||||
from a built-in mesh, a project template or your own mesh file (UVs are generated if it has none).
|
||||
|
||||
Run the tests with `cargo test --workspace --release`. The architecture is described in
|
||||
[`docs/architecture.md`](docs/architecture.md), the plan and parity estimate in
|
||||
[`ROADMAP.md`](ROADMAP.md), and contributor rules in [`AGENTS.md`](AGENTS.md).
|
||||
Japanese, Chinese and Korean interface text uses the fonts of
|
||||
[storytold/craft-fonts](https://github.com/storytold/craft-fonts) where it has them, an optional
|
||||
build input (releases always use it): `CRAFT_FONTS_DIR="$PWD/../craft-fonts" cargo run --release -p texturecraft`
|
||||
(an absolute path). Without it, the desktop app uses the installed system fonts.
|
||||
|
||||
### Use it from Claude Code and other agents
|
||||
|
||||
Register the MCP server with Claude Code, giving it the folders it may read and write:
|
||||
|
||||
```sh
|
||||
claude mcp add texturecraft -- /path/to/texturecraft-cli mcp --read-root /work/project --write-root /work/project
|
||||
```
|
||||
|
||||
To drive the running app instead, start it with `--control 7878` and bridge to it:
|
||||
|
||||
```sh
|
||||
claude mcp add texturecraft-app -- /path/to/texturecraft-cli mcp --bridge 7878
|
||||
```
|
||||
|
||||
The details are in [`docs/control-protocol.md`](docs/control-protocol.md).
|
||||
|
||||
## Status
|
||||
|
||||
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
|
||||
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
|
||||
speaks English, French, German, Spanish, Portuguese, Italian, Japanese, Chinese and Korean;
|
||||
[localization-parity.md](docs/localization-parity.md) has the details. The scores are self-assessed
|
||||
from our code against public documentation.
|
||||
|
||||
**What's missing:**
|
||||
- hardware ray tracing in Rendering mode;
|
||||
- pen tilt (the windowing layer doesn't report it yet);
|
||||
- high-poly base color textures kept in separate files (a `.gltf`'s image files, a loose USD
|
||||
layer's textures);
|
||||
- cameras from FBX, COLLADA and USD files (glTF cameras are imported), and clear coat in USD export;
|
||||
- Alembic files in the older HDF5 container, and Alembic animation (the first sample is read);
|
||||
- displacement in shadows and the path tracer (the viewport displaces);
|
||||
- a native-speaker review of the translations;
|
||||
- the first signed release on every platform.
|
||||
|
||||
**Where we're going:** the first release on every platform, then the remaining rendering and file
|
||||
format gaps. The ranked list is in [`ROADMAP.md`](ROADMAP.md).
|
||||
|
||||
**Workspace:** `crates/{core, texel, geom, compose, bake, paint, formats, engine, render, automation, ui-egui}`
|
||||
and `apps/{texturecraft, texturecraft-cli, texturecraft-web}`. The egui frontend is its own crate, so
|
||||
the UI can be swapped without touching the engine; [`docs/architecture.md`](docs/architecture.md)
|
||||
explains how it fits together.
|
||||
|
||||
Agent and contributor rules (clean room, the asset policy, no panics in shipped code, quality gates)
|
||||
are in [`AGENTS.md`](AGENTS.md), and [`docs/releasing.md`](docs/releasing.md) explains how releases
|
||||
are built, signed and published. Every bundled asset is listed with its licence in
|
||||
[`ATTRIBUTION.md`](ATTRIBUTION.md).
|
||||
|
||||
## Downloads
|
||||
|
||||
The easiest way to install TextureCraft is from its page on the ArtCraft website:
|
||||
**[getartcraft.com/apps/texturecraft](https://getartcraft.com/apps/texturecraft)**.
|
||||
**New to TextureCraft?** Download it from the [TextureCraft page on getartcraft.com](https://getartcraft.com/apps/texturecraft). That's the easiest way to install it.
|
||||
|
||||
Technical users can grab builds from GitHub: the
|
||||
[latest release](https://github.com/storytold/texturecraft/releases/latest) or
|
||||
[all releases](https://github.com/storytold/texturecraft/releases).
|
||||
**Want a specific build or format?** On GitHub, the [latest release](https://github.com/storytold/texturecraft/releases/latest) has every build listed below, and [all releases](https://github.com/storytold/texturecraft/releases) has earlier versions and their notes. `<ver>` in the file names is the version number, and `SHA256SUMS.txt` lists a checksum for every file.
|
||||
|
||||
| Windows | File |
|
||||
### Windows
|
||||
|
||||
| Build | Installer | Portable |
|
||||
|---|---|---|
|
||||
| x64 (64-bit Intel/AMD) | `texturecraft-<ver>-windows-x64.msi` | `texturecraft-<ver>-windows-x64-portable.zip` |
|
||||
| arm64 (Snapdragon and other ARM PCs) | `texturecraft-<ver>-windows-arm64.msi` | `texturecraft-<ver>-windows-arm64-portable.zip` |
|
||||
| x86 (32-bit) | `texturecraft-<ver>-windows-x86.msi` | `texturecraft-<ver>-windows-x86-portable.zip` |
|
||||
|
||||
### macOS
|
||||
|
||||
| Build | File | Notes |
|
||||
|---|---|---|
|
||||
| App, universal (Apple silicon + Intel) | `texturecraft-<ver>-macos-universal.dmg` | Signed and notarized |
|
||||
| Command-line tool, universal | `texturecraft-cli-<ver>-macos-universal.zip` | Signed and notarized |
|
||||
|
||||
### Linux
|
||||
|
||||
| Format | x86_64 | aarch64 (ARM64) | Notes |
|
||||
|---|---|---|---|
|
||||
| AppImage | `texturecraft-<ver>-linux-x86_64.AppImage` | `texturecraft-<ver>-linux-aarch64.AppImage` | Runs anywhere; updates itself with [AppImageUpdate](https://github.com/AppImageCommunity/AppImageUpdate) (`.zsync` files) |
|
||||
| Flatpak | `texturecraft-<ver>-linux-x86_64.flatpak` | `texturecraft-<ver>-linux-aarch64.flatpak` | Sandboxed; `flatpak install --user <file>` |
|
||||
| Debian/Ubuntu | `texturecraft-<ver>-linux-x86_64.deb` | `texturecraft-<ver>-linux-aarch64.deb` | |
|
||||
| Fedora/RHEL/openSUSE | `texturecraft-<ver>-linux-x86_64.rpm` | `texturecraft-<ver>-linux-aarch64.rpm` | |
|
||||
| Tarball | `texturecraft-<ver>-linux-x86_64.tar.gz` | `texturecraft-<ver>-linux-aarch64.tar.gz` | Unpack anywhere |
|
||||
|
||||
### FreeBSD
|
||||
|
||||
| Build | File |
|
||||
|---|---|
|
||||
| Installer (x64, x86, arm64) | `texturecraft-<version>-windows-<arch>.msi` |
|
||||
| Portable (x64, x86, arm64) | `texturecraft-<version>-windows-<arch>-portable.zip` |
|
||||
| x86_64 | `texturecraft-<ver>-freebsd-x86_64.tar.gz` |
|
||||
|
||||
| macOS | File |
|
||||
|---|---|
|
||||
| Universal app (Apple silicon and Intel), signed and notarized | `texturecraft-<version>-macos-universal.dmg` |
|
||||
| Command-line tools | `texturecraft-cli-<version>-macos-universal.zip` |
|
||||
### Web (WebAssembly)
|
||||
|
||||
| Linux (x86_64, aarch64) | File |
|
||||
|---|---|
|
||||
| AppImage (any distribution) | `texturecraft-<version>-linux-<arch>.AppImage` |
|
||||
| Debian, Ubuntu, Mint, Pop!_OS | `texturecraft-<version>-linux-<arch>.deb` |
|
||||
| Fedora, openSUSE, RHEL | `texturecraft-<version>-linux-<arch>.rpm` |
|
||||
| Flatpak bundle | `texturecraft-<version>-linux-<arch>.flatpak` |
|
||||
| Plain archive | `texturecraft-<version>-linux-<arch>.tar.gz` |
|
||||
|
||||
| FreeBSD | File |
|
||||
|---|---|
|
||||
| x86_64 | `texturecraft-<version>-freebsd-x86_64.tar.gz` |
|
||||
|
||||
| Web (WebAssembly) | File |
|
||||
|---|---|
|
||||
| Static site to host or embed | `texturecraft-web-<version>.zip` |
|
||||
| Build | File | Notes |
|
||||
|---|---|---|
|
||||
| Static site | `texturecraft-web-<ver>.zip` | Runs in a modern browser; host it on any static server |
|
||||
|
||||
## The Crafting Apps
|
||||
|
||||
@@ -276,9 +262,9 @@ stand on its own.
|
||||
|
||||
| | App | What it's for | Code | Learn more |
|
||||
|:-:|---|---|---|---|
|
||||
| <img src="https://raw.githubusercontent.com/storytold/texturecraft/main/assets/app-icon/hicolor/64x64/apps/ai.storyteller.texturecraft.png" alt="" width="32" height="32"> | **TextureCraft** | **3D texture painting · you are here** | [GitHub](https://github.com/storytold/texturecraft) | [Website](https://getartcraft.com/apps/texturecraft) |
|
||||
| <img src="https://raw.githubusercontent.com/storytold/photocraft/main/assets/app-icon/hicolor/64x64/apps/ai.storyteller.photocraft.png" alt="" width="32" height="32"> | **PhotoCraft** | Image editing: layers, masks, type and real PSD files | [GitHub](https://github.com/storytold/photocraft) | [Website](https://getartcraft.com/apps/photocraft) |
|
||||
| <img src="https://raw.githubusercontent.com/storytold/vectorcraft/main/assets/app-icon/hicolor/64x64/apps/ai.storyteller.vectorcraft.png" alt="" width="32" height="32"> | **VectorCraft** | Vector illustration | [GitHub](https://github.com/storytold/vectorcraft) | [Website](https://getartcraft.com/apps/vectorcraft) |
|
||||
| <img src="https://raw.githubusercontent.com/storytold/texturecraft/main/assets/app-icon/hicolor/64x64/apps/ai.storyteller.texturecraft.png" alt="" width="32" height="32"> | **TextureCraft** | **3D texture painting · you are here** | [GitHub](https://github.com/storytold/texturecraft) | [Website](https://getartcraft.com/apps/texturecraft) |
|
||||
| <img src="https://raw.githubusercontent.com/storytold/filmcraft/main/assets/app-icon/hicolor/64x64/apps/ai.storyteller.filmcraft.png" alt="" width="32" height="32"> | **FilmCraft** | Video editing, color and sound | [GitHub](https://github.com/storytold/filmcraft) | [Website](https://getartcraft.com/apps/filmcraft) |
|
||||
| <img src="https://raw.githubusercontent.com/storytold/lightcraft/main/assets/app-icon/hicolor/64x64/apps/ai.storyteller.lightcraft.png" alt="" width="32" height="32"> | **LightCraft** | Photo library and raw development | [GitHub](https://github.com/storytold/lightcraft) | [Website](https://getartcraft.com/apps/lightcraft) |
|
||||
| <img src="https://raw.githubusercontent.com/storytold/pdfcraft/main/assets/app-icon/hicolor/64x64/apps/ai.storyteller.pdfcraft.png" alt="" width="32" height="32"> | **PdfCraft** | Reading, organizing and protecting PDFs | [GitHub](https://github.com/storytold/pdfcraft) | [Website](https://getartcraft.com/apps/pdfcraft) |
|
||||
@@ -310,24 +296,31 @@ And [**ArtCraft**](https://getartcraft.com/) itself, our AI image and video stud
|
||||
<a href="https://getartcraft.com/apps/texturecraft">TextureCraft</a>
|
||||
</p>
|
||||
|
||||
## Star history
|
||||
|
||||
[](https://www.star-history.com/?repos=storytold%2Ftexturecraft&type=date&legend=top-left)
|
||||
|
||||
## License and credits
|
||||
|
||||
TextureCraft is dual-licensed under [MIT](LICENSE-MIT) or [Apache-2.0](LICENSE-APACHE), at your option.
|
||||
Copyright (c) 2026 ArtCraft Team and the TextureCraft contributors. Required notices are in [NOTICE](NOTICE).
|
||||
|
||||
Bundled fonts, icons, images and other assets keep their own open licenses; each one is listed
|
||||
with its author, source and license in [ATTRIBUTION.md](ATTRIBUTION.md).
|
||||
with its author, source and license in [ATTRIBUTION.md](ATTRIBUTION.md). Release builds also embed
|
||||
the fonts of [craft-fonts](https://github.com/storytold/craft-fonts/blob/main/ATTRIBUTION.md)
|
||||
(Japanese and Simplified Chinese faces; SIL Open Font License 1.1).
|
||||
|
||||
Every material, environment, brush alpha and mesh shown is generated procedurally by TextureCraft
|
||||
itself; no third-party textures or models appear in the screenshots.
|
||||
|
||||
The app icon (an engraved zebra on TextureCraft copper, `#c2672b`) is the owner's original artwork;
|
||||
its files are in [`assets/app-icon/`](assets/app-icon/).
|
||||
|
||||
The ArtCraft name, wordmark and logos in [`docs/brand/`](docs/brand/) are trademarks of the
|
||||
ArtCraft Team and are not covered by this license. They may be used only unmodified, and only as
|
||||
part of this repository and TextureCraft, under [`docs/brand/LICENSE-brand.txt`](docs/brand/LICENSE-brand.txt).
|
||||
Forks and modified versions must remove them.
|
||||
|
||||
<sub>Adobe, Substance 3D Painter, Photoshop, Illustrator, Premiere Pro, Lightroom, Acrobat, After Effects and InDesign are trademarks or registered trademarks of Adobe Inc. in the United States and/or other countries. TextureCraft is an independent, open-source project and is not affiliated with, sponsored by or endorsed by Adobe Inc.; these names are used only to describe the workflows it is compatible with.</sub>
|
||||
|
||||
<p align="center">
|
||||
<a href="https://getartcraft.com/"><img alt="ArtCraft" src="docs/brand/artcraft-mark.svg" width="28"></a><br>
|
||||
<sub>Made by the <a href="https://getartcraft.com/">ArtCraft</a> team and community.</sub>
|
||||
|
||||
@@ -164,7 +164,7 @@ pub struct StrokeParams {
|
||||
/// -1..1
|
||||
#[serde(default, skip_serializing_if = "Option::is_none")]
|
||||
pub height: Option<f64>,
|
||||
/// Brush size 0..100 (Painter's scale).
|
||||
/// Brush size 0..100 (percent of the largest brush).
|
||||
#[serde(default, skip_serializing_if = "Option::is_none")]
|
||||
pub size: Option<f64>,
|
||||
/// Brush hardness 0..100.
|
||||
|
||||
@@ -36,7 +36,7 @@ pub struct Layer {
|
||||
/// Effects applied to the layer's content, bottom → top.
|
||||
#[serde(default)]
|
||||
pub content_effects: Vec<Effect>,
|
||||
/// Painter-style color tag (0..8), shown as a stripe on the layer row.
|
||||
/// Color tag (0..8), shown as a stripe on the layer row.
|
||||
#[serde(default)]
|
||||
pub color_tag: Option<u8>,
|
||||
/// Combine the mask with the layer's height ("mask with height").
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
//!
|
||||
//! The TextureCraft document model: a [`Project`] holds texture sets (one per mesh material),
|
||||
//! each with a stack of [`Layer`]s (paint, fill, group) whose channels blend with one of
|
||||
//! Painter's [`BlendMode`]s. Pure data with serde; pixels live in `texturecraft-texel` images
|
||||
//! the [`BlendMode`]s. Pure data with serde; pixels live in `texturecraft-texel` images
|
||||
//! owned by the engine. [`blend`] is the CPU reference for every blend mode.
|
||||
#![forbid(unsafe_code)]
|
||||
#![deny(clippy::unwrap_used, clippy::expect_used, clippy::panic, clippy::unimplemented, clippy::todo, clippy::unreachable)]
|
||||
|
||||
@@ -107,7 +107,7 @@ impl BakedMap {
|
||||
}
|
||||
}
|
||||
|
||||
/// How low-poly parts find their high-poly counterparts (Painter's "Match").
|
||||
/// How low-poly parts find their high-poly counterparts (the bake "Match" option).
|
||||
#[derive(Clone, Copy, Debug, PartialEq, Eq, Serialize, Deserialize, Default)]
|
||||
pub enum BakeMatch {
|
||||
/// Every low-poly part sees every high-poly part.
|
||||
@@ -177,7 +177,7 @@ impl Default for RaySettings {
|
||||
}
|
||||
}
|
||||
|
||||
/// Bake parameters (Painter's "Common parameters" plus the per-map parameters). Fields missing
|
||||
/// Bake parameters (the common parameters plus the per-map parameters). Fields missing
|
||||
/// from older projects take their defaults.
|
||||
#[derive(Clone, Debug, PartialEq, Serialize, Deserialize)]
|
||||
#[serde(default)]
|
||||
@@ -300,7 +300,7 @@ pub struct TextureSet {
|
||||
pub baked: BTreeSet<BakedMap>,
|
||||
#[serde(default = "yes")]
|
||||
pub visible: bool,
|
||||
/// UDIM numbers of the UV tiles this set paints, ascending (Painter's "UV Tiles" mode);
|
||||
/// UDIM numbers of the UV tiles this set paints, ascending (UV tiles mode);
|
||||
/// empty for a classic set covering UV 0..1. Each tile is one block of an atlas laid out by
|
||||
/// [`TileGrid`], [`TextureSet::block_resolution`] texels square.
|
||||
#[serde(default, skip_serializing_if = "Vec::is_empty")]
|
||||
@@ -483,7 +483,7 @@ pub enum ToneMapping {
|
||||
AcesFilmic,
|
||||
}
|
||||
|
||||
/// Viewport display settings (saved with the project, as Painter does). Fields missing from
|
||||
/// Viewport display settings (saved with the project). Fields missing from
|
||||
/// older projects take their defaults.
|
||||
#[derive(Clone, Debug, PartialEq, Serialize, Deserialize)]
|
||||
#[serde(default)]
|
||||
@@ -526,7 +526,7 @@ pub struct DisplaySettings {
|
||||
pub dof: DepthOfField,
|
||||
}
|
||||
|
||||
/// A thin-lens camera's depth of field (Painter's Display settings: focus distance and aperture).
|
||||
/// A thin-lens camera's depth of field (Display settings: focus distance and aperture).
|
||||
#[derive(Clone, Copy, Debug, PartialEq, Serialize, Deserialize)]
|
||||
#[serde(default, rename_all = "camelCase")]
|
||||
pub struct DepthOfField {
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
//! Mesh-map baking commands (Painter's "Bake Mesh Maps" window): bake settings, the
|
||||
//! Mesh-map baking commands (the "Bake Mesh Maps" window): bake settings, the
|
||||
//! high-definition mesh list, the cage, and running a bake. Bakes cast their rays on the GPU
|
||||
//! tracer the app installs ([`install_gpu_tracer`]) and on the CPU otherwise.
|
||||
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
//! The camera list (Painter's viewport camera menu: the default camera plus saved and imported
|
||||
//! The camera list (the viewport camera menu: the default camera plus saved and imported
|
||||
//! cameras, saved with the project) and the depth of field focus pick.
|
||||
|
||||
use serde_json::{Value, json};
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
//! The command registry. Every user-visible action is a command with a stable id; the menus,
|
||||
//! shortcuts, CLI, control channel and MCP server all dispatch them by id. Ids follow
|
||||
//! Painter's menu structure (see `menu_catalog`).
|
||||
//! the menu structure (see `menu_catalog`).
|
||||
|
||||
use serde_json::{Value, json};
|
||||
use texturecraft_core::{BlendMode, Channel};
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
//! Geometry decals: an image resource projected onto the surface from a frame placed on it
|
||||
//! (Painter's decal fill with a planar projection), as a fill layer with a decal projection.
|
||||
//! (a decal fill with a planar projection), as a fill layer with a decal projection.
|
||||
|
||||
use serde_json::{Value, json};
|
||||
use texturecraft_core::{Channel, Decal, Fill, Layer, LayerId, LayerKind, Projection, Source};
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
//! The filter library (Painter's Filters shelf): adjustment, blur and distortion filters for
|
||||
//! The filter library (the Filters shelf): adjustment, blur and distortion filters for
|
||||
//! layer content and masks, and material finishes (content only). `effect.add.filter` adds one
|
||||
//! by id; `filter.list` lists them with their default parameters.
|
||||
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
//! Preserve strokes on mesh reimport (Painter's "Preserve strokes positions on mesh"): when the
|
||||
//! Preserve strokes on mesh reimport ("Preserve strokes positions on mesh"): when the
|
||||
//! reimported mesh's UVs differ, painted pixels follow the surface instead of the UV layout.
|
||||
//! Each covered texel of the new layout finds the nearest point of the old surface (same
|
||||
//! material, facing the same way when there is one) and reads the old texel there. Fills and
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
//! Quick mask (Painter: Y enables, U edits, Ctrl+Shift+I inverts): a temporary texel mask per
|
||||
//! Quick mask (Y enables, U edits, Ctrl+Shift+I inverts): a temporary texel mask per
|
||||
//! texture set, painted with the normal brush while editing, that limits every paint stroke
|
||||
//! while enabled. Session state only: not saved and not in the undo history.
|
||||
|
||||
|
||||
@@ -138,7 +138,7 @@ pub enum ViewMode {
|
||||
MeshMap(texturecraft_core::BakedMap),
|
||||
/// UV checker (texel density and seams).
|
||||
UvChecker,
|
||||
/// One layer's mask, in grayscale (Painter: Alt+click a mask).
|
||||
/// One layer's mask, in grayscale (Alt+click a mask).
|
||||
Mask(LayerId),
|
||||
}
|
||||
|
||||
@@ -163,7 +163,7 @@ pub enum FillMode {
|
||||
Mesh,
|
||||
}
|
||||
|
||||
/// A screen-pinned image for the Projection tool (Painter's stencil).
|
||||
/// A screen-pinned image for the Projection tool (a stencil).
|
||||
#[derive(Clone, Debug, PartialEq, Serialize, Deserialize)]
|
||||
pub struct StencilState {
|
||||
/// Image resource name.
|
||||
@@ -210,7 +210,7 @@ pub struct ToolState {
|
||||
/// Smudge tool: how much of the picked-up values each stamp deposits (0..1).
|
||||
#[serde(default = "default_smudge_strength")]
|
||||
pub smudge_strength: f32,
|
||||
/// Clone tool source (Painter: V + click).
|
||||
/// Clone tool source (V + click).
|
||||
#[serde(default)]
|
||||
pub clone_source: Option<CloneSource>,
|
||||
/// What the Clone tool copies: the composite or the selected layer alone.
|
||||
@@ -225,7 +225,7 @@ fn default_smudge_strength() -> f32 {
|
||||
0.5
|
||||
}
|
||||
|
||||
/// What the Clone tool copies (Painter's clone source modes).
|
||||
/// What the Clone tool copies (the clone source modes).
|
||||
#[derive(Clone, Copy, Debug, PartialEq, Eq, Serialize, Deserialize, Default)]
|
||||
pub enum CloneFrom {
|
||||
/// Everything the texture set shows.
|
||||
@@ -409,7 +409,7 @@ impl Session {
|
||||
Session::new_project_tiled(name, mesh, mesh_ref, mesh_source, resolution, None)
|
||||
}
|
||||
|
||||
/// [`Session::new_project`] choosing Painter's UV tile (UDIM) mode: `Some(true)` for every
|
||||
/// [`Session::new_project`] choosing the UV tile (UDIM) mode: `Some(true)` for every
|
||||
/// set, `Some(false)` for none, `None` for the sets whose UVs leave tile 1001.
|
||||
pub fn new_project_tiled(
|
||||
name: &str,
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
//! Project templates (Painter's "Template" in the New project dialog): preset channel lists,
|
||||
//! Project templates ("Template" in the New project dialog): preset channel lists,
|
||||
//! normal format, resolution and shader settings a new project starts from. Built-in templates
|
||||
//! are read-only; the user's are saved from the current project and, on the desktop, mirrored
|
||||
//! as `<name>.json` files in a library folder (see [`Session::load_templates`]).
|
||||
|
||||
@@ -345,8 +345,8 @@ fn schema_compound<'p>(props: &'p [Prop], schema: &str, name: &str) -> Option<&'
|
||||
|
||||
impl Walk<'_, '_> {
|
||||
/// The children of object group `r`, placed by `parent` (world matrix); `xform` names the
|
||||
/// Xform object `r` is (empty otherwise): meshes take their transform's name, as in Maya
|
||||
/// (`pCube1` / `pCubeShape1`) and Blender (object / mesh data).
|
||||
/// Xform object `r` is (empty otherwise): meshes take their transform's name, as DCC
|
||||
/// exports expect (`pCube1` / `pCubeShape1`, object / mesh data).
|
||||
fn object(&mut self, r: u64, parent: Mat4, xform: &str, depth: usize) -> Result<()> {
|
||||
self.visits += 1;
|
||||
if depth > MAX_DEPTH || self.visits > MAX_OBJECT_VISITS {
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
//! Autodesk FBX 6.x and 7.x, binary (32- and 64-bit node records, zlib-compressed arrays) and
|
||||
//! FBX 6.x and 7.x, binary (32- and 64-bit node records, zlib-compressed arrays) and
|
||||
//! ASCII: mesh geometry with normals, UVs and per-polygon materials from the layer elements, every
|
||||
//! Model's transform and parent hierarchy, and the file's unit and axis system (converted to
|
||||
//! meters, Y up, like glTF). FBX 6 keeps the geometry inside its Model, names objects instead of
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
//! Pixar USD: `.usda` (text), `.usdc` (Crate binary), `.usd` (either, by magic) and `.usdz`
|
||||
//! USD: `.usda` (text), `.usdc` (Crate binary), `.usd` (either, by magic) and `.usdz`
|
||||
//! (zip package; its first layer is read). Both encodings parse into one [`Layer`]; the stage is
|
||||
//! then composed (internal references, prim hierarchy, xform ops) and every `Mesh` prim becomes
|
||||
//! polygons in world space: points, faceVertexCounts/Indices (holes skipped), normals
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
//! Orbit camera (Painter-style navigation) and picking rays.
|
||||
//! Orbit camera (texture painting navigation) and picking rays.
|
||||
|
||||
use glam::{Mat4, Vec2, Vec3, Vec4};
|
||||
use serde::{Deserialize, Serialize};
|
||||
|
||||
@@ -159,7 +159,7 @@ impl Default for Particles {
|
||||
}
|
||||
}
|
||||
|
||||
/// Brush parameters (the Painter "Brush" properties section plus tool-bar values).
|
||||
/// Brush parameters (the "Brush" properties section plus tool-bar values).
|
||||
#[derive(Clone, Debug, PartialEq, Serialize, Deserialize)]
|
||||
pub struct BrushSettings {
|
||||
/// Radius as a fraction of the mesh bounding-box diagonal (the UI shows 0–100).
|
||||
|
||||
@@ -19,7 +19,7 @@ pub fn mesh_map_rgba(baked: Option<&BakedMaps>, m: BakedMap, size: u32) -> Vec<u
|
||||
let v = b.sample(m, x, sy, size).unwrap_or([0.5; 3]);
|
||||
let i = ((y * size + x) * 4) as usize;
|
||||
for k in 0..3 {
|
||||
// Data maps are shown as stored (like Painter), i.e. treated as display values.
|
||||
// Data maps are shown as stored, i.e. treated as display values.
|
||||
out[i + k] = (v[k].clamp(0.0, 1.0) * 255.0 + 0.5) as u8;
|
||||
}
|
||||
out[i + 3] = 255;
|
||||
|
||||
@@ -112,7 +112,7 @@ pub struct Shade {
|
||||
pub normal_y: f32,
|
||||
/// 0 material, 1 channel, 2 mesh map (aux texture), 3 UV checker.
|
||||
pub view_mode: u32,
|
||||
/// Channel index for view mode 1 (Painter channel order, see the shader).
|
||||
/// Channel index for view mode 1 (channel order, see the shader).
|
||||
pub channel: u32,
|
||||
/// Direction to an optional key light and its intensity (0 = off). The direction is in
|
||||
/// environment space: it turns with `env_rotation_deg` like the lights painted into the
|
||||
@@ -123,7 +123,7 @@ pub struct Shade {
|
||||
/// Key-light shadow map (needs `light[3] > 0`; 3D material view only). Shadows dim the key
|
||||
/// light, not the image-based lighting.
|
||||
pub shadows: bool,
|
||||
/// Master switch of the effects below (Painter's "Post effects"); off costs no extra pass.
|
||||
/// Master switch of the effects below ("Post effects"); off costs no extra pass.
|
||||
/// Effects never apply to data views (channels, mesh maps, UV checker, 2D view).
|
||||
pub post_effects: bool,
|
||||
/// Effect strengths, 0..1.
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
[package]
|
||||
name = "texturecraft-ui-egui"
|
||||
description = "TextureCraft's egui shell: Painter-style docks, toolbars, viewports and windows"
|
||||
description = "TextureCraft's egui shell: docks, toolbars, viewports and windows"
|
||||
version.workspace = true
|
||||
edition.workspace = true
|
||||
license.workspace = true
|
||||
|
||||
@@ -620,7 +620,7 @@ pub(crate) fn texture_set_settings(app: &mut TextureCraftApp, ui: &mut Ui) {
|
||||
app.run("textureSet.uvTiles", json!({"ts": ts, "enabled": tiled}));
|
||||
}
|
||||
ui.end_row();
|
||||
// Each tile's own size (Painter's per-tile resolution).
|
||||
// Each tile's own size (per-tile resolution).
|
||||
for &udim in &set.uv_tiles {
|
||||
let r = set.tile_resolution(udim);
|
||||
ui.label(RichText::new(format!(" {udim}")).color(tk.text_dim));
|
||||
|
||||
@@ -171,7 +171,7 @@ fn split(vertical: bool, fraction: f32, first: Node, second: Node) -> Node {
|
||||
}
|
||||
|
||||
impl Default for Layout {
|
||||
/// Painter's default: assets left of the viewport; texture set list, layers (tabbed with the
|
||||
/// The default: assets left of the viewport; texture set list, layers (tabbed with the
|
||||
/// texture set settings) and properties down the right. Fractions match the 1600x960 window.
|
||||
fn default() -> Self {
|
||||
use Panel::*;
|
||||
@@ -562,7 +562,7 @@ impl TabViewer for Host<'_> {
|
||||
fn title(&mut self, tab: &mut Panel) -> WidgetText {
|
||||
let text = match tab {
|
||||
Panel::Properties => crate::dock::properties_title(self.app),
|
||||
// Bake mode shows its settings where the shelf lives, as Painter does.
|
||||
// Bake mode shows its settings where the shelf lives.
|
||||
Panel::Assets if self.app.ui.mode == crate::state::Mode::Baking => tr("Bake Mesh Maps").to_string(),
|
||||
p => tr(p.name()).to_string(),
|
||||
};
|
||||
@@ -617,7 +617,7 @@ impl TabViewer for Host<'_> {
|
||||
}
|
||||
|
||||
/// The dock look: every panel group is a rounded card on the window's frame colour, its tab strip
|
||||
/// without hard lines, the shown tab a rounded pill, Painter-style uppercase captions.
|
||||
/// without hard lines, the shown tab a rounded pill, uppercase captions.
|
||||
fn style(egui_style: &egui::Style, t: &Tokens) -> Style {
|
||||
let card = crate::theme::CARD_RADIUS;
|
||||
let mut s = Style::from_egui(egui_style);
|
||||
|
||||
@@ -32,7 +32,7 @@ const fn sep(menu: &'static str) -> Item {
|
||||
|
||||
pub const TOP: [&str; 6] = ["File", "Edit", "Mode", "Window", "Viewport", "Help"];
|
||||
|
||||
/// The menu catalog (Painter's menu tree with our ids).
|
||||
/// The menu catalog (the target menu tree with our ids).
|
||||
pub const CATALOG: &[Item] = &[
|
||||
it("File", "New project...", "ui.newProject", Some("Ctrl+N")),
|
||||
it("File", "Open...", "file.open", Some("Ctrl+O")),
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
//! Menu parity with Painter: which catalog items are live. `cargo test -p texturecraft-ui-egui
|
||||
//! Menu parity with the target menu tree: which catalog items are live. `cargo test -p texturecraft-ui-egui
|
||||
//! parity` checks the floor; with `TC_UPDATE_PARITY=1` it rewrites `docs/parity.md`.
|
||||
|
||||
use crate::menus::{CATALOG, implemented};
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
//! The asset shelf (the Assets dock tab): Painter-style tabs (materials, smart materials, smart
|
||||
//! The asset shelf (the Assets dock tab): tabs (materials, smart materials, smart
|
||||
//! masks, filters, alphas, procedurals, environments, textures), all built in and procedural.
|
||||
//! Search filters across every tab. Materials (built in and saved), smart masks, filters, alphas
|
||||
//! and textures drag onto the layer stack, a layer row, the viewport or the brush properties
|
||||
|
||||
@@ -346,7 +346,7 @@ pub fn apply(ctx: &egui::Context, b: Brightness, accent: Accent) {
|
||||
});
|
||||
}
|
||||
|
||||
/// Painter-style uppercase panel caption (the strong text colour).
|
||||
/// Uppercase panel caption (the strong text colour).
|
||||
pub fn caption(text: &str) -> egui::RichText {
|
||||
egui::RichText::new(text.to_uppercase()).size(10.5).strong()
|
||||
}
|
||||
|
||||
@@ -215,7 +215,7 @@ fn view_3d(app: &mut TextureCraftApp, ui: &mut Ui, rect: Rect, sync: &mut Pendin
|
||||
if alt {
|
||||
app.session.camera.zoom(-delta.y * 0.01);
|
||||
} else if shift {
|
||||
// Shift + right drag turns the environment light (Painter's shortcut).
|
||||
// Shift + right drag turns the environment light.
|
||||
let d = &mut app.session.doc.project.display;
|
||||
d.env_rotation = (d.env_rotation + delta.x * 0.5).rem_euclid(360.0);
|
||||
} else {
|
||||
@@ -361,7 +361,7 @@ fn view_3d(app: &mut TextureCraftApp, ui: &mut Ui, rect: Rect, sync: &mut Pendin
|
||||
visible: app.session.doc.project.texture_sets.iter().map(|t| t.visible).collect(),
|
||||
};
|
||||
add_callback(app, ui, rect, frame, sync);
|
||||
// Shelf drops: a material goes above the selection (as in Painter), an alpha on the brush.
|
||||
// Shelf drops: a material goes above the selection, an alpha on the brush.
|
||||
crate::shelf::drop_target(app, ui, &resp, crate::shelf::DropZone::View3d);
|
||||
|
||||
// Brush cursor.
|
||||
|
||||
@@ -153,7 +153,7 @@ pub fn section(ui: &mut Ui, id: &str, title: &str, default_open: bool, body: imp
|
||||
});
|
||||
}
|
||||
|
||||
/// A Painter-style channel chip ("color", "metal", "rough"…): toggled = the accent-tinted well.
|
||||
/// A channel chip ("color", "metal", "rough"…): toggled = the accent-tinted well.
|
||||
pub fn chip(ui: &mut Ui, text: &str, on: bool) -> Response {
|
||||
let tk = Tokens::get(ui.ctx());
|
||||
let galley = ui.painter().layout_no_wrap(text.into(), egui::FontId::proportional(11.0), tk.text);
|
||||
|
||||
@@ -494,7 +494,7 @@ pub(crate) fn log(app: &mut TextureCraftApp, ui: &mut Ui) {
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------------------------
|
||||
// Bake mode (Painter's "Bake Mesh Maps": texture sets, bakers, common and per-map parameters)
|
||||
// Bake mode ("Bake Mesh Maps": texture sets, bakers, common and per-map parameters)
|
||||
|
||||
pub fn bake_left(app: &mut TextureCraftApp, ui: &mut Ui) {
|
||||
let tk = Tokens::get(ui.ctx());
|
||||
|
||||
@@ -0,0 +1,110 @@
|
||||
# TextureCraft features
|
||||
|
||||
Everything TextureCraft does today, by area. What's still missing is in [`ROADMAP.md`](../ROADMAP.md).
|
||||
|
||||
## Paint in 3D
|
||||
|
||||
- **Brushes** with size, flow, stroke opacity, spacing, hardness, angle and follow path; size,
|
||||
angle, flow and position jitter; tangent or camera alignment, angle fade, backface culling, lazy
|
||||
mouse, X/Y/Z mirror symmetry and pen pressure. **67 procedural brush alphas** in their own shelf
|
||||
tab, or any imported image as the alpha.
|
||||
- **Tools:** paint, eraser, **projection** with image stencils (hold S to move, turn and scale the
|
||||
stencil), polygon fill (triangle, UV island or the whole mesh), **path** and **lasso fill**, a
|
||||
**particle brush**, **smudge**, **clone** (V + click sets the source), color picker, Shift+click
|
||||
straight lines, and painting directly in the **2D UV view**.
|
||||
- **Geometry decals:** drop an image on the surface, then move, scale and turn its frame; it stays
|
||||
an editable fill layer.
|
||||
- **Quick mask** (Y): paint a temporary mask (U to edit, Ctrl+Shift+I to invert) that protects
|
||||
everything outside it while you paint.
|
||||
- **Every channel at once:** base color, metallic, roughness, height, normal, emissive, opacity,
|
||||
ambient occlusion and specular level, plus clear coat, sheen, anisotropy, subsurface scattering
|
||||
and transmission, each toggled per stroke in the brush's material properties.
|
||||
|
||||
## Layers, masks and smart materials
|
||||
|
||||
- **Paint, fill, folder and instance layers** with **32 blend modes per channel** (Normal through
|
||||
Normal map detail), per-channel opacity, visibility, color tags, drag-and-drop reordering,
|
||||
duplicate, group, flatten, cut, copy and paste across texture sets.
|
||||
- **Filters and content effects** on any layer or mask: **18 filters** (HSL, levels,
|
||||
contrast/luminosity, color balance, gradient map, posterize, clamp, invert, threshold, blur,
|
||||
directional and slope blur, sharpen, warp 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
|
||||
gradients, all with world-space noise), filters, ID color selection and compare. Alt+click a
|
||||
mask to view it alone.
|
||||
- **Fill layers** take uniform values, **22 procedurals** (clouds, cells, grunge, scratches, wood
|
||||
grain, bricks, fabric weave, leather grain, marble veins, Voronoi, paint chips…) or your own
|
||||
**images**, through UV, tri-planar, planar, spherical, cylindrical or decal projection.
|
||||
- **48 materials** (metals from measured reflectance, car paint, brushed anisotropic steel,
|
||||
velvet, skin, wax, glass, woods, stone, plastics, fabric, leather, ceramic), **17 smart
|
||||
materials** (rusted iron, worn paint, oxidized copper, bronze statue, weathered wood, mossy
|
||||
brick…) and **10 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.
|
||||
|
||||
## Files and texture sets
|
||||
|
||||
- **Open** glTF/GLB, FBX (binary and ASCII), COLLADA, **USD** (usda, usdc, usdz), **Alembic**,
|
||||
OBJ, PLY and STL, or a built-in mesh; UVs are generated when a mesh has none. Reimport a changed
|
||||
mesh and your painted strokes stay on the surface.
|
||||
- **UDIM / UV tiles:** detected on import or switched on later, with a resolution per tile and one
|
||||
texture per tile on export (`$udim`).
|
||||
- **Texture sets** from 128 to 8192 px per material, resampled when you change them, with 21
|
||||
channel types to add or remove.
|
||||
- **Projects** are a single `.tcraft` file: the mesh, every layer (sparse and lossless), baked maps
|
||||
and imported images. **Project templates** start new work from a saved setup.
|
||||
|
||||
## Bake and export
|
||||
|
||||
- **Bake mesh maps** on the GPU (ray traced, about 12× the CPU path) or on every CPU core: ambient
|
||||
occlusion, curvature, thickness, world-space normal, position, ID, bent normals, opacity, color
|
||||
and direction maps, and normal and height maps from high-poly meshes, with a cage, ray distances
|
||||
and matching by mesh name.
|
||||
- **Export presets** for glTF PBR Metal Roughness, Unreal Engine (packed), Unity HDRP (mask map),
|
||||
Unity Standard, Blender (Principled BSDF), separate maps, mesh maps and document channels, in
|
||||
PNG, JPEG, TGA, TIFF, BMP, WEBP, EXR or HDR at 8, 16 or 32 bits, with UV padding, size
|
||||
override and OpenGL or DirectX normals.
|
||||
- **Output template editor:** build your own presets with per-channel packing and converted maps,
|
||||
and share them as JSON.
|
||||
- **Mesh export** to OBJ, textured GLB (with clear coat and sheen) and USD.
|
||||
|
||||
## The viewport
|
||||
|
||||
- Physically based shading (metallic/roughness or specular/glossiness) with clear coat, sheen,
|
||||
anisotropy, subsurface scattering, transmission and parallax occlusion; image-based lighting from
|
||||
six procedural studio and outdoor environments or **your own HDR/EXR panoramas**; ACES or linear
|
||||
tone mapping, key-light shadows, bloom, vignette, sharpen, grain, **depth of field** and
|
||||
**saved cameras** (also imported from glTF).
|
||||
- **Rendering mode** (F10): a progressive, **path-traced** view of your textures with multi-bounce
|
||||
light, environment importance sampling, a denoiser and one-click PNG save, traced on the GPU
|
||||
(compute shaders, about 25× the CPU tracer, desktop and WebGPU) or on the CPU.
|
||||
- View any channel, any baked mesh map, or a UV checker; Alt+drag to orbit, middle-drag to pan,
|
||||
wheel to zoom, F to frame, M / C / B to cycle views.
|
||||
|
||||
## Interface
|
||||
|
||||
- A modern look in **four brightness levels** (dark, medium dark, medium light and light) with
|
||||
**seven accent colors**, set in Settings › Interface.
|
||||
- **Dockable, tabbed and floating panels**, saved layouts, and panels that reopen where you closed
|
||||
them.
|
||||
- A **shortcut editor** with conflict detection, and every shortcut shown in its tooltip.
|
||||
- **9 languages:** English, French, German, Spanish, Portuguese, Italian, Japanese, Chinese and
|
||||
Korean, switchable live.
|
||||
- **In the browser:** the same app compiled to WebAssembly, on WebGPU or WebGL2, with touch
|
||||
navigation and project open, save and download.
|
||||
|
||||
## Built for agents
|
||||
|
||||
Everything you can do in the window, an agent can do too:
|
||||
|
||||
- **CLI:** `texturecraft-cli new builtin:material_ball out.tcraft`, `bake`, `export`, `render`,
|
||||
`run <command> <params>`, `batch`, `commands`, `info`.
|
||||
- **MCP server:** `texturecraft-cli mcp` gives Claude and other agents tools to create projects,
|
||||
add layers and masks, paint strokes, bake, export, render previews and inspect everything they
|
||||
changed.
|
||||
- **Control channel:** launch the app with `--control <port>` to drive the running UI: run any
|
||||
command, invoke menu items, paint, and take screenshots.
|
||||
|
||||
See [`control-protocol.md`](control-protocol.md) for the full protocol and examples.
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 230 KiB |
@@ -12,8 +12,8 @@
|
||||
</developer>
|
||||
<description>
|
||||
<p>
|
||||
TextureCraft is an open-source, native 3D texture painter that works the way Substance 3D
|
||||
Painter users expect: familiar menus, shortcuts, panels and tools, with texture sets,
|
||||
TextureCraft is an open-source, native 3D texture painter that works the way texture artists
|
||||
expect: familiar menus, shortcuts, panels and tools, with texture sets,
|
||||
layers, masks, fills and effects painted straight onto the model.
|
||||
</p>
|
||||
<ul>
|
||||
|
||||
@@ -17,9 +17,9 @@ vendor: Learning Machines LLC
|
||||
homepage: https://getartcraft.com/apps/texturecraft
|
||||
license: MIT OR Apache-2.0
|
||||
description: |-
|
||||
Open-source, native 3D texture painter that works the way Substance 3D
|
||||
Painter users expect. Paints PBR texture sets directly on glTF, OBJ, PLY and
|
||||
STL meshes with layers, masks, fills and smart materials; bakes mesh maps;
|
||||
Open-source, native 3D texture painter that works the way texture artists
|
||||
expect. Paints PBR texture sets directly on glTF, FBX, COLLADA, USD, Alembic,
|
||||
OBJ, PLY and STL meshes with layers, masks, fills and smart materials; bakes mesh maps;
|
||||
exports texture sets for game engines. GPU viewport (wgpu).
|
||||
Includes texturecraft-cli, a headless converter and command runner.
|
||||
|
||||
|
||||
Reference in new issue
Block a user