Semantic inventory
See colors, materials, transforms, components, and slicer-specific project data.
3MF Semantic Guard
Edit 3MF geometry while tracking project data.
Inspect 3MF colors, materials, transforms, components, and extensions before editing. Know what is preserved, recomputed, or unsupported before export.
Last reviewed
Expected outcomeA 3MF workflow that reports preserved, changed, and unsupported project data.
Why 3MF edits lose color.
A 3MF file is a package, not just a mesh. Besides triangles it can hold units, build items, components with transforms, colors, materials, textures, and private extensions written by one specific slicer. The .3mf extension names the container. It does not tell you how much of that data the next application keeps.
Color fails in quiet ways. A tool that reads only the core mesh drops every appearance property. A cut or repair creates new triangles that need new color assignments. An object color can be converted into painted faces, or a texture reduced to a flat color. The file still opens, so the loss shows up only in the slicer preview, or on the printed part.
Meshworthy takes inventory before an edit, tells you what the operation can preserve, and compares the exported file with those promises.
Checks included in this workflow.
Meshworthy shows the affected geometry, applies the selected constraints, and checks the exported result. Limitations remain visible when a result requires manual review.
Loss disclosure
Meshworthy tells you what an operation can preserve before it changes the model.
Required extension handling
An unsupported required extension blocks the operation and remains visible in the report.
Round-trip check
Exported semantics are compared against the promises shown before the edit.
From inventory to a compared round trip.
01Take inventory
→Review units, objects, components, transforms, colors, materials, textures, and declared extensions.
02Check the impact
→See which resources the operation preserves, recomputes, flattens, or cannot support, before it changes the model.
03Export without overwriting
→Keep the source package and save the result under a new name.
04Compare the round trip
Reopen the file and compare its inventory with the baseline from before the operation.
What is free and what needs Pro.
The 3MF integrity checks, including the semantic inventory, are free in the Mac app. Repairing and splitting 3MF models is part of the one-time Meshworthy Pro unlock, with no subscription.
To inspect a package without installing anything, the free 3MF Color Inspector runs in your browser. It reads the file locally, shows colors, materials, textures, and reference integrity, and compares a color round trip.
What this does not do.
- A valid 3MF can contain vendor-specific project data that another application does not understand. Meshworthy reports supported and unsupported semantics, but it cannot make a different slicer implement a private extension.
- When a required extension is unsupported, the operation is blocked instead of risking silent loss.
- The final authority is the slicer you print from. Open the exported file there and check the sliced layers.
- Meshworthy does not slice, and it does not generate toolpaths or G-code.
Why 3MF colors disappear after editing.
Trace color loss to triangle remapping, representation conversion, partial support, or export. Then verify the file saved to disk.
More guides on this topic
About 3mf semantic guard.
Does Meshworthy preserve painted 3MF colors?+
Meshworthy inventories supported paint and material data, preserves what the chosen operation supports, and warns before any known loss.
Why is 3MF harder than STL?+
A 3MF package can contain units, transforms, components, colors, textures, materials, and private slicer extensions in addition to triangles.
What if an extension is unsupported?+
If it is required, Meshworthy stops. If it can be preserved safely as opaque data, the export report says so.
Which 3MF data does Meshworthy inventory?+
Units, objects, components, transforms, colors, materials, textures, metadata, and declared extensions.
Why did my colors disappear in another tool?+
Common causes are a tool that read only the core mesh, new triangles without matching color assignments, object colors converted into painted faces, and an export that wrote a reduced subset of the package. The guide on 3MF color loss walks through each one.
Can I check a 3MF without installing anything?+
Yes. The free 3MF Color Inspector runs in your browser, reads the package locally, and nothing is uploaded.
Know before you print.
On the Mac App Store. Diagnosis is free; Pro unlocks repair and preparation for $19.99, once — never a subscription. Model processing stays local.
Get Meshworthy for Mac ↗