gnomevfssink

gnomevfssink

Properties

GnomeVFSHandle * handle Read / Write
gchar * location Read / Write
GnomeVFSURI * uri Read / Write

Signals

gboolean allow-overwrite Cleanup

Types and Values

Object Hierarchy

    GObject
    ╰── GstObject
        ╰── GstElement
            ╰── GstBaseSink
                ╰── GstGnomeVFSSink

Implemented Interfaces

GstGnomeVFSSink implements GstURIHandler.

Description

This plugin writes incoming data to 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', 'ftp', or 'smb'.

Applications can connect to the “allow-overwrite” signal to receive a callback when an existing file will be overwritten. The return value of the signal will determine if gnomevfssink will overwrite the resource or abort with an error.

Example launch lines

1
gst-launch -v filesrc location=input.xyz ! gnomevfssink location=file:///home/joe/out.xyz
The above pipeline will simply copy a local file. Instead of gnomevfssink, we could just as well have used the filesink element here.
1
gst-launch -v filesrc location=foo.mp3 ! mad ! flacenc ! gnomevfssink location=smb://othercomputer/foo.flac
The above pipeline will re-encode an mp3 file into FLAC format and store it on a remote host using the Samba protocol.

Last reviewed on 2006-02-28 (0.10.4)

Functions

Types and Values

struct GstGnomeVFSSink

struct GstGnomeVFSSink;

Opaque data structure.

Property Details

The “handle” property

  “handle”                   GnomeVFSHandle *

Handle for GnomeVFS.

Flags: Read / Write


The “location” property

  “location”                 gchar *

Location of the file to write.

Flags: Read / Write

Default value: NULL


The “uri” property

  “uri”                      GnomeVFSURI *

URI for GnomeVFS.

Flags: Read / Write

Signal Details

The “allow-overwrite” signal

gboolean
user_function (GstGnomeVFSSink *sink,
               GnomeVFSURI     *uri,
               gpointer         user_data)

This signal is fired when gnomevfssink is about to overwrite an existing resource. The application can connect to this signal and ask the user if the resource may be overwritten.

Parameters

sink

the object which received the signal

 

uri

the URI to be overwritten

 

user_data

user data set when the signal handler was connected.

 

Returns

A boolean indicating that the resource may be overwritten.

Flags: Cleanup

See Also

GstFileSink, GstGnomeVFSSrc