mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-11-07 09:59:55 +00:00
c36190cbda
Existing VP9 parser implementation doesn't provide information required by other stateless decoding APIs (i.e., DXVA and NVDEC), specifically loop filter and segmentation parameters might not exist current frame. So parser needs to fill the information by using previously parsed information. We can update the gstvp9parser implementation so that it can provide all information required by stateless decoding APIs with a huge API break, or adding more ugly struct in it. Instead doing as such, this commit introduce a new VP9 parser implementation. What is different from existing one? * All variables will follow the specification as much as possible: VP9 Bitstream & Decoding Process Specification - v0.6 31st March 2016 * Parser will fill all the required information for decoding frame to GstVp9FrameHeader struct. In case of old VP9 parser, user needs to read additional data from parser's member variables. * GstVp9StatefulParser object struct is completely completely opaque Part-of: <https://gitlab.freedesktop.org/gstreamer/gst-plugins-bad/-/merge_requests/2112>
344 lines
12 KiB
C
344 lines
12 KiB
C
/* GStreamer
|
|
* Copyright (C) 2021 Seungha Yang <seungha@centricular.com>
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Library General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Library General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Library General Public
|
|
* License along with this library; if not, write to the
|
|
* Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
|
|
* Boston, MA 02110-1301, USA.
|
|
*/
|
|
|
|
#ifndef __GST_VP9_STATEFUL_PARSER_H__
|
|
#define __GST_VP9_STATEFUL_PARSER_H__
|
|
|
|
#include <gst/codecs/codecs-prelude.h>
|
|
#include <gst/codecparsers/gstvp9parser.h>
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
typedef struct _GstVp9StatefulParser GstVp9StatefulParser;
|
|
typedef struct _GstVp9LoopFilterParams GstVp9LoopFilterParams;
|
|
typedef struct _GstVp9QuantizationParams GstVp9QuantizationParams;
|
|
typedef struct _GstVp9SegmentationParams GstVp9SegmentationParams;
|
|
typedef struct _GstVp9FrameHeader GstVp9FrameHeader;
|
|
|
|
/**
|
|
* GST_VP9_SEG_LVL_ALT_Q:
|
|
*
|
|
* Index for quantizer segment feature
|
|
*
|
|
* Since: 1.20
|
|
*/
|
|
#define GST_VP9_SEG_LVL_ALT_Q 0
|
|
|
|
/**
|
|
* GST_VP9_SEG_LVL_ALT_L:
|
|
*
|
|
* Index for loop filter segment feature
|
|
*
|
|
* Since: 1.20
|
|
*/
|
|
#define GST_VP9_SEG_LVL_ALT_L 1
|
|
|
|
/**
|
|
* GST_VP9_SEG_LVL_REF_FRAME:
|
|
*
|
|
* Index for reference frame segment feature
|
|
*
|
|
* Since: 1.20
|
|
*/
|
|
#define GST_VP9_SEG_LVL_REF_FRAME 2
|
|
|
|
/**
|
|
* GST_VP9_SEG_SEG_LVL_SKIP:
|
|
*
|
|
* Index for skip segment feature
|
|
*
|
|
* Since: 1.20
|
|
*/
|
|
#define GST_VP9_SEG_SEG_LVL_SKIP 3
|
|
|
|
/**
|
|
* GST_VP9_SEG_LVL_MAX:
|
|
*
|
|
* Number of segment features
|
|
*
|
|
* Since: 1.20
|
|
*/
|
|
#define GST_VP9_SEG_LVL_MAX 4
|
|
|
|
/**
|
|
* GstVp9LoopFilterParams:
|
|
* @loop_filter_level: indicates the loop filter strength
|
|
* @loop_filter_sharpness: indicates the sharpness level
|
|
* @loop_filter_delta_enabled: equal to 1 means that the filter level depends
|
|
* on the mode and reference frame used to predict a block
|
|
* @loop_filter_delta_update: equal to 1 means that the bitstream contains
|
|
* additional syntax elements that specify which mode and reference frame
|
|
* deltas are to be updated
|
|
* @update_ref_delta: equal to 1 means that the bitstream contains the syntax
|
|
* element loop_filter_ref_delta
|
|
* @loop_filter_ref_deltas: contains the adjustment needed for the filter level
|
|
* based on the chosen reference frame
|
|
* @update_mode_delta: equal to 1 means that the bitstream contains the syntax
|
|
* element loop_filter_mode_deltas
|
|
* @loop_filter_mode_deltas: contains the adjustment needed for the filter level
|
|
* based on the chosen mode
|
|
*
|
|
* Loop filter params. See "6.2.8 Loop filter params syntax" and
|
|
* "7.2.8 Loop filter semantics".
|
|
*
|
|
* If syntax elements for @update_ref_delta
|
|
* and/or @loop_filter_mode_deltas are not present in bitstream,
|
|
* parser will fill @loop_filter_ref_deltas and @loop_filter_mode_deltas values
|
|
* by using previously parsed values.
|
|
*
|
|
* Since: 1.20
|
|
*/
|
|
struct _GstVp9LoopFilterParams
|
|
{
|
|
guint8 loop_filter_level;
|
|
guint8 loop_filter_sharpness;
|
|
guint8 loop_filter_delta_enabled;
|
|
guint8 loop_filter_delta_update;
|
|
|
|
guint8 update_ref_delta[GST_VP9_MAX_REF_LF_DELTAS];
|
|
gint8 loop_filter_ref_deltas[GST_VP9_MAX_REF_LF_DELTAS];
|
|
|
|
guint8 update_mode_delta[GST_VP9_MAX_MODE_LF_DELTAS];
|
|
gint8 loop_filter_mode_deltas[GST_VP9_MAX_MODE_LF_DELTAS];
|
|
};
|
|
|
|
/**
|
|
* GstVp9QuantizationParams:
|
|
* @base_q_idx: indicates the base frame qindex. This is used for Y AC
|
|
* coefficients and as the base value for the other quantizers
|
|
* @delta_q_y_dc: indicates the Y DC quantizer relative to base_q_idx
|
|
* @delta_q_uv_dc: indicates the UV DC quantizer relative to base_q_idx
|
|
* @delta_q_uv_ac: indicates the UV AC quantizer relative to base_q_idx
|
|
*
|
|
* Since: 1.20
|
|
*/
|
|
struct _GstVp9QuantizationParams
|
|
{
|
|
guint8 base_q_idx;
|
|
gint8 delta_q_y_dc;
|
|
gint8 delta_q_uv_dc;
|
|
gint8 delta_q_uv_ac;
|
|
};
|
|
|
|
/**
|
|
* GstVp9SegmentationParams:
|
|
* @segmentation_enabled: equal to 1 indicates that this frame makes use of the
|
|
* segmentation tool
|
|
* @segmentation_update_map: equal to 1 indicates that the segmentation map
|
|
* should be updated during the decoding of this frame
|
|
* @segmentation_tree_probs: specify the probability values to be used when
|
|
* decoding segment_id
|
|
* @segmentation_pred_prob: specify the probability values to be used when
|
|
* decoding seg_id_predicted
|
|
* @segmentation_temporal_update: equal to 1 indicates that the updates to
|
|
* the segmentation map are coded relative to the existing segmentation map
|
|
* @segmentation_update_data: equal to 1 indicates that new parameters are
|
|
* about to be specified for each segment
|
|
* @segmentation_abs_or_delta_update: equal to 0 indicates that the segmentation
|
|
* parameters represent adjustments relative to the standard values.
|
|
* equal to 1 indicates that the segmentation parameters represent the actual
|
|
* values to be used
|
|
* @feature_enabled: indicates whether feature is enabled or not
|
|
* @feature_data: segmentation feature data
|
|
*
|
|
* See "6.2.11 Segmentation params syntax" and
|
|
* "7.2.10 Segmentation params syntax". When @segmentation_update_data is equal
|
|
* to zero, parser will fill @feature_enabled and by @feature_data
|
|
* using previously parsed values.
|
|
*
|
|
* Since: 1.20
|
|
*/
|
|
struct _GstVp9SegmentationParams
|
|
{
|
|
guint8 segmentation_enabled;
|
|
guint8 segmentation_update_map;
|
|
guint8 segmentation_tree_probs[GST_VP9_SEG_TREE_PROBS];
|
|
guint8 segmentation_pred_prob[GST_VP9_PREDICTION_PROBS];
|
|
guint8 segmentation_temporal_update;
|
|
|
|
guint8 segmentation_update_data;
|
|
guint8 segmentation_abs_or_delta_update;
|
|
|
|
guint8 feature_enabled[GST_VP9_MAX_SEGMENTS][GST_VP9_SEG_LVL_MAX];
|
|
gint16 feature_data[GST_VP9_MAX_SEGMENTS][GST_VP9_SEG_LVL_MAX];
|
|
};
|
|
|
|
/**
|
|
* GstVp9FrameHeader:
|
|
* @profile: encoded profile
|
|
* @bit_depth: encoded bit depth
|
|
* @subsampling_x: specify the chroma subsampling format for x coordinate
|
|
* @subsampling_y: specify the chroma subsampling format for y coordinate
|
|
* @color_space: specifies the color space of the stream
|
|
* @color_range: specifies the black level and range of the luma and chroma
|
|
* signals
|
|
* @show_existing_frame: equal to 1, indicates the frame indexed by
|
|
* frame_to_show_map_idx is to be displayed
|
|
* @frame_to_show_map_idx: specifies the frame to be displayed.
|
|
* It is only available if show_existing_frame is 1
|
|
* @frame_type: equal to 0 indicates that the current frame is a key frame
|
|
* @show_frame: indicate whether it is a displayable frame or not
|
|
* @error_resilient_mode: equal to 1 indicates that error resilient mode is
|
|
* enabled
|
|
* @width: coded frame width
|
|
* @height: coded frame height
|
|
* @render_and_frame_size_different: equal to 0 means that the render width and
|
|
* height are inferred from the frame width and height
|
|
* @render_width: render width of the frame
|
|
* @render_height: render width of the frame
|
|
* @intra_only: equal to 1 indicates that the frame is an intra-only frame
|
|
* @reset_frame_context: specifies whether the frame context should be reset to
|
|
* default values
|
|
* @refresh_frame_flags: contains a bitmask that specifies which reference frame
|
|
* slots will be updated with the current frame after it is decoded
|
|
* @ref_frame_idx: specifies which reference frames are used by inter frames
|
|
* @ref_frame_sign_bias: specifies the intended direction of the motion vector
|
|
* in time for each reference frame. A sign bias equal to 0 indicates that
|
|
* the reference frame is a backwards reference
|
|
* @allow_high_precision_mv: equal to 0 specifies that motion vectors are
|
|
* specified to quarter pel precision
|
|
* @interpolation_filter: specifies the filter selection used for performing
|
|
* inter prediction
|
|
* @refresh_frame_context: equal to 1 indicates that the probabilities computed
|
|
* for this frame
|
|
* @frame_parallel_decoding_mode: equal to 1 indicates that parallel decoding
|
|
* mode is enabled
|
|
* @frame_context_idx: indicates the frame context to use
|
|
* @loop_filter_params: a #GstVp9LoopFilterParams
|
|
* @quantization_params: a #GstVp9QuantizationParams
|
|
* @segmentation_params: a #GstVp9SegmentationParams
|
|
* @tile_cols_log2: specifies the base 2 logarithm of the width of each tile
|
|
* @tile_rows_log2: specifies the base 2 logarithm of the height of each tile
|
|
* @lossless_flag: lossless mode decode
|
|
* @frame_header_length_in_bytes: length of uncompressed header
|
|
*
|
|
* Since: 1.20
|
|
*/
|
|
struct _GstVp9FrameHeader
|
|
{
|
|
guint8 profile;
|
|
guint8 bit_depth;
|
|
guint8 subsampling_x;
|
|
guint8 subsampling_y;
|
|
guint8 color_space;
|
|
guint8 color_range;
|
|
guint8 show_existing_frame;
|
|
guint8 frame_to_show_map_idx;
|
|
guint8 frame_type;
|
|
guint8 show_frame;
|
|
guint8 error_resilient_mode;
|
|
guint32 width;
|
|
guint32 height;
|
|
guint8 render_and_frame_size_different;
|
|
guint32 render_width;
|
|
guint32 render_height;
|
|
guint8 intra_only;
|
|
guint8 reset_frame_context;
|
|
guint8 refresh_frame_flags;
|
|
guint8 ref_frame_idx[GST_VP9_REFS_PER_FRAME];
|
|
guint8 ref_frame_sign_bias[4];
|
|
guint8 allow_high_precision_mv;
|
|
guint8 interpolation_filter;
|
|
|
|
guint8 refresh_frame_context;
|
|
guint8 frame_parallel_decoding_mode;
|
|
guint8 frame_context_idx;
|
|
|
|
GstVp9LoopFilterParams loop_filter_params;
|
|
GstVp9QuantizationParams quantization_params;
|
|
GstVp9SegmentationParams segmentation_params;
|
|
|
|
guint8 tile_cols_log2;
|
|
guint8 tile_rows_log2;
|
|
|
|
guint16 header_size_in_bytes;
|
|
|
|
/* calculated values */
|
|
guint8 lossless_flag;
|
|
guint32 frame_header_length_in_bytes;
|
|
};
|
|
|
|
/**
|
|
* GstVp9StatefulParser:
|
|
*
|
|
* Opaque VP9 parser struct.
|
|
* The size of this object and member variables are not API
|
|
*
|
|
* Since: 1.20
|
|
*/
|
|
struct _GstVp9StatefulParser
|
|
{
|
|
/*< private >*/
|
|
guint8 bit_depth;
|
|
guint8 subsampling_x;
|
|
guint8 subsampling_y;
|
|
guint8 color_space;
|
|
guint8 color_range;
|
|
|
|
guint mi_cols;
|
|
guint mi_rows;
|
|
guint sb64_cols;
|
|
guint sb64_rows;
|
|
|
|
GstVp9LoopFilterParams loop_filter_params;
|
|
GstVp9SegmentationParams segmentation_params;
|
|
|
|
struct {
|
|
guint32 width;
|
|
guint32 height;
|
|
} reference[GST_VP9_REF_FRAMES];
|
|
};
|
|
|
|
GST_CODECS_API
|
|
GstVp9StatefulParser * gst_vp9_stateful_parser_new (void);
|
|
|
|
GST_CODECS_API
|
|
void gst_vp9_stateful_parser_free (GstVp9StatefulParser * parser);
|
|
|
|
GST_CODECS_API
|
|
GstVp9ParserResult gst_vp9_stateful_parser_parse_frame_header (GstVp9StatefulParser * parser,
|
|
GstVp9FrameHeader * header,
|
|
const guint8 * data,
|
|
gsize size);
|
|
|
|
/* Util methods */
|
|
GST_CODECS_API
|
|
gboolean gst_vp9_seg_feature_active (const GstVp9SegmentationParams * params,
|
|
guint8 segment_id,
|
|
guint8 feature);
|
|
|
|
GST_CODECS_API
|
|
guint8 gst_vp9_get_qindex (const GstVp9SegmentationParams * segmentation_params,
|
|
const GstVp9QuantizationParams * quantization_params,
|
|
guint8 segment_id);
|
|
|
|
|
|
GST_CODECS_API
|
|
gint16 gst_vp9_get_dc_quant (guint8 qindex,
|
|
gint8 delta_q_dc,
|
|
guint8 bit_depth);
|
|
|
|
GST_CODECS_API
|
|
gint16 gst_vp9_get_ac_quant (guint8 qindex,
|
|
gint8 delta_q_ac,
|
|
guint8 bit_depth);
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __GST_VP9_STATEFUL_PARSER_H__ */
|