multifilesrc

Reads buffers from sequentially named files. If used together with an image decoder, one needs to use the caps property or a capsfilter to force to caps containing a framerate. Otherwise image decoders send EOS after the first picture. We also need a videorate element to set timestamps on all buffers after the first one in accordance with the framerate.

File names are created by replacing "%d" with the index using printf().

Example launch line

 gst-launch-1.0 multifilesrc location="img.%04d.png" index=0 caps="image/png,framerate=\(fraction\)12/1" ! \
     pngdec ! videoconvert ! videorate ! theoraenc ! oggmux ! \
     filesink location="images.ogg"

This pipeline creates a video file "images.ogg" by joining multiple PNG files named img.0000.png, img.0001.png, etc.

Hierarchy

GObject
    ╰──GInitiallyUnowned
        ╰──GstObject
            ╰──GstElement
                ╰──GstBaseSrc
                    ╰──GstPushSrc
                        ╰──multifilesrc

Factory details

Authors: – David Schleef

Classification:Source/File

Rank – none

Plugin – gstmultifile

Package – GStreamer Good Plug-ins git

Pad Templates

src

ANY

Presencealways

Directionsrc


Properties

blocksize

“blocksize” guint *

Size in bytes to read per buffer (-1 = default)

Flags : Read / Write

Default value : 4096


caps

“caps” GstCaps *

Caps describing the format of the data.

Flags : Read / Write


do-timestamp

“do-timestamp” gboolean *

Apply current stream time to buffers

Flags : Read / Write

Default value : false


index

“index” gint *

Index to use with location property to create file names. The index is incremented by one for each buffer read.

Flags : Read / Write

Default value : 0


location

“location” gchararray *

Pattern to create file names of input files. File names are created by calling sprintf with the pattern and the current index.

Flags : Read / Write

Default value : %%05d


loop

“loop” gboolean *

Whether to repeat from the beginning when all files have been read.

Flags : Read / Write

Default value : false


name

“name” gchararray *

The name of the object

Flags : Read / Write / Construct

Default value : NULL


num-buffers

“num-buffers” gint *

Number of buffers to output before sending EOS (-1 = unlimited)

Flags : Read / Write

Default value : -1


parent

“parent” GstObject *

The parent of the object

Flags : Read / Write


start-index

“start-index” gint *

Start value of index. The initial value of index can be set either by setting index or start-index. When the end of the loop is reached, the index will be set to the value start-index.

Flags : Read / Write

Default value : 0


stop-index

“stop-index” gint *

Stop value of index. The special value -1 means no stop.

Flags : Read / Write

Default value : -1


typefind

“typefind” gboolean *

Run typefind before negotiating (deprecated, non-functional)

Flags : Read / Write

Default value : false


The results of the search are