Instance Property

threadGroupSizeIsMultipleOfThreadExecutionWidth

A Boolean that indicates whether the threadgroup size must always be a multiple of the thread execution width.

Declaration

@property(readwrite, nonatomic) BOOL threadGroupSizeIsMultipleOfThreadExecutionWidth;

Discussion

The default value is NO. Set this to YES if you can guarantee that the compute function will always be dispatched with a threadgroup size that is a multiple of the thread execution width. Setting this flag to YES may improve performance.

When you use the resulting pipeline state object to encode commands, you get the thread execution width from its threadExecutionWidth property. The results are undefined if this value is set to YES and a dispatch call is made where the threadgroup size is not a multiple of the thread execution width.

See Also

Specifying the Compute Function and Associated Data

computeFunction

The compute function to be compiled into the pipeline state object.

maxTotalThreadsPerThreadgroup

The maximum number of threads allowed for a threadgroup dispatched to the compute function.