Top | ![]() |
![]() |
![]() |
![]() |
xmlDocPtr | gst_xml_write () |
gint | gst_xml_write_file () |
GstXML * | gst_xml_new () |
gboolean | gst_xml_parse_doc () |
gboolean | gst_xml_parse_file () |
gboolean | gst_xml_parse_memory () |
GstElement * | gst_xml_get_element () |
GList * | gst_xml_get_topelements () |
GstElement * | gst_xml_make_element () |
GStreamer pipelines can be saved to xml files using gst_xml_write_file()
.
They can be loaded back using gst_xml_parse_doc()
/ gst_xml_parse_file()
/
gst_xml_parse_memory()
.
Additionally one can load saved pipelines into the gst-editor to inspect the
graph.
GstElement implementations need to override the GstObjectClass.save_thyself()
and GstObjectClass.restore_thyself()
virtual functions of GstObject.
xmlDocPtr
gst_xml_write (GstElement *element
);
gst_xml_write
is deprecated and should not be used in newly-written code.
Converts the given element into an XML presentation.
gint gst_xml_write_file (GstElement *element
,FILE *out
);
gst_xml_write_file
is deprecated and should not be used in newly-written code.
Converts the given element into XML and writes the formatted XML to an open file.
GstXML *
gst_xml_new (void
);
gst_xml_new
is deprecated and should not be used in newly-written code.
Create a new GstXML parser object.
gboolean gst_xml_parse_doc (GstXML *xml
,xmlDocPtr doc
,const guchar *root
);
gst_xml_parse_doc
is deprecated and should not be used in newly-written code.
Fills the GstXML object with the elements from the xmlDocPtr.
gboolean gst_xml_parse_file (GstXML *xml
,const guchar *fname
,const guchar *root
);
gst_xml_parse_file
is deprecated and should not be used in newly-written code.
Fills the GstXML object with the corresponding elements from the XML file fname. Optionally it will only build the element from the element node root (if it is not NULL). This feature is useful if you only want to build a specific element from an XML file but not the pipeline it is embedded in.
Pass "-" as fname to read from stdin. You can also pass a URI of any format that libxml supports, including http.
gboolean gst_xml_parse_memory (GstXML *xml
,guchar *buffer
,guint size
,const gchar *root
);
gst_xml_parse_memory
is deprecated and should not be used in newly-written code.
Fills the GstXML object with the corresponding elements from an in memory XML buffer.
GstElement * gst_xml_get_element (GstXML *xml
,const guchar *name
);
gst_xml_get_element
is deprecated and should not be used in newly-written code.
This function is used to get a pointer to the GstElement corresponding to name in the pipeline description. You would use this if you have to do anything to the element after loading.
GList *
gst_xml_get_topelements (GstXML *xml
);
gst_xml_get_topelements
is deprecated and should not be used in newly-written code.
Retrieve a list of toplevel elements.
a GList of top-level elements. The caller does not own a copy
of the list and must not free or modify the list. The caller also does not
own a reference to any of the elements in the list and should obtain its own
reference using gst_object_ref()
if necessary.
GstElement * gst_xml_make_element (xmlNodePtr cur
,GstObject *parent
);
gst_xml_make_element
is deprecated and should not be used in newly-written code.
Load the element from the XML description
“object-loaded”
signalvoid user_function (GstXML *xml, GstObject *object, gpointer xml_node, gpointer user_data)
Signals that a new object has been deserialized.
xml |
the xml persistence instance |
|
object |
the object that has been loaded |
|
xml_node |
the related xml_node pointer to the document tree |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last