.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
+
+[](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.
-

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.