status-im/Vulkan-Docs
2
0
Fork 0
mirror of https://github.com/status-im/Vulkan-Docs.git synced 2025-02-25 12:35:11 +00:00
Code Issues Projects Releases Wiki Activity
Vulkan-Docs/appendices/VK_KHR_sampler_ycbcr_conversion.txt
Jon Leech 59750fe4c7 Change log for August 25, 2019 Vulkan 1.1.121 spec update: 
* Update release number to 121.

Github Issues:

  * Add missing `structextends` attribute in `vk.xml` for
    slink:VkPhysicalDevicePipelineExecutablePropertiesFeaturesKHR (public
    issue 1018).
  * Change attributes of flink:vkCmdCopyAccelerationStructureNV,
    flink:vkCmdWriteAccelerationStructuresPropertiesNV,
    flink:vkCmdBuildAccelerationStructureNV, and flink:vkCmdTraceRaysNV to
    require that these commands execute outside renderpasses (public issue
    1021).
  * Add an issue to the `<<VK_EXT_buffer_device_address>>` appendix
    discussing the introduction of new names and aliasing by equivalent old
    names (public pull request 1024).

Internal Issues:

  * Protect the `VK_KHR_sampler_mirror_clamp_to_edge` extension with
    asciidoctor conditionals, and remove it from the core-only specification
    builds, where it had previously been force-included in the Makefile. It
    is now treated like any other extension (internal issue 1776).
  * Edit some asciidoctor anchor names starting with `features-features-` to
    just start with `features-`, since the old chapters was split into 3
    pieces. There are still some mild naming inconsistencies with anchors
    which may be addressed in the future (internal issue 1792).
  * Add `KHR` alias for the non-suffixed extension token
    ename:VK_SAMPLER_ADDRESS_MODE_MIRROR_CLAMP_TO_EDGE, for compatibility
    with naming rules for extensions (internal issue 1796).
  * Clarify requirements for external memory in NOTEs for
    sname:VkExternalMemoryBufferCreateInfo, and valid usage statements for
    flink:vkBindBufferMemory, slink:VkBindBufferMemoryInfo,
    flink:vkBindImageMemory, and slink:VkBindImageMemoryInfo (internal merge
    request 3301).
  * Make extension version numbers in `vk.xml` and extension appendices
    consistent. In a few cases, we could not recover history at this
    granularity, and left the summary of a version's change undefined
    (internal merge request 3323).
  * Fix invocation of `CodeInlineMacro` in the Ruby extension backing the
    `code:` macro, which was delegating to the wrong base class (internal
    merge request 3331).
  * Modify `reg.py` to do a better job of recognizing equivalent <enum>
    definitions.
  * Add a `sortorder` attribute to XML feature and extension tags.

New Extensions

  * `<<VK_AMD_device_coherent_memory>>`
2019-08-25 03:57:09 -07:00

157 lines
6.4 KiB
Plaintext
Raw Blame History

// Copyright (c) 2017-2019 Khronos Group. This work is licensed under a
// Creative Commons Attribution 4.0 International License; see
// http://creativecommons.org/licenses/by/4.0/
include::meta/VK_KHR_sampler_ycbcr_conversion.txt[]
*Last Modified Date*::
2017-08-11
*IP Status*::
No known IP claims.
*Interactions and External Dependencies*::
- Promoted to Vulkan 1.1 Core
- This extension interacts with `<<VK_EXT_debug_report>>`
*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
This extension provides the ability to perform specified color space
conversions during texture sampling operations.
It also adds a selection of multi-planar formats, including the ability to
bind memory to the planes of an image collectively or separately.
=== New Enum Constants
* Extending elink:VkStructureType:
** ename:VK_STRUCTURE_TYPE_SAMPLER_YCBCR_CONVERSION_CREATE_INFO_KHR
** ename:VK_STRUCTURE_TYPE_SAMPLER_YCBCR_CONVERSION_INFO_KHR
** ename:VK_STRUCTURE_TYPE_BIND_IMAGE_PLANE_MEMORY_INFO_KHR
** ename:VK_STRUCTURE_TYPE_IMAGE_PLANE_MEMORY_REQUIREMENTS_INFO_KHR
** ename:VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SAMPLER_YCBCR_CONVERSION_FEATURES_KHR
* Extending elink:VkFormat:
** ename:VK_FORMAT_G8B8G8R8_422_UNORM_KHR
** ename:VK_FORMAT_B8G8R8G8_422_UNORM_KHR
** ename:VK_FORMAT_G8_B8_R8_3PLANE_420_UNORM_KHR
** ename:VK_FORMAT_G8_B8R8_2PLANE_420_UNORM_KHR
** ename:VK_FORMAT_G8_B8_R8_3PLANE_422_UNORM_KHR
** ename:VK_FORMAT_G8_B8R8_2PLANE_422_UNORM_KHR
** ename:VK_FORMAT_G8_B8_R8_3PLANE_444_UNORM_KHR
** ename:VK_FORMAT_R10X6_UNORM_PACK16_KHR
** ename:VK_FORMAT_R10X6G10X6_UNORM_2PACK16_KHR
** ename:VK_FORMAT_R10X6G10X6B10X6A10X6_UNORM_4PACK16_KHR
** ename:VK_FORMAT_G10X6B10X6G10X6R10X6_422_UNORM_4PACK16_KHR
** ename:VK_FORMAT_B10X6G10X6R10X6G10X6_422_UNORM_4PACK16_KHR
** ename:VK_FORMAT_G10X6_B10X6_R10X6_3PLANE_420_UNORM_3PACK16_KHR
** ename:VK_FORMAT_G10X6_B10X6R10X6_2PLANE_420_UNORM_3PACK16_KHR
** ename:VK_FORMAT_G10X6_B10X6_R10X6_3PLANE_422_UNORM_3PACK16_KHR
** ename:VK_FORMAT_G10X6_B10X6R10X6_2PLANE_422_UNORM_3PACK16_KHR
** ename:VK_FORMAT_G10X6_B10X6_R10X6_3PLANE_444_UNORM_3PACK16_KHR
** ename:VK_FORMAT_R12X4_UNORM_PACK16_KHR
** ename:VK_FORMAT_R12X4G12X4_UNORM_2PACK16_KHR
** ename:VK_FORMAT_R12X4G12X4B12X4A12X4_UNORM_4PACK16_KHR
** ename:VK_FORMAT_G12X4B12X4G12X4R12X4_422_UNORM_4PACK16_KHR
** ename:VK_FORMAT_B12X4G12X4R12X4G12X4_422_UNORM_4PACK16_KHR
** ename:VK_FORMAT_G12X4_B12X4_R12X4_3PLANE_420_UNORM_3PACK16_KHR
** ename:VK_FORMAT_G12X4_B12X4R12X4_2PLANE_420_UNORM_3PACK16_KHR
** ename:VK_FORMAT_G12X4_B12X4_R12X4_3PLANE_422_UNORM_3PACK16_KHR
** ename:VK_FORMAT_G12X4_B12X4R12X4_2PLANE_422_UNORM_3PACK16_KHR
** ename:VK_FORMAT_G12X4_B12X4_R12X4_3PLANE_444_UNORM_3PACK16_KHR
** ename:VK_FORMAT_G16B16G16R16_422_UNORM_KHR
** ename:VK_FORMAT_B16G16R16G16_422_UNORM_KHR
** ename:VK_FORMAT_G16_B16_R16_3PLANE_420_UNORM_KHR
** ename:VK_FORMAT_G16_B16R16_2PLANE_420_UNORM_KHR
** ename:VK_FORMAT_G16_B16_R16_3PLANE_422_UNORM_KHR
** ename:VK_FORMAT_G16_B16R16_2PLANE_422_UNORM_KHR
** ename:VK_FORMAT_G16_B16_R16_3PLANE_444_UNORM_KHR
* Extending elink:VkImageAspectFlagBits:
** ename:VK_IMAGE_ASPECT_PLANE_0_BIT_KHR
** ename:VK_IMAGE_ASPECT_PLANE_1_BIT_KHR
** ename:VK_IMAGE_ASPECT_PLANE_2_BIT_KHR
* Extending elink:VkImageCreateFlagBits:
** ename:VK_IMAGE_CREATE_DISJOINT_BIT_KHR
* Extending elink:VkFormatFeatureFlagBits:
** ename:VK_FORMAT_FEATURE_MIDPOINT_CHROMA_SAMPLES_BIT_KHR
** ename:VK_FORMAT_FEATURE_COSITED_CHROMA_SAMPLES_BIT_KHR
** ename:VK_FORMAT_FEATURE_SAMPLED_IMAGE_YCBCR_CONVERSION_LINEAR_FILTER_BIT_KHR
** ename:VK_FORMAT_FEATURE_SAMPLED_IMAGE_YCBCR_CONVERSION_SEPARATE_RECONSTRUCTION_FILTER_BIT_KHR
** ename:VK_FORMAT_FEATURE_SAMPLED_IMAGE_YCBCR_CONVERSION_CHROMA_RECONSTRUCTION_EXPLICIT_BIT_KHR
** ename:VK_FORMAT_FEATURE_SAMPLED_IMAGE_YCBCR_CONVERSION_CHROMA_RECONSTRUCTION_EXPLICIT_FORCEABLE_BIT_KHR
** ename:VK_FORMAT_FEATURE_DISJOINT_BIT_KHR
=== New Enums
* elink:VkSamplerYcbcrModelConversionKHR
* elink:VkSamplerYcbcrRangeKHR
* elink:VkChromaLocationKHR
=== New Structures
* slink:VkSamplerYcbcrConversionInfoKHR
* slink:VkSamplerYcbcrConversionCreateInfoKHR
* slink:VkBindImagePlaneMemoryInfoKHR
* slink:VkImagePlaneMemoryRequirementsInfoKHR
* slink:VkPhysicalDeviceSamplerYcbcrConversionFeaturesKHR
* slink:VkSamplerYcbcrConversionImageFormatPropertiesKHR
=== New Functions
* flink:vkCreateSamplerYcbcrConversionKHR
* flink:vkDestroySamplerYcbcrConversionKHR
=== New Objects
* slink:VkSamplerYcbcrConversionKHR
=== Promotion to Vulkan 1.1
All functionality in this extension is included in core Vulkan 1.1, with the
KHR suffix omitted.
The original type, enum and command names are still available as aliases of
the core functionality.
=== 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-4-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
Reference in New Issue View Git Blame Copy Permalink