cairo/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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 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.
  53  * @CAIRO_PS_LEVEL_3: The language level 3 of the PostScript specification.
  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 typedef enum _cairo_ps_level {
  60     CAIRO_PS_LEVEL_2,
  61     CAIRO_PS_LEVEL_3
  62 } cairo_ps_level_t;
  63
  64 cairo_public cairo_surface_t *
  65 cairo_ps_surface_create (const char             *filename,
  66                          double                  width_in_points,
  67                          double                  height_in_points);
  68
  69 cairo_public cairo_surface_t *
  70 cairo_ps_surface_create_for_stream (cairo_write_func_t  write_func,
  71                                     void               *closure,
  72                                     double              width_in_points,
  73                                     double              height_in_points);
  74
  75 cairo_public void
  76 cairo_ps_surface_restrict_to_level (cairo_surface_t    *surface,
  77                                     cairo_ps_level_t    level);
  78
  79 cairo_public void
  80 cairo_ps_get_levels (cairo_ps_level_t const  **levels,
  81                      int                      *num_levels);
  82
  83 cairo_public const char *
  84 cairo_ps_level_to_string (cairo_ps_level_t level);
  85
  86 cairo_public void
  87 cairo_ps_surface_set_eps (cairo_surface_t       *surface,
  88                           cairo_bool_t           eps);
  89
  90 cairo_public cairo_bool_t
  91 cairo_ps_surface_get_eps (cairo_surface_t       *surface);
  92
  93 cairo_public void
  94 cairo_ps_surface_set_size (cairo_surface_t      *surface,
  95                            double                width_in_points,
  96                            double                height_in_points);
  97
  98 cairo_public void
  99 cairo_ps_surface_dsc_comment (cairo_surface_t   *surface,
 100                               const char        *comment);
 101
 102 cairo_public void
 103 cairo_ps_surface_dsc_begin_setup (cairo_surface_t *surface);
 104
 105 cairo_public void
 106 cairo_ps_surface_dsc_begin_page_setup (cairo_surface_t *surface);
 107
 108 CAIRO_END_DECLS
 109
 110 #else  /* CAIRO_HAS_PS_SURFACE */
 111 # error Cairo was not compiled with support for the ps backend
 112 #endif /* CAIRO_HAS_PS_SURFACE */
 113
 114 #endif /* CAIRO_PS_H */