1 /* GStreamer WebM muxer
2 * Copyright (c) 2010 Sebastian Dröge <sebastian.droege@collabora.co.uk>
3 *
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Library General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
8 *
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Library General Public License for more details.
13 *
14 * You should have received a copy of the GNU Library General Public
15 * License along with this library; if not, write to the
16 * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
17 * Boston, MA 02110-1301, USA.
18 */
19
20 /**
21 * SECTION:element-webmmux
22 *
23 * webmmux muxes VP8 video and Vorbis audio streams into a WebM file.
24 *
25 * <refsect2>
26 * <title>Example launch line</title>
27 * |[
28 * gst-launch-1.0 webmmux name=mux ! filesink location=newfile.webm \
29 * uridecodebin uri=file:///path/to/somefile.ogv name=demux \
30 * demux. ! videoconvert ! vp8enc ! queue ! mux.video_0 \
31 * demux. ! progressreport ! audioconvert ! audiorate ! vorbisenc ! queue ! mux.audio_0
32 * ]| This pipeline re-encodes a video file of any format into a WebM file.
33 * |[
34 * gst-launch-1.0 webmmux name=mux ! filesink location=test.webm \
35 * videotestsrc num-buffers=250 ! video/x-raw,framerate=25/1 ! videoconvert ! vp8enc ! queue ! mux.video_0 \
36 * audiotestsrc samplesperbuffer=44100 num-buffers=10 ! audio/x-raw,rate=44100 ! vorbisenc ! queue ! mux.audio_0
37 * ]| This pipeline muxes a test video and a sine wave into a WebM file.
38 * </refsect2>
39 */
40
41 #ifdef HAVE_CONFIG_H
42 #include "config.h"
43 #endif
44
45 #include "webm-mux.h"
46
47 #define COMMON_VIDEO_CAPS \
48 "width = (int) [ 16, MAX ], " \
49 "height = (int) [ 16, MAX ], " \
50 "framerate = (fraction) [ 0, MAX ]"
51
52 #define COMMON_AUDIO_CAPS \
53 "channels = (int) [ 1, MAX ], " \
54 "rate = (int) [ 1, MAX ]"
55
56 G_DEFINE_TYPE (GstWebMMux, gst_webm_mux, GST_TYPE_MATROSKA_MUX);
57
58 static GstStaticPadTemplate webm_src_templ = GST_STATIC_PAD_TEMPLATE ("src",
59 GST_PAD_SRC,
60 GST_PAD_ALWAYS,
61 GST_STATIC_CAPS ("video/webm; audio/webm")
62 );
63
64 static GstStaticPadTemplate webm_videosink_templ =
65 GST_STATIC_PAD_TEMPLATE ("video_%u",
66 GST_PAD_SINK,
67 GST_PAD_REQUEST,
68 GST_STATIC_CAPS ("video/x-vp8, " COMMON_VIDEO_CAPS ";"
69 "video/x-vp9, " COMMON_VIDEO_CAPS ";" "video/x-av1, " COMMON_VIDEO_CAPS)
70 );
71
72 static GstStaticPadTemplate webm_audiosink_templ =
73 GST_STATIC_PAD_TEMPLATE ("audio_%u",
74 GST_PAD_SINK,
75 GST_PAD_REQUEST,
76 GST_STATIC_CAPS ("audio/x-vorbis, " COMMON_AUDIO_CAPS ";"
77 "audio/x-opus, " COMMON_AUDIO_CAPS)
78 );
79
80 static void
gst_webm_mux_class_init(GstWebMMuxClass * klass)81 gst_webm_mux_class_init (GstWebMMuxClass * klass)
82 {
83 GstElementClass *gstelement_class = (GstElementClass *) klass;
84
85 gst_element_class_add_static_pad_template (gstelement_class,
86 &webm_videosink_templ);
87 gst_element_class_add_static_pad_template (gstelement_class,
88 &webm_audiosink_templ);
89 gst_element_class_add_static_pad_template (gstelement_class, &webm_src_templ);
90 gst_element_class_set_static_metadata (gstelement_class, "WebM muxer",
91 "Codec/Muxer",
92 "Muxes video and audio streams into a WebM stream",
93 "GStreamer maintainers <gstreamer-devel@lists.freedesktop.org>");
94 }
95
96 static void
gst_webm_mux_init(GstWebMMux * mux)97 gst_webm_mux_init (GstWebMMux * mux)
98 {
99 GST_MATROSKA_MUX (mux)->doctype = GST_MATROSKA_DOCTYPE_WEBM;
100 GST_MATROSKA_MUX (mux)->is_webm = TRUE;
101 }
102