cairo/src/cairo-surface-private.h

   1 /* cairo - a vector graphics library with display and print output
   2  *
   3  * Copyright © 2002 University of Southern California
   4  * Copyright © 2005 Red Hat, Inc.
   5  *
   6  * This library is free software; you can redistribute it and/or
   7  * modify it either under the terms of the GNU Lesser General Public
   8  * License version 2.1 as published by the Free Software Foundation
   9  * (the "LGPL") or, at your option, under the terms of the Mozilla
  10  * Public License Version 1.1 (the "MPL"). If you do not alter this
  11  * notice, a recipient may use your version of this file under either
  12  * the MPL or the LGPL.
  13  *
  14  * You should have received a copy of the LGPL along with this library
  15  * in the file COPYING-LGPL-2.1; if not, write to the Free Software
  16  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  17  * You should have received a copy of the MPL along with this library
  18  * in the file COPYING-MPL-1.1
  19  *
  20  * The contents of this file are subject to the Mozilla Public License
  21  * Version 1.1 (the "License"); you may not use this file except in
  22  * compliance with the License. You may obtain a copy of the License at
  23  * http://www.mozilla.org/MPL/
  24  *
  25  * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY
  26  * OF ANY KIND, either express or implied. See the LGPL or the MPL for
  27  * the specific language governing rights and limitations.
  28  *
  29  * The Original Code is the cairo graphics library.
  30  *
  31  * The Initial Developer of the Original Code is University of Southern
  32  * California.
  33  *
  34  * Contributor(s):
  35  *      Carl D. Worth <cworth@cworth.org>
  36  */
  37
  38 #ifndef CAIRO_SURFACE_PRIVATE_H
  39 #define CAIRO_SURFACE_PRIVATE_H
  40
  41 #include "cairo.h"
  42
  43 #include "cairo-types-private.h"
  44 #include "cairo-reference-count-private.h"
  45
  46 struct _cairo_surface {
  47     const cairo_surface_backend_t *backend;
  48
  49     /* We allow surfaces to override the backend->type by shoving something
  50      * else into surface->type. This is for "wrapper" surfaces that want to
  51      * hide their internal type from the user-level API. */
  52     cairo_surface_type_t type;
  53
  54     cairo_content_t content;
  55
  56     cairo_reference_count_t ref_count;
  57     cairo_status_t status;
  58     cairo_bool_t finished;
  59     cairo_user_data_array_t user_data;
  60
  61     cairo_matrix_t device_transform;
  62     cairo_matrix_t device_transform_inverse;
  63
  64     /* The actual resolution of the device, in dots per inch. */
  65     double x_resolution;
  66     double y_resolution;
  67
  68     /* The resolution that should be used when generating image-based
  69      * fallback; generally only used by the analysis/paginated
  70      * surfaces
  71      */
  72     double x_fallback_resolution;
  73     double y_fallback_resolution;
  74
  75     cairo_clip_t *clip;
  76
  77     /*
  78      * Each time a clip region is modified, it gets the next value in this
  79      * sequence.  This means that clip regions for this surface are uniquely
  80      * identified and updates to the clip can be readily identified
  81      */
  82     unsigned int next_clip_serial;
  83     /*
  84      * The serial number of the current clip.  This is set when
  85      * the surface clipping is set.  The gstate can then cheaply
  86      * check whether the surface clipping is already correct before
  87      * performing a rendering operation.
  88      *
  89      * The special value '0' is reserved for the unclipped case.
  90      */
  91     unsigned int current_clip_serial;
  92
  93     /* A "snapshot" surface is immutable. See _cairo_surface_snapshot. */
  94     cairo_bool_t is_snapshot;
  95
  96     /*
  97      * Surface font options, falling back to backend's default options,
  98      * and set using _cairo_surface_set_font_options(), and propagated by
  99      * cairo_surface_create_similar().
 100      */
 101     cairo_bool_t has_font_options;
 102     cairo_font_options_t font_options;
 103 };
 104
 105 #endif /* CAIRO_SURFACE_PRIVATE_H */