Skip to main content

Core 3MF Specification

Core Specification & Reference Guide – Download PDF
Version: 1.3.0
Status: Published

Table of Contents

Preface
About this Specification
Document Conventions Language Notes Software Conformance
Part I. 3MF Documents
Chapter 1. 3MF Document Format
1.1. Package
Chapter 2. Parts and Relationships 2.1. 3D Payload
2.2. Part Naming Recommendations
2.3. 3MF Document Markup
Chapter 3. 3D Models
3.1. Coordinate Space
3.2. Relative Directions and Measurement 3.3. 3D Matrices
3.4. Model
Chapter 4. Object Resources 4.1. Meshes
4.2. Components
Chapter 5. Material Resources 5.1. Base Material
Chapter 6. 3MF Document Package Features
6.1. Package Thumbnail and Object Thumbnail
6.2. Core Properties 6.3. Digital Signatures 6.4. Protected Content
3MF Core Specification
1/40
Part II. Appendices Appendix A. Glossary
Appendix B.1. 3MF XSD Schema
Appendix B.2. 3MF Metadata Example
Appendix C. Standard Namespaces and Content Types C.1 Content Types
C.2 Relationship Types C.3 Namespaces

Preface

About this Specification

The 3D Manufacturing Format, or 3MF, describes the set of conventions for the use of XML and other widely available technologies to describe the content and appearance of one or more 3D models. It is written for developers who are building systems to process 3MF content.
A primary goal of this specification is to ensure the interoperability of independently created software and hardware systems that produce or consume 3MF content. This specification defines the formal requirements that producers and consumers must satisfy in order to achieve interoperability.
This specification describes a 3D model and containing format called the 3MF Document. The format requirements are an extension of the packaging requirements described in the Open Packaging Conventions (OPC) specification. That specification describes packaging and physical format conventions for the use of XML, Unicode, ZIP, and other technologies and specifications to organize the content and resources that make up any model. They are an integral part of the 3MF specification.
Understanding this specification requires working knowledge of the Extensible Markup Language (XML) and XML Namespace specifications. Full understanding might also require domain knowledge of common terms and procedures within the 3D manufacturing sector, although every effort has been made to minimize such reliance.
The 3MF Consortium offers a free to use open source implementation of this specification in order to allow an easy adoption of the format in applications handling 3D content.
Part I, “3MF Documents,” presents the details of the primarily XML-based 3MF Document format. This section describes the XML markup that defines the composition of 3D documents and the appearance of each model within the document.
Part II, “Appendices,” contains additional technical details and schemas too extensive to include in the main body of the text as well as convenient reference information.
The information contained in this specification is subject to change. Every effort has been made to ensure its accuracy at the time of publication.
This core specification is extended with additions. As an example, the prefix “t” maps to the xml-namespace “http://schemas.microsoft.com/3dmanufacturing/trianglesets/2021/07” and the prefix “mm” maps to the xml namespace “http://schemas.microsoft.com/3dmanufacturing/mirroring/2021/07”, both defined in version 1.3. See Appendix C.3 Namespaces

Disclaimer

THESE MATERIALS ARE PROVIDED “AS IS.” The contributors expressly disclaim any warranties (express, implied, or otherwise), including implied warranties of merchantability, non-infringement, fitness for a particular purpose, or title, related to the materials. The entire risk as to implementing or otherwise using the materials is assumed by the implementer and user. IN NO EVENT WILL ANY MEMBER BE LIABLE TO ANY OTHER PARTY FOR LOST PROFITS OR ANY FORM OF INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY CHARACTER FROM ANY CAUSES OF ACTION OF ANY KIND WITH RESPECT TO THIS DELIVERABLE OR ITS GOVERNING AGREEMENT, WHETHER BASED ON BREACH OF CONTRACT, TORT (INCLUDING NEGLIGENCE), OR OTHERWISE, AND WHETHER OR NOT THE OTHER MEMBER HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.