Contents

MTL4RenderEncoderOptions

Custom render pass options you specify at encoder creation time.

Declaration

struct MTL4RenderEncoderOptions

Overview

Use these options to implement parallel encoding of render passes across multiple CPU threads by providing these values to the options parameter of makeRenderCommandEncoder(descriptor:options:) and observing these requirements:

  1. Commit all command encoders together in an array you provide to commit:count: or commit:count:options:

  2. The first command buffer in the array contains a render pass that you start with option suspending

  3. The last command buffer in the array contains the same render pass that you start with option resuming

  4. All intermediate command buffers between the first and last in the array contain the same render pass that you start with both resuming and suspending options.

  5. The sequence of render passes, in submission order, doesn’t intermix with compute, blit, acceleration structure or machine learning encoding.

  6. A command buffer shouldn’t contain a render pass that you start with option suspending if it already contains a render pass that you start with option resuming.

Topics

Initializers

Type Properties

See Also

Submitting work to a GPU with Metal 4