mirror of
https://github.com/storytold/materialcraft.git
synced 2026-11-19 22:10:53 +01:00
- 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>
2.0 KiB
2.0 KiB
File format parity
Last reviewed: 2026-11-02 · Last updated: 2026-11-02 · Change: minor (
.mcmatportable 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 |