3D Manufacturing Format Specification and Reference Guide 1
Total Page:16
File Type:pdf, Size:1020Kb
3D Manufacturing Format Specification and Reference Guide 1 3D Manufacturing Format Core Specification & Reference Guide Version 1.0 Status Published 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. Copyright 3MF Consortium 2015 2 Table of Contents Preface .................................................................................................................................. 4 About this Specification ..................................................................................................................4 Document Conventions ..................................................................................................................4 Language Notes ..............................................................................................................................5 Software Conformance ...................................................................................................................5 Part I. 3MF Documents .......................................................................................................... 7 Chapter 1. 3MF Document Format ......................................................................................... 8 1.1. How This Specification Is Organized .....................................................................................8 1.2. Package ..............................................................................................................................9 Chapter 2. Parts and Relationships ...................................................................................... 10 2.1. 3D Payload ........................................................................................................................ 10 2.1.1. 3D Parts and Payload Relationships .................................................................................... 10 2.1.2. 3D Model Part ..................................................................................................................... 12 2.1.3. Thumbnail Part .................................................................................................................... 12 2.1.4. PrintTicket Part ................................................................................................................... 13 2.2. Part Naming Recommendations ........................................................................................ 13 2.3. 3MF Document Markup ..................................................................................................... 14 2.3.1. Support for Versioning and Extensibility ............................................................................ 14 2.3.2. XML Usage ........................................................................................................................... 15 2.3.3. Markup Model .................................................................................................................... 15 2.3.4. Whitespace ......................................................................................................................... 15 2.3.5. Language ............................................................................................................................. 16 Chapter 3. 3D Models .......................................................................................................... 17 3.1. Coordinate Space .............................................................................................................. 17 3.2. Relative Directions and Measurement ............................................................................... 17 3.3. 3D Matrices....................................................................................................................... 18 3.4. Model ............................................................................................................................... 19 3.4.1. Metadata ............................................................................................................................. 21 3.4.2. Resources ............................................................................................................................ 22 3.4.3. Build Instructions ................................................................................................................ 23 Chapter 4. Object Resources ................................................................................................ 25 4.1. Meshes ............................................................................................................................. 26 4.1.1. Fill Rule ................................................................................................................................ 27 4.1.2. Vertices ............................................................................................................................... 28 4.1.3. Triangles .............................................................................................................................. 29 4.2. Components ..................................................................................................................... 31 4.2.1. Component ......................................................................................................................... 32 Version 1.0 4/29/2015 6:40:00 PM 3D Manufacturing Format Specification and Reference Guide 3 Chapter 5. Material Resources ............................................................................................. 33 5.1. Base Material .................................................................................................................... 33 5.1.1. sRGB Color ........................................................................................................................... 34 Chapter 6. 3MF Document Package Features ....................................................................... 35 6.1. Thumbnail ......................................................................................................................... 35 6.1.1. JPEG Images ........................................................................................................................ 35 6.1.2. PNG Images ......................................................................................................................... 35 6.2. Core Properties ................................................................................................................. 36 6.3. Digital Signatures .............................................................................................................. 36 6.3.1. Normalization ...................................................................................................................... 36 6.4. Protected Content ............................................................................................................. 37 Part II. Appendixes .............................................................................................................. 38 Appendix A. Glossary ........................................................................................................... 39 Appendix B. 3MF XSD Schema ............................................................................................. 42 Appendix C. Standard Namespaces and Content Types ........................................................ 46 C.1 Content Types ................................................................................................................... 46 C.2 Relationship Types ............................................................................................................ 46 C.3 Namespaces ...................................................................................................................... 46 References .......................................................................................................................... 47 Copyright 3MF Consortium 2015 4 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 specification. That specification