Files
materialcraft/docs/file-format-parity.md
T
bflatasticandClaude Opus 5.5 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.0 KiB

File format parity

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

MaterialCraft does not read or write the reference app's proprietary package or archive formats (a non-goal of the clean room). It has its own package format and reads and writes the open image formats material artists exchange.

Format Read Write Fidelity Tests
.mcraft package (zip: package.json + resources/) Yes Yes Lossless (graphs, parameters, frames, comments, pins, exposed inputs, embedded bitmaps) formats::tests::package_round_trip, engine package_save_and_open_round_trip
PNG Yes (8/16-bit, gray and color) Yes (8/16-bit) 16-bit gray round-trips within 1/65535 formats::tests::export_every_format
JPEG Yes Yes (8-bit) Lossy same
TGA Yes Yes (8-bit) Lossless same
TIFF Yes Yes (8/16-bit) Lossless same
BMP Yes Yes (8-bit) Lossless same
WEBP Yes Yes (8-bit lossless) Lossless same
OpenEXR Yes Yes (32-bit float RGB) Float same
Radiance HDR Yes Yes Float (RGBE) same
SVG, fonts (resources) No — — gap
Meshes for the 3D view (OBJ, glTF, FBX) No — — gap
.mcmat portable material (zip: manifest, cooked maps, source package) Yes (opens the source package) Yes Maps at 8-bit sRGB (color) / 16-bit linear (data); exposed inputs, presets and input nodes in the manifest. Our own format, shared with TextureCraft, not the reference app's archive format formats::material::tests, engine material_cmds::tests, TextureCraft materialcraft_link

Exports write base color, emissive and specular through the sRGB curve and data maps (normal, roughness, metallic, height, ambient occlusion, opacity) linear.

Revision history

Date Change Summary
2026-11-02 minor .mcmat portable materials replace the published-archive gap
2026-11-02 major First version