getDefaultSamplePositions(sampleCount:)

Declaration

func getDefaultSamplePositions(sampleCount: Int) -> [MTLSamplePosition]

Parameters

• sampleCount:

  The number of points a GPU can sample from a texture. Ensure the GPU can support the sampleCount value by first calling the device’s Supportstexturesamplecount(_:) method.

Return Value

An array of MTLSamplePosition instances.

Discussion

The default sample positions are the same on all GPUs that support programmable sample positions (see areProgrammableSamplePositionsSupported).

The default sample position for GPUs that can sample one time is at the pixel’s center.

[Image]

The default sample positions for GPUs that can sample two times have locations in the center of the pixel’s second quadrant and fourth quadrants.

[Image]

The default sample positions for GPUs that can sample four times have one location in each of the pixel’s quadrants. Each location is at the center of one of that quadrant’s subquadrants.

[Image]

The default sample positions for GPUs that can sample eight times have two locations in each of the pixel’s quadrants.

[Image]

The table lists the indices and default locations for GPUs that support 1, 2, 4, or 8 sample positions.

See Also

Creating samplers

• supportsTextureSampleCount(_:)
• makeSamplerState(descriptor:)