Vulkan.Extensions.VK_EXT_image_robustness

Name

VK_EXT_image_robustness - device extension

VK_EXT_image_robustness

Name String

VK_EXT_image_robustness

Extension Type

Device extension

Registered Extension Number

336

Revision

1

Extension and Version Dependencies

• Requires Vulkan 1.0
• Requires VK_KHR_get_physical_device_properties2

Contact

• Graeme Leese @gnl21%0A<<Here describe the issue or question you have about the VK_EXT_image_robustness extension> >

Other Extension Metadata

Last Modified Date

2020-04-27

IP Status

No known IP claims.

Contributors

• Graeme Leese, Broadcom
• Jan-Harald Fredriksen, ARM
• Jeff Bolz, NVIDIA
• Spencer Fricke, Samsung
• Courtney Goeltzenleuchter, Google
• Slawomir Cygan, Intel

Description

This extension adds stricter requirements for how out of bounds reads from images are handled. Rather than returning undefined values, most out of bounds reads return R, G, and B values of zero and alpha values of either zero or one. Components not present in the image format may be set to zero or to values based on the format as described in Conversion to RGBA.

New Structures

• Extending PhysicalDeviceFeatures2, DeviceCreateInfo:

  • PhysicalDeviceImageRobustnessFeaturesEXT

New Enum Constants

• EXT_IMAGE_ROBUSTNESS_EXTENSION_NAME

• EXT_IMAGE_ROBUSTNESS_SPEC_VERSION

• Extending StructureType:

  • STRUCTURE_TYPE_PHYSICAL_DEVICE_IMAGE_ROBUSTNESS_FEATURES_EXT

Issues

1. How does this extension differ from VK_EXT_robustness2?

The guarantees provided by this extension are a subset of those provided by the robustImageAccess2 feature of VK_EXT_robustness2. Where this extension allows return values of (0, 0, 0, 0) or (0, 0, 0, 1), robustImageAccess2 requires that a particular value dependent on the image format be returned. This extension provides no guarantees about the values returned for an access to an invalid Lod.

Examples

None.

Version History

• Revision 1, 2020-04-27 (Graeme Leese)

  • Initial draft

See Also

PhysicalDeviceImageRobustnessFeaturesEXT

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

data PhysicalDeviceImageRobustnessFeaturesEXT

VkPhysicalDeviceImageRobustnessFeaturesEXT - Structure describing the out-of-bounds behavior for an implementation

Members

This structure describes the following feature:

Description

If the PhysicalDeviceImageRobustnessFeaturesEXT structure is included in the pNext chain of the PhysicalDeviceFeatures2 structure passed to getPhysicalDeviceFeatures2, it is filled in to indicate whether each corresponding feature is supported. PhysicalDeviceImageRobustnessFeaturesEXT can also be used in the pNext chain of DeviceCreateInfo to selectively enable these features.

Valid Usage (Implicit)

See Also

VK_EXT_image_robustness, Bool32, StructureType

Constructors

PhysicalDeviceImageRobustnessFeaturesEXT

Fields

• robustImageAccess :: Bool

  robustImageAccess indicates whether image accesses are tightly bounds-checked against the dimensions of the image view. Invalid texels resulting from out of bounds image loads will be replaced as described in Texel Replacement, with either (0,0,1) or (0,0,0) values inserted for missing G, B, or A components based on the format.

Instances

Eq PhysicalDeviceImageRobustnessFeaturesEXT

Defined in Vulkan.Extensions.VK_EXT_image_robustness

Methods

(==) :: PhysicalDeviceImageRobustnessFeaturesEXT -> PhysicalDeviceImageRobustnessFeaturesEXT -> Bool

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

Show PhysicalDeviceImageRobustnessFeaturesEXT

Defined in Vulkan.Extensions.VK_EXT_image_robustness

Methods

showsPrec :: Int -> PhysicalDeviceImageRobustnessFeaturesEXT -> ShowS

show :: PhysicalDeviceImageRobustnessFeaturesEXT -> String

showList :: [PhysicalDeviceImageRobustnessFeaturesEXT] -> ShowS

Storable PhysicalDeviceImageRobustnessFeaturesEXT

Defined in Vulkan.Extensions.VK_EXT_image_robustness

Methods

sizeOf :: PhysicalDeviceImageRobustnessFeaturesEXT -> Int

alignment :: PhysicalDeviceImageRobustnessFeaturesEXT -> Int

peekElemOff :: Ptr PhysicalDeviceImageRobustnessFeaturesEXT -> Int -> IO PhysicalDeviceImageRobustnessFeaturesEXT

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

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

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

peek :: Ptr PhysicalDeviceImageRobustnessFeaturesEXT -> IO PhysicalDeviceImageRobustnessFeaturesEXT

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

FromCStruct PhysicalDeviceImageRobustnessFeaturesEXT

Defined in Vulkan.Extensions.VK_EXT_image_robustness

Methods

peekCStruct :: Ptr PhysicalDeviceImageRobustnessFeaturesEXT -> IO PhysicalDeviceImageRobustnessFeaturesEXT

ToCStruct PhysicalDeviceImageRobustnessFeaturesEXT

Defined in Vulkan.Extensions.VK_EXT_image_robustness

Methods

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

pokeCStruct :: Ptr PhysicalDeviceImageRobustnessFeaturesEXT -> PhysicalDeviceImageRobustnessFeaturesEXT -> IO b -> IO b

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

pokeZeroCStruct :: Ptr PhysicalDeviceImageRobustnessFeaturesEXT -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

Zero PhysicalDeviceImageRobustnessFeaturesEXT

Defined in Vulkan.Extensions.VK_EXT_image_robustness

Methods

zero :: PhysicalDeviceImageRobustnessFeaturesEXT

type EXT_IMAGE_ROBUSTNESS_SPEC_VERSION = 1

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

type EXT_IMAGE_ROBUSTNESS_EXTENSION_NAME = "VK_EXT_image_robustness"

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