Format:3MF
| Magic | PK\x03\x04 (ZIP) |
|---|---|
| Extensions | .3mf |
| On this wiki | Facts · Code · Notes · Topics |
3D Manufacturing Format (.3mf): an Open Packaging Conventions ZIP whose root relationship points to a 3D model part, normally /3D/3dmodel.model, an XML file with mesh, build and unit data.
Identification
3MF is an OPC package, so it is a Format:ZIP (see also Format:OOXML for the same packaging conventions). The 3MF Core specification (3MFConsortium/spec_core, 3MF Core Specification.md) defines a "3MF Document StartPart relationship" from the package root to the 3D Model part (line 173); its example .rels entry is Target="/3D/3dmodel.model" with Type http://schemas.microsoft.com/3dmanufacturing/2013/01/3dmodel (lines 241, 1372). The model part name SHOULD have two segments, /3D/ and a name ending .model (line 296); textures go under /3D/Textures/, metadata under /3D/Metadata/ (lines 297-298).
Assimp's importer (code/AssetLib/3MF/D3MFOpcPackage.cpp) hard-codes 3D/3dmodel.model as the model reference (line 226) and handles further .model parts and .rels parts of the production extension.
Model XML
The <model> element has a unit attribute whose valid values are micron, millimeter, centimeter, inch, foot and meter; the default is millimeter (spec lines 415, 1021). Vertex coordinates are interpreted in that unit.
Unverified: the package also has [Content_Types].xml and _rels/.rels like any OPC package; the spec text was not read for those names.
Tools and sources
- 3MF Consortium core spec (BSD-2-Clause): https://github.com/3MFConsortium/spec_core
- assimp (BSD-3-Clause): https://github.com/assimp/assimp
Code & repositories
- https://github.com/assimp/assimp @
f20e46b3fc1fdf9bc2675fd549d180dda06861f1· license: BSD-3-Clause (declared by the contributor for the files used; GitHub reports BSD-3-Clause (read from LICENSE; GitHub's detector did not classify it) for the repository)
Open Asset Import Library; importers in code/AssetLib read as format documentation
Tested on: source read, not run: source read only · checked 2026-10-19; last activity 2026-10-17; Note: the latest release ships binaries; the wiki links only the source, never the binaries - https://github.com/3MFConsortium/spec_core @
997b385e06f3181cf9aae0c578e0b45ccd48ccb2· license: BSD-2-Clause
3MF Core Specification in Markdown
Tested on: source read, not run: documentation read · checked 2026-10-19; last activity 2025-02-11