Vulkan.Extensions.VK_EXT_legacy_dithering

Name

VK_EXT_legacy_dithering - device extension

VK_EXT_legacy_dithering

Name String

VK_EXT_legacy_dithering

Extension Type

Device extension

Registered Extension Number

466

Revision

1

Extension and Version Dependencies

• Requires support for Vulkan 1.0
• Requires VK_KHR_get_physical_device_properties2 to be enabled for any device-level functionality

Special Use

• OpenGL / ES support

Contact

• Shahbaz Youssefi @syoussefi%0A*Here describe the issue or question you have about the VK_EXT_legacy_dithering extension*

Extension Proposal

VK_EXT_legacy_dithering

Other Extension Metadata

Last Modified Date

2022-03-31

Contributors

• Shahbaz Youssefi, Google
• Graeme Leese, Broadcom
• Jan-Harald Fredriksen, Arm

Description

This extension exposes a hardware feature used by some vendors to implement OpenGL’s dithering. The purpose of this extension is to support layering OpenGL over Vulkan, by allowing the layer to take advantage of the same hardware feature and provide equivalent dithering to OpenGL applications.

New Structures

• Extending PhysicalDeviceFeatures2, DeviceCreateInfo:

  • PhysicalDeviceLegacyDitheringFeaturesEXT

New Enum Constants

• EXT_LEGACY_DITHERING_EXTENSION_NAME

• EXT_LEGACY_DITHERING_SPEC_VERSION

• Extending StructureType:

  • STRUCTURE_TYPE_PHYSICAL_DEVICE_LEGACY_DITHERING_FEATURES_EXT

• Extending SubpassDescriptionFlagBits:

  • SUBPASS_DESCRIPTION_ENABLE_LEGACY_DITHERING_BIT_EXT

If VK_KHR_dynamic_rendering is supported:

• Extending RenderingFlagBits:

  • RENDERING_ENABLE_LEGACY_DITHERING_BIT_EXT

If Version 1.3 is supported:

• Extending RenderingFlagBits:

  • RENDERING_ENABLE_LEGACY_DITHERING_BIT_EXT

Version History

• Revision 1, 2022-03-31 (Shahbaz Youssefi)

  • Internal revisions

Issues

1) In OpenGL, the dither state can change dynamically. Should this extension add a pipeline state for dither?

RESOLVED: No. Changing dither state is rarely, if ever, done during rendering. Every surveyed Android application either entirely disables dither, explicitly enables it, or uses the default state (which is enabled). Additionally, on some hardware dither can only be specified in a render pass granularity, so a change in dither state would necessarily need to cause a render pass break. This extension considers dynamic changes in OpenGL dither state a theoretical situation, and expects the layer to break the render pass in such a situation without any practical downsides.

See Also

PhysicalDeviceLegacyDitheringFeaturesEXT

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 PhysicalDeviceLegacyDitheringFeaturesEXT

VkPhysicalDeviceLegacyDitheringFeaturesEXT - Structure describing support for legacy dithering

Members

This structure describes the following feature:

Description

If the PhysicalDeviceLegacyDitheringFeaturesEXT 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. PhysicalDeviceLegacyDitheringFeaturesEXT can also be used in the pNext chain of DeviceCreateInfo to selectively enable these features.

Valid Usage (Implicit)

See Also

VK_EXT_legacy_dithering, Bool32, StructureType

Constructors

PhysicalDeviceLegacyDitheringFeaturesEXT

Fields

• legacyDithering :: Bool

  legacyDithering indicates whether the implementation supports Legacy Dithering.

Instances

Storable PhysicalDeviceLegacyDitheringFeaturesEXT

Defined in Vulkan.Extensions.VK_EXT_legacy_dithering

Methods

sizeOf :: PhysicalDeviceLegacyDitheringFeaturesEXT -> Int

alignment :: PhysicalDeviceLegacyDitheringFeaturesEXT -> Int

peekElemOff :: Ptr PhysicalDeviceLegacyDitheringFeaturesEXT -> Int -> IO PhysicalDeviceLegacyDitheringFeaturesEXT

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

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

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

peek :: Ptr PhysicalDeviceLegacyDitheringFeaturesEXT -> IO PhysicalDeviceLegacyDitheringFeaturesEXT

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

Show PhysicalDeviceLegacyDitheringFeaturesEXT

Defined in Vulkan.Extensions.VK_EXT_legacy_dithering

Methods

showsPrec :: Int -> PhysicalDeviceLegacyDitheringFeaturesEXT -> ShowS

show :: PhysicalDeviceLegacyDitheringFeaturesEXT -> String

showList :: [PhysicalDeviceLegacyDitheringFeaturesEXT] -> ShowS

Eq PhysicalDeviceLegacyDitheringFeaturesEXT

Defined in Vulkan.Extensions.VK_EXT_legacy_dithering

Methods

(==) :: PhysicalDeviceLegacyDitheringFeaturesEXT -> PhysicalDeviceLegacyDitheringFeaturesEXT -> Bool

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

FromCStruct PhysicalDeviceLegacyDitheringFeaturesEXT

Defined in Vulkan.Extensions.VK_EXT_legacy_dithering

Methods

peekCStruct :: Ptr PhysicalDeviceLegacyDitheringFeaturesEXT -> IO PhysicalDeviceLegacyDitheringFeaturesEXT

ToCStruct PhysicalDeviceLegacyDitheringFeaturesEXT

Defined in Vulkan.Extensions.VK_EXT_legacy_dithering

Methods

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

pokeCStruct :: Ptr PhysicalDeviceLegacyDitheringFeaturesEXT -> PhysicalDeviceLegacyDitheringFeaturesEXT -> IO b -> IO b

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

pokeZeroCStruct :: Ptr PhysicalDeviceLegacyDitheringFeaturesEXT -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

Zero PhysicalDeviceLegacyDitheringFeaturesEXT

Defined in Vulkan.Extensions.VK_EXT_legacy_dithering

Methods

zero :: PhysicalDeviceLegacyDitheringFeaturesEXT

type EXT_LEGACY_DITHERING_SPEC_VERSION = 1

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

type EXT_LEGACY_DITHERING_EXTENSION_NAME = "VK_EXT_legacy_dithering"

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