Contents

makeRenderPipelineDescriptorForSpecialization()

Creates a render pipeline descriptor from this pipeline that you can use for pipeline specialization.

Declaration

func makeRenderPipelineDescriptorForSpecialization() -> MTL4PipelineDescriptor

Return Value

A new pipeline descriptor that you use for pipeline state specialization.

Discussion

Use this method to obtain a new MTL4PipelineDescriptor instance that you can use to specialize any unspecialized properties in this pipeline state object.

The returned descriptor contains every unspecialized field in the current pipeline state object, set to unspecialized. It may, however, not contain valid or accurate properties in any other field.

This descriptor is only valid for the purpose of calling specialization functions on the MTL4Compiler to specialize this pipeline, for example: newRenderPipelineStateBySpecializationWithDescriptor:pipeline:error:.

Although this method returns the MTL4PipelineDescriptor base class, the concrete instance this method returns corresponds to the specific descriptor type for the creation of this pipeline state, for example if a MTL4Compiler instance creates this current pipeline form a MTLTileRenderPipelineDescriptor, this method returns a concrete MTLTileRenderPipelineDescriptor instance.