diff --git a/ATTRIBUTION.md b/ATTRIBUTION.md index 4c641aa9..a686526b 100644 --- a/ATTRIBUTION.md +++ b/ATTRIBUTION.md @@ -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 diff --git a/README.md b/README.md index 08e729c4..ac60d8a7 100644 --- a/README.md +++ b/README.md @@ -7,23 +7,32 @@

+

- TextureCraft icon: an octopus on a rust-orange tile + TextureCraft icon: an engraved zebra on a copper tile

TextureCraft

- 3D texture painting; an open-source, clean-room reimplementation of Adobe Substance 3D Painter, rebuilt in pure Rust.
- 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. Open source, offline, and yours. + 3D texture painting; an open-source, modern texture painting application, built in pure Rust.

- 100% Rust - macOS · Windows · Linux · FreeBSD · Web - License: MIT OR Apache-2.0 - Status: early alpha + 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. +

+ +

+ Status: in active development + Written in pure Rust + Runs on macOS, Windows, Linux, FreeBSD and the web + MCP server for agents + License: MIT OR Apache-2.0 +
+ Reviewed by CodeRabbit

@@ -40,8 +49,7 @@

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 -
- The workspace: asset shelf, 3D viewport, 2D UV view, texture sets, layer stack and properties. +
The workspace: asset shelf, 3D viewport, 2D UV view, texture sets, layer stack and properties

> [!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).**

- Features · - Painting · - Layers · - Files · - Bake and export · - Viewport · - Agents · - Get started · + A look around · + Made in TextureCraft · + Why TextureCraft · + Quick start · + Status · Downloads · - Crafting Apps · - Discord + The Crafting Apps · + License

-
+## A look around - - - - - - + + + + + + + +
-

🎨 Familiar by design

- 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. -
-

⚡ Native and fast

- 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. -
-

🧵 Seamless by construction

- 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. -
-

🤖 Agent-ready

- 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. -
+ 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 +

Bake mesh maps: ambient occlusion, curvature, thickness and more, ray traced on the GPU

+
+ The Export textures dialog: texture sets to export, the output directory, an output template, file type, size, padding and normal map format +

Export textures: presets for common engines, or your own output templates with channel packing

+
+ 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 +

Rendering mode (F10): your textures path traced on the GPU, with a denoiser

+
+ 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 +

Light theme: four brightness levels and seven accent colours

+
-## 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. + + + + + +
+ A path-traced crate: teal paint chipping off wooden planks, a rusted iron lid and a tarnished brass handle +

Crate: chipped paint on wood, rusted iron and tarnished brass smart materials, one per texture set

+
+ Three path-traced material balls: glossy red car paint with a clear coat, purple velvet with sheen, and brushed steel with anisotropic highlights +

Shading lobes: car paint (clear coat), velvet (sheen) and brushed steel (anisotropy)

+
-### 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. -

- 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 -
- Car paint (clear coat), velvet (sheen) and brushed steel (anisotropy), path traced on the GPU by texturecraft-cli render. -

+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. - -

- 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 - The Export textures dialog: texture sets to export, the output directory, an output template, file type, size, padding and normal map format -

- -### 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. - -

- 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 -

- -### 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. - -

- 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 -

- -## 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 `, `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 ` 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. `` 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--windows-x64.msi` | `texturecraft--windows-x64-portable.zip` | +| arm64 (Snapdragon and other ARM PCs) | `texturecraft--windows-arm64.msi` | `texturecraft--windows-arm64-portable.zip` | +| x86 (32-bit) | `texturecraft--windows-x86.msi` | `texturecraft--windows-x86-portable.zip` | + +### macOS + +| Build | File | Notes | +|---|---|---| +| App, universal (Apple silicon + Intel) | `texturecraft--macos-universal.dmg` | Signed and notarized | +| Command-line tool, universal | `texturecraft-cli--macos-universal.zip` | Signed and notarized | + +### Linux + +| Format | x86_64 | aarch64 (ARM64) | Notes | +|---|---|---|---| +| AppImage | `texturecraft--linux-x86_64.AppImage` | `texturecraft--linux-aarch64.AppImage` | Runs anywhere; updates itself with [AppImageUpdate](https://github.com/AppImageCommunity/AppImageUpdate) (`.zsync` files) | +| Flatpak | `texturecraft--linux-x86_64.flatpak` | `texturecraft--linux-aarch64.flatpak` | Sandboxed; `flatpak install --user ` | +| Debian/Ubuntu | `texturecraft--linux-x86_64.deb` | `texturecraft--linux-aarch64.deb` | | +| Fedora/RHEL/openSUSE | `texturecraft--linux-x86_64.rpm` | `texturecraft--linux-aarch64.rpm` | | +| Tarball | `texturecraft--linux-x86_64.tar.gz` | `texturecraft--linux-aarch64.tar.gz` | Unpack anywhere | + +### FreeBSD + +| Build | File | |---|---| -| Installer (x64, x86, arm64) | `texturecraft--windows-.msi` | -| Portable (x64, x86, arm64) | `texturecraft--windows--portable.zip` | +| x86_64 | `texturecraft--freebsd-x86_64.tar.gz` | -| macOS | File | -|---|---| -| Universal app (Apple silicon and Intel), signed and notarized | `texturecraft--macos-universal.dmg` | -| Command-line tools | `texturecraft-cli--macos-universal.zip` | +### Web (WebAssembly) -| Linux (x86_64, aarch64) | File | -|---|---| -| AppImage (any distribution) | `texturecraft--linux-.AppImage` | -| Debian, Ubuntu, Mint, Pop!_OS | `texturecraft--linux-.deb` | -| Fedora, openSUSE, RHEL | `texturecraft--linux-.rpm` | -| Flatpak bundle | `texturecraft--linux-.flatpak` | -| Plain archive | `texturecraft--linux-.tar.gz` | - -| FreeBSD | File | -|---|---| -| x86_64 | `texturecraft--freebsd-x86_64.tar.gz` | - -| Web (WebAssembly) | File | -|---|---| -| Static site to host or embed | `texturecraft-web-.zip` | +| Build | File | Notes | +|---|---|---| +| Static site | `texturecraft-web-.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 | |:-:|---|---|---|---| -| | **TextureCraft** | **3D texture painting · you are here** | [GitHub](https://github.com/storytold/texturecraft) | [Website](https://getartcraft.com/apps/texturecraft) | | | **PhotoCraft** | Image editing: layers, masks, type and real PSD files | [GitHub](https://github.com/storytold/photocraft) | [Website](https://getartcraft.com/apps/photocraft) | | | **VectorCraft** | Vector illustration | [GitHub](https://github.com/storytold/vectorcraft) | [Website](https://getartcraft.com/apps/vectorcraft) | +| | **TextureCraft** | **3D texture painting · you are here** | [GitHub](https://github.com/storytold/texturecraft) | [Website](https://getartcraft.com/apps/texturecraft) | | | **FilmCraft** | Video editing, color and sound | [GitHub](https://github.com/storytold/filmcraft) | [Website](https://getartcraft.com/apps/filmcraft) | | | **LightCraft** | Photo library and raw development | [GitHub](https://github.com/storytold/lightcraft) | [Website](https://getartcraft.com/apps/lightcraft) | | | **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 TextureCraft

+## Star history + +[![Star History Chart](https://api.star-history.com/svg?repos=storytold/texturecraft&type=Date&legend=top-left)](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. -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. -

ArtCraft
Made by the ArtCraft team and community. diff --git a/crates/automation/src/server.rs b/crates/automation/src/server.rs index c83c784f..3049bae9 100644 --- a/crates/automation/src/server.rs +++ b/crates/automation/src/server.rs @@ -164,7 +164,7 @@ pub struct StrokeParams { /// -1..1 #[serde(default, skip_serializing_if = "Option::is_none")] pub height: Option, - /// 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, /// Brush hardness 0..100. diff --git a/crates/core/src/layer.rs b/crates/core/src/layer.rs index 04afca9e..86ec6409 100644 --- a/crates/core/src/layer.rs +++ b/crates/core/src/layer.rs @@ -36,7 +36,7 @@ pub struct Layer { /// Effects applied to the layer's content, bottom → top. #[serde(default)] pub content_effects: Vec, - /// 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, /// Combine the mask with the layer's height ("mask with height"). diff --git a/crates/core/src/lib.rs b/crates/core/src/lib.rs index da4c7a20..89120e08 100644 --- a/crates/core/src/lib.rs +++ b/crates/core/src/lib.rs @@ -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)] diff --git a/crates/core/src/project.rs b/crates/core/src/project.rs index 91a52680..ca2ee2ec 100644 --- a/crates/core/src/project.rs +++ b/crates/core/src/project.rs @@ -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, #[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 { diff --git a/crates/engine/src/bake_cmds.rs b/crates/engine/src/bake_cmds.rs index 951ea845..f154927b 100644 --- a/crates/engine/src/bake_cmds.rs +++ b/crates/engine/src/bake_cmds.rs @@ -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. diff --git a/crates/engine/src/camera_cmds.rs b/crates/engine/src/camera_cmds.rs index ebedab77..af94815c 100644 --- a/crates/engine/src/camera_cmds.rs +++ b/crates/engine/src/camera_cmds.rs @@ -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}; diff --git a/crates/engine/src/commands.rs b/crates/engine/src/commands.rs index f10d44d5..1d6b0cb8 100644 --- a/crates/engine/src/commands.rs +++ b/crates/engine/src/commands.rs @@ -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}; diff --git a/crates/engine/src/decal_cmds.rs b/crates/engine/src/decal_cmds.rs index 8b3874f8..5c1c4ab0 100644 --- a/crates/engine/src/decal_cmds.rs +++ b/crates/engine/src/decal_cmds.rs @@ -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}; diff --git a/crates/engine/src/filter_lib.rs b/crates/engine/src/filter_lib.rs index 301c1586..89e838be 100644 --- a/crates/engine/src/filter_lib.rs +++ b/crates/engine/src/filter_lib.rs @@ -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. diff --git a/crates/engine/src/preserve.rs b/crates/engine/src/preserve.rs index d46fb5e7..38544edc 100644 --- a/crates/engine/src/preserve.rs +++ b/crates/engine/src/preserve.rs @@ -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 diff --git a/crates/engine/src/quick_mask.rs b/crates/engine/src/quick_mask.rs index 05e94a88..304ab3c9 100644 --- a/crates/engine/src/quick_mask.rs +++ b/crates/engine/src/quick_mask.rs @@ -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. diff --git a/crates/engine/src/session.rs b/crates/engine/src/session.rs index 75aee536..42b2560a 100644 --- a/crates/engine/src/session.rs +++ b/crates/engine/src/session.rs @@ -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, /// 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, diff --git a/crates/engine/src/template_cmds.rs b/crates/engine/src/template_cmds.rs index 25cf9beb..e5629cc7 100644 --- a/crates/engine/src/template_cmds.rs +++ b/crates/engine/src/template_cmds.rs @@ -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 `.json` files in a library folder (see [`Session::load_templates`]). diff --git a/crates/formats/src/mesh_import/abc/mod.rs b/crates/formats/src/mesh_import/abc/mod.rs index b1de37dc..6730b334 100644 --- a/crates/formats/src/mesh_import/abc/mod.rs +++ b/crates/formats/src/mesh_import/abc/mod.rs @@ -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 { diff --git a/crates/formats/src/mesh_import/fbx.rs b/crates/formats/src/mesh_import/fbx.rs index 9c7d52e0..a902b5d4 100644 --- a/crates/formats/src/mesh_import/fbx.rs +++ b/crates/formats/src/mesh_import/fbx.rs @@ -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 diff --git a/crates/formats/src/mesh_import/usd/mod.rs b/crates/formats/src/mesh_import/usd/mod.rs index 5fec3051..d6f01cfe 100644 --- a/crates/formats/src/mesh_import/usd/mod.rs +++ b/crates/formats/src/mesh_import/usd/mod.rs @@ -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 diff --git a/crates/geom/src/camera.rs b/crates/geom/src/camera.rs index 93f27e27..1f4156c9 100644 --- a/crates/geom/src/camera.rs +++ b/crates/geom/src/camera.rs @@ -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}; diff --git a/crates/paint/src/brush.rs b/crates/paint/src/brush.rs index a7a67298..87e076b5 100644 --- a/crates/paint/src/brush.rs +++ b/crates/paint/src/brush.rs @@ -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). diff --git a/crates/render/src/mesh_maps.rs b/crates/render/src/mesh_maps.rs index b8231d81..e9ed9424 100644 --- a/crates/render/src/mesh_maps.rs +++ b/crates/render/src/mesh_maps.rs @@ -19,7 +19,7 @@ pub fn mesh_map_rgba(baked: Option<&BakedMaps>, m: BakedMap, size: u32) -> Vec 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. diff --git a/crates/ui-egui/Cargo.toml b/crates/ui-egui/Cargo.toml index 879c7625..ccd45a4e 100644 --- a/crates/ui-egui/Cargo.toml +++ b/crates/ui-egui/Cargo.toml @@ -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 diff --git a/crates/ui-egui/src/dock.rs b/crates/ui-egui/src/dock.rs index 15116399..08f4e79b 100644 --- a/crates/ui-egui/src/dock.rs +++ b/crates/ui-egui/src/dock.rs @@ -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)); diff --git a/crates/ui-egui/src/docking.rs b/crates/ui-egui/src/docking.rs index c958d868..8b0774b4 100644 --- a/crates/ui-egui/src/docking.rs +++ b/crates/ui-egui/src/docking.rs @@ -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); diff --git a/crates/ui-egui/src/menus.rs b/crates/ui-egui/src/menus.rs index e3d39419..baf5143b 100644 --- a/crates/ui-egui/src/menus.rs +++ b/crates/ui-egui/src/menus.rs @@ -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")), diff --git a/crates/ui-egui/src/parity.rs b/crates/ui-egui/src/parity.rs index 4bfc1b6c..50b51a55 100644 --- a/crates/ui-egui/src/parity.rs +++ b/crates/ui-egui/src/parity.rs @@ -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}; diff --git a/crates/ui-egui/src/shelf.rs b/crates/ui-egui/src/shelf.rs index 6ba10207..5d86cacd 100644 --- a/crates/ui-egui/src/shelf.rs +++ b/crates/ui-egui/src/shelf.rs @@ -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 diff --git a/crates/ui-egui/src/theme.rs b/crates/ui-egui/src/theme.rs index dc1bd1c9..fc7dd40e 100644 --- a/crates/ui-egui/src/theme.rs +++ b/crates/ui-egui/src/theme.rs @@ -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() } diff --git a/crates/ui-egui/src/viewport.rs b/crates/ui-egui/src/viewport.rs index 6d69f566..ee34ae92 100644 --- a/crates/ui-egui/src/viewport.rs +++ b/crates/ui-egui/src/viewport.rs @@ -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. diff --git a/crates/ui-egui/src/widgets.rs b/crates/ui-egui/src/widgets.rs index 535995b2..17b69998 100644 --- a/crates/ui-egui/src/widgets.rs +++ b/crates/ui-egui/src/widgets.rs @@ -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); diff --git a/crates/ui-egui/src/windows.rs b/crates/ui-egui/src/windows.rs index 588220e7..9c3b2a99 100644 --- a/crates/ui-egui/src/windows.rs +++ b/crates/ui-egui/src/windows.rs @@ -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()); diff --git a/docs/features.md b/docs/features.md new file mode 100644 index 00000000..2863a398 --- /dev/null +++ b/docs/features.md @@ -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 `, `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 ` 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. diff --git a/docs/images/texturecraft-crate.png b/docs/images/texturecraft-crate.png new file mode 100644 index 00000000..0e7f4c5c Binary files /dev/null and b/docs/images/texturecraft-crate.png differ diff --git a/packaging/linux/ai.storyteller.texturecraft.metainfo.xml.in b/packaging/linux/ai.storyteller.texturecraft.metainfo.xml.in index 87a1e631..e04f156c 100644 --- a/packaging/linux/ai.storyteller.texturecraft.metainfo.xml.in +++ b/packaging/linux/ai.storyteller.texturecraft.metainfo.xml.in @@ -12,8 +12,8 @@

- 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.

    diff --git a/packaging/linux/nfpm.yaml b/packaging/linux/nfpm.yaml index 30aca20a..8d4cebf0 100644 --- a/packaging/linux/nfpm.yaml +++ b/packaging/linux/nfpm.yaml @@ -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.