diff options
Diffstat (limited to 'subprojects/gst-plugins-bad/gst-libs/gst/codecs/gstvp9decoder.h')
-rw-r--r-- | subprojects/gst-plugins-bad/gst-libs/gst/codecs/gstvp9decoder.h | 185 |
1 files changed, 185 insertions, 0 deletions
diff --git a/subprojects/gst-plugins-bad/gst-libs/gst/codecs/gstvp9decoder.h b/subprojects/gst-plugins-bad/gst-libs/gst/codecs/gstvp9decoder.h new file mode 100644 index 0000000000..98c2f73328 --- /dev/null +++ b/subprojects/gst-plugins-bad/gst-libs/gst/codecs/gstvp9decoder.h @@ -0,0 +1,185 @@ +/* GStreamer + * Copyright (C) 2019 Seungha Yang <seungha.yang@navercorp.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_DECODER_H__ +#define __GST_VP9_DECODER_H__ + +#include <gst/codecs/codecs-prelude.h> + +#include <gst/video/video.h> +#include <gst/codecs/gstvp9picture.h> + +G_BEGIN_DECLS + +#define GST_TYPE_VP9_DECODER (gst_vp9_decoder_get_type()) +#define GST_VP9_DECODER(obj) (G_TYPE_CHECK_INSTANCE_CAST((obj),GST_TYPE_VP9_DECODER,GstVp9Decoder)) +#define GST_VP9_DECODER_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST((klass),GST_TYPE_VP9_DECODER,GstVp9DecoderClass)) +#define GST_VP9_DECODER_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS((obj),GST_TYPE_VP9_DECODER,GstVp9DecoderClass)) +#define GST_IS_VP9_DECODER(obj) (G_TYPE_CHECK_INSTANCE_TYPE((obj),GST_TYPE_VP9_DECODER)) +#define GST_IS_VP9_DECODER_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE((klass),GST_TYPE_VP9_DECODER)) +#define GST_VP9_DECODER_CAST(obj) ((GstVP9Decoder*)obj) + +typedef struct _GstVp9Decoder GstVp9Decoder; +typedef struct _GstVp9DecoderClass GstVp9DecoderClass; +typedef struct _GstVp9DecoderPrivate GstVp9DecoderPrivate; + +/** + * GstVp9Decoder: + * + * The opaque #GstVp9Decoder data structure. + */ +struct _GstVp9Decoder +{ + /*< private >*/ + GstVideoDecoder parent; + + /*< protected >*/ + GstVideoCodecState * input_state; + + /*< private >*/ + GstVp9DecoderPrivate *priv; + gpointer padding[GST_PADDING_LARGE]; +}; + +/** + * GstVp9DecoderClass: + */ +struct _GstVp9DecoderClass +{ + GstVideoDecoderClass parent_class; + + /** + * GstVp9Decoder::new_sequence: + * + * Notifies subclass of video sequence update such as resolution, bitdepth, + * profile. + * + * Since: 1.18 + */ + GstFlowReturn (*new_sequence) (GstVp9Decoder * decoder, + const GstVp9FrameHeader *frame_hdr); + + /** + * GstVp9Decoder:new_picture: + * @decoder: a #GstVp9Decoder + * @frame: (transfer none): a #GstVideoCodecFrame + * @picture: (transfer none): a #GstVp9Picture + * + * Optional. Called whenever new #GstVp9Picture is created. + * Subclass can set implementation specific user data on the #GstVp9Picture + * via gst_vp9_picture_set_user_data() + * + * Since: 1.18 + */ + GstFlowReturn (*new_picture) (GstVp9Decoder * decoder, + GstVideoCodecFrame * frame, + GstVp9Picture * picture); + + /** + * GstVp9Decoder:duplicate_picture: + * @decoder: a #GstVp9Decoder + * @frame: (transfer none): a #GstVideoCodecFrame + * @picture: (transfer none): a #GstVp9Picture to be duplicated + * + * Optional. Called to duplicate @picture when show_existing_frame flag is set + * in the parsed vp9 frame header. Returned #GstVp9Picture from this method + * should hold already decoded picture data corresponding to the @picture, + * since the returned #GstVp9Picture from this method will be passed to + * the output_picture method immediately without additional decoding process. + * + * If this method is not implemented by subclass, baseclass will drop + * current #GstVideoCodecFrame without additional processing for the current + * frame. + * + * Returns: (transfer full): a #GstVp9Picture or %NULL if failed to duplicate + * @picture. + * + * Since: 1.18 + */ + GstVp9Picture * (*duplicate_picture) (GstVp9Decoder * decoder, + GstVideoCodecFrame * frame, + GstVp9Picture * picture); + + /** + * GstVp9Decoder:start_picture: + * @decoder: a #GstVp9Decoder + * @picture: (transfer none): a #GstVp9Picture + * + * Optional. Called to notify subclass to prepare decoding process for + * @picture + * + * Since: 1.18 + */ + GstFlowReturn (*start_picture) (GstVp9Decoder * decoder, + GstVp9Picture * picture); + + /** + * GstVp9Decoder:decode_picture: + * @decoder: a #GstVp9Decoder + * @picture: (transfer none): a #GstVp9Picture to decoder + * @dpb: (transfer none): a #GstVp9Dpb + * + * Called to notify decoding for subclass to decoder given @picture with + * given @dpb + * + * Since: 1.18 + */ + GstFlowReturn (*decode_picture) (GstVp9Decoder * decoder, + GstVp9Picture * picture, + GstVp9Dpb * dpb); + + /** + * GstVp9Decoder::end_picture: + * @decoder: a #GstVp9Decoder + * @picture: (transfer none): a #GstVp9Picture + * + * Optional. Called per one #GstVp9Picture to notify subclass to finish + * decoding process for the #GstVp9Picture + * + * Since: 1.18 + */ + GstFlowReturn (*end_picture) (GstVp9Decoder * decoder, + GstVp9Picture * picture); + + /** + * GstVp9Decoder:output_picture: + * @decoder: a #GstVp9Decoder + * @frame: (transfer full): a #GstVideoCodecFrame + * @picture: (transfer full): a #GstVp9Picture + * + * Called to notify @picture is ready to be outputted. + * + * Since: 1.18 + */ + GstFlowReturn (*output_picture) (GstVp9Decoder * decoder, + GstVideoCodecFrame * frame, + GstVp9Picture * picture); + + /*< private >*/ + gpointer padding[GST_PADDING_LARGE]; +}; + +G_DEFINE_AUTOPTR_CLEANUP_FUNC(GstVp9Decoder, gst_object_unref) + +GST_CODECS_API +GType gst_vp9_decoder_get_type (void); + +G_END_DECLS + +#endif /* __GST_VP9_DECODER_H__ */ |