vapi/libgvc.vapi

   1 /*
   2  * libgvc.vapi
   3  *
   4  * Copyright (C) 2009  Martin Olsson
   5  *
   6  * This library is free software; you can redistribute it and/or
   7  * modify it under the terms of the GNU Lesser General Public
   8  * License as published by the Free Software Foundation; either
   9  * version 2.1 of the License, or (at your option) any later version.
  10  *
  11  * This library is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14  * Lesser General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU Lesser General Public
  17  * License along with this library; if not, write to the Free Software
  18  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA
  19  *
  20  * Author:
  21  *      Martin Olsson <martin@minimum.se>
  22  */
  23
  24 [CCode (cprefix = "", lower_case_cprefix = "", cheader_filename = "graphviz/gvc.h")]
  25 namespace Gvc {
  26
  27         [CCode (cname = "aginitlib", cheader_filename="gvc.h")]
  28         public void initlib ( size_t graphinfo, size_t nodeinfo, size_t  edgeinfo);
  29
  30         [CCode (cname = "aginit")]
  31 #if WITH_CGRAPH
  32         public void init (Graph g, int kind, string rec_name, bool move_to_front);
  33 #else
  34         public void init ();
  35 #endif
  36
  37 #if WITH_CGRAPH
  38         [SimpleType]
  39         [CCode (cname = "Agdesc_t")]
  40         public struct Desc {
  41         }
  42
  43         public Desc Agdirected; // Desc.DIRECTED | Desc.MAINGRAPH;
  44         public Desc Agstrictdirected; //  Desc.DIRECTED | Desc.STRICT | Desc.MAINGRAPH;
  45         public Desc Agundirected; // Desc.MAINGRAPH;
  46         public Desc Agstrictundirected; // Desc.STRICT | Desc.MAINGRAPH;
  47 #else
  48         [CCode (cprefix = "", has_type_id = false)]
  49         public enum GraphKind {
  50                 AGRAPH,
  51                 AGRAPHSTRICT,
  52                 AGDIGRAPH,
  53                 AGDIGRAPHSTRICT,
  54                 AGMETAGRAPH,
  55         }
  56 #endif
  57
  58         [CCode (cname = "agerrlevel_t", cheader_filename = "gvc.h", cprefix = "", has_type_id = false)]
  59         public enum ErrorLevel {
  60                 AGWARN,
  61                 AGERR,
  62                 AGMAX,
  63                 AGPREV
  64         }
  65
  66         [Compact]
  67         [CCode (cname = "GVC_t", free_function = "gvFreeContext")]
  68         public class Context {
  69                 [CCode (cname = "gvContext")]
  70                 public Context ();
  71
  72                 [CCode (cname = "gvParseArgs")]
  73                 public int parse_args ( [CCode (array_length_pos = 0.9)] string[] argv );
  74
  75                 [CCode (cname = "gvLayout")]
  76                 public int layout (Graph graph, [CCode (type = "char*")] string layout_engine);
  77
  78                 [CCode (cname = "gvFreeLayout")]
  79                 public int free_layout (Graph graph);
  80
  81                 [CCode (cname = "gvRender")]
  82                 public int render (Graph graph, [CCode (type = "char*")] string file_type, GLib.FileStream? file);
  83
  84                 [CCode (cname = "gvRenderFilename")]
  85                 public int render_filename (Graph graph, [CCode (type = "char*")] string file_type, [CCode (type = "char*")] string filename);
  86
  87                 [CCode (cname = "gvLayoutJobs")]
  88                 public int layout_jobs (Graph graph);
  89
  90                 [CCode (cname = "gvRenderJobs")]
  91                 public int render_jobs (Graph graph);
  92
  93                 [CCode (cname = "gvRenderData")]
  94                 public int render_data (Graph graph, [CCode (type = "char*")] string file_type, [CCode (type = "char**")] out uint8[] output_data);
  95         }
  96
  97         [Compact]
  98         [CCode (cname = "Agnode_t", ref_function = "", unref_function = "", free_function = "")]
  99         public class Node {
 100                 [CCode (cname = "name")]
 101                 public string name;
 102
 103                 [CCode (cname = "agget")]
 104                 public unowned string? get ([CCode (type = "char*")] string attribute_name);
 105
 106                 [CCode (cname = "agset")]
 107                 public void set ([CCode (type = "char*")] string attribute_name, [CCode (type = "char*")] string attribute_value);
 108
 109                 [CCode (cname = "agsafeset")]
 110                 public void safe_set ([CCode (type = "char*")] string attribute_name, [CCode (type = "char*")] string attribute_value, [CCode (type = "char*")] string? default_value);
 111         }
 112
 113         [Compact]
 114         [CCode (cname = "Agedge_t", ref_function = "", unref_function = "", free_function = "")]
 115         public class Edge {
 116                 [CCode (cname = "agget")]
 117                 public unowned string? get ([CCode (type = "char*")] string attribute_name);
 118
 119                 [CCode (cname = "agset")]
 120                 public int set ([CCode (type = "char*")] string attribute_name, [CCode (type = "char*")] string attribute_value);
 121
 122                 [CCode (cname = "agsafeset")]
 123                 public int safe_set ([CCode (type = "char*")] string attribute_name, [CCode (type = "char*")] string attribute_value, [CCode (type = "char*")] string? default_value);
 124         }
 125
 126         [Compact]
 127         [CCode (cname = "Agraph_t", free_function = "agclose")]
 128         public class Graph {
 129                 [CCode (cname = "agopen")]
 130 #if WITH_CGRAPH
 131                 public Graph ([CCode (type = "char*")] string graph_name, Desc desc, int disc = 0);
 132 #else
 133                 public Graph ([CCode (type = "char*")] string graph_name, GraphKind kind);
 134 #endif
 135
 136                 [CCode (cname = "agread")]
 137                 public static Graph read (GLib.FileStream file);
 138
 139                 [CCode (cname = "agmemread")]
 140                 public static Graph read_string (string str);
 141
 142                 [CCode (cname = "agnode")]
 143 #if WITH_CGRAPH
 144                 public Node create_node ([CCode (type = "char*")] string node_name, int createflag = 1);
 145 #else
 146                 public Node create_node ([CCode (type = "char*")] string node_name);
 147 #endif
 148
 149                 [CCode (cname = "agedge")]
 150 #if WITH_CGRAPH
 151                 public Edge create_edge (Node from, Node to, string? name = null, int createflag = 1);
 152 #else
 153                 public Edge create_edge (Node from, Node to);
 154 #endif
 155
 156                 [CCode (cname = "agsubg")]
 157                 public unowned Graph create_subgraph ([CCode (type = "char*")] string? name);
 158
 159                 [CCode (cname = "agfindsubg")]
 160                 public Graph find_subgraph ([CCode (type = "char*")] string name);
 161
 162                 [CCode (cname = "agidsubg")]
 163                 public Graph create_subgraph_id (ulong id);
 164
 165                 [CCode (cname = "agfstsubg")]
 166                 public Graph get_first_subgraph ();
 167
 168                 [CCode (cname = "agnxtsubg")]
 169                 public Graph get_next_subgraph ();
 170
 171                 [CCode (cname = "agparent")]
 172                 public Graph get_parent_graph ();
 173
 174                 [CCode (cname = "agdelsubg")]
 175                 public int delete_subgraph (Graph subgraph);
 176
 177                 [CCode (cname = "agfindnode")]
 178                 public Node? find_node ([CCode (type = "char*")] string node_name);
 179
 180                 [CCode (cname = "agfstnode")]
 181                 public Node? get_first_node ();
 182
 183                 [CCode (cname = "agnxtnode")]
 184                 public Node? get_next_node (Node node);
 185
 186                 [CCode (cname = "agget")]
 187                 public unowned string? get ([CCode (type = "char*")] string attribute_name);
 188
 189                 [CCode (cname = "agset")]
 190                 public int set ([CCode (type = "char*")] string attribute_name, [CCode (type = "char*")] string attribute_value);
 191
 192                 [CCode (cname = "agsafeset")]
 193                 public int safe_set ([CCode (type = "char*")] string attribute_name, [CCode (type = "char*")] string attribute_value, [CCode (type = "char*")] string? default_value);
 194
 195                 [CCode (cname = "AG_IS_DIRECTED")]
 196                 public bool is_directed ();
 197
 198                 [CCode (cname = "AG_IS_STRICT")]
 199                 public bool is_strict ();
 200
 201         }
 202
 203         [CCode (cname = "char", copy_function = "agdupstr_html", free_function = "agstrfree")]
 204         public class HtmlString : string {
 205                 [CCode (cname = "agstrdup_html")]
 206                 public HtmlString (string markup);
 207         }
 208
 209         [CCode(cprefix = "ag")]
 210         namespace Error {
 211                 [CCode (cname = "agerrno")]
 212                 public static ErrorLevel errno;
 213
 214                 [CCode (cname = "agerr")]
 215                 [PrintfFormat]
 216                 public static int error (ErrorLevel level, string fmt, ...);
 217
 218                 [CCode (cname = "agerrors")]
 219                 public static int errors ();
 220
 221                 [CCode (cname = "agseterr")]
 222                 public static void set_error (ErrorLevel err);
 223
 224                 [CCode (cname = "aglasterr")]
 225                 public static string? last_error ();
 226
 227                 [CCode (cname = "agerrorf")]
 228                 [PrintfFormat]
 229                 public static void errorf (string format, ...);
 230
 231                 [CCode (cname = "agwarningf")]
 232                 [PrintfFormat]
 233                 void warningf (string fmt, ...);
 234         }
 235
 236 }