Instance Method


Synchronously creates a render pipeline state object and associated reflection information.





A descriptor object that contains graphics rendering state properties, including rasterization, visibility, programmable shader, and blend state.


The type of reflection information to return.


On return, the location this parameter points to is filled with a new object that contains the reflection data about the vertex and fragment functions, including details about function arguments. If the pipeline state could not be compiled, then nil is returned.


On input, a pointer to an error object variable. On output, an error object that describes any error that occurred, or nil if the operation succeeded.

Return Value

A new object with the compiled graphics rendering pipeline state.


To use the graphics rendering pipeline state for a rendering pass, call the setRenderPipelineState(_:) method of a MTLRenderCommandEncoder object with the MTLRenderPipelineState object.


Pipeline Options

struct MTLPipelineOption

The compilation options that determine which argument information to provide.

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