Instance Method

newRenderPipelineStateWithDescriptor:options:completionHandler:

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

Required.

Declaration

- (void)newRenderPipelineStateWithDescriptor:(MTLRenderPipelineDescriptor *)descriptor options:(MTLPipelineOption)options completionHandler:(MTLNewRenderPipelineStateWithReflectionCompletionHandler)completionHandler;

Parameters

descriptor: A descriptor object that contains graphics rendering state properties, including rasterization, visibility, function, and blend state.
options: The type of reflection information to return.
completionHandler: A block of code that's invoked when the logic to create the render pipeline state object is completed.

Discussion

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

Topics

Pipeline Options

MTLPipelineOption

The compilation options that determine which argument information to provide.

Completion Handler

MTLNewRenderPipelineStateWithReflectionCompletionHandler

A block of code that is invoked when the logic to create a MTLRenderPipelineState object is completed.