cairo.vapi 35.9 KB
Newer Older
1 2
/* cairo.vala
 *
3
 * Copyright (C) 2006-2009  Jürg Billeter
4 5 6 7
 *
 * 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
8
 * version 2.1 of the License, or (at your option) any later version.
9 10 11 12 13 14 15 16 17 18 19 20 21 22

 * 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:
 * 	Jürg Billeter <j@bitron.ch>
 */

Rob Taylor's avatar
Rob Taylor committed
23
[CCode (cheader_filename = "cairo.h", gir_namespace = "cairo", gir_version = "1.0")]
24
namespace Cairo {
25 26 27 28 29 30 31 32 33 34 35 36
	[CCode (lower_case_cprefix = "CAIRO_MIME_TYPE_")]
	namespace MimeType {
		public const string JBIG2;
		public const string JBIG2_GLOBAL;
		public const string JBIG2_GLOBAL_ID;
		public const string JP2;
		public const string JPEG;
		public const string PNG;
		public const string UNIQUE_ID;
		public const string URI;
	}
	[CCode (cname = "cairo_t", cprefix = "cairo_", ref_function = "cairo_reference", unref_function = "cairo_destroy")]
37
	[Compact]
38
	public class Context {
39
		[CCode (cname = "cairo_create")]
40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60
		public Context (Cairo.Surface target);
		public void append_path (Cairo.Path path);
		public void arc (double xc, double yc, double radius, double angle1, double angle2);
		public void arc_negative (double xc, double yc, double radius, double angle1, double angle2);
		public void clip ();
		public void clip_extents (out double x1, out double y1, out double x2, out double y2);
		public void clip_preserve ();
		public void close_path ();
		public Cairo.RectangleList copy_clip_rectangle_list ();
		public void copy_page ();
		public Cairo.Path copy_path ();
		public Cairo.Path copy_path_flat ();
		public void curve_to (double x1, double y1, double x2, double y2, double x3, double y3);
		public void device_to_user (ref double x, ref double y);
		public void device_to_user_distance (ref double dx, ref double dy);
		public void fill ();
		public void fill_extents (out double x1, out double y1, out double x2, out double y2);
		public void fill_preserve ();
		public void font_extents (out Cairo.FontExtents extents);
		public Cairo.Antialias get_antialias ();
		public void get_current_point (out double x, out double y);
61 62
		public void get_dash (double[]? dashes, double[]? offset);
		public int get_dash_count ();
63 64 65 66 67 68 69
		public Cairo.FillRule get_fill_rule ();
		public unowned Cairo.FontFace get_font_face ();
		public void get_font_matrix (out Cairo.Matrix matrix);
		public void get_font_options (out Cairo.FontOptions options);
		public unowned Cairo.Surface get_group_target ();
		public Cairo.LineCap get_line_cap ();
		public Cairo.LineJoin get_line_join ();
70
		public double get_line_width ();
71
		public Cairo.Matrix get_matrix ();
72
		public double get_miter_limit ();
73 74 75 76 77
		public Cairo.Operator get_operator ();
		public uint get_reference_count ();
		public unowned Cairo.ScaledFont get_scaled_font ();
		public unowned Cairo.Pattern get_source ();
		public unowned Cairo.Surface get_target ();
78
		public double get_tolerance ();
79 80
		[CCode (simple_generics = true)]
		public unowned G? get_user_data<G> (Cairo.UserDataKey? key);
81 82 83 84
		public void glyph_extents (Cairo.Glyph[] glyphs, out Cairo.TextExtents extents);
		public void glyph_path (Cairo.Glyph[] glyphs);
		public bool has_current_point ();
		public void identity_matrix ();
85
		public bool in_clip (double x, double y);
86 87 88
		public bool in_fill (double x, double y);
		public bool in_stroke (double x, double y);
		public void line_to (double x, double y);
89 90
		public void mask (Cairo.Pattern pattern);
		public void mask_surface (Cairo.Surface surface, double surface_x, double surface_y);
91
		public void move_to (double x, double y);
92 93 94 95 96 97 98 99 100
		public void new_path ();
		public void new_sub_path ();
		public void paint ();
		public void paint_with_alpha (double alpha);
		public void path_extents (out double x1, out double y1, out double x2, out double y2);
		public Cairo.Pattern pop_group ();
		public void pop_group_to_source ();
		public void push_group ();
		public void push_group_with_content (Cairo.Content content);
101 102 103 104
		public void rectangle (double x, double y, double width, double height);
		public void rel_curve_to (double dx1, double dy1, double dx2, double dy2, double dx3, double dy3);
		public void rel_line_to (double dx, double dy);
		public void rel_move_to (double dx, double dy);
105 106
		public void reset_clip ();
		public void restore ();
107
		public void rotate (double angle);
108 109 110 111 112 113 114 115 116
		public void save ();
		public void scale (double sx, double sy);
		public void select_font_face (string family, Cairo.FontSlant slant, Cairo.FontWeight weight);
		public void set_antialias (Cairo.Antialias antialias);
		public void set_dash (double[]? dashes, double offset);
		public void set_fill_rule (Cairo.FillRule fill_rule);
		public void set_font_face (Cairo.FontFace font_face);
		public void set_font_matrix (Cairo.Matrix matrix);
		public void set_font_options (Cairo.FontOptions options);
117
		public void set_font_size (double size);
118 119 120 121 122 123 124 125 126 127 128 129
		public void set_line_cap (Cairo.LineCap line_cap);
		public void set_line_join (Cairo.LineJoin line_join);
		public void set_line_width (double width);
		public void set_matrix (Cairo.Matrix matrix);
		public void set_miter_limit (double limit);
		public void set_operator (Cairo.Operator op);
		public void set_scaled_font (Cairo.ScaledFont font);
		public void set_source (Cairo.Pattern source);
		public void set_source_rgb (double red, double green, double blue);
		public void set_source_rgba (double red, double green, double blue, double alpha);
		public void set_source_surface (Cairo.Surface surface, double x, double y);
		public void set_tolerance (double tolerance);
130 131
		[CCode (simple_generics = true)]
		public Cairo.Status set_user_data<G> (Cairo.UserDataKey? key, owned G? data);
132 133
		public void show_glyphs (Cairo.Glyph[] glyphs);
		public void show_page ();
134
		public void show_text (string utf8);
135
		public Cairo.Status show_text_glyphs (string utf8, int utf8_len, Cairo.Glyph[] glyphs, Cairo.TextCluster[] clusters, out Cairo.TextClusterFlags cluster_flags);
136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152
		public Cairo.Status status ();
		public void stroke ();
		public void stroke_extents (out double x1, out double y1, out double x2, out double y2);
		public void stroke_preserve ();
		public void text_extents (string utf8, out Cairo.TextExtents extents);
		public void text_path (string utf8);
		public void transform (Cairo.Matrix matrix);
		public void translate (double tx, double ty);
		public void user_to_device (ref double x, ref double y);
		public void user_to_device_distance (ref double dx, ref double dy);
	}
	[CCode (cname = "cairo_device_t", ref_function = "cairo_device_reference", unref_function = "cairo_device_destroy")]
	[Compact]
	public class Device {
		public Cairo.Status acquire ();
		public void finish ();
		public void flush ();
153
		public uint get_reference_count ();
154
		public Cairo.DeviceType get_type ();
155 156
		[CCode (simple_generics = true)]
		public unowned G? get_user_data<G> (Cairo.UserDataKey? key);
157
		public void release ();
158 159
		[CCode (simple_generics = true)]
		public Cairo.Status set_user_data<G> (Cairo.UserDataKey? key, owned G? data);
160
		public Cairo.Status status ();
161
	}
162 163 164 165 166 167 168 169 170 171 172
	[CCode (cname = "cairo_device_t", ref_function = "cairo_device_reference", unref_function = "cairo_device_destroy")]
	[Compact]
	public class DeviceObserver {
		protected DeviceObserver ();
		public double elapsed ();
		public double fill_elapsed ();
		public double glyphs_elapsed ();
		public double mask_elapsed ();
		public double paint_elapsed ();
		public Cairo.Status print (Cairo.WriteFunc write_func);
		public double stroke_elapsed ();
173
	}
174 175 176 177 178
	[CCode (cname = "cairo_font_face_t", ref_function = "cairo_font_face_reference", unref_function = "cairo_font_face_destroy")]
	[Compact]
	public class FontFace {
		public uint get_reference_count ();
		public Cairo.FontType get_type ();
179 180 181 182
		[CCode (simple_generics = true)]
		public unowned G? get_user_data<G> (Cairo.UserDataKey? key);
		[CCode (simple_generics = true)]
		public Cairo.Status set_user_data<G> (Cairo.UserDataKey? key, owned G? data);
183
		public Cairo.Status status ();
184
	}
185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201
	[CCode (cname = "cairo_font_options_t", copy_function = "cairo_font_options_copy", free_function = "cairo_font_options_destroy")]
	[Compact]
	public class FontOptions {
		[CCode (cname = "cairo_font_options_create")]
		public FontOptions ();
		public bool equal (Cairo.FontOptions other);
		public Cairo.Antialias get_antialias ();
		public Cairo.HintMetrics get_hint_metrics ();
		public Cairo.HintStyle get_hint_style ();
		public Cairo.SubpixelOrder get_subpixel_order ();
		public ulong hash ();
		public void merge (Cairo.FontOptions other);
		public void set_antialias (Cairo.Antialias antialias);
		public void set_hint_metrics (Cairo.HintMetrics hint_metrics);
		public void set_hint_style (Cairo.HintStyle hint_style);
		public void set_subpixel_order (Cairo.SubpixelOrder subpixel_order);
		public Cairo.Status status ();
202
	}
203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219
	[CCode (cname = "cairo_surface_t")]
	[Compact]
	public class ImageSurface : Cairo.Surface {
		[CCode (cname = "cairo_image_surface_create")]
		public ImageSurface (Cairo.Format format, int width, int height);
		[CCode (cname = "cairo_image_surface_create_for_data")]
		public ImageSurface.for_data ([CCode (array_length = false)] uchar[] data, Cairo.Format format, int width, int height, int stride);
		[CCode (cname = "cairo_image_surface_create_from_png")]
		public ImageSurface.from_png (string filename);
		[CCode (cname = "cairo_image_surface_create_from_png_stream")]
		public ImageSurface.from_png_stream (Cairo.ReadFunc read_func);
		[CCode (array_length = false)]
		public unowned uchar[] get_data ();
		public Cairo.Format get_format ();
		public int get_height ();
		public int get_stride ();
		public int get_width ();
220
	}
221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237
	[CCode (cname = "cairo_pattern_t", ref_function = "cairo_pattern_reference", unref_function = "cairo_pattern_destroy")]
	[Compact]
	public class MeshPattern : Cairo.Pattern {
		[CCode (cname = "cairo_pattern_create_mesh")]
		public MeshPattern ();
		public void begin_patch ();
		public void curve_to (double x1, double y1, double x2, double y2, double x3, double y3);
		public void end_patch ();
		public Cairo.Status get_control_point (uint patch_num, uint point_num, out double x, out double y);
		public Cairo.Status get_corner_color_rgba (uint patch_num, uint corner_num, out double red, out double green, out double blue, out double alpha);
		public Cairo.Status get_patch_count (out uint count);
		public Cairo.Path get_path (uint patch_num);
		public void line_to (double x, double y);
		public void move_to (double x, double y);
		public void set_control_point (uint point_num, double x, double y);
		public void set_corner_color_rgb (uint corner_num, double red, double green, double blue);
		public void set_corner_color_rgba (uint corner_num, double red, double green, double blue, double alpha);
238
	}
239
	[CCode (cname = "cairo_path_t", free_function = "cairo_path_destroy")]
240
	[Compact]
241
	public class Path {
242
		[CCode (array_length = false)]
243
		public Cairo.PathData[] data;
244
		public int num_data;
245
		public Cairo.Status status;
246
	}
247
	[CCode (cname = "cairo_pattern_t", ref_function = "cairo_pattern_reference", unref_function = "cairo_pattern_destroy")]
248
	[Compact]
249
	public class Pattern {
250 251 252
		public void add_color_stop_rgb (double offset, double red, double green, double blue);
		public void add_color_stop_rgba (double offset, double red, double green, double blue, double alpha);
		[CCode (cname = "cairo_pattern_create_for_surface")]
253 254 255 256 257 258 259 260 261
		public Pattern.for_surface (Cairo.Surface surface);
		public Cairo.Status get_color_stop_count (out int count);
		public Cairo.Status get_color_stop_rgba (int index, out double offset, out double red, out double green, out double blue, out double alpha);
		public Cairo.Extend get_extend ();
		public Cairo.Filter get_filter ();
		public Cairo.Status get_linear_points (out double x0, out double y0, out double x1, out double y1);
		public void get_matrix (out Cairo.Matrix matrix);
		public Cairo.Status get_surface (out unowned Cairo.Surface surface);
		public Cairo.PatternType get_type ();
262 263
		[CCode (simple_generics = true)]
		public unowned G? get_user_data<G> (Cairo.UserDataKey? key);
264
		[CCode (cname = "cairo_pattern_create_linear")]
265
		public Pattern.linear (double x0, double y0, double x1, double y1);
266
		[CCode (cname = "cairo_pattern_create_radial")]
267
		public Pattern.radial (double cx0, double cy0, double radius0, double cx1, double cy1, double radius1);
268 269 270 271 272 273 274
		[CCode (cname = "cairo_pattern_create_rgb")]
		public Pattern.rgb (double red, double green, double blue);
		[CCode (cname = "cairo_pattern_create_rgba")]
		public Pattern.rgba (double red, double green, double blue, double alpha);
		public void set_extend (Cairo.Extend extend);
		public void set_filter (Cairo.Filter filter);
		public void set_matrix (Cairo.Matrix matrix);
275 276
		[CCode (simple_generics = true)]
		public Cairo.Status set_user_data<G> (Cairo.UserDataKey? key, owned G? data);
277
		public Cairo.Status status ();
278
	}
279
	[CCode (cheader_filename = "cairo-pdf.h", cname = "cairo_surface_t")]
280
	[Compact]
281 282 283 284 285 286 287
	public class PdfSurface : Cairo.Surface {
		[CCode (cname = "cairo_pdf_surface_create")]
		public PdfSurface (string? filename, double width_in_points, double height_in_points);
		[CCode (cname = "cairo_pdf_surface_create_for_stream")]
		public PdfSurface.for_stream (Cairo.WriteFunc write_func, double width_in_points, double height_in_points);
		public void restrict_to_version (Cairo.PdfVersion version);
		public void set_size (double width_in_points, double height_in_points);
288
	}
289
	[CCode (cheader_filename = "cairo-ps.h", cname = "cairo_surface_t")]
290
	[Compact]
291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307
	public class PsSurface : Cairo.Surface {
		[CCode (cname = "cairo_ps_surface_create")]
		public PsSurface (string filename, double width_in_points, double height_in_points);
		public void dsc_begin_page_setup ();
		public void dsc_begin_setup ();
		public void dsc_comment (string comment);
		[CCode (cname = "cairo_ps_surface_create_for_stream")]
		public PsSurface.for_stream (Cairo.WriteFunc write_func, double width_in_points, double height_in_points);
		public bool get_eps ();
		public static void get_levels (out unowned Cairo.PsLevel[] levels);
		public void restrict_to_level (Cairo.PsLevel level);
		public void set_eps (bool eps);
		public void set_size (double width_in_points, double height_in_points);
	}
	[CCode (cname = "cairo_pattern_t", ref_function = "cairo_pattern_reference", unref_function = "cairo_pattern_destroy")]
	[Compact]
	public class RasterSourcePattern : Cairo.Pattern {
308 309
		[CCode (cname = "cairo_pattern_create_raster_source")]
		public RasterSourcePattern ();
310
		public void get_acquire (out Cairo.RasterSourceAcquireFunc acquire, out Cairo.RasterSourceReleaseFunc release);
311
		public void* get_callback_data ();
312 313 314 315 316 317 318 319
		public Cairo.RasterSourceCopyFunc get_copy ();
		public Cairo.RasterSourceFinishFunc get_finish ();
		public Cairo.RasterSourceSnapshotFunc get_snapshot ();
		public void set_acquire (Cairo.RasterSourceAcquireFunc acquire, Cairo.RasterSourceReleaseFunc release);
		public void set_callback_data (void* data);
		public void set_copy (Cairo.RasterSourceCopyFunc copy);
		public void set_finish (Cairo.RasterSourceFinishFunc finish);
		public void set_snapshot (Cairo.RasterSourceSnapshotFunc snapshot);
320
	}
321 322 323 324 325 326 327
	[CCode (cname = "cairo_surface_t")]
	[Compact]
	public class RecordingSurface : Cairo.Surface {
		[CCode (cname = "cairo_recording_surface_create")]
		public RecordingSurface (Cairo.Content content, Cairo.Rectangle? extents = null);
		public bool get_extents (out Cairo.Rectangle extents);
		public void ink_extents (out double x0, out double y0, out double width, out double height);
328
	}
329 330 331 332 333 334
	[CCode (cname = "cairo_rectangle_list_t", free_function = "cairo_rectangle_list_destroy")]
	[Compact]
	public class RectangleList {
		[CCode (array_length_cname = "num_rectangles")]
		public Cairo.Rectangle[] rectangles;
		public Cairo.Status status;
335
	}
336
	[CCode (cname = "cairo_region_t", ref_function = "cairo_region_reference", unref_function = "cairo_region_destroy")]
Jürg Billeter's avatar
Jürg Billeter committed
337 338 339 340
	[Compact]
	public class Region {
		[CCode (cname = "cairo_region_create")]
		public Region ();
341 342 343 344 345 346 347 348 349 350
		public bool contains_point (int x, int y);
		public Cairo.RegionOverlap contains_rectangle (Cairo.RectangleInt rectangle);
		public Cairo.Region copy ();
		public bool equal (Cairo.Region other);
		public Cairo.RectangleInt get_extents ();
		public Cairo.RectangleInt get_rectangle (int nth);
		public Cairo.Status intersect (Cairo.Region other);
		public Cairo.Status intersect_rectangle (Cairo.RectangleInt rectangle);
		public bool is_empty ();
		public int num_rectangles ();
Jürg Billeter's avatar
Jürg Billeter committed
351
		[CCode (cname = "cairo_region_create_rectangle")]
352
		public Region.rectangle (Cairo.RectangleInt rectangle);
Jürg Billeter's avatar
Jürg Billeter committed
353
		[CCode (cname = "cairo_region_create_rectangles")]
354 355 356 357
		public Region.rectangles (Cairo.RectangleInt[] rects);
		public Cairo.Status status ();
		public Cairo.Status subtract (Cairo.Region other);
		public Cairo.Status subtract_rectangle (Cairo.RectangleInt rectangle);
Jürg Billeter's avatar
Jürg Billeter committed
358
		public void translate (int dx, int dy);
359 360 361 362
		public Cairo.Status union (Cairo.Region other);
		public Cairo.Status union_rectangle (Cairo.RectangleInt rectangle);
		public Cairo.Status xor (Cairo.Region other);
		public Cairo.Status xor_rectangle (Cairo.RectangleInt rectangle);
363
	}
364
	[CCode (cname = "cairo_scaled_font_t", ref_function = "cairo_scaled_font_reference", unref_function = "cairo_scaled_font_destroy")]
365
	[Compact]
366 367 368 369 370 371 372 373
	public class ScaledFont {
		[CCode (cname = "cairo_scaled_font_create")]
		public ScaledFont (Cairo.FontFace font_face, Cairo.Matrix font_matrix, Cairo.Matrix ctm, Cairo.FontOptions options);
		public void extents (out Cairo.FontExtents extents);
		public void get_ctm (out Cairo.Matrix ctm);
		public unowned Cairo.FontFace get_font_face ();
		public void get_font_matrix (out Cairo.Matrix font_matrix);
		public void get_font_options (out Cairo.FontOptions options);
374
		public uint get_reference_count ();
375 376
		public void get_scale_matrix (out Cairo.Matrix scale_matrix);
		public Cairo.FontType get_type ();
377 378
		[CCode (simple_generics = true)]
		public unowned G? get_user_data<G> (Cairo.UserDataKey? key);
379
		public void glyph_extents (Cairo.Glyph[] glyphs, out Cairo.TextExtents extents);
380 381
		[CCode (simple_generics = true)]
		public Cairo.Status set_user_data<G> (Cairo.UserDataKey? key, owned G? data);
382 383 384 385 386 387 388 389 390
		public Cairo.Status status ();
		public void text_extents (string utf8, out Cairo.TextExtents extents);
		public Cairo.Status text_to_glyphs (double x, double y, string utf8, int utf8_len, out Cairo.Glyph[] glyphs, out Cairo.TextCluster[] clusters, out Cairo.TextClusterFlags cluster_flags);
		[CCode (cname = "cairo_win32_scaled_font_get_device_to_logical")]
		public Cairo.Matrix win32_get_device_to_logical ();
		[CCode (cname = "cairo_win32_scaled_font_get_logical_to_device")]
		public Cairo.Matrix win32_get_logical_to_device ();
	}
	[CCode (cname = "cairo_device_t", ref_function = "cairo_device_reference", unref_function = "cairo_device_destroy")]
391
	[Compact]
392
	public class Script : Cairo.Device {
393 394 395
		[CCode (cname = "cairo_script_create")]
		public Script (string filename);
		[CCode (cname = "cairo_script_create_for_stream")]
396
		public Script.for_stream (Cairo.WriteFunc write_func);
397
		[CCode (cname = "cairo_script_from_recording_surface")]
398 399 400
		public Script.from_recording_surface ([CCode (type = "cairo_surface_t")] Cairo.RecordingSurface recording_surface);
		public Cairo.ScriptMode get_mode ();
		public void set_mode (Cairo.ScriptMode mode);
401 402
		public void write_comment (string comment, int len = -1);
	}
403 404 405 406 407 408 409
	[CCode (cheader_filename = "cairo-svg.h", cname = "cairo_surface_t")]
	[Compact]
	public class ScriptSurface : Cairo.Surface {
		[CCode (cname = "cairo_script_surface_create")]
		public ScriptSurface (Cairo.Script script, Cairo.Content content, double width, double height);
		[CCode (cname = "cairo_script_surface_create_for_target")]
		public ScriptSurface.for_target (Cairo.Script script, Cairo.Surface target);
410
	}
411
	[CCode (cname = "cairo_surface_t", ref_function = "cairo_surface_reference", unref_function = "cairo_surface_destroy")]
412
	[Compact]
413
	public class Surface {
414
		public void copy_page ();
415 416
		public void finish ();
		public void flush ();
417 418 419 420
		[CCode (cname = "cairo_surface_create_for_rectangle")]
		public Surface.for_rectangle (Cairo.Surface target, double x, double y, double width, double height);
		public Cairo.Content get_content ();
		public Cairo.Device get_device ();
421 422
		public void get_device_offset (out double x_offset, out double y_offset);
		public void get_device_scale (out double x_scale, out double y_scale);
423
		public void get_fallback_resolution (out double x_pixels_per_inch, out double y_pixels_per_inch);
424
		public void get_font_options (out Cairo.FontOptions options);
425
		public uint get_reference_count ();
426
		public Cairo.SurfaceType get_type ();
427 428
		[CCode (simple_generics = true)]
		public unowned G? get_user_data<G> (Cairo.UserDataKey? key);
429
		public bool has_show_text_glyphs ();
430
		public Cairo.Surface map_to_image (Cairo.RectangleInt extents);
431 432 433
		public void mark_dirty ();
		public void mark_dirty_rectangle (int x, int y, int width, int height);
		public void set_device_offset (double x_offset, double y_offset);
434
		public void set_device_scale (double x_scale, double y_scale);
435
		public void set_fallback_resolution (double x_pixels_per_inch, double y_pixels_per_inch);
436 437
		[CCode (simple_generics = true)]
		public Cairo.Status set_user_data<G> (Cairo.UserDataKey? key, owned G? data);
438
		public void show_page ();
439 440 441 442 443
		[CCode (cname = "cairo_surface_create_similar")]
		public Surface.similar (Cairo.Surface other, Cairo.Content content, int width, int height);
		[CCode (cname = "cairo_surface_create_similar_image")]
		public Surface.similar_image (Cairo.Surface other, Cairo.Format format, int width, int height);
		public Cairo.Status status ();
444
		public bool supports_mime_type (string mime_type);
445
		public void unmap_image (Cairo.Surface image);
446
		[CCode (cname = "cairo_win32_surface_get_image")]
447 448 449
		public Cairo.Surface? win32_get_image ();
		public Cairo.Status write_to_png (string filename);
		public Cairo.Status write_to_png_stream (Cairo.WriteFunc write_func);
450
	}
451
	[CCode (cname = "cairo_surface_t", ref_function = "cairo_surface_reference", unref_function = "cairo_surface_destroy")]
452 453 454
	[Compact]
	public class SurfaceObserver {
		[CCode (cname = "cairo_surface_create_observer")]
455 456 457 458 459 460 461 462
		public SurfaceObserver (Cairo.Surface target, Cairo.SurfaceObserverMode mode);
		public Cairo.Status add_fill_callback (Cairo.SurfaceObserverCallback func);
		public Cairo.Status add_finish_callback (Cairo.SurfaceObserverCallback func);
		public Cairo.Status add_flush_callback (Cairo.SurfaceObserverCallback func);
		public Cairo.Status add_glyphs_callback (Cairo.SurfaceObserverCallback func);
		public Cairo.Status add_mask_callback (Cairo.SurfaceObserverCallback func);
		public Cairo.Status add_paint_callback (Cairo.SurfaceObserverCallback func);
		public Cairo.Status add_stroke_callback (Cairo.SurfaceObserverCallback func);
463
		public double elapsed ();
464
		public Cairo.Status print (Cairo.WriteFunc write_func);
465
	}
466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595
	[CCode (cheader_filename = "cairo-svg.h", cname = "cairo_surface_t")]
	[Compact]
	public class SvgSurface : Cairo.Surface {
		[CCode (cname = "cairo_svg_surface_create")]
		public SvgSurface (string filename, double width_in_points, double height_in_points);
		[CCode (cname = "cairo_svg_surface_create_for_stream")]
		public SvgSurface.for_stream (Cairo.WriteFunc write_func, double width_in_points, double height_in_points);
		public void restrict_to_version (Cairo.SvgVersion version);
	}
	[CCode (cname = "cairo_font_face_t", ref_function = "cairo_font_face_reference", unref_function = "cairo_font_face_destroy")]
	[Compact]
	public class ToyFontFace : Cairo.FontFace {
		[CCode (cname = "cairo_toy_font_face_create")]
		public ToyFontFace (string family, Cairo.FontSlant slant, Cairo.FontWeight weight);
		public unowned string get_family ();
		public Cairo.FontSlant get_slant ();
		public Cairo.FontWeight get_weight ();
	}
	[CCode (cname = "cairo_font_face_t", ref_function = "cairo_font_face_reference", unref_function = "cairo_font_face_destroy")]
	[Compact]
	public class UserFontFace : Cairo.FontFace {
		[CCode (cname = "cairo_user_font_face_create")]
		public UserFontFace ();
		public Cairo.UserScaledFontInitFunc get_init_func ();
		public Cairo.UserScaledFontRenderGlyphFunc get_render_glyph_func ();
		public Cairo.UserScaledFontTextToGlyphsFunc get_text_to_glyphs_func ();
		public Cairo.UserScaledFontUnicodeToGlyphFunc get_unicode_to_glyph_func ();
		public void set_init_func (Cairo.UserScaledFontInitFunc init_func);
		public void set_render_glyph_func (Cairo.UserScaledFontRenderGlyphFunc render_glyph_func);
		public void set_text_to_glyphs_func (Cairo.UserScaledFontTextToGlyphsFunc text_to_glyphs_func);
		public void set_unicode_to_glyph_func (Cairo.UserScaledFontUnicodeToGlyphFunc unicode_to_glyph_func);
	}
	[CCode (cname = "cairo_scaled_font_t", ref_function = "cairo_scaled_font_reference", unref_function = "cairo_scaled_font_destroy")]
	[Compact]
	public class UserScaledFont {
	}
	[CCode (cheader_filename = "cairo-xlib.h", cname = "cairo_surface_t")]
	[Compact]
	public class XlibSurface : Cairo.Surface {
		[CCode (cname = "cairo_xlib_surface_create")]
		public XlibSurface (void* dpy, int drawable, void* visual, int width, int height);
		[CCode (cname = "cairo_xlib_surface_create_for_bitmap")]
		public XlibSurface.for_bitmap (void* dpy, int bitmap, void* screen, int width, int height);
		public int get_depth ();
		public void* get_display ();
		public int get_drawable ();
		public int get_height ();
		public void* get_screen ();
		public void* get_visual ();
		public int get_width ();
		public void set_drawable (int drawable, int width, int height);
		public void set_size (int width, int height);
	}
	[CCode (cname = "cairo_font_extents_t", has_type_id = false)]
	public struct FontExtents {
		public double ascent;
		public double descent;
		public double height;
		public double max_x_advance;
		public double max_y_advance;
	}
	[CCode (cname = "cairo_glyph_t", has_type_id = false)]
	public struct Glyph {
		public ulong index;
		public double x;
		public double y;
	}
	[CCode (cname = "cairo_matrix_t", has_type_id = false)]
	public struct Matrix {
		public double xx;
		public double yx;
		public double xy;
		public double yy;
		public double x0;
		public double y0;
		[CCode (cname = "cairo_matrix_init")]
		public Matrix (double xx, double yx, double xy, double yy, double x0, double y0);
		[CCode (cname = "cairo_matrix_init_identity")]
		public Matrix.identity ();
		public Cairo.Status invert ();
		public void multiply (Cairo.Matrix a, Cairo.Matrix b);
		public void rotate (double radians);
		public void scale (double sx, double sy);
		public void transform_distance (ref double dx, ref double dy);
		public void transform_point (ref double x, ref double y);
		public void translate (double tx, double ty);
	}
	[CCode (cname = "cairo_path_data_t", has_type_id = false)]
	public struct PathData {
		public Cairo.PathDataHeader header;
		public Cairo.PathDataPoint point;
	}
	[CCode (cname = "struct { cairo_path_data_type_t type; int length; }", has_type_id = false)]
	public struct PathDataHeader {
		public Cairo.PathDataType type;
		public int length;
	}
	[CCode (cname = "struct { double x, y; }", has_type_id = false)]
	public struct PathDataPoint {
		public double x;
		public double y;
	}
	[CCode (cname = "cairo_rectangle_t", has_type_id = false)]
	public struct Rectangle {
		public double x;
		public double y;
		public double width;
		public double height;
	}
	[CCode (cname = "cairo_rectangle_int_t", has_type_id = false)]
	public struct RectangleInt {
		public int x;
		public int y;
		public int width;
		public int height;
	}
	[CCode (cname = "cairo_text_cluster_t", has_type_id = false)]
	public struct TextCluster {
		public int num_bytes;
		public int num_glyphs;
	}
	[CCode (cname = "cairo_text_extents_t", has_type_id = false)]
	public struct TextExtents {
		public double x_bearing;
		public double y_bearing;
		public double width;
		public double height;
		public double x_advance;
		public double y_advance;
	}
596 597 598
	[CCode (cname = "cairo_user_data_key_t", has_copy_function = false, has_destroy_function = false, has_type_id = false, lvalue_access = false)]
	public struct UserDataKey {
	}
599 600 601 602 603 604 605 606 607
	[CCode (cname = "cairo_antialias_t", has_type_id = false)]
	public enum Antialias {
		DEFAULT,
		NONE,
		GRAY,
		SUBPIXEL,
		FAST,
		GOOD,
		BEST
608
	}
609
	[CCode (cname = "cairo_content_t", has_type_id = false)]
610 611 612 613 614
	public enum Content {
		COLOR,
		ALPHA,
		COLOR_ALPHA
	}
615 616
	[CCode (cname = "cairo_device_type_t", has_type_id = false)]
	public enum DeviceType {
617
		DRM,
618 619 620 621
		GL,
		SCRIPT,
		XCB,
		XLIB,
622
		XML,
623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664
		COGL,
		WIN32
	}
	[CCode (cname = "cairo_extend_t", has_type_id = false)]
	public enum Extend {
		NONE,
		REPEAT,
		REFLECT,
		PAD
	}
	[CCode (cname = "cairo_fill_rule_t", has_type_id = false)]
	public enum FillRule {
		WINDING,
		EVEN_ODD
	}
	[CCode (cname = "cairo_filter_t", has_type_id = false)]
	public enum Filter {
		FAST,
		GOOD,
		BEST,
		NEAREST,
		BILINEAR,
		GAUSSIAN
	}
	[CCode (cname = "cairo_font_slant_t", has_type_id = false)]
	public enum FontSlant {
		NORMAL,
		ITALIC,
		OBLIQUE
	}
	[CCode (cname = "cairo_font_type_t", has_type_id = false)]
	public enum FontType {
		TOY,
		FT,
		WIN32,
		QUARTZ,
		USER
	}
	[CCode (cname = "cairo_font_weight_t", has_type_id = false)]
	public enum FontWeight {
		NORMAL,
		BOLD
665
	}
666
	[CCode (cname = "cairo_format_t", has_type_id = false)]
667
	public enum Format {
668 669 670 671 672 673 674
		ARGB32,
		RGB24,
		A8,
		A1,
		RGB16_565,
		RGB30;
		public int stride_for_width (int width);
675
	}
676 677 678 679 680
	[CCode (cname = "cairo_hint_metrics_t", has_type_id = false)]
	public enum HintMetrics {
		DEFAULT,
		OFF,
		ON
681
	}
682 683 684 685 686 687 688
	[CCode (cname = "cairo_hint_style_t", has_type_id = false)]
	public enum HintStyle {
		DEFAULT,
		NONE,
		SLIGHT,
		MEDIUM,
		FULL
689
	}
690 691 692 693 694
	[CCode (cname = "cairo_line_cap_t", has_type_id = false)]
	public enum LineCap {
		BUTT,
		ROUND,
		SQUARE
695
	}
696 697 698 699 700
	[CCode (cname = "cairo_line_join_t", has_type_id = false)]
	public enum LineJoin {
		MITER,
		ROUND,
		BEVEL
701
	}
702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732
	[CCode (cname = "cairo_operator_t", has_type_id = false)]
	public enum Operator {
		CLEAR,
		SOURCE,
		OVER,
		IN,
		OUT,
		ATOP,
		DEST,
		DEST_OVER,
		DEST_IN,
		DEST_OUT,
		DEST_ATOP,
		XOR,
		ADD,
		SATURATE,
		MULTIPLY,
		SCREEN,
		OVERLAY,
		DARKEN,
		LIGHTEN,
		COLOR_DODGE,
		COLOR_BURN,
		HARD_LIGHT,
		SOFT_LIGHT,
		DIFFERENCE,
		EXCLUSION,
		HSL_HUE,
		HSL_SATURATION,
		HSL_COLOR,
		HSL_LUMINOSITY
733
	}
734 735 736 737 738 739 740 741 742 743 744 745 746 747 748
	[CCode (cname = "cairo_path_data_type_t", cprefix = "CAIRO_PATH_", has_type_id = false)]
	public enum PathDataType {
		MOVE_TO,
		LINE_TO,
		CURVE_TO,
		CLOSE_PATH
	}
	[CCode (cname = "cairo_pattern_type_t", has_type_id = false)]
	public enum PatternType {
		SOLID,
		SURFACE,
		LINEAR,
		RADIAL,
		MESH,
		RASTER_SOURCE
749
	}
750
	[CCode (cname = "cairo_pdf_version_t", cprefix = "CAIRO_PDF_", has_type_id = false)]
751 752 753 754 755
	public enum PdfVersion {
		VERSION_1_4,
		VERSION_1_5;
		[CCode (cname = "cairo_pdf_version_to_string")]
		public unowned string to_string ();
756
		[CCode (cname = "cairo_pdf_get_versions")]
757
		public static void get_versions (out unowned Cairo.PdfVersion[] versions);
758
	}
759
	[CCode (cname = "cairo_ps_level_t", cprefix = "CAIRO_PS_", has_type_id = false)]
760 761 762 763 764
	public enum PsLevel {
		LEVEL_2,
		LEVEL_3;
		[CCode (cname = "cairo_ps_level_to_string")]
		public unowned string to_string ();
765
		[CCode (cname = "cairo_ps_get_levels")]
766
		public static void get_levels (out unowned Cairo.PsLevel[] levels);
767
	}
768 769 770 771 772
	[CCode (cname = "cairo_region_overlap_t", has_type_id = false)]
	public enum RegionOverlap {
		IN,
		OUT,
		PART
Jürg Billeter's avatar
Jürg Billeter committed
773
	}
774 775 776 777
	[CCode (cname = "cairo_script_mode_t", has_type_id = false)]
	public enum ScriptMode {
		ASCII,
		BINARY
778
	}
779
	[CCode (cname = "cairo_status_t", has_type_id = false)]
780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800
	public enum Status {
		SUCCESS,
		NO_MEMORY,
		INVALID_RESTORE,
		INVALID_POP_GROUP,
		NO_CURRENT_POINT,
		INVALID_MATRIX,
		INVALID_STATUS,
		NULL_POINTER,
		INVALID_STRING,
		INVALID_PATH_DATA,
		READ_ERROR,
		WRITE_ERROR,
		SURFACE_FINISHED,
		SURFACE_TYPE_MISMATCH,
		PATTERN_TYPE_MISMATCH,
		INVALID_CONTENT,
		INVALID_FORMAT,
		INVALID_VISUAL,
		FILE_NOT_FOUND,
		INVALID_DASH,
801 802 803 804 805 806 807 808 809 810 811 812 813 814 815
		INVALID_DSC_COMMENT,
		INVALID_INDEX,
		CLIP_NOT_REPRESENTABLE,
		TEMP_FILE_ERROR,
		INVALID_STRIDE,
		FONT_TYPE_MISMATCH,
		USER_FONT_IMMUTABLE,
		USER_FONT_ERROR,
		NEGATIVE_COUNT,
		INVALID_CLUSTERS,
		INVALID_SLANT,
		INVALID_WEIGHT,
		INVALID_SIZE,
		USER_FONT_NOT_IMPLEMENTED,
		DEVICE_TYPE_MISMATCH,
816 817 818
		DEVICE_ERROR,
		INVALID_MESH_CONSTRUCTION,
		DEVICE_FINISHED,
819 820 821 822
		JBIG2_GLOBAL_MISSING,
		PNG_ERROR,
		FREETYPE_ERROR,
		WIN32_GDI_ERROR;
823 824
		[CCode (cname = "cairo_status_to_string")]
		public unowned string to_string ();
825
	}
826 827 828 829 830 831 832
	[CCode (cname = "cairo_subpixel_order_t", has_type_id = false)]
	public enum SubpixelOrder {
		DEFAULT,
		RGB,
		BGR,
		VRGB,
		VBGR
833
	}
834 835 836 837 838 839 840 841 842 843 844 845 846 847 848 849 850 851 852 853 854 855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 882 883 884 885 886 887 888 889 890 891 892 893 894 895 896 897 898 899 900 901 902 903 904 905
	[CCode (cname = "cairo_surface_observer_mode_t", has_type_id = false)]
	public enum SurfaceObserverMode {
		NORMAL,
		RECORD_OPERATIONS
	}
	[CCode (cname = "cairo_surface_type_t", has_type_id = false)]
	public enum SurfaceType {
		IMAGE,
		PDF,
		PS,
		XLIB,
		XCB,
		GLITZ,
		QUARTZ,
		WIN32,
		BEOS,
		DIRECTFB,
		SVG,
		OS2,
		WIN32_PRINTING,
		QUARTZ_IMAGE,
		SCRIPT,
		QT,
		RECORDING,
		VG,
		GL,
		DRM,
		TEE,
		XML,
		SKIA,
		SUBSURFACE,
		COGL
	}
	[CCode (cname = "cairo_svg_version_t", cprefix = "CAIRO_SVG_", has_type_id = false)]
	public enum SvgVersion {
		VERSION_1_1,
		VERSION_1_2;
		[CCode (cname = "cairo_svg_version_to_string")]
		public unowned string to_string ();
		[CCode (cname = "cairo_svg_get_versions")]
		public static void get_versions (out unowned Cairo.SvgVersion[] versions);
	}
	[CCode (cname = "cairo_text_cluster_flags_t", cprefix = "CAIRO_TEXT_CLUSTER_FLAG_", has_type_id = false)]
	public enum TextClusterFlags {
		BACKWARD
	}
	[CCode (cname = "cairo_raster_source_acquire_func_t", has_target = false)]
	public delegate Cairo.Surface RasterSourceAcquireFunc (Cairo.Pattern pattern, void* callback_data, Cairo.Surface target, Cairo.RectangleInt? extents);
	[CCode (cname = "cairo_raster_source_copy_func_t", has_target = false)]
	public delegate Cairo.Status RasterSourceCopyFunc (Cairo.Pattern pattern, void* callback_data, Cairo.Pattern other_pattern);
	[CCode (cname = "cairo_raster_source_finish_func_t", has_target = false)]
	public delegate void RasterSourceFinishFunc (Cairo.Pattern pattern, void* callback_data);
	[CCode (cname = "cairo_raster_source_release_func_t", has_target = false)]
	public delegate void RasterSourceReleaseFunc (Cairo.Pattern pattern, void* callback_data, Cairo.Surface surface);
	[CCode (cname = "cairo_raster_source_snapshot_func_t", has_target = false)]
	public delegate Cairo.Status RasterSourceSnapshotFunc (Cairo.Pattern pattern, void* callback_data);
	[CCode (cname = "cairo_read_func_t", instance_pos = 0)]
	public delegate Cairo.Status ReadFunc (uchar[] data);
	[CCode (cname = "cairo_surface_observer_callback_t", instance_pos = 2.9)]
	public delegate void SurfaceObserverCallback (Cairo.SurfaceObserver observer, Cairo.Surface target);
	[CCode (cname = "cairo_user_scaled_font_init_func_t", has_target = false)]
	public delegate Cairo.Status UserScaledFontInitFunc (Cairo.UserScaledFont scaled_font, Cairo.Context cr, Cairo.FontExtents extents);
	[CCode (cname = "cairo_user_scaled_font_render_glyph_func_t", has_target = false)]
	public delegate Cairo.Status UserScaledFontRenderGlyphFunc (Cairo.UserScaledFont scaled_font, ulong glyph, Cairo.Context cr, out Cairo.TextExtents extents);
	[CCode (cname = "cairo_user_font_face_get_text_to_glyphs_func", has_target = false)]
	public delegate Cairo.Status UserScaledFontTextToGlyphsFunc (Cairo.UserScaledFont scaled_font, string utf8, int utf8_len, out Cairo.Glyph[] glyphs, out Cairo.TextCluster[] clusters, out Cairo.TextClusterFlags cluster_flags);
	[CCode (cname = "cairo_user_scaled_font_unicode_to_glyph_func_t", has_target = false)]
	public delegate Cairo.Status UserScaledFontUnicodeToGlyphFunc (Cairo.UserScaledFont scaled_font, ulong unicode, out ulong glyph_index);
	[CCode (cname = "cairo_write_func_t", instance_pos = 0)]
	public delegate Cairo.Status WriteFunc (uchar[] data);
	public static int version ();
	public static unowned string version_string ();
906
}