src/cairo-svg.h

   1 /* cairo - a vector graphics library with display and print output
   2  *
   3  * cairo-svg.h
   4  *
   5  * Copyright © 2005 Emmanuel Pacaud <emmanuel.pacaud@univ-poitiers.fr>
   6  *
   7  * This library is free software; you can redistribute it and/or
   8  * modify it either under the terms of the GNU Lesser General Public
   9  * License version 2.1 as published by the Free Software Foundation
  10  * (the "LGPL") or, at your option, under the terms of the Mozilla
  11  * Public License Version 1.1 (the "MPL"). If you do not alter this
  12  * notice, a recipient may use your version of this file under either
  13  * the MPL or the LGPL.
  14  *
  15  * You should have received a copy of the LGPL along with this library
  16  * in the file COPYING-LGPL-2.1; if not, write to the Free Software
  17  * Foundation, Inc., 51 Franklin Street, Suite 500, Boston, MA 02110-1335, USA
  18  * You should have received a copy of the MPL along with this library
  19  * in the file COPYING-MPL-1.1
  20  *
  21  * The contents of this file are subject to the Mozilla Public License
  22  * Version 1.1 (the "License"); you may not use this file except in
  23  * compliance with the License. You may obtain a copy of the License at
  24  * http://www.mozilla.org/MPL/
  25  *
  26  * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY
  27  * OF ANY KIND, either express or implied. See the LGPL or the MPL for
  28  * the specific language governing rights and limitations.
  29  *
  30  */
  31
  32 #ifndef CAIRO_SVG_H
  33 #define CAIRO_SVG_H
  34
  35 #include "cairo.h"
  36
  37 #if CAIRO_HAS_SVG_SURFACE
  38
  39 CAIRO_BEGIN_DECLS
  40
  41 /**
  42  * cairo_svg_version_t:
  43  * @CAIRO_SVG_VERSION_1_1: The version 1.1 of the SVG specification. (Since 1.2)
  44  * @CAIRO_SVG_VERSION_1_2: The version 1.2 of the SVG specification. (Since 1.2)
  45  *
  46  * #cairo_svg_version_t is used to describe the version number of the SVG
  47  * specification that a generated SVG file will conform to.
  48  *
  49  * Since: 1.2
  50  **/
  51 typedef enum _cairo_svg_version {
  52     CAIRO_SVG_VERSION_1_1,
  53     CAIRO_SVG_VERSION_1_2
  54 } cairo_svg_version_t;
  55
  56 cairo_public cairo_surface_t *
  57 cairo_svg_surface_create (const char   *filename,
  58                           double        width_in_points,
  59                           double        height_in_points);
  60
  61 cairo_public cairo_surface_t *
  62 cairo_svg_surface_create_for_stream (cairo_write_func_t write_func,
  63                                      void              *closure,
  64                                      double             width_in_points,
  65                                      double             height_in_points);
  66
  67 cairo_public void
  68 cairo_svg_surface_restrict_to_version (cairo_surface_t          *surface,
  69                                        cairo_svg_version_t       version);
  70
  71 cairo_public void
  72 cairo_svg_get_versions (cairo_svg_version_t const       **versions,
  73                         int                              *num_versions);
  74
  75 cairo_public const char *
  76 cairo_svg_version_to_string (cairo_svg_version_t version);
  77
  78 CAIRO_END_DECLS
  79
  80 #else  /* CAIRO_HAS_SVG_SURFACE */
  81 # error Cairo was not compiled with support for the svg backend
  82 #endif /* CAIRO_HAS_SVG_SURFACE */
  83
  84 #endif /* CAIRO_SVG_H */