Instance Method

setVertexBuffers(_:offsets:range:)

Sets an array of buffers for the vertex function.

Declaration

func setVertexBuffers(_ buffers: [MTLBuffer?], offsets: [Int], range: Range<Int>)

Parameters

buffers

An array of buffers to set in the buffer argument table.

offsets

An array of offsets, each of which specifies where the data begins, in bytes, from the start of its corresponding buffer.

range

A range of indices in the buffer argument table.

Discussion

For buffers in the device address space, align the offset to the data type consumed by the vertex function (which is always less than or equal to 16 bytes).

For buffers in the constant address space, align the offset to 256 bytes in macOS. In iOS, align the offset to the maximum of either the data type consumed by the vertex function, or 4 bytes. A 16-byte alignment is safe in iOS if you don't need to consider the data type.

See Also

Specifying Arguments for a Vertex Function

func setVertexBuffer(MTLBuffer?, offset: Int, index: Int)

Sets a buffer for the vertex function.

Required.

func setVertexBufferOffset(Int, index: Int)

Sets where the data begins in a buffer already bound to the vertex shader.

Required.

func setVertexBytes(UnsafeRawPointer, length: Int, index: Int)

Sets a block of data for the vertex shader.

Required.

func setVertexSamplerState(MTLSamplerState?, index: Int)

Sets a sampler for the vertex function.

Required.

func setVertexSamplerState(MTLSamplerState?, lodMinClamp: Float, lodMaxClamp: Float, index: Int)

Sets a sampler for the vertex function, specifying clamp values for the level of detail.

Required.

func setVertexSamplerStates([MTLSamplerState?], range: Range<Int>)

Sets multiple samplers for the vertex function.

func setVertexSamplerStates([MTLSamplerState?], lodMinClamps: [Float], lodMaxClamps: [Float], range: Range<Int>)

Sets a sampler state for the vertex function in a range of indices in the sampler state argument table, with clamp values for the level of detail.

func setVertexTexture(MTLTexture?, index: Int)

Sets a texture for the vertex function.

Required.

func setVertexTextures([MTLTexture?], range: Range<Int>)

Sets an array of textures for the vertex function.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software