gnomevfssrc

gnomevfssrc

Properties

GnomeVFSHandle * handle Read / Write
gchar * iradio-genre Read
gboolean iradio-mode Read / Write
gchar * iradio-name Read
gchar * iradio-title Read
gchar * iradio-url Read
gchar * location Read / Write
gboolean random-access Read / Write

Types and Values

Object Hierarchy

    GObject
    ╰── GstObject
        ╰── GstElement
            ╰── GstBaseSrc
                ╰── GstGnomeVFSSrc

Implemented Interfaces

GstGnomeVFSSrc implements GstURIHandler.

Description

This plugin reads data from a local or remote location specified by an URI. This location can be specified using any protocol supported by the GnomeVFS library. Common protocols are 'file', 'http', 'ftp', or 'smb'.

In case the “iradio-mode” property is set and the location is a http resource, gnomevfssrc will send special icecast http headers to the server to request additional icecast metainformation. If the server is not an icecast server, it will display the same behaviour as if the “iradio-mode” property was not set. However, if the server is in fact an icecast server, gnomevfssrc will output data with a media type of application/x-icy, in which case you will need to use the GstICYDemux element as follow-up element to extract the icecast meta data and to determine the underlying media type.

Example launch lines

1
gst-launch -v gnomevfssrc location=file:///home/joe/foo.xyz ! fakesink
The above pipeline will simply read a local file and do nothing with the data read. Instead of gnomevfssrc, we could just as well have used the filesrc element here.
1
gst-launch -v gnomevfssrc location=smb://othercomputer/foo.xyz ! filesink location=/home/joe/foo.xyz
The above pipeline will copy a file from a remote host to the local file system using the Samba protocol.
1
gst-launch -v gnomevfssrc location=http://music.foobar.com/demo.mp3 ! mad ! audioconvert ! audioresample ! alsasink
The above pipeline will read and decode and play an mp3 file from a web server using the http protocol.

Functions

Types and Values

struct GstGnomeVFSSrc

struct GstGnomeVFSSrc;

Opaque data structure.

Property Details

The “handle” property

  “handle”                   GnomeVFSHandle *

Handle for GnomeVFS.

Flags: Read / Write


The “iradio-genre” property

  “iradio-genre”             gchar *

Genre of the stream.

Flags: Read

Default value: NULL


The “iradio-mode” property

  “iradio-mode”              gboolean

Enable internet radio mode (extraction of shoutcast/icecast metadata).

Flags: Read / Write

Default value: FALSE


The “iradio-name” property

  “iradio-name”              gchar *

Name of the stream.

Flags: Read

Default value: NULL


The “iradio-title” property

  “iradio-title”             gchar *

Name of currently playing song.

Flags: Read

Default value: NULL


The “iradio-url” property

  “iradio-url”               gchar *

Homepage URL for radio stream.

Flags: Read

Default value: NULL


The “location” property

  “location”                 gchar *

Location of the file to read.

Flags: Read / Write

Default value: NULL


The “random-access” property

  “random-access”            gboolean

Enable random file access.

Flags: Read / Write

Default value: FALSE

See Also

GstFileSrc, GstGnomeVFSSink