1 /* Quicktime muxer plugin for GStreamer
2 * Copyright (C) 2008-2010 Thiago Santos <thiagoss@embedded.ufcg.edu.br>
3 * Copyright (C) 2008 Mark Nauwelaerts <mnauw@users.sf.net>
4 * Copyright (C) 2010 Nokia Corporation. All rights reserved.
5 * Copyright (C) 2014 Jan Schmidt <jan@centricular.com>
6 * Contact: Stefan Kost <stefan.kost@nokia.com>
8 * This library is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU Library General Public
10 * License as published by the Free Software Foundation; either
11 * version 2 of the License, or (at your option) any later version.
13 * This library is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * Library General Public License for more details.
18 * You should have received a copy of the GNU Library General Public
19 * License along with this library; if not, write to the
20 * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
21 * Boston, MA 02110-1301, USA.
24 * Unless otherwise indicated, Source Code is licensed under MIT license.
25 * See further explanation attached in License Statement (distributed in the file
28 * Permission is hereby granted, free of charge, to any person obtaining a copy of
29 * this software and associated documentation files (the "Software"), to deal in
30 * the Software without restriction, including without limitation the rights to
31 * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
32 * of the Software, and to permit persons to whom the Software is furnished to do
33 * so, subject to the following conditions:
35 * The above copyright notice and this permission notice shall be included in all
36 * copies or substantial portions of the Software.
38 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
39 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
40 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
41 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
42 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
43 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
49 * SECTION:element-qtmux
50 * @short_description: Muxer for quicktime(.mov) files
52 * This element merges streams (audio and video) into QuickTime(.mov) files.
54 * The following background intends to explain why various similar muxers
55 * are present in this plugin.
57 * The <ulink url="http://www.apple.com/quicktime/resources/qtfileformat.pdf">
58 * QuickTime file format specification</ulink> served as basis for the MP4 file
59 * format specification (mp4mux), and as such the QuickTime file structure is
60 * nearly identical to the so-called ISO Base Media file format defined in
61 * ISO 14496-12 (except for some media specific parts).
62 * In turn, the latter ISO Base Media format was further specialized as a
63 * Motion JPEG-2000 file format in ISO 15444-3 (mj2mux)
64 * and in various 3GPP(2) specs (gppmux).
65 * The fragmented file features defined (only) in ISO Base Media are used by
66 * ISMV files making up (a.o.) Smooth Streaming (ismlmux).
68 * A few properties (#GstQTMux:movie-timescale, #GstQTMux:trak-timescale) allow
69 * adjusting some technical parameters, which might be useful in (rare) cases to
70 * resolve compatibility issues in some situations.
72 * Some other properties influence the result more fundamentally.
73 * A typical mov/mp4 file's metadata (aka moov) is located at the end of the
74 * file, somewhat contrary to this usually being called "the header".
75 * However, a #GstQTMux:faststart file will (with some effort) arrange this to
76 * be located near start of the file, which then allows it e.g. to be played
77 * while downloading. Alternatively, rather than having one chunk of metadata at
78 * start (or end), there can be some metadata at start and most of the other
79 * data can be spread out into fragments of #GstQTMux:fragment-duration.
80 * If such fragmented layout is intended for streaming purposes, then
81 * #GstQTMux:streamable allows foregoing to add index metadata (at the end of
84 * When the maximum duration to be recorded can be known in advance, #GstQTMux
85 * also supports a 'Robust Muxing' mode. In robust muxing mode, space for the
86 * headers are reserved at the start of muxing, and rewritten at a configurable
87 * interval, so that the output file is always playable, even if the recording
88 * is interrupted uncleanly by a crash. Robust muxing mode requires a seekable
89 * output, such as filesink, because it needs to rewrite the start of the file.
91 * To enable robust muxing mode, set the #GstQTMux::reserved-moov-update-period
92 * and #GstQTMux::reserved-max-duration property. Also present is the
93 * #GstQTMux::reserved-bytes-per-sec property, which can be increased if
94 * for some reason the default is not large enough and the initial reserved
95 * space for headers is too small. Applications can monitor the
96 * #GstQTMux::reserved-duration-remaining property to see how close to full
97 * the reserved space is becoming.
100 * <title>Example pipelines</title>
102 * gst-launch-1.0 v4l2src num-buffers=500 ! video/x-raw,width=320,height=240 ! videoconvert ! qtmux ! filesink location=video.mov
104 * Records a video stream captured from a v4l2 device and muxes it into a qt file.
116 #include <glib/gstdio.h>
119 #include <gst/base/gstcollectpads.h>
120 #include <gst/base/gstbytereader.h>
121 #include <gst/base/gstbitreader.h>
122 #include <gst/audio/audio.h>
123 #include <gst/video/video.h>
124 #include <gst/tag/tag.h>
125 #include <gst/pbutils/pbutils.h>
127 #include <sys/types.h>
129 #include <io.h> /* lseek, open, close, read */
131 #define lseek _lseeki64
133 #define off_t guint64
137 #define ftruncate g_win32_ftruncate
144 #include "gstqtmux.h"
146 GST_DEBUG_CATEGORY_STATIC (gst_qt_mux_debug);
147 #define GST_CAT_DEFAULT gst_qt_mux_debug
151 * The basic building blocks of MP4 files are:
152 * - an 'ftyp' box at the very start
153 * - an 'mdat' box which contains the raw audio/video/subtitle data;
154 * this is just a bunch of bytes, completely unframed and possibly
155 * unordered with no additional meta-information
156 * - a 'moov' box that contains information about the different streams
157 * and what they contain, as well as sample tables for each stream
158 * that tell the demuxer where in the mdat box each buffer/sample is
159 * and what its duration/timestamp etc. is, and whether it's a
161 * Additionally, fragmented MP4 works by writing chunks of data in
162 * pairs of 'moof' and 'mdat' boxes:
163 * - 'moof' boxes, header preceding each mdat fragment describing the
164 * contents, like a moov but only for that fragment.
165 * - a 'mfra' box for Fragmented MP4, which is written at the end and
166 * contains a summary of all fragments and seek tables.
168 * Currently mp4mux can work in 4 different modes / generate 4 types
169 * of output files/streams:
171 * - Normal mp4: mp4mux will write a little ftyp identifier at the
172 * beginning, then start an mdat box into which it will write all the
173 * sample data. At EOS it will then write the moov header with track
174 * headers and sample tables at the end of the file, and rewrite the
175 * start of the file to fix up the mdat box size at the beginning.
176 * It has to wait for EOS to write the moov (which includes the
177 * sample tables) because it doesn't know how much space those
178 * tables will be. The output downstream must be seekable to rewrite
179 * the mdat box at EOS.
181 * - Fragmented mp4: moov header with track headers at start
182 * but no sample table, followed by N fragments, each containing
183 * track headers with sample tables followed by some data. Downstream
184 * does not need to be seekable if the 'streamable' flag is TRUE,
185 * as the final mfra and total duration will be omitted.
187 * - Fast-start mp4: the goal here is to create a file where the moov
188 * headers are at the beginning; what mp4mux will do is write all
189 * sample data into a temp file and build moov header plus sample
190 * tables in memory and then when EOS comes, it will push out the
191 * moov header plus sample tables at the beginning, followed by the
192 * mdat sample data at the end which is read in from the temp file
193 * Files created in this mode are better for streaming over the
194 * network, since the client doesn't have to seek to the end of the
195 * file to get the headers, but it requires copying all sample data
196 * out of the temp file at EOS, which can be expensive. Downstream does
197 * not need to be seekable, because of the use of the temp file.
199 * - Robust Muxing mode: In this mode, qtmux uses the reserved-max-duration
200 * and reserved-moov-update-period properties to reserve free space
201 * at the start of the file and periodically write the MOOV atom out
202 * to it. That means that killing the muxing at any point still
203 * results in a playable file, at the cost of wasting some amount of
204 * free space at the start of file. The approximate recording duration
205 * has to be known in advance to estimate how much free space to reserve
206 * for the moov, and the downstream must be seekable.
207 * If the moov header grows larger than the reserved space, an error
208 * is generated - so it's better to over-estimate the amount of space
209 * to reserve. To ensure the file is playable at any point, the moov
210 * is updated using a 'ping-pong' strategy, so the output is never in
214 #ifndef GST_REMOVE_DEPRECATED
223 gst_qt_mux_dts_method_get_type (void)
225 static GType gst_qt_mux_dts_method = 0;
227 if (!gst_qt_mux_dts_method) {
228 static const GEnumValue dts_methods[] = {
229 {DTS_METHOD_DD, "delta/duration", "dd"},
230 {DTS_METHOD_REORDER, "reorder", "reorder"},
231 {DTS_METHOD_ASC, "ascending", "asc"},
235 gst_qt_mux_dts_method =
236 g_enum_register_static ("GstQTMuxDtsMethods", dts_methods);
239 return gst_qt_mux_dts_method;
242 #define GST_TYPE_QT_MUX_DTS_METHOD \
243 (gst_qt_mux_dts_method_get_type ())
246 /* QTMux signals and args */
256 PROP_MOVIE_TIMESCALE,
259 PROP_FAST_START_TEMP_FILE,
260 PROP_MOOV_RECOV_FILE,
261 PROP_FRAGMENT_DURATION,
263 PROP_RESERVED_MAX_DURATION,
264 PROP_RESERVED_DURATION_REMAINING,
265 PROP_RESERVED_MOOV_UPDATE_PERIOD,
266 PROP_RESERVED_BYTES_PER_SEC,
267 #ifndef GST_REMOVE_DEPRECATED
271 PROP_INTERLEAVE_BYTES,
272 PROP_INTERLEAVE_TIME,
275 /* some spare for header size as well */
276 #define MDAT_LARGE_FILE_LIMIT ((guint64) 1024 * 1024 * 1024 * 2)
278 #define DEFAULT_MOVIE_TIMESCALE 0
279 #define DEFAULT_TRAK_TIMESCALE 0
280 #define DEFAULT_DO_CTTS TRUE
281 #define DEFAULT_FAST_START FALSE
282 #define DEFAULT_FAST_START_TEMP_FILE NULL
283 #define DEFAULT_MOOV_RECOV_FILE NULL
284 #define DEFAULT_FRAGMENT_DURATION 0
285 #define DEFAULT_STREAMABLE TRUE
286 #ifndef GST_REMOVE_DEPRECATED
287 #define DEFAULT_DTS_METHOD DTS_METHOD_REORDER
289 #define DEFAULT_RESERVED_MAX_DURATION GST_CLOCK_TIME_NONE
290 #define DEFAULT_RESERVED_MOOV_UPDATE_PERIOD GST_CLOCK_TIME_NONE
291 #define DEFAULT_RESERVED_BYTES_PER_SEC_PER_TRAK 550
292 #define DEFAULT_INTERLEAVE_BYTES 0
293 #define DEFAULT_INTERLEAVE_TIME 250*GST_MSECOND
295 static void gst_qt_mux_finalize (GObject * object);
297 static GstStateChangeReturn gst_qt_mux_change_state (GstElement * element,
298 GstStateChange transition);
300 /* property functions */
301 static void gst_qt_mux_set_property (GObject * object,
302 guint prop_id, const GValue * value, GParamSpec * pspec);
303 static void gst_qt_mux_get_property (GObject * object,
304 guint prop_id, GValue * value, GParamSpec * pspec);
307 static GstPad *gst_qt_mux_request_new_pad (GstElement * element,
308 GstPadTemplate * templ, const gchar * name, const GstCaps * caps);
309 static void gst_qt_mux_release_pad (GstElement * element, GstPad * pad);
312 static gboolean gst_qt_mux_sink_event (GstCollectPads * pads,
313 GstCollectData * data, GstEvent * event, gpointer user_data);
315 static GstFlowReturn gst_qt_mux_collected (GstCollectPads * pads,
317 static GstFlowReturn gst_qt_mux_add_buffer (GstQTMux * qtmux, GstQTPad * pad,
321 gst_qt_mux_robust_recording_rewrite_moov (GstQTMux * qtmux);
323 static GstElementClass *parent_class = NULL;
326 gst_qt_mux_base_init (gpointer g_class)
328 GstElementClass *element_class = GST_ELEMENT_CLASS (g_class);
329 GstQTMuxClass *klass = (GstQTMuxClass *) g_class;
330 GstQTMuxClassParams *params;
331 GstPadTemplate *videosinktempl, *audiosinktempl, *subtitlesinktempl;
332 GstPadTemplate *srctempl;
333 gchar *longname, *description;
336 (GstQTMuxClassParams *) g_type_get_qdata (G_OBJECT_CLASS_TYPE (g_class),
337 GST_QT_MUX_PARAMS_QDATA);
338 g_assert (params != NULL);
340 /* construct the element details struct */
341 longname = g_strdup_printf ("%s Muxer", params->prop->long_name);
342 description = g_strdup_printf ("Multiplex audio and video into a %s file",
343 params->prop->long_name);
344 gst_element_class_set_static_metadata (element_class, longname,
345 "Codec/Muxer", description,
346 "Thiago Sousa Santos <thiagoss@embedded.ufcg.edu.br>");
348 g_free (description);
351 srctempl = gst_pad_template_new ("src", GST_PAD_SRC,
352 GST_PAD_ALWAYS, params->src_caps);
353 gst_element_class_add_pad_template (element_class, srctempl);
355 if (params->audio_sink_caps) {
356 audiosinktempl = gst_pad_template_new ("audio_%u",
357 GST_PAD_SINK, GST_PAD_REQUEST, params->audio_sink_caps);
358 gst_element_class_add_pad_template (element_class, audiosinktempl);
361 if (params->video_sink_caps) {
362 videosinktempl = gst_pad_template_new ("video_%u",
363 GST_PAD_SINK, GST_PAD_REQUEST, params->video_sink_caps);
364 gst_element_class_add_pad_template (element_class, videosinktempl);
367 if (params->subtitle_sink_caps) {
368 subtitlesinktempl = gst_pad_template_new ("subtitle_%u",
369 GST_PAD_SINK, GST_PAD_REQUEST, params->subtitle_sink_caps);
370 gst_element_class_add_pad_template (element_class, subtitlesinktempl);
373 klass->format = params->prop->format;
377 gst_qt_mux_class_init (GstQTMuxClass * klass)
379 GObjectClass *gobject_class;
380 GstElementClass *gstelement_class;
381 GParamFlags streamable_flags;
382 const gchar *streamable_desc;
384 #define STREAMABLE_DESC "If set to true, the output should be as if it is to "\
385 "be streamed and hence no indexes written or duration written."
387 gobject_class = (GObjectClass *) klass;
388 gstelement_class = (GstElementClass *) klass;
390 parent_class = g_type_class_peek_parent (klass);
392 gobject_class->finalize = gst_qt_mux_finalize;
393 gobject_class->get_property = gst_qt_mux_get_property;
394 gobject_class->set_property = gst_qt_mux_set_property;
396 streamable_flags = G_PARAM_READWRITE | G_PARAM_CONSTRUCT;
397 if (klass->format == GST_QT_MUX_FORMAT_ISML) {
398 streamable_desc = STREAMABLE_DESC;
399 streamable = DEFAULT_STREAMABLE;
402 STREAMABLE_DESC " (DEPRECATED, only valid for fragmented MP4)";
403 streamable_flags |= G_PARAM_DEPRECATED;
407 g_object_class_install_property (gobject_class, PROP_MOVIE_TIMESCALE,
408 g_param_spec_uint ("movie-timescale", "Movie timescale",
409 "Timescale to use in the movie (units per second, 0 == default)",
410 0, G_MAXUINT32, DEFAULT_MOVIE_TIMESCALE,
411 G_PARAM_READWRITE | G_PARAM_CONSTRUCT | G_PARAM_STATIC_STRINGS));
412 g_object_class_install_property (gobject_class, PROP_TRAK_TIMESCALE,
413 g_param_spec_uint ("trak-timescale", "Track timescale",
414 "Timescale to use for the tracks (units per second, 0 is automatic)",
415 0, G_MAXUINT32, DEFAULT_TRAK_TIMESCALE,
416 G_PARAM_READWRITE | G_PARAM_CONSTRUCT | G_PARAM_STATIC_STRINGS));
417 g_object_class_install_property (gobject_class, PROP_DO_CTTS,
418 g_param_spec_boolean ("presentation-time",
419 "Include presentation-time info",
420 "Calculate and include presentation/composition time "
421 "(in addition to decoding time)", DEFAULT_DO_CTTS,
422 G_PARAM_READWRITE | G_PARAM_CONSTRUCT | G_PARAM_STATIC_STRINGS));
423 #ifndef GST_REMOVE_DEPRECATED
424 g_object_class_install_property (gobject_class, PROP_DTS_METHOD,
425 g_param_spec_enum ("dts-method", "dts-method",
426 "Method to determine DTS time (DEPRECATED)",
427 GST_TYPE_QT_MUX_DTS_METHOD, DEFAULT_DTS_METHOD,
428 G_PARAM_DEPRECATED | G_PARAM_READWRITE | G_PARAM_CONSTRUCT |
429 G_PARAM_STATIC_STRINGS));
431 g_object_class_install_property (gobject_class, PROP_FAST_START,
432 g_param_spec_boolean ("faststart", "Format file to faststart",
433 "If the file should be formatted for faststart (headers first)",
434 DEFAULT_FAST_START, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
435 g_object_class_install_property (gobject_class, PROP_FAST_START_TEMP_FILE,
436 g_param_spec_string ("faststart-file", "File to use for storing buffers",
437 "File that will be used temporarily to store data from the stream "
438 "when creating a faststart file. If null a filepath will be "
439 "created automatically", DEFAULT_FAST_START_TEMP_FILE,
440 G_PARAM_READWRITE | G_PARAM_CONSTRUCT | G_PARAM_STATIC_STRINGS));
441 g_object_class_install_property (gobject_class, PROP_MOOV_RECOV_FILE,
442 g_param_spec_string ("moov-recovery-file",
443 "File to store data for posterior moov atom recovery",
444 "File to be used to store "
445 "data for moov atom making movie file recovery possible in case "
446 "of a crash during muxing. Null for disabled. (Experimental)",
447 DEFAULT_MOOV_RECOV_FILE,
448 G_PARAM_READWRITE | G_PARAM_CONSTRUCT | G_PARAM_STATIC_STRINGS));
449 g_object_class_install_property (gobject_class, PROP_FRAGMENT_DURATION,
450 g_param_spec_uint ("fragment-duration", "Fragment duration",
451 "Fragment durations in ms (produce a fragmented file if > 0)",
452 0, G_MAXUINT32, klass->format == GST_QT_MUX_FORMAT_ISML ?
453 2000 : DEFAULT_FRAGMENT_DURATION,
454 G_PARAM_READWRITE | G_PARAM_CONSTRUCT | G_PARAM_STATIC_STRINGS));
455 g_object_class_install_property (gobject_class, PROP_STREAMABLE,
456 g_param_spec_boolean ("streamable", "Streamable", streamable_desc,
457 streamable, streamable_flags | G_PARAM_STATIC_STRINGS));
458 g_object_class_install_property (gobject_class, PROP_RESERVED_MAX_DURATION,
459 g_param_spec_uint64 ("reserved-max-duration",
460 "Reserved maximum file duration (ns)",
461 "When set to a value > 0, reserves space for index tables at the "
462 "beginning of the file.",
463 0, G_MAXUINT64, DEFAULT_RESERVED_MAX_DURATION,
464 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
465 g_object_class_install_property (gobject_class,
466 PROP_RESERVED_DURATION_REMAINING,
467 g_param_spec_uint64 ("reserved-duration-remaining",
468 "Report the approximate amount of remaining recording space (ns)",
469 "Reports the approximate amount of remaining moov header space "
470 "reserved using reserved-max-duration", 0, G_MAXUINT64, 0,
471 G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
472 g_object_class_install_property (gobject_class,
473 PROP_RESERVED_MOOV_UPDATE_PERIOD,
474 g_param_spec_uint64 ("reserved-moov-update-period",
475 "Interval at which to update index tables (ns)",
476 "When used with reserved-max-duration, periodically updates the "
477 "index tables with information muxed so far.", 0, G_MAXUINT64,
478 DEFAULT_RESERVED_MOOV_UPDATE_PERIOD,
479 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
480 g_object_class_install_property (gobject_class, PROP_RESERVED_BYTES_PER_SEC,
481 g_param_spec_uint ("reserved-bytes-per-sec",
482 "Reserved MOOV bytes per second, per track",
483 "Multiplier for converting reserved-max-duration into bytes of header to reserve, per second, per track",
484 0, 10000, DEFAULT_RESERVED_BYTES_PER_SEC_PER_TRAK,
485 G_PARAM_READWRITE | G_PARAM_CONSTRUCT | G_PARAM_STATIC_STRINGS));
486 g_object_class_install_property (gobject_class, PROP_INTERLEAVE_BYTES,
487 g_param_spec_uint64 ("interleave-bytes", "Interleave (bytes)",
488 "Interleave between streams in bytes",
489 0, G_MAXUINT64, DEFAULT_INTERLEAVE_BYTES,
490 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
491 g_object_class_install_property (gobject_class, PROP_INTERLEAVE_TIME,
492 g_param_spec_uint64 ("interleave-time", "Interleave (time)",
493 "Interleave between streams in nanoseconds",
494 0, G_MAXUINT64, DEFAULT_INTERLEAVE_TIME,
495 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
497 gstelement_class->request_new_pad =
498 GST_DEBUG_FUNCPTR (gst_qt_mux_request_new_pad);
499 gstelement_class->change_state = GST_DEBUG_FUNCPTR (gst_qt_mux_change_state);
500 gstelement_class->release_pad = GST_DEBUG_FUNCPTR (gst_qt_mux_release_pad);
504 gst_qt_mux_pad_reset (GstQTPad * qtpad)
507 qtpad->is_out_of_order = FALSE;
508 qtpad->sample_size = 0;
511 qtpad->dts_adjustment = GST_CLOCK_TIME_NONE;
512 qtpad->first_ts = GST_CLOCK_TIME_NONE;
513 qtpad->first_dts = GST_CLOCK_TIME_NONE;
514 qtpad->prepare_buf_func = NULL;
515 qtpad->create_empty_buffer = NULL;
516 qtpad->avg_bitrate = 0;
517 qtpad->max_bitrate = 0;
518 qtpad->total_duration = 0;
519 qtpad->total_bytes = 0;
520 qtpad->sparse = FALSE;
522 gst_buffer_replace (&qtpad->last_buf, NULL);
525 gst_tag_list_unref (qtpad->tags);
529 /* reference owned elsewhere */
531 qtpad->tc_trak = NULL;
534 atom_traf_free (qtpad->traf);
537 atom_array_clear (&qtpad->fragment_buffers);
539 /* reference owned elsewhere */
542 qtpad->first_pts = GST_CLOCK_TIME_NONE;
545 gst_video_time_code_free (qtpad->first_tc);
546 qtpad->first_tc = NULL;
550 * Takes GstQTMux back to its initial state
553 gst_qt_mux_reset (GstQTMux * qtmux, gboolean alloc)
557 qtmux->state = GST_QT_MUX_STATE_NONE;
558 qtmux->header_size = 0;
559 qtmux->mdat_size = 0;
562 qtmux->longest_chunk = GST_CLOCK_TIME_NONE;
563 qtmux->fragment_sequence = 0;
566 atom_ftyp_free (qtmux->ftyp);
570 atom_moov_free (qtmux->moov);
574 atom_mfra_free (qtmux->mfra);
577 if (qtmux->fast_start_file) {
578 fclose (qtmux->fast_start_file);
579 g_remove (qtmux->fast_start_file_path);
580 qtmux->fast_start_file = NULL;
582 if (qtmux->moov_recov_file) {
583 fclose (qtmux->moov_recov_file);
584 qtmux->moov_recov_file = NULL;
586 for (walk = qtmux->extra_atoms; walk; walk = g_slist_next (walk)) {
587 AtomInfo *ainfo = (AtomInfo *) walk->data;
588 ainfo->free_func (ainfo->atom);
591 g_slist_free (qtmux->extra_atoms);
592 qtmux->extra_atoms = NULL;
594 GST_OBJECT_LOCK (qtmux);
595 gst_tag_setter_reset_tags (GST_TAG_SETTER (qtmux));
596 GST_OBJECT_UNLOCK (qtmux);
599 for (walk = qtmux->sinkpads; walk; walk = g_slist_next (walk)) {
600 GstQTPad *qtpad = (GstQTPad *) walk->data;
601 gst_qt_mux_pad_reset (qtpad);
603 /* hm, moov_free above yanked the traks away from us,
604 * so do not free, but do clear */
609 qtmux->moov = atom_moov_new (qtmux->context);
610 /* ensure all is as nice and fresh as request_new_pad would provide it */
611 for (walk = qtmux->sinkpads; walk; walk = g_slist_next (walk)) {
612 GstQTPad *qtpad = (GstQTPad *) walk->data;
614 qtpad->trak = atom_trak_new (qtmux->context);
615 atom_moov_add_trak (qtmux->moov, qtpad->trak);
619 qtmux->current_pad = NULL;
620 qtmux->current_chunk_size = 0;
621 qtmux->current_chunk_duration = 0;
622 qtmux->current_chunk_offset = -1;
624 qtmux->reserved_moov_size = 0;
625 qtmux->last_moov_update = GST_CLOCK_TIME_NONE;
626 qtmux->muxed_since_last_update = 0;
627 qtmux->reserved_duration_remaining = GST_CLOCK_TIME_NONE;
631 gst_qt_mux_init (GstQTMux * qtmux, GstQTMuxClass * qtmux_klass)
633 GstElementClass *klass = GST_ELEMENT_CLASS (qtmux_klass);
634 GstPadTemplate *templ;
636 templ = gst_element_class_get_pad_template (klass, "src");
637 qtmux->srcpad = gst_pad_new_from_template (templ, "src");
638 gst_pad_use_fixed_caps (qtmux->srcpad);
639 gst_element_add_pad (GST_ELEMENT (qtmux), qtmux->srcpad);
641 qtmux->sinkpads = NULL;
642 qtmux->collect = gst_collect_pads_new ();
643 gst_collect_pads_set_event_function (qtmux->collect,
644 GST_DEBUG_FUNCPTR (gst_qt_mux_sink_event), qtmux);
645 gst_collect_pads_set_clip_function (qtmux->collect,
646 GST_DEBUG_FUNCPTR (gst_collect_pads_clip_running_time), qtmux);
647 gst_collect_pads_set_function (qtmux->collect,
648 GST_DEBUG_FUNCPTR (gst_qt_mux_collected), qtmux);
650 /* properties set to default upon construction */
652 qtmux->reserved_max_duration = DEFAULT_RESERVED_MAX_DURATION;
653 qtmux->reserved_moov_update_period = DEFAULT_RESERVED_MOOV_UPDATE_PERIOD;
654 qtmux->reserved_bytes_per_sec_per_trak =
655 DEFAULT_RESERVED_BYTES_PER_SEC_PER_TRAK;
656 qtmux->interleave_bytes = DEFAULT_INTERLEAVE_BYTES;
657 qtmux->interleave_time = DEFAULT_INTERLEAVE_TIME;
659 /* always need this */
661 atoms_context_new (gst_qt_mux_map_format_to_flavor (qtmux_klass->format));
663 /* internals to initial state */
664 gst_qt_mux_reset (qtmux, TRUE);
669 gst_qt_mux_finalize (GObject * object)
671 GstQTMux *qtmux = GST_QT_MUX_CAST (object);
673 gst_qt_mux_reset (qtmux, FALSE);
675 g_free (qtmux->fast_start_file_path);
676 g_free (qtmux->moov_recov_file_path);
678 atoms_context_free (qtmux->context);
679 gst_object_unref (qtmux->collect);
681 g_slist_free (qtmux->sinkpads);
683 G_OBJECT_CLASS (parent_class)->finalize (object);
687 gst_qt_mux_prepare_jpc_buffer (GstQTPad * qtpad, GstBuffer * buf,
694 GST_LOG_OBJECT (qtmux, "Preparing jpc buffer");
699 size = gst_buffer_get_size (buf);
700 newbuf = gst_buffer_new_and_alloc (size + 8);
701 gst_buffer_copy_into (newbuf, buf, GST_BUFFER_COPY_ALL, 8, size);
703 gst_buffer_map (newbuf, &map, GST_MAP_WRITE);
704 GST_WRITE_UINT32_BE (map.data, map.size);
705 GST_WRITE_UINT32_LE (map.data + 4, FOURCC_jp2c);
707 gst_buffer_unmap (buf, &map);
708 gst_buffer_unref (buf);
714 gst_qt_mux_prepare_tx3g_buffer (GstQTPad * qtpad, GstBuffer * buf,
721 const guint8 *dataend;
723 GST_LOG_OBJECT (qtmux, "Preparing tx3g buffer %" GST_PTR_FORMAT, buf);
728 gst_buffer_map (buf, &frommap, GST_MAP_READ);
730 dataend = memchr (frommap.data, 0, frommap.size);
731 size = dataend ? dataend - frommap.data : frommap.size;
732 newbuf = gst_buffer_new_and_alloc (size + 2);
734 gst_buffer_map (newbuf, &tomap, GST_MAP_WRITE);
736 GST_WRITE_UINT16_BE (tomap.data, size);
737 memcpy (tomap.data + 2, frommap.data, size);
739 gst_buffer_unmap (newbuf, &tomap);
740 gst_buffer_unmap (buf, &frommap);
742 gst_buffer_copy_into (newbuf, buf, GST_BUFFER_COPY_METADATA, 0, size);
744 /* gst_buffer_copy_into is trying to be too clever and
745 * won't copy duration when size is different */
746 GST_BUFFER_DURATION (newbuf) = GST_BUFFER_DURATION (buf);
748 gst_buffer_unref (buf);
754 gst_qt_mux_pad_add_ac3_extension (GstQTMux * qtmux, GstQTPad * qtpad,
755 guint8 fscod, guint8 frmsizcod, guint8 bsid, guint8 bsmod, guint8 acmod,
760 g_return_if_fail (qtpad->trak_ste);
762 ext = build_ac3_extension (fscod, bsid, bsmod, acmod, lfe_on, frmsizcod >> 1); /* bitrate_code is inside frmsizcod */
764 sample_table_entry_add_ext_atom (qtpad->trak_ste, ext);
768 gst_qt_mux_prepare_parse_ac3_frame (GstQTPad * qtpad, GstBuffer * buf,
772 GstByteReader reader;
775 if (!gst_buffer_map (buf, &map, GST_MAP_READ)) {
776 GST_WARNING_OBJECT (qtpad->collect.pad, "Failed to map buffer");
780 if (G_UNLIKELY (map.size < 8))
783 gst_byte_reader_init (&reader, map.data, map.size);
784 off = gst_byte_reader_masked_scan_uint32 (&reader, 0xffff0000, 0x0b770000,
789 guint8 fscod, frmsizcod, bsid, bsmod, acmod, lfe_on;
791 GST_DEBUG_OBJECT (qtpad->collect.pad, "Found ac3 sync point at offset: %u",
794 gst_bit_reader_init (&bits, map.data, map.size);
796 /* off + sync + crc */
797 gst_bit_reader_skip_unchecked (&bits, off * 8 + 16 + 16);
799 fscod = gst_bit_reader_get_bits_uint8_unchecked (&bits, 2);
800 frmsizcod = gst_bit_reader_get_bits_uint8_unchecked (&bits, 6);
801 bsid = gst_bit_reader_get_bits_uint8_unchecked (&bits, 5);
802 bsmod = gst_bit_reader_get_bits_uint8_unchecked (&bits, 3);
803 acmod = gst_bit_reader_get_bits_uint8_unchecked (&bits, 3);
805 if ((acmod & 0x1) && (acmod != 0x1)) /* 3 front channels */
806 gst_bit_reader_skip_unchecked (&bits, 2);
807 if ((acmod & 0x4)) /* if a surround channel exists */
808 gst_bit_reader_skip_unchecked (&bits, 2);
809 if (acmod == 0x2) /* if in 2/0 mode */
810 gst_bit_reader_skip_unchecked (&bits, 2);
812 lfe_on = gst_bit_reader_get_bits_uint8_unchecked (&bits, 1);
814 gst_qt_mux_pad_add_ac3_extension (qtmux, qtpad, fscod, frmsizcod, bsid,
815 bsmod, acmod, lfe_on);
817 /* AC-3 spec says that those values should be constant for the
818 * whole stream when muxed in mp4. We trust the input follows it */
819 GST_DEBUG_OBJECT (qtpad->collect.pad, "Data parsed, removing "
820 "prepare buffer function");
821 qtpad->prepare_buf_func = NULL;
825 gst_buffer_unmap (buf, &map);
830 gst_qt_mux_create_empty_tx3g_buffer (GstQTPad * qtpad, gint64 duration)
835 GST_WRITE_UINT16_BE (data, 0);
837 return gst_buffer_new_wrapped (data, 2);
841 gst_qt_mux_add_mp4_tag (GstQTMux * qtmux, const GstTagList * list,
842 AtomUDTA * udta, const char *tag, const char *tag2, guint32 fourcc)
844 switch (gst_tag_get_type (tag)) {
850 if (!gst_tag_list_get_string (list, tag, &str) || !str)
852 GST_DEBUG_OBJECT (qtmux, "Adding tag %" GST_FOURCC_FORMAT " -> %s",
853 GST_FOURCC_ARGS (fourcc), str);
854 atom_udta_add_str_tag (udta, fourcc, str);
863 if (!gst_tag_list_get_double (list, tag, &value))
865 GST_DEBUG_OBJECT (qtmux, "Adding tag %" GST_FOURCC_FORMAT " -> %u",
866 GST_FOURCC_ARGS (fourcc), (gint) value);
867 atom_udta_add_uint_tag (udta, fourcc, 21, (gint) value);
874 /* paired unsigned integers */
878 got_tag = gst_tag_list_get_uint (list, tag, &value);
879 got_tag = gst_tag_list_get_uint (list, tag2, &count) || got_tag;
882 GST_DEBUG_OBJECT (qtmux, "Adding tag %" GST_FOURCC_FORMAT " -> %u/%u",
883 GST_FOURCC_ARGS (fourcc), value, count);
884 atom_udta_add_uint_tag (udta, fourcc, 0,
885 value << 16 | (count & 0xFFFF));
887 /* unpaired unsigned integers */
888 if (!gst_tag_list_get_uint (list, tag, &value))
890 GST_DEBUG_OBJECT (qtmux, "Adding tag %" GST_FOURCC_FORMAT " -> %u",
891 GST_FOURCC_ARGS (fourcc), value);
892 atom_udta_add_uint_tag (udta, fourcc, 1, value);
897 g_assert_not_reached ();
903 gst_qt_mux_add_mp4_date (GstQTMux * qtmux, const GstTagList * list,
904 AtomUDTA * udta, const char *tag, const char *tag2, guint32 fourcc)
912 g_return_if_fail (gst_tag_get_type (tag) == G_TYPE_DATE);
914 if (!gst_tag_list_get_date (list, tag, &date) || !date)
917 year = g_date_get_year (date);
918 month = g_date_get_month (date);
919 day = g_date_get_day (date);
923 if (year == G_DATE_BAD_YEAR && month == G_DATE_BAD_MONTH &&
924 day == G_DATE_BAD_DAY) {
925 GST_WARNING_OBJECT (qtmux, "invalid date in tag");
929 str = g_strdup_printf ("%u-%u-%u", year, month, day);
930 GST_DEBUG_OBJECT (qtmux, "Adding tag %" GST_FOURCC_FORMAT " -> %s",
931 GST_FOURCC_ARGS (fourcc), str);
932 atom_udta_add_str_tag (udta, fourcc, str);
937 gst_qt_mux_add_mp4_cover (GstQTMux * qtmux, const GstTagList * list,
938 AtomUDTA * udta, const char *tag, const char *tag2, guint32 fourcc)
940 GValue value = { 0, };
944 GstStructure *structure;
948 g_return_if_fail (gst_tag_get_type (tag) == GST_TYPE_SAMPLE);
950 if (!gst_tag_list_copy_value (&value, list, tag))
953 sample = gst_value_get_sample (&value);
958 buf = gst_sample_get_buffer (sample);
962 caps = gst_sample_get_caps (sample);
964 GST_WARNING_OBJECT (qtmux, "preview image without caps");
968 GST_DEBUG_OBJECT (qtmux, "preview image caps %" GST_PTR_FORMAT, caps);
970 structure = gst_caps_get_structure (caps, 0);
971 if (gst_structure_has_name (structure, "image/jpeg"))
973 else if (gst_structure_has_name (structure, "image/png"))
977 GST_WARNING_OBJECT (qtmux, "preview image format not supported");
981 gst_buffer_map (buf, &map, GST_MAP_READ);
982 GST_DEBUG_OBJECT (qtmux, "Adding tag %" GST_FOURCC_FORMAT
983 " -> image size %" G_GSIZE_FORMAT "", GST_FOURCC_ARGS (fourcc), map.size);
984 atom_udta_add_tag (udta, fourcc, flags, map.data, map.size);
985 gst_buffer_unmap (buf, &map);
987 g_value_unset (&value);
991 gst_qt_mux_add_3gp_str (GstQTMux * qtmux, const GstTagList * list,
992 AtomUDTA * udta, const char *tag, const char *tag2, guint32 fourcc)
997 g_return_if_fail (gst_tag_get_type (tag) == G_TYPE_STRING);
998 g_return_if_fail (!tag2 || gst_tag_get_type (tag2) == G_TYPE_UINT);
1000 if (!gst_tag_list_get_string (list, tag, &str) || !str)
1004 if (!gst_tag_list_get_uint (list, tag2, &number))
1008 GST_DEBUG_OBJECT (qtmux, "Adding tag %" GST_FOURCC_FORMAT " -> %s",
1009 GST_FOURCC_ARGS (fourcc), str);
1010 atom_udta_add_3gp_str_tag (udta, fourcc, str);
1012 GST_DEBUG_OBJECT (qtmux, "Adding tag %" GST_FOURCC_FORMAT " -> %s/%d",
1013 GST_FOURCC_ARGS (fourcc), str, number);
1014 atom_udta_add_3gp_str_int_tag (udta, fourcc, str, number);
1021 gst_qt_mux_add_3gp_date (GstQTMux * qtmux, const GstTagList * list,
1022 AtomUDTA * udta, const char *tag, const char *tag2, guint32 fourcc)
1027 g_return_if_fail (gst_tag_get_type (tag) == G_TYPE_DATE);
1029 if (!gst_tag_list_get_date (list, tag, &date) || !date)
1032 year = g_date_get_year (date);
1035 if (year == G_DATE_BAD_YEAR) {
1036 GST_WARNING_OBJECT (qtmux, "invalid date in tag");
1040 GST_DEBUG_OBJECT (qtmux, "Adding tag %" GST_FOURCC_FORMAT " -> %d",
1041 GST_FOURCC_ARGS (fourcc), year);
1042 atom_udta_add_3gp_uint_tag (udta, fourcc, year);
1046 gst_qt_mux_add_3gp_location (GstQTMux * qtmux, const GstTagList * list,
1047 AtomUDTA * udta, const char *tag, const char *tag2, guint32 fourcc)
1049 gdouble latitude = -360, longitude = -360, altitude = 0;
1050 gchar *location = NULL;
1051 guint8 *data, *ddata;
1052 gint size = 0, len = 0;
1053 gboolean ret = FALSE;
1055 g_return_if_fail (strcmp (tag, GST_TAG_GEO_LOCATION_NAME) == 0);
1057 ret = gst_tag_list_get_string (list, tag, &location);
1058 ret |= gst_tag_list_get_double (list, GST_TAG_GEO_LOCATION_LONGITUDE,
1060 ret |= gst_tag_list_get_double (list, GST_TAG_GEO_LOCATION_LATITUDE,
1062 ret |= gst_tag_list_get_double (list, GST_TAG_GEO_LOCATION_ELEVATION,
1069 len = strlen (location);
1070 size += len + 1 + 2;
1072 /* role + (long, lat, alt) + body + notes */
1073 size += 1 + 3 * 4 + 1 + 1;
1075 data = ddata = g_malloc (size);
1078 GST_WRITE_UINT16_BE (data, language_code (GST_QT_MUX_DEFAULT_TAG_LANGUAGE));
1081 memcpy (data + 2, location, len);
1082 GST_WRITE_UINT8 (data + 2 + len, 0);
1083 data += len + 1 + 2;
1085 GST_WRITE_UINT8 (data, 0);
1086 /* long, lat, alt */
1087 #define QT_WRITE_SFP32(data, fp) GST_WRITE_UINT32_BE(data, (guint32) ((gint) (fp * 65536.0)))
1088 QT_WRITE_SFP32 (data + 1, longitude);
1089 QT_WRITE_SFP32 (data + 5, latitude);
1090 QT_WRITE_SFP32 (data + 9, altitude);
1091 /* neither astronomical body nor notes */
1092 GST_WRITE_UINT16_BE (data + 13, 0);
1094 GST_DEBUG_OBJECT (qtmux, "Adding tag 'loci'");
1095 atom_udta_add_3gp_tag (udta, fourcc, ddata, size);
1100 gst_qt_mux_add_3gp_keywords (GstQTMux * qtmux, const GstTagList * list,
1101 AtomUDTA * udta, const char *tag, const char *tag2, guint32 fourcc)
1103 gchar *keywords = NULL;
1104 guint8 *data, *ddata;
1108 g_return_if_fail (strcmp (tag, GST_TAG_KEYWORDS) == 0);
1110 if (!gst_tag_list_get_string (list, tag, &keywords) || !keywords)
1113 kwds = g_strsplit (keywords, ",", 0);
1117 for (i = 0; kwds[i]; i++) {
1118 /* size byte + null-terminator */
1119 size += strlen (kwds[i]) + 1 + 1;
1122 /* language tag + count + keywords */
1125 data = ddata = g_malloc (size);
1128 GST_WRITE_UINT16_BE (data, language_code (GST_QT_MUX_DEFAULT_TAG_LANGUAGE));
1130 GST_WRITE_UINT8 (data + 2, i);
1133 for (i = 0; kwds[i]; ++i) {
1134 gint len = strlen (kwds[i]);
1136 GST_DEBUG_OBJECT (qtmux, "Adding tag %" GST_FOURCC_FORMAT " -> %s",
1137 GST_FOURCC_ARGS (fourcc), kwds[i]);
1139 GST_WRITE_UINT8 (data, len + 1);
1140 memcpy (data + 1, kwds[i], len + 1);
1146 atom_udta_add_3gp_tag (udta, fourcc, ddata, size);
1151 gst_qt_mux_parse_classification_string (GstQTMux * qtmux, const gchar * input,
1152 guint32 * p_fourcc, guint16 * p_table, gchar ** p_content)
1160 size = strlen (input);
1162 if (size < 4 + 3 + 1 + 1 + 1) {
1163 /* at least the minimum xxxx://y/z */
1164 GST_WARNING_OBJECT (qtmux, "Classification tag input (%s) too short, "
1169 /* read the fourcc */
1170 memcpy (&fourcc, data, 4);
1174 if (strncmp (data, "://", 3) != 0) {
1180 /* read the table number */
1181 if (sscanf (data, "%d", &table) != 1) {
1185 GST_WARNING_OBJECT (qtmux, "Invalid table number in classification tag (%d)"
1186 ", table numbers should be positive, ignoring tag", table);
1190 /* find the next / */
1191 while (size > 0 && data[0] != '/') {
1198 g_assert (data[0] == '/');
1207 /* read up the rest of the string */
1208 *p_content = g_strdup (data);
1209 *p_table = (guint16) table;
1215 GST_WARNING_OBJECT (qtmux, "Ignoring classification tag as "
1216 "input (%s) didn't match the expected entitycode://table/content",
1223 gst_qt_mux_add_3gp_classification (GstQTMux * qtmux, const GstTagList * list,
1224 AtomUDTA * udta, const char *tag, const char *tag2, guint32 fourcc)
1226 gchar *clsf_data = NULL;
1230 gchar *content = NULL;
1233 g_return_if_fail (strcmp (tag, GST_TAG_3GP_CLASSIFICATION) == 0);
1235 if (!gst_tag_list_get_string (list, tag, &clsf_data) || !clsf_data)
1238 GST_DEBUG_OBJECT (qtmux, "Adding tag %" GST_FOURCC_FORMAT " -> %s",
1239 GST_FOURCC_ARGS (fourcc), clsf_data);
1241 /* parse the string, format is:
1242 * entityfourcc://table/content
1244 gst_qt_mux_parse_classification_string (qtmux, clsf_data, &entity, &table,
1248 size = strlen (content) + 1;
1250 /* now we have everything, build the atom
1251 * atom description is at 3GPP TS 26.244 V8.2.0 (2009-09) */
1252 data = g_malloc (4 + 2 + 2 + size);
1253 GST_WRITE_UINT32_LE (data, entity);
1254 GST_WRITE_UINT16_BE (data + 4, (guint16) table);
1255 GST_WRITE_UINT16_BE (data + 6, 0);
1256 memcpy (data + 8, content, size);
1259 atom_udta_add_3gp_tag (udta, fourcc, data, 4 + 2 + 2 + size);
1263 typedef void (*GstQTMuxAddUdtaTagFunc) (GstQTMux * mux,
1264 const GstTagList * list, AtomUDTA * udta, const char *tag,
1265 const char *tag2, guint32 fourcc);
1268 * Struct to record mappings from gstreamer tags to fourcc codes
1270 typedef struct _GstTagToFourcc
1273 const gchar *gsttag;
1274 const gchar *gsttag2;
1275 const GstQTMuxAddUdtaTagFunc func;
1278 /* tag list tags to fourcc matching */
1279 static const GstTagToFourcc tag_matches_mp4[] = {
1280 {FOURCC__alb, GST_TAG_ALBUM, NULL, gst_qt_mux_add_mp4_tag},
1281 {FOURCC_soal, GST_TAG_ALBUM_SORTNAME, NULL, gst_qt_mux_add_mp4_tag},
1282 {FOURCC__ART, GST_TAG_ARTIST, NULL, gst_qt_mux_add_mp4_tag},
1283 {FOURCC_soar, GST_TAG_ARTIST_SORTNAME, NULL, gst_qt_mux_add_mp4_tag},
1284 {FOURCC_aART, GST_TAG_ALBUM_ARTIST, NULL, gst_qt_mux_add_mp4_tag},
1285 {FOURCC_soaa, GST_TAG_ALBUM_ARTIST_SORTNAME, NULL, gst_qt_mux_add_mp4_tag},
1286 {FOURCC__swr, GST_TAG_APPLICATION_NAME, NULL, gst_qt_mux_add_mp4_tag},
1287 {FOURCC__cmt, GST_TAG_COMMENT, NULL, gst_qt_mux_add_mp4_tag},
1288 {FOURCC__wrt, GST_TAG_COMPOSER, NULL, gst_qt_mux_add_mp4_tag},
1289 {FOURCC_soco, GST_TAG_COMPOSER_SORTNAME, NULL, gst_qt_mux_add_mp4_tag},
1290 {FOURCC_tvsh, GST_TAG_SHOW_NAME, NULL, gst_qt_mux_add_mp4_tag},
1291 {FOURCC_sosn, GST_TAG_SHOW_SORTNAME, NULL, gst_qt_mux_add_mp4_tag},
1292 {FOURCC_tvsn, GST_TAG_SHOW_SEASON_NUMBER, NULL, gst_qt_mux_add_mp4_tag},
1293 {FOURCC_tves, GST_TAG_SHOW_EPISODE_NUMBER, NULL, gst_qt_mux_add_mp4_tag},
1294 {FOURCC__gen, GST_TAG_GENRE, NULL, gst_qt_mux_add_mp4_tag},
1295 {FOURCC__nam, GST_TAG_TITLE, NULL, gst_qt_mux_add_mp4_tag},
1296 {FOURCC_sonm, GST_TAG_TITLE_SORTNAME, NULL, gst_qt_mux_add_mp4_tag},
1297 {FOURCC_perf, GST_TAG_PERFORMER, NULL, gst_qt_mux_add_mp4_tag},
1298 {FOURCC__grp, GST_TAG_GROUPING, NULL, gst_qt_mux_add_mp4_tag},
1299 {FOURCC__des, GST_TAG_DESCRIPTION, NULL, gst_qt_mux_add_mp4_tag},
1300 {FOURCC__lyr, GST_TAG_LYRICS, NULL, gst_qt_mux_add_mp4_tag},
1301 {FOURCC__too, GST_TAG_ENCODER, NULL, gst_qt_mux_add_mp4_tag},
1302 {FOURCC_cprt, GST_TAG_COPYRIGHT, NULL, gst_qt_mux_add_mp4_tag},
1303 {FOURCC_keyw, GST_TAG_KEYWORDS, NULL, gst_qt_mux_add_mp4_tag},
1304 {FOURCC__day, GST_TAG_DATE, NULL, gst_qt_mux_add_mp4_date},
1305 {FOURCC_tmpo, GST_TAG_BEATS_PER_MINUTE, NULL, gst_qt_mux_add_mp4_tag},
1306 {FOURCC_trkn, GST_TAG_TRACK_NUMBER, GST_TAG_TRACK_COUNT,
1307 gst_qt_mux_add_mp4_tag},
1308 {FOURCC_disk, GST_TAG_ALBUM_VOLUME_NUMBER, GST_TAG_ALBUM_VOLUME_COUNT,
1309 gst_qt_mux_add_mp4_tag},
1310 {FOURCC_covr, GST_TAG_PREVIEW_IMAGE, NULL, gst_qt_mux_add_mp4_cover},
1311 {FOURCC_covr, GST_TAG_IMAGE, NULL, gst_qt_mux_add_mp4_cover},
1315 static const GstTagToFourcc tag_matches_3gp[] = {
1316 {FOURCC_titl, GST_TAG_TITLE, NULL, gst_qt_mux_add_3gp_str},
1317 {FOURCC_dscp, GST_TAG_DESCRIPTION, NULL, gst_qt_mux_add_3gp_str},
1318 {FOURCC_cprt, GST_TAG_COPYRIGHT, NULL, gst_qt_mux_add_3gp_str},
1319 {FOURCC_perf, GST_TAG_ARTIST, NULL, gst_qt_mux_add_3gp_str},
1320 {FOURCC_auth, GST_TAG_COMPOSER, NULL, gst_qt_mux_add_3gp_str},
1321 {FOURCC_gnre, GST_TAG_GENRE, NULL, gst_qt_mux_add_3gp_str},
1322 {FOURCC_kywd, GST_TAG_KEYWORDS, NULL, gst_qt_mux_add_3gp_keywords},
1323 {FOURCC_yrrc, GST_TAG_DATE, NULL, gst_qt_mux_add_3gp_date},
1324 {FOURCC_albm, GST_TAG_ALBUM, GST_TAG_TRACK_NUMBER, gst_qt_mux_add_3gp_str},
1325 {FOURCC_loci, GST_TAG_GEO_LOCATION_NAME, NULL, gst_qt_mux_add_3gp_location},
1326 {FOURCC_clsf, GST_TAG_3GP_CLASSIFICATION, NULL,
1327 gst_qt_mux_add_3gp_classification},
1331 /* qtdemux produces these for atoms it cannot parse */
1332 #define GST_QT_DEMUX_PRIVATE_TAG "private-qt-tag"
1335 gst_qt_mux_add_xmp_tags (GstQTMux * qtmux, const GstTagList * list)
1337 GstQTMuxClass *qtmux_klass = (GstQTMuxClass *) (G_OBJECT_GET_CLASS (qtmux));
1338 GstBuffer *xmp = NULL;
1340 /* adobe specs only have 'quicktime' and 'mp4',
1341 * but I guess we can extrapolate to gpp.
1342 * Keep mj2 out for now as we don't add any tags for it yet.
1343 * If you have further info about xmp on these formats, please share */
1344 if (qtmux_klass->format == GST_QT_MUX_FORMAT_MJ2)
1347 GST_DEBUG_OBJECT (qtmux, "Adding xmp tags");
1349 if (qtmux_klass->format == GST_QT_MUX_FORMAT_QT) {
1350 xmp = gst_tag_xmp_writer_tag_list_to_xmp_buffer (GST_TAG_XMP_WRITER (qtmux),
1353 atom_udta_add_xmp_tags (&qtmux->moov->udta, xmp);
1356 /* for isom/mp4, it is a top level uuid atom */
1357 xmp = gst_tag_xmp_writer_tag_list_to_xmp_buffer (GST_TAG_XMP_WRITER (qtmux),
1360 ainfo = build_uuid_xmp_atom (xmp);
1362 qtmux->extra_atoms = g_slist_prepend (qtmux->extra_atoms, ainfo);
1367 gst_buffer_unref (xmp);
1371 gst_qt_mux_add_metadata_tags (GstQTMux * qtmux, const GstTagList * list,
1374 GstQTMuxClass *qtmux_klass = (GstQTMuxClass *) (G_OBJECT_GET_CLASS (qtmux));
1377 const gchar *tag, *tag2;
1378 const GstTagToFourcc *tag_matches;
1380 switch (qtmux_klass->format) {
1381 case GST_QT_MUX_FORMAT_3GP:
1382 tag_matches = tag_matches_3gp;
1384 case GST_QT_MUX_FORMAT_MJ2:
1388 /* sort of iTunes style for mp4 and QT (?) */
1389 tag_matches = tag_matches_mp4;
1396 /* Clear existing tags so we don't add them over and over */
1397 atom_udta_clear_tags (udta);
1399 for (i = 0; tag_matches[i].fourcc; i++) {
1400 fourcc = tag_matches[i].fourcc;
1401 tag = tag_matches[i].gsttag;
1402 tag2 = tag_matches[i].gsttag2;
1404 g_assert (tag_matches[i].func);
1405 tag_matches[i].func (qtmux, list, udta, tag, tag2, fourcc);
1408 /* add unparsed blobs if present */
1409 if (gst_tag_exists (GST_QT_DEMUX_PRIVATE_TAG)) {
1412 num_tags = gst_tag_list_get_tag_size (list, GST_QT_DEMUX_PRIVATE_TAG);
1413 for (i = 0; i < num_tags; ++i) {
1414 GstSample *sample = NULL;
1416 const GstStructure *s;
1418 if (!gst_tag_list_get_sample_index (list, GST_QT_DEMUX_PRIVATE_TAG, i,
1421 buf = gst_sample_get_buffer (sample);
1423 if (buf && (s = gst_sample_get_info (sample))) {
1424 const gchar *style = NULL;
1427 gst_buffer_map (buf, &map, GST_MAP_READ);
1428 GST_DEBUG_OBJECT (qtmux,
1429 "Found private tag %d/%d; size %" G_GSIZE_FORMAT ", info %"
1430 GST_PTR_FORMAT, i, num_tags, map.size, s);
1431 if (s && (style = gst_structure_get_string (s, "style"))) {
1432 /* try to prevent some style tag ending up into another variant
1433 * (todo: make into a list if more cases) */
1434 if ((strcmp (style, "itunes") == 0 &&
1435 qtmux_klass->format == GST_QT_MUX_FORMAT_MP4) ||
1436 (strcmp (style, "iso") == 0 &&
1437 qtmux_klass->format == GST_QT_MUX_FORMAT_3GP)) {
1438 GST_DEBUG_OBJECT (qtmux, "Adding private tag");
1439 atom_udta_add_blob_tag (udta, map.data, map.size);
1442 gst_buffer_unmap (buf, &map);
1444 gst_sample_unref (sample);
1452 * Gets the tagsetter iface taglist and puts the known tags
1453 * into the output stream
1456 gst_qt_mux_setup_metadata (GstQTMux * qtmux)
1458 const GstTagList *tags = NULL;
1461 GST_OBJECT_LOCK (qtmux);
1462 if (qtmux->tags_changed) {
1463 tags = gst_tag_setter_get_tag_list (GST_TAG_SETTER (qtmux));
1464 qtmux->tags_changed = FALSE;
1466 GST_OBJECT_UNLOCK (qtmux);
1468 GST_LOG_OBJECT (qtmux, "tags: %" GST_PTR_FORMAT, tags);
1470 if (tags && !gst_tag_list_is_empty (tags)) {
1471 GstTagList *copy = gst_tag_list_copy (tags);
1473 GST_DEBUG_OBJECT (qtmux, "Removing bogus tags");
1474 gst_tag_list_remove_tag (copy, GST_TAG_VIDEO_CODEC);
1475 gst_tag_list_remove_tag (copy, GST_TAG_AUDIO_CODEC);
1476 gst_tag_list_remove_tag (copy, GST_TAG_CONTAINER_FORMAT);
1478 GST_DEBUG_OBJECT (qtmux, "Formatting tags");
1479 gst_qt_mux_add_metadata_tags (qtmux, copy, &qtmux->moov->udta);
1480 gst_qt_mux_add_xmp_tags (qtmux, copy);
1481 gst_tag_list_unref (copy);
1483 GST_DEBUG_OBJECT (qtmux, "No new tags received");
1486 for (walk = qtmux->sinkpads; walk; walk = g_slist_next (walk)) {
1487 GstCollectData *cdata = (GstCollectData *) walk->data;
1488 GstQTPad *qpad = (GstQTPad *) cdata;
1489 GstPad *pad = qpad->collect.pad;
1491 if (qpad->tags_changed && qpad->tags) {
1492 GST_DEBUG_OBJECT (pad, "Adding tags");
1493 gst_tag_list_remove_tag (qpad->tags, GST_TAG_CONTAINER_FORMAT);
1494 gst_qt_mux_add_metadata_tags (qtmux, qpad->tags, &qpad->trak->udta);
1495 qpad->tags_changed = FALSE;
1496 GST_DEBUG_OBJECT (pad, "Tags added");
1498 GST_DEBUG_OBJECT (pad, "No new tags received");
1503 static inline GstBuffer *
1504 _gst_buffer_new_take_data (guint8 * data, guint size)
1508 buf = gst_buffer_new ();
1509 gst_buffer_append_memory (buf,
1510 gst_memory_new_wrapped (0, data, size, 0, size, data, g_free));
1515 static GstFlowReturn
1516 gst_qt_mux_send_buffer (GstQTMux * qtmux, GstBuffer * buf, guint64 * offset,
1522 g_return_val_if_fail (buf != NULL, GST_FLOW_ERROR);
1524 size = gst_buffer_get_size (buf);
1525 GST_LOG_OBJECT (qtmux, "sending buffer size %" G_GSIZE_FORMAT, size);
1527 if (mind_fast && qtmux->fast_start_file) {
1531 GST_LOG_OBJECT (qtmux, "to temporary file");
1532 gst_buffer_map (buf, &map, GST_MAP_READ);
1533 ret = fwrite (map.data, sizeof (guint8), map.size, qtmux->fast_start_file);
1534 gst_buffer_unmap (buf, &map);
1535 gst_buffer_unref (buf);
1541 GST_LOG_OBJECT (qtmux, "downstream");
1542 res = gst_pad_push (qtmux->srcpad, buf);
1545 if (G_LIKELY (offset))
1553 GST_ELEMENT_ERROR (qtmux, RESOURCE, WRITE,
1554 ("Failed to write to temporary file"), GST_ERROR_SYSTEM);
1555 return GST_FLOW_ERROR;
1560 gst_qt_mux_seek_to_beginning (FILE * f)
1563 if (fseeko (f, (off_t) 0, SEEK_SET) != 0)
1565 #elif defined (G_OS_UNIX) || defined (G_OS_WIN32)
1566 if (lseek (fileno (f), (off_t) 0, SEEK_SET) == (off_t) - 1)
1569 if (fseek (f, (long) 0, SEEK_SET) != 0)
1575 static GstFlowReturn
1576 gst_qt_mux_send_buffered_data (GstQTMux * qtmux, guint64 * offset)
1578 GstFlowReturn ret = GST_FLOW_OK;
1579 GstBuffer *buf = NULL;
1581 if (fflush (qtmux->fast_start_file))
1584 if (!gst_qt_mux_seek_to_beginning (qtmux->fast_start_file))
1587 /* hm, this could all take a really really long time,
1588 * but there may not be another way to get moov atom first
1589 * (somehow optimize copy?) */
1590 GST_DEBUG_OBJECT (qtmux, "Sending buffered data");
1591 while (ret == GST_FLOW_OK) {
1592 const int bufsize = 4096;
1596 buf = gst_buffer_new_and_alloc (bufsize);
1597 gst_buffer_map (buf, &map, GST_MAP_WRITE);
1598 size = fread (map.data, sizeof (guint8), bufsize, qtmux->fast_start_file);
1600 gst_buffer_unmap (buf, &map);
1603 GST_LOG_OBJECT (qtmux, "Pushing buffered buffer of size %d", (gint) size);
1604 gst_buffer_unmap (buf, &map);
1605 if (size != bufsize)
1606 gst_buffer_set_size (buf, size);
1607 ret = gst_qt_mux_send_buffer (qtmux, buf, offset, FALSE);
1611 gst_buffer_unref (buf);
1613 if (ftruncate (fileno (qtmux->fast_start_file), 0))
1615 if (!gst_qt_mux_seek_to_beginning (qtmux->fast_start_file))
1623 GST_ELEMENT_ERROR (qtmux, RESOURCE, WRITE,
1624 ("Failed to flush temporary file"), GST_ERROR_SYSTEM);
1625 ret = GST_FLOW_ERROR;
1630 GST_ELEMENT_ERROR (qtmux, RESOURCE, SEEK,
1631 ("Failed to seek temporary file"), GST_ERROR_SYSTEM);
1632 ret = GST_FLOW_ERROR;
1637 /* clear descriptor so we don't remove temp file later on,
1638 * might be possible to recover */
1639 fclose (qtmux->fast_start_file);
1640 qtmux->fast_start_file = NULL;
1646 * Sends the initial mdat atom fields (size fields and fourcc type),
1647 * the subsequent buffers are considered part of it's data.
1648 * As we can't predict the amount of data that we are going to place in mdat
1649 * we need to record the position of the size field in the stream so we can
1650 * seek back to it later and update when the streams have finished.
1652 static GstFlowReturn
1653 gst_qt_mux_send_mdat_header (GstQTMux * qtmux, guint64 * off, guint64 size,
1654 gboolean extended, gboolean fsync_after)
1659 GST_DEBUG_OBJECT (qtmux, "Sending mdat's atom header, "
1660 "size %" G_GUINT64_FORMAT, size);
1662 /* if the qtmux state is EOS, really write the mdat, otherwise
1663 * allow size == 0 for a placeholder atom */
1664 if (qtmux->state == GST_QT_MUX_STATE_EOS || size > 0)
1668 gboolean large_file = (size > MDAT_LARGE_FILE_LIMIT);
1669 /* Always write 16-bytes, but put a free atom first
1670 * if the size is < 4GB. */
1671 buf = gst_buffer_new_and_alloc (16);
1672 gst_buffer_map (buf, &map, GST_MAP_WRITE);
1675 /* Write extended mdat header and large_size field */
1676 GST_WRITE_UINT32_BE (map.data, 1);
1677 GST_WRITE_UINT32_LE (map.data + 4, FOURCC_mdat);
1678 GST_WRITE_UINT64_BE (map.data + 8, size + 8);
1680 /* Write an empty free atom, then standard 32-bit mdat */
1681 GST_WRITE_UINT32_BE (map.data, 8);
1682 GST_WRITE_UINT32_LE (map.data + 4, FOURCC_free);
1683 GST_WRITE_UINT32_BE (map.data + 8, size);
1684 GST_WRITE_UINT32_LE (map.data + 12, FOURCC_mdat);
1686 gst_buffer_unmap (buf, &map);
1688 buf = gst_buffer_new_and_alloc (8);
1689 gst_buffer_map (buf, &map, GST_MAP_WRITE);
1691 /* Vanilla 32-bit mdat */
1692 GST_WRITE_UINT32_BE (map.data, size);
1693 GST_WRITE_UINT32_LE (map.data + 4, FOURCC_mdat);
1694 gst_buffer_unmap (buf, &map);
1697 GST_LOG_OBJECT (qtmux, "Pushing mdat header");
1699 GST_BUFFER_FLAG_SET (buf, GST_BUFFER_FLAG_SYNC_AFTER);
1701 return gst_qt_mux_send_buffer (qtmux, buf, off, FALSE);
1706 * We get the position of the mdat size field, seek back to it
1707 * and overwrite with the real value
1709 static GstFlowReturn
1710 gst_qt_mux_update_mdat_size (GstQTMux * qtmux, guint64 mdat_pos,
1711 guint64 mdat_size, guint64 * offset, gboolean fsync_after)
1715 /* We must have recorded the mdat position for this to work */
1716 g_assert (mdat_pos != 0);
1718 /* seek and rewrite the header */
1719 gst_segment_init (&segment, GST_FORMAT_BYTES);
1720 segment.start = mdat_pos;
1721 gst_pad_push_event (qtmux->srcpad, gst_event_new_segment (&segment));
1723 return gst_qt_mux_send_mdat_header (qtmux, offset, mdat_size, TRUE,
1727 static GstFlowReturn
1728 gst_qt_mux_send_ftyp (GstQTMux * qtmux, guint64 * off)
1731 guint64 size = 0, offset = 0;
1732 guint8 *data = NULL;
1734 GST_DEBUG_OBJECT (qtmux, "Sending ftyp atom");
1736 if (!atom_ftyp_copy_data (qtmux->ftyp, &data, &size, &offset))
1737 goto serialize_error;
1739 buf = _gst_buffer_new_take_data (data, offset);
1741 GST_LOG_OBJECT (qtmux, "Pushing ftyp");
1742 return gst_qt_mux_send_buffer (qtmux, buf, off, FALSE);
1747 GST_ELEMENT_ERROR (qtmux, STREAM, MUX, (NULL),
1748 ("Failed to serialize ftyp"));
1749 return GST_FLOW_ERROR;
1754 gst_qt_mux_prepare_ftyp (GstQTMux * qtmux, AtomFTYP ** p_ftyp,
1755 GstBuffer ** p_prefix)
1757 GstQTMuxClass *qtmux_klass = (GstQTMuxClass *) (G_OBJECT_GET_CLASS (qtmux));
1758 guint32 major, version;
1760 GstBuffer *prefix = NULL;
1761 AtomFTYP *ftyp = NULL;
1763 GST_DEBUG_OBJECT (qtmux, "Preparing ftyp and possible prefix atom");
1765 /* init and send context and ftyp based on current property state */
1766 gst_qt_mux_map_format_to_header (qtmux_klass->format, &prefix, &major,
1767 &version, &comp, qtmux->moov, qtmux->longest_chunk,
1768 qtmux->fast_start_file != NULL);
1769 ftyp = atom_ftyp_new (qtmux->context, major, version, comp);
1776 gst_buffer_unref (prefix);
1781 static GstFlowReturn
1782 gst_qt_mux_prepare_and_send_ftyp (GstQTMux * qtmux)
1784 GstFlowReturn ret = GST_FLOW_OK;
1785 GstBuffer *prefix = NULL;
1787 GST_DEBUG_OBJECT (qtmux, "Preparing to send ftyp atom");
1789 /* init and send context and ftyp based on current property state */
1791 atom_ftyp_free (qtmux->ftyp);
1794 gst_qt_mux_prepare_ftyp (qtmux, &qtmux->ftyp, &prefix);
1796 ret = gst_qt_mux_send_buffer (qtmux, prefix, &qtmux->header_size, FALSE);
1797 if (ret != GST_FLOW_OK)
1800 return gst_qt_mux_send_ftyp (qtmux, &qtmux->header_size);
1804 gst_qt_mux_set_header_on_caps (GstQTMux * mux, GstBuffer * buf)
1806 GstStructure *structure;
1807 GValue array = { 0 };
1808 GValue value = { 0 };
1809 GstCaps *caps, *tcaps;
1811 tcaps = gst_pad_get_current_caps (mux->srcpad);
1812 caps = gst_caps_copy (tcaps);
1813 gst_caps_unref (tcaps);
1815 structure = gst_caps_get_structure (caps, 0);
1817 g_value_init (&array, GST_TYPE_ARRAY);
1819 GST_BUFFER_FLAG_SET (buf, GST_BUFFER_FLAG_HEADER);
1820 g_value_init (&value, GST_TYPE_BUFFER);
1821 gst_value_take_buffer (&value, gst_buffer_ref (buf));
1822 gst_value_array_append_value (&array, &value);
1823 g_value_unset (&value);
1825 gst_structure_set_value (structure, "streamheader", &array);
1826 g_value_unset (&array);
1827 gst_pad_set_caps (mux->srcpad, caps);
1828 gst_caps_unref (caps);
1832 * Write out a free space atom. The offset is adjusted by the full
1833 * size, but a smaller buffer is sent
1835 static GstFlowReturn
1836 gst_qt_mux_send_free_atom (GstQTMux * qtmux, guint64 * off, guint32 size,
1837 gboolean fsync_after)
1841 guint8 *data = NULL;
1842 guint64 offset = 0, bsize = 0;
1845 GST_DEBUG_OBJECT (qtmux, "Sending free atom header of size %u", size);
1847 /* We can't make a free space atom smaller than the header */
1851 node_header = g_malloc0 (sizeof (Atom));
1852 node_header->type = FOURCC_free;
1853 node_header->size = size;
1856 if (atom_copy_data (node_header, &data, &bsize, &offset) == 0)
1857 goto serialize_error;
1859 buf = _gst_buffer_new_take_data (data, offset);
1860 g_free (node_header);
1863 GST_BUFFER_FLAG_SET (buf, GST_BUFFER_FLAG_SYNC_AFTER);
1865 GST_LOG_OBJECT (qtmux, "Pushing free atom");
1866 ret = gst_qt_mux_send_buffer (qtmux, buf, off, FALSE);
1873 /* Make sure downstream position ends up at the end of this free box */
1874 gst_segment_init (&segment, GST_FORMAT_BYTES);
1875 segment.start = *off;
1876 gst_pad_push_event (qtmux->srcpad, gst_event_new_segment (&segment));
1884 GST_ELEMENT_ERROR (qtmux, STREAM, MUX, (NULL),
1885 ("Not enough free reserved space"));
1886 return GST_FLOW_ERROR;
1890 GST_ELEMENT_ERROR (qtmux, STREAM, MUX, (NULL),
1891 ("Failed to serialize mdat"));
1892 g_free (node_header);
1893 return GST_FLOW_ERROR;
1898 gst_qt_mux_configure_moov (GstQTMux * qtmux)
1900 gboolean fragmented = FALSE;
1903 GST_OBJECT_LOCK (qtmux);
1904 timescale = qtmux->timescale;
1905 if (qtmux->mux_mode == GST_QT_MUX_MODE_FRAGMENTED ||
1906 qtmux->mux_mode == GST_QT_MUX_MODE_FRAGMENTED_STREAMABLE)
1908 GST_OBJECT_UNLOCK (qtmux);
1910 /* inform lower layers of our property wishes, and determine duration.
1911 * Let moov take care of this using its list of traks;
1912 * so that released pads are also included */
1913 GST_DEBUG_OBJECT (qtmux, "Updating timescale to %" G_GUINT32_FORMAT,
1915 atom_moov_update_timescale (qtmux->moov, timescale);
1916 atom_moov_set_fragmented (qtmux->moov, fragmented);
1918 atom_moov_update_duration (qtmux->moov);
1921 static GstFlowReturn
1922 gst_qt_mux_send_moov (GstQTMux * qtmux, guint64 * _offset,
1923 guint64 padded_moov_size, gboolean mind_fast, gboolean fsync_after)
1925 guint64 offset = 0, size = 0;
1928 GstFlowReturn ret = GST_FLOW_OK;
1930 guint64 current_time = atoms_get_current_qt_time ();
1932 /* update modification times */
1933 qtmux->moov->mvhd.time_info.modification_time = current_time;
1934 for (walk = qtmux->collect->data; walk; walk = g_slist_next (walk)) {
1935 GstCollectData *cdata = (GstCollectData *) walk->data;
1936 GstQTPad *qtpad = (GstQTPad *) cdata;
1938 qtpad->trak->mdia.mdhd.time_info.modification_time = current_time;
1939 qtpad->trak->tkhd.modification_time = current_time;
1942 /* serialize moov */
1945 GST_LOG_OBJECT (qtmux, "Copying movie header into buffer");
1946 if (!atom_moov_copy_data (qtmux->moov, &data, &size, &offset))
1947 goto serialize_error;
1948 qtmux->last_moov_size = offset;
1950 /* Check we have enough reserved space for this and a Free atom */
1951 if (padded_moov_size > 0 && offset + 8 > padded_moov_size)
1952 goto too_small_reserved;
1953 buf = _gst_buffer_new_take_data (data, offset);
1954 GST_DEBUG_OBJECT (qtmux, "Pushing moov atoms");
1956 /* If at EOS, this is the final moov, put in the streamheader
1957 * (apparently used by a flumotion util) */
1958 if (qtmux->state == GST_QT_MUX_STATE_EOS)
1959 gst_qt_mux_set_header_on_caps (qtmux, buf);
1962 GST_BUFFER_FLAG_SET (buf, GST_BUFFER_FLAG_SYNC_AFTER);
1963 ret = gst_qt_mux_send_buffer (qtmux, buf, _offset, mind_fast);
1965 /* Write out a free atom if needed */
1966 if (ret == GST_FLOW_OK && offset < padded_moov_size) {
1967 GST_LOG_OBJECT (qtmux, "Writing out free atom of size %u",
1968 (guint32) (padded_moov_size - offset));
1970 gst_qt_mux_send_free_atom (qtmux, _offset, padded_moov_size - offset,
1977 GST_ELEMENT_ERROR (qtmux, STREAM, MUX,
1978 ("Not enough free reserved header space"),
1979 ("Needed %" G_GUINT64_FORMAT " bytes, reserved %" G_GUINT64_FORMAT,
1980 offset, padded_moov_size));
1981 return GST_FLOW_ERROR;
1986 return GST_FLOW_ERROR;
1990 /* either calculates size of extra atoms or pushes them */
1991 static GstFlowReturn
1992 gst_qt_mux_send_extra_atoms (GstQTMux * qtmux, gboolean send, guint64 * offset,
1996 guint64 loffset = 0, size = 0;
1998 GstFlowReturn ret = GST_FLOW_OK;
2000 for (walk = qtmux->extra_atoms; walk; walk = g_slist_next (walk)) {
2001 AtomInfo *ainfo = (AtomInfo *) walk->data;
2005 if (!ainfo->copy_data_func (ainfo->atom,
2006 send ? &data : NULL, &size, &loffset))
2007 goto serialize_error;
2012 GST_DEBUG_OBJECT (qtmux,
2013 "Pushing extra top-level atom %" GST_FOURCC_FORMAT,
2014 GST_FOURCC_ARGS (ainfo->atom->type));
2015 buf = _gst_buffer_new_take_data (data, loffset);
2016 ret = gst_qt_mux_send_buffer (qtmux, buf, offset, FALSE);
2017 if (ret != GST_FLOW_OK)
2030 return GST_FLOW_ERROR;
2035 gst_qt_mux_downstream_is_seekable (GstQTMux * qtmux)
2037 gboolean seekable = FALSE;
2038 GstQuery *query = gst_query_new_seeking (GST_FORMAT_BYTES);
2040 if (gst_pad_peer_query (qtmux->srcpad, query)) {
2041 gst_query_parse_seeking (query, NULL, &seekable, NULL, NULL);
2042 GST_INFO_OBJECT (qtmux, "downstream is %sseekable", seekable ? "" : "not ");
2044 /* have to assume seeking is not supported if query not handled downstream */
2045 GST_WARNING_OBJECT (qtmux, "downstream did not handle seeking query");
2048 gst_query_unref (query);
2054 gst_qt_mux_prepare_moov_recovery (GstQTMux * qtmux)
2057 gboolean fail = FALSE;
2058 AtomFTYP *ftyp = NULL;
2059 GstBuffer *prefix = NULL;
2061 GST_DEBUG_OBJECT (qtmux, "Opening moov recovery file: %s",
2062 qtmux->moov_recov_file_path);
2064 qtmux->moov_recov_file = g_fopen (qtmux->moov_recov_file_path, "wb+");
2065 if (qtmux->moov_recov_file == NULL) {
2066 GST_WARNING_OBJECT (qtmux, "Failed to open moov recovery file in %s",
2067 qtmux->moov_recov_file_path);
2071 gst_qt_mux_prepare_ftyp (qtmux, &ftyp, &prefix);
2073 if (!atoms_recov_write_headers (qtmux->moov_recov_file, ftyp, prefix,
2074 qtmux->moov, qtmux->timescale, g_slist_length (qtmux->sinkpads))) {
2075 GST_WARNING_OBJECT (qtmux, "Failed to write moov recovery file " "headers");
2079 atom_ftyp_free (ftyp);
2081 gst_buffer_unref (prefix);
2083 for (walk = qtmux->sinkpads; walk && !fail; walk = g_slist_next (walk)) {
2084 GstCollectData *cdata = (GstCollectData *) walk->data;
2085 GstQTPad *qpad = (GstQTPad *) cdata;
2086 /* write info for each stream */
2087 fail = atoms_recov_write_trak_info (qtmux->moov_recov_file, qpad->trak);
2089 GST_WARNING_OBJECT (qtmux, "Failed to write trak info to recovery "
2099 fclose (qtmux->moov_recov_file);
2100 qtmux->moov_recov_file = NULL;
2103 static GstFlowReturn
2104 gst_qt_mux_start_file (GstQTMux * qtmux)
2106 GstQTMuxClass *qtmux_klass = (GstQTMuxClass *) (G_OBJECT_GET_CLASS (qtmux));
2107 GstFlowReturn ret = GST_FLOW_OK;
2111 GstClockTime reserved_max_duration;
2112 guint reserved_bytes_per_sec_per_trak;
2114 GST_DEBUG_OBJECT (qtmux, "starting file");
2116 GST_OBJECT_LOCK (qtmux);
2117 reserved_max_duration = qtmux->reserved_max_duration;
2118 reserved_bytes_per_sec_per_trak = qtmux->reserved_bytes_per_sec_per_trak;
2119 GST_OBJECT_UNLOCK (qtmux);
2121 /* stream-start (FIXME: create id based on input ids) */
2122 g_snprintf (s_id, sizeof (s_id), "qtmux-%08x", g_random_int ());
2123 gst_pad_push_event (qtmux->srcpad, gst_event_new_stream_start (s_id));
2125 caps = gst_caps_copy (gst_pad_get_pad_template_caps (qtmux->srcpad));
2126 /* qtmux has structure with and without variant, remove all but the first */
2127 while (gst_caps_get_size (caps) > 1)
2128 gst_caps_remove_structure (caps, 1);
2129 gst_pad_set_caps (qtmux->srcpad, caps);
2130 gst_caps_unref (caps);
2132 /* Default is 'normal' mode */
2133 qtmux->mux_mode = GST_QT_MUX_MODE_MOOV_AT_END;
2135 /* Require a sensible fragment duration when muxing
2136 * using the ISML muxer */
2137 if (qtmux_klass->format == GST_QT_MUX_FORMAT_ISML &&
2138 qtmux->fragment_duration == 0)
2141 if (qtmux->fragment_duration > 0) {
2142 if (qtmux->streamable)
2143 qtmux->mux_mode = GST_QT_MUX_MODE_FRAGMENTED_STREAMABLE;
2145 qtmux->mux_mode = GST_QT_MUX_MODE_FRAGMENTED;
2146 } else if (qtmux->fast_start) {
2147 qtmux->mux_mode = GST_QT_MUX_MODE_FAST_START;
2148 } else if (reserved_max_duration != GST_CLOCK_TIME_NONE) {
2149 qtmux->mux_mode = GST_QT_MUX_MODE_ROBUST_RECORDING;
2152 switch (qtmux->mux_mode) {
2153 case GST_QT_MUX_MODE_MOOV_AT_END:
2154 case GST_QT_MUX_MODE_ROBUST_RECORDING:
2155 /* We have to be able to seek to rewrite the mdat header, or any
2156 * moov atom we write will not be visible in the file, because an
2157 * MDAT with 0 as the size covers the rest of the file. A file
2158 * with no moov is not playable, so error out now. */
2159 if (!gst_qt_mux_downstream_is_seekable (qtmux)) {
2160 GST_ELEMENT_ERROR (qtmux, STREAM, MUX,
2161 ("Downstream is not seekable - will not be able to create a playable file"),
2163 return GST_FLOW_ERROR;
2166 case GST_QT_MUX_MODE_FAST_START:
2167 case GST_QT_MUX_MODE_FRAGMENTED_STREAMABLE:
2168 break; /* Don't need seekability, ignore */
2169 case GST_QT_MUX_MODE_FRAGMENTED:
2170 if (!gst_qt_mux_downstream_is_seekable (qtmux)) {
2171 GST_WARNING_OBJECT (qtmux, "downstream is not seekable, but "
2172 "streamable=false. Will ignore that and create streamable output "
2174 qtmux->streamable = TRUE;
2175 g_object_notify (G_OBJECT (qtmux), "streamable");
2180 /* let downstream know we think in BYTES and expect to do seeking later on */
2181 gst_segment_init (&segment, GST_FORMAT_BYTES);
2182 gst_pad_push_event (qtmux->srcpad, gst_event_new_segment (&segment));
2184 GST_OBJECT_LOCK (qtmux);
2186 if (qtmux->timescale == 0) {
2187 guint32 suggested_timescale = 0;
2190 /* Calculate a reasonable timescale for the moov:
2191 * If there is video, it is the biggest video track timescale or an even
2192 * multiple of it if it's smaller than 1800.
2193 * Otherwise it is 1800 */
2194 for (walk = qtmux->sinkpads; walk; walk = g_slist_next (walk)) {
2195 GstCollectData *cdata = (GstCollectData *) walk->data;
2196 GstQTPad *qpad = (GstQTPad *) cdata;
2202 if (!qpad->trak->mdia.minf.vmhd)
2205 suggested_timescale =
2206 MAX (qpad->trak->mdia.mdhd.time_info.timescale, suggested_timescale);
2209 if (suggested_timescale == 0)
2210 suggested_timescale = 1800;
2212 while (suggested_timescale < 1800)
2213 suggested_timescale *= 2;
2215 qtmux->timescale = suggested_timescale;
2218 /* initialize our moov recovery file */
2219 if (qtmux->moov_recov_file_path) {
2220 gst_qt_mux_prepare_moov_recovery (qtmux);
2223 /* Make sure the first time we update the moov, we'll
2224 * include any tagsetter tags */
2225 qtmux->tags_changed = TRUE;
2227 GST_OBJECT_UNLOCK (qtmux);
2230 * send mdat header if already needed, and mark position for later update.
2231 * We don't send ftyp now if we are on fast start mode, because we can
2232 * better fine tune using the information we gather to create the whole moov
2235 switch (qtmux->mux_mode) {
2236 case GST_QT_MUX_MODE_MOOV_AT_END:
2237 ret = gst_qt_mux_prepare_and_send_ftyp (qtmux);
2238 if (ret != GST_FLOW_OK)
2241 /* Store this as the mdat offset for later updating
2242 * when we write the moov */
2243 qtmux->mdat_pos = qtmux->header_size;
2244 /* extended atom in case we go over 4GB while writing and need
2245 * the full 64-bit atom */
2247 gst_qt_mux_send_mdat_header (qtmux, &qtmux->header_size, 0, TRUE,
2250 case GST_QT_MUX_MODE_ROBUST_RECORDING:
2252 ret = gst_qt_mux_prepare_and_send_ftyp (qtmux);
2253 if (ret != GST_FLOW_OK)
2256 /* Pad ftyp out to an 8-byte boundary before starting the moov
2257 * ping pong region. It should be well less than 1 disk sector,
2258 * unless there's a bajillion compatible types listed,
2259 * but let's be sure the free atom doesn't cross a sector
2260 * boundary anyway */
2261 if (qtmux->header_size % 8) {
2262 /* Extra 8 bytes for the padding free atom header */
2263 guint padding = (guint) (16 - (qtmux->header_size % 8));
2264 GST_LOG_OBJECT (qtmux, "Rounding ftyp by %u bytes", padding);
2266 gst_qt_mux_send_free_atom (qtmux, &qtmux->header_size, padding,
2268 if (ret != GST_FLOW_OK)
2272 /* Store this as the moov offset for later updating.
2273 * We record mdat position below */
2274 qtmux->moov_pos = qtmux->header_size;
2276 /* Set up the initial 'ping' state of the ping-pong buffers */
2277 qtmux->reserved_moov_first_active = TRUE;
2279 gst_qt_mux_configure_moov (qtmux);
2280 gst_qt_mux_setup_metadata (qtmux);
2281 /* Empty free atom to begin, starting on an 8-byte boundary */
2282 ret = gst_qt_mux_send_free_atom (qtmux, &qtmux->header_size, 8, FALSE);
2283 if (ret != GST_FLOW_OK)
2285 /* Moov header, not padded yet */
2286 ret = gst_qt_mux_send_moov (qtmux, &qtmux->header_size, 0, FALSE, FALSE);
2287 if (ret != GST_FLOW_OK)
2289 /* The moov we just sent contains the 'base' size of the moov, before
2290 * we put in any time-dependent per-trak data. Use that to make
2291 * a good estimate of how much extra to reserve */
2292 /* Calculate how much space to reserve for our MOOV atom.
2293 * We actually reserve twice that, for ping-pong buffers */
2294 qtmux->base_moov_size = qtmux->last_moov_size;
2295 GST_LOG_OBJECT (qtmux, "Base moov size is %u before any indexes",
2296 qtmux->base_moov_size);
2297 qtmux->reserved_moov_size = qtmux->base_moov_size +
2298 gst_util_uint64_scale (reserved_max_duration,
2299 reserved_bytes_per_sec_per_trak *
2300 atom_moov_get_trak_count (qtmux->moov), GST_SECOND);
2302 /* Need space for at least 4 atom headers. More really, but
2303 * this as an absolute minimum */
2304 if (qtmux->reserved_moov_size < 4 * 8)
2305 goto reserved_moov_too_small;
2307 GST_DEBUG_OBJECT (qtmux, "reserving header area of size %u",
2308 2 * qtmux->reserved_moov_size + 16);
2310 GST_OBJECT_LOCK (qtmux);
2311 qtmux->reserved_duration_remaining =
2312 gst_util_uint64_scale (qtmux->reserved_moov_size -
2313 qtmux->base_moov_size, GST_SECOND,
2314 reserved_bytes_per_sec_per_trak *
2315 atom_moov_get_trak_count (qtmux->moov));
2316 GST_OBJECT_UNLOCK (qtmux);
2318 /* Now that we know how much reserved space is targetted,
2319 * output a free atom to fill the extra reserved */
2320 ret = gst_qt_mux_send_free_atom (qtmux, &qtmux->header_size,
2321 qtmux->reserved_moov_size - qtmux->base_moov_size, FALSE);
2322 if (ret != GST_FLOW_OK)
2325 /* Then a free atom containing 'pong' buffer, with an
2326 * extra 8 bytes to account for the free atom header itself */
2327 ret = gst_qt_mux_send_free_atom (qtmux, &qtmux->header_size,
2328 qtmux->reserved_moov_size + 8, FALSE);
2329 if (ret != GST_FLOW_OK)
2332 /* extra atoms go after the free/moov(s), before the mdat */
2334 gst_qt_mux_send_extra_atoms (qtmux, TRUE, &qtmux->header_size, FALSE);
2335 if (ret != GST_FLOW_OK)
2338 qtmux->mdat_pos = qtmux->header_size;
2339 /* extended atom in case we go over 4GB while writing and need
2340 * the full 64-bit atom */
2342 gst_qt_mux_send_mdat_header (qtmux, &qtmux->header_size, 0, TRUE,
2345 case GST_QT_MUX_MODE_FAST_START:
2346 GST_OBJECT_LOCK (qtmux);
2347 qtmux->fast_start_file = g_fopen (qtmux->fast_start_file_path, "wb+");
2348 if (!qtmux->fast_start_file)
2350 GST_OBJECT_UNLOCK (qtmux);
2351 /* send a dummy buffer for preroll */
2352 ret = gst_qt_mux_send_buffer (qtmux, gst_buffer_new (), NULL, FALSE);
2354 case GST_QT_MUX_MODE_FRAGMENTED:
2355 case GST_QT_MUX_MODE_FRAGMENTED_STREAMABLE:
2356 ret = gst_qt_mux_prepare_and_send_ftyp (qtmux);
2357 if (ret != GST_FLOW_OK)
2359 /* store the moov pos so we can update the duration later
2360 * in non-streamable mode */
2361 qtmux->moov_pos = qtmux->header_size;
2363 GST_DEBUG_OBJECT (qtmux, "fragment duration %d ms, writing headers",
2364 qtmux->fragment_duration);
2365 /* also used as snapshot marker to indicate fragmented file */
2366 qtmux->fragment_sequence = 1;
2367 /* prepare moov and/or tags */
2368 gst_qt_mux_configure_moov (qtmux);
2369 gst_qt_mux_setup_metadata (qtmux);
2370 ret = gst_qt_mux_send_moov (qtmux, &qtmux->header_size, 0, FALSE, FALSE);
2371 if (ret != GST_FLOW_OK)
2375 gst_qt_mux_send_extra_atoms (qtmux, TRUE, &qtmux->header_size, FALSE);
2376 if (ret != GST_FLOW_OK)
2378 /* prepare index if not streamable */
2379 if (qtmux->mux_mode == GST_QT_MUX_MODE_FRAGMENTED)
2380 qtmux->mfra = atom_mfra_new (qtmux->context);
2388 GST_ELEMENT_ERROR (qtmux, STREAM, MUX,
2389 ("Cannot create an ISML file with 0 fragment duration"), (NULL));
2390 return GST_FLOW_ERROR;
2392 reserved_moov_too_small:
2394 GST_ELEMENT_ERROR (qtmux, STREAM, MUX,
2395 ("Not enough reserved space for creating headers"), (NULL));
2396 return GST_FLOW_ERROR;
2400 GST_ELEMENT_ERROR (qtmux, RESOURCE, OPEN_READ_WRITE,
2401 (("Could not open temporary file \"%s\""),
2402 qtmux->fast_start_file_path), GST_ERROR_SYSTEM);
2403 GST_OBJECT_UNLOCK (qtmux);
2404 return GST_FLOW_ERROR;
2408 static GstFlowReturn
2409 gst_qt_mux_send_last_buffers (GstQTMux * qtmux)
2411 GstFlowReturn ret = GST_FLOW_OK;
2414 for (walk = qtmux->collect->data; walk; walk = g_slist_next (walk)) {
2415 GstCollectData *cdata = (GstCollectData *) walk->data;
2416 GstQTPad *qtpad = (GstQTPad *) cdata;
2418 /* avoid add_buffer complaining if not negotiated
2419 * in which case no buffers either, so skipping */
2420 if (!qtpad->fourcc) {
2421 GST_DEBUG_OBJECT (qtmux, "Pad %s has never had buffers",
2422 GST_PAD_NAME (qtpad->collect.pad));
2426 /* send last buffer; also flushes possibly queued buffers/ts */
2427 GST_DEBUG_OBJECT (qtmux, "Sending the last buffer for pad %s",
2428 GST_PAD_NAME (qtpad->collect.pad));
2429 ret = gst_qt_mux_add_buffer (qtmux, qtpad, NULL);
2430 if (ret != GST_FLOW_OK) {
2431 GST_WARNING_OBJECT (qtmux, "Failed to send last buffer for %s, "
2432 "flow return: %s", GST_PAD_NAME (qtpad->collect.pad),
2433 gst_flow_get_name (ret));
2441 gst_qt_mux_update_global_statistics (GstQTMux * qtmux)
2445 /* for setting some subtitles fields */
2446 guint max_width = 0;
2447 guint max_height = 0;
2449 qtmux->first_ts = qtmux->last_dts = GST_CLOCK_TIME_NONE;
2451 for (walk = qtmux->collect->data; walk; walk = g_slist_next (walk)) {
2452 GstCollectData *cdata = (GstCollectData *) walk->data;
2453 GstQTPad *qtpad = (GstQTPad *) cdata;
2455 if (!qtpad->fourcc) {
2456 GST_DEBUG_OBJECT (qtmux, "Pad %s has never had buffers",
2457 GST_PAD_NAME (qtpad->collect.pad));
2461 /* having flushed above, can check for buffers now */
2462 if (GST_CLOCK_TIME_IS_VALID (qtpad->first_ts)) {
2463 /* determine max stream duration */
2464 if (!GST_CLOCK_TIME_IS_VALID (qtmux->last_dts)
2465 || qtpad->last_dts > qtmux->last_dts) {
2466 qtmux->last_dts = qtpad->last_dts;
2468 if (!GST_CLOCK_TIME_IS_VALID (qtmux->first_ts)
2469 || qtpad->first_ts < qtmux->first_ts) {
2470 qtmux->first_ts = qtpad->first_ts;
2474 /* subtitles need to know the video width/height,
2475 * it is stored shifted 16 bits to the left according to the
2477 max_width = MAX (max_width, (qtpad->trak->tkhd.width >> 16));
2478 max_height = MAX (max_height, (qtpad->trak->tkhd.height >> 16));
2480 /* update average bitrate of streams if needed */
2482 guint32 avgbitrate = 0;
2483 guint32 maxbitrate = qtpad->max_bitrate;
2485 if (qtpad->avg_bitrate)
2486 avgbitrate = qtpad->avg_bitrate;
2487 else if (qtpad->total_duration > 0)
2488 avgbitrate = (guint32) gst_util_uint64_scale_round (qtpad->total_bytes,
2489 8 * GST_SECOND, qtpad->total_duration);
2491 atom_trak_update_bitrates (qtpad->trak, avgbitrate, maxbitrate);
2495 /* need to update values on subtitle traks now that we know the
2496 * max width and height */
2497 for (walk = qtmux->collect->data; walk; walk = g_slist_next (walk)) {
2498 GstCollectData *cdata = (GstCollectData *) walk->data;
2499 GstQTPad *qtpad = (GstQTPad *) cdata;
2501 if (!qtpad->fourcc) {
2502 GST_DEBUG_OBJECT (qtmux, "Pad %s has never had buffers",
2503 GST_PAD_NAME (qtpad->collect.pad));
2507 if (qtpad->fourcc == FOURCC_tx3g) {
2508 atom_trak_tx3g_update_dimension (qtpad->trak, max_width, max_height);
2513 /* Called after gst_qt_mux_update_global_statistics() updates the
2514 * first_ts tracking, to create/set edit lists for delayed streams */
2516 gst_qt_mux_update_edit_lists (GstQTMux * qtmux)
2520 GST_DEBUG_OBJECT (qtmux, "Media first ts selected: %" GST_TIME_FORMAT,
2521 GST_TIME_ARGS (qtmux->first_ts));
2522 /* add/update EDTSs for late streams. configure_moov will have
2523 * set the trak durations above by summing the sample tables,
2524 * here we extend that if needing to insert an empty segment */
2525 for (walk = qtmux->collect->data; walk; walk = g_slist_next (walk)) {
2526 GstCollectData *cdata = (GstCollectData *) walk->data;
2527 GstQTPad *qtpad = (GstQTPad *) cdata;
2529 atom_trak_edts_clear (qtpad->trak);
2531 if (GST_CLOCK_TIME_IS_VALID (qtpad->first_ts)) {
2532 guint32 lateness = 0;
2533 guint32 duration = qtpad->trak->tkhd.duration;
2536 has_gap = (qtpad->first_ts > (qtmux->first_ts + qtpad->dts_adjustment));
2541 diff = qtpad->first_ts - (qtmux->first_ts + qtpad->dts_adjustment);
2542 lateness = gst_util_uint64_scale_round (diff,
2543 qtmux->timescale, GST_SECOND);
2546 GST_DEBUG_OBJECT (qtmux,
2547 "Pad %s is a late stream by %" GST_TIME_FORMAT,
2548 GST_PAD_NAME (qtpad->collect.pad), GST_TIME_ARGS (lateness));
2550 atom_trak_set_elst_entry (qtpad->trak, 0, lateness, (guint32) - 1,
2551 (guint32) (1 * 65536.0));
2555 /* Always write an edit list for the whole track. In general this is not
2556 * necessary except for the case of having a gap or DTS adjustment but
2557 * it allows to give the whole track's duration in the usually more
2558 * accurate media timescale
2561 GstClockTime ctts = 0;
2562 guint32 media_start;
2564 if (qtpad->first_ts > qtpad->first_dts)
2565 ctts = qtpad->first_ts - qtpad->first_dts;
2567 media_start = gst_util_uint64_scale_round (ctts,
2568 atom_trak_get_timescale (qtpad->trak), GST_SECOND);
2570 /* atom_trak_set_elst_entry() has a quirk - if the edit list
2571 * is empty because there's no gap added above, this call
2572 * will not replace index 1, it will create the entry at index 0.
2573 * Luckily, that's exactly what we want here */
2574 atom_trak_set_elst_entry (qtpad->trak, 1, duration, media_start,
2575 (guint32) (1 * 65536.0));
2578 /* need to add the empty time to the trak duration */
2579 duration += lateness;
2580 qtpad->trak->tkhd.duration = duration;
2581 if (qtpad->tc_trak) {
2582 qtpad->tc_trak->tkhd.duration = duration;
2583 qtpad->tc_trak->mdia.mdhd.time_info.duration = duration;
2586 /* And possibly grow the moov duration */
2587 if (duration > qtmux->moov->mvhd.time_info.duration) {
2588 qtmux->moov->mvhd.time_info.duration = duration;
2589 qtmux->moov->mvex.mehd.fragment_duration = duration;
2595 static GstFlowReturn
2596 gst_qt_mux_update_timecode (GstQTMux * qtmux, GstQTPad * qtpad)
2601 guint64 offset = qtpad->tc_pos;
2603 g_assert (qtpad->tc_pos != -1);
2605 gst_segment_init (&segment, GST_FORMAT_BYTES);
2606 segment.start = offset;
2607 gst_pad_push_event (qtmux->srcpad, gst_event_new_segment (&segment));
2609 buf = gst_buffer_new_and_alloc (4);
2610 gst_buffer_map (buf, &map, GST_MAP_WRITE);
2612 GST_WRITE_UINT32_BE (map.data,
2613 gst_video_time_code_frames_since_daily_jam (qtpad->first_tc));
2614 gst_buffer_unmap (buf, &map);
2616 /* Reset this value, so the timecode won't be re-rewritten */
2619 return gst_qt_mux_send_buffer (qtmux, buf, &offset, FALSE);
2622 static GstFlowReturn
2623 gst_qt_mux_stop_file (GstQTMux * qtmux)
2625 gboolean ret = GST_FLOW_OK;
2626 guint64 offset = 0, size = 0;
2627 gboolean large_file;
2630 GST_DEBUG_OBJECT (qtmux, "Updating remaining values and sending last data");
2632 /* pushing last buffers for each pad */
2633 if ((ret = gst_qt_mux_send_last_buffers (qtmux)) != GST_FLOW_OK)
2636 if (qtmux->mux_mode == GST_QT_MUX_MODE_FRAGMENTED_STREAMABLE) {
2637 /* Streamable mode; no need to write duration or MFRA */
2638 GST_DEBUG_OBJECT (qtmux, "streamable file; nothing to stop");
2642 gst_qt_mux_update_global_statistics (qtmux);
2643 for (walk = qtmux->collect->data; walk; walk = walk->next) {
2644 GstQTPad *qtpad = (GstQTPad *) walk->data;
2646 if (qtpad->tc_pos != -1) {
2647 /* File is being stopped and timecode hasn't been updated. Update it now
2648 * with whatever we have */
2649 ret = gst_qt_mux_update_timecode (qtmux, qtpad);
2650 if (ret != GST_FLOW_OK)
2655 switch (qtmux->mux_mode) {
2656 case GST_QT_MUX_MODE_FRAGMENTED:{
2658 guint8 *data = NULL;
2662 GST_DEBUG_OBJECT (qtmux, "adding mfra");
2663 if (!atom_mfra_copy_data (qtmux->mfra, &data, &size, &offset))
2664 goto serialize_error;
2665 buf = _gst_buffer_new_take_data (data, offset);
2666 ret = gst_qt_mux_send_buffer (qtmux, buf, NULL, FALSE);
2667 if (ret != GST_FLOW_OK)
2670 /* only mvex duration is updated,
2671 * mvhd should be consistent with empty moov
2672 * (but TODO maybe some clients do not handle that well ?) */
2673 qtmux->moov->mvex.mehd.fragment_duration =
2674 gst_util_uint64_scale (qtmux->last_dts, qtmux->timescale, GST_SECOND);
2675 GST_DEBUG_OBJECT (qtmux, "rewriting moov with mvex duration %"
2676 GST_TIME_FORMAT, GST_TIME_ARGS (qtmux->last_dts));
2677 /* seek and rewrite the header */
2678 gst_segment_init (&segment, GST_FORMAT_BYTES);
2679 segment.start = qtmux->moov_pos;
2680 gst_pad_push_event (qtmux->srcpad, gst_event_new_segment (&segment));
2681 /* no need to seek back */
2682 return gst_qt_mux_send_moov (qtmux, NULL, 0, FALSE, FALSE);
2684 case GST_QT_MUX_MODE_ROBUST_RECORDING:{
2685 ret = gst_qt_mux_robust_recording_rewrite_moov (qtmux);
2686 if (G_UNLIKELY (ret != GST_FLOW_OK))
2688 /* Finalise by writing the final size into the mdat. Up until now
2689 * it's been 0, which means 'rest of the file'
2690 * No need to seek back after this, we won't write any more */
2691 return gst_qt_mux_update_mdat_size (qtmux, qtmux->mdat_pos,
2692 qtmux->mdat_size, NULL, TRUE);
2698 /* Moov-at-end or fast-start mode from here down */
2699 gst_qt_mux_configure_moov (qtmux);
2701 gst_qt_mux_update_edit_lists (qtmux);
2703 /* tags into file metadata */
2704 gst_qt_mux_setup_metadata (qtmux);
2706 large_file = (qtmux->mdat_size > MDAT_LARGE_FILE_LIMIT);
2708 switch (qtmux->mux_mode) {
2709 case GST_QT_MUX_MODE_FAST_START:{
2710 /* if faststart, update the offset of the atoms in the movie with the offset
2711 * that the movie headers before mdat will cause.
2712 * Also, send the ftyp */
2715 ret = gst_qt_mux_prepare_and_send_ftyp (qtmux);
2716 if (ret != GST_FLOW_OK) {
2719 /* copy into NULL to obtain size */
2720 if (!atom_moov_copy_data (qtmux->moov, NULL, &size, &offset))
2721 goto serialize_error;
2722 GST_DEBUG_OBJECT (qtmux, "calculated moov atom size %" G_GUINT64_FORMAT,
2724 offset += qtmux->header_size + (large_file ? 16 : 8);
2726 /* sum up with the extra atoms size */
2727 ret = gst_qt_mux_send_extra_atoms (qtmux, FALSE, &offset, FALSE);
2728 if (ret != GST_FLOW_OK)
2733 offset = qtmux->header_size;
2737 /* Now that we know the size of moov + extra atoms, we can adjust
2738 * the chunk offsets stored into the moov */
2739 atom_moov_chunks_set_offset (qtmux->moov, offset);
2741 /* write out moov and extra atoms */
2742 /* note: as of this point, we no longer care about tracking written data size,
2743 * since there is no more use for it anyway */
2744 ret = gst_qt_mux_send_moov (qtmux, NULL, 0, FALSE, FALSE);
2745 if (ret != GST_FLOW_OK)
2749 ret = gst_qt_mux_send_extra_atoms (qtmux, TRUE, NULL, FALSE);
2750 if (ret != GST_FLOW_OK)
2753 switch (qtmux->mux_mode) {
2754 case GST_QT_MUX_MODE_MOOV_AT_END:
2756 /* mdat needs update iff not using faststart */
2757 GST_DEBUG_OBJECT (qtmux, "updating mdat size");
2758 ret = gst_qt_mux_update_mdat_size (qtmux, qtmux->mdat_pos,
2759 qtmux->mdat_size, NULL, FALSE);
2760 /* note; no seeking back to the end of file is done,
2761 * since we no longer write anything anyway */
2764 case GST_QT_MUX_MODE_FAST_START:
2766 /* send mdat atom and move buffered data into it */
2767 /* mdat_size = accumulated (buffered data) */
2768 ret = gst_qt_mux_send_mdat_header (qtmux, NULL, qtmux->mdat_size,
2770 if (ret != GST_FLOW_OK)
2772 ret = gst_qt_mux_send_buffered_data (qtmux, NULL);
2773 if (ret != GST_FLOW_OK)
2778 g_assert_not_reached ();
2786 GST_ELEMENT_ERROR (qtmux, STREAM, MUX, (NULL),
2787 ("Failed to serialize moov"));
2788 return GST_FLOW_ERROR;
2792 GST_ELEMENT_ERROR (qtmux, STREAM, MUX, (NULL), ("Failed to send ftyp"));
2793 return GST_FLOW_ERROR;
2797 static GstFlowReturn
2798 gst_qt_mux_pad_fragment_add_buffer (GstQTMux * qtmux, GstQTPad * pad,
2799 GstBuffer * buf, gboolean force, guint32 nsamples, gint64 dts,
2800 guint32 delta, guint32 size, gboolean sync, gint64 pts_offset)
2802 GstFlowReturn ret = GST_FLOW_OK;
2804 /* setup if needed */
2805 if (G_UNLIKELY (!pad->traf || force))
2809 /* flush pad fragment if threshold reached,
2810 * or at new keyframe if we should be minding those in the first place */
2811 if (G_UNLIKELY (force || (sync && pad->sync) ||
2812 pad->fragment_duration < (gint64) delta)) {
2814 guint64 size = 0, offset = 0;
2815 guint8 *data = NULL;
2817 guint i, total_size;
2819 /* now we know where moof ends up, update offset in tfra */
2821 atom_tfra_update_offset (pad->tfra, qtmux->header_size);
2823 moof = atom_moof_new (qtmux->context, qtmux->fragment_sequence);
2824 /* takes ownership */
2825 atom_moof_add_traf (moof, pad->traf);
2827 atom_moof_copy_data (moof, &data, &size, &offset);
2828 buffer = _gst_buffer_new_take_data (data, offset);
2829 GST_LOG_OBJECT (qtmux, "writing moof size %" G_GSIZE_FORMAT,
2830 gst_buffer_get_size (buffer));
2831 ret = gst_qt_mux_send_buffer (qtmux, buffer, &qtmux->header_size, FALSE);
2833 /* and actual data */
2835 for (i = 0; i < atom_array_get_len (&pad->fragment_buffers); i++) {
2837 gst_buffer_get_size (atom_array_index (&pad->fragment_buffers, i));
2840 GST_LOG_OBJECT (qtmux, "writing %d buffers, total_size %d",
2841 atom_array_get_len (&pad->fragment_buffers), total_size);
2842 if (ret == GST_FLOW_OK)
2843 ret = gst_qt_mux_send_mdat_header (qtmux, &qtmux->header_size, total_size,
2845 for (i = 0; i < atom_array_get_len (&pad->fragment_buffers); i++) {
2846 if (G_LIKELY (ret == GST_FLOW_OK))
2847 ret = gst_qt_mux_send_buffer (qtmux,
2848 atom_array_index (&pad->fragment_buffers, i), &qtmux->header_size,
2851 gst_buffer_unref (atom_array_index (&pad->fragment_buffers, i));
2854 atom_array_clear (&pad->fragment_buffers);
2855 atom_moof_free (moof);
2856 qtmux->fragment_sequence++;
2861 if (G_UNLIKELY (!pad->traf)) {
2862 GST_LOG_OBJECT (qtmux, "setting up new fragment");
2863 pad->traf = atom_traf_new (qtmux->context, atom_trak_get_id (pad->trak));
2864 atom_array_init (&pad->fragment_buffers, 512);
2865 pad->fragment_duration = gst_util_uint64_scale (qtmux->fragment_duration,
2866 atom_trak_get_timescale (pad->trak), 1000);
2868 if (G_UNLIKELY (qtmux->mfra && !pad->tfra)) {
2869 pad->tfra = atom_tfra_new (qtmux->context, atom_trak_get_id (pad->trak));
2870 atom_mfra_add_tfra (qtmux->mfra, pad->tfra);
2872 atom_traf_set_base_decode_time (pad->traf, dts);
2875 /* add buffer and metadata */
2876 atom_traf_add_samples (pad->traf, delta, size, sync, pts_offset,
2878 atom_array_append (&pad->fragment_buffers, buf, 256);
2879 pad->fragment_duration -= delta;
2882 guint32 sn = atom_traf_get_sample_num (pad->traf);
2884 if ((sync && pad->sync) || (sn == 1 && !pad->sync))
2885 atom_tfra_add_entry (pad->tfra, dts, sn);
2888 if (G_UNLIKELY (force))
2894 /* Here's the clever bit of robust recording: Updating the moov
2895 * header is done using a ping-pong scheme inside 2 blocks of size
2896 * 'reserved_moov_size' at the start of the file, in such a way that the
2897 * file on-disk is always valid if interrupted.
2898 * Inside the reserved space, we have 2 pairs of free + moov atoms
2899 * (in that order), free-A + moov-A @ offset 0 and free-B + moov-B at
2900 * at offset "reserved_moov_size".
2902 * 1. Free-A has 0 size payload, moov-A immediately after is
2903 * active/current, and is padded with an internal Free atom to
2904 * end at reserved_space/2. Free-B is at reserved_space/2, sized
2905 * to cover the remaining free space (including moov-B).
2906 * 2. We write moov-B (which is invisible inside free-B), and pad it to
2907 * end at the end of free space. Then, we update free-A to size
2908 * reserved_space/2 + sizeof(free-B), which hides moov-A and the
2909 * free-B header, and makes moov-B active.
2910 * 3. Rewrite moov-A inside free-A, with padding out to free-B.
2911 * Change the size of free-A to make moov-A active again.
2912 * 4. Rinse and repeat.
2915 static GstFlowReturn
2916 gst_qt_mux_robust_recording_rewrite_moov (GstQTMux * qtmux)
2920 guint64 freeA_offset;
2921 guint32 new_freeA_size;
2922 guint64 new_moov_offset;
2924 /* Update moov info, then seek and rewrite the MOOV atom */
2925 gst_qt_mux_update_global_statistics (qtmux);
2926 gst_qt_mux_configure_moov (qtmux);
2928 gst_qt_mux_update_edit_lists (qtmux);
2930 /* tags into file metadata */
2931 gst_qt_mux_setup_metadata (qtmux);
2933 /* chunks position is set relative to the first byte of the
2934 * MDAT atom payload. Set the overall offset into the file */
2935 atom_moov_chunks_set_offset (qtmux->moov, qtmux->header_size);
2937 /* Calculate which moov to rewrite. qtmux->moov_pos points to
2938 * the start of the free-A header */
2939 freeA_offset = qtmux->moov_pos;
2940 if (qtmux->reserved_moov_first_active) {
2941 GST_DEBUG_OBJECT (qtmux, "Updating pong moov header");
2942 /* After this, freeA will include itself, moovA, plus the freeB
2944 new_freeA_size = qtmux->reserved_moov_size + 16;
2946 GST_DEBUG_OBJECT (qtmux, "Updating ping moov header");
2949 /* the moov we update is after free-A, calculate its offset */
2950 new_moov_offset = freeA_offset + new_freeA_size;
2952 /* Swap ping-pong cadence marker */
2953 qtmux->reserved_moov_first_active = !qtmux->reserved_moov_first_active;
2955 /* seek and rewrite the MOOV atom */
2956 gst_segment_init (&segment, GST_FORMAT_BYTES);
2957 segment.start = new_moov_offset;
2958 gst_pad_push_event (qtmux->srcpad, gst_event_new_segment (&segment));
2961 gst_qt_mux_send_moov (qtmux, NULL, qtmux->reserved_moov_size, FALSE,
2963 if (ret != GST_FLOW_OK)
2966 /* Update the estimated recording space remaining, based on amount used so
2967 * far and duration muxed so far */
2968 if (qtmux->last_moov_size > qtmux->base_moov_size && qtmux->last_dts > 0) {
2969 GstClockTime remain;
2970 GstClockTime time_muxed = qtmux->last_dts;
2973 gst_util_uint64_scale (qtmux->reserved_moov_size -
2974 qtmux->last_moov_size, time_muxed,
2975 qtmux->last_moov_size - qtmux->base_moov_size);
2976 /* Always under-estimate slightly, so users
2977 * have time to stop muxing before we run out */
2978 if (remain < GST_SECOND / 2)
2981 remain -= GST_SECOND / 2;
2983 GST_INFO_OBJECT (qtmux,
2984 "Reserved %u header bytes. Used %u in %" GST_TIME_FORMAT
2985 ". Remaining now %u or approx %" G_GUINT64_FORMAT " ns\n",
2986 qtmux->reserved_moov_size, qtmux->last_moov_size,
2987 GST_TIME_ARGS (qtmux->last_dts),
2988 qtmux->reserved_moov_size - qtmux->last_moov_size, remain);
2990 GST_OBJECT_LOCK (qtmux);
2991 qtmux->reserved_duration_remaining = remain;
2992 qtmux->muxed_since_last_update = 0;
2993 GST_DEBUG_OBJECT (qtmux, "reserved remaining duration now %"
2994 G_GUINT64_FORMAT, qtmux->reserved_duration_remaining);
2995 GST_OBJECT_UNLOCK (qtmux);
2999 /* Now update the moov-A size. Don't pass offset, since we don't need
3000 * send_free_atom() to seek for us - all our callers seek back to
3001 * where they need after this, or they don't need it */
3002 gst_segment_init (&segment, GST_FORMAT_BYTES);
3003 segment.start = freeA_offset;
3004 gst_pad_push_event (qtmux->srcpad, gst_event_new_segment (&segment));
3006 ret = gst_qt_mux_send_free_atom (qtmux, NULL, new_freeA_size, TRUE);
3011 static GstFlowReturn
3012 gst_qt_mux_robust_recording_update (GstQTMux * qtmux, GstClockTime position)
3015 GstFlowReturn flow_ret;
3017 guint64 mdat_offset = qtmux->mdat_pos + 16 + qtmux->mdat_size;
3019 GST_OBJECT_LOCK (qtmux);
3020 if (qtmux->reserved_moov_update_period == GST_CLOCK_TIME_NONE) {
3021 GST_OBJECT_UNLOCK (qtmux);
3025 /* Update if position is > the threshold or there's been no update yet */
3026 if (qtmux->last_moov_update != GST_CLOCK_TIME_NONE &&
3027 (position <= qtmux->last_moov_update ||
3028 (position - qtmux->last_moov_update) <
3029 qtmux->reserved_moov_update_period)) {
3030 /* Update the offset of how much we've muxed, so the
3031 * report of remaining space keeps counting down */
3032 if (position > qtmux->last_moov_update &&
3033 position - qtmux->last_moov_update > qtmux->muxed_since_last_update) {
3034 GST_LOG_OBJECT (qtmux,
3035 "Muxed time %" G_GUINT64_FORMAT " since last moov update",
3036 qtmux->muxed_since_last_update);
3037 qtmux->muxed_since_last_update = position - qtmux->last_moov_update;
3039 GST_OBJECT_UNLOCK (qtmux);
3040 return GST_FLOW_OK; /* No update needed yet */
3043 qtmux->last_moov_update = position;
3044 GST_OBJECT_UNLOCK (qtmux);
3046 GST_DEBUG_OBJECT (qtmux, "Update moov atom, position %" GST_TIME_FORMAT
3047 " mdat starts @ %" G_GUINT64_FORMAT " we were a %" G_GUINT64_FORMAT,
3048 GST_TIME_ARGS (position), qtmux->mdat_pos, mdat_offset);
3050 flow_ret = gst_qt_mux_robust_recording_rewrite_moov (qtmux);
3051 if (G_UNLIKELY (flow_ret != GST_FLOW_OK))
3054 /* Seek back to previous position */
3055 gst_segment_init (&segment, GST_FORMAT_BYTES);
3056 segment.start = mdat_offset;
3057 gst_pad_push_event (qtmux->srcpad, gst_event_new_segment (&segment));
3062 static GstFlowReturn
3063 gst_qt_mux_register_and_push_sample (GstQTMux * qtmux, GstQTPad * pad,
3064 GstBuffer * buffer, gboolean is_last_buffer, guint nsamples,
3065 gint64 last_dts, gint64 scaled_duration, guint sample_size,
3066 guint64 chunk_offset, gboolean sync, gboolean do_pts, gint64 pts_offset)
3068 GstFlowReturn ret = GST_FLOW_OK;
3070 /* note that a new chunk is started each time (not fancy but works) */
3071 if (qtmux->moov_recov_file) {
3072 if (!atoms_recov_write_trak_samples (qtmux->moov_recov_file, pad->trak,
3073 nsamples, (gint32) scaled_duration, sample_size, chunk_offset, sync,
3074 do_pts, pts_offset)) {
3075 GST_WARNING_OBJECT (qtmux, "Failed to write sample information to "
3076 "recovery file, disabling recovery");
3077 fclose (qtmux->moov_recov_file);
3078 qtmux->moov_recov_file = NULL;
3082 switch (qtmux->mux_mode) {
3083 case GST_QT_MUX_MODE_MOOV_AT_END:
3084 case GST_QT_MUX_MODE_FAST_START:
3085 case GST_QT_MUX_MODE_ROBUST_RECORDING:
3086 atom_trak_add_samples (pad->trak, nsamples, (gint32) scaled_duration,
3087 sample_size, chunk_offset, sync, pts_offset);
3088 ret = gst_qt_mux_send_buffer (qtmux, buffer, &qtmux->mdat_size, TRUE);
3089 /* Check if it's time to re-write the headers in robust-recording mode */
3090 if (ret == GST_FLOW_OK
3091 && qtmux->mux_mode == GST_QT_MUX_MODE_ROBUST_RECORDING)
3092 ret = gst_qt_mux_robust_recording_update (qtmux, pad->total_duration);
3094 case GST_QT_MUX_MODE_FRAGMENTED:
3095 case GST_QT_MUX_MODE_FRAGMENTED_STREAMABLE:
3096 /* ensure that always sync samples are marked as such */
3097 ret = gst_qt_mux_pad_fragment_add_buffer (qtmux, pad, buffer,
3098 is_last_buffer, nsamples, last_dts, (gint32) scaled_duration,
3099 sample_size, !pad->sync || sync, pts_offset);
3106 static GstFlowReturn
3107 gst_qt_mux_check_and_update_timecode (GstQTMux * qtmux, GstQTPad * pad,
3108 GstBuffer * buf, GstFlowReturn ret)
3110 GstVideoTimeCodeMeta *tc_meta;
3111 GstVideoTimeCode *tc;
3114 guint32 frames_since_daily_jam;
3116 if (buf == NULL || (pad->tc_trak != NULL && pad->tc_pos == -1))
3119 tc_meta = gst_buffer_get_video_time_code_meta (buf);
3125 /* This means we never got a timecode before */
3126 if (pad->first_tc == NULL) {
3127 #ifndef GST_DISABLE_GST_DEBUG
3128 gchar *tc_str = gst_video_time_code_to_string (tc);
3129 GST_DEBUG_OBJECT (qtmux, "Found first timecode %s", tc_str);
3132 g_assert (pad->tc_trak == NULL);
3133 tc_buf = gst_buffer_new_allocate (NULL, 4, NULL);
3134 pad->first_tc = gst_video_time_code_copy (tc);
3135 /* If frames are out of order, the frame we're currently getting might
3136 * not be the first one. Just write a 0 timecode for now and wait
3137 * until we receive a timecode that's lower than the current one */
3138 if (pad->is_out_of_order) {
3139 pad->first_pts = GST_BUFFER_PTS (buf);
3140 frames_since_daily_jam = 0;
3141 /* Position to rewrite */
3142 pad->tc_pos = qtmux->mdat_size;
3144 frames_since_daily_jam =
3145 gst_video_time_code_frames_since_daily_jam (pad->first_tc);
3146 frames_since_daily_jam = GUINT32_TO_BE (frames_since_daily_jam);
3148 /* Write the timecode trak now */
3149 pad->tc_trak = atom_trak_new (qtmux->context);
3150 atom_moov_add_trak (qtmux->moov, pad->tc_trak);
3152 pad->trak->tref = atom_tref_new (FOURCC_tmcd);
3153 atom_tref_add_entry (pad->trak->tref, pad->tc_trak->tkhd.track_ID);
3155 atom_trak_set_timecode_type (pad->tc_trak, qtmux->context, pad->first_tc);
3157 szret = gst_buffer_fill (tc_buf, 0, &frames_since_daily_jam, 4);
3158 g_assert (szret == 4);
3160 atom_trak_add_samples (pad->tc_trak, 1, 1, 4, qtmux->mdat_size, FALSE, 0);
3161 ret = gst_qt_mux_send_buffer (qtmux, tc_buf, &qtmux->mdat_size, TRUE);
3163 /* Need to reset the current chunk (of the previous pad) here because
3164 * some other data was written now above, and the pad has to start a
3166 qtmux->current_chunk_offset = -1;
3167 qtmux->current_chunk_size = 0;
3168 qtmux->current_chunk_duration = 0;
3169 } else if (pad->is_out_of_order) {
3170 /* Check for a lower timecode than the one stored */
3171 g_assert (pad->tc_trak != NULL);
3172 if (GST_BUFFER_DTS (buf) <= pad->first_pts) {
3173 if (gst_video_time_code_compare (tc, pad->first_tc) == -1) {
3174 gst_video_time_code_free (pad->first_tc);
3175 pad->first_tc = gst_video_time_code_copy (tc);
3178 guint64 bk_size = qtmux->mdat_size;
3180 /* If this frame's DTS is after the first PTS received, it means
3181 * we've already received the first frame to be presented. Otherwise
3182 * the decoder would need to go back in time */
3183 gst_qt_mux_update_timecode (qtmux, pad);
3185 /* Reset writing position */
3186 gst_segment_init (&segment, GST_FORMAT_BYTES);
3187 segment.start = bk_size;
3188 gst_pad_push_event (qtmux->srcpad, gst_event_new_segment (&segment));
3196 * Here we push the buffer and update the tables in the track atoms
3198 static GstFlowReturn
3199 gst_qt_mux_add_buffer (GstQTMux * qtmux, GstQTPad * pad, GstBuffer * buf)
3201 GstBuffer *last_buf = NULL;
3202 GstClockTime duration;
3203 guint nsamples, sample_size;
3204 guint64 chunk_offset;
3205 gint64 last_dts, scaled_duration;
3206 gint64 pts_offset = 0;
3207 gboolean sync = FALSE;
3208 GstFlowReturn ret = GST_FLOW_OK;
3211 goto not_negotiated;
3213 /* if this pad has a prepare function, call it */
3214 if (pad->prepare_buf_func != NULL) {
3215 buf = pad->prepare_buf_func (pad, buf, qtmux);
3218 ret = gst_qt_mux_check_and_update_timecode (qtmux, pad, buf, ret);
3219 if (ret != GST_FLOW_OK) {
3221 gst_buffer_unref (buf);
3225 last_buf = pad->last_buf;
3226 pad->last_buf = buf;
3228 if (last_buf == NULL) {
3229 #ifndef GST_DISABLE_GST_DEBUG
3231 GST_DEBUG_OBJECT (qtmux, "Pad %s has no previous buffer stored and "
3232 "received NULL buffer, doing nothing",
3233 GST_PAD_NAME (pad->collect.pad));
3235 GST_LOG_OBJECT (qtmux,
3236 "Pad %s has no previous buffer stored, storing now",
3237 GST_PAD_NAME (pad->collect.pad));
3240 qtmux->current_pad = pad;
3244 if (!GST_BUFFER_PTS_IS_VALID (last_buf))
3247 /* if this is the first buffer, store the timestamp */
3248 if (G_UNLIKELY (pad->first_ts == GST_CLOCK_TIME_NONE)) {
3249 if (GST_BUFFER_PTS_IS_VALID (last_buf)) {
3250 pad->first_ts = GST_BUFFER_PTS (last_buf);
3251 } else if (GST_BUFFER_DTS_IS_VALID (last_buf)) {
3252 pad->first_ts = GST_BUFFER_DTS (last_buf);
3255 if (GST_BUFFER_DTS_IS_VALID (last_buf)) {
3256 pad->first_dts = pad->last_dts = GST_BUFFER_DTS (last_buf);
3257 } else if (GST_BUFFER_PTS_IS_VALID (last_buf)) {
3258 pad->first_dts = pad->last_dts = GST_BUFFER_PTS (last_buf);
3261 if (GST_CLOCK_TIME_IS_VALID (pad->first_ts)) {
3262 GST_DEBUG ("setting first_ts to %" G_GUINT64_FORMAT, pad->first_ts);
3264 GST_WARNING_OBJECT (qtmux, "First buffer for pad %s has no timestamp, "
3265 "using 0 as first timestamp", GST_PAD_NAME (pad->collect.pad));
3266 pad->first_ts = pad->first_dts = 0;
3268 GST_DEBUG_OBJECT (qtmux, "Stored first timestamp for pad %s %"
3269 GST_TIME_FORMAT, GST_PAD_NAME (pad->collect.pad),
3270 GST_TIME_ARGS (pad->first_ts));
3273 if (buf && GST_CLOCK_TIME_IS_VALID (GST_BUFFER_DTS (buf)) &&
3274 GST_CLOCK_TIME_IS_VALID (GST_BUFFER_DTS (last_buf)) &&
3275 GST_BUFFER_DTS (buf) < GST_BUFFER_DTS (last_buf)) {
3276 GST_ERROR ("decreasing DTS value %" GST_TIME_FORMAT " < %" GST_TIME_FORMAT,
3277 GST_TIME_ARGS (GST_BUFFER_DTS (buf)),
3278 GST_TIME_ARGS (GST_BUFFER_DTS (last_buf)));
3279 buf = gst_buffer_make_writable (buf);
3280 GST_BUFFER_DTS (buf) = GST_BUFFER_DTS (last_buf);
3283 /* duration actually means time delta between samples, so we calculate
3284 * the duration based on the difference in DTS or PTS, falling back
3285 * to DURATION if the other two don't exist, such as with the last
3286 * sample before EOS. Or use 0 if nothing else is available */
3287 if (GST_BUFFER_DURATION_IS_VALID (last_buf))
3288 duration = GST_BUFFER_DURATION (last_buf);
3292 if (buf && GST_BUFFER_DTS_IS_VALID (buf)
3293 && GST_BUFFER_DTS_IS_VALID (last_buf))
3294 duration = GST_BUFFER_DTS (buf) - GST_BUFFER_DTS (last_buf);
3295 else if (buf && GST_BUFFER_PTS_IS_VALID (buf)
3296 && GST_BUFFER_PTS_IS_VALID (last_buf))
3297 duration = GST_BUFFER_PTS (buf) - GST_BUFFER_PTS (last_buf);
3300 if (qtmux->current_pad != pad || qtmux->current_chunk_offset == -1) {
3301 GST_DEBUG_OBJECT (qtmux,
3302 "Switching to next chunk for pad %s:%s: offset %" G_GUINT64_FORMAT
3303 ", size %" G_GUINT64_FORMAT ", duration %" GST_TIME_FORMAT,
3304 GST_DEBUG_PAD_NAME (pad->collect.pad), qtmux->current_chunk_offset,
3305 qtmux->current_chunk_size,
3306 GST_TIME_ARGS (qtmux->current_chunk_duration));
3307 qtmux->current_pad = pad;
3308 if (qtmux->current_chunk_offset == -1)
3309 qtmux->current_chunk_offset = qtmux->mdat_size;
3311 qtmux->current_chunk_offset += qtmux->current_chunk_size;
3312 qtmux->current_chunk_size = 0;
3313 qtmux->current_chunk_duration = 0;
3316 last_dts = gst_util_uint64_scale_round (pad->last_dts,
3317 atom_trak_get_timescale (pad->trak), GST_SECOND);
3319 /* fragments only deal with 1 buffer == 1 chunk (== 1 sample) */
3320 if (pad->sample_size && !qtmux->fragment_sequence) {
3321 /* Constant size packets: usually raw audio (with many samples per
3322 buffer (= chunk)), but can also be fixed-packet-size codecs like ADPCM
3324 sample_size = pad->sample_size;
3325 if (gst_buffer_get_size (last_buf) % sample_size != 0)
3326 goto fragmented_sample;
3327 /* note: qt raw audio storage warps it implicitly into a timewise
3328 * perfect stream, discarding buffer times */
3329 if (GST_BUFFER_DURATION (last_buf) != GST_CLOCK_TIME_NONE) {
3330 nsamples = gst_util_uint64_scale_round (GST_BUFFER_DURATION (last_buf),
3331 atom_trak_get_timescale (pad->trak), GST_SECOND);
3332 duration = GST_BUFFER_DURATION (last_buf);
3334 nsamples = gst_buffer_get_size (last_buf) / sample_size;
3336 gst_util_uint64_scale_round (nsamples, GST_SECOND,
3337 atom_trak_get_timescale (pad->trak));
3340 /* timescale = samplerate */
3341 scaled_duration = 1;
3342 pad->last_dts += duration * nsamples;
3345 sample_size = gst_buffer_get_size (last_buf);
3346 if ((buf && GST_BUFFER_DTS_IS_VALID (buf))
3347 || GST_BUFFER_DTS_IS_VALID (last_buf)) {
3349 if (buf && GST_BUFFER_DTS_IS_VALID (buf)) {
3350 pad->last_dts = GST_BUFFER_DTS (buf);
3352 pad->last_dts = GST_BUFFER_DTS (last_buf) + duration;
3354 if ((gint64) (pad->last_dts) < 0) {
3355 scaled_dts = -gst_util_uint64_scale_round (-pad->last_dts,
3356 atom_trak_get_timescale (pad->trak), GST_SECOND);
3358 scaled_dts = gst_util_uint64_scale_round (pad->last_dts,
3359 atom_trak_get_timescale (pad->trak), GST_SECOND);
3361 scaled_duration = scaled_dts - last_dts;
3362 last_dts = scaled_dts;
3364 /* first convert intended timestamp (in GstClockTime resolution) to
3365 * trak timescale, then derive delta;
3366 * this ensures sums of (scale)delta add up to converted timestamp,
3367 * which only deviates at most 1/scale from timestamp itself */
3368 scaled_duration = gst_util_uint64_scale_round (pad->last_dts + duration,
3369 atom_trak_get_timescale (pad->trak), GST_SECOND) - last_dts;
3370 pad->last_dts += duration;
3374 /* for computing the avg bitrate */
3375 pad->total_bytes += gst_buffer_get_size (last_buf);
3376 pad->total_duration += duration;
3377 qtmux->current_chunk_size += gst_buffer_get_size (last_buf);
3378 qtmux->current_chunk_duration += duration;
3380 chunk_offset = qtmux->current_chunk_offset;
3382 GST_LOG_OBJECT (qtmux,
3383 "Pad (%s) dts updated to %" GST_TIME_FORMAT,
3384 GST_PAD_NAME (pad->collect.pad), GST_TIME_ARGS (pad->last_dts));
3385 GST_LOG_OBJECT (qtmux,
3386 "Adding %d samples to track, duration: %" G_GUINT64_FORMAT
3387 " size: %" G_GUINT32_FORMAT " chunk offset: %" G_GUINT64_FORMAT,
3388 nsamples, scaled_duration, sample_size, chunk_offset);
3390 /* might be a sync sample */
3392 !GST_BUFFER_FLAG_IS_SET (last_buf, GST_BUFFER_FLAG_DELTA_UNIT)) {
3393 GST_LOG_OBJECT (qtmux, "Adding new sync sample entry for track of pad %s",
3394 GST_PAD_NAME (pad->collect.pad));
3398 if (GST_BUFFER_DTS_IS_VALID (last_buf)) {
3399 last_dts = gst_util_uint64_scale_round (GST_BUFFER_DTS (last_buf),
3400 atom_trak_get_timescale (pad->trak), GST_SECOND);
3402 (gint64) (gst_util_uint64_scale_round (GST_BUFFER_PTS (last_buf),
3403 atom_trak_get_timescale (pad->trak), GST_SECOND) - last_dts);
3406 last_dts = gst_util_uint64_scale_round (GST_BUFFER_PTS (last_buf),
3407 atom_trak_get_timescale (pad->trak), GST_SECOND);
3409 GST_DEBUG ("dts: %" GST_TIME_FORMAT " pts: %" GST_TIME_FORMAT
3410 " timebase_dts: %d pts_offset: %d",
3411 GST_TIME_ARGS (GST_BUFFER_DTS (last_buf)),
3412 GST_TIME_ARGS (GST_BUFFER_PTS (last_buf)),
3413 (int) (last_dts), (int) (pts_offset));
3415 if (GST_CLOCK_TIME_IS_VALID (duration)
3416 && (qtmux->current_chunk_duration > qtmux->longest_chunk
3417 || !GST_CLOCK_TIME_IS_VALID (qtmux->longest_chunk))) {
3418 GST_DEBUG_OBJECT (qtmux,
3419 "New longest chunk found: %" GST_TIME_FORMAT ", pad %s",
3420 GST_TIME_ARGS (qtmux->current_chunk_duration),
3421 GST_PAD_NAME (pad->collect.pad));
3422 qtmux->longest_chunk = qtmux->current_chunk_duration;
3425 /* now we go and register this buffer/sample all over */
3426 ret = gst_qt_mux_register_and_push_sample (qtmux, pad, last_buf,
3427 buf == NULL, nsamples, last_dts, scaled_duration, sample_size,
3428 chunk_offset, sync, TRUE, pts_offset);
3430 /* if this is sparse and we have a next buffer, check if there is any gap
3431 * between them to insert an empty sample */
3432 if (pad->sparse && buf) {
3433 if (pad->create_empty_buffer) {
3434 GstBuffer *empty_buf;
3435 gint64 empty_duration =
3436 GST_BUFFER_PTS (buf) - (GST_BUFFER_PTS (last_buf) + duration);
3437 gint64 empty_duration_scaled;
3439 empty_buf = pad->create_empty_buffer (pad, empty_duration);
3441 empty_duration_scaled = gst_util_uint64_scale_round (empty_duration,
3442 atom_trak_get_timescale (pad->trak), GST_SECOND);
3444 pad->total_bytes += gst_buffer_get_size (empty_buf);
3445 pad->total_duration += duration;
3448 gst_qt_mux_register_and_push_sample (qtmux, pad, empty_buf, FALSE, 1,
3449 last_dts + scaled_duration, empty_duration_scaled,
3450 gst_buffer_get_size (empty_buf), chunk_offset, sync, TRUE, 0);
3452 /* our only case currently is tx3g subtitles, so there is no reason to fill this yet */
3453 g_assert_not_reached ();
3454 GST_WARNING_OBJECT (qtmux,
3455 "no empty buffer creation function found for pad %s",
3456 GST_PAD_NAME (pad->collect.pad));
3467 gst_buffer_unref (last_buf);
3468 return GST_FLOW_ERROR;
3472 GST_ELEMENT_ERROR (qtmux, STREAM, MUX, (NULL),
3473 ("Audio buffer contains fragmented sample."));
3478 GST_ELEMENT_ERROR (qtmux, STREAM, MUX, (NULL), ("Buffer has no PTS."));
3483 GST_ELEMENT_ERROR (qtmux, CORE, NEGOTIATION, (NULL),
3484 ("format wasn't negotiated before buffer flow on pad %s",
3485 GST_PAD_NAME (pad->collect.pad)));
3487 gst_buffer_unref (buf);
3488 return GST_FLOW_NOT_NEGOTIATED;
3493 * DTS running time can be negative. There is no way to represent that in
3494 * MP4 however, thus we need to offset DTS so that it starts from 0.
3497 gst_qt_pad_adjust_buffer_dts (GstQTMux * qtmux, GstQTPad * pad,
3498 GstCollectData * cdata, GstBuffer ** buf)
3503 pts = GST_BUFFER_PTS (*buf);
3504 dts = GST_COLLECT_PADS_DTS (cdata);
3506 GST_LOG_OBJECT (qtmux, "selected pad %s with PTS %" GST_TIME_FORMAT
3507 " and DTS %" GST_STIME_FORMAT, GST_PAD_NAME (cdata->pad),
3508 GST_TIME_ARGS (pts), GST_STIME_ARGS (dts));
3510 if (!GST_CLOCK_TIME_IS_VALID (pad->dts_adjustment)) {
3511 if (GST_CLOCK_STIME_IS_VALID (dts) && dts < 0)
3512 pad->dts_adjustment = -dts;
3514 pad->dts_adjustment = 0;
3517 if (pad->dts_adjustment > 0) {
3518 *buf = gst_buffer_make_writable (*buf);
3520 dts += pad->dts_adjustment;
3522 if (GST_CLOCK_TIME_IS_VALID (pts))
3523 pts += pad->dts_adjustment;
3525 if (GST_CLOCK_STIME_IS_VALID (dts) && dts < 0) {
3526 GST_WARNING_OBJECT (pad, "Decreasing DTS.");
3531 GST_WARNING_OBJECT (pad, "DTS is bigger then PTS");
3535 GST_BUFFER_PTS (*buf) = pts;
3536 GST_BUFFER_DTS (*buf) = dts;
3538 GST_LOG_OBJECT (qtmux, "time adjusted to PTS %" GST_TIME_FORMAT
3539 " and DTS %" GST_TIME_FORMAT, GST_TIME_ARGS (pts), GST_TIME_ARGS (dts));
3544 find_best_pad (GstQTMux * qtmux, GstCollectPads * pads)
3547 GstQTPad *best_pad = NULL;
3549 if (qtmux->current_pad &&
3550 (qtmux->interleave_bytes != 0 || qtmux->interleave_time != 0) &&
3551 (qtmux->interleave_bytes == 0
3552 || qtmux->current_chunk_size <= qtmux->interleave_bytes)
3553 && (qtmux->interleave_time == 0
3554 || qtmux->current_chunk_duration <= qtmux->interleave_time)
3555 && qtmux->mux_mode != GST_QT_MUX_MODE_FRAGMENTED
3556 && qtmux->mux_mode != GST_QT_MUX_MODE_FRAGMENTED_STREAMABLE) {
3557 GstBuffer *tmp_buf =
3558 gst_collect_pads_peek (pads, (GstCollectData *) qtmux->current_pad);
3560 if (tmp_buf || qtmux->current_pad->last_buf) {
3561 best_pad = qtmux->current_pad;
3563 gst_buffer_unref (tmp_buf);
3564 GST_DEBUG_OBJECT (qtmux, "Reusing pad %s:%s",
3565 GST_DEBUG_PAD_NAME (best_pad->collect.pad));
3567 } else if (qtmux->collect->data->next) {
3568 /* Only switch pads if we have more than one, otherwise
3569 * we can just put everything into a single chunk and save
3570 * a few bytes of offsets
3572 if (qtmux->current_pad)
3573 GST_DEBUG_OBJECT (qtmux, "Switching from pad %s:%s",
3574 GST_DEBUG_PAD_NAME (qtmux->current_pad->collect.pad));
3575 best_pad = qtmux->current_pad = NULL;
3579 GstClockTime best_time = GST_CLOCK_TIME_NONE;
3581 for (walk = qtmux->collect->data; walk; walk = g_slist_next (walk)) {
3582 GstCollectData *cdata = (GstCollectData *) walk->data;
3583 GstQTPad *qtpad = (GstQTPad *) cdata;
3585 GstClockTime timestamp;
3587 tmp_buf = gst_collect_pads_peek (pads, cdata);
3589 /* This one is newly EOS now, finish it for real */
3590 if (qtpad->last_buf) {
3591 timestamp = GST_BUFFER_DTS_OR_PTS (qtpad->last_buf);
3596 if (qtpad->last_buf)
3597 timestamp = GST_BUFFER_DTS_OR_PTS (qtpad->last_buf);
3599 timestamp = GST_BUFFER_DTS_OR_PTS (tmp_buf);
3602 if (best_pad == NULL ||
3603 !GST_CLOCK_TIME_IS_VALID (best_time) || timestamp < best_time) {
3605 best_time = timestamp;
3609 gst_buffer_unref (tmp_buf);
3613 GST_DEBUG_OBJECT (qtmux, "Choosing pad %s:%s",
3614 GST_DEBUG_PAD_NAME (best_pad->collect.pad));
3616 GST_DEBUG_OBJECT (qtmux, "No best pad: EOS");
3623 static GstFlowReturn
3624 gst_qt_mux_collected (GstCollectPads * pads, gpointer user_data)
3626 GstFlowReturn ret = GST_FLOW_OK;
3627 GstQTMux *qtmux = GST_QT_MUX_CAST (user_data);
3628 GstQTPad *best_pad = NULL;
3630 if (G_UNLIKELY (qtmux->state == GST_QT_MUX_STATE_STARTED)) {
3631 if ((ret = gst_qt_mux_start_file (qtmux)) != GST_FLOW_OK)
3634 qtmux->state = GST_QT_MUX_STATE_DATA;
3637 if (G_UNLIKELY (qtmux->state == GST_QT_MUX_STATE_EOS))
3638 return GST_FLOW_EOS;
3640 best_pad = find_best_pad (qtmux, pads);
3642 /* clipping already converted to running time */
3643 if (best_pad != NULL) {
3644 GstBuffer *buf = gst_collect_pads_pop (pads, (GstCollectData *) best_pad);
3646 g_assert (buf || best_pad->last_buf);
3648 gst_qt_pad_adjust_buffer_dts (qtmux, best_pad,
3649 (GstCollectData *) best_pad, &buf);
3651 ret = gst_qt_mux_add_buffer (qtmux, best_pad, buf);
3653 qtmux->state = GST_QT_MUX_STATE_EOS;
3654 ret = gst_qt_mux_stop_file (qtmux);
3655 if (ret == GST_FLOW_OK) {
3656 GST_DEBUG_OBJECT (qtmux, "Pushing eos");
3657 gst_pad_push_event (qtmux->srcpad, gst_event_new_eos ());
3660 GST_WARNING_OBJECT (qtmux, "Failed to stop file: %s",
3661 gst_flow_get_name (ret));
3669 check_field (GQuark field_id, const GValue * value, gpointer user_data)
3671 GstStructure *structure = (GstStructure *) user_data;
3672 const GValue *other = gst_structure_id_get_value (structure, field_id);
3675 return gst_value_compare (value, other) == GST_VALUE_EQUAL;
3679 gst_qtmux_caps_is_subset_full (GstQTMux * qtmux, GstCaps * subset,
3682 GstStructure *sub_s = gst_caps_get_structure (subset, 0);
3683 GstStructure *sup_s = gst_caps_get_structure (superset, 0);
3685 return gst_structure_foreach (sub_s, check_field, sup_s);
3689 gst_qt_mux_audio_sink_set_caps (GstQTPad * qtpad, GstCaps * caps)
3691 GstPad *pad = qtpad->collect.pad;
3692 GstQTMux *qtmux = GST_QT_MUX_CAST (gst_pad_get_parent (pad));
3693 GstQTMuxClass *qtmux_klass = (GstQTMuxClass *) (G_OBJECT_GET_CLASS (qtmux));
3694 GstStructure *structure;
3695 const gchar *mimetype;
3696 gint rate, channels;
3697 const GValue *value = NULL;
3698 const GstBuffer *codec_data = NULL;
3699 GstQTMuxFormat format;
3700 AudioSampleEntry entry = { 0, };
3701 AtomInfo *ext_atom = NULL;
3702 gint constant_size = 0;
3703 const gchar *stream_format;
3705 qtpad->prepare_buf_func = NULL;
3707 /* does not go well to renegotiate stream mid-way, unless
3708 * the old caps are a subset of the new one (this means upstream
3709 * added more info to the caps, as both should be 'fixed' caps) */
3710 if (qtpad->fourcc) {
3711 GstCaps *current_caps;
3713 current_caps = gst_pad_get_current_caps (pad);
3714 g_assert (caps != NULL);
3716 if (!gst_qtmux_caps_is_subset_full (qtmux, current_caps, caps)) {
3717 gst_caps_unref (current_caps);
3718 goto refuse_renegotiation;
3720 GST_DEBUG_OBJECT (qtmux,
3721 "pad %s accepted renegotiation to %" GST_PTR_FORMAT " from %"
3722 GST_PTR_FORMAT, GST_PAD_NAME (pad), caps, current_caps);
3723 gst_caps_unref (current_caps);
3726 GST_DEBUG_OBJECT (qtmux, "%s:%s, caps=%" GST_PTR_FORMAT,
3727 GST_DEBUG_PAD_NAME (pad), caps);
3729 format = qtmux_klass->format;
3730 structure = gst_caps_get_structure (caps, 0);
3731 mimetype = gst_structure_get_name (structure);
3734 if (!gst_structure_get_int (structure, "channels", &channels) ||
3735 !gst_structure_get_int (structure, "rate", &rate)) {
3740 value = gst_structure_get_value (structure, "codec_data");
3742 codec_data = gst_value_get_buffer (value);
3744 qtpad->is_out_of_order = FALSE;
3746 /* set common properties */
3747 entry.sample_rate = rate;
3748 entry.channels = channels;
3750 entry.sample_size = 16;
3751 /* this is the typical compressed case */
3752 if (format == GST_QT_MUX_FORMAT_QT) {
3754 entry.compression_id = -2;
3757 /* now map onto a fourcc, and some extra properties */
3758 if (strcmp (mimetype, "audio/mpeg") == 0) {
3759 gint mpegversion = 0, mpegaudioversion = 0;
3762 gst_structure_get_int (structure, "mpegversion", &mpegversion);
3763 switch (mpegversion) {
3765 gst_structure_get_int (structure, "layer", &layer);
3766 gst_structure_get_int (structure, "mpegaudioversion",
3770 /* note: QuickTime player does not like mp3 either way in iso/mp4 */
3771 if (format == GST_QT_MUX_FORMAT_QT)
3772 entry.fourcc = FOURCC__mp3;
3774 entry.fourcc = FOURCC_mp4a;
3776 build_esds_extension (qtpad->trak, ESDS_OBJECT_TYPE_MPEG1_P3,
3777 ESDS_STREAM_TYPE_AUDIO, codec_data, qtpad->avg_bitrate,
3778 qtpad->max_bitrate);
3781 g_warn_if_fail (format == GST_QT_MUX_FORMAT_MP4);
3782 entry.samples_per_packet = 384;
3783 } else if (layer == 2) {
3784 g_warn_if_fail (format == GST_QT_MUX_FORMAT_MP4);
3785 entry.samples_per_packet = 1152;
3787 g_warn_if_fail (layer == 3);
3788 entry.samples_per_packet = (mpegaudioversion <= 1) ? 1152 : 576;
3790 entry.bytes_per_sample = 2;
3794 /* check stream-format */
3795 stream_format = gst_structure_get_string (structure, "stream-format");
3796 if (stream_format) {
3797 if (strcmp (stream_format, "raw") != 0) {
3798 GST_WARNING_OBJECT (qtmux, "Unsupported AAC stream-format %s, "
3799 "please use 'raw'", stream_format);
3803 GST_WARNING_OBJECT (qtmux, "No stream-format present in caps, "
3807 if (!codec_data || gst_buffer_get_size ((GstBuffer *) codec_data) < 2) {
3808 GST_WARNING_OBJECT (qtmux, "no (valid) codec_data for AAC audio");
3813 gst_buffer_extract ((GstBuffer *) codec_data, 0, &profile, 1);
3814 /* warn if not Low Complexity profile */
3817 GST_WARNING_OBJECT (qtmux,
3818 "non-LC AAC may not run well on (Apple) QuickTime/iTunes");
3822 entry.fourcc = FOURCC_mp4a;
3824 if (format == GST_QT_MUX_FORMAT_QT)
3825 ext_atom = build_mov_aac_extension (qtpad->trak, codec_data,
3826 qtpad->avg_bitrate, qtpad->max_bitrate);
3829 build_esds_extension (qtpad->trak, ESDS_OBJECT_TYPE_MPEG4_P3,
3830 ESDS_STREAM_TYPE_AUDIO, codec_data, qtpad->avg_bitrate,
3831 qtpad->max_bitrate);
3836 } else if (strcmp (mimetype, "audio/AMR") == 0) {
3837 entry.fourcc = FOURCC_samr;
3838 entry.sample_size = 16;
3839 entry.samples_per_packet = 160;
3840 entry.bytes_per_sample = 2;
3841 ext_atom = build_amr_extension ();
3842 } else if (strcmp (mimetype, "audio/AMR-WB") == 0) {
3843 entry.fourcc = FOURCC_sawb;
3844 entry.sample_size = 16;
3845 entry.samples_per_packet = 320;
3846 entry.bytes_per_sample = 2;
3847 ext_atom = build_amr_extension ();
3848 } else if (strcmp (mimetype, "audio/x-raw") == 0) {
3851 gst_audio_info_init (&info);
3852 if (!gst_audio_info_from_caps (&info, caps))
3855 /* spec has no place for a distinction in these */
3856 if (info.finfo->width != info.finfo->depth) {
3857 GST_DEBUG_OBJECT (qtmux, "width must be same as depth!");
3861 if ((info.finfo->flags & GST_AUDIO_FORMAT_FLAG_SIGNED)) {
3862 if (info.finfo->endianness == G_LITTLE_ENDIAN)
3863 entry.fourcc = FOURCC_sowt;
3864 else if (info.finfo->endianness == G_BIG_ENDIAN)
3865 entry.fourcc = FOURCC_twos;
3867 entry.fourcc = FOURCC_sowt;
3868 /* maximum backward compatibility; only new version for > 16 bit */
3869 if (info.finfo->depth <= 16)
3871 /* not compressed in any case */
3872 entry.compression_id = 0;
3873 /* QT spec says: max at 16 bit even if sample size were actually larger,
3874 * however, most players (e.g. QuickTime!) seem to disagree, so ... */
3875 entry.sample_size = info.finfo->depth;
3876 entry.bytes_per_sample = info.finfo->depth / 8;
3877 entry.samples_per_packet = 1;
3878 entry.bytes_per_packet = info.finfo->depth / 8;
3879 entry.bytes_per_frame = entry.bytes_per_packet * info.channels;
3881 if (info.finfo->width == 8 && info.finfo->depth == 8) {
3882 /* fall back to old 8-bit version */
3883 entry.fourcc = FOURCC_raw_;
3885 entry.compression_id = 0;
3886 entry.sample_size = 8;
3888 GST_DEBUG_OBJECT (qtmux, "non 8-bit PCM must be signed");
3892 constant_size = (info.finfo->depth / 8) * info.channels;
3893 } else if (strcmp (mimetype, "audio/x-alaw") == 0) {
3894 entry.fourcc = FOURCC_alaw;
3895 entry.samples_per_packet = 1023;
3896 entry.bytes_per_sample = 2;
3897 } else if (strcmp (mimetype, "audio/x-mulaw") == 0) {
3898 entry.fourcc = FOURCC_ulaw;
3899 entry.samples_per_packet = 1023;
3900 entry.bytes_per_sample = 2;
3901 } else if (strcmp (mimetype, "audio/x-adpcm") == 0) {
3903 if (!gst_structure_get_int (structure, "block_align", &blocksize)) {
3904 GST_DEBUG_OBJECT (qtmux, "broken caps, block_align missing");
3907 /* Currently only supports WAV-style IMA ADPCM, for which the codec id is
3909 entry.fourcc = MS_WAVE_FOURCC (0x11);
3910 /* 4 byte header per channel (including one sample). 2 samples per byte
3911 remaining. Simplifying gives the following (samples per block per
3913 entry.samples_per_packet = 2 * blocksize / channels - 7;
3914 entry.bytes_per_sample = 2;
3916 entry.bytes_per_frame = blocksize;
3917 entry.bytes_per_packet = blocksize / channels;
3918 /* ADPCM has constant size packets */
3920 /* TODO: I don't really understand why this helps, but it does! Constant
3921 * size and compression_id of -2 seem to be incompatible, and other files
3922 * in the wild use this too. */
3923 entry.compression_id = -1;
3925 ext_atom = build_ima_adpcm_extension (channels, rate, blocksize);
3926 } else if (strcmp (mimetype, "audio/x-alac") == 0) {
3927 GstBuffer *codec_config;
3931 entry.fourcc = FOURCC_alac;
3932 gst_buffer_map ((GstBuffer *) codec_data, &map, GST_MAP_READ);
3933 /* let's check if codec data already comes with 'alac' atom prefix */
3934 if (!codec_data || (len = map.size) < 28) {
3935 GST_DEBUG_OBJECT (qtmux, "broken caps, codec data missing");
3936 gst_buffer_unmap ((GstBuffer *) codec_data, &map);
3939 if (GST_READ_UINT32_LE (map.data + 4) == FOURCC_alac) {
3942 gst_buffer_copy_region ((GstBuffer *) codec_data,
3943 GST_BUFFER_COPY_MEMORY, 8, len);
3945 codec_config = gst_buffer_ref ((GstBuffer *) codec_data);
3947 gst_buffer_unmap ((GstBuffer *) codec_data, &map);
3949 /* does not look good, but perhaps some trailing unneeded stuff */
3950 GST_WARNING_OBJECT (qtmux, "unexpected codec-data size, possibly broken");
3952 if (format == GST_QT_MUX_FORMAT_QT)
3953 ext_atom = build_mov_alac_extension (codec_config);
3955 ext_atom = build_codec_data_extension (FOURCC_alac, codec_config);
3956 /* set some more info */
3957 gst_buffer_map (codec_config, &map, GST_MAP_READ);
3958 entry.bytes_per_sample = 2;
3959 entry.samples_per_packet = GST_READ_UINT32_BE (map.data + 4);
3960 gst_buffer_unmap (codec_config, &map);
3961 gst_buffer_unref (codec_config);
3962 } else if (strcmp (mimetype, "audio/x-ac3") == 0) {
3963 entry.fourcc = FOURCC_ac_3;
3965 /* Fixed values according to TS 102 366 but it also mentions that
3966 * they should be ignored */
3968 entry.sample_size = 16;
3970 /* AC-3 needs an extension atom but its data can only be obtained from
3971 * the stream itself. Abuse the prepare_buf_func so we parse a frame
3972 * and get the needed data */
3973 qtpad->prepare_buf_func = gst_qt_mux_prepare_parse_ac3_frame;
3974 } else if (strcmp (mimetype, "audio/x-opus") == 0) {
3975 /* Based on the specification defined in:
3976 * https://www.opus-codec.org/docs/opus_in_isobmff.html */
3977 guint8 channels, mapping_family, stream_count, coupled_count;
3981 guint8 channel_mapping[256];
3982 const GValue *streamheader;
3983 const GValue *first_element;
3986 entry.fourcc = FOURCC_opus;
3987 entry.sample_size = 16;
3989 streamheader = gst_structure_get_value (structure, "streamheader");
3990 if (streamheader && GST_VALUE_HOLDS_ARRAY (streamheader) &&
3991 gst_value_array_get_size (streamheader) != 0) {
3992 first_element = gst_value_array_get_value (streamheader, 0);
3993 header = gst_value_get_buffer (first_element);
3994 if (!gst_codec_utils_opus_parse_header (header, &rate, &channels,
3995 &mapping_family, &stream_count, &coupled_count, channel_mapping,
3996 &pre_skip, &output_gain)) {
3997 GST_ERROR_OBJECT (qtmux, "Incomplete OpusHead");
4001 GST_WARNING_OBJECT (qtmux,
4002 "no streamheader field in caps %" GST_PTR_FORMAT, caps);
4004 if (!gst_codec_utils_opus_parse_caps (caps, &rate, &channels,
4005 &mapping_family, &stream_count, &coupled_count,
4007 GST_ERROR_OBJECT (qtmux, "Incomplete Opus caps");
4014 entry.channels = channels;
4015 ext_atom = build_opus_extension (rate, channels, mapping_family,
4016 stream_count, coupled_count, channel_mapping, pre_skip, output_gain);
4022 /* ok, set the pad info accordingly */
4023 qtpad->fourcc = entry.fourcc;
4024 qtpad->sample_size = constant_size;
4026 (SampleTableEntry *) atom_trak_set_audio_type (qtpad->trak,
4027 qtmux->context, &entry,
4028 qtmux->trak_timescale ? qtmux->trak_timescale : entry.sample_rate,
4029 ext_atom, constant_size);
4031 gst_object_unref (qtmux);
4037 GST_WARNING_OBJECT (qtmux, "pad %s refused caps %" GST_PTR_FORMAT,
4038 GST_PAD_NAME (pad), caps);
4039 gst_object_unref (qtmux);
4042 refuse_renegotiation:
4044 GST_WARNING_OBJECT (qtmux,
4045 "pad %s refused renegotiation to %" GST_PTR_FORMAT,
4046 GST_PAD_NAME (pad), caps);
4047 gst_object_unref (qtmux);
4052 /* return number of centiframes per second */
4054 adjust_rate (gint n, gint d)
4059 if (d != 1 && d != 1001) {
4060 /* otherwise there are probably rounding errors and we should rather guess
4061 * if it's close enough to a well known framerate */
4062 gst_video_guess_framerate (gst_util_uint64_scale (d, GST_SECOND, n), &n,
4066 return gst_util_uint64_scale (n, 100, d);
4070 gst_qt_mux_video_sink_set_caps (GstQTPad * qtpad, GstCaps * caps)
4072 GstPad *pad = qtpad->collect.pad;
4073 GstQTMux *qtmux = GST_QT_MUX_CAST (gst_pad_get_parent (pad));
4074 GstQTMuxClass *qtmux_klass = (GstQTMuxClass *) (G_OBJECT_GET_CLASS (qtmux));
4075 GstStructure *structure;
4076 const gchar *mimetype;
4077 gint width, height, depth = -1;
4078 gint framerate_num, framerate_den;
4080 const GValue *value = NULL;
4081 const GstBuffer *codec_data = NULL;
4082 VisualSampleEntry entry = { 0, };
4083 GstQTMuxFormat format;
4084 AtomInfo *ext_atom = NULL;
4085 GList *ext_atom_list = NULL;
4086 gboolean sync = FALSE;
4087 int par_num, par_den;
4089 qtpad->prepare_buf_func = NULL;
4091 /* does not go well to renegotiate stream mid-way, unless
4092 * the old caps are a subset of the new one (this means upstream
4093 * added more info to the caps, as both should be 'fixed' caps) */
4094 if (qtpad->fourcc) {
4095 GstCaps *current_caps;
4097 current_caps = gst_pad_get_current_caps (pad);
4098 g_assert (caps != NULL);
4100 if (!gst_qtmux_caps_is_subset_full (qtmux, current_caps, caps)) {
4101 gst_caps_unref (current_caps);
4102 goto refuse_renegotiation;
4104 GST_DEBUG_OBJECT (qtmux,
4105 "pad %s accepted renegotiation to %" GST_PTR_FORMAT " from %"
4106 GST_PTR_FORMAT, GST_PAD_NAME (pad), caps, current_caps);
4107 gst_caps_unref (current_caps);
4110 GST_DEBUG_OBJECT (qtmux, "%s:%s, caps=%" GST_PTR_FORMAT,
4111 GST_DEBUG_PAD_NAME (pad), caps);
4113 format = qtmux_klass->format;
4114 structure = gst_caps_get_structure (caps, 0);
4115 mimetype = gst_structure_get_name (structure);
4117 /* required parts */
4118 if (!gst_structure_get_int (structure, "width", &width) ||
4119 !gst_structure_get_int (structure, "height", &height))
4124 /* works as a default timebase */
4125 framerate_num = 10000;
4127 gst_structure_get_fraction (structure, "framerate", &framerate_num,
4129 gst_structure_get_int (structure, "depth", &depth);
4130 value = gst_structure_get_value (structure, "codec_data");
4132 codec_data = gst_value_get_buffer (value);
4136 gst_structure_get_fraction (structure, "pixel-aspect-ratio", &par_num,
4139 qtpad->is_out_of_order = FALSE;
4141 /* bring frame numerator into a range that ensures both reasonable resolution
4142 * as well as a fair duration */
4143 rate = qtmux->trak_timescale ?
4144 qtmux->trak_timescale : adjust_rate (framerate_num, framerate_den);
4145 GST_DEBUG_OBJECT (qtmux, "Rate of video track selected: %" G_GUINT32_FORMAT,
4148 /* set common properties */
4149 entry.width = width;
4150 entry.height = height;
4151 entry.par_n = par_num;
4152 entry.par_d = par_den;
4153 /* should be OK according to qt and iso spec, override if really needed */
4154 entry.color_table_id = -1;
4155 entry.frame_count = 1;
4158 /* sync entries by default */
4161 /* now map onto a fourcc, and some extra properties */
4162 if (strcmp (mimetype, "video/x-raw") == 0) {
4163 const gchar *format;
4165 const GstVideoFormatInfo *vinfo;
4167 format = gst_structure_get_string (structure, "format");
4168 fmt = gst_video_format_from_string (format);
4169 vinfo = gst_video_format_get_info (fmt);
4172 case GST_VIDEO_FORMAT_UYVY:
4175 entry.fourcc = FOURCC_2vuy;
4176 entry.depth = depth;
4179 case GST_VIDEO_FORMAT_v210:
4182 entry.fourcc = FOURCC_v210;
4183 entry.depth = depth;
4187 if (GST_VIDEO_FORMAT_INFO_FLAGS (vinfo) & GST_VIDEO_FORMAT_FLAG_RGB) {
4188 entry.fourcc = FOURCC_raw_;
4189 entry.depth = GST_VIDEO_FORMAT_INFO_PSTRIDE (vinfo, 0) * 8;
4194 } else if (strcmp (mimetype, "video/x-h263") == 0) {
4196 if (format == GST_QT_MUX_FORMAT_QT)
4197 entry.fourcc = FOURCC_h263;
4199 entry.fourcc = FOURCC_s263;
4200 ext_atom = build_h263_extension ();
4201 if (ext_atom != NULL)
4202 ext_atom_list = g_list_prepend (ext_atom_list, ext_atom);
4203 } else if (strcmp (mimetype, "video/x-divx") == 0 ||
4204 strcmp (mimetype, "video/mpeg") == 0) {
4207 if (strcmp (mimetype, "video/x-divx") == 0) {
4208 gst_structure_get_int (structure, "divxversion", &version);
4209 version = version == 5 ? 1 : 0;
4211 gst_structure_get_int (structure, "mpegversion", &version);
4212 version = version == 4 ? 1 : 0;
4215 entry.fourcc = FOURCC_mp4v;
4217 build_esds_extension (qtpad->trak, ESDS_OBJECT_TYPE_MPEG4_P2,
4218 ESDS_STREAM_TYPE_VISUAL, codec_data, qtpad->avg_bitrate,
4219 qtpad->max_bitrate);
4220 if (ext_atom != NULL)
4221 ext_atom_list = g_list_prepend (ext_atom_list, ext_atom);
4223 GST_WARNING_OBJECT (qtmux, "no codec_data for MPEG4 video; "
4224 "output might not play in Apple QuickTime (try global-headers?)");
4226 } else if (strcmp (mimetype, "video/x-h264") == 0) {
4228 GST_WARNING_OBJECT (qtmux, "no codec_data in h264 caps");
4232 entry.fourcc = FOURCC_avc1;
4234 ext_atom = build_btrt_extension (0, qtpad->avg_bitrate, qtpad->max_bitrate);
4235 if (ext_atom != NULL)
4236 ext_atom_list = g_list_prepend (ext_atom_list, ext_atom);
4237 ext_atom = build_codec_data_extension (FOURCC_avcC, codec_data);
4238 if (ext_atom != NULL)
4239 ext_atom_list = g_list_prepend (ext_atom_list, ext_atom);
4240 } else if (strcmp (mimetype, "video/x-h265") == 0) {
4241 const gchar *format;
4244 GST_WARNING_OBJECT (qtmux, "no codec_data in h265 caps");
4248 format = gst_structure_get_string (structure, "stream-format");
4249 if (strcmp (format, "hvc1") == 0)
4250 entry.fourcc = FOURCC_hvc1;
4251 else if (strcmp (format, "hev1") == 0)
4252 entry.fourcc = FOURCC_hev1;
4254 ext_atom = build_btrt_extension (0, qtpad->avg_bitrate, qtpad->max_bitrate);
4255 if (ext_atom != NULL)
4256 ext_atom_list = g_list_prepend (ext_atom_list, ext_atom);
4258 ext_atom = build_codec_data_extension (FOURCC_hvcC, codec_data);
4259 if (ext_atom != NULL)
4260 ext_atom_list = g_list_prepend (ext_atom_list, ext_atom);
4262 } else if (strcmp (mimetype, "video/x-svq") == 0) {
4264 const GstBuffer *seqh = NULL;
4265 const GValue *seqh_value;
4268 gst_structure_get_int (structure, "svqversion", &version);
4270 entry.fourcc = FOURCC_SVQ3;
4274 seqh_value = gst_structure_get_value (structure, "seqh");
4276 seqh = gst_value_get_buffer (seqh_value);
4277 ext_atom = build_SMI_atom (seqh);
4279 ext_atom_list = g_list_prepend (ext_atom_list, ext_atom);
4282 /* we need to add the gamma anyway because quicktime might crash
4283 * when it doesn't find it */
4284 if (!gst_structure_get_double (structure, "applied-gamma", &gamma)) {
4285 /* it seems that using 0 here makes it ignored */
4288 ext_atom = build_gama_atom (gamma);
4290 ext_atom_list = g_list_prepend (ext_atom_list, ext_atom);
4292 GST_WARNING_OBJECT (qtmux, "SVQ version %d not supported. Please file "
4293 "a bug at http://bugzilla.gnome.org", version);
4295 } else if (strcmp (mimetype, "video/x-dv") == 0) {
4297 gboolean pal = TRUE;
4300 if (framerate_num != 25 || framerate_den != 1)
4302 gst_structure_get_int (structure, "dvversion", &version);
4303 /* fall back to typical one */
4309 entry.fourcc = FOURCC_dvcp;
4311 entry.fourcc = FOURCC_dvc_;
4315 entry.fourcc = FOURCC_dv5p;
4317 entry.fourcc = FOURCC_dv5n;
4320 GST_WARNING_OBJECT (qtmux, "unrecognized dv version");
4323 } else if (strcmp (mimetype, "image/jpeg") == 0) {
4324 entry.fourcc = FOURCC_jpeg;
4326 } else if (strcmp (mimetype, "image/x-j2c") == 0 ||
4327 strcmp (mimetype, "image/x-jpc") == 0) {
4328 const gchar *colorspace;
4329 const GValue *cmap_array;
4330 const GValue *cdef_array;
4333 if (strcmp (mimetype, "image/x-jpc") == 0) {
4334 qtpad->prepare_buf_func = gst_qt_mux_prepare_jpc_buffer;
4337 gst_structure_get_int (structure, "num-components", &ncomp);
4338 cmap_array = gst_structure_get_value (structure, "component-map");
4339 cdef_array = gst_structure_get_value (structure, "channel-definitions");
4342 entry.fourcc = FOURCC_mjp2;
4345 colorspace = gst_structure_get_string (structure, "colorspace");
4348 build_jp2h_extension (width, height, colorspace, ncomp, cmap_array,
4349 cdef_array)) != NULL) {
4350 ext_atom_list = g_list_append (ext_atom_list, ext_atom);
4352 ext_atom = build_jp2x_extension (codec_data);
4354 ext_atom_list = g_list_append (ext_atom_list, ext_atom);
4356 GST_DEBUG_OBJECT (qtmux, "missing or invalid fourcc in jp2 caps");
4359 } else if (strcmp (mimetype, "video/x-vp8") == 0) {
4360 entry.fourcc = FOURCC_VP80;
4362 } else if (strcmp (mimetype, "video/x-dirac") == 0) {
4363 entry.fourcc = FOURCC_drac;
4364 } else if (strcmp (mimetype, "video/x-qt-part") == 0) {
4367 gst_structure_get_uint (structure, "format", &fourcc);
4368 entry.fourcc = fourcc;
4369 } else if (strcmp (mimetype, "video/x-mp4-part") == 0) {
4372 gst_structure_get_uint (structure, "format", &fourcc);
4373 entry.fourcc = fourcc;
4374 } else if (strcmp (mimetype, "video/x-prores") == 0) {
4375 const gchar *variant;
4377 variant = gst_structure_get_string (structure, "variant");
4378 if (!variant || !g_strcmp0 (variant, "standard"))
4379 entry.fourcc = FOURCC_apcn;
4380 else if (!g_strcmp0 (variant, "lt"))
4381 entry.fourcc = FOURCC_apcs;
4382 else if (!g_strcmp0 (variant, "hq"))
4383 entry.fourcc = FOURCC_apch;
4384 else if (!g_strcmp0 (variant, "proxy"))
4385 entry.fourcc = FOURCC_apco;
4386 else if (!g_strcmp0 (variant, "4444"))
4387 entry.fourcc = FOURCC_ap4h;
4388 else if (!g_strcmp0 (variant, "4444xq"))
4389 entry.fourcc = FOURCC_ap4x;
4393 if (!qtmux->interleave_time_set)
4394 qtmux->interleave_time = 500 * GST_MSECOND;
4395 if (!qtmux->interleave_bytes_set)
4396 qtmux->interleave_bytes = width > 720 ? 4 * 1024 * 1024 : 2 * 1024 * 1024;
4397 } else if (strcmp (mimetype, "video/x-cineform") == 0) {
4398 entry.fourcc = FOURCC_cfhd;
4405 if (qtmux_klass->format == GST_QT_MUX_FORMAT_QT ||
4406 qtmux_klass->format == GST_QT_MUX_FORMAT_MP4) {
4408 GstVideoColorimetry colorimetry;
4410 s = gst_structure_get_string (structure, "colorimetry");
4411 if (s && gst_video_colorimetry_from_string (&colorimetry, s)) {
4413 build_colr_extension (&colorimetry,
4414 qtmux_klass->format == GST_QT_MUX_FORMAT_MP4);
4416 ext_atom_list = g_list_append (ext_atom_list, ext_atom);
4420 if (qtmux_klass->format == GST_QT_MUX_FORMAT_QT
4421 || strcmp (mimetype, "image/x-j2c") == 0
4422 || strcmp (mimetype, "image/x-jpc") == 0) {
4424 GstVideoInterlaceMode interlace_mode;
4425 GstVideoFieldOrder field_order;
4428 if (strcmp (mimetype, "image/x-j2c") == 0 ||
4429 strcmp (mimetype, "image/x-jpc") == 0) {
4432 gst_structure_get_int (structure, "fields", &fields);
4435 s = gst_structure_get_string (structure, "interlace-mode");
4437 interlace_mode = gst_video_interlace_mode_from_string (s);
4441 1) ? GST_VIDEO_INTERLACE_MODE_PROGRESSIVE :
4442 GST_VIDEO_INTERLACE_MODE_MIXED;
4444 field_order = GST_VIDEO_FIELD_ORDER_UNKNOWN;
4445 if (interlace_mode == GST_VIDEO_INTERLACE_MODE_INTERLEAVED) {
4446 s = gst_structure_get_string (structure, "field-order");
4448 field_order = gst_video_field_order_from_string (s);
4451 ext_atom = build_fiel_extension (interlace_mode, field_order);
4453 ext_atom_list = g_list_append (ext_atom_list, ext_atom);
4457 if (qtmux_klass->format == GST_QT_MUX_FORMAT_QT &&
4458 width > 640 && width <= 1052 && height >= 480 && height <= 576) {
4459 /* The 'clap' extension is also defined for MP4 but inventing values in
4460 * general seems a bit tricky for this one. We only write it for
4461 * SD resolution in MOV, where it is a requirement.
4462 * The same goes for the 'tapt' extension, just that it is not defined for
4463 * MP4 and only for MOV
4465 gint dar_num, dar_den;
4466 gint clef_width, clef_height, prof_width;
4467 gint clap_width_n, clap_width_d, clap_height;
4471 /* First, guess display aspect ratio based on pixel aspect ratio,
4472 * width and height. We assume that display aspect ratio is either
4475 approx_dar = (gdouble) (width * par_num) / (height * par_den);
4476 if (approx_dar > 11.0 / 9 && approx_dar < 14.0 / 9) {
4479 } else if (approx_dar > 15.0 / 9 && approx_dar < 18.0 / 9) {
4483 dar_num = width * par_num;
4484 dar_den = height * par_den;
4485 cdiv = gst_util_greatest_common_divisor (dar_num, dar_den);
4490 /* Then, calculate clean-aperture values (clap and clef)
4491 * using the guessed DAR.
4493 clef_height = clap_height = (height == 486 ? 480 : height);
4494 clef_width = gst_util_uint64_scale (clef_height,
4495 dar_num * G_GUINT64_CONSTANT (65536), dar_den);
4496 prof_width = gst_util_uint64_scale (width,
4497 par_num * G_GUINT64_CONSTANT (65536), par_den);
4498 clap_width_n = clap_height * dar_num * par_den;
4499 clap_width_d = dar_den * par_num;
4500 cdiv = gst_util_greatest_common_divisor (clap_width_n, clap_width_d);
4501 clap_width_n /= cdiv;
4502 clap_width_d /= cdiv;
4504 ext_atom = build_tapt_extension (clef_width, clef_height << 16, prof_width,
4505 height << 16, width << 16, height << 16);
4506 qtpad->trak->tapt = ext_atom;
4508 ext_atom = build_clap_extension (clap_width_n, clap_width_d,
4509 clap_height, 1, 0, 1, 0, 1);
4511 ext_atom_list = g_list_append (ext_atom_list, ext_atom);
4514 /* ok, set the pad info accordingly */
4515 qtpad->fourcc = entry.fourcc;
4518 (SampleTableEntry *) atom_trak_set_video_type (qtpad->trak,
4519 qtmux->context, &entry, rate, ext_atom_list);
4520 if (strcmp (mimetype, "video/x-prores") == 0) {
4521 SampleTableEntryMP4V *mp4v = (SampleTableEntryMP4V *) qtpad->trak_ste;
4522 const gchar *compressor = NULL;
4523 mp4v->spatial_quality = 0x3FF;
4524 mp4v->temporal_quality = 0;
4525 mp4v->vendor = FOURCC_appl;
4526 mp4v->horizontal_resolution = 72 << 16;
4527 mp4v->vertical_resolution = 72 << 16;
4528 mp4v->depth = (entry.fourcc == FOURCC_ap4h
4529 || entry.fourcc == FOURCC_ap4x) ? 32 : 24;
4531 /* Set compressor name, required by some software */
4532 switch (entry.fourcc) {
4534 compressor = "Apple ProRes 422";
4537 compressor = "Apple ProRes 422 LT";
4540 compressor = "Apple ProRes 422 HQ";
4543 compressor = "Apple ProRes 422 Proxy";
4546 compressor = "Apple ProRes 4444";
4549 compressor = "Apple ProRes 4444 XQ";
4553 strcpy ((gchar *) mp4v->compressor + 1, compressor);
4554 mp4v->compressor[0] = strlen (compressor);
4558 gst_object_unref (qtmux);
4564 GST_WARNING_OBJECT (qtmux, "pad %s refused caps %" GST_PTR_FORMAT,
4565 GST_PAD_NAME (pad), caps);
4566 gst_object_unref (qtmux);
4569 refuse_renegotiation:
4571 GST_WARNING_OBJECT (qtmux,
4572 "pad %s refused renegotiation to %" GST_PTR_FORMAT, GST_PAD_NAME (pad),
4574 gst_object_unref (qtmux);
4580 gst_qt_mux_subtitle_sink_set_caps (GstQTPad * qtpad, GstCaps * caps)
4582 GstPad *pad = qtpad->collect.pad;
4583 GstQTMux *qtmux = GST_QT_MUX_CAST (gst_pad_get_parent (pad));
4584 GstStructure *structure;
4585 SubtitleSampleEntry entry = { 0, };
4587 /* does not go well to renegotiate stream mid-way, unless
4588 * the old caps are a subset of the new one (this means upstream
4589 * added more info to the caps, as both should be 'fixed' caps) */
4590 if (qtpad->fourcc) {
4591 GstCaps *current_caps;
4593 current_caps = gst_pad_get_current_caps (pad);
4594 g_assert (caps != NULL);
4596 if (!gst_qtmux_caps_is_subset_full (qtmux, current_caps, caps)) {
4597 gst_caps_unref (current_caps);
4598 goto refuse_renegotiation;
4600 GST_DEBUG_OBJECT (qtmux,
4601 "pad %s accepted renegotiation to %" GST_PTR_FORMAT " from %"
4602 GST_PTR_FORMAT, GST_PAD_NAME (pad), caps, current_caps);
4603 gst_caps_unref (current_caps);
4606 GST_DEBUG_OBJECT (qtmux, "%s:%s, caps=%" GST_PTR_FORMAT,
4607 GST_DEBUG_PAD_NAME (pad), caps);
4609 /* subtitles default */
4610 subtitle_sample_entry_init (&entry);
4611 qtpad->is_out_of_order = FALSE;
4612 qtpad->sync = FALSE;
4613 qtpad->sparse = TRUE;
4614 qtpad->prepare_buf_func = NULL;
4616 structure = gst_caps_get_structure (caps, 0);
4618 if (gst_structure_has_name (structure, "text/x-raw")) {
4619 const gchar *format = gst_structure_get_string (structure, "format");
4620 if (format && strcmp (format, "utf8") == 0) {
4621 entry.fourcc = FOURCC_tx3g;
4622 qtpad->prepare_buf_func = gst_qt_mux_prepare_tx3g_buffer;
4623 qtpad->create_empty_buffer = gst_qt_mux_create_empty_tx3g_buffer;
4630 qtpad->fourcc = entry.fourcc;
4632 (SampleTableEntry *) atom_trak_set_subtitle_type (qtpad->trak,
4633 qtmux->context, &entry);
4635 gst_object_unref (qtmux);
4641 GST_WARNING_OBJECT (qtmux, "pad %s refused caps %" GST_PTR_FORMAT,
4642 GST_PAD_NAME (pad), caps);
4643 gst_object_unref (qtmux);
4646 refuse_renegotiation:
4648 GST_WARNING_OBJECT (qtmux,
4649 "pad %s refused renegotiation to %" GST_PTR_FORMAT, GST_PAD_NAME (pad),
4651 gst_object_unref (qtmux);
4657 gst_qt_mux_sink_event (GstCollectPads * pads, GstCollectData * data,
4658 GstEvent * event, gpointer user_data)
4661 guint32 avg_bitrate = 0, max_bitrate = 0;
4662 GstPad *pad = data->pad;
4663 gboolean ret = TRUE;
4665 qtmux = GST_QT_MUX_CAST (user_data);
4666 switch (GST_EVENT_TYPE (event)) {
4667 case GST_EVENT_CAPS:
4670 GstQTPad *collect_pad;
4672 gst_event_parse_caps (event, &caps);
4674 /* find stream data */
4675 collect_pad = (GstQTPad *) gst_pad_get_element_private (pad);
4676 g_assert (collect_pad);
4677 g_assert (collect_pad->set_caps);
4679 ret = collect_pad->set_caps (collect_pad, caps);
4680 gst_event_unref (event);
4684 case GST_EVENT_TAG:{
4686 GstTagSetter *setter = GST_TAG_SETTER (qtmux);
4687 GstTagMergeMode mode;
4689 GstQTPad *collect_pad;
4691 GST_OBJECT_LOCK (qtmux);
4692 mode = gst_tag_setter_get_tag_merge_mode (setter);
4693 collect_pad = (GstQTPad *) gst_pad_get_element_private (pad);
4695 gst_event_parse_tag (event, &list);
4696 GST_DEBUG_OBJECT (qtmux, "received tag event on pad %s:%s : %"
4697 GST_PTR_FORMAT, GST_DEBUG_PAD_NAME (pad), list);
4699 if (gst_tag_list_get_scope (list) == GST_TAG_SCOPE_GLOBAL) {
4700 gst_tag_setter_merge_tags (setter, list, mode);
4701 qtmux->tags_changed = TRUE;
4703 if (!collect_pad->tags)
4704 collect_pad->tags = gst_tag_list_new_empty ();
4705 gst_tag_list_insert (collect_pad->tags, list, mode);
4706 collect_pad->tags_changed = TRUE;
4708 GST_OBJECT_UNLOCK (qtmux);
4710 if (gst_tag_list_get_uint (list, GST_TAG_BITRATE, &avg_bitrate) |
4711 gst_tag_list_get_uint (list, GST_TAG_MAXIMUM_BITRATE, &max_bitrate)) {
4712 GstQTPad *qtpad = gst_pad_get_element_private (pad);
4715 if (avg_bitrate > 0 && avg_bitrate < G_MAXUINT32)
4716 qtpad->avg_bitrate = avg_bitrate;
4717 if (max_bitrate > 0 && max_bitrate < G_MAXUINT32)
4718 qtpad->max_bitrate = max_bitrate;
4721 if (gst_tag_list_get_string (list, GST_TAG_LANGUAGE_CODE, &code)) {
4722 const char *iso_code = gst_tag_get_language_code_iso_639_2T (code);
4724 GstQTPad *qtpad = gst_pad_get_element_private (pad);
4727 /* https://developer.apple.com/library/mac/#documentation/QuickTime/QTFF/QTFFChap4/qtff4.html */
4728 qtpad->trak->mdia.mdhd.language_code =
4729 (iso_code[0] - 0x60) * 0x400 + (iso_code[1] - 0x60) * 0x20 +
4730 (iso_code[2] - 0x60);
4736 gst_event_unref (event);
4746 return gst_collect_pads_event_default (pads, data, event, FALSE);
4752 gst_qt_mux_release_pad (GstElement * element, GstPad * pad)
4754 GstQTMux *mux = GST_QT_MUX_CAST (element);
4757 GST_DEBUG_OBJECT (element, "Releasing %s:%s", GST_DEBUG_PAD_NAME (pad));
4759 for (walk = mux->sinkpads; walk; walk = g_slist_next (walk)) {
4760 GstQTPad *qtpad = (GstQTPad *) walk->data;
4761 GST_DEBUG ("Checking %s:%s", GST_DEBUG_PAD_NAME (qtpad->collect.pad));
4762 if (qtpad->collect.pad == pad) {
4763 /* this is it, remove */
4764 mux->sinkpads = g_slist_delete_link (mux->sinkpads, walk);
4765 gst_element_remove_pad (element, pad);
4770 if (mux->current_pad && mux->current_pad->collect.pad == pad) {
4771 mux->current_pad = NULL;
4772 mux->current_chunk_size = 0;
4773 mux->current_chunk_duration = 0;
4776 gst_collect_pads_remove_pad (mux->collect, pad);
4778 if (mux->sinkpads == NULL) {
4779 /* No more outstanding request pads, reset our counters */
4780 mux->video_pads = 0;
4781 mux->audio_pads = 0;
4782 mux->subtitle_pads = 0;
4787 gst_qt_mux_request_new_pad (GstElement * element,
4788 GstPadTemplate * templ, const gchar * req_name, const GstCaps * caps)
4790 GstElementClass *klass = GST_ELEMENT_GET_CLASS (element);
4791 GstQTMux *qtmux = GST_QT_MUX_CAST (element);
4792 GstQTPad *collect_pad;
4794 GstQTPadSetCapsFunc setcaps_func;
4797 gboolean lock = TRUE;
4799 if (templ->direction != GST_PAD_SINK)
4800 goto wrong_direction;
4802 if (qtmux->state > GST_QT_MUX_STATE_STARTED)
4805 if (templ == gst_element_class_get_pad_template (klass, "audio_%u")) {
4806 setcaps_func = gst_qt_mux_audio_sink_set_caps;
4807 if (req_name != NULL && sscanf (req_name, "audio_%u", &pad_id) == 1) {
4808 name = g_strdup (req_name);
4810 name = g_strdup_printf ("audio_%u", qtmux->audio_pads++);
4812 } else if (templ == gst_element_class_get_pad_template (klass, "video_%u")) {
4813 setcaps_func = gst_qt_mux_video_sink_set_caps;
4814 if (req_name != NULL && sscanf (req_name, "video_%u", &pad_id) == 1) {
4815 name = g_strdup (req_name);
4817 name = g_strdup_printf ("video_%u", qtmux->video_pads++);
4819 } else if (templ == gst_element_class_get_pad_template (klass, "subtitle_%u")) {
4820 setcaps_func = gst_qt_mux_subtitle_sink_set_caps;
4821 if (req_name != NULL && sscanf (req_name, "subtitle_%u", &pad_id) == 1) {
4822 name = g_strdup (req_name);
4824 name = g_strdup_printf ("subtitle_%u", qtmux->subtitle_pads++);
4828 goto wrong_template;
4830 GST_DEBUG_OBJECT (qtmux, "Requested pad: %s", name);
4832 /* create pad and add to collections */
4833 newpad = gst_pad_new_from_template (templ, name);
4835 collect_pad = (GstQTPad *)
4836 gst_collect_pads_add_pad (qtmux->collect, newpad, sizeof (GstQTPad),
4837 (GstCollectDataDestroyNotify) (gst_qt_mux_pad_reset), lock);
4839 gst_qt_mux_pad_reset (collect_pad);
4840 collect_pad->trak = atom_trak_new (qtmux->context);
4841 atom_moov_add_trak (qtmux->moov, collect_pad->trak);
4843 qtmux->sinkpads = g_slist_append (qtmux->sinkpads, collect_pad);
4845 /* set up pad functions */
4846 collect_pad->set_caps = setcaps_func;
4848 gst_pad_set_active (newpad, TRUE);
4849 gst_element_add_pad (element, newpad);
4856 GST_WARNING_OBJECT (qtmux, "Request pad that is not a SINK pad.");
4861 GST_WARNING_OBJECT (qtmux, "Not providing request pad after stream start.");
4866 GST_WARNING_OBJECT (qtmux, "This is not our template!");
4872 gst_qt_mux_get_property (GObject * object,
4873 guint prop_id, GValue * value, GParamSpec * pspec)
4875 GstQTMux *qtmux = GST_QT_MUX_CAST (object);
4877 GST_OBJECT_LOCK (qtmux);
4879 case PROP_MOVIE_TIMESCALE:
4880 g_value_set_uint (value, qtmux->timescale);
4882 case PROP_TRAK_TIMESCALE:
4883 g_value_set_uint (value, qtmux->trak_timescale);
4886 g_value_set_boolean (value, qtmux->guess_pts);
4888 #ifndef GST_REMOVE_DEPRECATED
4889 case PROP_DTS_METHOD:
4890 g_value_set_enum (value, qtmux->dts_method);
4893 case PROP_FAST_START:
4894 g_value_set_boolean (value, qtmux->fast_start);
4896 case PROP_FAST_START_TEMP_FILE:
4897 g_value_set_string (value, qtmux->fast_start_file_path);
4899 case PROP_MOOV_RECOV_FILE:
4900 g_value_set_string (value, qtmux->moov_recov_file_path);
4902 case PROP_FRAGMENT_DURATION:
4903 g_value_set_uint (value, qtmux->fragment_duration);
4905 case PROP_STREAMABLE:
4906 g_value_set_boolean (value, qtmux->streamable);
4908 case PROP_RESERVED_MAX_DURATION:
4909 g_value_set_uint64 (value, qtmux->reserved_max_duration);
4911 case PROP_RESERVED_DURATION_REMAINING:
4912 if (qtmux->reserved_duration_remaining == GST_CLOCK_TIME_NONE)
4913 g_value_set_uint64 (value, qtmux->reserved_max_duration);
4915 GstClockTime remaining = qtmux->reserved_duration_remaining;
4917 /* Report the remaining space as the calculated remaining, minus
4918 * however much we've muxed since the last update */
4919 if (remaining > qtmux->muxed_since_last_update)
4920 remaining -= qtmux->muxed_since_last_update;
4923 GST_LOG_OBJECT (qtmux, "reserved duration remaining - reporting %"
4924 G_GUINT64_FORMAT "(%" G_GUINT64_FORMAT " - %" G_GUINT64_FORMAT,
4925 remaining, qtmux->reserved_duration_remaining,
4926 qtmux->muxed_since_last_update);
4927 g_value_set_uint64 (value, remaining);
4930 case PROP_RESERVED_MOOV_UPDATE_PERIOD:
4931 g_value_set_uint64 (value, qtmux->reserved_moov_update_period);
4933 case PROP_RESERVED_BYTES_PER_SEC:
4934 g_value_set_uint (value, qtmux->reserved_bytes_per_sec_per_trak);
4936 case PROP_INTERLEAVE_BYTES:
4937 g_value_set_uint64 (value, qtmux->interleave_bytes);
4939 case PROP_INTERLEAVE_TIME:
4940 g_value_set_uint64 (value, qtmux->interleave_time);
4943 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
4946 GST_OBJECT_UNLOCK (qtmux);
4950 gst_qt_mux_generate_fast_start_file_path (GstQTMux * qtmux)
4954 g_free (qtmux->fast_start_file_path);
4955 qtmux->fast_start_file_path = NULL;
4957 tmp = g_strdup_printf ("%s%d", "qtmux", g_random_int ());
4958 qtmux->fast_start_file_path = g_build_filename (g_get_tmp_dir (), tmp, NULL);
4963 gst_qt_mux_set_property (GObject * object,
4964 guint prop_id, const GValue * value, GParamSpec * pspec)
4966 GstQTMux *qtmux = GST_QT_MUX_CAST (object);
4968 GST_OBJECT_LOCK (qtmux);
4970 case PROP_MOVIE_TIMESCALE:
4971 qtmux->timescale = g_value_get_uint (value);
4973 case PROP_TRAK_TIMESCALE:
4974 qtmux->trak_timescale = g_value_get_uint (value);
4977 qtmux->guess_pts = g_value_get_boolean (value);
4979 #ifndef GST_REMOVE_DEPRECATED
4980 case PROP_DTS_METHOD:
4981 qtmux->dts_method = g_value_get_enum (value);
4984 case PROP_FAST_START:
4985 qtmux->fast_start = g_value_get_boolean (value);
4987 case PROP_FAST_START_TEMP_FILE:
4988 g_free (qtmux->fast_start_file_path);
4989 qtmux->fast_start_file_path = g_value_dup_string (value);
4990 /* NULL means to generate a random one */
4991 if (!qtmux->fast_start_file_path) {
4992 gst_qt_mux_generate_fast_start_file_path (qtmux);
4995 case PROP_MOOV_RECOV_FILE:
4996 g_free (qtmux->moov_recov_file_path);
4997 qtmux->moov_recov_file_path = g_value_dup_string (value);
4999 case PROP_FRAGMENT_DURATION:
5000 qtmux->fragment_duration = g_value_get_uint (value);
5002 case PROP_STREAMABLE:{
5003 GstQTMuxClass *qtmux_klass =
5004 (GstQTMuxClass *) (G_OBJECT_GET_CLASS (qtmux));
5005 if (qtmux_klass->format == GST_QT_MUX_FORMAT_ISML) {
5006 qtmux->streamable = g_value_get_boolean (value);
5010 case PROP_RESERVED_MAX_DURATION:
5011 qtmux->reserved_max_duration = g_value_get_uint64 (value);
5013 case PROP_RESERVED_MOOV_UPDATE_PERIOD:
5014 qtmux->reserved_moov_update_period = g_value_get_uint64 (value);
5016 case PROP_RESERVED_BYTES_PER_SEC:
5017 qtmux->reserved_bytes_per_sec_per_trak = g_value_get_uint (value);
5019 case PROP_INTERLEAVE_BYTES:
5020 qtmux->interleave_bytes = g_value_get_uint64 (value);
5021 qtmux->interleave_bytes_set = TRUE;
5023 case PROP_INTERLEAVE_TIME:
5024 qtmux->interleave_time = g_value_get_uint64 (value);
5025 qtmux->interleave_time_set = TRUE;
5028 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
5031 GST_OBJECT_UNLOCK (qtmux);
5034 static GstStateChangeReturn
5035 gst_qt_mux_change_state (GstElement * element, GstStateChange transition)
5037 GstStateChangeReturn ret;
5038 GstQTMux *qtmux = GST_QT_MUX_CAST (element);
5040 switch (transition) {
5041 case GST_STATE_CHANGE_NULL_TO_READY:
5043 case GST_STATE_CHANGE_READY_TO_PAUSED:
5044 gst_collect_pads_start (qtmux->collect);
5045 qtmux->state = GST_QT_MUX_STATE_STARTED;
5047 case GST_STATE_CHANGE_PAUSED_TO_PLAYING:
5049 case GST_STATE_CHANGE_PAUSED_TO_READY:
5050 gst_collect_pads_stop (qtmux->collect);
5056 ret = GST_ELEMENT_CLASS (parent_class)->change_state (element, transition);
5058 switch (transition) {
5059 case GST_STATE_CHANGE_PLAYING_TO_PAUSED:
5061 case GST_STATE_CHANGE_PAUSED_TO_READY:
5062 gst_qt_mux_reset (qtmux, TRUE);
5064 case GST_STATE_CHANGE_READY_TO_NULL:
5074 gst_qt_mux_register (GstPlugin * plugin)
5076 GTypeInfo typeinfo = {
5077 sizeof (GstQTMuxClass),
5078 (GBaseInitFunc) gst_qt_mux_base_init,
5080 (GClassInitFunc) gst_qt_mux_class_init,
5085 (GInstanceInitFunc) gst_qt_mux_init,
5087 static const GInterfaceInfo tag_setter_info = {
5090 static const GInterfaceInfo tag_xmp_writer_info = {
5093 static const GInterfaceInfo preset_info = {
5097 GstQTMuxFormat format;
5098 GstQTMuxClassParams *params;
5101 GST_DEBUG_CATEGORY_INIT (gst_qt_mux_debug, "qtmux", 0, "QT Muxer");
5103 GST_LOG ("Registering muxers");
5106 GstQTMuxFormatProp *prop;
5107 GstCaps *subtitle_caps;
5109 prop = &gst_qt_mux_format_list[i];
5110 format = prop->format;
5111 if (format == GST_QT_MUX_FORMAT_NONE)
5114 /* create a cache for these properties */
5115 params = g_new0 (GstQTMuxClassParams, 1);
5116 params->prop = prop;
5117 params->src_caps = gst_static_caps_get (&prop->src_caps);
5118 params->video_sink_caps = gst_static_caps_get (&prop->video_sink_caps);
5119 params->audio_sink_caps = gst_static_caps_get (&prop->audio_sink_caps);
5120 subtitle_caps = gst_static_caps_get (&prop->subtitle_sink_caps);
5121 if (!gst_caps_is_equal (subtitle_caps, GST_CAPS_NONE)) {
5122 params->subtitle_sink_caps = subtitle_caps;
5124 gst_caps_unref (subtitle_caps);
5127 /* create the type now */
5128 type = g_type_register_static (GST_TYPE_ELEMENT, prop->type_name, &typeinfo,
5130 g_type_set_qdata (type, GST_QT_MUX_PARAMS_QDATA, (gpointer) params);
5131 g_type_add_interface_static (type, GST_TYPE_TAG_SETTER, &tag_setter_info);
5132 g_type_add_interface_static (type, GST_TYPE_TAG_XMP_WRITER,
5133 &tag_xmp_writer_info);
5134 g_type_add_interface_static (type, GST_TYPE_PRESET, &preset_info);
5136 if (!gst_element_register (plugin, prop->name, prop->rank, type))
5142 GST_LOG ("Finished registering muxers");
5144 /* FIXME: ideally classification tag should be added and
5145 registered in gstreamer core gsttaglist
5148 GST_LOG ("Registering tags");
5150 gst_tag_register (GST_TAG_3GP_CLASSIFICATION, GST_TAG_FLAG_META,
5151 G_TYPE_STRING, GST_TAG_3GP_CLASSIFICATION, "content classification",
5152 gst_tag_merge_use_first);
5154 GST_LOG ("Finished registering tags");