VkSamplerYcbcrConversionInfo(3)

# VkSamplerYcbcrConversionInfo(3) Manual Page

## Name

VkSamplerYcbcrConversionInfo - Structure specifying Y′CBCR conversion to a sampler or image view

## C Specification

To create a sampler with Y′CBCR conversion enabled, add a VkSamplerYcbcrConversionInfo structure to the `pNext` chain of the VkSamplerCreateInfo structure. To create a sampler Y′CBCR conversion, the `samplerYcbcrConversion` feature must be enabled. Conversion must be fixed at pipeline creation time, through use of a combined embedded sampler and image mapping if using descriptor heaps, or a combined image sampler with an immutable sampler in `VkDescriptorSetLayoutBinding`.

A VkSamplerYcbcrConversionInfo must be provided for samplers to be used with image views that access VK_IMAGE_ASPECT_COLOR_BIT if the format is one of the formats that require a sampler Y′CBCR conversion , or if the image view has an external format .

The `VkSamplerYcbcrConversionInfo` structure is defined as:

    // Provided by VK_VERSION_1_1
    typedef struct VkSamplerYcbcrConversionInfo {
        VkStructureType             sType;
        const void*                 pNext;
        VkSamplerYcbcrConversion    conversion;
    } VkSamplerYcbcrConversionInfo;

    // Provided by VK_KHR_sampler_ycbcr_conversion
    // Equivalent to VkSamplerYcbcrConversionInfo
    typedef VkSamplerYcbcrConversionInfo VkSamplerYcbcrConversionInfoKHR;

## Members

- `sType` is a VkStructureType value identifying this structure.

- `pNext` is `NULL` or a pointer to a structure extending this structure.

- `conversion` is a VkSamplerYcbcrConversion handle created with vkCreateSamplerYcbcrConversion.

## Description

Valid Usage (Implicit)

- VUID-VkSamplerYcbcrConversionInfo-sType-sType
  `sType` must be VK_STRUCTURE_TYPE_SAMPLER_YCBCR_CONVERSION_INFO

- VUID-VkSamplerYcbcrConversionInfo-conversion-parameter
  `conversion` must be a valid VkSamplerYcbcrConversion handle

Structure Chaining

Extends the structures

  - VkImageViewCreateInfo

  - VkSamplerCreateInfo

## See Also

VK_KHR_sampler_ycbcr_conversion, VK_VERSION_1_1, VkSamplerYcbcrConversion, VkStructureType

## Document Notes

For more information, see the Vulkan Specification.

This page is extracted from the Vulkan Specification. Fixes and changes should be made to the Specification, not directly.

## Copyright

Copyright 2014-2026 The Khronos Group Inc.

SPDX-License-Identifier: CC-BY-4.0