/usr/share/gir-1.0/v

<?xml version="1.0"?>
<!-- This file was automatically generated from C sources - DO NOT EDIT!
To affect the contents of this file, edit the original C definitions,
and/or use gtk-doc annotations.  -->
<repository version="1.2"
            xmlns="http://www.gtk.org/introspection/core/1.0"
            xmlns:c="http://www.gtk.org/introspection/c/1.0"
            xmlns:glib="http://www.gtk.org/introspection/glib/1.0">
  <include name="Atk" version="1.0"/>
  <include name="GL" version="1.0"/>
  <include name="GLib" version="2.0"/>
  <include name="GModule" version="2.0"/>
  <include name="GObject" version="2.0"/>
  <include name="Gdk" version="2.0"/>
  <include name="GdkPixbuf" version="2.0"/>
  <include name="Gio" version="2.0"/>
  <include name="Gtk" version="2.0"/>
  <include name="Pango" version="1.0"/>
  <include name="cairo" version="1.0"/>
  <include name="xlib" version="2.0"/>
  <namespace name="v_sim"
             version="3.6"
             shared-library=""
             c:identifier-prefixes="Visu,Tool,Ext"
             c:symbol-prefixes="visu,tool,ext">
    <enumeration name="AtomicShapeId" c:type="VisuAtomicShapeId">
      <doc xml:whitespace="preserve">This enum is used as identifier for shapes managed by the
attomic rendering method.</doc>
      <member name="isu_rendering_atomic_sphere"
              value="0"
              c:identifier="VISU_RENDERING_ATOMIC_SPHERE"/>
      <member name="isu_rendering_atomic_cube"
              value="1"
              c:identifier="VISU_RENDERING_ATOMIC_CUBE"/>
      <member name="isu_rendering_atomic_ellipsoid"
              value="2"
              c:identifier="VISU_RENDERING_ATOMIC_ELLIPSOID"/>
      <member name="isu_rendering_atomic_point"
              value="3"
              c:identifier="VISU_RENDERING_ATOMIC_POINT"/>
      <member name="isu_rendering_atomic_torus"
              value="4"
              c:identifier="VISU_RENDERING_ATOMIC_TORUS"/>
      <member name="batomicshapes" value="5" c:identifier="nbAtomicShapes"/>
    </enumeration>
    <record name="BasicCLISet" c:type="VisuBasicCLISet">
      <doc xml:whitespace="preserve">Internal object to store values read from command line.</doc>
      <field name="colorFile" writable="1">
        <type name="utf8" c:type="gchar*"/>
      </field>
      <field name="planesList" introspectable="0" writable="1">
        <type c:type="Plane**"/>
      </field>
      <field name="surfsList" introspectable="0" writable="1">
        <type c:type="Surfaces**"/>
      </field>
      <field name="fieldsList" writable="1">
        <type name="GLib.List" c:type="GList*">
          <type name="gpointer" c:type="gpointer"/>
        </type>
      </field>
      <field name="shade" introspectable="0" writable="1">
        <type c:type="Shade*"/>
      </field>
      <field name="mapPlaneId" writable="1">
        <type name="gint" c:type="gint*"/>
      </field>
      <field name="logScale" writable="1">
        <type name="MatrixScalingFlag" c:type="ToolMatrixScalingFlag"/>
      </field>
      <field name="nIsolines" writable="1">
        <type name="guint" c:type="guint"/>
      </field>
      <field name="isoLinesColor" writable="1">
        <type name="gfloat" c:type="float*"/>
      </field>
      <field name="bgImage" writable="1">
        <type name="utf8" c:type="gchar*"/>
      </field>
    </record>
    <constant name="CAMERA_OMEGA" value="8" c:type="VISU_CAMERA_OMEGA">
      <type name="gint" c:type="gint"/>
    </constant>
    <constant name="CAMERA_PHI" value="4" c:type="VISU_CAMERA_PHI">
      <type name="gint" c:type="gint"/>
    </constant>
    <constant name="CAMERA_THETA" value="2" c:type="VISU_CAMERA_THETA">
      <type name="gint" c:type="gint"/>
    </constant>
    <constant name="COLOR_MASK_A" value="8" c:type="TOOL_COLOR_MASK_A">
      <type name="gint" c:type="gint"/>
    </constant>
    <constant name="COLOR_MASK_B" value="4" c:type="TOOL_COLOR_MASK_B">
      <type name="gint" c:type="gint"/>
    </constant>
    <constant name="COLOR_MASK_G" value="2" c:type="TOOL_COLOR_MASK_G">
      <type name="gint" c:type="gint"/>
    </constant>
    <constant name="COLOR_MASK_R" value="1" c:type="TOOL_COLOR_MASK_R">
      <type name="gint" c:type="gint"/>
    </constant>
    <constant name="COLOR_MASK_RGBA" value="15" c:type="TOOL_COLOR_MASK_RGBA">
      <type name="gint" c:type="gint"/>
    </constant>
    <constant name="CONFIGFILE_PARAMETER"
              value="0"
              c:type="VISU_CONFIGFILE_PARAMETER">
      <type name="gint" c:type="gint"/>
    </constant>
    <constant name="CONFIGFILE_RESOURCE"
              value="1"
              c:type="VISU_CONFIGFILE_RESOURCE">
      <type name="gint" c:type="gint"/>
    </constant>
    <record name="Color" c:type="ToolColor">
      <doc xml:whitespace="preserve">A structure to store colors.</doc>
      <field name="rgba" writable="1">
        <array zero-terminated="0" c:type="gfloat" fixed-size="4">
          <type name="gfloat" c:type="float"/>
        </array>
      </field>
      <field name="userData" writable="1">
        <type name="gpointer" c:type="gpointer"/>
      </field>
      <method name="addColor" c:identifier="tool_color_addColor">
        <doc xml:whitespace="preserve">This method copies color informations from @color to the list of stored colors.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">the newly created #ToolColor.</doc>
          <type name="Color" c:type="ToolColor*"/>
        </return-value>
      </method>
      <method name="copy" c:identifier="tool_color_copy">
        <doc xml:whitespace="preserve">This method copies all values from @color_old to @color.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="color_old" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #ToolColor to read the values from.</doc>
            <type name="Color" c:type="ToolColor*"/>
          </parameter>
        </parameters>
      </method>
      <method name="equal" c:identifier="tool_color_equal">
        <doc xml:whitespace="preserve">Test if the two colours are the same.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if the @rgba attributes are the same.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="color2" transfer-ownership="none">
            <doc xml:whitespace="preserve">an other #ToolColor.</doc>
            <type name="Color" c:type="ToolColor*"/>
          </parameter>
        </parameters>
      </method>
      <method name="getByColor" c:identifier="tool_color_getByColor">
        <doc xml:whitespace="preserve">This function retrieves the number (begining at 0) of the specified color.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">the position of the specified color or -1 if not found.</doc>
          <type name="gint" c:type="int"/>
        </return-value>
      </method>
      <function name="addFloatRGBA" c:identifier="tool_color_addFloatRGBA">
        <doc xml:whitespace="preserve">This method adds a new color in the list of stored colors with the given values.
If it already exits it returns the pointer of that color.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">a newly created #ToolColor or the already existing one.</doc>
          <type name="Color" c:type="ToolColor*"/>
        </return-value>
        <parameters>
          <parameter name="rgba" transfer-ownership="none">
            <doc xml:whitespace="preserve">four values between 0. and 1. that represent [Red, Green, Blue, Alpha] ;</doc>
            <type name="gfloat" c:type="float"/>
          </parameter>
          <parameter name="position"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none">
            <doc xml:whitespace="preserve">an int pointer to store the position of the returned colour.</doc>
            <type name="gint" c:type="int*"/>
          </parameter>
        </parameters>
      </function>
      <function name="addIntRGBA" c:identifier="tool_color_addIntRGBA">
        <doc xml:whitespace="preserve">This method adds a new color in the list of stored colors with the given values.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">a newly created #ToolColor or the already existing one.</doc>
          <type name="Color" c:type="ToolColor*"/>
        </return-value>
        <parameters>
          <parameter name="rgba" transfer-ownership="none">
            <doc xml:whitespace="preserve">four values between 0 and 255 that represent [Red, Green, Blue, Alpha].</doc>
            <type name="gint" c:type="int"/>
          </parameter>
        </parameters>
      </function>
      <function name="convertHSLtoRGB"
                c:identifier="tool_color_convertHSLtoRGB">
        <doc xml:whitespace="preserve">This methods convert a HSL color to a RGB one.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="rgb" transfer-ownership="none">
            <doc xml:whitespace="preserve">an allocated 3 elements array to receive the RGB values ;</doc>
            <type name="gfloat" c:type="float*"/>
          </parameter>
          <parameter name="hsl" transfer-ownership="none">
            <doc xml:whitespace="preserve">a 3 elements array to retrieve the HSL values from.</doc>
            <type name="gfloat" c:type="float*"/>
          </parameter>
        </parameters>
      </function>
      <function name="convertHSVtoRGB"
                c:identifier="tool_color_convertHSVtoRGB">
        <doc xml:whitespace="preserve">This methods convert a HSV color to a RGB one.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="rgb" transfer-ownership="none">
            <doc xml:whitespace="preserve">an allocated 3 elements array to receive the RGB values ;</doc>
            <type name="gfloat" c:type="float*"/>
          </parameter>
          <parameter name="hsv" transfer-ownership="none">
            <doc xml:whitespace="preserve">a 3 elements array to retrieve the HSV values from.</doc>
            <type name="gfloat" c:type="float*"/>
          </parameter>
        </parameters>
      </function>
      <function name="convertRGBtoHSL"
                c:identifier="tool_color_convertRGBtoHSL">
        <doc xml:whitespace="preserve">Convert a RGB colour into a HSL one.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="hsl" transfer-ownership="none">
            <doc xml:whitespace="preserve">three float to store the HSL value ;</doc>
            <type name="gfloat" c:type="float*"/>
          </parameter>
          <parameter name="rgb" transfer-ownership="none">
            <doc xml:whitespace="preserve">three floats giving the RGB values.</doc>
            <type name="gfloat" c:type="float*"/>
          </parameter>
        </parameters>
      </function>
      <function name="freeAll" c:identifier="tool_color_freeAll">
        <doc xml:whitespace="preserve">Remove all previously stored colours.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
      </function>
      <function name="getById" c:identifier="tool_color_getById">
        <doc xml:whitespace="preserve">This function retrieves the nth stored color. Number 0, is the last
added color.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">the corresponding color, or NULL if none has been found.</doc>
          <type name="Color" c:type="ToolColor*"/>
        </return-value>
        <parameters>
          <parameter name="num" transfer-ownership="none">
            <doc xml:whitespace="preserve">an integer (&gt;0).</doc>
            <type name="gint" c:type="int"/>
          </parameter>
        </parameters>
      </function>
      <function name="getByValues" c:identifier="tool_color_getByValues">
        <doc xml:whitespace="preserve">This method is used to look for a specific color in the stored list. The argument @pos
is -1 if nothing is found or stores the position (beginning at 0) of the found color.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">the found color, or NULL if none exists.</doc>
          <type name="Color" c:type="ToolColor*"/>
        </return-value>
        <parameters>
          <parameter name="pos"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none">
            <doc xml:whitespace="preserve">an allocated int to store the position of the found color ;</doc>
            <type name="gint" c:type="int*"/>
          </parameter>
          <parameter name="red" transfer-ownership="none">
            <doc xml:whitespace="preserve">a value between 0. and 1. ;</doc>
            <type name="gfloat" c:type="float"/>
          </parameter>
          <parameter name="green" transfer-ownership="none">
            <doc xml:whitespace="preserve">a value between 0. and 1. ;</doc>
            <type name="gfloat" c:type="float"/>
          </parameter>
          <parameter name="blue" transfer-ownership="none">
            <doc xml:whitespace="preserve">a value between 0. and 1. ;</doc>
            <type name="gfloat" c:type="float"/>
          </parameter>
          <parameter name="alpha" transfer-ownership="none">
            <doc xml:whitespace="preserve">a value between 0. and 1..</doc>
            <type name="gfloat" c:type="float"/>
          </parameter>
        </parameters>
      </function>
      <function name="getLastStored" c:identifier="tool_color_getLastStored">
        <doc xml:whitespace="preserve">This method is typiccally called after a client has catched
the colorNewAvailable signal.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">the last added color, NULL if no color exists.</doc>
          <type name="Color" c:type="ToolColor*"/>
        </return-value>
      </function>
      <function name="getStoredColors"
                c:identifier="tool_color_getStoredColors">
        <doc xml:whitespace="preserve">Use this method to get a pointeur to the list of stored colors.

a GList pointer to the stored colors.</doc>
        <return-value transfer-ownership="none">
          <type name="GLib.List" c:type="GList*">
            <type name="Color"/>
          </type>
        </return-value>
      </function>
      <function name="new" c:identifier="tool_color_new">
        <doc xml:whitespace="preserve">Create a new color with initial values given as arguments.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">a new allocated #ToolColor (use g_free() to free it).</doc>
          <type name="Color" c:type="ToolColor*"/>
        </return-value>
        <parameters>
          <parameter name="rgba" transfer-ownership="none">
            <doc xml:whitespace="preserve">four values between 0. and 1. that represent [Red, Green, Blue, Alpha].</doc>
            <type name="gfloat" c:type="float"/>
          </parameter>
        </parameters>
      </function>
    </record>
    <record name="ConfigFileEntry" c:type="VisuConfigFileEntry" disguised="1">
      <doc xml:whitespace="preserve">This is the common name of the structure.</doc>
    </record>
    <callback name="ConfigFileExportFunc" c:type="VisuConfigFileExportFunc">
      <doc xml:whitespace="preserve">This prototype defines a method that is used to export some resources
or parameters. The @data argument is an empty GString where the export has
to be written. If the argument @dataObj is not null, only resources related
to the #VisuData object should be exported (for parameters files, @dataObj is
always NULL).</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="data" transfer-ownership="none">
          <doc xml:whitespace="preserve">an empty GString to store the export ;</doc>
          <type name="GLib.String" c:type="GString*"/>
        </parameter>
        <parameter name="dataObj" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuData object.</doc>
          <type name="Data" c:type="VisuData*"/>
        </parameter>
      </parameters>
    </callback>
    <callback name="ConfigFileReadFunc"
              c:type="VisuConfigFileReadFunc"
              throws="1">
      <doc xml:whitespace="preserve">This prototype corresponds to methods called when an entry is
found. The @lines argument is an array of lines read from the files.
These strings are copies and can be modified but not freed. There are
@nbLines and this value correspond to the number of lines defined
for the entry. The @error argument is used to store some text
messages and error ids. They should be in UTF8. The @error argument
must be initialised with (GError*)0. The @position argument give the number
of the first line given in @lines argument. If the @dataObj argument is not null,
some updates should be done with read values.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">TRUE if everything goes right, FALSE otherwise.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </return-value>
      <parameters>
        <parameter name="lines" transfer-ownership="none">
          <doc xml:whitespace="preserve">an array of strings ;</doc>
          <type name="utf8" c:type="gchar**"/>
        </parameter>
        <parameter name="nbLines" transfer-ownership="none">
          <doc xml:whitespace="preserve">an integer ;</doc>
          <type name="gint" c:type="int"/>
        </parameter>
        <parameter name="position" transfer-ownership="none">
          <doc xml:whitespace="preserve">an integer ;</doc>
          <type name="gint" c:type="int"/>
        </parameter>
        <parameter name="dataObj" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuData object ;</doc>
          <type name="Data" c:type="VisuData*"/>
        </parameter>
      </parameters>
    </callback>
    <class name="Data"
           c:symbol-prefix="data"
           parent="GObject.Object"
           glib:type-name="VisuData"
           glib:get-type="visu_data_get_type"
           glib:type-struct="DataClass">
      <doc xml:whitespace="preserve">This structure describes a #VisuData object.</doc>
      <constructor name="new" c:identifier="visu_data_new">
        <doc xml:whitespace="preserve">This creates an empty #VisuData object.</doc>
        <return-value transfer-ownership="full">
          <doc xml:whitespace="preserve">a newly created #VisuData object (its ref count is set to 1).</doc>
          <type name="Data" c:type="VisuData*"/>
        </return-value>
      </constructor>
      <function name="getAllObjects"
                c:identifier="visu_data_getAllObjects"
                introspectable="0">
        <doc xml:whitespace="preserve">This methods is used to retrieve all #VisuObject currently allocated
in V_Sim. It is usefull to apply some changes on all objects (resources
for example).</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">a list of V_Sim own #VisuData objects.</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="gpointer" c:type="gpointer"/>
          </type>
        </return-value>
      </function>
      <function name="newWithSize" c:identifier="visu_data_newWithSize">
        <doc xml:whitespace="preserve">Create a new #VisuData object with a given size for the view.</doc>
        <return-value transfer-ownership="full">
          <doc xml:whitespace="preserve">a newly created object.</doc>
          <type name="Data" c:type="VisuData*"/>
        </return-value>
        <parameters>
          <parameter name="w" transfer-ownership="none">
            <doc xml:whitespace="preserve">the width size ;</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
          <parameter name="h" transfer-ownership="none">
            <doc xml:whitespace="preserve">the height size.</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
        </parameters>
      </function>
      <function name="newWithView" c:identifier="visu_data_newWithView">
        <doc xml:whitespace="preserve">This creates an empty #VisuData object with values for its view taken
from the given @view argument (the argument is indeed copied). If @autoAdjust
is TRUE, the zoom level is automaticaly adjusted for the object to be
full size at zoom level 1.</doc>
        <return-value transfer-ownership="full">
          <doc xml:whitespace="preserve">a newly created #VisuData object (its ref count is set to 1).</doc>
          <type name="Data" c:type="VisuData*"/>
        </return-value>
        <parameters>
          <parameter name="view" transfer-ownership="none">
            <doc xml:whitespace="preserve">an #VisuOpenGLView object.</doc>
            <type name="OpenGLView" c:type="VisuOpenGLView*"/>
          </parameter>
          <parameter name="autoAdjust" transfer-ownership="none">
            <doc xml:whitespace="preserve">a boolean.</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </function>
      <method name="addFile" c:identifier="visu_data_addFile">
        <doc xml:whitespace="preserve">This method is used to add files
of type @kind to the @data. The @file
attribute is copied. The @format argument can be null.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="file" transfer-ownership="none">
            <doc xml:whitespace="preserve">a string that points to a file ;</doc>
            <type name="utf8" c:type="gchar*"/>
          </parameter>
          <parameter name="kind" transfer-ownership="none">
            <doc xml:whitespace="preserve">an integer to qualify the file to add ;</doc>
            <type name="gint" c:type="int"/>
          </parameter>
          <parameter name="format" transfer-ownership="none" allow-none="1">
            <doc xml:whitespace="preserve">a file format.</doc>
            <type name="FileFormat" c:type="ToolFileFormat*"/>
          </parameter>
        </parameters>
      </method>
      <method name="addNodeFromElement"
              c:identifier="visu_data_addNodeFromElement">
        <doc xml:whitespace="preserve">This method adds a new #VisuNode to the specified #VisuData. If
@emitSignal is TRUE, then NodePopulationIncrease signal is
triggered.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">a pointer to the newly created node.</doc>
          <type name="Node" c:type="VisuNode*"/>
        </return-value>
        <parameters>
          <parameter name="ele" transfer-ownership="none">
            <doc xml:whitespace="preserve">the #VisuElement kind of the new #VisuNode ;</doc>
            <type name="Element" c:type="VisuElement*"/>
          </parameter>
          <parameter name="xyz" transfer-ownership="none">
            <doc xml:whitespace="preserve">its coordinates ;</doc>
            <array zero-terminated="0" c:type="float" fixed-size="3">
              <type name="gfloat" c:type="float"/>
            </array>
          </parameter>
          <parameter name="reduced" transfer-ownership="none">
            <doc xml:whitespace="preserve">coordinates are in reduced coordinates ;</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
          <parameter name="emitSignal" transfer-ownership="none">
            <doc xml:whitespace="preserve">a boolean.</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="addNodeFromElementName"
              c:identifier="visu_data_addNodeFromElementName"
              version="3.6">
        <doc xml:whitespace="preserve">This method adds a new #VisuNode to the specified #VisuData. If
@emitSignal is TRUE, then NodePopulationIncrease signal is
triggered.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">a pointer to the newly created node.</doc>
          <type name="Node" c:type="VisuNode*"/>
        </return-value>
        <parameters>
          <parameter name="name" transfer-ownership="none">
            <doc xml:whitespace="preserve">the name of the element ;</doc>
            <type name="utf8" c:type="gchar*"/>
          </parameter>
          <parameter name="xyz" transfer-ownership="none">
            <doc xml:whitespace="preserve">its coordinates ;</doc>
            <array zero-terminated="0" c:type="float" fixed-size="3">
              <type name="gfloat" c:type="float"/>
            </array>
          </parameter>
          <parameter name="reduced" transfer-ownership="none">
            <doc xml:whitespace="preserve">coordinates are in reduced coordinates ;</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
          <parameter name="emitSignal" transfer-ownership="none">
            <doc xml:whitespace="preserve">a boolean.</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="addNodeFromIndex"
              c:identifier="visu_data_addNodeFromIndex">
        <doc xml:whitespace="preserve">This method adds a new #VisuNode to the specified #VisuData. Position must be
chosen between 0 and (ntype - 1) and corresponds to the position of the array
of #VisuNodes of a #VisuElement. If @emitSignal is TRUE, then
NodePopulationIncrease signal is triggered.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">a pointer to the newly created node.</doc>
          <type name="Node" c:type="VisuNode*"/>
        </return-value>
        <parameters>
          <parameter name="position" transfer-ownership="none">
            <doc xml:whitespace="preserve">a integer corresponding to the position of a #VisuElement in the array **nodes in the structure;</doc>
            <type name="guint" c:type="unsigned int"/>
          </parameter>
          <parameter name="xyz" transfer-ownership="none">
            <doc xml:whitespace="preserve">its coordinates ;</doc>
            <array zero-terminated="0" c:type="float" fixed-size="3">
              <type name="gfloat" c:type="float"/>
            </array>
          </parameter>
          <parameter name="reduced" transfer-ownership="none">
            <doc xml:whitespace="preserve">coordinates are in reduced coordinates ;</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
          <parameter name="emitSignal" transfer-ownership="none">
            <doc xml:whitespace="preserve">a boolean.</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="addTimeout" c:identifier="visu_data_addTimeout">
        <doc xml:whitespace="preserve">This method is used to add the @func method to be called regularly at the period
@time. This methos calls in fact g_timeout_add() with the given arguments. But
the source id is stored internaly and the timeout function is removed automatically
when the object @data is destroyed. It is convienient to add a method working
on the #VisuData object that is called periodically during the life of te object.

the callback, don't use g_source_remove() but visu_data_removeTimeout()
to inform the #VisuData object that this source has been removed and
not to remove it when the object will be destroyed.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">the source id if the calling method need to work with it. To remove</doc>
          <type name="guint" c:type="guint"/>
        </return-value>
        <parameters>
          <parameter name="time" transfer-ownership="none">
            <doc xml:whitespace="preserve">the period of call in milliseconds ;</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
          <parameter name="func"
                     transfer-ownership="none"
                     scope="call"
                     closure="2">
            <doc xml:whitespace="preserve">the callback function to be called ;</doc>
            <type name="GLib.SourceFunc" c:type="GSourceFunc"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:whitespace="preserve">a pointer to some user defined informations.</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="allocatePopulation"
              c:identifier="visu_data_allocatePopulation">
        <doc xml:whitespace="preserve">This method allocates the storing part of the given #VisuData structure and
store all the #VisuNodes.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if everything goes right.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="nNodesPerElement" transfer-ownership="none">
            <doc xml:whitespace="preserve">number of #VisuNode per VisuElement;</doc>
            <array name="GLib.Array" c:type="GArray*">
              <type name="guint"/>
            </array>
          </parameter>
          <parameter name="elements" transfer-ownership="none">
            <doc xml:whitespace="preserve">pointers to #VisuElement in the same order that @nNodesPerElement;</doc>
            <array name="GLib.Array" c:type="GArray*">
              <type name="Element"/>
            </array>
          </parameter>
        </parameters>
      </method>
      <method name="allocatePopulationByNames"
              c:identifier="visu_data_allocatePopulationByNames">
        <doc xml:whitespace="preserve">This method allocates the storing part of the given #VisuData structure and
store all the #VisuNodes.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if everything goes right.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="nNodesPerElement" transfer-ownership="none">
            <doc xml:whitespace="preserve">number of #VisuNode per VisuElement;</doc>
            <array name="GLib.Array" c:type="GArray*">
              <type name="guint"/>
            </array>
          </parameter>
          <parameter name="elementNames" transfer-ownership="none">
            <doc xml:whitespace="preserve">names of elements;</doc>
            <array name="GLib.Array" c:type="GArray*">
              <type name="utf8"/>
            </array>
          </parameter>
        </parameters>
      </method>
      <method name="applyBoxGeometry"
              c:identifier="visu_data_applyBoxGeometry">
        <doc xml:whitespace="preserve">The box expansion is calculated. From this call, all cartesian
coordinates are treated in V_Sim box definition and not a possible
full definition.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
      </method>
      <method name="compareElements" c:identifier="visu_data_compareElements">
        <doc xml:whitespace="preserve">This method is used to compare the composition of the given two #VisuData objects.
The test is only done on #VisuElement lists.

one more or one less or one different), FALSE otherwise.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if the two objects contains exactly the same #VisuElement objects (not</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="data2" transfer-ownership="none">
            <doc xml:whitespace="preserve">an other #VisuData object.</doc>
            <type name="Data" c:type="VisuData*"/>
          </parameter>
        </parameters>
      </method>
      <method name="constrainedElementInTheBox"
              c:identifier="visu_data_constrainedElementInTheBox">
        <doc xml:whitespace="preserve">Check all the nodes of the specified @element and change their coordinates if they are out
of the bounding box. The position of each node is the result of the
sum of their own position and of the box translation.

the 'NodePositionChanged' should be emitted.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if visu_data_createAllNodes() should be called and</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="element" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuElement object.</doc>
            <type name="Element" c:type="VisuElement*"/>
          </parameter>
        </parameters>
      </method>
      <method name="constrainedFree" c:identifier="visu_data_constrainedFree">
        <doc xml:whitespace="preserve">Return all the nodes to their original position, except for the
global translation.

the 'NodePositionChanged' should be emitted.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if visu_data_createAllNodes() should be called and</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
      </method>
      <method name="constrainedInTheBox"
              c:identifier="visu_data_constrainedInTheBox">
        <doc xml:whitespace="preserve">It does the same things that visu_data_constrainedElementInTheBox() but for all
the #VisuElement of the given @data. I.e. it checks all the nodes and changes
their coordinates if they are out of the bounding box.
The position of each node is the result of the
sum of their own position and of the box translation.

the 'NodePositionChanged' should be emitted.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if visu_data_createAllNodes() should be called and</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
      </method>
      <method name="convertBoxCoordinatestoXYZ"
              c:identifier="visu_data_convertBoxCoordinatestoXYZ">
        <doc xml:whitespace="preserve">Use this method to transform box coordinates into cartesian.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="xyz"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none">
            <doc xml:whitespace="preserve">an array of floating point values to store the result ;</doc>
            <array zero-terminated="0" c:type="float" fixed-size="3">
              <type name="gfloat" c:type="float"/>
            </array>
          </parameter>
          <parameter name="boxCoord" transfer-ownership="none">
            <doc xml:whitespace="preserve">an array of floating point values that describes the box coordinates.</doc>
            <array zero-terminated="0" c:type="float" fixed-size="3">
              <type name="gfloat" c:type="float"/>
            </array>
          </parameter>
        </parameters>
      </method>
      <method name="convertFullCartesianToSpherical"
              c:identifier="visu_data_convertFullCartesianToSpherical"
              version="3.6">
        <doc xml:whitespace="preserve">Convert given cartesian coordinates to spherical ones. If the box has been rotated
(see visu_data_setBoxGeometryFull()), then the cartesian coordinates should
be the one before the rotation.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="sph"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none">
            <array zero-terminated="0" c:type="float" fixed-size="3">
              <type name="gfloat" c:type="float"/>
            </array>
          </parameter>
          <parameter name="xyz" transfer-ownership="none">
            <array zero-terminated="0" c:type="float" fixed-size="3">
              <type name="gfloat" c:type="float"/>
            </array>
          </parameter>
        </parameters>
      </method>
      <method name="convertReducedToXYZ"
              c:identifier="visu_data_convertReducedToXYZ"
              version="3.6">
        <doc xml:whitespace="preserve">Use this method to transform box coordinates into cartesian.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="red" transfer-ownership="none">
            <doc xml:whitespace="preserve">floating point values that describes the cartesian coordinates.</doc>
            <array zero-terminated="0"
                   name="GLib.Array"
                   c:type="GArray*"
                   fixed-size="3">
              <type name="gfloat"/>
            </array>
          </parameter>
          <parameter name="x"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none">
            <doc xml:whitespace="preserve">the x coordinate.</doc>
            <type name="gfloat" c:type="float*"/>
          </parameter>
          <parameter name="y"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none">
            <doc xml:whitespace="preserve">the y coordinate.</doc>
            <type name="gfloat" c:type="float*"/>
          </parameter>
          <parameter name="z"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none">
            <doc xml:whitespace="preserve">the z coordinate.</doc>
            <type name="gfloat" c:type="float*"/>
          </parameter>
        </parameters>
      </method>
      <method name="convertXYZToReduced"
              c:identifier="visu_data_convertXYZToReduced"
              version="3.6">
        <doc xml:whitespace="preserve">Use this method to transform cartesian into box coordinates.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="xyz" transfer-ownership="none">
            <doc xml:whitespace="preserve">floating point values that describes the cartesian coordinates.</doc>
            <array zero-terminated="0"
                   name="GLib.Array"
                   c:type="GArray*"
                   fixed-size="3">
              <type name="gfloat"/>
            </array>
          </parameter>
          <parameter name="u"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none">
            <doc xml:whitespace="preserve">the x coordinate.</doc>
            <type name="gfloat" c:type="float*"/>
          </parameter>
          <parameter name="v"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none">
            <doc xml:whitespace="preserve">the y coordinate.</doc>
            <type name="gfloat" c:type="float*"/>
          </parameter>
          <parameter name="w"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none">
            <doc xml:whitespace="preserve">the z coordinate.</doc>
            <type name="gfloat" c:type="float*"/>
          </parameter>
        </parameters>
      </method>
      <method name="convertXYZtoBoxCoordinates"
              c:identifier="visu_data_convertXYZtoBoxCoordinates"
              introspectable="0">
        <doc xml:whitespace="preserve">Use this method to transform cartesian coordinates to the box coordinates.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="boxCoord" transfer-ownership="none">
            <doc xml:whitespace="preserve">an array of floating point values to store the result ;</doc>
            <array zero-terminated="0" c:type="float" fixed-size="3">
              <type name="gfloat" c:type="float"/>
            </array>
          </parameter>
          <parameter name="xyz" transfer-ownership="none">
            <doc xml:whitespace="preserve">an array of floating point values describing coordinates in cartesian.</doc>
            <array zero-terminated="0" c:type="float" fixed-size="3">
              <type name="gfloat" c:type="float"/>
            </array>
          </parameter>
        </parameters>
      </method>
      <method name="createAllElements"
              c:identifier="visu_data_createAllElements">
        <doc xml:whitespace="preserve">This method will call the createOpenGLElementFunc() method of the current #RenderingMethod
on all the nodes of the given #VisuData.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
      </method>
      <method name="createAllNodes" c:identifier="visu_data_createAllNodes">
        <doc xml:whitespace="preserve">This create the glObjectList registered that contains all the
nodes. This glObjectList is made of all nodes of all element whose
attribute rendered is TRUE and translated to their own positions.

This method doesn't ask for redraw and #VISU_ADD_REDRAW macro
should be called by caller.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
      </method>
      <method name="createNode" c:identifier="visu_data_createNode">
        <doc xml:whitespace="preserve">This method call the createNode method of the current rendering method
for the given node. It also calls the list of the material associated
to the given node.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="node" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuNode object.</doc>
            <type name="Node" c:type="VisuNode*"/>
          </parameter>
        </parameters>
      </method>
      <method name="createNodes" c:identifier="visu_data_createNodes">
        <doc xml:whitespace="preserve">This creates the glObjectList that contains all the nodes of the given #VisuElement.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="ele" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuElement object.</doc>
            <type name="Element" c:type="VisuElement*"/>
          </parameter>
        </parameters>
      </method>
      <method name="emitAskForShowHideNodes"
              c:identifier="visu_data_emitAskForShowHideNodes">
        <doc xml:whitespace="preserve">This methods is used to emit the 'NodeAskForShowHide' signal. This
signal asks all modules that may hide nodes to recompute their
hiding scheme and put in @redraw if they have changed something. Since
all listeners write in @redraw, they should modify it with an union.
@redraw is initialised at FALSE before the signal is emitted.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="redraw" transfer-ownership="none">
            <doc xml:whitespace="preserve">a pointer to a location to store if redraw is needed after all listeners have modified the nodes of the given @data.</doc>
            <type name="gboolean" c:type="gboolean*"/>
          </parameter>
        </parameters>
      </method>
      <method name="emitFacettesChanged"
              c:identifier="visu_data_emitFacettesChanged">
        <doc xml:whitespace="preserve">Emit the 'OpenGLFacetteChanged' signal.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
      </method>
      <method name="emitNodePositionChanged"
              c:identifier="visu_data_emitNodePositionChanged">
        <doc xml:whitespace="preserve">This method is used to emit the 'NodePositionChanged' signal. This signal asks
all modules that are dependent of the nodes' positions to recompute their
OpenGL lists.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
      </method>
      <method name="emitNodeRenderedChange"
              c:identifier="visu_data_emitNodeRenderedChange">
        <doc xml:whitespace="preserve">This method is used to emit the 'NodeRenderedChanged' signal. This signal asks
all modules that are dependent of the nodes' visibility to recompute their
OpenGL lists. This signal is usualy emitted after a call to
visu_data_emitAskForShowHideNodes().</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
      </method>
      <method name="freePopulation" c:identifier="visu_data_freePopulation">
        <doc xml:whitespace="preserve">This method frees only the allocated memory that deals with
the nodes (i.e. everything except the data of the files,
the properties and the setColor method.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
      </method>
      <method name="getAllElementExtens"
              c:identifier="visu_data_getAllElementExtens">
        <doc xml:whitespace="preserve">Calculate the maximum size of all #VisuElement used in this
@dataObj.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">a positive size.</doc>
          <type name="gfloat" c:type="float"/>
        </return-value>
      </method>
      <method name="getBoundaryConditions"
              c:identifier="visu_data_getBoundaryConditions"
              version="3.5">
        <doc xml:whitespace="preserve">Get the boundary conditions defined for @data.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuDataBoxBoundaries flag.</doc>
          <type name="DataBoxBoundaries" c:type="VisuDataBoxBoundaries"/>
        </return-value>
      </method>
      <method name="getBoxCentre" c:identifier="visu_data_getBoxCentre">
        <doc xml:whitespace="preserve">@centre contains on output the cartesian coordinates of the centre
of the bounding box.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="centre" transfer-ownership="none">
            <doc xml:whitespace="preserve">coordinates of the centre.</doc>
            <array zero-terminated="0" c:type="float" fixed-size="3">
              <type name="gfloat" c:type="float"/>
            </array>
          </parameter>
        </parameters>
      </method>
      <method name="getBoxExtens" c:identifier="visu_data_getBoxExtens">
        <doc xml:whitespace="preserve">This routines returns two float values giving the longest length of
the bounding box, with or without extension applied.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">two floating point values.</doc>
          <type name="gfloat" c:type="float*"/>
        </return-value>
      </method>
      <method name="getBoxGeometry" c:identifier="visu_data_getBoxGeometry">
        <doc xml:whitespace="preserve">Retrieve the value of a vector defining the bounding box. The vector
is chosen with an int, see the #visu_data_boxVector enum for more
details.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">the value of the required vector (always a positive value for vector = 0, 2 or 5 !).</doc>
          <type name="gfloat" c:type="float"/>
        </return-value>
        <parameters>
          <parameter name="vector" transfer-ownership="none">
            <doc xml:whitespace="preserve">an int corresponding to a vector of the box.</doc>
            <type name="gint" c:type="int"/>
          </parameter>
        </parameters>
      </method>
      <method name="getBoxLengths"
              c:identifier="visu_data_getBoxLengths"
              version="3.6">
        <doc xml:whitespace="preserve">Equivalent function to visu_data_getBoxExtens().</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="ext1"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none">
            <doc xml:whitespace="preserve">the length scale ;</doc>
            <type name="gfloat" c:type="float*"/>
          </parameter>
          <parameter name="ext2"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none">
            <doc xml:whitespace="preserve">...</doc>
            <type name="gfloat" c:type="float*"/>
          </parameter>
        </parameters>
      </method>
      <method name="getBoxMatrix" c:identifier="visu_data_getBoxMatrix">
        <doc xml:whitespace="preserve">This method is used when the box matrix is required. This matrix can transform
a vector given in box coordinates into a cartesian vector. If a simple vector
multication is required, then the use of visu_data_convertBoxCoordinatestoXYZ()
should be prefered.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="matrix"
                     direction="inout"
                     caller-allocates="0"
                     transfer-ownership="full">
            <doc xml:whitespace="preserve">an area to store the matrix.</doc>
            <array zero-terminated="0" c:type="float" fixed-size="3">
              <type name="gfloat" c:type="float"/>
            </array>
          </parameter>
        </parameters>
      </method>
      <method name="getBoxMatrixD0" c:identifier="visu_data_getBoxMatrixD0">
        <doc xml:whitespace="preserve">Same as visu_data_getBoxMatrix() but with a double precision
matrix.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="matrix"
                     direction="inout"
                     caller-allocates="0"
                     transfer-ownership="full">
            <doc xml:whitespace="preserve">an area to store the matrix.</doc>
            <array zero-terminated="0" c:type="double" fixed-size="3">
              <type name="gdouble" c:type="double"/>
            </array>
          </parameter>
        </parameters>
      </method>
      <method name="getBoxSpan" c:identifier="visu_data_getBoxSpan">
        <doc xml:whitespace="preserve">Compute the two most far distance from origin in the box. The first
is the negative one and the second, the positive one.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="span" transfer-ownership="none">
            <doc xml:whitespace="preserve">a location to store two floats.</doc>
            <array zero-terminated="0" c:type="float" fixed-size="2">
              <type name="gfloat" c:type="float"/>
            </array>
          </parameter>
        </parameters>
      </method>
      <method name="getBoxVertices" c:identifier="visu_data_getBoxVertices">
        <doc xml:whitespace="preserve">All nodes are rendered inside a bounding box, this method can be used to retrieve
it. This box is not the drawn box but the box containing all the
nodes, included possible extension. To get the box itself, use
visu_data_getBoxMatrix() instead. One can also get the vertices of
the box itself using FALSE as @withExtension argument.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="v" transfer-ownership="none">
            <doc xml:whitespace="preserve">the position of the eight vertices of the bounding box.</doc>
            <array zero-terminated="0" c:type="float">
              <type name="gfloat" c:type="float"/>
            </array>
          </parameter>
          <parameter name="withExtension" transfer-ownership="none">
            <doc xml:whitespace="preserve">a boolean.</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="getChangeElementFlag"
              c:identifier="visu_data_getChangeElementFlag">
        <doc xml:whitespace="preserve">V_Sim can use a flag set on @data object to know if @data has exactly the same
#VisuElement list than the previously rendered one.

#VisuElement list than the given one, FALSE otherwise.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if the previously rendered #VisuData object has had the same</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
      </method>
      <method name="getDistanceList"
              c:identifier="visu_data_getDistanceList"
              version="3.5"
              introspectable="0">
        <doc xml:whitespace="preserve">This routine creates an array of #VisuNodeInfo, storing for each
node its node id and its distance to @nodeId. The periodicity is
NOT taken into account. The array is not distance sorted, but if
@minVal is provided, it will contain the minimal distance between
@nodeId and the other nodes.


is terminated by @nodeId value itself.</doc>
        <return-value>
          <doc xml:whitespace="preserve">an array of #VisuNodeInfo of size the number of nodes. It</doc>
          <type name="NodeInfo" c:type="VisuNodeInfo*"/>
        </return-value>
        <parameters>
          <parameter name="nodeId" transfer-ownership="none">
            <doc xml:whitespace="preserve">a node id.</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
          <parameter name="minVal" transfer-ownership="none">
            <doc xml:whitespace="preserve">a location for a float.</doc>
            <type name="gfloat" c:type="float*"/>
          </parameter>
        </parameters>
      </method>
      <method name="getExtension" c:identifier="visu_data_getExtension">
        <doc xml:whitespace="preserve">Using visu_data_replicate(), it is possible to duplicate the primitive box
in each directions. Use this method to know the current extension. Returned
values are positive floating point values. An extension of 0. means that
only the primitive box exists, while a value of one means a duplication of
one box in each direction of the coordinate.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="extension" transfer-ownership="none">
            <doc xml:whitespace="preserve">an allocated array to store the values.</doc>
            <array zero-terminated="0" c:type="float" fixed-size="3">
              <type name="gfloat" c:type="float"/>
            </array>
          </parameter>
        </parameters>
      </method>
      <method name="getFile" c:identifier="visu_data_getFile">
        <doc xml:whitespace="preserve">This prototype is used to retrieve stored
files identify by their @kind.</doc>
        <return-value transfer-ownership="full">
          <doc xml:whitespace="preserve">the name of a file (it should not be deleted).</doc>
          <type name="utf8" c:type="gchar*"/>
        </return-value>
        <parameters>
          <parameter name="kind" transfer-ownership="none">
            <doc xml:whitespace="preserve">an integer to qualify the required file ;</doc>
            <type name="gint" c:type="int"/>
          </parameter>
          <parameter name="format" transfer-ownership="none">
            <doc xml:whitespace="preserve">a location for a file format (can be NULL).</doc>
            <type name="FileFormat" c:type="ToolFileFormat**"/>
          </parameter>
        </parameters>
      </method>
      <method name="getFileCommentary"
              c:identifier="visu_data_getFileCommentary">
        <doc xml:whitespace="preserve">Get the commentary associated to the given @data, for the given
node set.

and should not be freed.</doc>
        <return-value transfer-ownership="full">
          <doc xml:whitespace="preserve">a string description (possibly empty). This string is own by V_Sim</doc>
          <type name="utf8" c:type="gchar*"/>
        </return-value>
        <parameters>
          <parameter name="iSet" transfer-ownership="none">
            <doc xml:whitespace="preserve">an integer (&gt;= 0).</doc>
            <type name="gint" c:type="gint"/>
          </parameter>
        </parameters>
      </method>
      <method name="getFilesAsLabel"
              c:identifier="visu_data_getFilesAsLabel"
              version="3.6">
        <doc xml:whitespace="preserve">Creates a label using the list of files used to defined this @data
separated by dashes.


were used to defined @data, the function returns NULL.</doc>
        <return-value transfer-ownership="full">
          <doc xml:whitespace="preserve">a newly created string with the filenames. If no filename</doc>
          <type name="utf8" c:type="gchar*"/>
        </return-value>
      </method>
      <method name="getISubset" c:identifier="visu_data_getISubset">
        <doc xml:whitespace="preserve">Retrieve the id of the current set of data (ordered as in C,
beginning at 0).</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">the id of the set of nodes currently loaded, -1 if none.</doc>
          <type name="gint" c:type="int"/>
        </return-value>
      </method>
      <method name="getNSubset" c:identifier="visu_data_getNSubset">
        <doc xml:whitespace="preserve">Retrieve the number of available sets of nodes for this #VisuData,
see visu_data_setNSubset().</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">the number of set of nodes (1 is default).</doc>
          <type name="gint" c:type="int"/>
        </return-value>
      </method>
      <method name="getNodeArray" c:identifier="visu_data_getNodeArray">
        <doc xml:whitespace="preserve">This method retrieve the #VisuNodeArray associated to the given @data.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">the associated #VisuNodeArray.</doc>
          <type name="NodeArray" c:type="VisuNodeArray*"/>
        </return-value>
      </method>
      <method name="getNodeBoxFromCoord"
              c:identifier="visu_data_getNodeBoxFromCoord">
        <doc xml:whitespace="preserve">This method retrieves the value of the box associated to the coordinates of the node (with respect to the unit cell).</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if everything went well, FALSE otherwise. The box is stored in the nodeBox array.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="xcart" transfer-ownership="none">
            <doc xml:whitespace="preserve">the coordinates of a node.</doc>
            <array zero-terminated="0" c:type="float" fixed-size="3">
              <type name="gfloat" c:type="float"/>
            </array>
          </parameter>
          <parameter name="nodeBox" transfer-ownership="none">
            <doc xml:whitespace="preserve">the array to store the box of the node.</doc>
            <array zero-terminated="0" c:type="int" fixed-size="3">
              <type name="gint" c:type="int"/>
            </array>
          </parameter>
        </parameters>
      </method>
      <method name="getNodeBoxFromNumber"
              c:identifier="visu_data_getNodeBoxFromNumber">
        <doc xml:whitespace="preserve">This method retrieves the value of the box associated to a node (with respect to the unit cell).</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if everything went well, FALSE otherwise. The box is stored in the nodeBox array.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="nodeId" transfer-ownership="none">
            <doc xml:whitespace="preserve">the index of the node considered.</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
          <parameter name="nodeBox" transfer-ownership="none">
            <doc xml:whitespace="preserve">the array to store the box of the node.</doc>
            <array zero-terminated="0" c:type="int" fixed-size="3">
              <type name="gint" c:type="int"/>
            </array>
          </parameter>
        </parameters>
      </method>
      <method name="getNodeCoordinates"
              c:identifier="visu_data_getNodeCoordinates"
              version="3.6">
        <doc xml:whitespace="preserve">Wrapper for the function visu_data_getNodePosition() in case of call
from python.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="node" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuNode object ;</doc>
            <type name="Node" c:type="VisuNode*"/>
          </parameter>
          <parameter name="x"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none">
            <doc xml:whitespace="preserve">the x coordinate.</doc>
            <type name="gfloat" c:type="float*"/>
          </parameter>
          <parameter name="y"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none">
            <doc xml:whitespace="preserve">the y coordinate.</doc>
            <type name="gfloat" c:type="float*"/>
          </parameter>
          <parameter name="z"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none">
            <doc xml:whitespace="preserve">the z coordinate.</doc>
            <type name="gfloat" c:type="float*"/>
          </parameter>
        </parameters>
      </method>
      <method name="getNodeFromNumber"
              c:identifier="visu_data_getNodeFromNumber">
        <doc xml:whitespace="preserve">This methods retrieves the #VisuNode identified by the integer @number.
The number must be strictly positive. No eror is raised if no node corresponds
to the given number.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">the found #VisuNode or NULL if none corresponds to number.</doc>
          <type name="Node" c:type="VisuNode*"/>
        </return-value>
        <parameters>
          <parameter name="number" transfer-ownership="none">
            <doc xml:whitespace="preserve">an integer.</doc>
            <type name="guint" c:type="unsigned int"/>
          </parameter>
        </parameters>
      </method>
      <method name="getNodePosition"
              c:identifier="visu_data_getNodePosition"
              introspectable="0">
        <doc xml:whitespace="preserve">Position of nodes are subject to various translations and different transformations.
Their coordinates should not be access directly through node.[xyz]. This method
is used to retrieve the given node position.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="node" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuNode object ;</doc>
            <type name="Node" c:type="VisuNode*"/>
          </parameter>
          <parameter name="coord"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none">
            <doc xml:whitespace="preserve">an array of 3 floating point values to store the position.</doc>
            <array zero-terminated="0" c:type="float" fixed-size="3">
              <type name="gfloat" c:type="float"/>
            </array>
          </parameter>
        </parameters>
      </method>
      <method name="getNodeScalingFactor"
              c:identifier="visu_data_getNodeScalingFactor"
              version="3.5">
        <doc xml:whitespace="preserve">One can modify the size of a given node using a routine set by
visu_data_setNodeScalingFunc(). By default the scaling is 1.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">the scaling factor to be applied to node @node.</doc>
          <type name="gfloat" c:type="float"/>
        </return-value>
        <parameters>
          <parameter name="node" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuNode object.</doc>
            <type name="Node" c:type="VisuNode*"/>
          </parameter>
        </parameters>
      </method>
      <method name="getObjectList" c:identifier="visu_data_getObjectList">
        <doc xml:whitespace="preserve">All the drawned nodes are stored in an OpenGL list. The identifier of
this list can be access with the present method.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">an integer that identifies the OpenGL list of all drawn nodes.</doc>
          <type name="gint" c:type="int"/>
        </return-value>
      </method>
      <method name="getOpenGLView" c:identifier="visu_data_getOpenGLView">
        <doc xml:whitespace="preserve">Once the object @data has been initialised, an #VisuOpenGLView object
is automattically attached and this method can be used to retrieve
it.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">the #VisuOpenGLView attached to the given @data.</doc>
          <type name="OpenGLView" c:type="VisuOpenGLView*"/>
        </return-value>
      </method>
      <method name="getReducedNodePosition"
              c:identifier="visu_data_getReducedNodePosition"
              introspectable="0">
        <doc xml:whitespace="preserve">This function is equivalent to visu_data_getNodePosition() but
gives reduced coordinates instead.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="node" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuNode object ;</doc>
            <type name="Node" c:type="VisuNode*"/>
          </parameter>
          <parameter name="red"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none">
            <doc xml:whitespace="preserve">coordinates of the reduced node</doc>
            <array zero-terminated="0" c:type="float" fixed-size="3">
              <type name="gfloat" c:type="float"/>
            </array>
          </parameter>
        </parameters>
      </method>
      <method name="getTranslationStatus"
              c:identifier="visu_data_getTranslationStatus">
        <doc xml:whitespace="preserve">When a translation is applied (even with a [0,0,0] vector), the
nodes are shifted to be in the box. This routine returns the
translation status of all nodes. If one of them is translated, then
return value is TRUE.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">if one of the nodes is shifted.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
      </method>
      <method name="getUnit"
              c:identifier="visu_data_getUnit"
              version="3.5"
              introspectable="0">
        <doc xml:whitespace="preserve">The lengths of @data may be given in a certain unit using
visu_data_setUnit().</doc>
        <return-value>
          <doc xml:whitespace="preserve">the #ToolUnits of @data or #unit_undefined.</doc>
          <type c:type="ToolUnits"/>
        </return-value>
      </method>
      <method name="getUserColor"
              c:identifier="visu_data_getUserColor"
              version="3.6">
        <doc xml:whitespace="preserve">If a user defined color has been set (see
visu_data_setColorFunc()), then call this method to obtain a color
for the given node.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if a user color has been defined.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="ele" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuElement object ;</doc>
            <type name="Element" c:type="VisuElement*"/>
          </parameter>
          <parameter name="node" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuNode object ;</doc>
            <type name="Node" c:type="VisuNode*"/>
          </parameter>
          <parameter name="rgba" transfer-ownership="none">
            <doc xml:whitespace="preserve">a location to store the color.</doc>
            <array zero-terminated="0" c:type="float" fixed-size="4">
              <type name="gfloat" c:type="float"/>
            </array>
          </parameter>
        </parameters>
      </method>
      <method name="getXYZtranslation"
              c:identifier="visu_data_getXYZtranslation">
        <doc xml:whitespace="preserve">The nodes are rendered at thier coordinates plus a translation. This method
allows to retrieve that translation.

to free() after use.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">a newly allocated array of 3 floats. It should be freed with a call</doc>
          <array zero-terminated="0" c:type="float*" fixed-size="3">
            <type name="gfloat" c:type="float"/>
          </array>
        </return-value>
      </method>
      <method name="hasUserColorFunc"
              c:identifier="visu_data_hasUserColorFunc"
              version="3.6">
        <doc xml:whitespace="preserve">Test the existence of a user defined colourisation function.

visu_data_setColorFunc().</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if a user color function has been defined with</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
      </method>
      <method name="iterNew" c:identifier="visu_data_iterNew">
        <doc xml:whitespace="preserve">Set values to a #VisuDataIter object to iterate over nodes.
Its contain is initialised with the data size (number of elements,
number of nodes per element...).</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="iter"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="full">
            <doc xml:whitespace="preserve">an alocated iterator.</doc>
            <type name="DataIter" c:type="VisuDataIter*"/>
          </parameter>
        </parameters>
      </method>
      <method name="iterNext" c:identifier="visu_data_iterNext">
        <doc xml:whitespace="preserve">Modify node and element internal pointers to the next node, or NULL if
none remains.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="iter" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuDataIter object.</doc>
            <type name="DataIter" c:type="VisuDataIter*"/>
          </parameter>
        </parameters>
      </method>
      <method name="iterNextElement" c:identifier="visu_data_iterNextElement">
        <doc xml:whitespace="preserve">Modify element internal pointer to the next element and set node
to the first one, or NULL if none remains.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="iter" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuDataIter object.</doc>
            <type name="DataIter" c:type="VisuDataIter*"/>
          </parameter>
        </parameters>
      </method>
      <method name="iterNextNode" c:identifier="visu_data_iterNextNode">
        <doc xml:whitespace="preserve">Modify node internal pointer to the next node, or NULL if
none remains. Contrary to visu_data_iterNext() it does not go to the
next element if one exists.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="iter" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuDataIter object.</doc>
            <type name="DataIter" c:type="VisuDataIter*"/>
          </parameter>
        </parameters>
      </method>
      <method name="iterNextNodeNumber"
              c:identifier="visu_data_iterNextNodeNumber">
        <doc xml:whitespace="preserve">Modify node internal pointer to the next node, increasing the id of
the current node. The element internal pointer is also updated
accordingly. If no more nodes exist after the given one, node and
element internal pointers are set to NULL.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="iter" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuDataIter object.</doc>
            <type name="DataIter" c:type="VisuDataIter*"/>
          </parameter>
        </parameters>
      </method>
      <method name="iterNextNodeOriginal"
              c:identifier="visu_data_iterNextNodeOriginal"
              version="3.6">
        <doc xml:whitespace="preserve">Modify node internal pointer to the next original node, or NULL if
none remains. Contrary to visu_data_iterNext() it does not go to the
next element if one exists.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="iter" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuDataIter object.</doc>
            <type name="DataIter" c:type="VisuDataIter*"/>
          </parameter>
        </parameters>
      </method>
      <method name="iterNextVisible" c:identifier="visu_data_iterNextVisible">
        <doc xml:whitespace="preserve">Go to the next rendered node (changing element if required).</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="iter" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuDataIter object.</doc>
            <type name="DataIter" c:type="VisuDataIter*"/>
          </parameter>
        </parameters>
      </method>
      <method name="iterRestartNode" c:identifier="visu_data_iterRestartNode">
        <doc xml:whitespace="preserve">The element internal pointer must be associated. Then, it returns the
node pointer to the first node for this element.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="iter" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuDataIter object.</doc>
            <type name="DataIter" c:type="VisuDataIter*"/>
          </parameter>
        </parameters>
      </method>
      <method name="iterStart" c:identifier="visu_data_iterStart">
        <doc xml:whitespace="preserve">Initialise the node and element internal pointers for a run over the nodes.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="iter" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuDataIter object.</doc>
            <type name="DataIter" c:type="VisuDataIter*"/>
          </parameter>
        </parameters>
      </method>
      <method name="iterStartNumber" c:identifier="visu_data_iterStartNumber">
        <doc xml:whitespace="preserve">Initialise the node and element internal pointers for a run
following the node oder.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="iter" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuDataIter object.</doc>
            <type name="DataIter" c:type="VisuDataIter*"/>
          </parameter>
        </parameters>
      </method>
      <method name="iterStartVisible"
              c:identifier="visu_data_iterStartVisible">
        <doc xml:whitespace="preserve">Initialise the node and element internal pointers for a run over the 
visible nodes (see visu_data_iterNextVisible).</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="iter" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuDataIter object.</doc>
            <type name="DataIter" c:type="VisuDataIter*"/>
          </parameter>
        </parameters>
      </method>
      <method name="removeAllFiles" c:identifier="visu_data_removeAllFiles">
        <doc xml:whitespace="preserve">This method is used to empty the list of
known file from the given @data.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
      </method>
      <method name="removeNodes" c:identifier="visu_data_removeNodes">
        <doc xml:whitespace="preserve">Delete some nodes using this method. The nodes are identified by their
number and have not to be of the same element. This routine raises
the "NodePopulationDecrease" signal. The @nodeNumbers argument must
be terminated with a negative value.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="nodeNumbers" transfer-ownership="none">
            <doc xml:whitespace="preserve">an allocated int array with number identifying nodes.</doc>
            <array zero-terminated="0" c:type="int*">
              <type name="gint" c:type="int"/>
            </array>
          </parameter>
        </parameters>
      </method>
      <method name="removeTimeout" c:identifier="visu_data_removeTimeout">
        <doc xml:whitespace="preserve">This method is used to remove a timeout that has been associated to the given
@data (see visu_data_addTimeout()).</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if the source has been found and removed.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="timeoutId" transfer-ownership="none">
            <doc xml:whitespace="preserve">a source id.</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
        </parameters>
      </method>
      <method name="reorder" c:identifier="visu_data_reorder" version="3.6">
        <doc xml:whitespace="preserve">This routine modifies the node ordering of @data using the order in
@dataRef. The association is done by nearest neigbours conditions.


@data correspond to one of @dataRef).</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE is the reordering is successfull (i.e. all nodes of</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="dataRef" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuData object, to take the order from.</doc>
            <type name="Data" c:type="VisuData*"/>
          </parameter>
        </parameters>
      </method>
      <method name="replicate" c:identifier="visu_data_replicate">
        <doc xml:whitespace="preserve">This routine will create (or remove) nodes to expand the initial box to
the required size. An extension of 0 means no extension, i.e. the initial
box. The extension is done symmetrically in each direction toward negative
and positive direction.

If the @rebuild argument is TRUE, the nodes should be rebuilt (with
visu_data_createAllNodes()).

To remove added nodes, see visu_data_restore().</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if the redraw should be done.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="extension" transfer-ownership="none">
            <doc xml:whitespace="preserve">three floating point values ;</doc>
            <array zero-terminated="0" c:type="float" fixed-size="3">
              <type name="gfloat" c:type="float"/>
            </array>
          </parameter>
          <parameter name="rebuild" transfer-ownership="none">
            <doc xml:whitespace="preserve">a location to store a flag.</doc>
            <type name="gboolean" c:type="gboolean*"/>
          </parameter>
        </parameters>
      </method>
      <method name="restore" c:identifier="visu_data_restore">
        <doc xml:whitespace="preserve">Remove all nodes that have been added by a visu_data_replicate()
call.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if some nodes has been indeed removed.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
      </method>
      <method name="setAngleOfView" c:identifier="visu_data_setAngleOfView">
        <doc xml:whitespace="preserve">This method is used to change the camera orientation for the given @data.
If necessary, this method will emit the 'OpenGLThetaPhiOmega' signal.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">1 if the 'OpenGLAskForReDraw' signal should be emitted.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="valueTheta" transfer-ownership="none">
            <doc xml:whitespace="preserve">a floatinf point value in degrees ;</doc>
            <type name="gfloat" c:type="float"/>
          </parameter>
          <parameter name="valuePhi" transfer-ownership="none">
            <doc xml:whitespace="preserve">a floating point value in degrees ;</doc>
            <type name="gfloat" c:type="float"/>
          </parameter>
          <parameter name="valueOmega" transfer-ownership="none">
            <doc xml:whitespace="preserve">a floating point value in degrees ;</doc>
            <type name="gfloat" c:type="float"/>
          </parameter>
          <parameter name="mask" transfer-ownership="none">
            <doc xml:whitespace="preserve">to specified what values will be changed.</doc>
            <type name="gint" c:type="int"/>
          </parameter>
        </parameters>
      </method>
      <method name="setBoxGeometry" c:identifier="visu_data_setBoxGeometry">
        <doc xml:whitespace="preserve">This methods set the size of the box. The boundary conditions can
be specified thanks to @bc.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="geometry" transfer-ownership="none">
            <doc xml:whitespace="preserve">a 6 floating point array ;</doc>
            <array zero-terminated="0" c:type="double" fixed-size="6">
              <type name="gdouble" c:type="double"/>
            </array>
          </parameter>
          <parameter name="bc" transfer-ownership="none">
            <doc xml:whitespace="preserve">define the boundary conditions.</doc>
            <type name="DataBoxBoundaries" c:type="VisuDataBoxBoundaries"/>
          </parameter>
        </parameters>
      </method>
      <method name="setBoxGeometryFull"
              c:identifier="visu_data_setBoxGeometryFull"
              version="3.6">
        <doc xml:whitespace="preserve">This methods set the size of the box. The boundary conditions can
be specified thanks to @bc. The basis set will be rotated by V_Sim
to align the given first axis with X, and put the second axis in
the XY plane. Further inclusion of nodes with visu_data_addNodeFromElement()
and friends will automatically apply the rotation if coordinates are
given in cartesian. This rotation will stop after any call to
visu_data_applyBoxGeometry().</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">FALSE if the given box is planar.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="geometry" transfer-ownership="none">
            <doc xml:whitespace="preserve">a 9 floating point array ;</doc>
            <array zero-terminated="0" c:type="double" fixed-size="9">
              <type name="gdouble" c:type="double"/>
            </array>
          </parameter>
          <parameter name="bc" transfer-ownership="none">
            <doc xml:whitespace="preserve">define the boundary conditions.</doc>
            <type name="DataBoxBoundaries" c:type="VisuDataBoxBoundaries"/>
          </parameter>
        </parameters>
      </method>
      <method name="setChangeElementFlag"
              c:identifier="visu_data_setChangeElementFlag">
        <doc xml:whitespace="preserve">This method is mainly used by internal gears to set a flag. This flag control
if the @data object has the same #VisuElement objects than the previously rendered one.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="changeElement" transfer-ownership="none">
            <doc xml:whitespace="preserve">a boolean.</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="setColorFunc" c:identifier="visu_data_setColorFunc">
        <doc xml:whitespace="preserve">This is a little trick to colorized the nodes. It should not be used since it
will probably be different in future release.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="func" transfer-ownership="none" scope="call">
            <doc xml:whitespace="preserve">a method that colorize the nodes.</doc>
            <type name="DataColorFunc" c:type="VisuDataColorFunc"/>
          </parameter>
        </parameters>
      </method>
      <method name="setFileCommentary"
              c:identifier="visu_data_setFileCommentary">
        <doc xml:whitespace="preserve">This method is used to store a description of the given @data. This
string is copied and @commentary can be freed. Before using this
method, the number of possible node sets must have been defined
using visu_data_setNSubset(), if not, only iSet == 0 is allowed.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="commentary" transfer-ownership="none">
            <doc xml:whitespace="preserve">the message to be stored (null terminated) ;</doc>
            <type name="utf8" c:type="gchar*"/>
          </parameter>
          <parameter name="iSet" transfer-ownership="none">
            <doc xml:whitespace="preserve">an integer.</doc>
            <type name="gint" c:type="gint"/>
          </parameter>
        </parameters>
      </method>
      <method name="setISubset" c:identifier="visu_data_setISubset">
        <doc xml:whitespace="preserve">Change the current id of the set of data (ordered as in C,
beginning at 0).</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="iSet" transfer-ownership="none">
            <doc xml:whitespace="preserve">an integer.</doc>
            <type name="gint" c:type="int"/>
          </parameter>
        </parameters>
      </method>
      <method name="setNSubset" c:identifier="visu_data_setNSubset">
        <doc xml:whitespace="preserve">Change the number of available sets of nodes for this
#VisuData. This has a side effect to delete all previously saved
file commentaries (see visu_data_setFileCommentary()).</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="nSet" transfer-ownership="none">
            <doc xml:whitespace="preserve">an integer.</doc>
            <type name="gint" c:type="int"/>
          </parameter>
        </parameters>
      </method>
      <method name="setNewBasis"
              c:identifier="visu_data_setNewBasis"
              version="3.6">
        <doc xml:whitespace="preserve">Change the basis set of @data according to the new definition given
by @matA and @O. Nodes outside the new box are killed. See also
visu_data_setNewBasisFromNodes() for a convenient function using
nodes as basis set definition.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if the new basis set is valid.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="matA" transfer-ownership="none">
            <doc xml:whitespace="preserve">a basis set definition.</doc>
            <type name="gfloat" c:type="float"/>
          </parameter>
          <parameter name="O" transfer-ownership="none">
            <doc xml:whitespace="preserve">the origin cartesian coordinates.</doc>
            <type name="gfloat" c:type="float"/>
          </parameter>
        </parameters>
      </method>
      <method name="setNewBasisFromNodes"
              c:identifier="visu_data_setNewBasisFromNodes"
              version="3.6">
        <doc xml:whitespace="preserve">Change the basis set by providing the new basis set from a list of
nodes. See also visu_data_setNewBasis(). Nodes outside the new box
are killed.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if the new basis set is valid.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="nO" transfer-ownership="none">
            <doc xml:whitespace="preserve">the index of node as origin.</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
          <parameter name="nA" transfer-ownership="none">
            <doc xml:whitespace="preserve">the index of node on X axis.</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
          <parameter name="nB" transfer-ownership="none">
            <doc xml:whitespace="preserve">the index of node as Y axis.</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
          <parameter name="nC" transfer-ownership="none">
            <doc xml:whitespace="preserve">the index of node as Z axis.</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
        </parameters>
      </method>
      <method name="setNodeScalingFunc"
              c:identifier="visu_data_setNodeScalingFunc"
              version="3.5">
        <doc xml:whitespace="preserve">Change the scaling routine when nodes are drawn.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="scaling" transfer-ownership="none" scope="call">
            <doc xml:whitespace="preserve">a scaling routine.</doc>
            <type name="DataScalingFunc" c:type="VisuDataScalingFunc"/>
          </parameter>
        </parameters>
      </method>
      <method name="setPerspectiveOfView"
              c:identifier="visu_data_setPerspectiveOfView">
        <doc xml:whitespace="preserve">This method is used to change the camera perspective for the given @data.
If necessary, this method will emit the 'OpenGLPersp' signal and
the 'OpenGLFacetteChanged' signal.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">1 if the 'OpenGLAskForReDraw' signal should be emitted.</doc>
          <type name="gint" c:type="int"/>
        </return-value>
        <parameters>
          <parameter name="value" transfer-ownership="none">
            <doc xml:whitespace="preserve">a positive floating point value (&gt; 1.1).</doc>
            <type name="gfloat" c:type="float"/>
          </parameter>
        </parameters>
      </method>
      <method name="setPopulation"
              c:identifier="visu_data_setPopulation"
              introspectable="0">
        <doc xml:whitespace="preserve">Allocate the storage arrays for @data, with @nbOfTypes #VisuElement
and corresponding numbers of nodes from @nbOfNodesPerVisuElement.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">1 on success.</doc>
          <type name="gint" c:type="int"/>
        </return-value>
        <parameters>
          <parameter name="nbOfTypes" transfer-ownership="none">
            <doc xml:whitespace="preserve">number of #VisuElement to defined.</doc>
            <type name="guint" c:type="unsigned int"/>
          </parameter>
          <parameter name="nbOfNodesPerVisuElement" transfer-ownership="none">
            <doc xml:whitespace="preserve">an array with the number of nodes per #VisuElement.</doc>
            <type name="guint" c:type="unsigned int*"/>
          </parameter>
          <parameter name="visu_element_Used" transfer-ownership="none">
            <doc xml:whitespace="preserve">an array of the actual #VisuElement.</doc>
            <type name="Element" c:type="VisuElement**"/>
          </parameter>
        </parameters>
      </method>
      <method name="setPositionOfView"
              c:identifier="visu_data_setPositionOfView">
        <doc xml:whitespace="preserve">This method is used to change the camera position for the given @data.
If necessary, this method will emit the 'OpenGLXsYs' signal.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">1 if the 'OpenGLAskForReDraw' signal should be emitted.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="valueX" transfer-ownership="none">
            <doc xml:whitespace="preserve">a floatinf point value in the bounding box scale (1 is the size of the bounding box) ;</doc>
            <type name="gfloat" c:type="float"/>
          </parameter>
          <parameter name="valueY" transfer-ownership="none">
            <doc xml:whitespace="preserve">a floating point value in bounding box scale ;</doc>
            <type name="gfloat" c:type="float"/>
          </parameter>
          <parameter name="mask" transfer-ownership="none">
            <doc xml:whitespace="preserve">to specified what values will be changed.</doc>
            <type name="gint" c:type="int"/>
          </parameter>
        </parameters>
      </method>
      <method name="setSizeOfView" c:identifier="visu_data_setSizeOfView">
        <doc xml:whitespace="preserve">It changes the size of the OpenGl area and reccompute the OpenGL viewport.
Warning : it doesn't change the size of the window.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">1 if the 'OpenGLAskForReDraw' signal should be emitted.</doc>
          <type name="gint" c:type="int"/>
        </return-value>
        <parameters>
          <parameter name="width" transfer-ownership="none">
            <doc xml:whitespace="preserve">the new horizontal size ;</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
          <parameter name="height" transfer-ownership="none">
            <doc xml:whitespace="preserve">the new vertical size.</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
        </parameters>
      </method>
      <method name="setTightBox" c:identifier="visu_data_setTightBox">
        <doc xml:whitespace="preserve">Calculate the box geometry to have a tight box in directions that
are not periodic. If some directions are still periodic, the box
size in these directions should be setup first with
visu_data_setBoxGeometry().</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
      </method>
      <method name="setUnit"
              c:identifier="visu_data_setUnit"
              version="3.5"
              introspectable="0">
        <doc xml:whitespace="preserve">The lengths of @data may be given in a certain unit by calling this
routine. If the unit is different from the previously defined, the
coordinate are scaled accordingly.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if the unit has been changed.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="unit" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #ToolUnits flag.</doc>
            <type c:type="ToolUnits"/>
          </parameter>
        </parameters>
      </method>
      <method name="setXYZtranslation"
              c:identifier="visu_data_setXYZtranslation">
        <doc xml:whitespace="preserve">This set the translations of the specified #VisuData whatever previous values.
The translation is done in the orthonormal referential, not the referential of
the box.

the 'NodePositionChanged' should be emitted.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">if returns TRUE, visu_data_createAllNodes() should be called and</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="xyz" transfer-ownership="none">
            <doc xml:whitespace="preserve">an array of floating point values.</doc>
            <array zero-terminated="0" c:type="float" fixed-size="3">
              <type name="gfloat" c:type="float"/>
            </array>
          </parameter>
        </parameters>
      </method>
      <method name="setZoomOfView" c:identifier="visu_data_setZoomOfView">
        <doc xml:whitespace="preserve">This method is used to change the camera zoom for the given @data.
If necessary, this method will emit the 'OpenGLGross' signal and
the 'OpenGLFacetteChanged' signal.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">1 if the 'OpenGLAskForReDraw' signal should be emitted.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="value" transfer-ownership="none">
            <doc xml:whitespace="preserve">a positive floating point value.</doc>
            <type name="gfloat" c:type="float"/>
          </parameter>
        </parameters>
      </method>
      <property name="totalEnergy"
                writable="1"
                construct="1"
                transfer-ownership="none">
        <type name="gdouble"/>
      </property>
      <glib:signal name="BoxSizeChanged"
                   when="last"
                   no-recurse="1"
                   no-hooks="1"
                   version="3.4">
        <doc xml:whitespace="preserve">Gets emitted when the box size is changed (because of box
duplication for instance).</doc>
        <return-value transfer-ownership="none">
          <type name="none"/>
        </return-value>
      </glib:signal>
      <glib:signal name="NodeAskForShowHide"
                   when="last"
                   no-recurse="1"
                   no-hooks="1"
                   version="3.2">
        <doc xml:whitespace="preserve">Gets emitted when external modules should recompute their masking
effect on nodes. Location pointed by @redraw must be set to TRUE
if the visibility of at least one node is changed.</doc>
        <return-value transfer-ownership="none">
          <type name="none"/>
        </return-value>
        <parameters>
          <parameter name="redraw" transfer-ownership="none">
            <doc xml:whitespace="preserve">a location on a boolean.</doc>
            <type name="gpointer"/>
          </parameter>
        </parameters>
      </glib:signal>
      <glib:signal name="NodeMaterialChanged"
                   when="last"
                   no-recurse="1"
                   no-hooks="1"
                   version="3.6">
        <doc xml:whitespace="preserve">Gets emitted when one or more nodes have changed of
color or material.</doc>
        <return-value transfer-ownership="none">
          <type name="none"/>
        </return-value>
      </glib:signal>
      <glib:signal name="NodePopulationDecrease"
                   when="last"
                   no-recurse="1"
                   no-hooks="1"
                   version="3.4">
        <doc xml:whitespace="preserve">Gets emitted when the number of nodes has changed,
decreasing. @ids contains all removed ids and is -1 terminated.
When emitted, nodes have already been removed, so no external
routines should keep pointers on these nodes.</doc>
        <return-value transfer-ownership="none">
          <type name="none"/>
        </return-value>
        <parameters>
          <parameter name="ids" transfer-ownership="none">
            <doc xml:whitespace="preserve">an array of #VisuNode ids.</doc>
            <type name="gpointer"/>
          </parameter>
        </parameters>
      </glib:signal>
      <glib:signal name="NodePopulationDefined"
                   when="last"
                   no-recurse="1"
                   no-hooks="1"
                   version="3.5">
        <doc xml:whitespace="preserve">Gets emitted when the population of nodes is created or
destroyed. It is possible then to associate new #VisuNodeProperty
for instance.</doc>
        <return-value transfer-ownership="none">
          <type name="none"/>
        </return-value>
        <parameters>
          <parameter name="nodes" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuNodeArray object or NULL.</doc>
            <type name="gpointer"/>
          </parameter>
        </parameters>
      </glib:signal>
      <glib:signal name="NodePopulationIncrease"
                   when="last"
                   no-recurse="1"
                   no-hooks="1"
                   version="3.4">
        <doc xml:whitespace="preserve">Gets emitted when the number of nodes has changed,
increasing. @ids contains all new ids and is -1 terminated.</doc>
        <return-value transfer-ownership="none">
          <type name="none"/>
        </return-value>
        <parameters>
          <parameter name="ids" transfer-ownership="none">
            <doc xml:whitespace="preserve">an array of #VisuNode ids.</doc>
            <type name="gpointer"/>
          </parameter>
        </parameters>
      </glib:signal>
      <glib:signal name="NodePositionChanged"
                   when="last"
                   no-recurse="1"
                   no-hooks="1"
                   version="3.2">
        <doc xml:whitespace="preserve">Gets emitted when one or more nodes have moved, because of
translations or because the user has moved them manually.</doc>
        <return-value transfer-ownership="none">
          <type name="none"/>
        </return-value>
      </glib:signal>
      <glib:signal name="NodeRenderedChanged"
                   when="last"
                   no-recurse="1"
                   no-hooks="1"
                   version="3.2">
        <doc xml:whitespace="preserve">Gets emitted when one or more nodes have changed of
visibility. Some may have appeared, some may have disappeared.</doc>
        <return-value transfer-ownership="none">
          <type name="none"/>
        </return-value>
      </glib:signal>
      <glib:signal name="OpenGLFacetteChanged"
                   when="last"
                   no-recurse="1"
                   no-hooks="1"
                   version="3.2">
        <doc xml:whitespace="preserve">Gets emitted when precision of the drawn object has been changed.</doc>
        <return-value transfer-ownership="none">
          <type name="none"/>
        </return-value>
      </glib:signal>
      <glib:signal name="OpenGLGross"
                   when="last"
                   no-recurse="1"
                   no-hooks="1"
                   version="3.2">
        <doc xml:whitespace="preserve">Gets emitted when the camera zoom factor has been changed.</doc>
        <return-value transfer-ownership="none">
          <type name="none"/>
        </return-value>
        <parameters>
          <parameter name="view" transfer-ownership="none">
            <doc xml:whitespace="preserve">the new #VisuOpenGLView.</doc>
            <type name="gpointer"/>
          </parameter>
        </parameters>
      </glib:signal>
      <glib:signal name="OpenGLNearFar"
                   when="last"
                   no-recurse="1"
                   no-hooks="1"
                   version="3.2">
        <doc xml:whitespace="preserve">Gets emitted when the viewing field has been changed.</doc>
        <return-value transfer-ownership="none">
          <type name="none"/>
        </return-value>
        <parameters>
          <parameter name="view" transfer-ownership="none">
            <doc xml:whitespace="preserve">the new #VisuOpenGLView.</doc>
            <type name="gpointer"/>
          </parameter>
        </parameters>
      </glib:signal>
      <glib:signal name="OpenGLPersp"
                   when="last"
                   no-recurse="1"
                   no-hooks="1"
                   version="3.2">
        <doc xml:whitespace="preserve">Gets emitted when the camera perspective factor has been changed.</doc>
        <return-value transfer-ownership="none">
          <type name="none"/>
        </return-value>
        <parameters>
          <parameter name="view" transfer-ownership="none">
            <doc xml:whitespace="preserve">the new #VisuOpenGLView.</doc>
            <type name="gpointer"/>
          </parameter>
        </parameters>
      </glib:signal>
      <glib:signal name="OpenGLThetaPhiOmega"
                   when="last"
                   no-recurse="1"
                   no-hooks="1"
                   version="3.2">
        <doc xml:whitespace="preserve">Gets emitted when the camera angles have been changed.</doc>
        <return-value transfer-ownership="none">
          <type name="none"/>
        </return-value>
        <parameters>
          <parameter name="view" transfer-ownership="none">
            <doc xml:whitespace="preserve">the new #VisuOpenGLView.</doc>
            <type name="gpointer"/>
          </parameter>
        </parameters>
      </glib:signal>
      <glib:signal name="OpenGLWidthHeight"
                   when="last"
                   no-recurse="1"
                   no-hooks="1"
                   version="3.2">
        <doc xml:whitespace="preserve">Gets emitted when the viewing frame has been changed.</doc>
        <return-value transfer-ownership="none">
          <type name="none"/>
        </return-value>
        <parameters>
          <parameter name="view" transfer-ownership="none">
            <doc xml:whitespace="preserve">the new #VisuOpenGLView.</doc>
            <type name="gpointer"/>
          </parameter>
        </parameters>
      </glib:signal>
      <glib:signal name="OpenGLXsYs"
                   when="last"
                   no-recurse="1"
                   no-hooks="1"
                   version="3.2">
        <doc xml:whitespace="preserve">Gets emitted when the camera position has been changed.</doc>
        <return-value transfer-ownership="none">
          <type name="none"/>
        </return-value>
        <parameters>
          <parameter name="view" transfer-ownership="none">
            <doc xml:whitespace="preserve">the new #VisuOpenGLView.</doc>
            <type name="gpointer"/>
          </parameter>
        </parameters>
      </glib:signal>
      <glib:signal name="UnitChanged"
                   when="last"
                   no-recurse="1"
                   no-hooks="1"
                   version="3.6">
        <doc xml:whitespace="preserve">Gets emitted when the units are changed.</doc>
        <return-value transfer-ownership="none">
          <type name="none"/>
        </return-value>
        <parameters>
          <parameter name="factor" transfer-ownership="none">
            <doc xml:whitespace="preserve">the factor that has been applied.</doc>
            <type name="gfloat"/>
          </parameter>
        </parameters>
      </glib:signal>
      <glib:signal name="objectFreed"
                   when="last"
                   no-recurse="1"
                   no-hooks="1"
                   version="3.3">
        <doc xml:whitespace="preserve">Gets emitted when the object is been destroyed. All external
objects having a reference on this #VisuData should clean it.</doc>
        <return-value transfer-ownership="none">
          <type name="none"/>
        </return-value>
      </glib:signal>
    </class>
    <enumeration name="DataBoxBoundaries" c:type="VisuDataBoxBoundaries">
      <doc xml:whitespace="preserve">This describes the periodicity of the bounding box in the three directions.</doc>
      <member name="periodic" value="0" c:identifier="VISU_DATA_BOX_PERIODIC"/>
      <member name="surface_xy"
              value="1"
              c:identifier="VISU_DATA_BOX_SURFACE_XY"/>
      <member name="surface_yz"
              value="2"
              c:identifier="VISU_DATA_BOX_SURFACE_YZ"/>
      <member name="surface_zx"
              value="3"
              c:identifier="VISU_DATA_BOX_SURFACE_ZX"/>
      <member name="free" value="4" c:identifier="VISU_DATA_BOX_FREE"/>
    </enumeration>
    <record name="DataClass"
            c:type="VisuDataClass"
            disguised="1"
            glib:is-gtype-struct-for="Data">
      <doc xml:whitespace="preserve">A short way to identify #_VisuDataClass structure.</doc>
    </record>
    <callback name="DataColorFunc" c:type="VisuDataColorFunc">
      <doc xml:whitespace="preserve">This prototype is used to specify an optional method
to associate a color with external values to each node.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="visuData" transfer-ownership="none">
          <doc xml:whitespace="preserve">a pointer to the calling object ;</doc>
          <type name="Data" c:type="VisuData*"/>
        </parameter>
        <parameter name="rgba" transfer-ownership="none">
          <doc xml:whitespace="preserve">an 4 allocated float area to store the return values.</doc>
          <array zero-terminated="0" c:type="float" fixed-size="4">
            <type name="gfloat" c:type="float"/>
          </array>
        </parameter>
        <parameter name="ele" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuElement ;</doc>
          <type name="Element" c:type="VisuElement*"/>
        </parameter>
        <parameter name="node" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuNode ;</doc>
          <type name="Node" c:type="VisuNode*"/>
        </parameter>
      </parameters>
    </callback>
    <record name="DataIter" c:type="VisuDataIter">
      <doc xml:whitespace="preserve">This structure is an iterator over the nodes of a #VisuData object.
Create it with visu_data_iterNew(). Then the numbers are allocated and
correspond to the value of the #VisuData object. Use visu_data_iterStart()
to initialise the iterator for a run over the nodes, visu_data_iterNext()
to associate @node and @element to the next node, or NULL if there is no
more node to run over.</doc>
      <field name="data" writable="1">
        <type name="Data" c:type="VisuData*"/>
      </field>
      <field name="idMax" writable="1">
        <type name="guint" c:type="guint"/>
      </field>
      <field name="nAllStoredNodes" writable="1">
        <type name="guint" c:type="guint"/>
      </field>
      <field name="nElements" writable="1">
        <type name="guint" c:type="guint"/>
      </field>
      <field name="nStoredNodes" writable="1">
        <type name="guint" c:type="guint*"/>
      </field>
      <field name="iElement" writable="1">
        <type name="guint" c:type="guint"/>
      </field>
      <field name="node" writable="1">
        <type name="Node" c:type="VisuNode*"/>
      </field>
      <field name="element" writable="1">
        <type name="Element" c:type="VisuElement*"/>
      </field>
      <field name="type" writable="1">
        <type name="DataIterType" c:type="VisuDataIterType"/>
      </field>
      <field name="init" writable="1">
        <type name="gboolean" c:type="gboolean"/>
      </field>
      <method name="next" c:identifier="visu_data_iter_next" version="3.6">
        <doc xml:whitespace="preserve">Run the iterator to go to next item.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if any item is found, FALSE otherwise.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
      </method>
      <method name="next2" c:identifier="visu_data_iter_next2" version="3.6">
        <doc xml:whitespace="preserve">Iterator to run on a pair of different nodes.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if any item is found, FALSE otherwise.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="iter2" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuDataIter object.</doc>
            <type name="DataIter" c:type="VisuDataIter*"/>
          </parameter>
        </parameters>
      </method>
    </record>
    <enumeration name="DataIterType" version="3.6" c:type="VisuDataIterType">
      <doc xml:whitespace="preserve">The kind of iterator to be used on #VisuData objects.</doc>
      <member name="nodes_by_type"
              value="0"
              c:identifier="ITER_NODES_BY_TYPE"/>
      <member name="nodes_by_number"
              value="1"
              c:identifier="ITER_NODES_BY_NUMBER"/>
      <member name="nodes_visible"
              value="2"
              c:identifier="ITER_NODES_VISIBLE"/>
      <member name="nodes_original"
              value="3"
              c:identifier="ITER_NODES_ORIGINAL"/>
      <member name="elements" value="4" c:identifier="ITER_ELEMENTS"/>
    </enumeration>
    <class name="DataNode"
           c:symbol-prefix="data_node"
           c:type="VisuDataNode"
           parent="GObject.Object"
           glib:type-name="VisuDataNode"
           glib:get-type="visu_data_node_get_type"
           glib:type-struct="DataNodeClass">
      <doc xml:whitespace="preserve">An opaque structure.</doc>
      <constructor name="new" c:identifier="visu_data_node_new">
        <doc xml:whitespace="preserve">This method creates a new #VisuDataNode and registers it. A #VisuDataNode is
characterised by a string used as a key to store it as a node property
(see visu_node_property_newPointer()). The stored data can be arrays or not.
Notice that @name is copied.</doc>
        <return-value transfer-ownership="full">
          <doc xml:whitespace="preserve">a newly created #VisuDataNode.</doc>
          <type name="GObject.Object" c:type="GObject*"/>
        </return-value>
        <parameters>
          <parameter name="name" transfer-ownership="none">
            <doc xml:whitespace="preserve">a string used to store the data as a node property ;</doc>
            <type name="utf8" c:type="gchar*"/>
          </parameter>
          <parameter name="type" transfer-ownership="none">
            <doc xml:whitespace="preserve">the type of data stored (array or not).</doc>
            <type name="GType" c:type="GType"/>
          </parameter>
        </parameters>
      </constructor>
      <function name="newWithCallbacks"
                c:identifier="visu_data_node_newWithCallbacks">
        <doc xml:whitespace="preserve">As visu_data_node_new(), but with custom @setAsString and @getAsString routines. This
is used to allow to treat every node related values, not just node properties.</doc>
        <return-value transfer-ownership="full">
          <doc xml:whitespace="preserve">a newly created #VisuDataNode.</doc>
          <type name="GObject.Object" c:type="GObject*"/>
        </return-value>
        <parameters>
          <parameter name="name" transfer-ownership="none">
            <doc xml:whitespace="preserve">a string used to store the data as a node property ;</doc>
            <type name="utf8" c:type="gchar*"/>
          </parameter>
          <parameter name="setAsString" transfer-ownership="none" scope="call">
            <doc xml:whitespace="preserve">a custom routine to change node values from a string ;</doc>
            <type name="DataNodeFromStringFunc"
                  c:type="VisuDataNodeFromStringFunc"/>
          </parameter>
          <parameter name="getAsString" transfer-ownership="none" scope="call">
            <doc xml:whitespace="preserve">a custom routine to create a string from node values.</doc>
            <type name="DataNodeToStringFunc"
                  c:type="VisuDataNodeToStringFunc"/>
          </parameter>
        </parameters>
      </function>
      <method name="emitValueChanged"
              c:identifier="visu_data_node_emitValueChanged">
        <doc xml:whitespace="preserve">Emit the 'valueChanged' signal. This method should be called after
all changes have been done to a node property set of nodes. Then routines
using this property can update itself.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="dataObj" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuData object.</doc>
            <type name="Data" c:type="VisuData*"/>
          </parameter>
        </parameters>
      </method>
      <method name="getEditable" c:identifier="visu_data_node_getEditable">
        <doc xml:whitespace="preserve">If some callback method has been given with visu_data_node_setCallback(), then
the values are considered editable.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if values are editable.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
      </method>
      <method name="getLabel" c:identifier="visu_data_node_getLabel">
        <doc xml:whitespace="preserve">A #VisuDataNode can have a label, if not its name is used.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">the label of the node (in UTF8), this string is owned by V_Sim.</doc>
          <type name="utf8" c:type="gchar*"/>
        </return-value>
      </method>
      <method name="getUsed" c:identifier="visu_data_node_getUsed">
        <doc xml:whitespace="preserve">Access method to know if the given @dataObj has a public node property of the type
@data.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if @dataObj has a node property of the given type.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="dataObj" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuData object.</doc>
            <type name="Data" c:type="VisuData*"/>
          </parameter>
        </parameters>
      </method>
      <method name="getValueAsString"
              c:identifier="visu_data_node_getValueAsString">
        <doc xml:whitespace="preserve">For the given node, the values stored are printed into a string.</doc>
        <return-value transfer-ownership="full">
          <doc xml:whitespace="preserve">a newly created string.</doc>
          <type name="utf8" c:type="gchar*"/>
        </return-value>
        <parameters>
          <parameter name="dataObj" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuData object ;</doc>
            <type name="Data" c:type="VisuData*"/>
          </parameter>
          <parameter name="node" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuNode.</doc>
            <type name="Node" c:type="VisuNode*"/>
          </parameter>
        </parameters>
      </method>
      <method name="setCallback" c:identifier="visu_data_node_setCallback">
        <doc xml:whitespace="preserve">When visu_data_node_setValueAsString(), values may be modified. If true, the given
callback method is called with @user_data as argument.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="callback"
                     transfer-ownership="none"
                     scope="call"
                     closure="1">
            <doc xml:whitespace="preserve">a #VisuDataNodeCallbackMethod method ;</doc>
            <type name="DataNodeCallbackMethod"
                  c:type="VisuDataNodeCallbackMethod"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:whitespace="preserve">a pointer to a location used to store some user data.</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="setEditable" c:identifier="visu_data_node_setEditable">
        <doc xml:whitespace="preserve">Set if the values are modifiable.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="status" transfer-ownership="none">
            <doc xml:whitespace="preserve">a boolean value.</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="setLabel" c:identifier="visu_data_node_setLabel">
        <doc xml:whitespace="preserve">A #VisuDataNode can have a label, if not its name is used.
Notice that @label is not copied.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="label" transfer-ownership="none">
            <doc xml:whitespace="preserve">an UTF8 string (may be translated).</doc>
            <type name="utf8" c:type="gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="setUsed" c:identifier="visu_data_node_setUsed">
        <doc xml:whitespace="preserve">A #VisuDataNode stores data for each node of a given #VisuData. The number of data stored for
each node is set with this method. When some part wants to set a new node property
and wants to make it public, this method can be called. It also can be called when
the node property is removed (using a null @nb argument).
If @nb is changed for a positive value, the "propertyUsed"
signal is emitted with @dataObj as argument, instead if the value is changed
for null, the "propertyUnused" signal is triggered also with @dataObj as argument.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="dataObj" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuData object ;</doc>
            <type name="Data" c:type="VisuData*"/>
          </parameter>
          <parameter name="nb" transfer-ownership="none">
            <doc xml:whitespace="preserve">a positive or null integer.</doc>
            <type name="gint" c:type="gint"/>
          </parameter>
        </parameters>
      </method>
      <method name="setValueAsString"
              c:identifier="visu_data_node_setValueAsString">
        <doc xml:whitespace="preserve">If the string is correctly formatted (that means it has the same format as
the string returned by visu_data_node_getValueAsString()) the stored values are modified.
The resulting string is created and put into @labelOut. If the input string @labelIn
is unparsable, @labelOut will contain current values. Notice that this method is
callable only if the @data is editable (see visu_data_node_getEditable()).</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if the string was correctly parsed.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="dataObj" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuData object ;</doc>
            <type name="Data" c:type="VisuData*"/>
          </parameter>
          <parameter name="node" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuNode ;</doc>
            <type name="Node" c:type="VisuNode*"/>
          </parameter>
          <parameter name="labelIn" transfer-ownership="none">
            <doc xml:whitespace="preserve">a formatted string ;</doc>
            <type name="utf8" c:type="gchar*"/>
          </parameter>
          <parameter name="labelOut" transfer-ownership="none">
            <doc xml:whitespace="preserve">a pointer to store a string.</doc>
            <type name="utf8" c:type="gchar**"/>
          </parameter>
        </parameters>
      </method>
      <glib:signal name="propertyUnused"
                   when="last"
                   no-recurse="1"
                   no-hooks="1"
                   version="3.3">
        <doc xml:whitespace="preserve">The given property @data gets unused by @dataObj.</doc>
        <return-value transfer-ownership="none">
          <type name="none"/>
        </return-value>
        <parameters>
          <parameter name="dataObj" transfer-ownership="none">
            <doc xml:whitespace="preserve">the #VisuData its working on.</doc>
            <type name="GObject.Object"/>
          </parameter>
        </parameters>
      </glib:signal>
      <glib:signal name="propertyUsed"
                   when="last"
                   no-recurse="1"
                   no-hooks="1"
                   version="3.3">
        <doc xml:whitespace="preserve">The given property @data gets used by @dataObj.</doc>
        <return-value transfer-ownership="none">
          <type name="none"/>
        </return-value>
        <parameters>
          <parameter name="dataObj" transfer-ownership="none">
            <doc xml:whitespace="preserve">the #VisuData its working on.</doc>
            <type name="GObject.Object"/>
          </parameter>
        </parameters>
      </glib:signal>
      <glib:signal name="valueChanged"
                   when="last"
                   no-recurse="1"
                   no-hooks="1"
                   version="3.3">
        <doc xml:whitespace="preserve">The given property @data used by @dataObj has its value changed.</doc>
        <return-value transfer-ownership="none">
          <type name="none"/>
        </return-value>
        <parameters>
          <parameter name="dataObj" transfer-ownership="none">
            <doc xml:whitespace="preserve">the #VisuData its working on.</doc>
            <type name="GObject.Object"/>
          </parameter>
        </parameters>
      </glib:signal>
    </class>
    <callback name="DataNodeCallbackMethod"
              c:type="VisuDataNodeCallbackMethod">
      <doc xml:whitespace="preserve">Interface for callbacks methods that are called whenever a data is changed
on a node.

WARNING: it may be removed later.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="dataObj" transfer-ownership="none">
          <doc xml:whitespace="preserve">the #VisuData object on which the callback is done ;</doc>
          <type name="Data" c:type="VisuData*"/>
        </parameter>
        <parameter name="node" transfer-ownership="none">
          <doc xml:whitespace="preserve">the #VisuNode on which the callback is done ;</doc>
          <type name="Node" c:type="VisuNode*"/>
        </parameter>
        <parameter name="data" transfer-ownership="none">
          <doc xml:whitespace="preserve">a user defined pointer.</doc>
          <type name="gpointer" c:type="gpointer"/>
        </parameter>
      </parameters>
    </callback>
    <record name="DataNodeClass"
            c:type="VisuDataNodeClass"
            disguised="1"
            glib:is-gtype-struct-for="DataNode">
      <doc xml:whitespace="preserve">An opaque structure.</doc>
    </record>
    <callback name="DataNodeFromStringFunc"
              c:type="VisuDataNodeFromStringFunc">
      <doc xml:whitespace="preserve">If the string is correctly formatted (that means it has the same format as
the string returned by GetValueAsStringFunc()) the stored values are modified.
The resulting string is created and put into @labelOut. If the input string @labelIn
is unparsable, @labelOut will contain current values.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">TRUE if the string was correctly parsed (modified or not).</doc>
        <type name="gboolean" c:type="gboolean"/>
      </return-value>
      <parameters>
        <parameter name="data" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuDataNode ;</doc>
          <type name="DataNode" c:type="VisuDataNode*"/>
        </parameter>
        <parameter name="dataObj" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuData object ;</doc>
          <type name="Data" c:type="VisuData*"/>
        </parameter>
        <parameter name="node" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuNode ;</doc>
          <type name="Node" c:type="VisuNode*"/>
        </parameter>
        <parameter name="labelIn" transfer-ownership="none">
          <doc xml:whitespace="preserve">a formatted string ;</doc>
          <type name="utf8" c:type="gchar*"/>
        </parameter>
        <parameter name="labelOut" transfer-ownership="none">
          <doc xml:whitespace="preserve">a pointer to store a string ;</doc>
          <type name="utf8" c:type="gchar**"/>
        </parameter>
        <parameter name="modify" transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if the values have been modified.</doc>
          <type name="gboolean" c:type="gboolean*"/>
        </parameter>
      </parameters>
    </callback>
    <callback name="DataNodeToStringFunc" c:type="VisuDataNodeToStringFunc">
      <doc xml:whitespace="preserve">For the given node, the values stored are printed into a string.</doc>
      <return-value transfer-ownership="full">
        <doc xml:whitespace="preserve">a newly created string (use g_free()).</doc>
        <type name="utf8" c:type="gchar*"/>
      </return-value>
      <parameters>
        <parameter name="data" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuDataNode ;</doc>
          <type name="DataNode" c:type="VisuDataNode*"/>
        </parameter>
        <parameter name="dataObj" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuData object ;</doc>
          <type name="Data" c:type="VisuData*"/>
        </parameter>
        <parameter name="node" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuNode.</doc>
          <type name="Node" c:type="VisuNode*"/>
        </parameter>
      </parameters>
    </callback>
    <record name="DataPrivate" c:type="VisuDataPrivate" disguised="1">
      <doc xml:whitespace="preserve">Private fields for #VisuData objects.</doc>
    </record>
    <callback name="DataScalingFunc" c:type="VisuDataScalingFunc">
      <doc xml:whitespace="preserve">Interface for routine that need to rescale @node before drawing
them.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">the scaling factor.</doc>
        <type name="gfloat" c:type="float"/>
      </return-value>
      <parameters>
        <parameter name="visuData" transfer-ownership="none">
          <doc xml:whitespace="preserve">a pointer to the calling object ;</doc>
          <type name="Data" c:type="VisuData*"/>
        </parameter>
        <parameter name="node" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuNode ;</doc>
          <type name="Node" c:type="VisuNode*"/>
        </parameter>
      </parameters>
    </callback>
    <record name="Dump" c:type="VisuDump">
      <doc xml:whitespace="preserve">This structure is used to store a dumping extension. Such an
extension is characterized by its #ToolFileFormat and a method that can
write a file from the current rendered data.</doc>
      <field name="bitmap" writable="1">
        <type name="gboolean" c:type="gboolean"/>
      </field>
      <field name="glRequired" writable="1">
        <type name="gboolean" c:type="gboolean"/>
      </field>
      <field name="fileType" writable="1">
        <type name="FileFormat" c:type="ToolFileFormat*"/>
      </field>
      <field name="hasAlpha" writable="1">
        <type name="gboolean" c:type="gboolean"/>
      </field>
      <field name="writeFunc" introspectable="0" writable="1">
        <type name="DumpWriteFunc" c:type="VisuDumpWriteFunc"/>
      </field>
      <method name="callWriteFunc"
              c:identifier="visu_dump_callWriteFunc"
              version="3.6"
              throws="1">
        <doc xml:whitespace="preserve">Use the write function of @dump to export the current @dataObj to
file @fileName.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if dump succeed.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="fileName" transfer-ownership="none">
            <doc xml:whitespace="preserve">a string that defined the file to write to ;</doc>
            <type name="utf8" c:type="char*"/>
          </parameter>
          <parameter name="width" transfer-ownership="none">
            <doc xml:whitespace="preserve">an integer ;</doc>
            <type name="gint" c:type="int"/>
          </parameter>
          <parameter name="height" transfer-ownership="none">
            <doc xml:whitespace="preserve">an integer ;</doc>
            <type name="gint" c:type="int"/>
          </parameter>
          <parameter name="dataObj" transfer-ownership="none">
            <doc xml:whitespace="preserve">the #VisuData to be exported ;</doc>
            <type name="Data" c:type="VisuData*"/>
          </parameter>
          <parameter name="image" transfer-ownership="none" allow-none="1">
            <doc xml:whitespace="preserve">the data to be written ;</doc>
            <array name="GLib.Array" c:type="GArray*">
              <type name="gint8"/>
            </array>
          </parameter>
          <parameter name="functionWait"
                     transfer-ownership="none"
                     allow-none="1"
                     scope="call"
                     closure="6">
            <doc xml:whitespace="preserve">a method to call periodically during the dump ;</doc>
            <type name="VoidDataFunc" c:type="ToolVoidDataFunc"/>
          </parameter>
          <parameter name="data" transfer-ownership="none">
            <doc xml:whitespace="preserve">some pointer on object to be passed to the wait function.</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <function name="getAllModules" c:identifier="visu_dump_getAllModules">
        <doc xml:whitespace="preserve">All dumping extensions are stored in an opaque way in V_Sim. But
they can be listed by a call to this method.

the known dumping extensions. This list is own by V_Sim and should
be considered read-only.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">a list of all</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="Dump"/>
          </type>
        </return-value>
      </function>
      <function name="getNModules" c:identifier="visu_dump_getNModules">
        <doc xml:whitespace="preserve">A convenient way to know how many dumping extensions are registered.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">the number of known dumping extensions.</doc>
          <type name="gint" c:type="gint"/>
        </return-value>
      </function>
      <function name="getQuark"
                c:identifier="visu_dump_getQuark"
                introspectable="0">
        <doc xml:whitespace="preserve">Internal routine to get the #GQuark to handle error related to dump
actions.</doc>
        <return-value transfer-ownership="none">
          <type name="GLib.Quark" c:type="GQuark"/>
        </return-value>
      </function>
    </record>
    <callback name="DumpInitFunc" c:type="VisuDumpInitFunc" introspectable="0">
      <doc xml:whitespace="preserve">This protoype defines initializing function for dumping extension.
Create such a function and add its name in the list #listInitDumpModuleFunc
defined in dumpModules/externalDumpModules.h thus the new dumping extension
will be initialized on startup.</doc>
      <return-value>
        <doc xml:whitespace="preserve">a newly allocated #VisuDump.</doc>
        <type name="Dump" c:type="VisuDump*"/>
      </return-value>
    </callback>
    <callback name="DumpWriteFunc"
              c:type="VisuDumpWriteFunc"
              introspectable="0">
      <doc xml:whitespace="preserve">This is a prototype of a method implemented by a dumping extension that is called
when the current rendering must be dumped to a file.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">TRUE if everything went right.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </return-value>
      <parameters>
        <parameter name="format" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #ToolFileFormat object, corresponding to the write method ;</doc>
          <type name="FileFormat" c:type="ToolFileFormat*"/>
        </parameter>
        <parameter name="fileName" transfer-ownership="none">
          <doc xml:whitespace="preserve">a string that defined the file to write to ;</doc>
          <type name="utf8" c:type="char*"/>
        </parameter>
        <parameter name="width" transfer-ownership="none">
          <doc xml:whitespace="preserve">an integer ;</doc>
          <type name="gint" c:type="int"/>
        </parameter>
        <parameter name="height" transfer-ownership="none">
          <doc xml:whitespace="preserve">an integer.</doc>
          <type name="gint" c:type="int"/>
        </parameter>
        <parameter name="dataObj" transfer-ownership="none">
          <doc xml:whitespace="preserve">the #VisuData to be exported ;</doc>
          <type name="Data" c:type="VisuData*"/>
        </parameter>
        <parameter name="image" transfer-ownership="none">
          <doc xml:whitespace="preserve">the data to be written ;</doc>
          <type name="guint8" c:type="guchar*"/>
        </parameter>
        <parameter name="error" transfer-ownership="none" allow-none="1">
          <doc xml:whitespace="preserve">a location to store some error (not NULL) ;</doc>
          <type name="GLib.Error" c:type="GError**"/>
        </parameter>
        <parameter name="functionWait"
                   transfer-ownership="none"
                   allow-none="1"
                   closure="8">
          <doc xml:whitespace="preserve">a method to call periodically during the dump ;</doc>
          <type name="VoidDataFunc" c:type="ToolVoidDataFunc"/>
        </parameter>
        <parameter name="data" transfer-ownership="none" closure="8">
          <doc xml:whitespace="preserve">some pointer on object to be passed to the wait function.</doc>
          <type name="gpointer" c:type="gpointer"/>
        </parameter>
      </parameters>
    </callback>
    <constant name="ELEMENT_MAX_NUMBER"
              value="500"
              c:type="VISU_ELEMENT_MAX_NUMBER">
      <type name="gint" c:type="gint"/>
    </constant>
    <constant name="EXTENSION_PRIORITY_BACKGROUND"
              value="0"
              c:type="VISU_EXTENSION_PRIORITY_BACKGROUND">
      <type name="gint" c:type="gint"/>
    </constant>
    <constant name="EXTENSION_PRIORITY_HIGH"
              value="20"
              c:type="VISU_EXTENSION_PRIORITY_HIGH">
      <type name="gint" c:type="gint"/>
    </constant>
    <constant name="EXTENSION_PRIORITY_LAST"
              value="100"
              c:type="VISU_EXTENSION_PRIORITY_LAST">
      <type name="gint" c:type="gint"/>
    </constant>
    <constant name="EXTENSION_PRIORITY_LOW"
              value="80"
              c:type="VISU_EXTENSION_PRIORITY_LOW">
      <type name="gint" c:type="gint"/>
    </constant>
    <constant name="EXTENSION_PRIORITY_NODES"
              value="2"
              c:type="VISU_EXTENSION_PRIORITY_NODES">
      <type name="gint" c:type="gint"/>
    </constant>
    <constant name="EXTENSION_PRIORITY_NODE_DECORATIONS"
              value="5"
              c:type="VISU_EXTENSION_PRIORITY_NODE_DECORATIONS">
      <type name="gint" c:type="gint"/>
    </constant>
    <constant name="EXTENSION_PRIORITY_NORMAL"
              value="50"
              c:type="VISU_EXTENSION_PRIORITY_NORMAL">
      <type name="gint" c:type="gint"/>
    </constant>
    <class name="Element"
           c:symbol-prefix="element"
           parent="GObject.Object"
           glib:type-name="VisuElement"
           glib:get-type="visu_element_get_type"
           glib:type-struct="ElementClass">
      <doc xml:whitespace="preserve">Structure to store the description of an element.</doc>
      <constructor name="new" c:identifier="visu_element_new">
        <doc xml:whitespace="preserve">Allocate a new visuElement with the specified name. Remember
that names must be unique since they identify the element.

wrong in the process (if the name already exist for example).</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">the newly created VisuElement or 0 if something goes</doc>
          <type name="Element" c:type="VisuElement*"/>
        </return-value>
        <parameters>
          <parameter name="key" transfer-ownership="none">
            <doc xml:whitespace="preserve">the name of the new element to create.</doc>
            <type name="utf8" c:type="char*"/>
          </parameter>
        </parameters>
      </constructor>
      <function name="getAllElements"
                c:identifier="visu_element_getAllElements">
        <doc xml:whitespace="preserve">This method returns a list of all the registered #VisuElement.
The returned list is read-only.

all known #VisuElement.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">the list of</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="Element"/>
          </type>
        </return-value>
      </function>
      <function name="getUpdateNodesOnMaterialChange"
                c:identifier="visu_element_getUpdateNodesOnMaterialChange">
        <doc xml:whitespace="preserve">Retrieve if one the #VisuElement is sensitive to the material
values. See visu_element_setUpdateNodesOnMaterialChange().

material values are changed.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if visu_data_createNodes() should be called when the</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
      </function>
      <function name="lookup"
                c:identifier="visu_element_lookup"
                version="3.6"
                introspectable="0">
        <doc xml:whitespace="preserve">Lookup for element @name in the base. Do not create it if not
found. To do this, use visu_element_retrieveFromName().</doc>
        <return-value>
          <doc xml:whitespace="preserve">the found #VisuElement or NULL.</doc>
          <type name="Element" c:type="VisuElement*"/>
        </return-value>
        <parameters>
          <parameter name="name" transfer-ownership="none">
            <doc xml:whitespace="preserve">a string.</doc>
            <type name="utf8" c:type="gchar*"/>
          </parameter>
        </parameters>
      </function>
      <function name="retrieveFromName"
                c:identifier="visu_element_retrieveFromName">
        <doc xml:whitespace="preserve">Try to find a #VisuElement already associated to that @name or
create a new one if none has been found. If @nw is not NULL it is
set to FALSE if @name was found.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuElement associated to this @name.</doc>
          <type name="Element" c:type="VisuElement*"/>
        </return-value>
        <parameters>
          <parameter name="name" transfer-ownership="none">
            <doc xml:whitespace="preserve">a string that identify the #VisuElement (in UTF8) ;</doc>
            <type name="utf8" c:type="gchar*"/>
          </parameter>
          <parameter name="nw"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none">
            <doc xml:whitespace="preserve">a location to store a boolean.</doc>
            <type name="gboolean" c:type="gboolean*"/>
          </parameter>
        </parameters>
      </function>
      <function name="setUpdateNodesOnMaterialChange"
                c:identifier="visu_element_setUpdateNodesOnMaterialChange">
        <doc xml:whitespace="preserve">If this method is called, whenever a change occurs to a #VisuElement material
description (color and light) the corresponding OpenGl list of nodes of the
currentVisuData is rebuilt. This is usefull if the nodes can't use the list material
because the color is node dependant for example. Use
visu_element_unsetUpdateNodesOnMaterialChange() to return to the normal behavior.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
      </function>
      <function name="unsetUpdateNodesOnMaterialChange"
                c:identifier="visu_element_unsetUpdateNodesOnMaterialChange">
        <doc xml:whitespace="preserve">If this method is called (and no other method has used
visu_element_setUpdateNodesOnMaterialChange(), a changement
in the material description only change the list of the material.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
      </function>
      <method name="createMaterial" c:identifier="visu_element_createMaterial">
        <doc xml:whitespace="preserve">Create a list whose number is defined by #identifierMaterials + @ele-&gt;typeNumber
that stores the definition of light and color for this #VisuElement. The previous
OpenGL object list with the same identifier is deleted.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
      </method>
      <method name="getIdentifierMaterial"
              c:identifier="visu_element_getIdentifierMaterial">
        <doc xml:whitespace="preserve">This method is useful for the rendering method to get the
OpenGl identifier of the material of the specified element.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">the OpenGL identifier of the specified VisuElement.</doc>
          <type name="gint" c:type="int"/>
        </return-value>
      </method>
      <method name="getRendered" c:identifier="visu_element_getRendered">
        <doc xml:whitespace="preserve">This gets the value of the private attribute 'rendered' for
the specified #VisuElement.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">the value of attribute 'rendered'.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
      </method>
      <method name="getSensitiveToPlanes"
              c:identifier="visu_element_getSensitiveToPlanes">
        <doc xml:whitespace="preserve">This method is used to retrieve if nodes of the element are sensitive to
the masking property of planes, or not.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if nodes are masked by planes.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
      </method>
      <method name="setAllColorValues"
              c:identifier="visu_element_setAllColorValues">
        <doc xml:whitespace="preserve">This method is used to set all the values that define the color
and the lighting of the given element.

redraw is need if the value is not null.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">&gt; 0 if visu_data_createNodes() should be called and then</doc>
          <type name="gint" c:type="gint"/>
        </return-value>
        <parameters>
          <parameter name="rgb" transfer-ownership="none">
            <doc xml:whitespace="preserve">the new color given by a {red, green, blue} array ;</doc>
            <array zero-terminated="0" c:type="float" fixed-size="4">
              <type name="gfloat" c:type="float"/>
            </array>
          </parameter>
          <parameter name="material" transfer-ownership="none">
            <doc xml:whitespace="preserve">the new values to define the lighting.</doc>
            <array zero-terminated="0" c:type="float" fixed-size="5">
              <type name="gfloat" c:type="float"/>
            </array>
          </parameter>
        </parameters>
      </method>
      <method name="setAllMaterialValues"
              c:identifier="visu_element_setAllMaterialValues">
        <doc xml:whitespace="preserve">It saves the values of material in the specified VisuElement.

redraw is need if the value is not null.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">&gt; 0 if visu_data_createNodes() should be called and then</doc>
          <type name="gint" c:type="gint"/>
        </return-value>
        <parameters>
          <parameter name="material" transfer-ownership="none">
            <doc xml:whitespace="preserve">the new values to define the lighting.</doc>
            <array zero-terminated="0" c:type="float" fixed-size="5">
              <type name="gfloat" c:type="float"/>
            </array>
          </parameter>
        </parameters>
      </method>
      <method name="setAllRGBValues"
              c:identifier="visu_element_setAllRGBValues">
        <doc xml:whitespace="preserve">It saves the values of rgb in the specified VisuElement.

redraw is need if the value is not null.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">&gt; 0 if visu_data_createNodes() should be called and then</doc>
          <type name="gint" c:type="gint"/>
        </return-value>
        <parameters>
          <parameter name="rgb" transfer-ownership="none">
            <doc xml:whitespace="preserve">the new color given by a {red, green, blue} array.</doc>
            <array zero-terminated="0" c:type="float" fixed-size="4">
              <type name="gfloat" c:type="float"/>
            </array>
          </parameter>
        </parameters>
      </method>
      <method name="setMaterialValue"
              c:identifier="visu_element_setMaterialValue">
        <doc xml:whitespace="preserve">It saves the specific value of material (use the enum as the parameter
material) in the specified VisuElement.

redraw is need if the value is not null.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">&gt; 0 if visu_data_createNodes() should be called and then</doc>
          <type name="gint" c:type="gint"/>
        </return-value>
        <parameters>
          <parameter name="material" transfer-ownership="none">
            <doc xml:whitespace="preserve">the component to change,</doc>
            <type name="gint" c:type="int"/>
          </parameter>
          <parameter name="value" transfer-ownership="none">
            <doc xml:whitespace="preserve">the new value of the specified component.</doc>
            <type name="gfloat" c:type="float"/>
          </parameter>
        </parameters>
      </method>
      <method name="setRGBValue" c:identifier="visu_element_setRGBValue">
        <doc xml:whitespace="preserve">It saves the specific value of rgb (0 for red, 1 for green and 2
for bluein the specified VisuElement.

redraw is need if the value is not null.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">&gt; 0 if visu_data_createNodes() should be called and then</doc>
          <type name="gint" c:type="gint"/>
        </return-value>
        <parameters>
          <parameter name="rgb" transfer-ownership="none">
            <doc xml:whitespace="preserve">the component to change, 0 for red, 1 for green and 2 for blue,</doc>
            <type name="gint" c:type="int"/>
          </parameter>
          <parameter name="value" transfer-ownership="none">
            <doc xml:whitespace="preserve">the value for one of the red, green or blue component.</doc>
            <type name="gfloat" c:type="float"/>
          </parameter>
        </parameters>
      </method>
      <method name="setRendered" c:identifier="visu_element_setRendered">
        <doc xml:whitespace="preserve">This method sets the private attribute 'rendered' to TRUE or FALSE
for the specified #visuElement. If FALSE, all the nodes of that #VisuElement
are not included in the nodes OpenGL list.

#VisuElement and then should emit the 'OpenGLAskForReDraw' signal.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">1 if the calling method should call visu_data_createNodes() for the given</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="rendered" transfer-ownership="none">
            <doc xml:whitespace="preserve">TRUE or FALSE.</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="setSensitiveToPlanes"
              c:identifier="visu_element_setSensitiveToPlanes">
        <doc xml:whitespace="preserve">This method sets the private attribute 'sensitiveToMaskingPlanes' to TRUE or FALSE
for the specified #visuElement. If TRUE, all the nodes of that #VisuElement
are not sensitive to the masking property of planes.

#VisuElement and then should add visu_object_redraw() to the Gloop.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">1 if the calling method should call visu_data_createNodes() for the given</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="status" transfer-ownership="none">
            <doc xml:whitespace="preserve">TRUE or FALSE.</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <glib:signal name="ElementMaterialChanged"
                   when="last"
                   no-recurse="1"
                   version="3.6">
        <doc xml:whitespace="preserve">Gets emitted when the material or color properties of a VisuElement
are modified.</doc>
        <return-value transfer-ownership="none">
          <type name="none"/>
        </return-value>
      </glib:signal>
      <glib:signal name="ElementNew" when="last" no-recurse="1" version="3.6">
        <doc xml:whitespace="preserve">A new element is available.</doc>
        <return-value transfer-ownership="none">
          <type name="none"/>
        </return-value>
      </glib:signal>
      <glib:signal name="ElementPlaneChanged"
                   when="last"
                   no-recurse="1"
                   version="3.6">
        <doc xml:whitespace="preserve">Gets emitted when the property of masking by plane is modified.</doc>
        <return-value transfer-ownership="none">
          <type name="none"/>
        </return-value>
      </glib:signal>
      <glib:signal name="ElementRenderedChanged"
                   when="last"
                   no-recurse="1"
                   version="3.6">
        <doc xml:whitespace="preserve">Gets emitted when one of the rendered #VisuElement is made
visible or hidden.</doc>
        <return-value transfer-ownership="none">
          <type name="none"/>
        </return-value>
      </glib:signal>
    </class>
    <record name="ElementClass"
            c:type="VisuElementClass"
            disguised="1"
            glib:is-gtype-struct-for="Element">
      <doc xml:whitespace="preserve">An opaque structure representing the class of #VisuElement objects.</doc>
    </record>
    <record name="Extension" c:type="VisuExtension">
      <doc xml:whitespace="preserve">This structure allows the user to store data
about an OpenGL extension.</doc>
      <field name="name" writable="1">
        <type name="utf8" c:type="gchar*"/>
      </field>
      <field name="nameI18n" writable="1">
        <type name="utf8" c:type="gchar*"/>
      </field>
      <field name="description" writable="1">
        <type name="utf8" c:type="gchar*"/>
      </field>
      <field name="objectListId" writable="1">
        <type name="gint" c:type="int"/>
      </field>
      <field name="rebuild" writable="1">
        <type name="ExtensionRebuildFunc" c:type="VisuExtensionRebuildFunc"/>
      </field>
      <field name="priority" writable="1">
        <type name="guint" c:type="guint"/>
      </field>
      <field name="saveState" writable="1">
        <type name="gboolean" c:type="gboolean"/>
      </field>
      <field name="isSensitiveToRenderingMode" writable="1">
        <type name="gboolean" c:type="gboolean"/>
      </field>
      <field name="preferedRenderingMode" writable="1">
        <type name="RenderingModeId" c:type="VisuRenderingModeId"/>
      </field>
      <field name="used" writable="1">
        <type name="gint" c:type="int"/>
      </field>
      <method name="free" c:identifier="visu_extension_free">
        <doc xml:whitespace="preserve">Free all the allocated attributes of the specified method.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
      </method>
      <method name="getActive" c:identifier="visu_extension_getActive">
        <doc xml:whitespace="preserve">Get if the extension is used or not. If not its ObjectList
is not rendered.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">1 if used, 0 otherwise.</doc>
          <type name="gint" c:type="int"/>
        </return-value>
      </method>
      <method name="setActive" c:identifier="visu_extension_setActive">
        <doc xml:whitespace="preserve">Set if an extension is actually used or not.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="value" transfer-ownership="none">
            <doc xml:whitespace="preserve">the new value.</doc>
            <type name="gint" c:type="int"/>
          </parameter>
        </parameters>
      </method>
      <method name="setPreferedRenderingMode"
              c:identifier="visu_extension_setPreferedRenderingMode">
        <doc xml:whitespace="preserve">This method is used to specify the rendering mode that the extension should use
to be drawn (if the sensitive flag has been set, see
visu_extension_setSensitiveToRenderingMode()). If the @value is set
to followGeneralSetting, the extension follows the global setting
for rendering mode.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if the "OpenGLAskForReDraw" should be emitted.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="value" transfer-ownership="none">
            <doc xml:whitespace="preserve">see #VisuRenderingModeId to choose one.</doc>
            <type name="RenderingModeId" c:type="VisuRenderingModeId"/>
          </parameter>
        </parameters>
      </method>
      <method name="setPriority" c:identifier="visu_extension_setPriority">
        <doc xml:whitespace="preserve">Extentions are drawn in an order that depends on their priority.
The lower is the number, the sooner the extension is drawn. Flags,
such as #VISU_EXTENSION_PRIORITY_NORMAL or #VISU_EXTENSION_PRIORITY_LOW,
can be used or user defined values are also possible.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="priority" transfer-ownership="none">
            <doc xml:whitespace="preserve">an integer value.</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
        </parameters>
      </method>
      <method name="setSaveOpenGLState"
              c:identifier="visu_extension_setSaveOpenGLState">
        <doc xml:whitespace="preserve">If the extension needs to change some OpenGL state (to disable the fog for example,
or the cullface), a flag should be set to enable V_Sim to restore the right values after
the extensio have been called. Because the OpenGL list of an extension is just GL_COMPILE
the extension can't just save and restore state itself because when the list is called,
the state can have been changed.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="saveState" transfer-ownership="none">
            <doc xml:whitespace="preserve">an boolean value.</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="setSensitiveToRenderingMode"
              c:identifier="visu_extension_setSensitiveToRenderingMode">
        <doc xml:whitespace="preserve">If @status is TRUE, when the extension is rendered, OpenGL context is
switched to the rendering mode preferd for the extension. Use
visu_extension_setPreferedRenderingMode() to choose one.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="status" transfer-ownership="none">
            <doc xml:whitespace="preserve">an boolean value.</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <function name="new" c:identifier="visu_extension_new">
        <doc xml:whitespace="preserve">Create a new VisuExtension with the specified name, description
and OpenGL object list. The priority is set by default to
#VISU_EXTENSION_PRIORITY_NORMAL. The flag used to store
the OpenGL state is put to FALSE by default (see
visu_extension_setSaveOpenGLState() to chance it).</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">the new VisuExtension or null if something wrong happens.</doc>
          <type name="Extension" c:type="VisuExtension*"/>
        </return-value>
        <parameters>
          <parameter name="name" transfer-ownership="none">
            <doc xml:whitespace="preserve">name of the extension, in ASCII, used as id in the config files,</doc>
            <type name="filename" c:type="gchar*"/>
          </parameter>
          <parameter name="nameI18n" transfer-ownership="none">
            <doc xml:whitespace="preserve">name in UTF8 that can be translated and shown to user,</doc>
            <type name="utf8" c:type="gchar*"/>
          </parameter>
          <parameter name="description"
                     transfer-ownership="none"
                     allow-none="1">
            <doc xml:whitespace="preserve">a brief description of the extension (can be null),</doc>
            <type name="utf8" c:type="gchar*"/>
          </parameter>
          <parameter name="objectListId" transfer-ownership="none">
            <doc xml:whitespace="preserve">an int to identify an list of OpenGL objects (null if this extension as no OpenGL object,</doc>
            <type name="gint" c:type="int"/>
          </parameter>
          <parameter name="rebuild"
                     transfer-ownership="none"
                     allow-none="1"
                     scope="call">
            <doc xml:whitespace="preserve">handler to a method that is called every time V_Sim needs to create again the OpenGL object list. If NULL, nothing is called.</doc>
            <type name="ExtensionRebuildFunc"
                  c:type="VisuExtensionRebuildFunc"/>
          </parameter>
        </parameters>
      </function>
    </record>
    <callback name="ExtensionRebuildFunc" c:type="VisuExtensionRebuildFunc">
      <doc xml:whitespace="preserve">Prototypes used to recreate OpenGL list of objects for each extension.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="dataObj" transfer-ownership="none">
          <doc xml:whitespace="preserve">the #VisuData object to be rebuilt.</doc>
          <type name="Data" c:type="VisuData*"/>
        </parameter>
      </parameters>
    </callback>
    <record name="FileFormat" c:type="ToolFileFormat" disguised="1">
      <doc xml:whitespace="preserve">An opaque structure.</doc>
      <method name="addPropertyBoolean"
              c:identifier="tool_file_format_addPropertyBoolean">
        <doc xml:whitespace="preserve">Add a new boolean property to the file format @format.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">a newly created #ToolOption, free with tool_option_free().</doc>
          <type name="Option" c:type="ToolOption*"/>
        </return-value>
        <parameters>
          <parameter name="name" transfer-ownership="none">
            <doc xml:whitespace="preserve">a name ;</doc>
            <type name="utf8" c:type="gchar*"/>
          </parameter>
          <parameter name="label" transfer-ownership="none">
            <doc xml:whitespace="preserve">a description ;</doc>
            <type name="utf8" c:type="gchar*"/>
          </parameter>
          <parameter name="defaultVal" transfer-ownership="none">
            <doc xml:whitespace="preserve">a default value.</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="addPropertyInt"
              c:identifier="tool_file_format_addPropertyInt">
        <doc xml:whitespace="preserve">Add a new integer property to the file format @format.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">a newly created #ToolOption, free with tool_option_free().</doc>
          <type name="Option" c:type="ToolOption*"/>
        </return-value>
        <parameters>
          <parameter name="name" transfer-ownership="none">
            <doc xml:whitespace="preserve">a name ;</doc>
            <type name="utf8" c:type="gchar*"/>
          </parameter>
          <parameter name="label" transfer-ownership="none">
            <doc xml:whitespace="preserve">a description ;</doc>
            <type name="utf8" c:type="gchar*"/>
          </parameter>
          <parameter name="defaultVal" transfer-ownership="none">
            <doc xml:whitespace="preserve">a default value.</doc>
            <type name="gint" c:type="gint"/>
          </parameter>
        </parameters>
      </method>
      <method name="canMatch"
              c:identifier="tool_file_format_canMatch"
              version="3.6">
        <doc xml:whitespace="preserve">This method is used to know if the file pattern list can be used
to match a given filename with @tool_file_format_match().</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if a call to @tool_file_format_match() is safe.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
      </method>
      <method name="copy" c:identifier="tool_file_format_copy" version="3.6">
        <doc xml:whitespace="preserve">Copy the given file format @from a create a new one.


be freed with tool_file_format_free().</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">a newly created #ToolFileFormat. Should</doc>
          <type name="FileFormat" c:type="ToolFileFormat*"/>
        </return-value>
      </method>
      <method name="free" c:identifier="tool_file_format_free">
        <doc xml:whitespace="preserve">Free all the memory used by @format. If @format is NULL, the method
writes a warning on the eror output.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
      </method>
      <method name="getFilePatterns"
              c:identifier="tool_file_format_getFilePatterns"
              version="3.6">
        <doc xml:whitespace="preserve">This method gives a list with the file patterns.

patterns. This list should not be freed.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">a list with the file</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="utf8"/>
          </type>
        </return-value>
      </method>
      <method name="getLabel" c:identifier="tool_file_format_getLabel">
        <doc xml:whitespace="preserve">This method gives a label describing the file format.

the paterns of the given format, given in parentethis. This string
should not be freed.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">a string made by the name and all</doc>
          <type name="utf8" c:type="gchar*"/>
        </return-value>
      </method>
      <method name="getName" c:identifier="tool_file_format_getName">
        <doc xml:whitespace="preserve">This method gives the name describing the file format.

should not be freed.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">a string with the name. This string</doc>
          <type name="utf8" c:type="gchar*"/>
        </return-value>
      </method>
      <method name="getPropertyByName"
              c:identifier="tool_file_format_getPropertyByName"
              version="3.5">
        <doc xml:whitespace="preserve">Retrieve the corresponding property to @name from the biven
@format.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">the found #ToolOption or NULL.</doc>
          <type name="Option" c:type="ToolOption*"/>
        </return-value>
        <parameters>
          <parameter name="name" transfer-ownership="none">
            <doc xml:whitespace="preserve">the name of a property.</doc>
            <type name="utf8" c:type="gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="getPropertyList"
              c:identifier="tool_file_format_getPropertyList">
        <doc xml:whitespace="preserve">Use this method to get a list of stored properties for the given #ToolFileFormat.
The GList is composed of #ToolOption objects.

GList* that is read-only.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">a</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="Option"/>
          </type>
        </return-value>
      </method>
      <method name="iterNextProperty"
              c:identifier="tool_file_format_iterNextProperty"
              version="3.6"
              introspectable="0">
        <doc xml:whitespace="preserve">Run to the next property of the file format @format. The iterator
attributes are updated so it's convenient to access the property
values and details, see #ToolFileFormatIter.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if any.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="iter" transfer-ownership="none">
            <doc xml:whitespace="preserve">an iterator.</doc>
            <type c:type="ToolFileFormatIter*"/>
          </parameter>
        </parameters>
      </method>
      <method name="match" c:identifier="tool_file_format_match">
        <doc xml:whitespace="preserve">This method try to match the given string to one of the patterns of
the #ToolFileFormat @format.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">the matching pattern, if any.</doc>
          <type name="utf8" c:type="gchar*"/>
        </return-value>
        <parameters>
          <parameter name="filename" transfer-ownership="none">
            <doc xml:whitespace="preserve">a string to match.</doc>
            <type name="utf8" c:type="gchar*"/>
          </parameter>
        </parameters>
      </method>
      <function name="getQuark"
                c:identifier="tool_file_format_getQuark"
                introspectable="0">
        <doc xml:whitespace="preserve">Internal routine to get the #GQuark to handle error related to file formats.</doc>
        <return-value transfer-ownership="none">
          <type name="GLib.Quark" c:type="GQuark"/>
        </return-value>
      </function>
      <function name="new" c:identifier="tool_file_format_new">
        <doc xml:whitespace="preserve">Allocate a new #ToolFileFormat. The @patterns argument is copied in
the #ToolFileFormat object and can be freed safely after the call to this method.

or NULL if something goes wrong.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">a newly allocated ToolFileFormat,</doc>
          <type name="FileFormat" c:type="ToolFileFormat*"/>
        </return-value>
        <parameters>
          <parameter name="descr" transfer-ownership="none">
            <doc xml:whitespace="preserve">a short string to label a new file format.</doc>
            <type name="utf8" c:type="gchar*"/>
          </parameter>
          <parameter name="patterns" transfer-ownership="none">
            <doc xml:whitespace="preserve">a set of patterns to identify files of this format.</doc>
            <array c:type="gchar**">
              <type name="utf8"/>
            </array>
          </parameter>
        </parameters>
      </function>
      <function name="newRestricted"
                c:identifier="tool_file_format_newRestricted">
        <doc xml:whitespace="preserve">Allocate a new #ToolFileFormat. The @patterns argument is copied in
the #ToolFileFormat object and can be freed safely after the call to this method.
The @patterns list is not all the patterns supported by the format.

or NULL if something goes wrong.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">a newly allocated ToolFileFormat,</doc>
          <type name="FileFormat" c:type="ToolFileFormat*"/>
        </return-value>
        <parameters>
          <parameter name="descr" transfer-ownership="none">
            <doc xml:whitespace="preserve">a short string to label a new file format.</doc>
            <type name="utf8" c:type="gchar*"/>
          </parameter>
          <parameter name="patterns" transfer-ownership="none">
            <doc xml:whitespace="preserve">a set of patterns to identify files of this format.</doc>
            <type name="utf8" c:type="gchar**"/>
          </parameter>
        </parameters>
      </function>
    </record>
    <enumeration name="FileFormatErrorFlag" c:type="ToolFileFormatErrorFlag">
      <doc xml:whitespace="preserve">These are flags used when reading a file with a loading method associated to a file format.</doc>
      <member name="method"
              value="0"
              c:identifier="TOOL_FILE_FORMAT_ERROR_METHOD"/>
      <member name="file"
              value="1"
              c:identifier="TOOL_FILE_FORMAT_ERROR_FILE"/>
      <member name="format"
              value="2"
              c:identifier="TOOL_FILE_FORMAT_ERROR_FORMAT"/>
      <member name="unknown_format"
              value="3"
              c:identifier="TOOL_FILE_FORMAT_ERROR_UNKNOWN_FORMAT"/>
    </enumeration>
    <enumeration name="GlExtInfosDrawId" c:type="VisuGlExtInfosDrawId">
      <doc xml:whitespace="preserve">This enum represents the possibilities for the information drawing.</doc>
      <member name="never" value="0" c:identifier="DRAW_NEVER"/>
      <member name="selected" value="1" c:identifier="DRAW_SELECTED"/>
      <member name="always" value="2" c:identifier="DRAW_ALWAYS"/>
    </enumeration>
    <enumeration name="GlExtInfosDrawMethod" c:type="VisuGlExtInfosDrawMethod">
      <doc xml:whitespace="preserve">This enum represents the method for information drawing.</doc>
      <member name="none" value="0" c:identifier="EXT_DRAW_METH_NONE"/>
      <member name="id" value="1" c:identifier="EXT_DRAW_METH_ID"/>
      <member name="type" value="2" c:identifier="EXT_DRAW_METH_TYPE"/>
      <member name="other" value="3" c:identifier="EXT_DRAW_METH_OTHER"/>
    </enumeration>
    <enumeration name="GtkDirType" c:type="VisuGtkDirType">
      <doc xml:whitespace="preserve">V_Sim remembers the last open directory when presenting a new file
selector. This enum is used to specify different kind of
directories. Like that saving a configuration file in a given
directory will not affect the prefered directory for browsing a
list of files.</doc>
      <member name="isu_dir_file" value="0" c:identifier="VISU_DIR_FILE"/>
      <member name="isu_dir_surface"
              value="1"
              c:identifier="VISU_DIR_SURFACE"/>
      <member name="isu_dir_datafile"
              value="2"
              c:identifier="VISU_DIR_DATAFILE"/>
      <member name="isu_dir_conf" value="3" c:identifier="VISU_DIR_CONF"/>
      <member name="isu_dir_browser"
              value="4"
              c:identifier="VISU_DIR_BROWSER"/>
    </enumeration>
    <callback name="GtkInitWidgetFunc" c:type="VisuGtkInitWidgetFunc">
      <doc xml:whitespace="preserve">This prototype is used whenever a method is required to initialise
the GTK interface of V_Sim. @panel must be set to point on the
window of the command panel, @renderWindow must point to the window
containing the rendering area (can be the same than @panel) and
@renderArea contains the widget that does the OpenGL rendering.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="panel" transfer-ownership="none">
          <doc xml:whitespace="preserve">a location for a #GtkWindow ;</doc>
          <type name="Gtk.Window" c:type="GtkWindow**"/>
        </parameter>
        <parameter name="renderWindow" transfer-ownership="none">
          <doc xml:whitespace="preserve">a location for a #GtkWindow ;</doc>
          <type name="Gtk.Window" c:type="GtkWindow**"/>
        </parameter>
        <parameter name="renderArea" transfer-ownership="none">
          <doc xml:whitespace="preserve">a location for a #GtkWidget.</doc>
          <type name="Gtk.Widget" c:type="GtkWidget**"/>
        </parameter>
      </parameters>
    </callback>
    <callback name="GtkSetFilesFunc" c:type="VisuGtkSetFilesFunc">
      <doc xml:whitespace="preserve">Methods that conform to this prototype is used to set filename(s)
to be loaded when the 'load' button is pushed. They can use a
#GtkFileChooser to prompt the user for file names.

call gtkMainLoadAndRender_file() with a g_idle_add method.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">FALSE if no filename as been set, TRUE if the calling method should</doc>
        <type name="gboolean" c:type="gboolean"/>
      </return-value>
      <parameters>
        <parameter name="data" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuData to store the informations ;</doc>
          <type name="Data" c:type="VisuData*"/>
        </parameter>
        <parameter name="parent" transfer-ownership="none">
          <doc xml:whitespace="preserve">the parent window of the dialog.</doc>
          <type name="Gtk.Window" c:type="GtkWindow*"/>
        </parameter>
      </parameters>
    </callback>
    <callback name="GtkWidgetFunc" c:type="VisuGtkWidgetFunc">
      <doc xml:whitespace="preserve">This prototype is used whenever a method is required to create a GtkWidget.</doc>
      <return-value transfer-ownership="full">
        <doc xml:whitespace="preserve">a newly created GtkWidget.</doc>
        <type name="Gtk.Widget" c:type="GtkWidget*"/>
      </return-value>
    </callback>
    <record name="Interactive" c:type="VisuInteractive" disguised="1">
      <doc xml:whitespace="preserve">All fields are private.</doc>
    </record>
    <record name="InteractiveClass"
            c:type="VisuInteractiveClass"
            disguised="1">
      <doc xml:whitespace="preserve">An opaque structure representing the class of #VisuInteractive objects.</doc>
    </record>
    <enumeration name="InteractiveId" c:type="VisuInteractiveId">
      <doc xml:whitespace="preserve">These are the possible mouse interaction that are implemented.</doc>
      <member name="none" value="0" c:identifier="interactive_none"/>
      <member name="observe" value="1" c:identifier="interactive_observe"/>
      <member name="measureandobserve"
              value="2"
              c:identifier="interactive_measureAndObserve"/>
      <member name="measure" value="3" c:identifier="interactive_measure"/>
      <member name="pick" value="4" c:identifier="interactive_pick"/>
      <member name="move" value="5" c:identifier="interactive_move"/>
      <member name="mark" value="6" c:identifier="interactive_mark"/>
    </enumeration>
    <enumeration name="InteractiveMethod" c:type="VisuInteractiveMethod">
      <doc xml:whitespace="preserve">Describes the different possible methods for observe moves.</doc>
      <member name="constrained"
              value="0"
              c:identifier="interactive_constrained"/>
      <member name="walker" value="1" c:identifier="interactive_walker"/>
    </enumeration>
    <enumeration name="InteractivePick" c:type="VisuInteractivePick">
      <doc xml:whitespace="preserve">Possible significations of a click.</doc>
      <member name="none" value="0" c:identifier="PICK_NONE"/>
      <member name="selected" value="1" c:identifier="PICK_SELECTED"/>
      <member name="distance" value="2" c:identifier="PICK_DISTANCE"/>
      <member name="angle" value="3" c:identifier="PICK_ANGLE"/>
      <member name="highlight" value="4" c:identifier="PICK_HIGHLIGHT"/>
      <member name="reference_1" value="5" c:identifier="PICK_REFERENCE_1"/>
      <member name="unreference_1"
              value="6"
              c:identifier="PICK_UNREFERENCE_1"/>
      <member name="reference_2" value="7" c:identifier="PICK_REFERENCE_2"/>
      <member name="unreference_2"
              value="8"
              c:identifier="PICK_UNREFERENCE_2"/>
      <member name="information" value="9" c:identifier="PICK_INFORMATION"/>
      <member name="region" value="10" c:identifier="PICK_REGION"/>
    </enumeration>
    <enumeration name="InteractivePickError" c:type="VisuInteractivePickError">
      <doc xml:whitespace="preserve">Possible errors to occur when pick or measure.</doc>
      <member name="none" value="0" c:identifier="PICK_ERROR_NONE"/>
      <member name="no_selection"
              value="1"
              c:identifier="PICK_ERROR_NO_SELECTION"/>
      <member name="same_ref" value="2" c:identifier="PICK_ERROR_SAME_REF"/>
      <member name="ref1" value="3" c:identifier="PICK_ERROR_REF1"/>
      <member name="ref2" value="4" c:identifier="PICK_ERROR_REF2"/>
    </enumeration>
    <class name="Marks"
           c:symbol-prefix="marks"
           c:type="VisuMarks"
           version="3.6"
           parent="GObject.Object"
           glib:type-name="VisuMarks"
           glib:get-type="visu_marks_get_type"
           glib:type-struct="MarksClass">
      <doc xml:whitespace="preserve">All fields are private.</doc>
      <constructor name="new" c:identifier="visu_marks_new">
        <doc xml:whitespace="preserve">Create a new #VisuMarks object. Make it listen to
#VisuInteractive::node-selection signal to update itself
automatically.</doc>
        <return-value transfer-ownership="full">
          <doc xml:whitespace="preserve">the newly created object.</doc>
          <type name="Marks" c:type="VisuMarks*"/>
        </return-value>
      </constructor>
      <method name="exportXMLFile"
              c:identifier="visu_marks_exportXMLFile"
              version="3.5"
              throws="1">
        <doc xml:whitespace="preserve">This routines export to an XML file a description of selected
@nodes. If @nodes is NULL, the nodes stored in the @mark will be
used instead.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if no error.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="filename" transfer-ownership="none">
            <doc xml:whitespace="preserve">a location to save to.</doc>
            <type name="utf8" c:type="gchar*"/>
          </parameter>
          <parameter name="nodes" transfer-ownership="none">
            <doc xml:whitespace="preserve">an array of nodes, -1 terminated (can be NULL).</doc>
            <type name="gint" c:type="int*"/>
          </parameter>
          <parameter name="drawingMode" transfer-ownership="none">
            <doc xml:whitespace="preserve">a flag.</doc>
            <type name="GlExtInfosDrawId" c:type="VisuGlExtInfosDrawId"/>
          </parameter>
          <parameter name="drawingInfos" transfer-ownership="none">
            <doc xml:whitespace="preserve">a flag.</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
        </parameters>
      </method>
      <method name="getActive" c:identifier="visu_marks_getActive">
        <doc xml:whitespace="preserve">Retrieve if @nodeId is implied any measurement marks stored in @mark.

angle...).</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if @nodeId participate to any mark (distance,</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="nodeId" transfer-ownership="none">
            <doc xml:whitespace="preserve">a node id.</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
        </parameters>
      </method>
      <method name="getHighlightedList"
              c:identifier="visu_marks_getHighlightedList"
              version="3.6">
        <doc xml:whitespace="preserve">@marks has a list of mark for some nodes. These marks can be
highlight (or distance, angles...).

highlighted nodes (starting from 0), should freed with g_list_free().</doc>
        <return-value transfer-ownership="container">
          <doc xml:whitespace="preserve">list of</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="guint32"/>
          </type>
        </return-value>
      </method>
      <method name="getMeasurementLabels"
              c:identifier="visu_marks_getMeasurementLabels"
              version="3.6">
        <doc xml:whitespace="preserve">Exports as a string the ids of nodes for measurement marks.</doc>
        <return-value transfer-ownership="full">
          <doc xml:whitespace="preserve">a newly allocated string.</doc>
          <type name="utf8" c:type="gchar*"/>
        </return-value>
      </method>
      <method name="getMeasurementStrings"
              c:identifier="visu_marks_getMeasurementStrings"
              version="3.6">
        <doc xml:whitespace="preserve">Exports as a string all measurements stored in @marks.</doc>
        <return-value transfer-ownership="full">
          <doc xml:whitespace="preserve">a newly allocated string.</doc>
          <type name="utf8" c:type="gchar*"/>
        </return-value>
        <parameters>
          <parameter name="dataObj" transfer-ownership="none">
            <doc xml:whitespace="preserve">the #VisuData to apply the measurements to.</doc>
            <type name="Data" c:type="VisuData*"/>
          </parameter>
        </parameters>
      </method>
      <method name="parseXMLFile"
              c:identifier="visu_marks_parseXMLFile"
              version="3.5"
              introspectable="0"
              throws="1">
        <doc xml:whitespace="preserve">This routines read from an XML file the description of selected
nodes, @mark is updated accordingly.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if no error.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="filename" transfer-ownership="none">
            <doc xml:whitespace="preserve">a location to save to.</doc>
            <type name="utf8" c:type="gchar*"/>
          </parameter>
          <parameter name="infos" transfer-ownership="none">
            <doc xml:whitespace="preserve">a location to a #GList.</doc>
            <type name="GLib.List" c:type="GList**">
              <type name="gpointer" c:type="gpointer"/>
            </type>
          </parameter>
          <parameter name="drawingMode" transfer-ownership="none">
            <doc xml:whitespace="preserve">a location to a flag.</doc>
            <type name="GlExtInfosDrawId" c:type="VisuGlExtInfosDrawId*"/>
          </parameter>
          <parameter name="drawingInfos" transfer-ownership="none">
            <doc xml:whitespace="preserve">a location to a flag.</doc>
            <type name="guint" c:type="guint*"/>
          </parameter>
        </parameters>
      </method>
      <method name="removeMeasures" c:identifier="visu_marks_removeMeasures">
        <doc xml:whitespace="preserve">This routine scans the @mark to remove all marks of distance or
angle where @nodeId is implied in.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE is @mark is changed.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="nodeId" transfer-ownership="none">
            <doc xml:whitespace="preserve">a node id.</doc>
            <type name="gint" c:type="gint"/>
          </parameter>
        </parameters>
      </method>
      <method name="setDrawValues" c:identifier="visu_marks_setDrawValues">
        <doc xml:whitespace="preserve">Change if the measurements are printed or not (distance length, or
angles...).</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if @marks is modified.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="status" transfer-ownership="none">
            <doc xml:whitespace="preserve">a boolean.</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="setHighlightedList"
              c:identifier="visu_marks_setHighlightedList"
              version="3.6">
        <doc xml:whitespace="preserve">@marks has a list of mark for some nodes. These marks can be
highlight (or distance, angles...). Depending on @status values,
the mark may be switch on or off.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if redraw needed.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="lst" transfer-ownership="none">
            <doc xml:whitespace="preserve">a set of node ids (0 started) ;</doc>
            <type name="GLib.List" c:type="GList*">
              <type name="guint32"/>
            </type>
          </parameter>
          <parameter name="status" transfer-ownership="none">
            <doc xml:whitespace="preserve">changing command.</doc>
            <type name="MarksStatus" c:type="VisuMarksStatus"/>
          </parameter>
        </parameters>
      </method>
      <method name="setInfos" c:identifier="visu_marks_setInfos">
        <doc xml:whitespace="preserve">Depending on @status, it removes all measurements from @nodeId or
it calculate all first neighbour relations of @nodeId.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if @marks is changed.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="nodeId" transfer-ownership="none">
            <doc xml:whitespace="preserve">a node id.</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
          <parameter name="status" transfer-ownership="none">
            <doc xml:whitespace="preserve">a boolean.</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="setVisuData" c:identifier="visu_marks_setVisuData">
        <doc xml:whitespace="preserve">Attach the given @marks to @data. @marks will be updated if @data
is changed and internal list of marks is updated with the new nodes
of @data.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="data" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuData object.</doc>
            <type name="Data" c:type="VisuData*"/>
          </parameter>
        </parameters>
      </method>
      <glib:signal name="highlightChanged"
                   when="last"
                   no-recurse="1"
                   no-hooks="1"
                   version="3.6">
        <doc xml:whitespace="preserve">The list of highlighted nodes has been modified.</doc>
        <return-value transfer-ownership="none">
          <type name="none"/>
        </return-value>
        <parameters>
          <parameter name="lst" transfer-ownership="none">
            <doc xml:whitespace="preserve">a list of node ids (starting from 0).</doc>
            <type name="gpointer"/>
          </parameter>
        </parameters>
      </glib:signal>
      <glib:signal name="measurementChanged"
                   when="last"
                   no-recurse="1"
                   no-hooks="1"
                   version="3.6">
        <doc xml:whitespace="preserve">The list of measurements has been changed.</doc>
        <return-value transfer-ownership="none">
          <type name="none"/>
        </return-value>
      </glib:signal>
    </class>
    <record name="MarksClass"
            c:type="VisuMarksClass"
            disguised="1"
            glib:is-gtype-struct-for="Marks"
            version="3.6">
      <doc xml:whitespace="preserve">An opaque structure defining the class of a #VisuMarks objects.</doc>
    </record>
    <enumeration name="MarksStatus" version="3.6" c:type="VisuMarksStatus">
      <doc xml:whitespace="preserve">Possible parameters to change mark status, see
visu_marks_setHighlightedList() for instance.</doc>
      <member name="toggle" value="0" c:identifier="MARKS_STATUS_TOGGLE"/>
      <member name="set" value="1" c:identifier="MARKS_STATUS_SET"/>
      <member name="unset" value="2" c:identifier="MARKS_STATUS_UNSET"/>
    </enumeration>
    <enumeration name="MatrixScalingFlag"
                 version="3.4"
                 c:type="ToolMatrixScalingFlag">
      <doc xml:whitespace="preserve">Flag used to specify the transformation for scalarFieldDraw_map()
routine.</doc>
      <member name="inear" value="0" c:identifier="linear"/>
      <member name="ogarithm" value="1" c:identifier="logarithm"/>
      <member name="erocentredlog" value="2" c:identifier="zeroCentredLog"/>
      <member name="_scaleflag" value="3" c:identifier="n_scaleflag"/>
    </enumeration>
    <enumeration name="MatrixSphericalCoord"
                 version="3.6"
                 c:type="ToolMatrixSphericalCoord">
      <doc xml:whitespace="preserve">This is used to access the ordering of the vectors with
tool_matrix_cartesianToSpherical() or with
tool_matrix_sphericalToCartesian().</doc>
      <member name="modulus"
              value="0"
              c:identifier="TOOL_MATRIX_SPHERICAL_MODULUS"/>
      <member name="theta"
              value="1"
              c:identifier="TOOL_MATRIX_SPHERICAL_THETA"/>
      <member name="phi" value="2" c:identifier="TOOL_MATRIX_SPHERICAL_PHI"/>
    </enumeration>
    <record name="Node" c:type="VisuNode">
      <doc xml:whitespace="preserve">Structure to store primary data of a node.</doc>
      <field name="xyz" writable="1">
        <array zero-terminated="0" c:type="gfloat" fixed-size="3">
          <type name="gfloat" c:type="float"/>
        </array>
      </field>
      <field name="translation" writable="1">
        <array zero-terminated="0" c:type="gfloat" fixed-size="3">
          <type name="gfloat" c:type="float"/>
        </array>
      </field>
      <field name="number" writable="1">
        <type name="guint" c:type="unsigned"/>
      </field>
      <field name="posElement" writable="1">
        <type name="guint" c:type="unsigned"/>
      </field>
      <field name="posNode" writable="1">
        <type name="guint" c:type="unsigned"/>
      </field>
      <field name="rendered" writable="1">
        <type name="gboolean" c:type="gboolean"/>
      </field>
      <method name="copy" c:identifier="visu_node_copy">
        <doc xml:whitespace="preserve">Copy all attributes of the object @nodeFrom to @nodeTo.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="nodeFrom" transfer-ownership="none">
            <doc xml:whitespace="preserve">an allocated #VisuNode object.</doc>
            <type name="Node" c:type="VisuNode*"/>
          </parameter>
        </parameters>
      </method>
      <method name="getVisibility" c:identifier="visu_node_getVisibility">
        <doc xml:whitespace="preserve">This method is used get the status of the drawing state of a node.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">true if the node is rendered, false otherwise.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
      </method>
      <method name="newValues" c:identifier="visu_node_newValues">
        <doc xml:whitespace="preserve">Set the coordinates and set all other values to default.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="xyz" transfer-ownership="none">
            <doc xml:whitespace="preserve">the coordinates to set.</doc>
            <array zero-terminated="0" c:type="float" fixed-size="3">
              <type name="gfloat" c:type="float"/>
            </array>
          </parameter>
        </parameters>
      </method>
      <method name="setVisibility" c:identifier="visu_node_setVisibility">
        <doc xml:whitespace="preserve">This method is used to turn on or off the drawing of the specified node.

a call to the visu_data_createAllNodes() method.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">true if the calling method should recreate the node list with</doc>
          <type name="gint" c:type="int"/>
        </return-value>
        <parameters>
          <parameter name="visibility" transfer-ownership="none">
            <doc xml:whitespace="preserve">a boolean.</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
    </record>
    <record name="NodeArray" c:type="VisuNodeArray">
      <doc xml:whitespace="preserve">This structure describes a set of nodes of different #VisuElement types.
It is optimized for quick access, allocation and reallocation.</doc>
      <field name="ntype" writable="1">
        <type name="guint" c:type="unsigned"/>
      </field>
      <field name="idCounter" writable="1">
        <type name="guint" c:type="unsigned"/>
      </field>
      <field name="nodeTable" writable="1">
        <type name="Node" c:type="VisuNode**"/>
      </field>
      <field name="nodeTableSize" writable="1">
        <type name="guint" c:type="unsigned"/>
      </field>
      <field name="nNodes" writable="1">
        <type name="guint" c:type="unsigned"/>
      </field>
      <field name="nbOfAllStoredNodes" writable="1">
        <type name="guint" c:type="unsigned"/>
      </field>
      <field name="numberOfNodes" writable="1">
        <type name="guint" c:type="unsigned*"/>
      </field>
      <field name="numberOfStoredNodes" writable="1">
        <type name="guint" c:type="unsigned*"/>
      </field>
      <field name="nodes" writable="1">
        <type name="Node" c:type="VisuNode**"/>
      </field>
      <field name="properties" writable="1">
        <type name="GLib.HashTable" c:type="GHashTable*">
          <type name="gpointer" c:type="gpointer"/>
          <type name="gpointer" c:type="gpointer"/>
        </type>
      </field>
      <field name="origProp" writable="1">
        <type name="NodeProperty" c:type="VisuNodeProperty*"/>
      </field>
      <field name="nOrigNodes" writable="1">
        <type name="guint" c:type="guint"/>
      </field>
      <method name="allocateNewNodes"
              c:identifier="visu_node_array_allocateNewNodes">
        <doc xml:whitespace="preserve">When a new node is required, using visu_node_array_getNewNode() or visu_node_array_getCopyNode()
the storing arrays are expand automatically with a fixed increment. If the user
wants to control this increment, he should call this routine before the get() ones
with the appropriated @step value.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="iEle" transfer-ownership="none">
            <doc xml:whitespace="preserve">the id of a #VisuElement to expand the number of allocated nodes ;</doc>
            <type name="guint" c:type="unsigned int"/>
          </parameter>
          <parameter name="step" transfer-ownership="none">
            <doc xml:whitespace="preserve">the number of newly allocated nodes.</doc>
            <type name="guint" c:type="unsigned int"/>
          </parameter>
        </parameters>
      </method>
      <method name="freeNodes" c:identifier="visu_node_array_freeNodes">
        <doc xml:whitespace="preserve">Free the given object and all associated memory.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
      </method>
      <method name="freeProperty" c:identifier="visu_node_array_freeProperty">
        <doc xml:whitespace="preserve">This method free the given property and all associated data.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="key" transfer-ownership="none">
            <doc xml:whitespace="preserve">the name of the property to be removed.</doc>
            <type name="utf8" c:type="char*"/>
          </parameter>
        </parameters>
      </method>
      <method name="getCopyNode" c:identifier="visu_node_array_getCopyNode">
        <doc xml:whitespace="preserve">Return the location of an unstored node that is the deep copy of the given node.
The returned node is then added in the list of used nodes.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">the location of a newly used node.</doc>
          <type name="Node" c:type="VisuNode*"/>
        </return-value>
        <parameters>
          <parameter name="node" transfer-ownership="none">
            <doc xml:whitespace="preserve">a node of the given #VisuNodeArray.</doc>
            <type name="Node" c:type="VisuNode*"/>
          </parameter>
        </parameters>
      </method>
      <method name="getNewNode" c:identifier="visu_node_array_getNewNode">
        <doc xml:whitespace="preserve">Return the location of an unstored node for the given #VisuElement.
The returned node is then added in the list of used nodes.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">the location of a newly used node.</doc>
          <type name="Node" c:type="VisuNode*"/>
        </return-value>
        <parameters>
          <parameter name="iEle" transfer-ownership="none">
            <doc xml:whitespace="preserve">an integer between 0 and @nodeArray-&gt;ntypes - 1.</doc>
            <type name="guint" c:type="unsigned int"/>
          </parameter>
        </parameters>
      </method>
      <method name="getOriginal" c:identifier="visu_node_array_getOriginal">
        <doc xml:whitespace="preserve">Test if the given @nodeId is an original or a replica for the
periodisation.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE for an original node.</doc>
          <type name="gint" c:type="gint"/>
        </return-value>
        <parameters>
          <parameter name="nodeId" transfer-ownership="none">
            <doc xml:whitespace="preserve">a node id.</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
        </parameters>
      </method>
      <method name="getProperty" c:identifier="visu_node_array_getProperty">
        <doc xml:whitespace="preserve">This method is used to retrieve the node property associated to the given @key.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuNodeProperty.</doc>
          <type name="NodeProperty" c:type="VisuNodeProperty*"/>
        </return-value>
        <parameters>
          <parameter name="key" transfer-ownership="none">
            <doc xml:whitespace="preserve">a string.</doc>
            <type name="utf8" c:type="char*"/>
          </parameter>
        </parameters>
      </method>
      <method name="removeAllDuplicateNodes"
              c:identifier="visu_node_array_removeAllDuplicateNodes">
        <doc xml:whitespace="preserve">Remove all nodes that are not original in the box. The list of
removed nodes ids are stored in @nodeNumbers. This array is
allocated and should be freed with g_free(). If no nodes are
removed, this array is not allocated.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if some nodes have been removed (and @nodeNumbers allocated).</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="nodeNumbers" transfer-ownership="none">
            <doc xml:whitespace="preserve">a location to create an arry of int.</doc>
            <type name="gint" c:type="int**"/>
          </parameter>
        </parameters>
      </method>
      <method name="removeNodes" c:identifier="visu_node_array_removeNodes">
        <doc xml:whitespace="preserve">Remove the given #VisuNode from the @nodeArray. The properties
are also updated.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="nodeNumbers" transfer-ownership="none">
            <doc xml:whitespace="preserve">an array of integers (negative terminated).</doc>
            <array zero-terminated="0" c:type="int*">
              <type name="gint" c:type="int"/>
            </array>
          </parameter>
        </parameters>
      </method>
      <method name="setOriginal" c:identifier="visu_node_array_setOriginal">
        <doc xml:whitespace="preserve">Test if the given @nodeId is an original or a replica for the
periodisation.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE for an original node.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="nodeId" transfer-ownership="none">
            <doc xml:whitespace="preserve">a node id.</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
        </parameters>
      </method>
      <method name="switchNumber"
              c:identifier="visu_node_array_switchNumber"
              version="3.6">
        <doc xml:whitespace="preserve">Two nodes of @nodeArray switches their number.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if number is switched.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="from" transfer-ownership="none">
            <doc xml:whitespace="preserve">a node id.</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
          <parameter name="to" transfer-ownership="none">
            <doc xml:whitespace="preserve">another node id.</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
        </parameters>
      </method>
      <method name="traceProperty"
              c:identifier="visu_node_array_traceProperty">
        <doc xml:whitespace="preserve">This is a debug method. It outputs on stderr the values for all
nodes of the property @id.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="id" transfer-ownership="none">
            <doc xml:whitespace="preserve">a property name.</doc>
            <type name="utf8" c:type="gchar*"/>
          </parameter>
        </parameters>
      </method>
      <function name="newNodes" c:identifier="visu_node_array_newNodes">
        <doc xml:whitespace="preserve">Create a new #VisuNodeArray structure, allocate all necessary values.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">a newly created #VisuNodeArray object.</doc>
          <type name="NodeArray" c:type="VisuNodeArray*"/>
        </return-value>
        <parameters>
          <parameter name="nTypes" transfer-ownership="none">
            <doc xml:whitespace="preserve">the size of nNodes.</doc>
            <type name="guint" c:type="unsigned int"/>
          </parameter>
          <parameter name="nNodes" transfer-ownership="none">
            <doc xml:whitespace="preserve">an array giving the number of nodes per element.</doc>
            <array length="0" zero-terminated="0" c:type="unsigned int*">
              <type name="guint" c:type="unsigned int"/>
            </array>
          </parameter>
        </parameters>
      </function>
    </record>
    <record name="NodeInfo" c:type="VisuNodeInfo">
      <field name="id" writable="1">
        <type name="guint" c:type="guint"/>
      </field>
      <field name="dist" writable="1">
        <type name="gfloat" c:type="float"/>
      </field>
    </record>
    <record name="NodeInfo_struct" c:type="VisuNodeInfo_struct">
      <field name="id" writable="1">
        <type name="guint" c:type="guint"/>
      </field>
      <field name="dist" writable="1">
        <type name="gfloat" c:type="float"/>
      </field>
    </record>
    <record name="NodeProperty" c:type="VisuNodeProperty" disguised="1">
      <doc xml:whitespace="preserve">This structure defines a storage for one property for each node of a given
#VisuNodeArray. Use visu_node_property_newPointer() or
visu_node_property_newInteger() to create one property.</doc>
      <method name="getValue" c:identifier="visu_node_property_getValue">
        <doc xml:whitespace="preserve">This method is used to retrieve some data associated to
the specified @node, stored in the given @data. These return data
should not be freed after used. The read value is stored in the given
GValue pointer. This GValue must be of the right type, depending on the
creation of the #VisuNodeProperty.</doc>
        <return-value transfer-ownership="full">
          <doc xml:whitespace="preserve">some data associated to the key, stored the given GValue location.</doc>
          <type name="GObject.Value" c:type="GValue*"/>
        </return-value>
        <parameters>
          <parameter name="node" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuNode object ;</doc>
            <type name="Node" c:type="VisuNode*"/>
          </parameter>
          <parameter name="value" transfer-ownership="none">
            <doc xml:whitespace="preserve">an initialise GValue location.</doc>
            <type name="GObject.Value" c:type="GValue*"/>
          </parameter>
        </parameters>
      </method>
      <method name="setValue" c:identifier="visu_node_property_setValue">
        <doc xml:whitespace="preserve">This method is used to store some values associated with
the given @node of the given @nodeArray. These values can be pointers to
anything allocated (will be free automatically when the property is deleted) or
they can be static values. This depends on the construction of the node property.
These values can be retrieved with the visu_node_property_getValue() method.

See visu_node_array_getProperty() to get a property by its name.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="node" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuNode object ;</doc>
            <type name="Node" c:type="VisuNode*"/>
          </parameter>
          <parameter name="value" transfer-ownership="none">
            <doc xml:whitespace="preserve">A GValue pointer this the value to be stored.</doc>
            <type name="GObject.Value" c:type="GValue*"/>
          </parameter>
        </parameters>
      </method>
      <function name="newInteger" c:identifier="visu_node_property_newInteger">
        <doc xml:whitespace="preserve">This method creates and allocates a new area to store nodes associated integer
values. This is the same than visu_node_property_newPointer() but for static
integers instead of pointers as data.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">the newly created #VisuNodeProperty object.</doc>
          <type name="NodeProperty" c:type="VisuNodeProperty*"/>
        </return-value>
        <parameters>
          <parameter name="nodeArray" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuNodeArray object ;</doc>
            <type name="NodeArray" c:type="VisuNodeArray*"/>
          </parameter>
          <parameter name="key" transfer-ownership="none">
            <doc xml:whitespace="preserve">a string.</doc>
            <type name="utf8" c:type="char*"/>
          </parameter>
        </parameters>
      </function>
      <function name="newPointer"
                c:identifier="visu_node_property_newPointer"
                introspectable="0">
        <doc xml:whitespace="preserve">This method creates and allocates a new area to store nodes associated data that
can be retrieve with the @key. These data are pointers on allocated memory
locations. When the property is removed with the #visu_node_freePropertry (or the
associated #VisuNodeArray is free) the area is free and @freeFunc is called for
each token (or g_free() if @freeFunc is NULL).

The method @newAndCopyFunc is used when the number of nodes is increased,
if the const gpointer of the GCopyFunc is not NULL, then we require a copy,
if it is NULL, then the routine must create a new token with default values.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">the newly created #VisuNodeProperty object.</doc>
          <type name="NodeProperty" c:type="VisuNodeProperty*"/>
        </return-value>
        <parameters>
          <parameter name="nodeArray" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuNodeArray object ;</doc>
            <type name="NodeArray" c:type="VisuNodeArray*"/>
          </parameter>
          <parameter name="key" transfer-ownership="none">
            <doc xml:whitespace="preserve">a string ;</doc>
            <type name="utf8" c:type="char*"/>
          </parameter>
          <parameter name="freeFunc"
                     transfer-ownership="none"
                     allow-none="1"
                     scope="call">
            <doc xml:whitespace="preserve">a method to free each token (can be NULL).</doc>
            <type name="GLib.Func" c:type="GFunc"/>
          </parameter>
          <parameter name="newAndCopyFunc"
                     transfer-ownership="none"
                     scope="call"
                     closure="4">
            <doc xml:whitespace="preserve">a method to create or copy each token.</doc>
            <type name="GLib.CopyFunc" c:type="GCopyFunc"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:whitespace="preserve">a user defined pointer that will be given to the free and copy routine.</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </function>
    </record>
    <record name="Object" c:type="VisuObject" disguised="1">
      <doc xml:whitespace="preserve">A short way to identify #_VisuObject structure.</doc>
      <method name="getRendering"
              c:identifier="visu_object_getRendering"
              introspectable="0">
        <return-value>
          <type name="Rendering" c:type="VisuRendering*"/>
        </return-value>
      </method>
      <method name="setRendering" c:identifier="visu_object_setRendering">
        <return-value transfer-ownership="none">
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="method" transfer-ownership="none">
            <type name="Rendering" c:type="VisuRendering*"/>
          </parameter>
        </parameters>
      </method>
      <function name="redraw" c:identifier="visu_object_redraw">
        <return-value transfer-ownership="none">
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="data" transfer-ownership="none">
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </function>
      <function name="redrawForce" c:identifier="visu_object_redrawForce">
        <return-value transfer-ownership="none">
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="data" transfer-ownership="none">
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </function>
    </record>
    <record name="OpenGLCamera" c:type="VisuOpenGLCamera">
      <doc xml:whitespace="preserve">Values to define the position of the observer.</doc>
      <field name="d_red" writable="1">
        <type name="gdouble" c:type="double"/>
      </field>
      <field name="theta" writable="1">
        <type name="gdouble" c:type="double"/>
      </field>
      <field name="phi" writable="1">
        <type name="gdouble" c:type="double"/>
      </field>
      <field name="omega" writable="1">
        <type name="gdouble" c:type="double"/>
      </field>
      <field name="xs" writable="1">
        <type name="gdouble" c:type="double"/>
      </field>
      <field name="ys" writable="1">
        <type name="gdouble" c:type="double"/>
      </field>
      <field name="gross" writable="1">
        <type name="gdouble" c:type="double"/>
      </field>
      <field name="length0" writable="1">
        <type name="gdouble" c:type="double"/>
      </field>
      <field name="unit" introspectable="0" writable="1">
        <type c:type="ToolUnits"/>
      </field>
      <field name="up" writable="1">
        <array zero-terminated="0" c:type="gdouble" fixed-size="3">
          <type name="gdouble" c:type="double"/>
        </array>
      </field>
      <field name="upAxis" introspectable="0" writable="1">
        <type c:type="ViewAxis"/>
      </field>
      <field name="centre" writable="1">
        <array zero-terminated="0" c:type="gdouble" fixed-size="3">
          <type name="gdouble" c:type="double"/>
        </array>
      </field>
      <field name="eye" writable="1">
        <array zero-terminated="0" c:type="gdouble" fixed-size="3">
          <type name="gdouble" c:type="double"/>
        </array>
      </field>
    </record>
    <record name="OpenGLView" c:type="VisuOpenGLView">
      <doc xml:whitespace="preserve">A container structure to deal with OpenGL observer position, size of rendering
viewport...</doc>
      <field name="camera" writable="1">
        <type name="OpenGLCamera" c:type="VisuOpenGLCamera*"/>
      </field>
      <field name="window" introspectable="0" writable="1">
        <type c:type="OpenGLWindow*"/>
      </field>
    </record>
    <record name="Option" c:type="ToolOption" disguised="1">
      <doc xml:whitespace="preserve">An opaque structure to store values. It is equivalent to #GValue
but with a name and a label.</doc>
      <method name="copy" c:identifier="tool_option_copy">
        <doc xml:whitespace="preserve">Create a new #ToolOption using the values from option @from.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">a newly created option, use tool_option_free() to free it.</doc>
          <type name="Option" c:type="ToolOption*"/>
        </return-value>
      </method>
      <method name="getLabel" c:identifier="tool_option_getLabel">
        <doc xml:whitespace="preserve">Get the label of the option.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">a string owned by V_Sim, should not be freed.</doc>
          <type name="utf8" c:type="gchar*"/>
        </return-value>
      </method>
      <method name="getName" c:identifier="tool_option_getName">
        <doc xml:whitespace="preserve">Get the name of the option.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">a string owned by V_Sim, should not be freed.</doc>
          <type name="utf8" c:type="gchar*"/>
        </return-value>
      </method>
      <method name="getType" c:identifier="tool_option_getType">
        <doc xml:whitespace="preserve">Get the type of the option.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">a #OptionTypes value.</doc>
          <type name="GType" c:type="GType"/>
        </return-value>
      </method>
      <method name="getValue" c:identifier="tool_option_getValue">
        <doc xml:whitespace="preserve">Get the location of the storage for the option.</doc>
        <return-value transfer-ownership="full">
          <doc xml:whitespace="preserve">the #GValue storing the option value.</doc>
          <type name="GObject.Value" c:type="GValue*"/>
        </return-value>
      </method>
      <method name="getValueAndLabel"
              c:identifier="tool_option_getValueAndLabel">
        <doc xml:whitespace="preserve">This method returns a string with the value followed by the label in parenthesis
and with Pango markup for smaller font.</doc>
        <return-value transfer-ownership="full">
          <doc xml:whitespace="preserve">a newly created markup string.</doc>
          <type name="utf8" c:type="gchar*"/>
        </return-value>
      </method>
      <function name="free" c:identifier="tool_option_free">
        <doc xml:whitespace="preserve">Free the memory used by the @data.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="data" transfer-ownership="none">
            <doc xml:whitespace="preserve">the #Option to free.</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </function>
      <function name="new" c:identifier="tool_option_new">
        <doc xml:whitespace="preserve">Create a new #Option using the name as identifier.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">a newly created option, use tool_option_free() to free it.</doc>
          <type name="Option" c:type="ToolOption*"/>
        </return-value>
        <parameters>
          <parameter name="name" transfer-ownership="none">
            <doc xml:whitespace="preserve">a string identifying the option ;</doc>
            <type name="utf8" c:type="gchar*"/>
          </parameter>
          <parameter name="label" transfer-ownership="none">
            <doc xml:whitespace="preserve">a string describing shortly the option (must be in UTF-8).</doc>
            <type name="utf8" c:type="gchar*"/>
          </parameter>
          <parameter name="g_type" transfer-ownership="none">
            <doc xml:whitespace="preserve">the type of option to create.</doc>
            <type name="GType" c:type="GType"/>
          </parameter>
        </parameters>
      </function>
    </record>
    <record name="PixmapContext" c:type="VisuPixmapContext" disguised="1">
      <doc xml:whitespace="preserve">Short way to address #VisuPixmapContext_struct objects.</doc>
      <method name="free" c:identifier="visu_pixmap_context_free">
        <doc xml:whitespace="preserve">Free an allocated #DumpImage.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
      </method>
      <function name="new" c:identifier="visu_pixmap_context_new">
        <doc xml:whitespace="preserve">Create a pixmap storage and a context associated to it. This pixmap
can then be used to dump pixel data from an OpenGL area.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">a newly allocated #DumpImage object.</doc>
          <type name="PixmapContext" c:type="VisuPixmapContext*"/>
        </return-value>
        <parameters>
          <parameter name="width" transfer-ownership="none">
            <doc xml:whitespace="preserve">an integer ;</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
          <parameter name="height" transfer-ownership="none">
            <doc xml:whitespace="preserve">an integer.</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
        </parameters>
      </function>
    </record>
    <constant name="RENDERING_ATOMIC_NAME"
              value="Atom visualisation"
              c:type="VISU_RENDERING_ATOMIC_NAME">
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <class name="Rendering"
           c:symbol-prefix="rendering"
           parent="GObject.Object"
           glib:type-name="VisuRendering"
           glib:get-type="visu_rendering_get_type">
      <doc xml:whitespace="preserve">This structure is used to describe a rendering method. Besides
names, representing icon... this structure stores pointers to
method technically used to draw elements with this method.</doc>
      <function name="getAllObjects"
                c:identifier="visu_rendering_getAllObjects"
                introspectable="0">
        <doc xml:whitespace="preserve">This method gives a GList with pointers to each rendering method.
Warning : the returned GList is not a copy, it must not be modified,
just read.</doc>
        <return-value>
          <doc xml:whitespace="preserve">A GList containing all the registered rendering methods.</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="gpointer" c:type="gpointer"/>
          </type>
        </return-value>
      </function>
      <function name="getByName"
                c:identifier="visu_rendering_getByName"
                version="3.6">
        <doc xml:whitespace="preserve">Get the corresponding #VisuRendering method to @name.</doc>
        <return-value transfer-ownership="none">
          <type name="Rendering" c:type="VisuRendering*"/>
        </return-value>
        <parameters>
          <parameter name="name" transfer-ownership="none">
            <doc xml:whitespace="preserve">a string.</doc>
            <type name="filename" c:type="gchar*"/>
          </parameter>
        </parameters>
      </function>
      <method name="addFileFormat" c:identifier="visu_rendering_addFileFormat">
        <doc xml:whitespace="preserve">Add a file format descriptor to the list of already known file formats
of the key @fileType.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="fileType" transfer-ownership="none">
            <doc xml:whitespace="preserve">an integer used as a key, must &gt;= 0 and &lt; method-&gt;nFiles.</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
          <parameter name="fmt" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #ToolFileFormat ;</doc>
            <type name="FileFormat" c:type="ToolFileFormat*"/>
          </parameter>
          <parameter name="priority" transfer-ownership="none">
            <doc xml:whitespace="preserve">the priority (lower sooner) ;</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
          <parameter name="loadFunc"
                     transfer-ownership="none"
                     scope="notified"
                     destroy="4">
            <doc xml:whitespace="preserve">the loading routine ;</doc>
            <type name="RenderingLoadFormatFunc"
                  c:type="VisuRenderingLoadFormatFunc"/>
          </parameter>
          <parameter name="notify" transfer-ownership="none" scope="async">
            <doc xml:whitespace="preserve">not used.</doc>
            <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
          </parameter>
        </parameters>
      </method>
      <method name="createElement"
              c:identifier="visu_rendering_createElement"
              version="3.6">
        <doc xml:whitespace="preserve">Use the create element function of @method to render @element for
the given zoom level.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">the OpenGL list id of this element.</doc>
          <type name="gint" c:type="int"/>
        </return-value>
        <parameters>
          <parameter name="element" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuElement object.</doc>
            <type name="Element" c:type="VisuElement*"/>
          </parameter>
          <parameter name="camera" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuOpenGLCamera object.</doc>
            <type name="OpenGLCamera" c:type="VisuOpenGLCamera*"/>
          </parameter>
          <parameter name="winSize" transfer-ownership="none">
            <doc xml:whitespace="preserve">the window size.</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
        </parameters>
      </method>
      <method name="createNode"
              c:identifier="visu_rendering_createNode"
              version="3.6">
        <doc xml:whitespace="preserve">Create @node at the right position calling OpenGL routines.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="data" transfer-ownership="none">
            <doc xml:whitespace="preserve">the #VisuData object the @node is taken from.</doc>
            <type name="Data" c:type="VisuData*"/>
          </parameter>
          <parameter name="node" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuNode of @data.</doc>
            <type name="Node" c:type="VisuNode*"/>
          </parameter>
          <parameter name="ele" transfer-ownership="none">
            <doc xml:whitespace="preserve">the #VisuElement of @node.</doc>
            <type name="Element" c:type="VisuElement*"/>
          </parameter>
        </parameters>
      </method>
      <method name="getDescription"
              c:identifier="visu_rendering_getDescription">
        <doc xml:whitespace="preserve">Get its description (in UTF8).</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">a string, owned by V_Sim.</doc>
          <type name="utf8" c:type="gchar*"/>
        </return-value>
      </method>
      <method name="getFileFormat"
              c:identifier="visu_rendering_getFileFormat"
              version="3.6">
        <doc xml:whitespace="preserve">This method is used to get the file formats associated to a kind of input file
handled by the rendering method.

GList* with the #ToolFileFormat. This GList should been considered
read-only.</doc>
        <return-value transfer-ownership="container">
          <doc xml:whitespace="preserve">a</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="FileFormat"/>
          </type>
        </return-value>
        <parameters>
          <parameter name="fileType" transfer-ownership="none">
            <doc xml:whitespace="preserve">the file kind of filee format to get from.</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
        </parameters>
      </method>
      <method name="getFileTypeName"
              c:identifier="visu_rendering_getFileTypeName">
        <doc xml:whitespace="preserve">This method is used to get the name associated to a kind of input file
handled by the rendering method.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">a string own by V_Sim. This string should been considered read-only.</doc>
          <type name="utf8" c:type="gchar*"/>
        </return-value>
        <parameters>
          <parameter name="fileType" transfer-ownership="none">
            <doc xml:whitespace="preserve">an integer used as a key, must &gt;= 0 and &lt; method-&gt;priv-&gt;nFiles.</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
        </parameters>
      </method>
      <method name="getIconPath" c:identifier="visu_rendering_getIconPath">
        <doc xml:whitespace="preserve">Get the location where to find the icon of the method.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">a string, owned by V_Sim.</doc>
          <type name="utf8" c:type="gchar*"/>
        </return-value>
      </method>
      <method name="getNFileTypes" c:identifier="visu_rendering_getNFileTypes">
        <doc xml:whitespace="preserve">This method is used to get the number of kind of files needed to
render a set of data.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">how many kind of files are handled by the given VisuRendering.</doc>
          <type name="guint" c:type="guint"/>
        </return-value>
      </method>
      <method name="getName" c:identifier="visu_rendering_getName">
        <doc xml:whitespace="preserve">Get its name (in @UTF8 or not).</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">a string, owned by V_Sim.</doc>
          <type name="utf8" c:type="gchar*"/>
        </return-value>
        <parameters>
          <parameter name="UTF8" transfer-ownership="none">
            <doc xml:whitespace="preserve">a boolean.</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="getSizeOfElement"
              c:identifier="visu_rendering_getSizeOfElement">
        <doc xml:whitespace="preserve">This method is used to retrieve the radius of the sphere that contains
the @ele.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">the radius of the given element.</doc>
          <type name="gfloat" c:type="float"/>
        </return-value>
        <parameters>
          <parameter name="ele" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuElement to get the size of.</doc>
            <type name="Element" c:type="VisuElement*"/>
          </parameter>
        </parameters>
      </method>
      <method name="load" c:identifier="visu_rendering_load" throws="1">
        <doc xml:whitespace="preserve">Call the load routine of @method. Filenames to read from should
have been set to @data using visu_data_addFile(). If @format is
NULL, an automatic detection is used, trying all available file
formats.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE on success.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="data" transfer-ownership="none">
            <doc xml:whitespace="preserve">a new #VisuData object to load into.</doc>
            <type name="Data" c:type="VisuData*"/>
          </parameter>
          <parameter name="format" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #ToolFileFormat to read input files from (can be NULL).</doc>
            <type name="FileFormat" c:type="ToolFileFormat*"/>
          </parameter>
          <parameter name="nSet" transfer-ownership="none">
            <doc xml:whitespace="preserve">the set id to read from.</doc>
            <type name="gint" c:type="int"/>
          </parameter>
        </parameters>
      </method>
      <method name="setFileFormat"
              c:identifier="visu_rendering_setFileFormat"
              version="3.6">
        <doc xml:whitespace="preserve">It copies the #ToolFileFormat of method @from to @meth for the
given @fileType.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="fileType" transfer-ownership="none">
            <doc xml:whitespace="preserve">a file kind id.</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
          <parameter name="from" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuRendering object.</doc>
            <type name="Rendering" c:type="VisuRendering*"/>
          </parameter>
        </parameters>
      </method>
      <method name="setFileTypeLabel"
              c:identifier="visu_rendering_setFileTypeLabel">
        <doc xml:whitespace="preserve">Store a list of #ToolFileFormat for the kind of file @fileType. The @name
argument is copied. but warning, the @fileTypeList GList* is not copied.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="fileType" transfer-ownership="none">
            <doc xml:whitespace="preserve">an integer used as a key, must &gt;= 0 and &lt; method-&gt;nFiles ;</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
          <parameter name="name" transfer-ownership="none">
            <doc xml:whitespace="preserve">a string to shortly describe the kind of file type (not NULL).</doc>
            <type name="utf8" c:type="gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="setIcon" c:identifier="visu_rendering_setIcon">
        <doc xml:whitespace="preserve">This method is used to set the path to an icon for the specified method.
The path is copied, and the given name can be freed freely after a call to
this method.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="path" transfer-ownership="none">
            <doc xml:whitespace="preserve">a path to an image file.</doc>
            <type name="utf8" c:type="gchar*"/>
          </parameter>
        </parameters>
      </method>
      <property name="description" writable="1" transfer-ownership="none">
        <type name="utf8"/>
      </property>
      <property name="label" writable="1" transfer-ownership="none">
        <type name="utf8"/>
      </property>
      <property name="nFiles"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <type name="guint"/>
      </property>
      <property name="name"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <type name="utf8"/>
      </property>
      <glib:signal name="elementSizeChanged"
                   when="last"
                   no-recurse="1"
                   version="3.6">
        <doc xml:whitespace="preserve">Emitted when the size of a element is changed.</doc>
        <return-value transfer-ownership="none">
          <type name="none"/>
        </return-value>
        <parameters>
          <parameter name="size" transfer-ownership="none">
            <doc xml:whitespace="preserve">the new size.</doc>
            <type name="gfloat"/>
          </parameter>
        </parameters>
      </glib:signal>
      <glib:signal name="fileTypeChanged"
                   when="last"
                   no-recurse="1"
                   no-hooks="1"
                   version="3.6">
        <doc xml:whitespace="preserve">TODO</doc>
        <return-value transfer-ownership="none">
          <type name="none"/>
        </return-value>
      </glib:signal>
    </class>
    <class name="RenderingAtomic"
           c:symbol-prefix="rendering_atomic"
           c:type="VisuRenderingAtomic"
           parent="Rendering"
           glib:type-name="VisuRenderingAtomic"
           glib:get-type="visu_rendering_atomic_get_type"
           glib:type-struct="RenderingAtomicClass">
      <doc xml:whitespace="preserve">An opaque structure.</doc>
      <constructor name="new"
                   c:identifier="visu_rendering_atomic_new"
                   version="3.6">
        <doc xml:whitespace="preserve">Create the structure and initialise its values.</doc>
        <return-value transfer-ownership="full">
          <doc xml:whitespace="preserve">a newly allocate #VisuRenderingAtomic object.</doc>
          <type name="RenderingAtomic" c:type="VisuRenderingAtomic*"/>
        </return-value>
      </constructor>
    </class>
    <record name="RenderingAtomicClass"
            c:type="VisuRenderingAtomicClass"
            disguised="1"
            glib:is-gtype-struct-for="RenderingAtomic">
      <doc xml:whitespace="preserve">An opaque structure.</doc>
    </record>
    <callback name="RenderingCreateElementFunc"
              c:type="VisuRenderingCreateElementFunc">
      <doc xml:whitespace="preserve">Such functions are called whenever a newElement is registered.

has been created.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">an id representing an OpenGL list in which the element</doc>
        <type name="gint" c:type="int"/>
      </return-value>
      <parameters>
        <parameter name="ele" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuElement object ;</doc>
          <type name="Element" c:type="VisuElement*"/>
        </parameter>
        <parameter name="camera" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuOpenGLCamera object ;</doc>
          <type name="OpenGLCamera" c:type="VisuOpenGLCamera*"/>
        </parameter>
        <parameter name="winSize" transfer-ownership="none">
          <doc xml:whitespace="preserve">the minimum size of the rendering area.</doc>
          <type name="guint" c:type="guint"/>
        </parameter>
      </parameters>
    </callback>
    <callback name="RenderingCreateNodeFunc"
              c:type="VisuRenderingCreateNodeFunc">
      <doc xml:whitespace="preserve">Such functions are called when the OpenGl list of all the nodes is created.
The @ele parameter is the #VisuElement of the given @node and the @visuData one
points to the #VisuData object that contains this node.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="visuData" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuData object ;</doc>
          <type name="Data" c:type="VisuData*"/>
        </parameter>
        <parameter name="node" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuElement ;</doc>
          <type name="Node" c:type="VisuNode*"/>
        </parameter>
        <parameter name="ele" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuElement.</doc>
          <type name="Element" c:type="VisuElement*"/>
        </parameter>
      </parameters>
    </callback>
    <callback name="RenderingGetNodeExtendFunc"
              c:type="VisuRenderingGetNodeExtendFunc">
      <doc xml:whitespace="preserve">This function is required to inform the OpenGL drawer
and to adapt the maximum size of the drawing area.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">the geometrical size of the element.</doc>
        <type name="gfloat" c:type="float"/>
      </return-value>
      <parameters>
        <parameter name="ele" transfer-ownership="none">
          <doc xml:whitespace="preserve">a @VisuElement.</doc>
          <type name="Element" c:type="VisuElement*"/>
        </parameter>
      </parameters>
    </callback>
    <callback name="RenderingLoadFormatFunc"
              c:type="VisuRenderingLoadFormatFunc"
              throws="1">
      <doc xml:whitespace="preserve">This is an interface for a generic load method. This method read the file
positionned on @filename and populate or change the arrays in
@data. When enter this method, the @data argument is already
allocated but its arrays may be empty and unallocated (depending on
context). If the load method fails (because the format is wrong or
anything else), the @data argument should not be modified. If some
errors occur, the pointer @error will be instanciated. A
#VisuRendering can have several #VisuRenderingLoadFormatFunc methods
for each format they support. The @nSet argument is used to load a
specific set of nodes if the input format supports it. If @nSet is
0, then the default set of nodes is loaded.

some minor errors have happened).</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">FALSE if @data is unchanged (wrong format), TRUE otherwise (even if</doc>
        <type name="gboolean" c:type="gboolean"/>
      </return-value>
      <parameters>
        <parameter name="data" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuData object ;</doc>
          <type name="Data" c:type="VisuData*"/>
        </parameter>
        <parameter name="filename" transfer-ownership="none">
          <doc xml:whitespace="preserve">the access to the file to load ;</doc>
          <type name="utf8" c:type="gchar*"/>
        </parameter>
        <parameter name="format" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #ToolFileFormat object (can be NULL) ;</doc>
          <type name="FileFormat" c:type="ToolFileFormat*"/>
        </parameter>
        <parameter name="nSet" transfer-ownership="none">
          <doc xml:whitespace="preserve">an integer ;</doc>
          <type name="gint" c:type="int"/>
        </parameter>
      </parameters>
    </callback>
    <enumeration name="RenderingModeId" c:type="VisuRenderingModeId">
      <doc xml:whitespace="preserve">Implemented mode to draw objects.</doc>
      <member name="ireframe" value="0" c:identifier="Wireframe"/>
      <member name="lat" value="1" c:identifier="Flat"/>
      <member name="mooth" value="2" c:identifier="Smooth"/>
      <member name="moothandedge" value="3" c:identifier="SmoothAndEdge"/>
      <member name="b_renderingmodes"
              value="4"
              c:identifier="nb_renderingModes"/>
      <member name="ollowgeneralsetting"
              value="5"
              c:identifier="followGeneralSetting"/>
    </enumeration>
    <record name="RenderingPriv"
            c:type="VisuRenderingPriv"
            disguised="1"
            version="3.6">
      <doc xml:whitespace="preserve">An opaque structure.</doc>
    </record>
    <class name="RenderingWindow"
           c:symbol-prefix="rendering_window"
           c:type="VisuRenderingWindow"
           parent="Gtk.VBox"
           glib:type-name="VisuRenderingWindow"
           glib:get-type="visu_rendering_window_get_type"
           glib:type-struct="RenderingWindowClass">
      <doc xml:whitespace="preserve">Short form for a #VisuRenderingWindow_struct structure.</doc>
      <implements name="Atk.ImplementorIface"/>
      <implements name="Gtk.Buildable"/>
      <implements name="Gtk.Orientable"/>
      <constructor name="new" c:identifier="visu_rendering_window_new">
        <doc xml:whitespace="preserve">A #VisuRenderingWindow widget is a GtkWindow that have an area for
OpenGL drawing and a statusBar with many stuff like action buttons,
real status bar for notifications, ... The rendering area can be
drawn with a frame or not. With this routine, only the
#VisuRenderingWindow widget is created. To embed it into a window
automatically, use visu_rendering_window_newEmbedded() instead.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">a newly created #VisuRenderingWindow widget.</doc>
          <type name="Gtk.Widget" c:type="GtkWidget*"/>
        </return-value>
        <parameters>
          <parameter name="width" transfer-ownership="none">
            <doc xml:whitespace="preserve">its desired width ;</doc>
            <type name="gint" c:type="int"/>
          </parameter>
          <parameter name="height" transfer-ownership="none">
            <doc xml:whitespace="preserve">its desired height ;</doc>
            <type name="gint" c:type="int"/>
          </parameter>
          <parameter name="withFrame" transfer-ownership="none">
            <doc xml:whitespace="preserve">a boolean ;</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
          <parameter name="withToolBar" transfer-ownership="none">
            <doc xml:whitespace="preserve">a boolean.</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </constructor>
      <function name="getAutoAdjust"
                c:identifier="visu_rendering_window_getAutoAdjust"
                version="3.6">
        <doc xml:whitespace="preserve">The camera can be set to auto adjust its zoom capability for the data to be
full size at zoom level 1.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if the camera auto adjust on data loading.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
      </function>
      <function name="getDisplayCoordinatesInReduce"
                c:identifier="visu_rendering_window_getDisplayCoordinatesInReduce"
                version="3.6">
        <doc xml:whitespace="preserve">Picked nodes have their coordinates displayed in the status bar of the rendering
window. This methods retrieves if they are printed in reduced values or not.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if the coordinates are displayed in reduced values.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
      </function>
      <function name="newEmbedded"
                c:identifier="visu_rendering_window_newEmbedded">
        <doc xml:whitespace="preserve">Like visu_rendering_window_new() but create also a #GtkWindow to go
around. This widget is reachable using g_object_get_data() with the
key #RENDERING_WINDOW_ID. In that case, no frame is drawn around
the rendering area.</doc>
        <return-value transfer-ownership="full">
          <doc xml:whitespace="preserve">a newly created #VisuRenderingWindow widget.</doc>
          <type name="Gtk.Widget" c:type="GtkWidget*"/>
        </return-value>
        <parameters>
          <parameter name="width" transfer-ownership="none">
            <doc xml:whitespace="preserve">its desired width ;</doc>
            <type name="gint" c:type="int"/>
          </parameter>
          <parameter name="height" transfer-ownership="none">
            <doc xml:whitespace="preserve">its desired height.</doc>
            <type name="gint" c:type="int"/>
          </parameter>
        </parameters>
      </function>
      <function name="setAutoAdjust"
                c:identifier="visu_rendering_window_setAutoAdjust"
                version="3.6">
        <doc xml:whitespace="preserve">If set, the camera auto adjust its zoom capability for the data to be
full size at zoom level 1.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if the value has been changed.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="status" transfer-ownership="none">
            <doc xml:whitespace="preserve">a boolean.</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </function>
      <function name="setDisplayCoordinatesInReduce"
                c:identifier="visu_rendering_window_setDisplayCoordinatesInReduce"
                version="3.6">
        <doc xml:whitespace="preserve">If set, the coordinates of picked nodes are displayed in reduced values.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if the value has been changed.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="status" transfer-ownership="none">
            <doc xml:whitespace="preserve">a boolean.</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </function>
      <method name="dump" c:identifier="visu_rendering_window_dump">
        <doc xml:whitespace="preserve">Call this method to dump the given @window to a file.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">TRUE if everything went right.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="format" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuDump object, corresponding to the write method ;</doc>
            <type name="Dump" c:type="VisuDump*"/>
          </parameter>
          <parameter name="fileName" transfer-ownership="none">
            <doc xml:whitespace="preserve">a string that defined the file to write to ;</doc>
            <type name="utf8" c:type="char*"/>
          </parameter>
          <parameter name="width" transfer-ownership="none">
            <doc xml:whitespace="preserve">an integer ;</doc>
            <type name="gint" c:type="gint"/>
          </parameter>
          <parameter name="height" transfer-ownership="none">
            <doc xml:whitespace="preserve">an integer ;</doc>
            <type name="gint" c:type="gint"/>
          </parameter>
          <parameter name="error" transfer-ownership="none" allow-none="1">
            <doc xml:whitespace="preserve">a location to store some error (not NULL) ;</doc>
            <type name="GLib.Error" c:type="GError**"/>
          </parameter>
          <parameter name="functionWait"
                     transfer-ownership="none"
                     allow-none="1"
                     scope="call"
                     closure="6">
            <doc xml:whitespace="preserve">a method to call periodically during the dump ;</doc>
            <type name="VoidDataFunc" c:type="ToolVoidDataFunc"/>
          </parameter>
          <parameter name="data" transfer-ownership="none">
            <doc xml:whitespace="preserve">some pointer on object to be passed to the wait function.</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="getMarks"
              c:identifier="visu_rendering_window_getMarks"
              version="3.6">
        <doc xml:whitespace="preserve">Get the #VisuMarks of the given @window.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuMarks object owned by V_Sim.</doc>
          <type name="Marks" c:type="VisuMarks*"/>
        </return-value>
      </method>
      <method name="getVisuData"
              c:identifier="visu_rendering_window_getVisuData">
        <doc xml:whitespace="preserve">This method is used to get the #VisuData attached to a window.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">the #VisuData attached to the @window or NULL if none.</doc>
          <type name="Data" c:type="VisuData*"/>
        </return-value>
      </method>
      <method name="loadFile" c:identifier="visu_rendering_window_loadFile">
        <doc xml:whitespace="preserve">This method calls the general function to load data from file
and deals with errors with gtkDialogs. The filenames must have
already been set into @data using visu_data_addFile().</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="data" transfer-ownership="none">
            <doc xml:whitespace="preserve">the #VisuData to be loaded.</doc>
            <type name="Data" c:type="VisuData*"/>
          </parameter>
          <parameter name="iSet" transfer-ownership="none">
            <doc xml:whitespace="preserve">the id of @data to load.</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
        </parameters>
      </method>
      <method name="setData" c:identifier="visu_rendering_window_setData">
        <doc xml:whitespace="preserve">This method is used to attach a #VisuData object to a given window.
When, @data is not NULL, this method emit the dataReadyForRendering signal,
and all modules that needs to draw something should catch this signal and
draw in the rendering window. If @data is NULL, the dataNotReadyForRendering
is emitted instead.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="data" transfer-ownership="none">
            <doc xml:whitespace="preserve">a #VisuData to render in the given @window (can be NULL).</doc>
            <type name="Data" c:type="VisuData*"/>
          </parameter>
        </parameters>
      </method>
      <glib:signal name="export" when="last" action="1" version="3.6">
        <doc xml:whitespace="preserve">Signal emitted when the user ask for data export.</doc>
        <return-value transfer-ownership="none">
          <type name="none"/>
        </return-value>
      </glib:signal>
      <glib:signal name="open" when="last" action="1" version="3.6">
        <doc xml:whitespace="preserve">Signal emitted when the user ask to open new data.</doc>
        <return-value transfer-ownership="none">
          <type name="none"/>
        </return-value>
      </glib:signal>
      <glib:signal name="reload" when="last" action="1" version="3.6">
        <doc xml:whitespace="preserve">Signal emitted when the user ask to reload current data.</doc>
        <return-value transfer-ownership="none">
          <type name="none"/>
        </return-value>
      </glib:signal>
      <glib:signal name="show-action-dialog"
                   when="last"
                   no-recurse="1"
                   action="1"
                   no-hooks="1"
                   version="3.6">
        <doc xml:whitespace="preserve">Signal emitted when the user ask to show the action dialog.</doc>
        <return-value transfer-ownership="none">
          <type name="none"/>
        </return-value>
      </glib:signal>
      <glib:signal name="show-main-panel"
                   when="last"
                   no-recurse="1"
                   action="1"
                   no-hooks="1"
                   version="3.6">
        <doc xml:whitespace="preserve">Signal emitted when the user ask to raise the main panel.</doc>
        <return-value transfer-ownership="none">
          <type name="none"/>
        </return-value>
      </glib:signal>
    </class>
    <record name="RenderingWindowClass"
            c:type="VisuRenderingWindowClass"
            disguised="1"
            glib:is-gtype-struct-for="RenderingWindow">
      <doc xml:whitespace="preserve">Short form for a #VisuRenderingWindowClass_struct structure.</doc>
    </record>
    <callback name="ToolsInitFunc" c:type="VisuToolsInitFunc">
      <doc xml:whitespace="preserve">These methods are used by V_Sim to initialise some part of the
program. They are called once on start-up.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
    </callback>
    <class name="UiMain"
           c:symbol-prefix="ui_main"
           parent="Gtk.Window"
           glib:type-name="VisuUiMain"
           glib:get-type="visu_ui_main_get_type"
           glib:type-struct="UiMainClass">
      <doc xml:whitespace="preserve">This structure describes a #VisuUiMain object.</doc>
      <implements name="Atk.ImplementorIface"/>
      <implements name="Gtk.Buildable"/>
      <constructor name="new" c:identifier="visu_ui_main_new">
        <doc xml:whitespace="preserve">Create the command panel window and is dependencies, such as the
associated rendering window... WARNING: some part are still currently
static, so only once instance can be created at a time. If
@oneWindow argument is TRUE, then the rendering area is creating in
the same #GtkWindow on the right of the panel.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">a newly create command panel.</doc>
          <type name="Gtk.Widget" c:type="GtkWidget*"/>
        </return-value>
        <parameters>
          <parameter name="oneWindow" transfer-ownership="none">
            <doc xml:whitespace="preserve">a boolean.</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </constructor>
      <function name="initPanels" c:identifier="visu_ui_main_initPanels">
        <doc xml:whitespace="preserve">Call the init routines for the different panels.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">always FALSE.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="data" transfer-ownership="none">
            <doc xml:whitespace="preserve">a pointer on a #VisuUiMain object.</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </function>
      <function name="runCommandLine"
                c:identifier="visu_ui_main_runCommandLine">
        <doc xml:whitespace="preserve">Call the get routines from the command line module and associate
the different tasks to the different panels. For a version that do
not use the panels, call visuGtkRun_commandLine() instead.</doc>
        <return-value transfer-ownership="none">
          <doc xml:whitespace="preserve">always FALSE.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="data" transfer-ownership="none">
            <doc xml:whitespace="preserve">a pointer on a #VisuUiMain object.</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </function>
      <method name="buildInteractiveDialog"
              c:identifier="visu_ui_main_buildInteractiveDialog">
        <doc xml:whitespace="preserve">Create the mouse action dialog window (if not already done).</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
      </method>
      <method name="quit" c:identifier="visu_ui_main_quit">
        <doc xml:whitespace="preserve">Quit the program. If the preference to have a confirm dialog is set,
then it raises the little warning window before quiting (or not).</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <parameter name="force" transfer-ownership="none">
            <doc xml:whitespace="preserve">if TRUE, override the preference of a quiting dialog and quit.</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
    </class>
    <record name="UiMainClass"
            c:type="VisuUiMainClass"
            disguised="1"
            glib:is-gtype-struct-for="UiMain">
      <doc xml:whitespace="preserve">A short way to identify #_VisuUiMainClass structure.</doc>
    </record>
    <record name="UiMain_private" c:type="VisuUiMain_private" disguised="1">
      <doc xml:whitespace="preserve">Private fields for #VisuUiMain objects.</doc>
    </record>
    <constant name="VISU_DATA_ID"
              value="AllElements"
              c:type="EXT_VISU_DATA_ID">
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <callback name="VoidDataFunc" c:type="ToolVoidDataFunc">
      <doc xml:whitespace="preserve">These methods are used when no specific argument is required except
a user-defined object and when void is the return type.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="data" transfer-ownership="none">
          <doc xml:whitespace="preserve">a pointer to some user defined object.</doc>
          <type name="gpointer" c:type="gpointer"/>
        </parameter>
      </parameters>
    </callback>
    <constant name="WEB_SITE"
              value="http://inac.cea.fr/L_Sim/V_Sim"
              c:type="VISU_WEB_SITE">
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <record name="_Data" c:type="_VisuData">
      <field name="parent" writable="1">
        <type name="GObject.Object" c:type="GObject"/>
      </field>
      <field name="ntype" writable="1">
        <type name="guint" c:type="unsigned"/>
      </field>
      <field name="fromVisuElementToInt" writable="1">
        <type name="GLib.HashTable" c:type="GHashTable*">
          <type name="gpointer" c:type="gpointer"/>
          <type name="gpointer" c:type="gpointer"/>
        </type>
      </field>
      <field name="fromIntToVisuElement" writable="1">
        <type name="Element" c:type="VisuElement**"/>
      </field>
      <field name="privateDt" writable="1">
        <type name="DataPrivate" c:type="VisuDataPrivate*"/>
      </field>
    </record>
    <record name="_Element" c:type="_VisuElement">
      <field name="parent" writable="1">
        <type name="GObject.Object" c:type="GObject"/>
      </field>
      <field name="name" writable="1">
        <type name="utf8" c:type="char*"/>
      </field>
      <field name="typeNumber" writable="1">
        <type name="gint" c:type="int"/>
      </field>
      <field name="rgb" writable="1">
        <array zero-terminated="0" c:type="gfloat" fixed-size="4">
          <type name="gfloat" c:type="float"/>
        </array>
      </field>
      <field name="material" writable="1">
        <array zero-terminated="0" c:type="gfloat" fixed-size="5">
          <type name="gfloat" c:type="float"/>
        </array>
      </field>
      <field name="openGLIdentifier" writable="1">
        <type name="gint" c:type="int"/>
      </field>
      <field name="materialIsUpToDate" writable="1">
        <type name="gboolean" c:type="gboolean"/>
      </field>
      <field name="rendered" writable="1">
        <type name="gboolean" c:type="gboolean"/>
      </field>
      <field name="sensitiveToMaskingPlanes" writable="1">
        <type name="gboolean" c:type="gboolean"/>
      </field>
      <field name="dispose_has_run" writable="1">
        <type name="gboolean" c:type="gboolean"/>
      </field>
    </record>
    <record name="_FileFormatIter" c:type="_ToolFileFormatIter">
      <field name="lst" writable="1">
        <type name="GLib.List" c:type="GList*">
          <type name="gpointer" c:type="gpointer"/>
        </type>
      </field>
      <field name="name" writable="1">
        <type name="utf8" c:type="gchar*"/>
      </field>
      <field name="label" writable="1">
        <type name="utf8" c:type="gchar*"/>
      </field>
      <field name="val" writable="1">
        <type name="GObject.Value" c:type="GValue*"/>
      </field>
    </record>
    <record name="_GtkPreview" c:type="_VisuGtkPreview">
      <field name="check" writable="1">
        <type name="Gtk.Widget" c:type="GtkWidget*"/>
      </field>
      <field name="image" writable="1">
        <type name="Gtk.Widget" c:type="GtkWidget*"/>
      </field>
      <field name="table" writable="1">
        <type name="Gtk.Widget" c:type="GtkWidget*"/>
      </field>
      <field name="vbox" writable="1">
        <type name="Gtk.Widget" c:type="GtkWidget*"/>
      </field>
    </record>
    <record name="_ObjectClass" c:type="_VisuObjectClass">
      <field name="parent" writable="1">
        <type name="GObject.ObjectClass" c:type="GObjectClass"/>
      </field>
      <field name="signals" writable="1">
        <array zero-terminated="0" c:type="guint">
          <type name="guint" c:type="guint"/>
        </array>
      </field>
    </record>
    <record name="_Rendering" c:type="_VisuRendering">
      <field name="parent" writable="1">
        <type name="GObject.Object" c:type="GObject"/>
      </field>
      <field name="priv" writable="1">
        <type name="RenderingPriv" c:type="VisuRenderingPriv*"/>
      </field>
    </record>
    <record name="_RenderingClass" c:type="_VisuRenderingClass">
      <field name="parent" writable="1">
        <type name="GObject.ObjectClass" c:type="GObjectClass"/>
      </field>
      <field name="createElement" writable="1">
        <type name="RenderingCreateElementFunc"
              c:type="VisuRenderingCreateElementFunc"/>
      </field>
      <field name="createNode" writable="1">
        <type name="RenderingCreateNodeFunc"
              c:type="VisuRenderingCreateNodeFunc"/>
      </field>
      <field name="getNodeExtend" writable="1">
        <type name="RenderingGetNodeExtendFunc"
              c:type="VisuRenderingGetNodeExtendFunc"/>
      </field>
    </record>
    <record name="_SurfacesResources" c:type="_VisuSurfacesResources">
      <field name="surfnom" writable="1">
        <type name="utf8" c:type="gchar*"/>
      </field>
      <field name="color" writable="1">
        <type name="Color" c:type="ToolColor*"/>
      </field>
      <field name="material" writable="1">
        <array zero-terminated="0" c:type="gfloat" fixed-size="5">
          <type name="gfloat" c:type="float"/>
        </array>
      </field>
      <field name="rendered" writable="1">
        <type name="gboolean" c:type="gboolean"/>
      </field>
      <field name="sensitiveToMaskingPlanes" writable="1">
        <type name="gboolean" c:type="gboolean"/>
      </field>
    </record>
    <record name="_UiMain" c:type="_VisuUiMain">
      <field name="parent" writable="1">
        <type name="Gtk.Window" c:type="GtkWindow"/>
      </field>
      <field name="renderingWindow" writable="1">
        <type name="Gtk.Widget" c:type="GtkWidget*"/>
      </field>
      <field name="pairsDialog" writable="1">
        <type name="Gtk.Widget" c:type="GtkWidget*"/>
      </field>
      <field name="interactiveDialog" writable="1">
        <type name="Gtk.Widget" c:type="GtkWidget*"/>
      </field>
      <field name="aboutDialog" writable="1">
        <type name="Gtk.Widget" c:type="GtkWidget*"/>
      </field>
      <field name="private" writable="1">
        <type name="UiMain_private" c:type="VisuUiMain_private*"/>
      </field>
    </record>
    <function name="basic_applyCommandLine"
              c:identifier="visu_basic_applyCommandLine"
              throws="1">
      <doc xml:whitespace="preserve">Call all the get methods on the command line options to tune the
given @data.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">TRUE if complete without error.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </return-value>
      <parameters>
        <parameter name="data" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuData object to apply the options on ;</doc>
          <type name="Data" c:type="VisuData*"/>
        </parameter>
        <parameter name="set" transfer-ownership="none">
          <doc xml:whitespace="preserve">a table of options ;</doc>
          <type name="BasicCLISet" c:type="VisuBasicCLISet*"/>
        </parameter>
      </parameters>
    </function>
    <function name="basic_createExtensions"
              c:identifier="visu_basic_createExtensions">
      <doc xml:whitespace="preserve">Create all extensions (planes, surfaces...) for the given data. Use
static values read from visu_basic_applyCommandLine(). This method
is mainly used when V_Sim run without the command panel.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="data" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuData object ;</doc>
          <type name="Data" c:type="VisuData*"/>
        </parameter>
        <parameter name="set" transfer-ownership="none">
          <doc xml:whitespace="preserve">a table of options ;</doc>
          <type name="BasicCLISet" c:type="VisuBasicCLISet*"/>
        </parameter>
        <parameter name="rebuild" transfer-ownership="none">
          <doc xml:whitespace="preserve">a boolean.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </parameter>
      </parameters>
    </function>
    <function name="basic_freeAll"
              c:identifier="visu_basic_freeAll"
              version="3.5">
      <doc xml:whitespace="preserve">This routine is called by V_Sim when quiting and it frees the memory
used by visu_basic.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
    </function>
    <function name="basic_getDataDir"
              c:identifier="visu_basic_getDataDir"
              version="3.4">
      <doc xml:whitespace="preserve">Get the static string where V_Sim looks for its data files.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">a string owned by V_Sim.</doc>
        <type name="utf8" c:type="gchar*"/>
      </return-value>
    </function>
    <function name="basic_getIconsDir"
              c:identifier="visu_basic_getIconsDir"
              version="3.4">
      <doc xml:whitespace="preserve">Get the static string where V_Sim looks for its icon files.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">a string owned by V_Sim.</doc>
        <type name="utf8" c:type="gchar*"/>
      </return-value>
    </function>
    <function name="basic_getLegalDir"
              c:identifier="visu_basic_getLegalDir"
              version="3.4">
      <doc xml:whitespace="preserve">Get the static string where V_Sim looks for its legal files.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">a string owned by V_Sim.</doc>
        <type name="utf8" c:type="gchar*"/>
      </return-value>
    </function>
    <function name="basic_getLoadCancel"
              c:identifier="visu_basic_getLoadCancel"
              version="3.6">
      <doc xml:whitespace="preserve">V_Sim implements cancelation load process by setting a flag that can
be check by running routine. Use this method to check the flag
value (not thread safe). See visu_basic_setLoadCancel() to set the
cancelation flag.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">the cancelation status.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </return-value>
    </function>
    <function name="basic_getLocalDir"
              c:identifier="visu_basic_getLocalDir"
              version="3.4">
      <doc xml:whitespace="preserve">Get the static string where V_Sim looks for its user configuration files.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">a string owned by V_Sim.</doc>
        <type name="utf8" c:type="gchar*"/>
      </return-value>
    </function>
    <function name="basic_getLocaleDir"
              c:identifier="visu_basic_getLocaleDir"
              version="3.4">
      <doc xml:whitespace="preserve">Get the static string where V_Sim looks for its localisation files.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">a string owned by V_Sim.</doc>
        <type name="utf8" c:type="gchar*"/>
      </return-value>
    </function>
    <function name="basic_getMainContext"
              c:identifier="visu_basic_getMainContext"
              version="3.6">
      <doc xml:whitespace="preserve">Even without GUI, V_Sim requires to run a main loop. This method is
to get the main loop.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">the main loop, as defined in GLib.</doc>
        <type name="GLib.MainContext" c:type="GMainContext*"/>
      </return-value>
    </function>
    <function name="basic_getOldLocalDir"
              c:identifier="visu_basic_getOldLocalDir"
              version="3.4">
      <doc xml:whitespace="preserve">Get the static string where V_Sim looks for its user configuration
files (old location).</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">a string owned by V_Sim.</doc>
        <type name="utf8" c:type="gchar*"/>
      </return-value>
    </function>
    <function name="basic_getPixmapsDir"
              c:identifier="visu_basic_getPixmapsDir"
              version="3.4">
      <doc xml:whitespace="preserve">Get the static string where V_Sim looks for its pixmap files.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">a string owned by V_Sim.</doc>
        <type name="utf8" c:type="gchar*"/>
      </return-value>
    </function>
    <function name="basic_getPluginsDir"
              c:identifier="visu_basic_getPluginsDir"
              version="3.4">
      <doc xml:whitespace="preserve">Get the static string where V_Sim looks for its plug-in files.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">a string owned by V_Sim.</doc>
        <type name="utf8" c:type="gchar*"/>
      </return-value>
    </function>
    <function name="basic_getPreferedUnit"
              c:identifier="visu_basic_getPreferedUnit"
              version="3.5"
              introspectable="0">
      <doc xml:whitespace="preserve">By setting the prefered unit, when a file is load, V_Sim tries to
render it in this prefered unit.


#unit_undefined).</doc>
      <return-value>
        <doc xml:whitespace="preserve">the prefered unit set by the user (default is</doc>
        <type c:type="ToolUnits"/>
      </return-value>
    </function>
    <function name="basic_loadData"
              c:identifier="visu_basic_loadData"
              throws="1">
      <doc xml:whitespace="preserve">This calls the load method of the current rendering
method. Some informations may be store in @error-&gt;message if the returned
value is FALSE.
The file(s) which is(are) opened is(are) stored in the
#VisuData. The @nSet argument is used to load a specific set of
nodes if the input format supports it. If @nSet is 0, then the
default set of nodes is loaded.

with g_error_free().</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">TRUE if everithing is OK, if FALSE, the @error is set and should be freed</doc>
        <type name="gboolean" c:type="gboolean"/>
      </return-value>
      <parameters>
        <parameter name="data" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuData object ;</doc>
          <type name="Data" c:type="VisuData*"/>
        </parameter>
        <parameter name="format" transfer-ownership="none" allow-none="1">
          <doc xml:whitespace="preserve">a pointer on a format (can be NULL if format is to be guessed) ;</doc>
          <type name="FileFormat" c:type="ToolFileFormat*"/>
        </parameter>
        <parameter name="nSet" transfer-ownership="none">
          <doc xml:whitespace="preserve">an integer ;</doc>
          <type name="gint" c:type="int"/>
        </parameter>
      </parameters>
    </function>
    <function name="basic_mainExport" c:identifier="visu_basic_mainExport">
      <doc xml:whitespace="preserve">This method is called when V_Sim is in export mode from the command line.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">0 if everything is normal, 1 if an error occured.</doc>
        <type name="gint" c:type="int"/>
      </return-value>
    </function>
    <function name="basic_parseConfigFiles"
              c:identifier="visu_basic_parseConfigFiles">
      <doc xml:whitespace="preserve">Parse the parameter and the resource file. Used once at startup.</doc>
      <return-value transfer-ownership="full">
        <doc xml:whitespace="preserve">a newly allocated #GString if some error occured.</doc>
        <type name="utf8" c:type="gchar*"/>
      </return-value>
    </function>
    <function name="basic_setDataFromCommandLine"
              c:identifier="visu_basic_setDataFromCommandLine">
      <doc xml:whitespace="preserve">Read the command line option and set the filenames for a new
#VisuData. The object is not loaded (files are not parsed), just prepared.</doc>
      <return-value transfer-ownership="full">
        <doc xml:whitespace="preserve">a newly allocated #VisuData if required.</doc>
        <type name="Data" c:type="VisuData*"/>
      </return-value>
    </function>
    <function name="basic_setExePath"
              c:identifier="visu_basic_setExePath"
              version="3.6">
      <doc xml:whitespace="preserve">This method is used to tell V_Sim where V_Sim is running (usually
reading from argv[0]. This makes it possible to relocate everything
on the fly. @exePath is copied.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="exePath" transfer-ownership="none">
          <doc xml:whitespace="preserve">a path where the V_Sim executable is running in.</doc>
          <type name="utf8" c:type="gchar*"/>
        </parameter>
      </parameters>
    </function>
    <function name="basic_setExtInfos" c:identifier="visu_basic_setExtInfos">
      <doc xml:whitespace="preserve">Create and draw possible information on nodes.  This method
is mainly used when V_Sim run without the command panel.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="dataObj" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuData object ;</doc>
          <type name="Data" c:type="VisuData*"/>
        </parameter>
        <parameter name="method" transfer-ownership="none">
          <doc xml:whitespace="preserve">where to draw information ;</doc>
          <type name="GlExtInfosDrawMethod" c:type="VisuGlExtInfosDrawMethod"/>
        </parameter>
        <parameter name="nodes" transfer-ownership="none">
          <doc xml:whitespace="preserve">a possible list of selected nodes, or NULL ;</doc>
          <type name="gint" c:type="int*"/>
        </parameter>
        <parameter name="data" transfer-ownership="none">
          <doc xml:whitespace="preserve">the information to draw.</doc>
          <type name="DataNode" c:type="VisuDataNode*"/>
        </parameter>
      </parameters>
    </function>
    <function name="basic_setLoadCancel"
              c:identifier="visu_basic_setLoadCancel"
              version="3.6">
      <doc xml:whitespace="preserve">V_Sim implements cancelation load process by setting a flag that can
be check by running routine. Use this method to set the flag
value (not thread safe). See visu_basic_getLoadCancel() to check the
cancelation flag.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="status" transfer-ownership="none">
          <doc xml:whitespace="preserve">a boolean.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </parameter>
      </parameters>
    </function>
    <function name="basic_setLoadMessage"
              c:identifier="visu_basic_setLoadMessage"
              version="3.6">
      <doc xml:whitespace="preserve">If a message function on load action has been set by
visu_basic_setLoadMessageFunc(), then the given @mess is given as
argument to this function.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="mess" transfer-ownership="none">
          <doc xml:whitespace="preserve">a string.</doc>
          <type name="utf8" c:type="gchar*"/>
        </parameter>
      </parameters>
    </function>
    <function name="basic_setLoadMessageFunc"
              c:identifier="visu_basic_setLoadMessageFunc"
              version="3.6">
      <doc xml:whitespace="preserve">When a load process is running, on can defined a message function
that may be called to output message to the user using
visu_basic_setLoadMessage().</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="func"
                   transfer-ownership="none"
                   scope="call"
                   closure="1">
          <doc xml:whitespace="preserve">a function to print a message.</doc>
          <type name="GLib.Func" c:type="GFunc"/>
        </parameter>
        <parameter name="data" transfer-ownership="none">
          <doc xml:whitespace="preserve">user data.</doc>
          <type name="gpointer" c:type="gpointer"/>
        </parameter>
      </parameters>
    </function>
    <function name="basic_setPreferedUnit"
              c:identifier="visu_basic_setPreferedUnit"
              version="3.5"
              introspectable="0">
      <doc xml:whitespace="preserve">By setting the prefered unit, when a file is load, V_Sim tries to
render it in this prefered unit.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">TRUE if the prefered unit is actually changed.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </return-value>
      <parameters>
        <parameter name="unit" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #ToolUnits value.</doc>
          <type c:type="ToolUnits"/>
        </parameter>
      </parameters>
    </function>
    <function name="basic_showOptionHelp"
              c:identifier="visu_basic_showOptionHelp"
              version="3.6">
      <doc xml:whitespace="preserve">Display a small help for some options. The output is different from
the -h command line options, here some details about running time
options is displayed like the available file format for
exportation... If @force is TRUE, all possible values are output,
otherwise only those relevant to the user provided command line
options.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">TRUE if something is displayed.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </return-value>
      <parameters>
        <parameter name="force" transfer-ownership="none">
          <doc xml:whitespace="preserve">a boolean.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </parameter>
      </parameters>
    </function>
    <function name="color_addFloatRGBA"
              c:identifier="tool_color_addFloatRGBA"
              moved-to="Color.addFloatRGBA">
      <doc xml:whitespace="preserve">This method adds a new color in the list of stored colors with the given values.
If it already exits it returns the pointer of that color.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">a newly created #ToolColor or the already existing one.</doc>
        <type name="Color" c:type="ToolColor*"/>
      </return-value>
      <parameters>
        <parameter name="rgba" transfer-ownership="none">
          <doc xml:whitespace="preserve">four values between 0. and 1. that represent [Red, Green, Blue, Alpha] ;</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="position"
                   direction="out"
                   caller-allocates="1"
                   transfer-ownership="none">
          <doc xml:whitespace="preserve">an int pointer to store the position of the returned colour.</doc>
          <type name="gint" c:type="int*"/>
        </parameter>
      </parameters>
    </function>
    <function name="color_addIntRGBA"
              c:identifier="tool_color_addIntRGBA"
              moved-to="Color.addIntRGBA">
      <doc xml:whitespace="preserve">This method adds a new color in the list of stored colors with the given values.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">a newly created #ToolColor or the already existing one.</doc>
        <type name="Color" c:type="ToolColor*"/>
      </return-value>
      <parameters>
        <parameter name="rgba" transfer-ownership="none">
          <doc xml:whitespace="preserve">four values between 0 and 255 that represent [Red, Green, Blue, Alpha].</doc>
          <type name="gint" c:type="int"/>
        </parameter>
      </parameters>
    </function>
    <function name="color_convertHSLtoRGB"
              c:identifier="tool_color_convertHSLtoRGB"
              moved-to="Color.convertHSLtoRGB">
      <doc xml:whitespace="preserve">This methods convert a HSL color to a RGB one.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="rgb" transfer-ownership="none">
          <doc xml:whitespace="preserve">an allocated 3 elements array to receive the RGB values ;</doc>
          <type name="gfloat" c:type="float*"/>
        </parameter>
        <parameter name="hsl" transfer-ownership="none">
          <doc xml:whitespace="preserve">a 3 elements array to retrieve the HSL values from.</doc>
          <type name="gfloat" c:type="float*"/>
        </parameter>
      </parameters>
    </function>
    <function name="color_convertHSVtoRGB"
              c:identifier="tool_color_convertHSVtoRGB"
              moved-to="Color.convertHSVtoRGB">
      <doc xml:whitespace="preserve">This methods convert a HSV color to a RGB one.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="rgb" transfer-ownership="none">
          <doc xml:whitespace="preserve">an allocated 3 elements array to receive the RGB values ;</doc>
          <type name="gfloat" c:type="float*"/>
        </parameter>
        <parameter name="hsv" transfer-ownership="none">
          <doc xml:whitespace="preserve">a 3 elements array to retrieve the HSV values from.</doc>
          <type name="gfloat" c:type="float*"/>
        </parameter>
      </parameters>
    </function>
    <function name="color_convertRGBtoHSL"
              c:identifier="tool_color_convertRGBtoHSL"
              moved-to="Color.convertRGBtoHSL">
      <doc xml:whitespace="preserve">Convert a RGB colour into a HSL one.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="hsl" transfer-ownership="none">
          <doc xml:whitespace="preserve">three float to store the HSL value ;</doc>
          <type name="gfloat" c:type="float*"/>
        </parameter>
        <parameter name="rgb" transfer-ownership="none">
          <doc xml:whitespace="preserve">three floats giving the RGB values.</doc>
          <type name="gfloat" c:type="float*"/>
        </parameter>
      </parameters>
    </function>
    <function name="color_freeAll"
              c:identifier="tool_color_freeAll"
              moved-to="Color.freeAll">
      <doc xml:whitespace="preserve">Remove all previously stored colours.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
    </function>
    <function name="color_getById"
              c:identifier="tool_color_getById"
              moved-to="Color.getById">
      <doc xml:whitespace="preserve">This function retrieves the nth stored color. Number 0, is the last
added color.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">the corresponding color, or NULL if none has been found.</doc>
        <type name="Color" c:type="ToolColor*"/>
      </return-value>
      <parameters>
        <parameter name="num" transfer-ownership="none">
          <doc xml:whitespace="preserve">an integer (&gt;0).</doc>
          <type name="gint" c:type="int"/>
        </parameter>
      </parameters>
    </function>
    <function name="color_getByValues"
              c:identifier="tool_color_getByValues"
              moved-to="Color.getByValues">
      <doc xml:whitespace="preserve">This method is used to look for a specific color in the stored list. The argument @pos
is -1 if nothing is found or stores the position (beginning at 0) of the found color.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">the found color, or NULL if none exists.</doc>
        <type name="Color" c:type="ToolColor*"/>
      </return-value>
      <parameters>
        <parameter name="pos"
                   direction="out"
                   caller-allocates="1"
                   transfer-ownership="none">
          <doc xml:whitespace="preserve">an allocated int to store the position of the found color ;</doc>
          <type name="gint" c:type="int*"/>
        </parameter>
        <parameter name="red" transfer-ownership="none">
          <doc xml:whitespace="preserve">a value between 0. and 1. ;</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="green" transfer-ownership="none">
          <doc xml:whitespace="preserve">a value between 0. and 1. ;</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="blue" transfer-ownership="none">
          <doc xml:whitespace="preserve">a value between 0. and 1. ;</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="alpha" transfer-ownership="none">
          <doc xml:whitespace="preserve">a value between 0. and 1..</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
      </parameters>
    </function>
    <function name="color_getLastStored"
              c:identifier="tool_color_getLastStored"
              moved-to="Color.getLastStored">
      <doc xml:whitespace="preserve">This method is typiccally called after a client has catched
the colorNewAvailable signal.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">the last added color, NULL if no color exists.</doc>
        <type name="Color" c:type="ToolColor*"/>
      </return-value>
    </function>
    <function name="color_getStoredColors"
              c:identifier="tool_color_getStoredColors"
              moved-to="Color.getStoredColors">
      <doc xml:whitespace="preserve">Use this method to get a pointeur to the list of stored colors.

a GList pointer to the stored colors.</doc>
      <return-value transfer-ownership="none">
        <type name="GLib.List" c:type="GList*">
          <type name="Color"/>
        </type>
      </return-value>
    </function>
    <function name="color_new"
              c:identifier="tool_color_new"
              moved-to="Color.new">
      <doc xml:whitespace="preserve">Create a new color with initial values given as arguments.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">a new allocated #ToolColor (use g_free() to free it).</doc>
        <type name="Color" c:type="ToolColor*"/>
      </return-value>
      <parameters>
        <parameter name="rgba" transfer-ownership="none">
          <doc xml:whitespace="preserve">four values between 0. and 1. that represent [Red, Green, Blue, Alpha].</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
      </parameters>
    </function>
    <function name="configFile_addEntry"
              c:identifier="visu_configFile_addEntry"
              introspectable="0">
      <doc xml:whitespace="preserve">This creates a new #VisuConfigFileEntry object with the given
values. The key and description arguments are copied.</doc>
      <return-value>
        <doc xml:whitespace="preserve">the newly created #VisuConfigFileEntry object.</doc>
        <type name="ConfigFileEntry" c:type="VisuConfigFileEntry*"/>
      </return-value>
      <parameters>
        <parameter name="kind" transfer-ownership="none">
          <doc xml:whitespace="preserve">an integer ;</doc>
          <type name="gint" c:type="int"/>
        </parameter>
        <parameter name="key" transfer-ownership="none">
          <doc xml:whitespace="preserve">a string (should not be NULL) ;</doc>
          <type name="utf8" c:type="gchar*"/>
        </parameter>
        <parameter name="description" transfer-ownership="none">
          <doc xml:whitespace="preserve">a string (can be NULL) ;</doc>
          <type name="utf8" c:type="gchar*"/>
        </parameter>
        <parameter name="nbLines" transfer-ownership="none">
          <doc xml:whitespace="preserve">an integer ;</doc>
          <type name="gint" c:type="int"/>
        </parameter>
        <parameter name="readFunc" transfer-ownership="none">
          <doc xml:whitespace="preserve">a VisuConfigFileReadFunc.</doc>
          <type name="ConfigFileReadFunc" c:type="VisuConfigFileReadFunc"/>
        </parameter>
      </parameters>
    </function>
    <function name="configFile_addExportFunction"
              c:identifier="visu_configFile_addExportFunction"
              introspectable="0">
      <doc xml:whitespace="preserve">This stores the @writeFunc given. It will be called when resources or parameters
will be exported to disk.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="kind" transfer-ownership="none">
          <doc xml:whitespace="preserve">an integer to identify resources or parameters ;</doc>
          <type name="gint" c:type="int"/>
        </parameter>
        <parameter name="writeFunc" transfer-ownership="none">
          <doc xml:whitespace="preserve">a VisuConfigFileExportFunc method.</doc>
          <type name="ConfigFileExportFunc" c:type="VisuConfigFileExportFunc"/>
        </parameter>
      </parameters>
    </function>
    <function name="configFile_addKnownTag"
              c:identifier="visu_configFile_addKnownTag">
      <doc xml:whitespace="preserve">If parameter entries have a tag, they are ignored except if their tag
has been declared using this method.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="tag" transfer-ownership="none">
          <doc xml:whitespace="preserve">a string (not nul or empty).</doc>
          <type name="utf8" c:type="gchar*"/>
        </parameter>
      </parameters>
    </function>
    <function name="configFile_entry_setReplace"
              c:identifier="visu_configFile_entry_setReplace">
      <doc xml:whitespace="preserve">Use this method to declare that @oldEntry has become obsolete and
has been replaced by @newEntry.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="newEntry" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuConfigFileEntry object ;</doc>
          <type name="ConfigFileEntry" c:type="VisuConfigFileEntry*"/>
        </parameter>
        <parameter name="oldEntry" transfer-ownership="none">
          <doc xml:whitespace="preserve">idem.</doc>
          <type name="ConfigFileEntry" c:type="VisuConfigFileEntry*"/>
        </parameter>
      </parameters>
    </function>
    <function name="configFile_entry_setTag"
              c:identifier="visu_configFile_entry_setTag">
      <doc xml:whitespace="preserve">This method is used to set a tag to the given entry. This tag is used
to ignore or not the entry when the file is read. The @tag argument
is copied.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="entry" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuConfigFileEntry object ;</doc>
          <type name="ConfigFileEntry" c:type="VisuConfigFileEntry*"/>
        </parameter>
        <parameter name="tag" transfer-ownership="none">
          <doc xml:whitespace="preserve">a string.</doc>
          <type name="utf8" c:type="gchar*"/>
        </parameter>
      </parameters>
    </function>
    <function name="configFile_entry_setVersion"
              c:identifier="visu_configFile_entry_setVersion">
      <doc xml:whitespace="preserve">Set the version number the entry appear in.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="entry" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuConfigFileEntry object ;</doc>
          <type name="ConfigFileEntry" c:type="VisuConfigFileEntry*"/>
        </parameter>
        <parameter name="version" transfer-ownership="none">
          <doc xml:whitespace="preserve">the version the entry appear in.</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
      </parameters>
    </function>
    <function name="configFile_exportToXML"
              c:identifier="visu_configFile_exportToXML"
              throws="1">
      <doc xml:whitespace="preserve">Export all the registered entries for resources or parameters to an
XML file.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">TRUE if the file is written with success.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </return-value>
      <parameters>
        <parameter name="filename" transfer-ownership="none">
          <doc xml:whitespace="preserve">a string in the encoding of the file system ;</doc>
          <type name="utf8" c:type="gchar*"/>
        </parameter>
        <parameter name="kind" transfer-ownership="none">
          <doc xml:whitespace="preserve">either #VISU_CONFIGFILE_PARAMETER or #VISU_CONFIGFILE_RESOURCE ;</doc>
          <type name="gint" c:type="int"/>
        </parameter>
      </parameters>
    </function>
    <function name="configFile_getDefaultFilename"
              c:identifier="visu_configFile_getDefaultFilename">
      <doc xml:whitespace="preserve">This methods is used to get the filename used for different
config files.

owned by V_Sim and should not be freed or modified.</doc>
      <return-value transfer-ownership="full">
        <doc xml:whitespace="preserve">the filename of config file. The returned *gchar is</doc>
        <type name="utf8" c:type="gchar*"/>
      </return-value>
      <parameters>
        <parameter name="kind" transfer-ownership="none">
          <doc xml:whitespace="preserve">an integer identifier.</doc>
          <type name="gint" c:type="int"/>
        </parameter>
      </parameters>
    </function>
    <function name="configFile_getEntries"
              c:identifier="visu_configFile_getEntries"
              introspectable="0">
      <doc xml:whitespace="preserve">This routine should be used for introspections purpose, to know
what resources or parameters are available.</doc>
      <return-value>
        <doc xml:whitespace="preserve">a #GList own by V_Sim.</doc>
        <type name="GLib.List" c:type="GList*">
          <type name="utf8"/>
        </type>
      </return-value>
      <parameters>
        <parameter name="kind" transfer-ownership="none">
          <doc xml:whitespace="preserve">either #VISU_CONFIGFILE_PARAMETER or #VISU_CONFIGFILE_RESOURCE ;</doc>
          <type name="gint" c:type="int"/>
        </parameter>
      </parameters>
    </function>
    <function name="configFile_getNextValidPath"
              c:identifier="visu_configFile_getNextValidPath"
              introspectable="0">
      <doc xml:whitespace="preserve">Test the entries of the given list to find
a valid position to read or write a config file.
It tests access for the specified file. After a call to this
method the @list argument points to the next entry in the list, after
the one found.</doc>
      <return-value transfer-ownership="full">
        <doc xml:whitespace="preserve">the first valid path find in the given list of paths.</doc>
        <type name="utf8" c:type="gchar*"/>
      </return-value>
      <parameters>
        <parameter name="kind" transfer-ownership="none">
          <doc xml:whitespace="preserve">an integer identifier ;</doc>
          <type name="gint" c:type="int"/>
        </parameter>
        <parameter name="accessMode" transfer-ownership="none">
          <doc xml:whitespace="preserve">a value from R_OK, W_OK and X_OK as described in unistd.h ;</doc>
          <type name="gint" c:type="int"/>
        </parameter>
        <parameter name="list" transfer-ownership="none">
          <doc xml:whitespace="preserve">a pointer to a valid *GList ;</doc>
          <type name="GLib.List" c:type="GList**">
            <type name="gpointer" c:type="gpointer"/>
          </type>
        </parameter>
        <parameter name="utf8" transfer-ownership="none">
          <doc xml:whitespace="preserve">if 1, the path is return in UTF-8 format, otherwise, the locale of the file system is used.</doc>
          <type name="gint" c:type="int"/>
        </parameter>
      </parameters>
    </function>
    <function name="configFile_getPathList"
              c:identifier="visu_configFile_getPathList"
              introspectable="0">
      <doc xml:whitespace="preserve">V_Sim stores a list of paths where to look for resources or parameters
files, this method is used to get these lists.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">the list of the parameters or resources paths. This list is read-only.</doc>
        <type name="GLib.List" c:type="GList*">
          <type name="gpointer" c:type="gpointer"/>
        </type>
      </return-value>
      <parameters>
        <parameter name="kind" transfer-ownership="none">
          <doc xml:whitespace="preserve">an integer identifier.</doc>
          <type name="gint" c:type="int"/>
        </parameter>
      </parameters>
    </function>
    <function name="configFile_getPathToResources"
              c:identifier="visu_configFile_getPathToResources">
      <return-value transfer-ownership="none">
        <type name="utf8" c:type="gchar*"/>
      </return-value>
    </function>
    <function name="configFile_getValidPath"
              c:identifier="visu_configFile_getValidPath">
      <doc xml:whitespace="preserve">Test the entries of the hadoc list to find
a valid position to read or write a config file.
It tests access for the specified file.</doc>
      <return-value transfer-ownership="full">
        <doc xml:whitespace="preserve">the first valid path find in the list of known paths.</doc>
        <type name="utf8" c:type="gchar*"/>
      </return-value>
      <parameters>
        <parameter name="kind" transfer-ownership="none">
          <doc xml:whitespace="preserve">an integer identifier ;</doc>
          <type name="gint" c:type="int"/>
        </parameter>
        <parameter name="mode" transfer-ownership="none">
          <doc xml:whitespace="preserve">a value from R_OK, W_OK and X_OK as described in unistd.h.</doc>
          <type name="gint" c:type="int"/>
        </parameter>
        <parameter name="utf8" transfer-ownership="none">
          <doc xml:whitespace="preserve">if 1, the path is return in UTF-8 format, otherwise, the locale of the file system is used.</doc>
          <type name="gint" c:type="int"/>
        </parameter>
      </parameters>
    </function>
    <function name="configFile_load"
              c:identifier="visu_configFile_load"
              throws="1">
      <doc xml:whitespace="preserve">Try to load the resources/parameters from the file name given in
parameter.

should be freed with g_error_free().</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">TRUE if everything goes right. If @error is not NULL it</doc>
        <type name="gboolean" c:type="gboolean"/>
      </return-value>
      <parameters>
        <parameter name="kind" transfer-ownership="none">
          <doc xml:whitespace="preserve">an integer to identify the kind of file ;</doc>
          <type name="gint" c:type="int"/>
        </parameter>
        <parameter name="fileName" transfer-ownership="none">
          <doc xml:whitespace="preserve">the path to file to read ;</doc>
          <type name="utf8" c:type="char*"/>
        </parameter>
        <parameter name="dataObj" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuData object, sometime needed to update values (can be NULL) ;</doc>
          <type name="Data" c:type="VisuData*"/>
        </parameter>
      </parameters>
    </function>
    <function name="configFile_save"
              c:identifier="visu_configFile_save"
              throws="1">
      <doc xml:whitespace="preserve">Try to export the resources/parameters to the file name given in
parameter. If @lines argument
is not NULL, and everything went right, it stores the number of written lines.
If the argument @dataObj is not null, only resources related
to the #VisuData object should be exported (for parameters files, @dataObj is
always NULL).</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">TRUE if everything goes right.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </return-value>
      <parameters>
        <parameter name="kind" transfer-ownership="none">
          <doc xml:whitespace="preserve">an integer to identify the kind of file ;</doc>
          <type name="gint" c:type="int"/>
        </parameter>
        <parameter name="fileName" transfer-ownership="none">
          <doc xml:whitespace="preserve">the path to file to read ;</doc>
          <type name="utf8" c:type="char*"/>
        </parameter>
        <parameter name="lines" transfer-ownership="none">
          <doc xml:whitespace="preserve">a pointer to an integer (can be NULL) ;</doc>
          <type name="gint" c:type="int*"/>
        </parameter>
        <parameter name="dataObj" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuData object (can be NULL) ;</doc>
          <type name="Data" c:type="VisuData*"/>
        </parameter>
      </parameters>
    </function>
    <function name="dump_getAllModules"
              c:identifier="visu_dump_getAllModules"
              moved-to="Dump.getAllModules">
      <doc xml:whitespace="preserve">All dumping extensions are stored in an opaque way in V_Sim. But
they can be listed by a call to this method.

the known dumping extensions. This list is own by V_Sim and should
be considered read-only.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">a list of all</doc>
        <type name="GLib.List" c:type="GList*">
          <type name="Dump"/>
        </type>
      </return-value>
    </function>
    <function name="dump_getNModules"
              c:identifier="visu_dump_getNModules"
              moved-to="Dump.getNModules">
      <doc xml:whitespace="preserve">A convenient way to know how many dumping extensions are registered.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">the number of known dumping extensions.</doc>
        <type name="gint" c:type="gint"/>
      </return-value>
    </function>
    <function name="dump_getQuark"
              c:identifier="visu_dump_getQuark"
              moved-to="Dump.getQuark"
              introspectable="0">
      <doc xml:whitespace="preserve">Internal routine to get the #GQuark to handle error related to dump
actions.</doc>
      <return-value transfer-ownership="none">
        <type name="GLib.Quark" c:type="GQuark"/>
      </return-value>
    </function>
    <function name="extension_new"
              c:identifier="visu_extension_new"
              moved-to="Extension.new">
      <doc xml:whitespace="preserve">Create a new VisuExtension with the specified name, description
and OpenGL object list. The priority is set by default to
#VISU_EXTENSION_PRIORITY_NORMAL. The flag used to store
the OpenGL state is put to FALSE by default (see
visu_extension_setSaveOpenGLState() to chance it).</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">the new VisuExtension or null if something wrong happens.</doc>
        <type name="Extension" c:type="VisuExtension*"/>
      </return-value>
      <parameters>
        <parameter name="name" transfer-ownership="none">
          <doc xml:whitespace="preserve">name of the extension, in ASCII, used as id in the config files,</doc>
          <type name="filename" c:type="gchar*"/>
        </parameter>
        <parameter name="nameI18n" transfer-ownership="none">
          <doc xml:whitespace="preserve">name in UTF8 that can be translated and shown to user,</doc>
          <type name="utf8" c:type="gchar*"/>
        </parameter>
        <parameter name="description" transfer-ownership="none" allow-none="1">
          <doc xml:whitespace="preserve">a brief description of the extension (can be null),</doc>
          <type name="utf8" c:type="gchar*"/>
        </parameter>
        <parameter name="objectListId" transfer-ownership="none">
          <doc xml:whitespace="preserve">an int to identify an list of OpenGL objects (null if this extension as no OpenGL object,</doc>
          <type name="gint" c:type="int"/>
        </parameter>
        <parameter name="rebuild"
                   transfer-ownership="none"
                   allow-none="1"
                   scope="call">
          <doc xml:whitespace="preserve">handler to a method that is called every time V_Sim needs to create again the OpenGL object list. If NULL, nothing is called.</doc>
          <type name="ExtensionRebuildFunc" c:type="VisuExtensionRebuildFunc"/>
        </parameter>
      </parameters>
    </function>
    <function name="file_format_getQuark"
              c:identifier="tool_file_format_getQuark"
              moved-to="FileFormat.getQuark"
              introspectable="0">
      <doc xml:whitespace="preserve">Internal routine to get the #GQuark to handle error related to file formats.</doc>
      <return-value transfer-ownership="none">
        <type name="GLib.Quark" c:type="GQuark"/>
      </return-value>
    </function>
    <function name="file_format_new"
              c:identifier="tool_file_format_new"
              moved-to="FileFormat.new">
      <doc xml:whitespace="preserve">Allocate a new #ToolFileFormat. The @patterns argument is copied in
the #ToolFileFormat object and can be freed safely after the call to this method.

or NULL if something goes wrong.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">a newly allocated ToolFileFormat,</doc>
        <type name="FileFormat" c:type="ToolFileFormat*"/>
      </return-value>
      <parameters>
        <parameter name="descr" transfer-ownership="none">
          <doc xml:whitespace="preserve">a short string to label a new file format.</doc>
          <type name="utf8" c:type="gchar*"/>
        </parameter>
        <parameter name="patterns" transfer-ownership="none">
          <doc xml:whitespace="preserve">a set of patterns to identify files of this format.</doc>
          <array c:type="gchar**">
            <type name="utf8"/>
          </array>
        </parameter>
      </parameters>
    </function>
    <function name="file_format_newRestricted"
              c:identifier="tool_file_format_newRestricted"
              moved-to="FileFormat.newRestricted">
      <doc xml:whitespace="preserve">Allocate a new #ToolFileFormat. The @patterns argument is copied in
the #ToolFileFormat object and can be freed safely after the call to this method.
The @patterns list is not all the patterns supported by the format.

or NULL if something goes wrong.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">a newly allocated ToolFileFormat,</doc>
        <type name="FileFormat" c:type="ToolFileFormat*"/>
      </return-value>
      <parameters>
        <parameter name="descr" transfer-ownership="none">
          <doc xml:whitespace="preserve">a short string to label a new file format.</doc>
          <type name="utf8" c:type="gchar*"/>
        </parameter>
        <parameter name="patterns" transfer-ownership="none">
          <doc xml:whitespace="preserve">a set of patterns to identify files of this format.</doc>
          <type name="utf8" c:type="gchar**"/>
        </parameter>
      </parameters>
    </function>
    <function name="glExt_infos_build" c:identifier="visu_glExt_infos_build">
      <doc xml:whitespace="preserve">Build the OpenGL list representing the informations associated to the given
@dataObj. To associate some, use visu_glExt_infos_drawIds(), or visu_glExt_infos_drawElements()
or visu_glExt_infos_drawData().</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="dataObj" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuData object.</doc>
          <type name="Data" c:type="VisuData*"/>
        </parameter>
      </parameters>
    </function>
    <function name="glExt_infos_drawData"
              c:identifier="visu_glExt_infos_drawData">
      <doc xml:whitespace="preserve">As visu_glExt_infos_drawIds(), but draw some informations instead of their
numbers. The informations are defined by the @dataNode argument.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="data" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuData object ;</doc>
          <type name="Data" c:type="VisuData*"/>
        </parameter>
        <parameter name="dataNode" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuDataNode object ;</doc>
          <type name="DataNode" c:type="VisuDataNode*"/>
        </parameter>
        <parameter name="nodes" transfer-ownership="none">
          <doc xml:whitespace="preserve">an integer list, terminated with a negative number ;</doc>
          <type name="gint" c:type="int*"/>
        </parameter>
      </parameters>
    </function>
    <function name="glExt_infos_drawElements"
              c:identifier="visu_glExt_infos_drawElements">
      <doc xml:whitespace="preserve">As visu_glExt_infos_drawIds(), but draw the names of elements instead of their
numbers.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="data" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuData object ;</doc>
          <type name="Data" c:type="VisuData*"/>
        </parameter>
        <parameter name="nodes" transfer-ownership="none">
          <doc xml:whitespace="preserve">an integer list, terminated with a negative number.</doc>
          <type name="gint" c:type="int*"/>
        </parameter>
      </parameters>
    </function>
    <function name="glExt_infos_drawIds"
              c:identifier="visu_glExt_infos_drawIds">
      <doc xml:whitespace="preserve">Associate a informations extension to the given @data. With this extension,
some the number of nodes will be drawn on them. Numbers can be drawn and
all nodes (set @nodes to a NULL pointer), or to a restricted list of nodes
represented by their numbers. In this case, @nodes can have whatever length
but must be terminated by a negative integer. This array is then owned by the
extension and should not be freed.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="data" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuData object ;</doc>
          <type name="Data" c:type="VisuData*"/>
        </parameter>
        <parameter name="nodes" transfer-ownership="none">
          <doc xml:whitespace="preserve">an integer list, terminated with a negative number.</doc>
          <type name="gint" c:type="int*"/>
        </parameter>
      </parameters>
    </function>
    <function name="glExt_infos_setOn" c:identifier="visu_glExt_infos_setOn">
      <doc xml:whitespace="preserve">Change the status of the informations extension.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">TRUE if the calling routine should call visu_object_redraw().</doc>
        <type name="gboolean" c:type="gboolean"/>
      </return-value>
      <parameters>
        <parameter name="data" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuData object ;</doc>
          <type name="Data" c:type="VisuData*"/>
        </parameter>
        <parameter name="status" transfer-ownership="none">
          <doc xml:whitespace="preserve">a boolean.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </parameter>
      </parameters>
    </function>
    <function name="matrix_cartesianToSpherical"
              c:identifier="tool_matrix_cartesianToSpherical"
              version="3.3">
      <doc xml:whitespace="preserve">A method to transform cartesian coordinates in spherical
coordinates (radius, phi and theta).</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="spherical" transfer-ownership="none">
          <doc xml:whitespace="preserve">an allocated array of 3 floating point values to store the result ;</doc>
          <type name="gfloat" c:type="float*"/>
        </parameter>
        <parameter name="cartesian" transfer-ownership="none">
          <doc xml:whitespace="preserve">an allocated array of 3 floating point values to read the input.</doc>
          <type name="gfloat" c:type="float*"/>
        </parameter>
      </parameters>
    </function>
    <function name="matrix_constrainInBox"
              c:identifier="tool_matrix_constrainInBox"
              version="3.6">
      <doc xml:whitespace="preserve">Given the box difintion as the transformation matrices @XYZToBox
and @boxToXYZ and the initial @xyz cartesian coordinates, it
returns the translation @translat to be applied to @xyz to move the
node into the box.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">TRUE if @translat is not (0;0;0).</doc>
        <type name="gboolean" c:type="gboolean"/>
      </return-value>
      <parameters>
        <parameter name="translat" transfer-ownership="none">
          <doc xml:whitespace="preserve">a translation in cartesian coordinates (out values).</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="xyz" transfer-ownership="none">
          <doc xml:whitespace="preserve">a set of cartesian coordinates.</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="extension" transfer-ownership="none">
          <doc xml:whitespace="preserve">the box expansion in the three directions.</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="XYZToBox" transfer-ownership="none">
          <doc xml:whitespace="preserve">the transformation matrix to go from cartesian to reduced coordinates.</doc>
          <type name="gdouble" c:type="double"/>
        </parameter>
        <parameter name="boxToXYZ" transfer-ownership="none">
          <doc xml:whitespace="preserve">the reverse transformation matrix.</doc>
          <type name="gdouble" c:type="double"/>
        </parameter>
      </parameters>
    </function>
    <function name="matrix_determinant"
              c:identifier="tool_matrix_determinant"
              version="3.6">
      <doc xml:whitespace="preserve">Calculate the determinant of matrix @mat.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">the determinant value.</doc>
        <type name="gfloat" c:type="float"/>
      </return-value>
      <parameters>
        <parameter name="mat" transfer-ownership="none">
          <doc xml:whitespace="preserve">a matrix.</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
      </parameters>
    </function>
    <function name="matrix_getRotationFromFull"
              c:identifier="tool_matrix_getRotationFromFull"
              version="3.6">
      <doc xml:whitespace="preserve">There is a rotation matrix to transform from full cartesian
coordinates into reduced box cartesian coordinates.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">TRUE if @full does not describe properly a 3D box.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </return-value>
      <parameters>
        <parameter name="rot" transfer-ownership="none">
          <doc xml:whitespace="preserve">a rotation matrix (out values).</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="full" transfer-ownership="none">
          <doc xml:whitespace="preserve">the description of basis set in full development.</doc>
          <type name="gdouble" c:type="double"/>
        </parameter>
        <parameter name="box" transfer-ownership="none">
          <doc xml:whitespace="preserve">the description of basis set in align X axis.</doc>
          <type name="gdouble" c:type="double"/>
        </parameter>
      </parameters>
    </function>
    <function name="matrix_getScaledLinear"
              c:identifier="tool_matrix_getScaledLinear"
              version="3.5">
      <doc xml:whitespace="preserve">Transform @x into [0;1] with a linear scale.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">a value into [0;1].</doc>
        <type name="gdouble" c:type="double"/>
      </return-value>
      <parameters>
        <parameter name="x" transfer-ownership="none">
          <doc xml:whitespace="preserve">the initial value ;</doc>
          <type name="gdouble" c:type="double"/>
        </parameter>
        <parameter name="minmax" transfer-ownership="none">
          <doc xml:whitespace="preserve">the boundaries for the @x argument ;</doc>
          <type name="gdouble" c:type="double"/>
        </parameter>
      </parameters>
    </function>
    <function name="matrix_getScaledLinearInv"
              c:identifier="tool_matrix_getScaledLinearInv"
              version="3.5">
      <doc xml:whitespace="preserve">Reverse function for tool_matrix_getScaledLinear().</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">a value into [0;1].</doc>
        <type name="gdouble" c:type="double"/>
      </return-value>
      <parameters>
        <parameter name="x" transfer-ownership="none">
          <doc xml:whitespace="preserve">the initial value ;</doc>
          <type name="gdouble" c:type="double"/>
        </parameter>
        <parameter name="minmax" transfer-ownership="none">
          <doc xml:whitespace="preserve">the boundaries for the @x argument.</doc>
          <type name="gdouble" c:type="double"/>
        </parameter>
      </parameters>
    </function>
    <function name="matrix_getScaledLog"
              c:identifier="tool_matrix_getScaledLog"
              version="3.5">
      <doc xml:whitespace="preserve">Transform @x into [0;1] with a log scale.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">a value into [0;1].</doc>
        <type name="gdouble" c:type="double"/>
      </return-value>
      <parameters>
        <parameter name="x" transfer-ownership="none">
          <doc xml:whitespace="preserve">the initial value ;</doc>
          <type name="gdouble" c:type="double"/>
        </parameter>
        <parameter name="minmax" transfer-ownership="none">
          <doc xml:whitespace="preserve">the boundaries for the @x argument.</doc>
          <type name="gdouble" c:type="double"/>
        </parameter>
      </parameters>
    </function>
    <function name="matrix_getScaledLogInv"
              c:identifier="tool_matrix_getScaledLogInv"
              version="3.5">
      <doc xml:whitespace="preserve">Reverse function for tool_matrix_getScaledLog().</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">a value into [0;1].</doc>
        <type name="gdouble" c:type="double"/>
      </return-value>
      <parameters>
        <parameter name="x" transfer-ownership="none">
          <doc xml:whitespace="preserve">the initial value ;</doc>
          <type name="gdouble" c:type="double"/>
        </parameter>
        <parameter name="minmax" transfer-ownership="none">
          <doc xml:whitespace="preserve">the boundaries for the @x argument.</doc>
          <type name="gdouble" c:type="double"/>
        </parameter>
      </parameters>
    </function>
    <callback name="matrix_getScaledValue"
              c:type="tool_matrix_getScaledValue"
              version="3.4">
      <doc xml:whitespace="preserve">Transform @x into [0;1] using the given @minmax values.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">a value into [0;1].</doc>
        <type name="gdouble" c:type="double"/>
      </return-value>
      <parameters>
        <parameter name="x" transfer-ownership="none">
          <doc xml:whitespace="preserve">the initial value ;</doc>
          <type name="gdouble" c:type="double"/>
        </parameter>
        <parameter name="minmax" transfer-ownership="none">
          <doc xml:whitespace="preserve">the boundaries for the @x argument.</doc>
          <type name="gdouble" c:type="double"/>
        </parameter>
      </parameters>
    </callback>
    <function name="matrix_getScaledZeroCentredLog"
              c:identifier="tool_matrix_getScaledZeroCentredLog"
              version="3.5">
      <doc xml:whitespace="preserve">Transform @x into [0;1] with a log scale with zero centred values.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">a value into [0;1].</doc>
        <type name="gdouble" c:type="double"/>
      </return-value>
      <parameters>
        <parameter name="x" transfer-ownership="none">
          <doc xml:whitespace="preserve">the initial value ;</doc>
          <type name="gdouble" c:type="double"/>
        </parameter>
        <parameter name="minmax" transfer-ownership="none">
          <doc xml:whitespace="preserve">the boundaries for the @x argument.</doc>
          <type name="gdouble" c:type="double"/>
        </parameter>
      </parameters>
    </function>
    <function name="matrix_getScaledZeroCentredLogInv"
              c:identifier="tool_matrix_getScaledZeroCentredLogInv"
              version="3.5">
      <doc xml:whitespace="preserve">Reverse function for tool_matrix_getScaledZeroCentredLog().</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">a value into [0;1].</doc>
        <type name="gdouble" c:type="double"/>
      </return-value>
      <parameters>
        <parameter name="x" transfer-ownership="none">
          <doc xml:whitespace="preserve">the initial value ;</doc>
          <type name="gdouble" c:type="double"/>
        </parameter>
        <parameter name="minmax" transfer-ownership="none">
          <doc xml:whitespace="preserve">the boundaries for the @x argument.</doc>
          <type name="gdouble" c:type="double"/>
        </parameter>
      </parameters>
    </function>
    <function name="matrix_invert"
              c:identifier="tool_matrix_invert"
              version="3.6">
      <doc xml:whitespace="preserve">Calculate the inverse matrix of matrix @mat and store it in @inv.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">FALSE if @mat is singular.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </return-value>
      <parameters>
        <parameter name="inv" transfer-ownership="none">
          <doc xml:whitespace="preserve">a matrix (out values).</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="mat" transfer-ownership="none">
          <doc xml:whitespace="preserve">a matrix.</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
      </parameters>
    </function>
    <function name="matrix_productMatrix"
              c:identifier="tool_matrix_productMatrix"
              version="3.2">
      <doc xml:whitespace="preserve">Compute the mathematical product between @matA and @matB and
put the result matrix in @matRes.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="matRes" transfer-ownership="none">
          <doc xml:whitespace="preserve">an array of floating point values of size 3x3 ;</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="matA" transfer-ownership="none">
          <doc xml:whitespace="preserve">an array of floating point values of size 3x3 ;</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="matB" transfer-ownership="none">
          <doc xml:whitespace="preserve">an array of floating point values of size 3x3.</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
      </parameters>
    </function>
    <function name="matrix_productVector"
              c:identifier="tool_matrix_productVector"
              version="3.2">
      <doc xml:whitespace="preserve">Compute the mathematical product between @matA and @vect and
put the result vector in @vectRes.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="vectRes" transfer-ownership="none">
          <doc xml:whitespace="preserve">an array of floating point values of size 3 ;</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="mat" transfer-ownership="none">
          <doc xml:whitespace="preserve">an array of floating point values of size 3x3 ;</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="vect" transfer-ownership="none">
          <doc xml:whitespace="preserve">an array of floating point values of size 3.</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
      </parameters>
    </function>
    <function name="matrix_reducePrimitiveVectors"
              c:identifier="tool_matrix_reducePrimitiveVectors">
      <doc xml:whitespace="preserve">This routine transforms the given matrix @full into a reduced array
used by V_Sim to store box definition.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">FALSE if the given matrix is planar.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </return-value>
      <parameters>
        <parameter name="reduced"
                   direction="out"
                   caller-allocates="1"
                   transfer-ownership="none">
          <doc xml:whitespace="preserve">a storage for 6 floating point values ;</doc>
          <array zero-terminated="0" c:type="double" fixed-size="6">
            <type name="gdouble" c:type="double"/>
          </array>
        </parameter>
        <parameter name="full" transfer-ownership="none">
          <doc xml:whitespace="preserve">a full 3x3 matrix to be transformed.</doc>
          <array zero-terminated="0" c:type="double" fixed-size="9">
            <type name="gdouble" c:type="double"/>
          </array>
        </parameter>
      </parameters>
    </function>
    <function name="matrix_sphericalToCartesian"
              c:identifier="tool_matrix_sphericalToCartesian"
              version="3.3">
      <doc xml:whitespace="preserve">A method to transform spherical coordinates (radius, phi and theta)
to cartesian coordinates.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="cartesian" transfer-ownership="none">
          <doc xml:whitespace="preserve">an allocated array of 3 floating point values to store the result ;</doc>
          <type name="gfloat" c:type="float*"/>
        </parameter>
        <parameter name="spherical" transfer-ownership="none">
          <doc xml:whitespace="preserve">an allocated array of 3 floating point values to read the input.</doc>
          <type name="gfloat" c:type="float*"/>
        </parameter>
      </parameters>
    </function>
    <function name="node_array_newNodes"
              c:identifier="visu_node_array_newNodes"
              moved-to="NodeArray.newNodes">
      <doc xml:whitespace="preserve">Create a new #VisuNodeArray structure, allocate all necessary values.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">a newly created #VisuNodeArray object.</doc>
        <type name="NodeArray" c:type="VisuNodeArray*"/>
      </return-value>
      <parameters>
        <parameter name="nTypes" transfer-ownership="none">
          <doc xml:whitespace="preserve">the size of nNodes.</doc>
          <type name="guint" c:type="unsigned int"/>
        </parameter>
        <parameter name="nNodes" transfer-ownership="none">
          <doc xml:whitespace="preserve">an array giving the number of nodes per element.</doc>
          <array length="0" zero-terminated="0" c:type="unsigned int*">
            <type name="guint" c:type="unsigned int"/>
          </array>
        </parameter>
      </parameters>
    </function>
    <function name="node_property_newInteger"
              c:identifier="visu_node_property_newInteger"
              moved-to="NodeProperty.newInteger">
      <doc xml:whitespace="preserve">This method creates and allocates a new area to store nodes associated integer
values. This is the same than visu_node_property_newPointer() but for static
integers instead of pointers as data.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">the newly created #VisuNodeProperty object.</doc>
        <type name="NodeProperty" c:type="VisuNodeProperty*"/>
      </return-value>
      <parameters>
        <parameter name="nodeArray" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuNodeArray object ;</doc>
          <type name="NodeArray" c:type="VisuNodeArray*"/>
        </parameter>
        <parameter name="key" transfer-ownership="none">
          <doc xml:whitespace="preserve">a string.</doc>
          <type name="utf8" c:type="char*"/>
        </parameter>
      </parameters>
    </function>
    <function name="object_redraw"
              c:identifier="visu_object_redraw"
              moved-to="Object.redraw">
      <return-value transfer-ownership="none">
        <type name="gboolean" c:type="gboolean"/>
      </return-value>
      <parameters>
        <parameter name="data" transfer-ownership="none">
          <type name="gpointer" c:type="gpointer"/>
        </parameter>
      </parameters>
    </function>
    <function name="object_redrawForce"
              c:identifier="visu_object_redrawForce"
              moved-to="Object.redrawForce">
      <return-value transfer-ownership="none">
        <type name="gboolean" c:type="gboolean"/>
      </return-value>
      <parameters>
        <parameter name="data" transfer-ownership="none">
          <type name="gpointer" c:type="gpointer"/>
        </parameter>
      </parameters>
    </function>
    <function name="option_free"
              c:identifier="tool_option_free"
              moved-to="Option.free">
      <doc xml:whitespace="preserve">Free the memory used by the @data.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="data" transfer-ownership="none">
          <doc xml:whitespace="preserve">the #Option to free.</doc>
          <type name="gpointer" c:type="gpointer"/>
        </parameter>
      </parameters>
    </function>
    <function name="option_new"
              c:identifier="tool_option_new"
              moved-to="Option.new">
      <doc xml:whitespace="preserve">Create a new #Option using the name as identifier.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">a newly created option, use tool_option_free() to free it.</doc>
        <type name="Option" c:type="ToolOption*"/>
      </return-value>
      <parameters>
        <parameter name="name" transfer-ownership="none">
          <doc xml:whitespace="preserve">a string identifying the option ;</doc>
          <type name="utf8" c:type="gchar*"/>
        </parameter>
        <parameter name="label" transfer-ownership="none">
          <doc xml:whitespace="preserve">a string describing shortly the option (must be in UTF-8).</doc>
          <type name="utf8" c:type="gchar*"/>
        </parameter>
        <parameter name="g_type" transfer-ownership="none">
          <doc xml:whitespace="preserve">the type of option to create.</doc>
          <type name="GType" c:type="GType"/>
        </parameter>
      </parameters>
    </function>
    <function name="pixmap_context_new"
              c:identifier="visu_pixmap_context_new"
              moved-to="PixmapContext.new">
      <doc xml:whitespace="preserve">Create a pixmap storage and a context associated to it. This pixmap
can then be used to dump pixel data from an OpenGL area.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">a newly allocated #DumpImage object.</doc>
        <type name="PixmapContext" c:type="VisuPixmapContext*"/>
      </return-value>
      <parameters>
        <parameter name="width" transfer-ownership="none">
          <doc xml:whitespace="preserve">an integer ;</doc>
          <type name="guint" c:type="guint"/>
        </parameter>
        <parameter name="height" transfer-ownership="none">
          <doc xml:whitespace="preserve">an integer.</doc>
          <type name="guint" c:type="guint"/>
        </parameter>
      </parameters>
    </function>
    <function name="renderingAtomic_getAllShapes"
              c:identifier="visu_renderingAtomic_getAllShapes">
      <doc xml:whitespace="preserve">This methods retrieve the whole list of shape names used by V_Sim for example
in the resources file. These names are not translated. If internationalized
names are required, use visu_renderingAtomic_getAllShapesI18n() instead.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">a pointer to a list of shape names (should not be modified or freed).</doc>
        <array c:type="char**">
          <type name="filename"/>
        </array>
      </return-value>
    </function>
    <function name="renderingAtomic_getAllShapesI18n"
              c:identifier="visu_renderingAtomic_getAllShapesI18n">
      <doc xml:whitespace="preserve">This methods retrieve the whole list of shape names, translated strings.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">a pointer to a list of shape names (should not be modified or freed).</doc>
        <array c:type="char**">
          <type name="utf8"/>
        </array>
      </return-value>
    </function>
    <function name="renderingAtomic_getElipsoidPhi"
              c:identifier="visu_renderingAtomic_getElipsoidPhi">
      <doc xml:whitespace="preserve">Retrieve the phi angle parameter of the elipsoid shape for the element @ele.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">the phi angle of the elipsoid.</doc>
        <type name="gfloat" c:type="float"/>
      </return-value>
      <parameters>
        <parameter name="ele" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuElement object.</doc>
          <type name="Element" c:type="VisuElement*"/>
        </parameter>
      </parameters>
    </function>
    <function name="renderingAtomic_getElipsoidRatio"
              c:identifier="visu_renderingAtomic_getElipsoidRatio">
      <doc xml:whitespace="preserve">Retrieve the ratio parameter of the elipsoid shape for the element @ele.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">the ratio of the elipsoid.</doc>
        <type name="gfloat" c:type="float"/>
      </return-value>
      <parameters>
        <parameter name="ele" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuElement object.</doc>
          <type name="Element" c:type="VisuElement*"/>
        </parameter>
      </parameters>
    </function>
    <function name="renderingAtomic_getElipsoidTheta"
              c:identifier="visu_renderingAtomic_getElipsoidTheta">
      <doc xml:whitespace="preserve">Retrieve the theta angle parameter of the elipsoid shape for the element @ele.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">the theta angle of the elipsoid.</doc>
        <type name="gfloat" c:type="float"/>
      </return-value>
      <parameters>
        <parameter name="ele" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuElement object.</doc>
          <type name="Element" c:type="VisuElement*"/>
        </parameter>
      </parameters>
    </function>
    <function name="renderingAtomic_getRadius"
              c:identifier="visu_renderingAtomic_getRadius">
      <doc xml:whitespace="preserve">In the rendering atomic method, shapes are characterized by
a radius. This method gets it for the specified element. If this
element has no radius defined yet, the default value is
associated and returned.

goies wrong.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">the radius of the specified element. A negative value if something</doc>
        <type name="gfloat" c:type="float"/>
      </return-value>
      <parameters>
        <parameter name="ele" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuElement object.</doc>
          <type name="Element" c:type="VisuElement*"/>
        </parameter>
      </parameters>
    </function>
    <function name="renderingAtomic_getRadiusDefault"
              c:identifier="visu_renderingAtomic_getRadiusDefault">
      <doc xml:whitespace="preserve">This method gets the default radius of the rendering atomic method.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">the default value for radius resource.</doc>
        <type name="gfloat" c:type="float"/>
      </return-value>
    </function>
    <function name="renderingAtomic_getShape"
              c:identifier="visu_renderingAtomic_getShape">
      <doc xml:whitespace="preserve">In the rendering atomic method, shapes are multiple.
This method gets it for the specified element. Shapes are
characterized by their id, corresponding to an integer value.
Use the enum #VisuAtomicShapeId to associate an integer value
to a specific shape.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">the shape id of the element @ele.</doc>
        <type name="AtomicShapeId" c:type="VisuAtomicShapeId"/>
      </return-value>
      <parameters>
        <parameter name="ele" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuElement object.</doc>
          <type name="Element" c:type="VisuElement*"/>
        </parameter>
      </parameters>
    </function>
    <function name="renderingAtomic_getShapeDefault"
              c:identifier="visu_renderingAtomic_getShapeDefault">
      <doc xml:whitespace="preserve">This method gets the default shape.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">the default shape id.</doc>
        <type name="AtomicShapeId" c:type="VisuAtomicShapeId"/>
      </return-value>
    </function>
    <function name="renderingAtomic_getShapeName"
              c:identifier="visu_renderingAtomic_getShapeName">
      <doc xml:whitespace="preserve">This method does the corresponding between a shape id and
its name (a string value).</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">the name associated to a shape.</doc>
        <type name="utf8" c:type="char*"/>
      </return-value>
      <parameters>
        <parameter name="shape" transfer-ownership="none">
          <doc xml:whitespace="preserve">an integer.</doc>
          <type name="AtomicShapeId" c:type="VisuAtomicShapeId"/>
        </parameter>
      </parameters>
    </function>
    <function name="renderingAtomic_getShapeNameDefault"
              c:identifier="visu_renderingAtomic_getShapeNameDefault">
      <doc xml:whitespace="preserve">This method is used to retrieve the default name for shapes.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">the name associated to the default shape.</doc>
        <type name="utf8" c:type="char*"/>
      </return-value>
    </function>
    <function name="renderingAtomic_setElipsoidParameters"
              c:identifier="visu_renderingAtomic_setElipsoidParameters">
      <doc xml:whitespace="preserve">Change the parameters for the elipsoid shape for the given @ele.
These parameters include a @ratio which is the ratio of the
long axis on the short one. Thus @ratio is always equal or greater than 1.
Arguments @theta and @phi are the direction of the long axis.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">TRUE if visu_rendering_createElement() should be called.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </return-value>
      <parameters>
        <parameter name="ele" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuElement object ;</doc>
          <type name="Element" c:type="VisuElement*"/>
        </parameter>
        <parameter name="ratio" transfer-ownership="none">
          <doc xml:whitespace="preserve">a float ;</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="phi" transfer-ownership="none">
          <doc xml:whitespace="preserve">a float ;</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
        <parameter name="theta" transfer-ownership="none">
          <doc xml:whitespace="preserve">a float.</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
      </parameters>
    </function>
    <function name="renderingAtomic_setElipsoidPhi"
              c:identifier="visu_renderingAtomic_setElipsoidPhi">
      <doc xml:whitespace="preserve">Set the phi angle parameter of the elipsoid shape for the element @ele.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">TRUE if visu_rendering_createElement() should be called.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </return-value>
      <parameters>
        <parameter name="ele" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuElement object.</doc>
          <type name="Element" c:type="VisuElement*"/>
        </parameter>
        <parameter name="phi" transfer-ownership="none">
          <doc xml:whitespace="preserve">a float ;</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
      </parameters>
    </function>
    <function name="renderingAtomic_setElipsoidRatio"
              c:identifier="visu_renderingAtomic_setElipsoidRatio">
      <doc xml:whitespace="preserve">Set the ratio parameter of the elipsoid shape for the element @ele.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">TRUE if visu_rendering_createElement() should be called.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </return-value>
      <parameters>
        <parameter name="ele" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuElement object.</doc>
          <type name="Element" c:type="VisuElement*"/>
        </parameter>
        <parameter name="ratio" transfer-ownership="none">
          <doc xml:whitespace="preserve">a float ;</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
      </parameters>
    </function>
    <function name="renderingAtomic_setElipsoidTheta"
              c:identifier="visu_renderingAtomic_setElipsoidTheta">
      <doc xml:whitespace="preserve">Set the theta angle parameter of the elipsoid shape for the element @ele.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">TRUE if visu_rendering_createElement() should be called.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </return-value>
      <parameters>
        <parameter name="ele" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuElement object.</doc>
          <type name="Element" c:type="VisuElement*"/>
        </parameter>
        <parameter name="theta" transfer-ownership="none">
          <doc xml:whitespace="preserve">a float.</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
      </parameters>
    </function>
    <function name="renderingAtomic_setRadius"
              c:identifier="visu_renderingAtomic_setRadius">
      <doc xml:whitespace="preserve">This change the radius value of element @ele to @value.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">1 if a call to visu_rendering_createElement() is required, 0 if not.</doc>
        <type name="gint" c:type="int"/>
      </return-value>
      <parameters>
        <parameter name="ele" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuElement object ;</doc>
          <type name="Element" c:type="VisuElement*"/>
        </parameter>
        <parameter name="value" transfer-ownership="none">
          <doc xml:whitespace="preserve">a positive floating point value.</doc>
          <type name="gfloat" c:type="float"/>
        </parameter>
      </parameters>
    </function>
    <function name="renderingAtomic_setShape"
              c:identifier="visu_renderingAtomic_setShape">
      <doc xml:whitespace="preserve">This changes the shape of the element @ele to the shape defined by its id.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">1 if a call to visu_rendering_createElement() is required, 0 if not.</doc>
        <type name="gint" c:type="int"/>
      </return-value>
      <parameters>
        <parameter name="ele" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuElement object ;</doc>
          <type name="Element" c:type="VisuElement*"/>
        </parameter>
        <parameter name="shape" transfer-ownership="none">
          <doc xml:whitespace="preserve">an integer.</doc>
          <type name="AtomicShapeId" c:type="VisuAtomicShapeId"/>
        </parameter>
      </parameters>
    </function>
    <function name="renderingAtomic_setShapeFromName"
              c:identifier="visu_renderingAtomic_setShapeFromName">
      <doc xml:whitespace="preserve">This method is equivalent to visu_renderingAtomic_setShape() but the shape is
defined by its name.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">1 if a call to visu_rendering_createElement() is required, 0 if not.</doc>
        <type name="gint" c:type="int"/>
      </return-value>
      <parameters>
        <parameter name="ele" transfer-ownership="none">
          <doc xml:whitespace="preserve">a #VisuElement object ;</doc>
          <type name="Element" c:type="VisuElement*"/>
        </parameter>
        <parameter name="shape" transfer-ownership="none">
          <doc xml:whitespace="preserve">a string.</doc>
          <type name="utf8" c:type="char*"/>
        </parameter>
      </parameters>
    </function>
    <function name="surfaces_resources_copy"
              c:identifier="visu_surfaces_resources_copy"
              introspectable="0">
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="res" transfer-ownership="none">
          <type c:type="VisuSurfacesResources*"/>
        </parameter>
        <parameter name="res_old" transfer-ownership="none">
          <type c:type="VisuSurfacesResources*"/>
        </parameter>
      </parameters>
    </function>
    <function name="surfaces_resources_free"
              c:identifier="visu_surfaces_resources_free"
              introspectable="0">
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="res" transfer-ownership="none">
          <type c:type="VisuSurfacesResources*"/>
        </parameter>
      </parameters>
    </function>
    <function name="surfaces_resources_getFromName"
              c:identifier="visu_surfaces_resources_getFromName"
              introspectable="0">
      <return-value>
        <type c:type="VisuSurfacesResources*"/>
      </return-value>
      <parameters>
        <parameter name="surf_name" transfer-ownership="none">
          <type name="utf8" c:type="gchar*"/>
        </parameter>
        <parameter name="new_surf" transfer-ownership="none">
          <type name="gboolean" c:type="gboolean*"/>
        </parameter>
      </parameters>
    </function>
    <function name="uiMainClass_createMain"
              c:identifier="visu_uiMainClass_createMain">
      <doc xml:whitespace="preserve">A convenience routine to create a command panel, a rendering window
and links them together.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="panel" transfer-ownership="none">
          <doc xml:whitespace="preserve">a location for a #GtkWindow ;</doc>
          <type name="Gtk.Window" c:type="GtkWindow**"/>
        </parameter>
        <parameter name="renderWindow" transfer-ownership="none">
          <doc xml:whitespace="preserve">a location for a #GtkWindow ;</doc>
          <type name="Gtk.Window" c:type="GtkWindow**"/>
        </parameter>
        <parameter name="renderArea" transfer-ownership="none">
          <doc xml:whitespace="preserve">a location for a #GtkWidget.</doc>
          <type name="Gtk.Widget" c:type="GtkWidget**"/>
        </parameter>
      </parameters>
    </function>
    <function name="uiMainClass_getCurrentPanel"
              c:identifier="visu_uiMainClass_getCurrentPanel">
      <doc xml:whitespace="preserve">This routine can be used to get the command panel, everywhere from
V_Sim.</doc>
      <return-value transfer-ownership="full">
        <doc xml:whitespace="preserve">the command Panel.</doc>
        <type name="UiMain" c:type="VisuUiMain*"/>
      </return-value>
    </function>
    <function name="uiMainClass_getDefaultRendering"
              c:identifier="visu_uiMainClass_getDefaultRendering">
      <doc xml:whitespace="preserve">Get the rendering window of V_Sim.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">the rendering window.</doc>
        <type name="RenderingWindow" c:type="VisuRenderingWindow*"/>
      </return-value>
    </function>
    <function name="uiMainClass_getRememberPosition"
              c:identifier="visu_uiMainClass_getRememberPosition">
      <doc xml:whitespace="preserve">V_Sim can store the position of its main windows. Use this routine
to get the status of this capability.</doc>
      <return-value transfer-ownership="none">
        <doc xml:whitespace="preserve">TRUE if set.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </return-value>
    </function>
    <function name="uiMainClass_setRememberPosition"
              c:identifier="visu_uiMainClass_setRememberPosition">
      <doc xml:whitespace="preserve">V_Sim can try to remember the position of its main windows, then
open them again will result in a positioning on screen equivalent
to previous position.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="val" transfer-ownership="none">
          <doc xml:whitespace="preserve">an boolean.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </parameter>
      </parameters>
    </function>
  </namespace>
</repository>
v-sim 3.6.0-2+b2 / usr / share / gir-1.0 / v_sim-3.6.gir
