Modulevulkan-3.27GHC2021
Vulkan.Extensions.VK_KHR_sampler_ycbcr_conversion
Name
VK_KHR_sampler_ycbcr_conversion - device extension
VK_KHR_sampler_ycbcr_conversion
- Name String
VK_KHR_sampler_ycbcr_conversion
- Extension Type
Device extension
- Registered Extension Number
157
- Revision
14
- Ratification Status
Ratified
- Extension and Version Dependencies
VK_KHR_get_memory_requirements2 and
VK_KHR_get_physical_device_properties2 or Vulkan Version 1.1
- API Interactions
Interacts with VK_EXT_debug_report
- Deprecation State
Promoted to Vulkan 1.1
- Contact
Other Extension Metadata
- Last Modified Date
2017-08-11
- IP Status
No known IP claims.
- Contributors
Andrew Garrard, Samsung Electronics
Tobias Hector, Imagination Technologies
James Jones, NVIDIA
Daniel Koch, NVIDIA
Daniel Rakos, AMD
Romain Guy, Google
Jesse Hall, Google
Tom Cooksey, ARM Ltd
Jeff Leger, Qualcomm Technologies, Inc
Jan-Harald Fredriksen, ARM Ltd
Jan Outters, Samsung Electronics
Alon Or-bach, Samsung Electronics
Michael Worcester, Imagination Technologies
Jeff Bolz, NVIDIA
Tony Zlatinski, NVIDIA
Matthew Netsch, Qualcomm Technologies, Inc
Description
The use of Y′CBCR sampler conversion is an area in 3D graphics not used by most Vulkan developers. It is mainly used for processing inputs from video decoders and cameras. The use of the extension assumes basic knowledge of Y′CBCR concepts.
This extension provides the ability to perform specified color space conversions during texture sampling operations for the Y′CBCR color space natively. It also adds a selection of multi-planar formats, image aspect plane, and the ability to bind memory to the planes of an image collectively or separately.
Promotion to Vulkan 1.1
All functionality in this extension is included in core Vulkan 1.1, with
the KHR suffix omitted. However, if Vulkan 1.1 is supported and this
extension is not, the samplerYcbcrConversion capability is optional.
The original type, enum, and command names are still available as
aliases of the core functionality.
Promotion to Vulkan 1.4
If Vulkan 1.4 is supported, support for the samplerYcbcrConversion
capability is required.
New Object Types
New Commands
New Structures
Extending BindImageMemoryInfo:
Extending ImageFormatProperties2:
Extending ImageMemoryRequirementsInfo2:
Extending PhysicalDeviceFeatures2, DeviceCreateInfo:
Extending SamplerCreateInfo, ImageViewCreateInfo:
New Enums
New Enum Constants
Extending ChromaLocation:
Extending Format:
Extending FormatFeatureFlagBits:
FORMAT_FEATURE_SAMPLED_IMAGE_YCBCR_CONVERSION_CHROMA_RECONSTRUCTION_EXPLICIT_BIT_KHR
FORMAT_FEATURE_SAMPLED_IMAGE_YCBCR_CONVERSION_CHROMA_RECONSTRUCTION_EXPLICIT_FORCEABLE_BIT_KHR
FORMAT_FEATURE_SAMPLED_IMAGE_YCBCR_CONVERSION_LINEAR_FILTER_BIT_KHR
FORMAT_FEATURE_SAMPLED_IMAGE_YCBCR_CONVERSION_SEPARATE_RECONSTRUCTION_FILTER_BIT_KHR
Extending ImageAspectFlagBits:
Extending ImageCreateFlagBits:
Extending ObjectType:
Extending SamplerYcbcrModelConversion:
Extending SamplerYcbcrRange:
Extending StructureType:
If VK_EXT_debug_report is supported:
Extending DebugReportObjectTypeEXT:
Version History
Revision 1, 2017-01-24 (Andrew Garrard)
Initial draft
Revision 2, 2017-01-25 (Andrew Garrard)
After initial feedback
Revision 3, 2017-01-27 (Andrew Garrard)
Higher bit depth formats, renaming, swizzle
Revision 4, 2017-02-22 (Andrew Garrard)
Added query function, formats as RGB, clarifications
Revision 5, 2017-04-?? (Andrew Garrard)
Simplified query and removed output conversions
Revision 6, 2017-04-24 (Andrew Garrard)
Tidying, incorporated new image query, restored transfer functions
Revision 7, 2017-04-25 (Andrew Garrard)
Added cosited option/midpoint requirement for formats, “bypassConversion”
Revision 8, 2017-04-25 (Andrew Garrard)
Simplified further
Revision 9, 2017-04-27 (Andrew Garrard)
Disjoint no more
Revision 10, 2017-04-28 (Andrew Garrard)
Restored disjoint
Revision 11, 2017-04-29 (Andrew Garrard)
Now Ycbcr conversion, and KHR
Revision 12, 2017-06-06 (Andrew Garrard)
Added conversion to image view creation
Revision 13, 2017-07-13 (Andrew Garrard)
Allowed cosited-only chroma samples for formats
Revision 14, 2017-08-11 (Andrew Garrard)
Reflected quantization changes in BT.2100-1
See Also
No cross-references are available
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.
- 13 types
- 2 values
- Packagevulkan-3.27
- Exports120
- LanguageGHC2021
- LicenceBSD-3-Clause
- SourceVK_KHR_sampler_ycbcr_conversion.hs
VkDebugReportObjectTypeEXT - Specify the type of an object handle
Description
'
Vulkan Handle Type | |
|---|---|
Unknown/Undefined Handle | |
DebugReportObjectTypeEXT and Vulkan Handle Relationship
The primary expected use of ERROR_VALIDATION_FAILED_EXT is for validation layer testing to prevent invalid commands from reaching the ICD. It is not expected that an application would see this error code during normal use of the validation layers. If an application returns TRUE in DebugUtilsMessengerCallbackDataEXT, the validation layers will return this error code instead of passing the command down the dispatch chain.
See Also
PFN_vkDebugReportCallbackEXT, VK_EXT_debug_marker, VK_EXT_debug_report, DebugMarkerObjectNameInfoEXT, DebugMarkerObjectTagInfoEXT, debugReportMessageEXT
Constructors
Instances6Eq, Ord, Read, Show, Storable, Zero
Eq DebugReportObjectTypeEXTDefined in vulkan-3.27 · Vulkan.Extensions.VK_EXT_debug_reportOrd DebugReportObjectTypeEXTDefined in vulkan-3.27 · Vulkan.Extensions.VK_EXT_debug_reportRead DebugReportObjectTypeEXTDefined in vulkan-3.27 · Vulkan.Extensions.VK_EXT_debug_reportShow DebugReportObjectTypeEXTDefined in vulkan-3.27 · Vulkan.Extensions.VK_EXT_debug_reportStorable DebugReportObjectTypeEXTDefined in vulkan-3.27 · Vulkan.Extensions.VK_EXT_debug_reportZero DebugReportObjectTypeEXTDefined in vulkan-3.27 · Vulkan.Extensions.VK_EXT_debug_report