Vulkan.Extensions.VK_EXT_sample_locations

Name

VK_EXT_sample_locations - device extension

VK_EXT_sample_locations

Name String

VK_EXT_sample_locations

Extension Type

Device extension

Registered Extension Number

144

Revision

1

Extension and Version Dependencies

• Requires Vulkan 1.0
• Requires VK_KHR_get_physical_device_properties2

Contact

• Daniel Rakos https://github.com/KhronosGroup/Vulkan-Docs/issues/new?title=VK_EXT_sample_locations:%20&body=@drakos-amd%20

Other Extension Metadata

Last Modified Date

2017-08-02

Contributors

• Mais Alnasser, AMD
• Matthaeus G. Chajdas, AMD
• Maciej Jesionowski, AMD
• Daniel Rakos, AMD
• Slawomir Grajewski, Intel
• Jeff Bolz, NVIDIA
• Bill Licea-Kane, Qualcomm

Description

This extension allows an application to modify the locations of samples within a pixel used in rasterization. Additionally, it allows applications to specify different sample locations for each pixel in a group of adjacent pixels, which can increase antialiasing quality (particularly if a custom resolve shader is used that takes advantage of these different locations).

It is common for implementations to optimize the storage of depth values by storing values that can be used to reconstruct depth at each sample location, rather than storing separate depth values for each sample. For example, the depth values from a single triangle may be represented using plane equations. When the depth value for a sample is needed, it is automatically evaluated at the sample location. Modifying the sample locations causes the reconstruction to no longer evaluate the same depth values as when the samples were originally generated, thus the depth aspect of a depth/stencil attachment must be cleared before rendering to it using different sample locations.

Some implementations may need to evaluate depth image values while performing image layout transitions. To accommodate this, instances of the SampleLocationsInfoEXT structure can be specified for each situation where an explicit or automatic layout transition has to take place. SampleLocationsInfoEXT can be chained from ImageMemoryBarrier structures to provide sample locations for layout transitions performed by cmdWaitEvents and cmdPipelineBarrier calls, and RenderPassSampleLocationsBeginInfoEXT can be chained from RenderPassBeginInfo to provide sample locations for layout transitions performed implicitly by a render pass instance.

New Commands

• cmdSetSampleLocationsEXT

• getPhysicalDeviceMultisamplePropertiesEXT

New Structures

• AttachmentSampleLocationsEXT

• MultisamplePropertiesEXT
• SampleLocationEXT
• SubpassSampleLocationsEXT

• Extending ImageMemoryBarrier, ImageMemoryBarrier2KHR:

  • SampleLocationsInfoEXT

• Extending PhysicalDeviceProperties2:

  • PhysicalDeviceSampleLocationsPropertiesEXT

• Extending PipelineMultisampleStateCreateInfo:

  • PipelineSampleLocationsStateCreateInfoEXT

• Extending RenderPassBeginInfo:

  • RenderPassSampleLocationsBeginInfoEXT

New Enum Constants

• EXT_SAMPLE_LOCATIONS_EXTENSION_NAME

• EXT_SAMPLE_LOCATIONS_SPEC_VERSION

• Extending DynamicState:

  • DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT

• Extending ImageCreateFlagBits:

  • IMAGE_CREATE_SAMPLE_LOCATIONS_COMPATIBLE_DEPTH_BIT_EXT

• Extending StructureType:

  • STRUCTURE_TYPE_MULTISAMPLE_PROPERTIES_EXT
  • STRUCTURE_TYPE_PHYSICAL_DEVICE_SAMPLE_LOCATIONS_PROPERTIES_EXT
  • STRUCTURE_TYPE_PIPELINE_SAMPLE_LOCATIONS_STATE_CREATE_INFO_EXT
  • STRUCTURE_TYPE_RENDER_PASS_SAMPLE_LOCATIONS_BEGIN_INFO_EXT
  • STRUCTURE_TYPE_SAMPLE_LOCATIONS_INFO_EXT

Version History

• Revision 1, 2017-08-02 (Daniel Rakos)

  • Internal revisions

See Also

AttachmentSampleLocationsEXT, MultisamplePropertiesEXT, PhysicalDeviceSampleLocationsPropertiesEXT, PipelineSampleLocationsStateCreateInfoEXT, RenderPassSampleLocationsBeginInfoEXT, SampleLocationEXT, SampleLocationsInfoEXT, SubpassSampleLocationsEXT, cmdSetSampleLocationsEXT, getPhysicalDeviceMultisamplePropertiesEXT

Document Notes

For more information, see the Vulkan Specification

This page is a generated document. Fixes and changes should be made to the generator scripts, not directly.

Documentation

cmdSetSampleLocationsEXT

Arguments

:: forall io. MonadIO io

=> CommandBuffer

commandBuffer is the command buffer into which the command will be recorded.

-> SampleLocationsInfoEXT

pSampleLocationsInfo is the sample locations state to set.

-> io ()

vkCmdSetSampleLocationsEXT - Set the dynamic sample locations state

Valid Usage

• The sampleLocationsPerPixel member of pSampleLocationsInfo must equal the rasterizationSamples member of the PipelineMultisampleStateCreateInfo structure the bound graphics pipeline has been created with

• If PhysicalDeviceSampleLocationsPropertiesEXT::variableSampleLocations is FALSE then the current render pass must have been begun by specifying a RenderPassSampleLocationsBeginInfoEXT structure whose pPostSubpassSampleLocations member contains an element with a subpassIndex matching the current subpass index and the sampleLocationsInfo member of that element must match the sample locations state pointed to by pSampleLocationsInfo

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• pSampleLocationsInfo must be a valid pointer to a valid SampleLocationsInfoEXT structure
• commandBuffer must be in the recording state
• The CommandPool that commandBuffer was allocated from must support graphics operations

Host Synchronization

• Host access to commandBuffer must be externally synchronized

• Host access to the CommandPool that commandBuffer was allocated from must be externally synchronized

Command Properties

'

Command Buffer Levels	Render Pass Scope	Supported Queue Types
Primary Secondary	Both	Graphics

See Also

CommandBuffer, SampleLocationsInfoEXT

getPhysicalDeviceMultisamplePropertiesEXT

Arguments

:: forall io. MonadIO io

=> PhysicalDevice

physicalDevice is the physical device from which to query the additional multisampling capabilities.

physicalDevice must be a valid PhysicalDevice handle

-> ("samples" ::: SampleCountFlagBits)

samples is a SampleCountFlagBits value specifying the sample count to query capabilities for.

samples must be a valid SampleCountFlagBits value

-> io MultisamplePropertiesEXT

vkGetPhysicalDeviceMultisamplePropertiesEXT - Report sample count specific multisampling capabilities of a physical device

Valid Usage (Implicit)

See Also

MultisamplePropertiesEXT, PhysicalDevice, SampleCountFlagBits

data SampleLocationEXT

VkSampleLocationEXT - Structure specifying the coordinates of a sample location

Description

The domain space of the sample location coordinates has an upper-left origin within the pixel in framebuffer space.

The values specified in a SampleLocationEXT structure are always clamped to the implementation-dependent sample location coordinate range [sampleLocationCoordinateRange[0],sampleLocationCoordinateRange[1]] that can be queried using PhysicalDeviceSampleLocationsPropertiesEXT.

See Also

SampleLocationsInfoEXT

Constructors

SampleLocationEXT

Fields

• x :: Float

  x is the horizontal coordinate of the sample’s location.

• y :: Float

  y is the vertical coordinate of the sample’s location.

Instances

Eq SampleLocationEXT

Defined in Vulkan.Extensions.VK_EXT_sample_locations

Methods

(==) :: SampleLocationEXT -> SampleLocationEXT -> Bool

(/=) :: SampleLocationEXT -> SampleLocationEXT -> Bool

Show SampleLocationEXT

Defined in Vulkan.Extensions.VK_EXT_sample_locations

Methods

showsPrec :: Int -> SampleLocationEXT -> ShowS

show :: SampleLocationEXT -> String

showList :: [SampleLocationEXT] -> ShowS

Storable SampleLocationEXT

Defined in Vulkan.Extensions.VK_EXT_sample_locations

Methods

sizeOf :: SampleLocationEXT -> Int

alignment :: SampleLocationEXT -> Int

peekElemOff :: Ptr SampleLocationEXT -> Int -> IO SampleLocationEXT

pokeElemOff :: Ptr SampleLocationEXT -> Int -> SampleLocationEXT -> IO ()

peekByteOff :: Ptr b -> Int -> IO SampleLocationEXT

pokeByteOff :: Ptr b -> Int -> SampleLocationEXT -> IO ()

peek :: Ptr SampleLocationEXT -> IO SampleLocationEXT

poke :: Ptr SampleLocationEXT -> SampleLocationEXT -> IO ()

FromCStruct SampleLocationEXT

Defined in Vulkan.Extensions.VK_EXT_sample_locations

Methods

peekCStruct :: Ptr SampleLocationEXT -> IO SampleLocationEXT

ToCStruct SampleLocationEXT

Defined in Vulkan.Extensions.VK_EXT_sample_locations

Methods

withCStruct :: SampleLocationEXT -> (Ptr SampleLocationEXT -> IO b) -> IO b

pokeCStruct :: Ptr SampleLocationEXT -> SampleLocationEXT -> IO b -> IO b

withZeroCStruct :: (Ptr SampleLocationEXT -> IO b) -> IO b

pokeZeroCStruct :: Ptr SampleLocationEXT -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

Zero SampleLocationEXT

Defined in Vulkan.Extensions.VK_EXT_sample_locations

Methods

zero :: SampleLocationEXT

data SampleLocationsInfoEXT

VkSampleLocationsInfoEXT - Structure specifying a set of sample locations

Description

This structure can be used either to specify the sample locations to be used for rendering or to specify the set of sample locations an image subresource has been last rendered with for the purposes of layout transitions of depth/stencil images created with IMAGE_CREATE_SAMPLE_LOCATIONS_COMPATIBLE_DEPTH_BIT_EXT.

The sample locations in pSampleLocations specify sampleLocationsPerPixel number of sample locations for each pixel in the grid of the size specified in sampleLocationGridSize. The sample location for sample i at the pixel grid location (x,y) is taken from pSampleLocations[(x + y × sampleLocationGridSize.width) × sampleLocationsPerPixel + i].

If the render pass has a fragment density map, the implementation will choose the sample locations for the fragment and the contents of pSampleLocations may be ignored.

Valid Usage

• sampleLocationsPerPixel must be a bit value that is set in PhysicalDeviceSampleLocationsPropertiesEXT::sampleLocationSampleCounts

• sampleLocationsCount must equal sampleLocationsPerPixel × sampleLocationGridSize.width × sampleLocationGridSize.height

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_SAMPLE_LOCATIONS_INFO_EXT

• If sampleLocationsCount is not 0, pSampleLocations must be a valid pointer to an array of sampleLocationsCount SampleLocationEXT structures

See Also

AttachmentSampleLocationsEXT, Extent2D, PipelineSampleLocationsStateCreateInfoEXT, SampleCountFlagBits, SampleLocationEXT, StructureType, SubpassSampleLocationsEXT, cmdSetSampleLocationsEXT

Constructors

SampleLocationsInfoEXT

Fields

• sampleLocationsPerPixel :: SampleCountFlagBits

  sampleLocationsPerPixel is a SampleCountFlagBits value specifying the number of sample locations per pixel.

• sampleLocationGridSize :: Extent2D

  sampleLocationGridSize is the size of the sample location grid to select custom sample locations for.

• sampleLocations :: Vector SampleLocationEXT

  pSampleLocations is a pointer to an array of sampleLocationsCount SampleLocationEXT structures.

Instances

Show SampleLocationsInfoEXT

Defined in Vulkan.Extensions.VK_EXT_sample_locations

Methods

showsPrec :: Int -> SampleLocationsInfoEXT -> ShowS

show :: SampleLocationsInfoEXT -> String

showList :: [SampleLocationsInfoEXT] -> ShowS

FromCStruct SampleLocationsInfoEXT

Defined in Vulkan.Extensions.VK_EXT_sample_locations

Methods

peekCStruct :: Ptr SampleLocationsInfoEXT -> IO SampleLocationsInfoEXT

ToCStruct SampleLocationsInfoEXT

Defined in Vulkan.Extensions.VK_EXT_sample_locations

Methods

withCStruct :: SampleLocationsInfoEXT -> (Ptr SampleLocationsInfoEXT -> IO b) -> IO b

pokeCStruct :: Ptr SampleLocationsInfoEXT -> SampleLocationsInfoEXT -> IO b -> IO b

withZeroCStruct :: (Ptr SampleLocationsInfoEXT -> IO b) -> IO b

pokeZeroCStruct :: Ptr SampleLocationsInfoEXT -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

Zero SampleLocationsInfoEXT

Defined in Vulkan.Extensions.VK_EXT_sample_locations

Methods

zero :: SampleLocationsInfoEXT

data AttachmentSampleLocationsEXT

VkAttachmentSampleLocationsEXT - Structure specifying the sample locations state to use in the initial layout transition of attachments

Description

If the image referenced by the framebuffer attachment at index attachmentIndex was not created with IMAGE_CREATE_SAMPLE_LOCATIONS_COMPATIBLE_DEPTH_BIT_EXT then the values specified in sampleLocationsInfo are ignored.

Valid Usage (Implicit)

See Also

RenderPassSampleLocationsBeginInfoEXT, SampleLocationsInfoEXT

Constructors

AttachmentSampleLocationsEXT

Fields

• attachmentIndex :: Word32

  attachmentIndex is the index of the attachment for which the sample locations state is provided.

  attachmentIndex must be less than the attachmentCount specified in RenderPassCreateInfo the render pass specified by RenderPassBeginInfo::renderPass was created with

• sampleLocationsInfo :: SampleLocationsInfoEXT

  sampleLocationsInfo is the sample locations state to use for the layout transition of the given attachment from the initial layout of the attachment to the image layout specified for the attachment in the first subpass using it.

  sampleLocationsInfo must be a valid SampleLocationsInfoEXT structure

Instances

Show AttachmentSampleLocationsEXT

Defined in Vulkan.Extensions.VK_EXT_sample_locations

Methods

showsPrec :: Int -> AttachmentSampleLocationsEXT -> ShowS

show :: AttachmentSampleLocationsEXT -> String

showList :: [AttachmentSampleLocationsEXT] -> ShowS

FromCStruct AttachmentSampleLocationsEXT

Defined in Vulkan.Extensions.VK_EXT_sample_locations

Methods

peekCStruct :: Ptr AttachmentSampleLocationsEXT -> IO AttachmentSampleLocationsEXT

ToCStruct AttachmentSampleLocationsEXT

Defined in Vulkan.Extensions.VK_EXT_sample_locations

Methods

withCStruct :: AttachmentSampleLocationsEXT -> (Ptr AttachmentSampleLocationsEXT -> IO b) -> IO b

pokeCStruct :: Ptr AttachmentSampleLocationsEXT -> AttachmentSampleLocationsEXT -> IO b -> IO b

withZeroCStruct :: (Ptr AttachmentSampleLocationsEXT -> IO b) -> IO b

pokeZeroCStruct :: Ptr AttachmentSampleLocationsEXT -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

Zero AttachmentSampleLocationsEXT

Defined in Vulkan.Extensions.VK_EXT_sample_locations

Methods

zero :: AttachmentSampleLocationsEXT

data SubpassSampleLocationsEXT

VkSubpassSampleLocationsEXT - Structure specifying the sample locations state to use for layout transitions of attachments performed after a given subpass

Description

If the image referenced by the depth/stencil attachment used in the subpass identified by subpassIndex was not created with IMAGE_CREATE_SAMPLE_LOCATIONS_COMPATIBLE_DEPTH_BIT_EXT or if the subpass does not use a depth/stencil attachment, and PhysicalDeviceSampleLocationsPropertiesEXT::variableSampleLocations is TRUE then the values specified in sampleLocationsInfo are ignored.

Valid Usage (Implicit)

See Also

RenderPassSampleLocationsBeginInfoEXT, SampleLocationsInfoEXT

Constructors

SubpassSampleLocationsEXT

Fields

• subpassIndex :: Word32

  subpassIndex is the index of the subpass for which the sample locations state is provided.

  subpassIndex must be less than the subpassCount specified in RenderPassCreateInfo the render pass specified by RenderPassBeginInfo::renderPass was created with

• sampleLocationsInfo :: SampleLocationsInfoEXT

  sampleLocationsInfo is the sample locations state to use for the layout transition of the depth/stencil attachment away from the image layout the attachment is used with in the subpass specified in subpassIndex.

  sampleLocationsInfo must be a valid SampleLocationsInfoEXT structure

Instances

Show SubpassSampleLocationsEXT

Defined in Vulkan.Extensions.VK_EXT_sample_locations

Methods

showsPrec :: Int -> SubpassSampleLocationsEXT -> ShowS

show :: SubpassSampleLocationsEXT -> String

showList :: [SubpassSampleLocationsEXT] -> ShowS

FromCStruct SubpassSampleLocationsEXT

Defined in Vulkan.Extensions.VK_EXT_sample_locations

Methods

peekCStruct :: Ptr SubpassSampleLocationsEXT -> IO SubpassSampleLocationsEXT

ToCStruct SubpassSampleLocationsEXT

Defined in Vulkan.Extensions.VK_EXT_sample_locations

Methods

withCStruct :: SubpassSampleLocationsEXT -> (Ptr SubpassSampleLocationsEXT -> IO b) -> IO b

pokeCStruct :: Ptr SubpassSampleLocationsEXT -> SubpassSampleLocationsEXT -> IO b -> IO b

withZeroCStruct :: (Ptr SubpassSampleLocationsEXT -> IO b) -> IO b

pokeZeroCStruct :: Ptr SubpassSampleLocationsEXT -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

Zero SubpassSampleLocationsEXT

Defined in Vulkan.Extensions.VK_EXT_sample_locations

Methods

zero :: SubpassSampleLocationsEXT

data RenderPassSampleLocationsBeginInfoEXT

VkRenderPassSampleLocationsBeginInfoEXT - Structure specifying sample locations to use for the layout transition of custom sample locations compatible depth/stencil attachments

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_RENDER_PASS_SAMPLE_LOCATIONS_BEGIN_INFO_EXT

• If attachmentInitialSampleLocationsCount is not 0, pAttachmentInitialSampleLocations must be a valid pointer to an array of attachmentInitialSampleLocationsCount valid AttachmentSampleLocationsEXT structures
• If postSubpassSampleLocationsCount is not 0, pPostSubpassSampleLocations must be a valid pointer to an array of postSubpassSampleLocationsCount valid SubpassSampleLocationsEXT structures

See Also

AttachmentSampleLocationsEXT, StructureType, SubpassSampleLocationsEXT

Constructors

RenderPassSampleLocationsBeginInfoEXT

Fields

• attachmentInitialSampleLocations :: Vector AttachmentSampleLocationsEXT

  pAttachmentInitialSampleLocations is a pointer to an array of attachmentInitialSampleLocationsCount AttachmentSampleLocationsEXT structures specifying the attachment indices and their corresponding sample location state. Each element of pAttachmentInitialSampleLocations can specify the sample location state to use in the automatic layout transition performed to transition a depth/stencil attachment from the initial layout of the attachment to the image layout specified for the attachment in the first subpass using it.

• postSubpassSampleLocations :: Vector SubpassSampleLocationsEXT

  pPostSubpassSampleLocations is a pointer to an array of postSubpassSampleLocationsCount SubpassSampleLocationsEXT structures specifying the subpass indices and their corresponding sample location state. Each element of pPostSubpassSampleLocations can specify the sample location state to use in the automatic layout transition performed to transition the depth/stencil attachment used by the specified subpass to the image layout specified in a dependent subpass or to the final layout of the attachment in case the specified subpass is the last subpass using that attachment. In addition, if PhysicalDeviceSampleLocationsPropertiesEXT::variableSampleLocations is FALSE, each element of pPostSubpassSampleLocations must specify the sample location state that matches the sample locations used by all pipelines that will be bound to a command buffer during the specified subpass. If variableSampleLocations is TRUE, the sample locations used for rasterization do not depend on pPostSubpassSampleLocations.

Instances

Show RenderPassSampleLocationsBeginInfoEXT

Defined in Vulkan.Extensions.VK_EXT_sample_locations

Methods

showsPrec :: Int -> RenderPassSampleLocationsBeginInfoEXT -> ShowS

show :: RenderPassSampleLocationsBeginInfoEXT -> String

showList :: [RenderPassSampleLocationsBeginInfoEXT] -> ShowS

FromCStruct RenderPassSampleLocationsBeginInfoEXT

Defined in Vulkan.Extensions.VK_EXT_sample_locations

Methods

peekCStruct :: Ptr RenderPassSampleLocationsBeginInfoEXT -> IO RenderPassSampleLocationsBeginInfoEXT

ToCStruct RenderPassSampleLocationsBeginInfoEXT

Defined in Vulkan.Extensions.VK_EXT_sample_locations

Methods

withCStruct :: RenderPassSampleLocationsBeginInfoEXT -> (Ptr RenderPassSampleLocationsBeginInfoEXT -> IO b) -> IO b

pokeCStruct :: Ptr RenderPassSampleLocationsBeginInfoEXT -> RenderPassSampleLocationsBeginInfoEXT -> IO b -> IO b

withZeroCStruct :: (Ptr RenderPassSampleLocationsBeginInfoEXT -> IO b) -> IO b

pokeZeroCStruct :: Ptr RenderPassSampleLocationsBeginInfoEXT -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

Zero RenderPassSampleLocationsBeginInfoEXT

Defined in Vulkan.Extensions.VK_EXT_sample_locations

Methods

zero :: RenderPassSampleLocationsBeginInfoEXT

data PipelineSampleLocationsStateCreateInfoEXT

VkPipelineSampleLocationsStateCreateInfoEXT - Structure specifying sample locations for a pipeline

Valid Usage (Implicit)

See Also

Bool32, SampleLocationsInfoEXT, StructureType

Constructors

PipelineSampleLocationsStateCreateInfoEXT

Fields

• sampleLocationsEnable :: Bool

  sampleLocationsEnable controls whether custom sample locations are used. If sampleLocationsEnable is FALSE, the default sample locations are used and the values specified in sampleLocationsInfo are ignored.

• sampleLocationsInfo :: SampleLocationsInfoEXT

  sampleLocationsInfo is the sample locations to use during rasterization if sampleLocationsEnable is TRUE and the graphics pipeline is not created with DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT.

  sampleLocationsInfo must be a valid SampleLocationsInfoEXT structure

Instances

Show PipelineSampleLocationsStateCreateInfoEXT

Defined in Vulkan.Extensions.VK_EXT_sample_locations

Methods

showsPrec :: Int -> PipelineSampleLocationsStateCreateInfoEXT -> ShowS

show :: PipelineSampleLocationsStateCreateInfoEXT -> String

showList :: [PipelineSampleLocationsStateCreateInfoEXT] -> ShowS

FromCStruct PipelineSampleLocationsStateCreateInfoEXT

Defined in Vulkan.Extensions.VK_EXT_sample_locations

Methods

peekCStruct :: Ptr PipelineSampleLocationsStateCreateInfoEXT -> IO PipelineSampleLocationsStateCreateInfoEXT

ToCStruct PipelineSampleLocationsStateCreateInfoEXT

Defined in Vulkan.Extensions.VK_EXT_sample_locations

Methods

withCStruct :: PipelineSampleLocationsStateCreateInfoEXT -> (Ptr PipelineSampleLocationsStateCreateInfoEXT -> IO b) -> IO b

pokeCStruct :: Ptr PipelineSampleLocationsStateCreateInfoEXT -> PipelineSampleLocationsStateCreateInfoEXT -> IO b -> IO b

withZeroCStruct :: (Ptr PipelineSampleLocationsStateCreateInfoEXT -> IO b) -> IO b

pokeZeroCStruct :: Ptr PipelineSampleLocationsStateCreateInfoEXT -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

Zero PipelineSampleLocationsStateCreateInfoEXT

Defined in Vulkan.Extensions.VK_EXT_sample_locations

Methods

zero :: PipelineSampleLocationsStateCreateInfoEXT

data PhysicalDeviceSampleLocationsPropertiesEXT

VkPhysicalDeviceSampleLocationsPropertiesEXT - Structure describing sample location limits that can be supported by an implementation

Description

If the PhysicalDeviceSampleLocationsPropertiesEXT structure is included in the pNext chain of the PhysicalDeviceProperties2 structure passed to getPhysicalDeviceProperties2, it is filled in with each corresponding implementation-dependent property.

Valid Usage (Implicit)

See Also

Bool32, Extent2D, SampleCountFlags, StructureType

Constructors

PhysicalDeviceSampleLocationsPropertiesEXT

Fields

• sampleLocationSampleCounts :: SampleCountFlags

  sampleLocationSampleCounts is a bitmask of SampleCountFlagBits indicating the sample counts supporting custom sample locations.

• maxSampleLocationGridSize :: Extent2D

  maxSampleLocationGridSize is the maximum size of the pixel grid in which sample locations can vary that is supported for all sample counts in sampleLocationSampleCounts.

• sampleLocationCoordinateRange :: (Float, Float)

  sampleLocationCoordinateRange[2] is the range of supported sample location coordinates.

• sampleLocationSubPixelBits :: Word32

  sampleLocationSubPixelBits is the number of bits of subpixel precision for sample locations.

• variableSampleLocations :: Bool

  variableSampleLocations specifies whether the sample locations used by all pipelines that will be bound to a command buffer during a subpass must match. If set to TRUE, the implementation supports variable sample locations in a subpass. If set to FALSE, then the sample locations must stay constant in each subpass.

Instances

Show PhysicalDeviceSampleLocationsPropertiesEXT

Defined in Vulkan.Extensions.VK_EXT_sample_locations

Methods

showsPrec :: Int -> PhysicalDeviceSampleLocationsPropertiesEXT -> ShowS

show :: PhysicalDeviceSampleLocationsPropertiesEXT -> String

showList :: [PhysicalDeviceSampleLocationsPropertiesEXT] -> ShowS

Storable PhysicalDeviceSampleLocationsPropertiesEXT

Defined in Vulkan.Extensions.VK_EXT_sample_locations

Methods

sizeOf :: PhysicalDeviceSampleLocationsPropertiesEXT -> Int

alignment :: PhysicalDeviceSampleLocationsPropertiesEXT -> Int

peekElemOff :: Ptr PhysicalDeviceSampleLocationsPropertiesEXT -> Int -> IO PhysicalDeviceSampleLocationsPropertiesEXT

pokeElemOff :: Ptr PhysicalDeviceSampleLocationsPropertiesEXT -> Int -> PhysicalDeviceSampleLocationsPropertiesEXT -> IO ()

peekByteOff :: Ptr b -> Int -> IO PhysicalDeviceSampleLocationsPropertiesEXT

pokeByteOff :: Ptr b -> Int -> PhysicalDeviceSampleLocationsPropertiesEXT -> IO ()

peek :: Ptr PhysicalDeviceSampleLocationsPropertiesEXT -> IO PhysicalDeviceSampleLocationsPropertiesEXT

poke :: Ptr PhysicalDeviceSampleLocationsPropertiesEXT -> PhysicalDeviceSampleLocationsPropertiesEXT -> IO ()

FromCStruct PhysicalDeviceSampleLocationsPropertiesEXT

Defined in Vulkan.Extensions.VK_EXT_sample_locations

Methods

peekCStruct :: Ptr PhysicalDeviceSampleLocationsPropertiesEXT -> IO PhysicalDeviceSampleLocationsPropertiesEXT

ToCStruct PhysicalDeviceSampleLocationsPropertiesEXT

Defined in Vulkan.Extensions.VK_EXT_sample_locations

Methods

withCStruct :: PhysicalDeviceSampleLocationsPropertiesEXT -> (Ptr PhysicalDeviceSampleLocationsPropertiesEXT -> IO b) -> IO b

pokeCStruct :: Ptr PhysicalDeviceSampleLocationsPropertiesEXT -> PhysicalDeviceSampleLocationsPropertiesEXT -> IO b -> IO b

withZeroCStruct :: (Ptr PhysicalDeviceSampleLocationsPropertiesEXT -> IO b) -> IO b

pokeZeroCStruct :: Ptr PhysicalDeviceSampleLocationsPropertiesEXT -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

Zero PhysicalDeviceSampleLocationsPropertiesEXT

Defined in Vulkan.Extensions.VK_EXT_sample_locations

Methods

zero :: PhysicalDeviceSampleLocationsPropertiesEXT

data MultisamplePropertiesEXT

VkMultisamplePropertiesEXT - Structure returning information about sample count specific additional multisampling capabilities

Valid Usage (Implicit)

See Also

Extent2D, StructureType, getPhysicalDeviceMultisamplePropertiesEXT

Constructors

MultisamplePropertiesEXT

Fields

• maxSampleLocationGridSize :: Extent2D

  maxSampleLocationGridSize is the maximum size of the pixel grid in which sample locations can vary.

Instances

Show MultisamplePropertiesEXT

Defined in Vulkan.Extensions.VK_EXT_sample_locations

Methods

showsPrec :: Int -> MultisamplePropertiesEXT -> ShowS

show :: MultisamplePropertiesEXT -> String

showList :: [MultisamplePropertiesEXT] -> ShowS

Storable MultisamplePropertiesEXT

Defined in Vulkan.Extensions.VK_EXT_sample_locations

Methods

sizeOf :: MultisamplePropertiesEXT -> Int

alignment :: MultisamplePropertiesEXT -> Int

peekElemOff :: Ptr MultisamplePropertiesEXT -> Int -> IO MultisamplePropertiesEXT

pokeElemOff :: Ptr MultisamplePropertiesEXT -> Int -> MultisamplePropertiesEXT -> IO ()

peekByteOff :: Ptr b -> Int -> IO MultisamplePropertiesEXT

pokeByteOff :: Ptr b -> Int -> MultisamplePropertiesEXT -> IO ()

peek :: Ptr MultisamplePropertiesEXT -> IO MultisamplePropertiesEXT

poke :: Ptr MultisamplePropertiesEXT -> MultisamplePropertiesEXT -> IO ()

FromCStruct MultisamplePropertiesEXT

Defined in Vulkan.Extensions.VK_EXT_sample_locations

Methods

peekCStruct :: Ptr MultisamplePropertiesEXT -> IO MultisamplePropertiesEXT

ToCStruct MultisamplePropertiesEXT

Defined in Vulkan.Extensions.VK_EXT_sample_locations

Methods

withCStruct :: MultisamplePropertiesEXT -> (Ptr MultisamplePropertiesEXT -> IO b) -> IO b

pokeCStruct :: Ptr MultisamplePropertiesEXT -> MultisamplePropertiesEXT -> IO b -> IO b

withZeroCStruct :: (Ptr MultisamplePropertiesEXT -> IO b) -> IO b

pokeZeroCStruct :: Ptr MultisamplePropertiesEXT -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

Zero MultisamplePropertiesEXT

Defined in Vulkan.Extensions.VK_EXT_sample_locations

Methods

zero :: MultisamplePropertiesEXT

type EXT_SAMPLE_LOCATIONS_SPEC_VERSION = 1

pattern EXT_SAMPLE_LOCATIONS_SPEC_VERSION :: forall a. Integral a => a

type EXT_SAMPLE_LOCATIONS_EXTENSION_NAME = "VK_EXT_sample_locations"

pattern EXT_SAMPLE_LOCATIONS_EXTENSION_NAME :: forall a. (Eq a, IsString a) => a