Enumeration Case

MTLStoreActionOptionCustomSamplePositions

An option that stores data in a sample-position-agnostic representation.

Declaration

MTLStoreActionOptionCustomSamplePositions = 1 << 0

Discussion

Setting this option indicates that the data will be read in a subsequent render pass, or blit operation, that's unaware of the programmable sample positions used to generate the data. You should set this option when, for example, reading per-sample data within a fragment function that uses different programmable sample positions.

This option can only be set on a MTLRenderPassColorAttachmentDescriptor or MTLRenderPassDepthAttachmentDescriptor object. Setting this option on a MTLRenderPassStencilAttachmentDescriptor object or combining it with a nonstore storeAction value results in a runtime error.