Package org.lwjgl.vulkan

Class VkVideoDecodeH264PictureInfoKHR

java.lang.Object
org.lwjgl.system.Pointer.Default
org.lwjgl.system.Struct<VkVideoDecodeH264PictureInfoKHR>
org.lwjgl.vulkan.VkVideoDecodeH264PictureInfoKHR
All Implemented Interfaces:
AutoCloseable, org.lwjgl.system.NativeResource, org.lwjgl.system.Pointer
public class VkVideoDecodeH264PictureInfoKHR extends org.lwjgl.system.Struct<VkVideoDecodeH264PictureInfoKHR> implements org.lwjgl.system.NativeResource
Structure specifies H.264 decode picture parameters when decoding a picture.
Description

This structure is specified in the pNext chain of the VkVideoDecodeInfoKHR structure passed to CmdDecodeVideoKHR to specify the codec-specific picture information for an H.264 decode operation.

Decode Output Picture Information
  • If pStdPictureInfo→flags.field_pic_flag is not set, then the picture represents a frame.
  • If pStdPictureInfo→flags.field_pic_flag is set, then the picture represents a field. Specifically:
    • If pStdPictureInfo→flags.bottom_field_flag is not set, then the picture represents the top field of the frame.
    • If pStdPictureInfo→flags.bottom_field_flag is set, then the picture represents the bottom field of the frame.
  • The image subregion used is determined according to the H.264 Decode Picture Data Access section.
  • The decode output picture is associated with the H.264 picture information provided in pStdPictureInfo.
Std Picture Information
  • reserved1 and reserved2 are used only for padding purposes and are otherwise ignored;
  • flags.is_intra as defined in section 3.73 of the ITU-T H.264 Specification;
  • flags.is_reference as defined in section 3.136 of the ITU-T H.264 Specification;
  • flags.complementary_field_pair as defined in section 3.35 of the ITU-T H.264 Specification;
  • seq_parameter_set_id and pic_parameter_set_id are used to identify the active parameter sets, as described below;
  • all other members are interpreted as defined in section 7.4.3 of the ITU-T H.264 Specification.

Reference picture setup is controlled by the value of StdVideoDecodeH264PictureInfo::flags.is_reference. If it is set and a reconstructed picture is specified, then the latter is used as the target of picture reconstruction to activate the DPB slot specified in pDecodeInfo→pSetupReferenceSlot→slotIndex. If StdVideoDecodeH264PictureInfo::flags.is_reference is not set, but a reconstructed picture is specified, then the corresponding picture reference associated with the DPB slot is invalidated, as described in the DPB Slot States section.

Active Parameter Sets
  • The active SPS is the SPS identified by the key specified in StdVideoDecodeH264PictureInfo::seq_parameter_set_id.
  • The active PPS is the PPS identified by the key specified by the pair constructed from StdVideoDecodeH264PictureInfo::seq_parameter_set_id and StdVideoDecodeH264PictureInfo::pic_parameter_set_id.
Valid Usage (Implicit)
  • sType must be STRUCTURE_TYPE_VIDEO_DECODE_H264_PICTURE_INFO_KHR
  • pStdPictureInfo must be a valid pointer to a valid StdVideoDecodeH264PictureInfo value
  • pSliceOffsets must be a valid pointer to an array of sliceCount uint32_t values
  • sliceCount must be greater than 0

Layout


 struct VkVideoDecodeH264PictureInfoKHR {
     VkStructureType sType();
     void const * pNext();
     StdVideoDecodeH264PictureInfo const * pStdPictureInfo();
     uint32_t sliceCount();
     uint32_t const * pSliceOffsets();
 }