GStreamer Good Plugins 1.0 Plugins Reference Manual: multifilesrc

## multifilesrc multifilesrc — Read a sequentially named set of files into buffers |

## Properties

GstCaps * | caps | Read / Write
gint | index | Read / Write
gchar * | location | Read / Write
gboolean | loop | Read / Write
gint | start-index | Read / Write
gint | stop-index | Read / Write

## Types and Values

struct | GstMultiFileSrc

## Object Hierarchy

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

## Description

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

    1
    2
    3
    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.

## Synopsis

### Element Information

plugin | multifile
author | David Schleef <ds@schleef.org>
class | Source/File

### Element Pads

name | src
direction | source
presence | always
details | ANY

## Functions

## Types and Values

### struct GstMultiFileSrc

    struct GstMultiFileSrc;

## Property Details

### The `“caps”` property

      “caps”                     GstCaps *

Caps describing the format of the data.

Flags: Read / Write

### The `“index”` property

      “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

Allowed values: >= 0

Default value: 0

### The `“location”` property

      “location”                 gchar *

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"

### The `“loop”` property

      “loop”                     gboolean

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

Flags: Read / Write

Default value: FALSE

### The `“start-index”` property

      “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

Allowed values: >= 0

Default value: 0

### The `“stop-index”` property

      “stop-index”               gint

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

Flags: Read / Write

Allowed values: >= G_MAXULONG

Default value: 0

## See Also

GstFileSrc