= class Gst::XML
Convert Gst::Element objects into an XML presentation.

== Class Methods
--- Gst::XML.new 
    Create a new GstXML parser object.

--- Gst::XML.write_file(aGstElement, aFileName) 
    Converts the given element into XML and writes the formatted XML 
    to the specified file name.
    
    Returns true on success, false on failure.


== Instance Methods
--- each_topelement { |aGstElement| ... } 
    Calls the block for each topelement, passing a reference to
    a Gst::Element object as parameteri.
    
    Always returns nil.

--- get_element(anElementName) 
    This method is used to get a reference to the Gst::Element 
    corresponding to name in the pipeline description.  You would use 
    this if you have to do anything to the element after loading.

--- parse_file(aFilename, aRootname = nil) 
    Fills the Gst::XML object with the corresponding elements from 
    the XML file name.  Optionally it will only build the element 
    from the element node root (if it is not nil).  
    
    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 file name to read from stdin.  You can also pass a 
    URI of any format that libxml supports, including http.
    
    Returns true on success, false on failure.

--- topelements 
    Retrieve a list of all toplevel elements, in an array
    of Gst::Element objects.



== Signals
--- object-loaded

- ((<lrz>))
