GhostPad

Object Hierarchy:

Description:

public class GhostPad : Pad

GhostPads are useful when organizing pipelines with Bin like elements. The idea here is to create hierarchical element graphs. The bin element contains a sub-graph. Now one would like to treat the bin-element like any other Element. This is where GhostPads come into play. A GhostPad acts as a proxy for another pad. Thus the bin can have sink and source ghost-pads that are associated with sink and source pads of the child elements. If the target pad is known at creation time, GhostPad is the function to use to get a ghost-pad. Otherwise one can use GhostPad.no_target to create the ghost-pad and use set_target to establish the association later on. Note that GhostPads add overhead to the data processing of a pipeline. Last reviewed on 2005-11-18 (0.9.5)

Namespace: Gst

Package: gstreamer-0.10

Content:

Static methods:

public static bool activate_pull_default (Pad pad, bool active)
public static bool activate_push_default (Pad pad, bool active)
public static bool internal_activate_pull_default (Pad pad, bool active)
public static bool internal_activate_push_default (Pad pad, bool active)
public static PadLinkReturn link_default (Pad pad, Pad peer)
public static bool setcaps_default (Pad pad, Caps caps)
public static void unlink_default (Pad pad)

Creation methods:

public GhostPad (string? name, Pad target)
Create a new ghostpad with target as the target. The direction will be taken from the target pad. target must be unlinked. Will ref the target.
public GhostPad.from_template (string? name, Pad target, PadTemplate templ)
Create a new ghostpad with target as the target. The direction will be taken from the target pad. The template used on the ghostpad will be template. Will ref the target.
public GhostPad.no_target (string? name, PadDirection dir)
Create a new ghostpad without a target with the given direction. A target can be set on the ghostpad later with the set_target function. The created ghostpad will not have a padtemplate.
public GhostPad.no_target_from_template (string? name, PadTemplate templ)
Create a new ghostpad based on templ, without setting a target. The direction will be taken from the templ.

Methods:

public Pad? get_target ()
Get the target pad of gpad. Unref target pad after usage. has no target set. Unref target pad after usage.
public bool set_target (Pad? newtarget)
Set the new target of the ghostpad gpad. Any existing target is unlinked and links to the new target are established. if newtarget is NULL the target will be cleared. can return FALSE when the internal pads could not be linked.