An object that you use to configure new rasterization rate maps.


@interface MTLRasterizationRateMapDescriptor : NSObject


To create a new rate map, first create a MTLRasterizationRateMapDescriptor object and set its property values. Then, call the newRasterizationRateMapWithScreenSize:layerCount:layers: method of a MTLDevice object to create the rate map.

When you create a rate map, Metal copies property values from the descriptor into it. You can reuse a MTLRasterizationRateMapDescriptor object, modifying its property values as needed, without affecting the rate maps you already created.


Creating Rate Map Descriptors

+ rasterizationRateMapDescriptorWithScreenSize:

Creates a rate map descriptor with a given size and identifier.

+ rasterizationRateMapDescriptorWithScreenSize:layer:

Creates a rate map descriptor with a single rate layer.

+ rasterizationRateMapDescriptorWithScreenSize:layerCount:layers:

Creates a rate map descriptor with a set of layer descriptors.

Identifying the Rate Map


A string used to identify the rate map you create with the descriptor.

Configuring the Viewport Size


The size of the viewport coordinate system, in logical pixels.

Configuring the Rate Map Layers


The number of layers in the rate map.

- layerAtIndex:

Returns the layer description for a layer in the rate map.

- setLayer:atIndex:

Sets a configuration for a layer rate map.


The rasterization rates for one or more layers in the rate map.


Descriptions for the rasterization rates to apply to the set of layers in a rate map.


Inherits From

Conforms To

See Also

Specifying a Rasterization Rate Map

Rendering at Different Rasterization Rates

Configure a rasterization rate map to vary rasterization rates depending on the amount of detail needed.


The rasterization rate map to use when executing the render pass.


A compiled read-only object that determines how to apply variable rasterization rates when rendering.