diff --git a/3MF Slice Extension.md b/3MF Slice Extension.md index f7e5ffd..f18d1fd 100644 --- a/3MF Slice Extension.md +++ b/3MF Slice Extension.md @@ -235,7 +235,7 @@ In order to reference slice data, there are two additional attributes for \** ##### Attributes -| Name | Type | Use | Default | Fixed | Annotation | -| --- | --- | --- | --- | --- | --- | -| id | **ST\_ResourceID** | required | | | Defines the unique identifier for this object. The slicestack ID must be unique within the entire 3MF package, but just within a single model part. | -| zbottom | **ST\_Number** | optional | 0 | | The starting level (in specified model units) relative to build platform. | +| Name | Type | Use | Default | Annotation | +| --- | --- | --- | --- | --- | +| id | **ST\_ResourceID** | required | | Defines the unique identifier for this object. The slicestack ID must be unique within the entire 3MF package, but just within a single model part. | +| zbottom | **ST\_Number** | optional | 0 | The starting level (in specified model units) relative to build platform. | A \ element is referenced from the \ element and defines an object by a stack of slices instead of a mesh. The slices in the \ element can then be stored in one or more separate files per sliced object using the sliceref element. @@ -264,10 +264,10 @@ Element **\** ##### Attributes -| Name | Type | Use | Default | Fixed | Annotation | -| --- | --- | --- | --- | --- | --- | -| slicestackid | **ST\_ResourceID** | required | | | Slicestackid identifies the \ that contains the slice data for the specified object. | -| slicepath | **ST\_UriReference** | required | | | Slicepath is an absolute path to a non-root model file in the 3MF package that contains slice data in \ objects. | +| Name | Type | Use | Default | Annotation | +| --- | --- | --- | --- | --- | +| slicestackid | **ST\_ResourceID** | required | | Slicestackid identifies the \ that contains the slice data for the specified object. | +| slicepath | **ST\_UriReference** | required | | Slicepath is an absolute path to a non-root model file in the 3MF package that contains slice data in \ objects. | Instead of supplying \ elements inside a slice stack, it is also possible to use \ elements to include a single slice (or multiple slices at once) from another model stream. Slice Stacks may either contain \ elements or \ elements, but they MUST NOT contain both element types concurrently. @@ -291,15 +291,15 @@ The \ element is the 2D companion to the \ element from the core sp ##### Attributes -| Name | Type | Use | Default | Fixed | Annotation | -| --- | --- | --- | --- | --- | --- | -| ztop | **ST\_Number** | required | | | ztop allows a slice to have an arbitrary thickness defined as an z-position of the top of the slice relative to the build platform. ztop MUST be always monotonically increasing throughout the slice stack. | +| Name | Type | Use | Default | Annotation | +| --- | --- | --- | --- | --- | +| ztop | **ST\_Number** | required | | ztop allows a slice to have an arbitrary thickness defined as an z-position of the top of the slice relative to the build platform. ztop MUST be always monotonically increasing throughout the slice stack. | ## Vertices Element **\** -The vertices element contains all the \ elements for this object. Vertices represent the points of the polygons within the slice. The order of these elements defines an implicit 0-based index that is referenced by other elements, such as the \ element. If the \ contains content, the \ element MUST exist and all downstream rules apply. The producer SHOULD collapse vertices that are very closely proximal with a single vertex. In order to avoid integer overflows, a vertex array MUST contain less than 2^31 vertices. +The \ element contains all the \ elements for this object. Vertices represent the points of the polygons within the slice. The order of these elements defines an implicit 0-based index that is referenced by other elements, such as the \ element. If the \ contains content, the \ element MUST exist and all downstream rules apply. The producer SHOULD collapse vertices that are very closely proximal with a single vertex. In order to avoid integer overflows, a vertex array MUST contain less than 2^31 vertices. ![element ](images/element_vertices.png) @@ -311,10 +311,10 @@ Element **\** ##### Attributes -| Name | Type | Use | Default | Fixed | Annotation | -| --- | --- | --- | --- | --- | --- | -| x | **ST\_Number** | required | | | The position of the vertex along the X axis. | -| y | **ST\_Number** | required | | | The position of the vertex along the Y axis. | +| Name | Type | Use | Default | Annotation | +| --- | --- | --- | --- | --- | +| x | **ST\_Number** | required | | The position of the vertex along the X axis. | +| y | **ST\_Number** | required | | The position of the vertex along the Y axis. | A \ element represents a point in 2-dimensional space that is referenced by a segment in the slice. The decimal values representing the coordinates can be recorded to arbitrary precision. The precision used should be no higher than that expected from the producer's calculations. @@ -328,9 +328,9 @@ Element **\** ##### Attributes -| Name | Type | Use | Default | Fixed | Annotation | -| --- | --- | --- | --- | --- | --- | -| startv | **ST\_ResourceIndex** | required | | | References a zero-based index into the vertices for this slice. Defines the first vertex of the first segment. | +| Name | Type | Use | Default | Annotation | +| --- | --- | --- | --- | --- | +| startv | **ST\_ResourceIndex** | required | | References a zero-based index into the vertices for this slice. Defines the first vertex of the first segment. | The \ element contains a set of 1 or more \ elements to describe a 2D contour. If a \ contains content, there MUST be at least one \ to describe it. @@ -348,12 +348,12 @@ Element **\** ##### Attributes -| Name | Type | Use | Default | Fixed | Annotation | -| --- | --- | --- | --- | --- | --- | -| v2 | **ST\_ResourceIndex** | required | | | References a zero-based index into the vertices for this slice. Defines the second vertex of the segment. | -| p1 | **ST\_ResourceIndex** | | | | Overrides the slice-level pindex for the first vertex of the segment, which is v2 from the previous segment or startv from the parent polygon. | -| p2 | **ST\_ResourceIndex** | | | | Overrides the slice-level pindex for the second vertex of the segment | -| pid | **ST\_ResourceID** | | | | Overrides the slice-level pid for the segment. | +| Name | Type | Use | Default | Annotation | +| --- | --- | --- | --- | --- | +| v2 | **ST\_ResourceIndex** | required | | References a zero-based index into the vertices for this slice. Defines the second vertex of the segment. | +| p1 | **ST\_ResourceIndex** | | | Overrides the slice-level pindex for the first vertex of the segment, which is v2 from the previous segment or startv from the parent polygon. | +| p2 | **ST\_ResourceIndex** | | | Overrides the slice-level pindex for the second vertex of the segment | +| pid | **ST\_ResourceID** | | | Overrides the slice-level pid for the segment. | A \ element represents a single line segment (or edge) of a polygon. It runs from the vertex specified by the previous segment (or the startv \ attribute for the first segment) to the specified vertex, v2.