C Specification
When calling vkGetPhysicalDeviceVideoEncodeQualityLevelPropertiesKHR
with pVideoProfile->videoCodecOperation specified as
VK_VIDEO_CODEC_OPERATION_ENCODE_AV1_BIT_KHR, the
VkVideoEncodeAV1QualityLevelPropertiesKHR structure must be included
in the pNext chain of the VkVideoEncodeQualityLevelPropertiesKHR
structure to retrieve additional video encode quality level properties
specific to AV1 encoding.
The VkVideoEncodeAV1QualityLevelPropertiesKHR structure is defined as:
// Provided by VK_KHR_video_encode_av1
typedef struct VkVideoEncodeAV1QualityLevelPropertiesKHR {
VkStructureType sType;
void* pNext;
VkVideoEncodeAV1RateControlFlagsKHR preferredRateControlFlags;
uint32_t preferredGopFrameCount;
uint32_t preferredKeyFramePeriod;
uint32_t preferredConsecutiveBipredictiveFrameCount;
uint32_t preferredTemporalLayerCount;
VkVideoEncodeAV1QIndexKHR preferredConstantQIndex;
uint32_t preferredMaxSingleReferenceCount;
uint32_t preferredSingleReferenceNameMask;
uint32_t preferredMaxUnidirectionalCompoundReferenceCount;
uint32_t preferredMaxUnidirectionalCompoundGroup1ReferenceCount;
uint32_t preferredUnidirectionalCompoundReferenceNameMask;
uint32_t preferredMaxBidirectionalCompoundReferenceCount;
uint32_t preferredMaxBidirectionalCompoundGroup1ReferenceCount;
uint32_t preferredMaxBidirectionalCompoundGroup2ReferenceCount;
uint32_t preferredBidirectionalCompoundReferenceNameMask;
} VkVideoEncodeAV1QualityLevelPropertiesKHR;
Members
-
sTypeis a VkStructureType value identifying this structure. -
pNextisNULLor a pointer to a structure extending this structure. -
preferredRateControlFlagsis a bitmask of VkVideoEncodeAV1RateControlFlagBitsKHR values indicating the preferred flags to use for VkVideoEncodeAV1RateControlInfoKHR::flags. -
preferredGopFrameCountindicates the preferred value to use for VkVideoEncodeAV1RateControlInfoKHR::gopFrameCount. -
preferredKeyFramePeriodindicates the preferred value to use for VkVideoEncodeAV1RateControlInfoKHR::keyFramePeriod. -
preferredConsecutiveBipredictiveFrameCountindicates the preferred value to use for VkVideoEncodeAV1RateControlInfoKHR::consecutiveBipredictiveFrameCount. -
preferredTemporalLayerCountindicates the preferred value to use for VkVideoEncodeAV1RateControlInfoKHR::temporalLayerCount. -
preferredConstantQIndexindicates the preferred value to use for VkVideoEncodeAV1PictureInfoKHR::constantQIndexwhen using rate control modeVK_VIDEO_ENCODE_RATE_CONTROL_MODE_DISABLED_BIT_KHR. -
preferredMaxSingleReferenceCountindicates the preferred maximum number of reference pictures to use with single reference prediction mode. -
preferredSingleReferenceNameMaskis a bitmask of preferred AV1 reference names when using single reference prediction mode. -
preferredMaxUnidirectionalCompoundReferenceCountindicates the preferred maximum number of reference pictures to use with unidirectional compound prediction mode. -
preferredMaxUnidirectionalCompoundGroup1ReferenceCountindicates the preferred maximum number of reference pictures to use with unidirectional compound prediction mode from reference frame group 1, as defined in section 6.10.24 of the AV1 Specification. -
preferredUnidirectionalCompoundReferenceNameMaskis a bitmask of preferred AV1 reference names when using unidirectional compound prediction mode. -
preferredMaxBidirectionalCompoundReferenceCountindicates the preferred maximum number of reference pictures to use with bidirectional compound prediction mode. -
preferredMaxBidirectionalCompoundGroup1ReferenceCountindicates the preferred maximum number of reference pictures to use with bidirectional compound prediction mode from reference frame group 1, as defined in section 6.10.24 of the AV1 Specification. -
preferredMaxBidirectionalCompoundGroup2ReferenceCountindicates the preferred maximum number of reference pictures to use with bidirectional compound prediction mode from reference frame group 2, as defined in section 6.10.24 of the AV1 Specification. -
preferredBidirectionalCompoundReferenceNameMaskis a bitmask of preferred AV1 reference names when using bidirectional compound prediction mode.
Description
preferredSingleReferenceNameMask,
preferredUnidirectionalCompoundReferenceNameMask, and
preferredBidirectionalCompoundReferenceNameMask are encoded such that
when bit index i is set, it indicates preference for using the
AV1 reference name
STD_VIDEO_AV1_REFERENCE_NAME_LAST_FRAME + i.
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.