Files
materialcraft/docs/gaps.md
bflatastic 53ab0f2d6a Cross-app materials: .mcmat portable materials for TextureCraft
- formats: .mcmat (zip: material.json manifest, maps/<usage>.png, source.mcraft) with
  read/write and caps; color usages 8-bit sRGB, data maps 16-bit linear
- engine: file.exportMaterial {path, size?, values?, inputs?}, file.sendToTextureCraft
  (TextureCraft's library folder), graph.input.bind/unbind; file.open reads .mcmat
- core/eval: Graph::input_images preview images for input nodes (mesh maps from
  TextureCraft); caller images win; grayscale inputs convert to gray
- ui: File > Export material..., File > Send to TextureCraft, Open accepts .mcmat,
  input previews in the graph properties
- docs: control protocol (portable materials), file formats, gaps, parity ≈ 67%,
  roadmap, architecture, AGENTS convention for shared formats

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-02 12:06:09 +07:00

2.5 KiB

Gaps

Last reviewed: 2026-11-02 · Last updated: 2026-11-02 · Change: minor (portable .mcmat materials closed the published-archive gap) · Target: the professional node-based material workflow

Every known shortfall, most important first. Pick from the top.

# Gap Evidence Impact Estimate Parity doc
1 Node library breadth 227 nodes vs. ~400 in the reference library Recipes that need scan processing, more grunges, splines or SDF shapes 30 h target-app-parity (Node library)
2 GPU 3D view with tessellation and lights CPU renderer with parallax only Displacement previews, light setups 12 h target-app-parity (3D view)
3 Mesh-based generators and bakers None Workflows that start from a mesh 15 h target-app-parity (Node library)
4 Portable materials over MCP .mcmat export runs from the app and the CLI; the MCP workspace sandbox refuses file.* commands and has no material_export tool Sandboxed agents can't hand a material to TextureCraft 1 h target-app-parity (Files)
5 Function loops and reusable functions Functions live on one parameter or processor Iterative effects; sharing logic between nodes 5 h target-app-parity (Function graphs)
6 Input visibility conditions, per-instance output sizes Not implemented Organizing large graphs' inputs 4 h target-app-parity (Graph parameters)
7 ui.screenshot times out on this test machine The window-capture callback never fires here; view.screenshot and the offscreen snapshot test work Agents bridged to the app see views but not the whole window 1 h —
8 Translations and keymap editor English only, fixed shortcuts Non-English users; custom shortcuts 8 h localization-parity
9 Minimap and multi-graph tabs One graph at a time, no overview Navigating big graphs 5 h target-app-parity (Graph editing, UI and UX)
10 Owner's mascot app icon A placeholder drawn in code Brand consistency with the other Crafting Apps owner —
11 First signed release Workflows copied, not run Downloads 3 h target-app-parity (Platforms)

Revision history

Date Change Summary
2026-11-02 minor Portable .mcmat materials for TextureCraft closed gap 4; what's left is an MCP tool
2026-11-02 major Closed the function editor, dynamic parameters, FX-Map/Text/SVG, presets and groups, browser file I/O and accessible names; re-ranked
2026-11-02 major First list