[vala] Add libgvc (graphviz) bindings.

[Evan Nemerson <evann src gnome org>]

commit 629178ced95326c2161f61fabea3d231debe7711
Author: Martin Olsson <martin minimum se>
Date:   Thu Feb 18 15:14:01 2010 -0800

    Add libgvc (graphviz) bindings.
    
    Fixes bug 596656.

 vapi/Makefile.am |    1 +
 vapi/libgvc.vapi |  197 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 198 insertions(+), 0 deletions(-)
---
diff --git a/vapi/Makefile.am b/vapi/Makefile.am
index e6b30d1..e39ed44 100644
--- a/vapi/Makefile.am
+++ b/vapi/Makefile.am
@@ -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
index 0000000..d77023c
--- /dev/null
+++ b/vapi/libgvc.vapi
@@ -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, ...);
+	}
+
+}