GhostPad

GhostPads are useful when organizing pipelines with gstreamer.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 gstreamer.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.new is the function to use to get a ghost-pad. Otherwise one can use GhostPad.newNoTarget to create the ghost-pad and use GhostPad.setTarget to establish the association later on.

Note that GhostPads add overhead to the data processing of a pipeline.

class GhostPad : ProxyPad {

protected

GstGhostPad* gstGhostPad;

GstGhostPad* getGhostPadStruct(bool transferOwnership);

void* getStruct();

this(GstGhostPad* gstGhostPad, bool ownedRef);

static GType getType();

this(string name, Pad target);

this(string name, Pad target, PadTemplate templ);

this(string name, GstPadDirection dir);

this(string name, PadTemplate templ);

static bool activateModeDefault(Pad pad, ObjectGst parent, GstPadMode mode, bool active);

static bool internalActivateModeDefault(Pad pad, ObjectGst parent, GstPadMode mode, bool active);

bool construct();

Pad getTarget();

bool setTarget(Pad newtarget);

}

Constructors

this this(GstGhostPad* gstGhostPad, bool ownedRef): Sets our main struct and passes it to the parent class.
this this(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.
this this(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.
this this(string name, GstPadDirection dir): Create a new ghostpad without a target with the given direction. A target can be set on the ghostpad later with the GhostPad.setTarget function.
this this(string name, PadTemplate templ): Create a new ghostpad based on templ, without setting a target. The direction will be taken from the templ.

Members

Functions

construct bool construct(): Finish initialization of a newly allocated ghost pad.
getGhostPadStruct GstGhostPad* getGhostPadStruct(bool transferOwnership): Get the main Gtk struct
getStruct void* getStruct(): the main Gtk struct as a void*
getTarget Pad getTarget(): Get the target pad of gpad. Unref target pad after usage.
setTarget bool setTarget(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.

Static functions

activateModeDefault bool activateModeDefault(Pad pad, ObjectGst parent, GstPadMode mode, bool active): Invoke the default activate mode function of a ghost pad.
getType GType getType()
internalActivateModeDefault bool internalActivateModeDefault(Pad pad, ObjectGst parent, GstPadMode mode, bool active): Invoke the default activate mode function of a proxy pad that is owned by a ghost pad.

Variables

gstGhostPad GstGhostPad* gstGhostPad;: the main Gtk struct

Inherited Members

From ProxyPad

gstProxyPad GstProxyPad* gstProxyPad;: the main Gtk struct
getProxyPadStruct GstProxyPad* getProxyPadStruct(bool transferOwnership): Get the main Gtk struct
getStruct void* getStruct(): the main Gtk struct as a void*
getType GType getType()
chainDefault GstFlowReturn chainDefault(Pad pad, ObjectGst parent, Buffer buffer): Invoke the default chain function of the proxy pad.
chainListDefault GstFlowReturn chainListDefault(Pad pad, ObjectGst parent, BufferList list): Invoke the default chain list function of the proxy pad.
getrangeDefault GstFlowReturn getrangeDefault(Pad pad, ObjectGst parent, ulong offset, uint size, Buffer buffer): Invoke the default getrange function of the proxy pad.
iterateInternalLinksDefault Iterator iterateInternalLinksDefault(Pad pad, ObjectGst parent): Invoke the default iterate internal links function of the proxy pad.
getInternal ProxyPad getInternal(): Get the internal pad of pad. Unref target pad after usage.

gstreamer GhostPad classes

GhostPad