splitmuxsink: GStreamer Good Plugins 1.0 Plugins Reference Manual

splitmuxsink

splitmuxsink — Muxer wrapper for splitting output stream by size or time

Properties

gchar *	location	Read / Write
guint64	max-size-bytes	Read / Write
guint64	max-size-time	Read / Write
gdouble	mux-overhead	Read / Write
GstElement *	muxer	Read / Write
GstElement *	sink	Read / Write
guint	max-files	Read / Write
gboolean	send-keyframe-requests	Read / Write
gchar *	max-size-timecode	Read / Write
guint64	alignment-threshold	Read / Write
gboolean	use-robust-muxing	Read / Write
gboolean	async-finalize	Read / Write
gchar *	muxer-factory	Read / Write
GstStructure *	muxer-properties	Read / Write
gboolean	reset-muxer	Read / Write
gchar *	sink-factory	Read / Write
GstStructure *	sink-properties	Read / Write

Signals

gchar*	format-location	Run Last
gchar*	format-location-full	Run Last
void	split-now	Run Last
void	muxer-added	Run Last
void	sink-added	Run Last
void	split-after	Run Last
void	split-at-running-time	Run Last

Types and Values

struct

GstSplitMuxSink

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── GstObject
            ╰── GstElement
                ╰── GstBin
                    ╰── GstSplitMuxSink

Implemented Interfaces

GstSplitMuxSink implements GstChildProxy.

Description

This element wraps a muxer and a sink, and starts a new file when the mux contents are about to cross a threshold of maximum size of maximum time, splitting at video keyframe boundaries. Exactly one input video stream can be muxed, with as many accompanying audio and subtitle streams as desired.

By default, it uses mp4mux and filesink, but they can be changed via the 'muxer' and 'sink' properties.

The minimum file size is 1 GOP, however - so limits may be overrun if the distance between any 2 keyframes is larger than the limits.

If a video stream is available, the splitting process is driven by the video stream contents, and the video stream must contain closed GOPs for the output file parts to be played individually correctly. In the absence of a video stream, the first available stream is used as reference for synchronization.

In the async-finalize mode, when the threshold is crossed, the old muxer and sink is disconnected from the pipeline and left to finish the file asynchronously, and a new muxer and sink is created to continue with the next fragment. For that reason, instead of muxer and sink objects, the muxer-factory and sink-factory properties are used to construct the new objects, together with muxer-properties and sink-properties.

Example pipelines

gst-launch-1.0 -e v4l2src num-buffers=500 ! video/x-raw,width=320,height=240 ! videoconvert ! queue ! timeoverlay ! x264enc key-int-max=10 ! h264parse ! splitmuxsink location=video%02d.mov max-size-time=10000000000 max-size-bytes=1000000

Records a video stream captured from a v4l2 device and muxes it into ISO mp4 files, splitting as needed to limit size/duration to 10 seconds and 1MB maximum size.

gst-launch-1.0 -e v4l2src num-buffers=500 ! video/x-raw,width=320,height=240 ! videoconvert ! queue ! timeoverlay ! x264enc key-int-max=10 ! h264parse ! splitmuxsink location=video%02d.mkv max-size-time=10000000000 muxer-factory=matroskamux muxer-properties="properties,streamable=true"

Records a video stream captured from a v4l2 device and muxer it into streamable Matroska files, splitting as needed to limit size/duration to 10 seconds. Each file will finalize asynchronously.

Synopsis

Element Information

plugin	multifile
author	Jan Schmidt <jan@centricular.com>
class	Generic/Bin/Muxer

Element Pads

name	audio_%u
direction	sink
presence	request
details	ANY

name	caption_%u
direction	sink
presence	request
details	ANY

name	subtitle_%u
direction	sink
presence	request
details	ANY

name	video
direction	sink
presence	request
details	ANY

Functions

Types and Values

struct GstSplitMuxSink

struct GstSplitMuxSink;

Property Details

The `“location”` property

  “location”                 gchar *

Format string pattern for the location of the files to write (e.g. video%05d.mp4).

Flags: Read / Write

Default value: NULL

The `“max-size-bytes”` property

  “max-size-bytes”           guint64

Max. amount of data per file (in bytes, 0=disable).

Flags: Read / Write

Default value: 0

The `“max-size-time”` property

  “max-size-time”            guint64

Max. amount of time per file (in ns, 0=disable).

Flags: Read / Write

Default value: 0

The `“mux-overhead”` property

  “mux-overhead”             gdouble

Extra size overhead of muxing (0.02 = 2%).

Flags: Read / Write

Allowed values: [0,1]

Default value: 0.02

The `“muxer”` property

  “muxer”                    GstElement *

The muxer element to use (NULL = default mp4mux). Valid only for async-finalize = FALSE.

Flags: Read / Write

The `“sink”` property

  “sink”                     GstElement *

The sink element (or element chain) to use (NULL = default filesink). Valid only for async-finalize = FALSE.

Flags: Read / Write

The `“max-files”` property

  “max-files”                guint

Maximum number of files to keep on disk. Once the maximum is reached,old files start to be deleted to make room for new ones.

Flags: Read / Write

Default value: 0

The `“send-keyframe-requests”` property

  “send-keyframe-requests”   gboolean

Request a keyframe every max-size-time ns to try splitting at that point. Needs max-size-bytes to be 0 in order to be effective.

Flags: Read / Write

Default value: FALSE

The `“max-size-timecode”` property

  “max-size-timecode”        gchar *

Maximum difference in timecode between first and last frame. Separator is assumed to be ":" everywhere (e.g. 01:00:00:00). Will only be effective if a timecode track is present.

Flags: Read / Write

Default value: NULL

The `“alignment-threshold”` property

  “alignment-threshold”      guint64

Allow non-reference streams to be that many ns before the reference stream.

Flags: Read / Write

Default value: 0

The `“use-robust-muxing”` property

  “use-robust-muxing”        gboolean

Check if muxers support robust muxing via the reserved-max-duration and reserved-duration-remaining properties and use them if so. (Only present on qtmux and mp4mux for now). splitmuxsink may then also create new fragments if the reserved header space is about to overflow. Note that for mp4mux and qtmux, reserved-moov-update-period must be set manually by the app to a non-zero value for robust muxing to have an effect.

Flags: Read / Write

Default value: FALSE

The `“async-finalize”` property

  “async-finalize”           gboolean

Finalize each fragment asynchronously and start a new one.

Flags: Read / Write

Default value: FALSE

The `“muxer-factory”` property

  “muxer-factory”            gchar *

The muxer element factory to use (default = mp4mux). Valid only for async-finalize = TRUE.

Flags: Read / Write

Default value: "mp4mux"

The `“muxer-properties”` property

  “muxer-properties”         GstStructure *

The muxer element properties to use. Example: {properties,boolean-prop=true,string-prop="hi"}. Valid only for async-finalize = TRUE.

Flags: Read / Write

The `“reset-muxer”` property

  “reset-muxer”              gboolean

Reset the muxer after each segment. Disabling this will not work for most muxers.

Flags: Read / Write

Default value: TRUE

The `“sink-factory”` property

  “sink-factory”             gchar *

The sink element factory to use (default = filesink). Valid only for async-finalize = TRUE.

Flags: Read / Write

Default value: "filesink"

The `“sink-properties”` property

  “sink-properties”          GstStructure *

The sink element properties to use. Example: {properties,boolean-prop=true,string-prop="hi"}. Valid only for async-finalize = TRUE.

Flags: Read / Write

Signal Details

The `“format-location”` signal

gchar*
user_function (GstSplitMuxSink *splitmux,
               guint            fragment_id,
               gpointer         user_data)

Parameters

splitmux	the GstSplitMuxSink
fragment_id	the sequence number of the file to be created
user_data	user data set when the signal handler was connected.

Returns

the location to be used for the next output file

Flags: Run Last

The `“format-location-full”` signal

gchar*
user_function (GstSplitMuxSink *splitmux,
               guint            fragment_id,
               GstSample       *first_sample,
               gpointer         user_data)

Parameters

splitmux	the GstSplitMuxSink
fragment_id	the sequence number of the file to be created
first_sample	A GstSample containing the first buffer from the reference stream in the new file
user_data	user data set when the signal handler was connected.

Returns

the location to be used for the next output file

Flags: Run Last

The `“split-now”` signal

void
user_function (GstSplitMuxSink *splitmux,
               gpointer         user_data)

When called by the user, this action signal splits the video file (and begins a new one) as soon as the given running time is reached. If this action signal is called multiple times, running times are queued up and processed in the order they were given.

Note that this is prone to race conditions, where said running time is reached and surpassed before we had a chance to split. The file will still split immediately, but in order to make sure that the split doesn't happen too late, it is recommended to call this action signal from something that will prevent further buffers from flowing into splitmuxsink before the split is completed, such as a pad probe before splitmuxsink.

Parameters

splitmux	the GstSplitMuxSink
user_data	user data set when the signal handler was connected.

Flags: Run Last

Since: 1.16

The `“muxer-added”` signal

void
user_function (GstSplitMuxSink *splitmux,
               GstElement      *muxer,
               gpointer         user_data)

Parameters

splitmux	the GstSplitMuxSink
muxer	the newly added muxer element
user_data	user data set when the signal handler was connected.

Flags: Run Last

Since: 1.14

The `“sink-added”` signal

void
user_function (GstSplitMuxSink *splitmux,
               GstElement      *sink,
               gpointer         user_data)

Parameters

splitmux	the GstSplitMuxSink
sink	the newly added sink element
user_data	user data set when the signal handler was connected.

Flags: Run Last

Since: 1.14

The `“split-after”` signal

void
user_function (GstSplitMuxSink *splitmux,
               gpointer         user_data)

When called by the user, this action signal splits the video file (and begins a new one) immediately. The current GOP will be output to the old file.

Parameters

splitmux	the GstSplitMuxSink
user_data	user data set when the signal handler was connected.

Flags: Run Last

Since: 1.16

The `“split-at-running-time”` signal

void
user_function (GstSplitMuxSink *gstsplitmuxsink,
               guint64          arg1,
               gpointer         user_data)

Flags: Run Last

splitmuxsink

Properties

Signals

Types and Values

Object Hierarchy

Implemented Interfaces

Description

Example pipelines

Synopsis

Element Information

Element Pads

Functions

Types and Values

struct GstSplitMuxSink

Property Details

The “location” property

The “max-size-bytes” property

The “max-size-time” property

The “mux-overhead” property

The “muxer” property

The “sink” property

The “max-files” property

The “send-keyframe-requests” property

The “max-size-timecode” property

The “alignment-threshold” property

The “use-robust-muxing” property

The “async-finalize” property

The “muxer-factory” property

The “muxer-properties” property

The “reset-muxer” property

The “sink-factory” property

The “sink-properties” property

Signal Details

The “format-location” signal

Parameters

Returns

The “format-location-full” signal

Parameters

Returns

The “split-now” signal

Parameters

The “muxer-added” signal

Parameters

The “sink-added” signal

Parameters

The “split-after” signal

Parameters

The “split-at-running-time” signal

The `“location”` property

The `“max-size-bytes”` property

The `“max-size-time”` property

The `“mux-overhead”` property

The `“muxer”` property

The `“sink”` property

The `“max-files”` property

The `“send-keyframe-requests”` property

The `“max-size-timecode”` property

The `“alignment-threshold”` property

The `“use-robust-muxing”` property

The `“async-finalize”` property

The `“muxer-factory”` property

The `“muxer-properties”` property

The `“reset-muxer”` property

The `“sink-factory”` property

The `“sink-properties”` property

The `“format-location”` signal

The `“format-location-full”` signal

The `“split-now”` signal

The `“muxer-added”` signal

The `“sink-added”` signal

The `“split-after”` signal

The `“split-at-running-time”` signal