Structure specifying the parameters of the newly created conversion.

Description

If the pNext chain includes a VkExternalFormatANDROID structure with non-zero externalFormat member, the sampler Y′C_BC_R conversion object represents an external format conversion, and format must be FORMAT_UNDEFINED. Such conversions must only be used to sample image views with a matching external format. When creating an external format conversion, the value of components is ignored.

Valid Usage

• If an external format conversion is being created, format must be FORMAT_UNDEFINED
• If an external format conversion is not being created, format must represent unsigned normalized values (i.e. the format must be a UNORM format)
• The potential format features of the sampler Y′C_BC_R conversion must support FORMAT_FEATURE_MIDPOINT_CHROMA_SAMPLES_BIT or FORMAT_FEATURE_COSITED_CHROMA_SAMPLES_BIT
• If the potential format features of the sampler Y′C_BC_R conversion do not support FORMAT_FEATURE_COSITED_CHROMA_SAMPLES_BIT, xChromaOffset and yChromaOffset must not be CHROMA_LOCATION_COSITED_EVEN if the corresponding components are downsampled
• If the potential format features of the sampler Y′C_BC_R conversion do not support FORMAT_FEATURE_MIDPOINT_CHROMA_SAMPLES_BIT, xChromaOffset and yChromaOffset must not be CHROMA_LOCATION_MIDPOINT if the corresponding components are downsampled
• If the format has a _422 or _420 suffix, then components.g must be the identity swizzle
• If the format has a _422 or _420 suffix, then components.a must be the identity swizzle, COMPONENT_SWIZZLE_ONE, or COMPONENT_SWIZZLE_ZERO
• If the format has a _422 or _420 suffix, then components.r must be the identity swizzle or COMPONENT_SWIZZLE_B
• If the format has a _422 or _420 suffix, then components.b must be the identity swizzle or COMPONENT_SWIZZLE_R
• If the format has a _422 or _420 suffix, and if either components.r or components.b is the identity swizzle, both values must be the identity swizzle
• If ycbcrModel is not SAMPLER_YCBCR_MODEL_CONVERSION_RGB_IDENTITY, then components.r, components.g, and components.b must correspond to components of the format; that is, components.r, components.g, and components.b must not be COMPONENT_SWIZZLE_ZERO or COMPONENT_SWIZZLE_ONE, and must not correspond to a component containing zero or one as a consequence of conversion to RGBA
• If ycbcrRange is SAMPLER_YCBCR_RANGE_ITU_NARROW then the R, G and B components obtained by applying the component swizzle to format must each have a bit-depth greater than or equal to 8
• If the potential format features of the sampler Y′C_BC_R conversion do not support FORMAT_FEATURE_SAMPLED_IMAGE_YCBCR_CONVERSION_CHROMA_RECONSTRUCTION_EXPLICIT_FORCEABLE_BIT forceExplicitReconstruction must be FALSE
• If the potential format features of the sampler Y′C_BC_R conversion do not support FORMAT_FEATURE_SAMPLED_IMAGE_YCBCR_CONVERSION_LINEAR_FILTER_BIT, chromaFilter must not be FILTER_LINEAR
• If the pNext chain includes a VkSamplerYcbcrConversionYcbcrDegammaCreateInfoQCOM structure, and if the ycbcrDegamma feature is not enabled, then VkSamplerYcbcrConversionYcbcrDegammaCreateInfoQCOM::enableYDegamma must be FALSE
• If the pNext chain includes a VkSamplerYcbcrConversionYcbcrDegammaCreateInfoQCOM structure, and if the ycbcrDegamma feature is not enabled, then VkSamplerYcbcrConversionYcbcrDegammaCreateInfoQCOM::enableCbCrDegamma must be FALSE
• If the pNext chain includes a VkSamplerYcbcrConversionYcbcrDegammaCreateInfoQCOM structure, format must be a format with 8-bit R, G, and B components.

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_SAMPLER_YCBCR_CONVERSION_CREATE_INFO
• Each pNext member of any structure (including this one) in the pNext chain must be either NULL or a pointer to a valid instance of VkExternalFormatANDROID or VkSamplerYcbcrConversionYcbcrDegammaCreateInfoQCOM
• The sType value of each struct in the pNext chain must be unique
• format must be a valid VkFormat value
• ycbcrModel must be a valid VkSamplerYcbcrModelConversion value
• ycbcrRange must be a valid VkSamplerYcbcrRange value
• components must be a valid VkComponentMapping structure
• xChromaOffset must be a valid VkChromaLocation value
• yChromaOffset must be a valid VkChromaLocation value
• chromaFilter must be a valid VkFilter value

If chromaFilter is FILTER_NEAREST, chroma samples are reconstructed to luma component resolution using nearest-neighbour sampling. Otherwise, chroma samples are reconstructed using interpolation. More details can be found in the description of sampler Y′C_BC_R conversion in the Image Operations chapter.

See Also

VkComponentMapping, CreateSamplerYcbcrConversion, CreateSamplerYcbcrConversionKHR

Layout

struct VkSamplerYcbcrConversionCreateInfo {
    VkStructureType sType;
    void const * pNext;
    VkFormat format;
    VkSamplerYcbcrModelConversion ycbcrModel;
    VkSamplerYcbcrRange ycbcrRange;
    VkComponentMapping components;
    VkChromaLocation xChromaOffset;
    VkChromaLocation yChromaOffset;
    VkFilter chromaFilter;
    VkBool32 forceExplicitReconstruction;
}