From 652cd2470f03c8faa335d54fe0c908c89dd039da Mon Sep 17 00:00:00 2001 From: He Junyan Date: Mon, 3 Feb 2025 13:45:34 +0800 Subject: [PATCH] Doc: update the document for the vvc decoder Part-of: --- girs/GstCodecs-1.0.gir | 782 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 782 insertions(+) diff --git a/girs/GstCodecs-1.0.gir b/girs/GstCodecs-1.0.gir index 3ff6a2b674..2b1d1f45b6 100644 --- a/girs/GstCodecs-1.0.gir +++ b/girs/GstCodecs-1.0.gir @@ -2646,6 +2646,759 @@ corresponding to the @system_frame_number + + The opaque #GstH266Decoder data structure. + + + Provides per slice data with parsed slice header and required raw bitstream +for subclass to decode it. + + + + + + + a #GstH266Decoder + + + + a #GstH266Picture + + + + a #GstH266Slice + + + + + + Optional. Called per one #GstH266Picture to notify subclass to finish +decoding process for the #GstH266Picture + + + + + + + a #GstH266Decoder + + + + a #GstH266Picture + + + + + + Optional. Called by baseclass to query whether delaying output is +preferred by subclass or not. + + + the number of perferred delayed output frame + + + + + a #GstH266Decoder + + + + whether upstream is live or not + + + + + + Optional. Called whenever new #GstH266Picture is created. +Subclass can set implementation specific user data +on the #GstH266Picture via gst_h266_picture_set_user_data + + + + + + + a #GstH266Decoder + + + + a #GstVideoCodecFrame + + + + a #GstH266Picture + + + + + + Notifies subclass of video sequence update + + + + + + + a #GstH266Decoder + + + + a #GstH266SPS + + + + the size of dpb including preferred output delay + by subclass reported via get_preferred_output_delay method. + + + + + + + + + + + + + + + + + + + + + + + Optional. Called per one #GstH266Picture to notify subclass to prepare +decoding process for the #GstH266Picture + + + + + + + a #GstH266Decoder + + + + a #GstH266Picture + + + + a #GstH266Slice + + + + a #GstH266Dpb + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + The opaque #GstH266DecoderClass data structure. + + + + + + + + + + + + + a #GstH266Decoder + + + + a #GstH266SPS + + + + the size of dpb including preferred output delay + by subclass reported via get_preferred_output_delay method. + + + + + + + + + + + + + + a #GstH266Decoder + + + + a #GstVideoCodecFrame + + + + a #GstH266Picture + + + + + + + + + + + + + + a #GstH266Decoder + + + + a #GstH266Picture + + + + a #GstH266Slice + + + + a #GstH266Dpb + + + + + + + + + + + + + + a #GstH266Decoder + + + + a #GstH266Picture + + + + a #GstH266Slice + + + + + + + + + + + + + + a #GstH266Decoder + + + + a #GstH266Picture + + + + + + + + + + + + + + + + + + + + + + + + + + + + + the number of perferred delayed output frame + + + + + a #GstH266Decoder + + + + whether upstream is live or not + + + + + + + + + + + + + + + + The #GstH266Dpb represents the dpb for decoding. + + + Store the @picture and perform increase pic_latency_cnt as defined in +"C.5.2.3 Additional bumping" process + + + + + + + a #GstH266Dpb + + + + a #GstH266Picture + + + + + + Perform bumping process as defined in C.5.2.4 "Bumping" process. +If @drain is %TRUE, @dpb will remove a #GstH266Picture from internal array +so that returned #GstH266Picture could hold the last reference of it. + + + a #GstH266Picture which is needed to be +outputted + + + + + a #GstH266Dpb + + + + whether draining or not + + + + + + Clear all stored #GstH266Picture + + + + + + + a #GstH266Dpb + + + + + + Delete unneeded pictures from dpb as defined in "C.5.2.2 Output and +removal of pictures from the DPB". + + + + + + + a #GstH266Dpb + + + + + + Free the @dpb + + + + + + + a #GstH266Dpb to free + + + + + + + + the number of maximum pictures + + + + + a #GstH266Dpb + + + + + + Find a picture which has matching poc + + + a #GstH266Picture + + + + + a #GstH266Dpb + + + + a picture order count + + + + + + Find a picture which has matching poc_lsb + + + a #GstH266Picture + + + + + a #GstH266Dpb + + + + a picture order count lsb + + + + + + + + a #GArray of + #GstH266Picture stored in @dpb + + + + + + + a #GstH266Dpb + + + + + + + + the length of stored dpb array + + + + + a #GstH266Dpb + + + + + + Mark all pictures are no needed for output + + + + + + + a #GstH266Dpb + + + + + + Mark all pictures are not referenced + + + + + + + a #GstH266Dpb + + + + + + + + %TRUE if bumping is required + + + + + a #GstH266Dpb + + + + dpb_max_num_reorder_pics[HighestTid] + + + + MaxLatencyPictures[HighestTid] + + + + dpb_max_dec_pic_buffering_minus1[HighestTid] + 1 + or zero if this shouldn't be used for bumping decision. + + + + + + + + The number of referenced pictures in dpb. + + + + + a #GstH266Dpb + + + + + + Set the number of maximum allowed pictures to store + + + + + + + a #GstH266Dpb + + + + the maximum number of picture + + + + + + Create new #GstH266Dpb + + + a new #GstH266Dpb + + + + + + The #GstH266Picture represents a picture for decoding. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Create new #GstH266Picture + + + a new #GstH266Picture + + + + + + The #GstH266Slice represents a slice for decoding. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -2709,6 +3462,27 @@ corresponding to the @system_frame_number + + + + + + + + + + + + + + + + + + + + + @@ -5030,6 +5804,14 @@ gst_vp9_stateful_parser_free() after use. + + Create new #GstH266Dpb + + + a new #GstH266Dpb + + + Create new #GstMpeg2Dpb