A container for index buffer data and material information to be used in rendering all or part of a 3D object.
SDKs
- iOS 9.0+
- macOS 10.11+
- Mac Catalyst 13.0+
- tvOS 9.0+
Framework
- Model I/O
Declaration
class MDLSubmesh : NSObject
Class
MDLSubmesh
Topics
Creating a Submesh
init(indexInitializes a submesh with an index buffer and the specified properties.
init(name: String, indexInitializes a named submesh with an index buffer and the specified properties.
init(name: String, indexInitializes a named submesh with a specific topology.
init?(mdlInitializes a submesh by copying or converting another submesh.
Working with a Submesh’s Index Buffer
var indexAn object that provides index data for the submesh.
var indexThe number of indices in the submesh’s index buffer.
var indexThe data type for each element in the submesh’s index buffer.
var geometryThe type of geometric primitives described by the submesh’s index buffer.
var topology: MDLSubmeshA description of how the non-uniform layout of the submesh’s index buffer defines the shape of the mesh.
Associating Materials with a Submesh
var material: MDLMaterial?An object that describes the intended surface appearance of the submesh for rendering.
Identifying a Submesh
var name: StringA descriptive name for the submesh.
Importing Submesh Objects from SceneKit
init(scnCreates a submesh from the specified SceneKit geometry element, using the specified allocator.
init(scnCreates a submesh from the specified SceneKit geometry element.
Constants
enum MDLIndexOptions for the size of integer data in a submesh’s index buffer, used by the index property.
enum MDLGeometryTypes of geometric primitives for rendering a submesh, used by the geometry property.
See Also
3D Asset Basics
class MDLAssetAn indexed container for 3D objects and associated information, such as transform hierarchies, meshes, cameras, and lights.
class MDLObjectThe base class for objects that are part of a 3D asset, including meshes, cameras, and lights.
class MDLTransformA description of the local coordinate space transformations for a 3D object.
class MDLMeshA container for vertex buffer data to be used in rendering a 3D object.
class MDLSubmeshA description of how a submesh's index buffer data is arranged and how that arrangement should be used to produce the submesh's intended 3D shape.
protocol MDLNamedThe common interface for Model I/O objects that expose a human-readable name.