Enumeration

MTLStoreAction

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

Declaration

enum MTLStoreAction : UInt

Topics

Constants

case dontCare

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.

case store

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

case multisampleResolve

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.

case storeAndMultisampleResolve

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.

case unknown

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.

case customSampleDepthStore

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