Enumeration

MTLStoreAction

The action performed at the end of a rendering pass for a render command encoder.

Declaration

typedef enum MTLStoreAction : NSUInteger {
    ...
} MTLStoreAction;

Topics

Constants

MTLStoreActionDontCare

After the rendering pass is complete, the attachment is left in an undefined state. This may improve performance because it enables the implementation to avoid any work necessary to store the rendering results.

MTLStoreActionStore

The final results of the rendering pass are stored in the attachment.

MTLStoreActionMultisampleResolve

The multisample values are resolved into single sample values that are stored in the texture specified by the resolveTexture property. The contents of the attachment are left undefined.

MTLStoreActionStoreAndMultisampleResolve

The multisample values are stored in the attachment and also resolved into single sample values that are stored in the texture specified by the resolveTexture property.

MTLStoreActionUnknown

This is a temporary store action only to be used if you do not know the attachment’s store action up front. Use this value to defer your decision until after the render command encoder is created. You must specify a known store action before you finish encoding commands into the render command encoder. Refer to the MTLRenderCommandEncoder and MTLParallelRenderCommandEncoder protocol references for further information.

MTLStoreActionCustomSampleDepthStore

A render target action that stores depth data in a sample-position-agnostic representation.