2 * Copyright (C) 2006 David Schleef <ds@schleef.org>
3 * Copyright (C) 2008,2009,2010 Entropy Wave Inc
4 * Copyright (C) 2010-2012 Sebastian Dröge <sebastian.droege@collabora.co.uk>
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Library General Public
8 * License as published by the Free Software Foundation; either
9 * version 2 of the License, or (at your option) any later version.
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Library General Public License for more details.
16 * You should have received a copy of the GNU Library General Public
17 * License along with this library; if not, write to the
18 * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
19 * Boston, MA 02110-1301, USA.
23 * SECTION:element-vp8dec
24 * @see_also: vp8enc, matroskademux
26 * This element decodes VP8 streams into raw video.
27 * <ulink url="http://www.webmproject.org">VP8</ulink> is a royalty-free
28 * video codec maintained by <ulink url="http://www.google.com/">Google
29 * </ulink>. It's the successor of On2 VP3, which was the base of the
33 * <title>Example pipeline</title>
35 * gst-launch-1.0 -v filesrc location=videotestsrc.webm ! matroskademux ! vp8dec ! videoconvert ! videoscale ! autovideosink
36 * ]| This example pipeline will decode a WebM stream and decodes the VP8 video.
44 #ifdef HAVE_VP8_DECODER
48 #include "gstvp8dec.h"
49 #include "gstvp8utils.h"
51 #include <gst/video/gstvideometa.h>
52 #include <gst/video/gstvideopool.h>
54 GST_DEBUG_CATEGORY_STATIC (gst_vp8dec_debug);
55 #define GST_CAT_DEFAULT gst_vp8dec_debug
57 #define VP8_DECODER_VIDEO_TAG "VP8 video"
59 static void gst_vp8_dec_set_default_format (GstVPXDec * dec, GstVideoFormat fmt,
60 int width, int height);
61 static void gst_vp8_dec_handle_resolution_change (GstVPXDec * dec,
62 vpx_image_t * img, GstVideoFormat fmt);
64 static GstStaticPadTemplate gst_vp8_dec_sink_template =
65 GST_STATIC_PAD_TEMPLATE ("sink",
68 GST_STATIC_CAPS ("video/x-vp8")
71 static GstStaticPadTemplate gst_vp8_dec_src_template =
72 GST_STATIC_PAD_TEMPLATE ("src",
75 GST_STATIC_CAPS (GST_VIDEO_CAPS_MAKE ("I420"))
78 #define parent_class gst_vp8_dec_parent_class
79 G_DEFINE_TYPE (GstVP8Dec, gst_vp8_dec, GST_TYPE_VPX_DEC);
82 gst_vp8_dec_class_init (GstVP8DecClass * klass)
84 GstElementClass *element_class;
85 GstVPXDecClass *vpx_class;
87 element_class = GST_ELEMENT_CLASS (klass);
88 vpx_class = GST_VPX_DEC_CLASS (klass);
90 gst_element_class_add_pad_template (element_class,
91 gst_static_pad_template_get (&gst_vp8_dec_sink_template));
93 gst_element_class_add_pad_template (element_class,
94 gst_static_pad_template_get (&gst_vp8_dec_src_template));
96 gst_element_class_set_static_metadata (element_class,
98 "Codec/Decoder/Video",
99 "Decode VP8 video streams", "David Schleef <ds@entropywave.com>, "
100 "Sebastian Dröge <sebastian.droege@collabora.co.uk>");
102 vpx_class->video_codec_tag = VP8_DECODER_VIDEO_TAG;
103 vpx_class->codec_algo = &vpx_codec_vp8_dx_algo;
104 vpx_class->set_default_format =
105 GST_DEBUG_FUNCPTR (gst_vp8_dec_set_default_format);
106 vpx_class->handle_resolution_change =
107 GST_DEBUG_FUNCPTR (gst_vp8_dec_handle_resolution_change);
109 GST_DEBUG_CATEGORY_INIT (gst_vp8dec_debug, "vp8dec", 0, "VP8 Decoder");
113 gst_vp8_dec_init (GstVP8Dec * gst_vp8_dec)
115 GST_DEBUG_OBJECT (gst_vp8_dec, "gst_vp8_dec_init");
119 gst_vp8_dec_set_default_format (GstVPXDec * dec, GstVideoFormat fmt, int width,
122 GstVPXDecClass *vpxclass = GST_VPX_DEC_GET_CLASS (dec);
123 g_assert (dec->output_state == NULL);
125 gst_video_decoder_set_output_state (GST_VIDEO_DECODER (dec),
126 GST_VIDEO_FORMAT_I420, width, height, dec->input_state);
127 gst_video_decoder_negotiate (GST_VIDEO_DECODER (dec));
128 vpxclass->send_tags (dec);
132 gst_vp8_dec_handle_resolution_change (GstVPXDec * dec, vpx_image_t * img,
136 GstVideoCodecState *new_output_state;
138 info = &dec->output_state->info;
139 if (GST_VIDEO_INFO_WIDTH (info) != img->d_w
140 || GST_VIDEO_INFO_HEIGHT (info) != img->d_h) {
141 GST_DEBUG_OBJECT (dec,
142 "Changed output resolution was %d x %d now is got %u x %u (display %u x %u)",
143 GST_VIDEO_INFO_WIDTH (info), GST_VIDEO_INFO_HEIGHT (info), img->w,
144 img->h, img->d_w, img->d_h);
147 gst_video_decoder_set_output_state (GST_VIDEO_DECODER (dec),
148 GST_VIDEO_FORMAT_I420, img->d_w, img->d_h, dec->output_state);
149 if (dec->output_state) {
150 gst_video_codec_state_unref (dec->output_state);
152 dec->output_state = new_output_state;
153 /* No need to call negotiate() here, it will be automatically called
154 * by allocate_output_frame()*/
158 #endif /* HAVE_VP8_DECODER */