Class

MDLVertexDescriptor

A description of the structure, format, and layout for vertex data buffers associated with a mesh.

Declaration

@interface MDLVertexDescriptor : NSObject

Overview

A MDLMesh object contains arrays of data for separate attributes of each vertex, such as position, color, surface normal vector, or texture coordinates. The vertex data for various attributes can be contained in one or more buffers and may be laid out in various contiguous or interleaved formats. You use a mesh’s vertexDescriptor property to determine the structure of vertex data for a mesh loaded from an asset file for use in rendering or processing a mesh. You also use vertex descriptors to describe the structure of existing vertex data when creating a new mesh.

Topics

Working with Vertex Attributes

attributes

The list of vertex attributes described by the vertex descriptor.

- attributeNamed:

Returns the vertex attribute with the specified name in the vertex descriptor.

- addOrReplaceAttribute:

Adds the specified vertex attribute to the vertex descriptor, replacing any existing attribute with the same name.

- setPackedOffsets

Sets the offset for each vertex attribute to the minimum value to pack vertex data together in a single buffer.

Working with Vertex Buffer Layouts

layouts

The list of vertex buffer layouts described by the vertex descriptor.

- setPackedStrides

Sets the stride for each vertex layout to the minimum value to pack vertex data together in a single buffer.

Resetting a Vertex Descriptor

- reset

Resets a vertex descriptor to its default state.

Copying a Vertex Descriptor

- initWithVertexDescriptor:

Creates a new vertex descriptor by performing a deep copy of the specified vertex descriptor.

Instance Methods

Relationships

Inherits From

Conforms To

See Also

Managing Mesh Data

MDLMeshBuffer

The general interface for managing storage of vertex and index data used in loading, processing, and rendering meshes.

MDLMeshBufferAllocator

The general interface for managing allocation of data buffers to be used in loading, processing, and rendering meshes.

MDLMeshBufferData

A memory buffer that stores vertex or index data for a Model I/O mesh.

MDLMeshBufferDataAllocator

A basic allocator implementation that allocates from main memory using data objects.

MDLMeshBufferMap

An object that manages access to a memory buffer used for the data storage of a Model I/O mesh.

MDLMeshBufferZone

The general interface for logical pools of memory used in allocation of related mesh data buffers.

MDLMeshBufferZoneDefault

A standard implementation of the MDLMeshBufferZone protocol.

MDLVertexAttribute

A description of the format of per-vertex data for a single vertex attribute in a mesh object.

MDLVertexAttributeData

An object that provides convenience access to vertex data for a specific vertex attribute of a mesh.

MDLVertexBufferLayout

A MDLVertexBufferLayout object describes layout information for a vertex buffer in a MDLMesh object. A collection of vertex layer objects, vertex attribute objects, and additional information forms a MDLVertexDescriptor object, which completely describes the layout of vertex buffers for a mesh.