src/cairo-ps.h

   1 /* cairo - a vector graphics library with display and print output
   2  *
   3  * Copyright © 2002 University of Southern California
   4  *
   5  * This library is free software; you can redistribute it and/or
   6  * modify it either under the terms of the GNU Lesser General Public
   7  * License version 2.1 as published by the Free Software Foundation
   8  * (the "LGPL") or, at your option, under the terms of the Mozilla
   9  * Public License Version 1.1 (the "MPL"). If you do not alter this
  10  * notice, a recipient may use your version of this file under either
  11  * the MPL or the LGPL.
  12  *
  13  * You should have received a copy of the LGPL along with this library
  14  * in the file COPYING-LGPL-2.1; if not, write to the Free Software
  15  * Foundation, Inc., 51 Franklin Street, Suite 500, Boston, MA 02110-1335, USA
  16  * You should have received a copy of the MPL along with this library
  17  * in the file COPYING-MPL-1.1
  18  *
  19  * The contents of this file are subject to the Mozilla Public License
  20  * Version 1.1 (the "License"); you may not use this file except in
  21  * compliance with the License. You may obtain a copy of the License at
  22  * http://www.mozilla.org/MPL/
  23  *
  24  * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY
  25  * OF ANY KIND, either express or implied. See the LGPL or the MPL for
  26  * the specific language governing rights and limitations.
  27  *
  28  * The Original Code is the cairo graphics library.
  29  *
  30  * The Initial Developer of the Original Code is University of Southern
  31  * California.
  32  *
  33  * Contributor(s):
  34  *      Carl D. Worth <cworth@cworth.org>
  35  */
  36
  37 #ifndef CAIRO_PS_H
  38 #define CAIRO_PS_H
  39
  40 #include "cairo.h"
  41
  42 #if CAIRO_HAS_PS_SURFACE
  43
  44 #include <stdio.h>
  45
  46 CAIRO_BEGIN_DECLS
  47
  48 /* PS-surface functions */
  49
  50 /**
  51  * cairo_ps_level_t:
  52  * @CAIRO_PS_LEVEL_2: The language level 2 of the PostScript specification. (Since 1.6)
  53  * @CAIRO_PS_LEVEL_3: The language level 3 of the PostScript specification. (Since 1.6)
  54  *
  55  * #cairo_ps_level_t is used to describe the language level of the
  56  * PostScript Language Reference that a generated PostScript file will
  57  * conform to.
  58  *
  59  * Since: 1.6
  60  **/
  61 typedef enum _cairo_ps_level {
  62     CAIRO_PS_LEVEL_2,
  63     CAIRO_PS_LEVEL_3
  64 } cairo_ps_level_t;
  65
  66 cairo_public cairo_surface_t *
  67 cairo_ps_surface_create (const char             *filename,
  68                          double                  width_in_points,
  69                          double                  height_in_points);
  70
  71 cairo_public cairo_surface_t *
  72 cairo_ps_surface_create_for_stream (cairo_write_func_t  write_func,
  73                                     void               *closure,
  74                                     double              width_in_points,
  75                                     double              height_in_points);
  76
  77 cairo_public void
  78 cairo_ps_surface_restrict_to_level (cairo_surface_t    *surface,
  79                                     cairo_ps_level_t    level);
  80
  81 cairo_public void
  82 cairo_ps_get_levels (cairo_ps_level_t const  **levels,
  83                      int                      *num_levels);
  84
  85 cairo_public const char *
  86 cairo_ps_level_to_string (cairo_ps_level_t level);
  87
  88 cairo_public void
  89 cairo_ps_surface_set_eps (cairo_surface_t       *surface,
  90                           cairo_bool_t           eps);
  91
  92 cairo_public cairo_bool_t
  93 cairo_ps_surface_get_eps (cairo_surface_t       *surface);
  94
  95 cairo_public void
  96 cairo_ps_surface_set_size (cairo_surface_t      *surface,
  97                            double                width_in_points,
  98                            double                height_in_points);
  99
 100 cairo_public void
 101 cairo_ps_surface_dsc_comment (cairo_surface_t   *surface,
 102                               const char        *comment);
 103
 104 cairo_public void
 105 cairo_ps_surface_dsc_begin_setup (cairo_surface_t *surface);
 106
 107 cairo_public void
 108 cairo_ps_surface_dsc_begin_page_setup (cairo_surface_t *surface);
 109
 110 CAIRO_END_DECLS
 111
 112 #else  /* CAIRO_HAS_PS_SURFACE */
 113 # error Cairo was not compiled with support for the ps backend
 114 #endif /* CAIRO_HAS_PS_SURFACE */
 115
 116 #endif /* CAIRO_PS_H */