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. 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 */ 115