Contents

makeRenderPipelineState(descriptor:dynamicLinkingDescriptor:compilerTaskOptions:)

Creates a new render pipeline state asynchronously.

Declaration

func makeRenderPipelineState(descriptor: MTL4PipelineDescriptor, dynamicLinkingDescriptor: MTL4RenderPipelineDynamicLinkingDescriptor? = nil, compilerTaskOptions: MTL4CompilerTaskOptions? = nil) async throws -> any MTLRenderPipelineState

Parameters

  • descriptor:

    A render, tile, or mesh pipeline state descriptor that describes the pipeline to create.

  • dynamicLinkingDescriptor:

    An optional parameter that provides additional configuration for linking the pipeline state object.

  • compilerTaskOptions:

    A description of the compilation process itself, providing parameters that influence execution of the compilation process.

Return Value

A render pipeline state if operation upon success, otherwise this function throws.

Discussion

Use this method to build any render pipeline type, including render, tile, and mesh render pipeline states. The type of the descriptor you pass indicates the pipeline type this method builds.

Passing in a compute pipeline descriptor to the descriptor parameter produces an error.