Windows.Graphics.Printing3D.Printing3DContract

Creates the 3D printing experience.

Occurs when a new 3D print job has been created.

Gets a 3D print manager.

The 3D print manager.

Programmatically initiates the 3D printing user interface.

**true** if the operation completes successfully; otherwise, **false**.

Represents a 3D print job.

Gets the 3D print package to be printed.

The 3D print package to be printed.

Occurs when the print request has been sent to the 3D printer and the 3D print job has been created.

Occurs when the workflow modifies the 3D print package.

Occurs when the 3D print package has been submitted to the 3D printer.

Provides data for the Completed event of the 3D print request.

Gets the status of the 3D print request.

The completion status of the 3D print request.

Gets the type of error encountered during the 3D print request.

The type of error encountered during the 3D print request.

Specifies the completion status of a 3D print request.

The request has been abandoned.

The request has been cancelled.

The request has failed.

The driver is preparing layer by layer slices of the 3D model for the printer.

The request has been submitted successfully.

Specifies the type of errors encountered during a 3D print request.

An invalid printing material has been selected.

The 3D model is not valid.

The print ticket is not valid.

The 3D model exceeds the print bed.

The 3d model does not have manifold edges.

No additional information is available.

The upload of the 3D print package failed.

Represents a 3D print job request.

Creates a 3D print job.

The name of the print job. The identifier of the 3D printer. The callback for the source of the print job request. The 3D print job.

Provides data for the TaskRequested event.

Gets the 3D print job request associated with the Print3DManager.

The 3D print job request.

Provides data for the SourceChanged event.

Gets the updated 3D print package from the workflow.

The updated 3D print package.

Provides data for the Print3DTaskSourceRequestedHandler delegate.

Specifies the 3D Manufacturing Format (3MF) package to use in the print job.

The 3D Manufacturing Format (3MF) package to use in the print job.

Represents the method that handles requests for 3D print packages.

Provides the 3D print package for use in the 3D print job.

Represents a 3D Manufacturing Format (3MF) package.

Creates a Printing3D3MFPackage object.

Gets and sets the intended file compression level for this 3MF package. This is taken into account when the Printing3D3MFPackage instance is converted to a 3MF file.

A Printing3DPackageCompression value describing the level of compression intended.

Gets or sets an XML stream to the 3D model in the 3D Manufacturing Format (3MF) package.

An XML stream to the 3D model in the 3MF package.

Gets or sets a stream to the print ticket in the 3D Manufacturing Format (3MF) package.

A stream to the print ticket in the 3MF package.

Gets or sets the textures in the 3D Manufacturing Format (3MF) package.

The textures in the 3MF package, of type Printing3DTextureResource.

Gets or sets a thumbnail image that represents the contents of the 3D Manufacturing Format (3MF) package.

A thumbnail image that represents the contents of the 3MF package.

Creates a Printing3D3MFPackage object from a 3D Manufacturing Format (3MF) file stream.

A 3MF file stream. A Printing3D3MFPackage created from the specified 3MF package stream.

Creates a Printing3DModel object from a 3D Manufacturing Format (3MF) file stream.

A 3MF file stream. A Printing3DModel object created from the specified 3MF object stream.

Saves the Printing3D3MFPackage object to a 3D Manufacturing Format (3MF) file stream.

A stream to the 3MF file where the package is to be saved.

Saves the specified 3D model to the 3D Manufacturing Format (3MF) package.

The 3D model to be saved to the 3MF package. The results of the operation.

Represents the base material used for manufacturing certain objects in the 3D model.

Creates an instance of the Printing3DBaseMaterial class.

Gets the name the acrylonitrile butadiene styrene (ABS) thermoplastic used in the base material.

The name the ABS thermoplastic used in the base material.

Gets or sets the color of the base material.

The color of the base material.

Gets or sets the name of the base material.

The name of the base material.

Gets the name the polylactic acid (PLA) thermoplastic used in the base material.

The PLA thermoplastic used in the base material.

Represents a group of base materials used in the 3D model.

Creates an instance of the Printing3DBaseMaterialGroup class.

The identifier for the group of base materials used in the 3D model; a value greater than zero.

Gets a group of base materials used in the 3D model.

The base materials used in the 3D model, of type Printing3DBaseMaterial.

Gets the identifier (ID) of the base material group.

The ID of the base material group.

Specifies how to parse data in the buffer.

Specifies the format used by the buffer.

Specifies how far to move the pointer forward to find the next unit of data.

Specifies the format used by the buffer.

A buffer of type **double**.

A buffer of type **uint**.

A four-component, 128-bit floating-point format that supports 32 bits per channel including alpha.

A four-component, 128-bit unsigned-integer format that supports 32 bits per channel including alpha.

A three-component, 96-bit floating-point format that supports 32 bits per color channel.

A three-component, 96-bit unsigned-integer format that supports 32 bits per color channel.

The format is not known.

Represents a color material used in the 3D model.

Creates an instance of the Printing3DColorMaterial class.

Gets or sets the color of the material.

The color of the material.

Gets or sets the color value of the material.

The color value of the material.

Represents a group of color materials used in the 3D model.

Creates an instance of the Printing3DColorMaterialGroup class.

The identifier for the group of color materials used in the 3D model; a value greater than zero.

Gets a group of color materials used in the 3D model.

A group of color materials used in the 3D model, of type Printing3DColorMaterial.

Gets the identifier (ID) for the color material group.

The ID for the color material group.

Represents a 3D Manufacturing Format (3MF) component. Acts as a container of other components.

Creates an instance of the Printing3DComponent class.

Gets the other components contained within the component.

The other components contained within the component.

Gets or sets the 3D mesh of the component.

The 3D mesh of the component.

Gets or sets the name of the 3D Manufacturing Format (3MF) component.

The name of the 3MF component.

Gets or sets the part number of the 3D Manufacturing Format (3MF) component.

The part number of the 3MF component.

Gets or sets the thumbnail image of the 3D Manufacturing Format (3MF) component.

The thumbnail image of the 3MF component.

Gets or sets the type of the 3D Manufacturing Format (3MF) component.

The type of the 3MF component.

Represents a 3D Manufacturing Format (3MF) component that's applied to the object definition with a matrix transform.

Creates an instance of the Printing3DComponentWithMatrix class.

Gets or sets the 3D Manufacturing Format (3MF) primitive component that's applied to the object definition with a matrix transform.

The 3MF primitive component that's applied to the object definition with a matrix transform.

Gets or sets the matrix transform that's applied to the 3D Manufacturing Format (3MF) primitive component.

The matrix transform that's applied to the 3D Manufacturing Format (3MF) primitive component.

Represents a composite material that's defined by a mixture of base materials.

Creates an instance of the Printing3DCompositeMaterial class.

Gets the mixture of base materials used in the composite material. Each mixture is defined by listing the proportion of the overall mixture for each base material (values between 0 and 1).

The proportions of base materials used in the composite material (values between 0 and 1). Proportion values are specified in the same order as the base materials in MaterialIndices.

Represents a group of composite materials.

Creates an instance of the Printing3DCompositeMaterialGroup class.

The identifier (ID) of the composite material group; a value greater than zero.

Gets the existing Printing3DBaseMaterialGroup whose Printing3DBaseMaterial members will be used to produce composite materials.

The Printing3DBaseMaterialGroup from which to produce composite materials.

Gets an list of mixtures that define individual composite materials. Each mixture is defined by listing the proportion of the overall mixture for each base material (values between 0 and 1), where the proportion values are specified in the same order as the base materials in MaterialIndices.

A list of mixtures that define individual composite materials.

Gets the identifier (ID) of the base material group that defines the materials used in the composite material group.

The ID of the base material group that defines the materials used in the composite material group.

Gets an ordered list of base materials that are used to make the composite materials in the group. The order of base materials is maintained in the mixture values defined by Composites.

Index values of base materials from the base material group specified by MaterialGroupId.

Provides additional information for the TryReduceFacesAsync method in the Printing3DModel class

Creates an instance of the Printing3DFaceReductionOptions class.

Sets the maximum length of an edge for which the triangles that share said edge can be merged via the TryReduceFacesAsync method. If set to zero, a built-in default value is used.

Maximum length of an edge for which the triangles that share said edge can be merged.

Sets the area of a triangle above which said triangle cannot be merged via the TryReduceFacesAsync method. If set to zero, a built-in default value is used.

Maximum area at which a triangle can be merged.

Sets the desired number of triangles on a mesh. The TryReduceFacesAsync method will stop merging faces if the triangle count is less than or equal to this number. If set to zero, the algorithm will run until the number of triangles is reduced by half.

Desired number of triangles on a mesh.

Represents all material resources in the 3D model.

Creates an instance of the Printing3DMaterial class.

Gets all base material groups used in the 3D model.

All base material groups used in the 3D model, of type Printing3DBaseMaterialGroup.

Gets all color material groups used in the 3D model.

All color material groups used in the 3D model, of type Printing3DColorMaterialGroup.

Gets all composite material groups used in the 3D model.

All composite material groups used in the 3D model, of type Printing3DCompositeMaterialGroup.

Gets all multi-property groups used in the 3D model.

All multi-property groups used in the 3D model, of type Printing3DMultiplePropertyMaterialGroup.

Gets all 2D texture material groups used in the 3D model.

All 2D texture material groups used in the 3D model, of type Printing3DTexture2CoordMaterialGroup.

Represents a mesh in the 3D model.

Creates an instance of the Printing3DMesh class.

Gets a set of mesh buffer descriptions.

A set of mesh buffer descriptions.

Gets a set of mesh buffers.

A set of mesh buffers.

Gets or sets the number of triangle indices.

The number of triangle indices.

Gets or sets the buffer description for triangle indices.

The buffer description for triangle indices.

Gets or sets the buffer description for triangle material indices.

The buffer description for triangle material indices.

Gets or sets the number of triangle vertices.

The number of triangle vertices.

Gets or sets the buffer description for vertex normals.

The buffer description for vertex normals.

Gets or sets the buffer description for vertex positions.

The buffer description for vertex positions.

Creates the buffer for triangle indices.

The capacity of the buffer, the maximum number of bytes that the IBuffer can hold.

Creates the buffer for triangle material indices.

The capacity of the buffer, the maximum number of bytes that the IBuffer can hold.

Creates the buffer for vertex normals.

The capacity of the buffer, the maximum number of bytes that the IBuffer can hold.

Creates the buffer for vertex positions.

The capacity of the buffer, the maximum number of bytes that the IBuffer can hold.

Gets the buffer for triangle indices.

The buffer for triangle indices.

Gets the buffer for triangle material indices.

The buffer for triangle material indices.

Gets the buffer for vertex normals.

The buffer for vertex normals.

Gets the buffer for vertex positions.

The buffer for vertex positions.

Verifies the mesh has manifold edges and normal triangles.

Specifies how the mesh is verified. The results of the verification, of type Printing3DMeshVerificationResult.

Specifies the mode in which the mesh is verified.

Wait to return results until the verification is complete.

Return results upon finding the first failure.

Provides data for the VerifyAsync method.

Gets a value that indicates if the mesh is valid.

**true** if the mesh is valid; otherwise, **false**.

Gets the triangles with non-manifold edges, if applicable.

The triangles with non-manifold edges.

Gets the reverse normal triangles, if applicable.

The reverse normal triangles.

Represents the 3D model in a 3D Manufacturing Format (3MF) package.

Creates an instance of the Printing3DModel class.

Gets or sets the root 3D Manufacturing Format (3MF) component. It represents the build plate on a 3D printer and defines what will be printed.

The root 3MF component.

Gets all 3D Manufacturing Format (3MF) components used in the 3D model.

All 3MF components used in the 3D model, of type Printing3DComponent.

Gets or sets the root material container for the 3D model.

The root material container for the 3D model.

Gets all meshes used in the 3D model.

All meshes used in the 3D model, of type Printing3DMesh.

Gets the metadata for the 3D Manufacturing Format (3MF) package.

The metadata for the 3MF package.

Gets a list of the extensions required by the 3D Manufacturing Format (3MF) package.

The extensions required by the 3MF package.

Gets all textures used in the 3D model.

All textures used in the 3D model, of type Printing3DModelTexture.

Gets or sets the units of measure used in the 3D model.

The units of measure used in the 3D model.

Gets or sets the version of the 3D Manufacturing Format (3MF) package.

The version of the 3MF package.

Gets a copy of the current 3D model.

A copy of the current 3D model.

Executes the 3D model repair algorithm on the model.

Results of the operation.

Executes the 3D model repair algorithm, with the ability to report the progress of the operation.

A **Boolean** value indicating whether the asynchronous operation succeeded, and a **Double** value reporting the progress as a decimal number between zero and one.

Executes the 3D model repair algorithm until complete or an exception is thrown.

**true** if the asynchronous operation succeeded; otherwise, **false**.

Begins the 3D model repair algorithm, but exits if the time limit is reached.

Defines the amount of time (in seconds) that the algorithm can run for. A value of 0 will cause the algorithm to run until another end condition is met. **true** if the asynchronous operation succeeded; otherwise, **false**.

Runs an algorithm that reduces the number of triangle faces in all of the meshes within the Printing3DModel by merging nearby vertices. Stops when the total number of triangles is reduced by half.

A **Boolean** value indicating whether the asynchronous operation succeeded, and a **Double** value reporting the progress as a decimal number between zero and one.

Runs an algorithm that reduces the number of triangle faces in all of the meshes within the Printing3DModel by merging nearby vertices. Stops according to the specified options.

Defines the conditions which will trigger the end of the operation. A **Boolean** value indicating whether the asynchronous operation succeeded, and a **Double** value reporting the progress as a decimal number between zero and one.

Runs an algorithm that reduces the number of triangle faces in all of the meshes within the Printing3DModel by merging nearby vertices. Stops according to the specified options or when the *maxWait* time is reached.

Defines the conditions which will trigger the end of the operation. Defines the amount of time (in seconds) that the algorithm can run for. A value of 0 will cause the algorithm to run until another end condition is met. A **Boolean** value indicating whether the asynchronous operation succeeded, and a **Double** value reporting the progress as a decimal number between zero and one.

Represents a texture used in the 3D model.

Creates an instance of the Printing3DModelTexture class.

Gets or sets the texture resource used by the texture.

The texture resource used by the texture.

Get or sets a value that indicates how tiling should occur in the U axis in order to fill the overall requested area.

A value that indicates how tiling should occur in the U axis in order to fill the overall requested area.

Gets or sets a value that indicates how tiling should occur in the V axis in order to fill the overall requested area.

A value that indicates how tiling should occur in the V axis in order to fill the overall requested area.

Specifies the units of measure used in the 3D model.

The units of the 3D model are specified in centimeters.

The units of the 3D model are specified in feet.

The units of the 3D model are specified in inches.

The units of the 3D model are specified in meters.

The units of the 3D model are specified in microns.

The units of the 3D model are specified in millimeters.

Represents a combination of properties and/or materials from the material groups specified in (MaterialGroupIndices ).

Creates an instance of the Printing3DMultiplePropertyMaterial class.

Gets the indices of the properties and/or materials combined in the multi-property material. Each combination is defined by listing the index of an item from one material group with the index of an item from a secondary material group. The index values are specified in the same order as the material groups listed in MaterialGroupIndices.

The indices of the properties or materials combined in the multi-property.

Represents a multi-property material group.

Creates a new instance of the Printing3DMultiplePropertyMaterialGroup class.

The identifier (ID) of the multi-property material group; a value greater than zero.

Gets the identifier (ID) of the multi-property material group.

The ID of the multi-property material group.

Gets an ordered list of material groups (**MaterialGroupId** values) that are used to define property-material combinations in the multi-property group. The order of material groups is maintained in the combinations defined by MultipleProperties.

The indices of the properties or materials in the group.

Gets a list of property-material combinations. Each combination is defined by listing the index of an item from one material group with the index of an item from a secondary material group. The index values are specified in the same order as the material groups listed in MaterialGroupIndices.

A list of property-material combinations .

Specifies the function of the object in the 3D model.

Functions as a core component of the 3D model.

Functions in some other capacity.

Functions as a support object.

Contains values that describe the intended file compression level.

High file compression. This is recommended to reduce the size of the 3MF package before saving it to disk or sending it over the network.

Low file compression. This results in faster in-memory processing.

Medium file compression. This is the default value.

Represents a 2D texture material used in the 3D model.

Creates an instance of the Printing3DTexture2CoordMaterial class.

Gets or sets the texture used in the 2D texture material.

The texture used in the 2D texture material.

Gets or sets the U-coordinate within the texture, horizontally right from the origin in the upper left of the texture.

The U-coordinate within the texture.

Gets or sets the V-coordinate within the texture, vertically down from the origin in the upper left of the texture.

The V-coordinate within the texture.

Represents a group of 2D texture materials used in the 3D model.

Creates a instance of the Printing3DTexture2CoordMaterialGroup class.

The identifier for a group of 2D texture materials used in the 3D model; a value greater than zero.

Gets the identifier (ID) of the 2D texture material group.

The ID of the 2D texture material group.

Gets or sets the texture of the material group.

The texture of the material group.

Gets a group of 2D texture materials used in the 3D model.

A group of 2D texture materials used in the 3D model, of type Printing3DTexture2CoordMaterial.

Specifies how tiling should occur in the U and V axis in order to fill the overall requested area of a texture.

Clamps texture coordinates to the [0.0, 1.0] range. That is, it applies the texture once, then smears the color of edge pixels. For example, suppose that your application creates a square primitive and assigns texture coordinates of (0.0,0.0), (0.0,3.0), (3.0,3.0), and (3.0,0.0) to the primitive's vertices. Setting the **Clamp** texture edge behavior results in the texture being applied once.

Tiles mirror the texture at every integer boundary. For example, with texture coordinates of (0.0,0.0), (0.0,3.0), (3.0,3.0), and (3.0,0.0). Setting the **Wrap** texture edge behavior results in the texture being applied three times in both the u- and v-directions. Every other row and column that it is applied is a mirror image of the preceding row or column, as shown here. <img alt="Illustration of mirror images in a 3x3 grid" src="./windows.graphics.printing3d/images/mirror.png" />

No tiling will occur.

Tiles repeat the texture resource at every integer junction. For example, with texture coordinates of (0.0,0.0), (0.0,3.0), (3.0,3.0), and (3.0,0.0), setting the **Wrap** texture edge behavior results in the texture being applied three times in both the u-and v-directions, as shown here.<img alt="Illustration of a face texture wrapped in the u-direction and the v-direction" src="./windows.graphics.printing3d/images/wrap.png" />

Specifies the texture resource used in a 2D texture material.

Creates an instance of the Printing3DTextureResource class.

Gets or sets the name of the texture resource.

The name of the texture resource.

Gets or sets the image stream of the texture resource.

The image stream of the texture resource.