]> git.ipfire.org Git - thirdparty/vala.git/commitdiff
Add libgvc (graphviz) bindings.
authorMartin Olsson <martin@minimum.se>
Thu, 18 Feb 2010 23:14:01 +0000 (15:14 -0800)
committerEvan Nemerson <evan@coeus-group.com>
Thu, 18 Feb 2010 23:14:01 +0000 (15:14 -0800)
Fixes bug 596656.

vapi/Makefile.am
vapi/libgvc.vapi [new file with mode: 0644]

index e6b30d14a8f1a738f9b6e4508a5e3406bf27382a..e39ed4478a5585a45421de28309cf97e66925753 100644 (file)
@@ -117,6 +117,7 @@ dist_vapi_DATA = \
        libgnomeui-2.0.vapi \
        libgsf-1.deps \
        libgsf-1.vapi \
+       libgvc.vapi \
        libmagic.vapi \
        libnl-1.vapi \
        libnl-2.0.vapi \
diff --git a/vapi/libgvc.vapi b/vapi/libgvc.vapi
new file mode 100644 (file)
index 0000000..d77023c
--- /dev/null
@@ -0,0 +1,197 @@
+/*
+ * libgvc.vapi
+ *
+ * Copyright (C) 2009  Martin Olsson
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA
+ *
+ * Author:
+ *      Martin Olsson <martin@minimum.se>
+ */
+
+[CCode (cprefix = "", lower_case_cprefix = "", cheader_filename = "graphviz/gvc.h")]
+namespace Gvc {
+
+       /**
+        * Low-level initialization function for the graphviz library, used only if
+        * you need to explicitly control the sizes of graph, node and edge objects.
+        *
+        * Note: It's not necessary to call initlib() if you already called aginit()
+        *       because aginit() makes a call to aginitlib() internally.
+        */
+       [CCode (cname = "aginitlib", cheader_filename="gvc.h")]
+       public void initlib ( size_t graphinfo, size_t nodeinfo, size_t  edgeinfo);
+
+       /**
+        * You must call aginit() before using the graphviz API. However, note that
+        * both gvContext() and gvParseArgs() will call aginit() internally if necessary.
+        * It's safe to call aginit() multiple times.
+        *
+        * For more information of Graphviz initialization, see documention at:
+        * http://graphviz.org/pdf/libguide.pdf
+        */
+       [CCode (cname = "aginit")]
+       public void init ();
+
+       [CCode (cprefix = "")]
+       public enum GraphKind {
+               AGRAPH,
+               AGRAPHSTRICT,
+               AGDIGRAPH,
+               AGDIGRAPHSTRICT,
+               AGMETAGRAPH,
+       }
+
+       [CCode (cname = "agerrlevel_t", cheader_filename = "gvc.h", cprefix = "")]
+       public enum ErrorLevel {
+               AGWARN,
+               AGERR,
+               AGMAX,
+               AGPREV
+       }
+
+       [Compact]
+       [CCode (cname = "GVC_t", free_function = "gvFreeContext")]
+       public class Context {
+               [CCode (cname = "gvContext")]
+               public Context ();
+
+               [CCode (cname = "gvParseArgs")]
+               public int parse_args ( [CCode (array_length_pos = 0.9)] string[] argv );
+
+               [CCode (cname = "gvLayout")]
+               public int layout (Graph graph, [CCode (type = "char*")] string layout_engine);
+
+               [CCode (cname = "gvFreeLayout")]
+               public int free_layout (Graph graph);
+
+               [CCode (cname = "gvRender")]
+               public int render (Graph graph, [CCode (type = "char*")] string file_type, GLib.FileStream? file);
+
+               [CCode (cname = "gvRenderFilename")]
+               public int render_filename (Graph graph, [CCode (type = "char*")] string file_type, [CCode (type = "char*")] string filename);
+
+               [CCode (cname = "gvLayoutJobs")]
+               public int layout_jobs (Graph graph);
+
+               [CCode (cname = "gvRenderJobs")]
+               public int render_jobs (Graph graph);
+       }
+
+       [Compact]
+       [CCode (cname = "Agnode_t", ref_function = "", unref_function = "", free_function = "")]
+       public class Node {
+               [CCode (cname = "agget")]
+               public unowned string? get ([CCode (type = "char*")] string attribute_name);
+
+               [CCode (cname = "agset")]
+               public void set ([CCode (type = "char*")] string attribute_name, [CCode (type = "char*")] string attribute_value);
+
+               [CCode (cname = "agsafeset")]
+               public void safe_set ([CCode (type = "char*")] string attribute_name, [CCode (type = "char*")] string attribute_value, [CCode (type = "char*")] string? default_value);
+       }
+
+       [Compact]
+       [CCode (cname = "Agedge_t", ref_function = "", unref_function = "", free_function = "")]
+       public class Edge {
+               [CCode (cname = "agget")]
+               public unowned string? get ([CCode (type = "char*")] string attribute_name);
+
+               [CCode (cname = "agset")]
+               public int set ([CCode (type = "char*")] string attribute_name, [CCode (type = "char*")] string attribute_value);
+
+               [CCode (cname = "agsafeset")]
+               public int safe_set ([CCode (type = "char*")] string attribute_name, [CCode (type = "char*")] string attribute_value, [CCode (type = "char*")] string? default_value);
+       }
+
+       [Compact]
+       [CCode (cname = "Agraph_t", free_function = "agclose")]
+       public class Graph {
+               [CCode (cname = "agopen")]
+               public Graph ([CCode (type = "char*")] string graph_name, GraphKind kind);
+
+               [CCode (cname = "agread")]
+               public static Graph read (GLib.FileStream file);
+
+               [CCode (cname = "agnode")]
+               public Node create_node ([CCode (type = "char*")] string node_name);
+
+               [CCode (cname = "agedge")]
+               public Edge create_edge (Node from, Node to);
+
+               [CCode (cname = "agfindnode")]
+               public Node? find_node ([CCode (type = "char*")] string node_name);
+
+               [CCode (cname = "agfstnode")]
+               public Node? get_first_node ();
+
+               [CCode (cname = "agnxtnode")]
+               public Node? get_next_node (Node node);
+
+               [CCode (cname = "agget")]
+               public unowned string? get ([CCode (type = "char*")] string attribute_name);
+
+               [CCode (cname = "agset")]
+               public int set ([CCode (type = "char*")] string attribute_name, [CCode (type = "char*")] string attribute_value);
+
+               [CCode (cname = "agsafeset")]
+               public int safe_set ([CCode (type = "char*")] string attribute_name, [CCode (type = "char*")] string attribute_value, [CCode (type = "char*")] string? default_value);
+
+               [CCode (cname = "AG_IS_DIRECTED")]
+               public bool is_directed ();
+
+               [CCode (cname = "AG_IS_STRICT")]
+               public bool is_strict ();
+
+       }
+
+       /**
+        * Graphviz has this concept of "referenced counted strings" to save memory.
+        * In addition, there is a special type of string in Graphviz called an "HTML string".
+        * More information about graphviz "HTML strings" can be found at:
+        * http://www.graphviz.org/doc/info/shapes.html#html
+        * And also near the end of page 9 in:  http://graphviz.org/pdf/libguide.pdf
+        */
+       [CCode (cname = "char", copy_function = "agdupstr_html", free_function = "agstrfree")]
+       public class HtmlString : string {
+               [CCode (cname = "agstrdup_html")]
+               public HtmlString (string markup);
+       }
+
+       [CCode(cprefix = "ag")]
+       namespace Error {
+               [CCode (cname = "agerrno")]
+               public static ErrorLevel errno;
+
+               [CCode (cname = "agerr")]
+               public static int error (ErrorLevel level, string fmt, ...);
+
+               [CCode (cname = "agerrors")]
+               public static int errors ();
+
+               [CCode (cname = "agseterr")]
+               public static void set_error (ErrorLevel err);
+
+               [CCode (cname = "aglasterr")]
+               public static string? last_error ();
+
+               [CCode (cname = "agerrorf")]
+               public static void errorf (string format, ...);
+
+               [CCode (cname = "agwarningf")]
+               void warningf (string fmt, ...);
+       }
+
+}