Top |
Object Hierarchy
GObject ╰── GInitiallyUnowned ╰── GstObject ╰── GstElement ╰── GstBaseTransform ╰── GstCapsSetter
Description
Sets or merges caps on a stream's buffers. That is, a buffer's caps are updated using (fields of) “caps”. Note that this may contain multiple structures (though not likely recommended), but each of these must be fixed (or will otherwise be rejected).
If “join” is TRUE
, then the incoming caps' mime-type is
compared to the mime-type(s) of provided caps and only matching structure(s)
are considered for updating.
If “replace” is TRUE
, then any caps update is preceded by
clearing existing fields, making provided fields (as a whole) replace
incoming ones. Otherwise, no clearing is performed, in which case provided
fields are added/merged onto incoming caps
Although this element might mainly serve as debug helper, it can also practically be used to correct a faulty pixel-aspect-ratio, or to modify a yuv fourcc value to effectively swap chroma components or such alike.
Synopsis
Element Information
plugin |
debug |
author |
Mark Nauwelaerts <mnauw@users.sourceforge.net> |
class |
Generic |
Property Details
The “caps”
property
“caps” GstCaps *
Merge these caps (thereby overwriting) in the stream.
Flags: Read / Write
The “join”
property
“join” gboolean
Match incoming caps' mime-type to mime-type of provided caps.
Flags: Read / Write
Default value: TRUE
The “replace”
property
“replace” gboolean
Drop fields of incoming caps.
Flags: Read / Write
Default value: FALSE