mirror of
https://gitlab.freedesktop.org/cairo/cairo.git
synced 2026-05-19 13:28:08 +02:00
bed2701e1c
Handling clip as part of the surface state, as opposed to being part of the operation state, is cumbersome and a hindrance to providing true proxy surface support. For example, the clip must be copied from the surface onto the fallback image, but this was forgotten causing undue hassle in each backend. Another example is the contortion the meta surface endures to ensure the clip is correctly recorded. By contrast passing the clip along with the operation is quite simple and enables us to write generic handlers for providing surface wrappers. (And in the future, we should be able to write more esoteric wrappers, e.g. automatic 2x FSAA, trivially.) In brief, instead of the surface automatically applying the clip before calling the backend, the backend can call into a generic helper to apply clipping. For raster surfaces, clip regions are handled automatically as part of the composite interface. For vector surfaces, a clip helper is introduced to replay and callback into an intersect_clip_path() function as necessary. Whilst this is not primarily a performance related change (the change should just move the computation of the clip from the moment it is applied by the user to the moment it is required by the backend), it is important to track any potential regression: ppc: Speedups ======== image-rgba evolution-20090607-0 1026085.22 0.18% -> 672972.07 0.77%: 1.52x speedup ▌ image-rgba evolution-20090618-0 680579.98 0.12% -> 573237.66 0.16%: 1.19x speedup ▎ image-rgba swfdec-fill-rate-4xaa-0 460296.92 0.36% -> 407464.63 0.42%: 1.13x speedup ▏ image-rgba swfdec-fill-rate-2xaa-0 128431.95 0.47% -> 115051.86 0.42%: 1.12x speedup ▏ Slowdowns ========= image-rgba firefox-periodic-table-0 56837.61 0.78% -> 66055.17 3.20%: 1.09x slowdown ▏
96 lines
3.3 KiB
C
96 lines
3.3 KiB
C
/* cairo - a vector graphics library with display and print output
|
|
*
|
|
* Copyright © 2002 University of Southern California
|
|
* Copyright © 2005 Red Hat, Inc.
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it either under the terms of the GNU Lesser General Public
|
|
* License version 2.1 as published by the Free Software Foundation
|
|
* (the "LGPL") or, at your option, under the terms of the Mozilla
|
|
* Public License Version 1.1 (the "MPL"). If you do not alter this
|
|
* notice, a recipient may use your version of this file under either
|
|
* the MPL or the LGPL.
|
|
*
|
|
* You should have received a copy of the LGPL along with this library
|
|
* in the file COPYING-LGPL-2.1; if not, write to the Free Software
|
|
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|
* You should have received a copy of the MPL along with this library
|
|
* in the file COPYING-MPL-1.1
|
|
*
|
|
* The contents of this file are subject to the Mozilla Public License
|
|
* Version 1.1 (the "License"); you may not use this file except in
|
|
* compliance with the License. You may obtain a copy of the License at
|
|
* http://www.mozilla.org/MPL/
|
|
*
|
|
* This software is distributed on an "AS IS" basis, WITHOUT WARRANTY
|
|
* OF ANY KIND, either express or implied. See the LGPL or the MPL for
|
|
* the specific language governing rights and limitations.
|
|
*
|
|
* The Original Code is the cairo graphics library.
|
|
*
|
|
* The Initial Developer of the Original Code is University of Southern
|
|
* California.
|
|
*
|
|
* Contributor(s):
|
|
* Carl D. Worth <cworth@cworth.org>
|
|
*/
|
|
|
|
#ifndef CAIRO_SURFACE_PRIVATE_H
|
|
#define CAIRO_SURFACE_PRIVATE_H
|
|
|
|
#include "cairo.h"
|
|
|
|
#include "cairo-types-private.h"
|
|
#include "cairo-reference-count-private.h"
|
|
#include "cairo-clip-private.h"
|
|
|
|
typedef void (*cairo_surface_func_t) (cairo_surface_t *);
|
|
|
|
struct _cairo_surface {
|
|
const cairo_surface_backend_t *backend;
|
|
|
|
/* We allow surfaces to override the backend->type by shoving something
|
|
* else into surface->type. This is for "wrapper" surfaces that want to
|
|
* hide their internal type from the user-level API. */
|
|
cairo_surface_type_t type;
|
|
|
|
cairo_content_t content;
|
|
|
|
cairo_reference_count_t ref_count;
|
|
cairo_status_t status;
|
|
cairo_bool_t finished;
|
|
unsigned int unique_id;
|
|
|
|
cairo_user_data_array_t user_data;
|
|
cairo_user_data_array_t mime_data;
|
|
|
|
cairo_matrix_t device_transform;
|
|
cairo_matrix_t device_transform_inverse;
|
|
|
|
/* The actual resolution of the device, in dots per inch. */
|
|
double x_resolution;
|
|
double y_resolution;
|
|
|
|
/* The resolution that should be used when generating image-based
|
|
* fallback; generally only used by the analysis/paginated
|
|
* surfaces
|
|
*/
|
|
double x_fallback_resolution;
|
|
double y_fallback_resolution;
|
|
|
|
/* A "snapshot" surface is immutable. See _cairo_surface_snapshot. */
|
|
cairo_surface_t *snapshot_of;
|
|
cairo_surface_func_t snapshot_detach;
|
|
/* current snapshots of this surface */
|
|
cairo_array_t snapshots;
|
|
|
|
/*
|
|
* Surface font options, falling back to backend's default options,
|
|
* and set using _cairo_surface_set_font_options(), and propagated by
|
|
* cairo_surface_create_similar().
|
|
*/
|
|
cairo_bool_t has_font_options;
|
|
cairo_font_options_t font_options;
|
|
};
|
|
|
|
#endif /* CAIRO_SURFACE_PRIVATE_H */
|