Subversion Repositories Kolibri OS

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

 */

#ifndef CAIRO_IMAGE_SURFACE_PRIVATE_H

#define CAIRO_IMAGE_SURFACE_PRIVATE_H

#include "cairo-surface-private.h"

#include 

CAIRO_BEGIN_DECLS

/* The canonical image backend */

struct _cairo_image_surface {

    cairo_surface_t base;

    pixman_image_t *pixman_image;

    const cairo_compositor_t *compositor;

    /* Parenting is tricky wrt lifetime tracking...

     *

     * One use for tracking the parent of an image surface is for

     * create_similar_image() where we wish to create a device specific

     * surface but return an image surface to the user. In such a case,

     * the image may be owned by the device specific surface, its parent,

     * but the user lifetime tracking is then performed on the image. So

     * when the image is then finalized we call cairo_surface_destroy()

     * on the parent. However, for normal usage where the lifetime tracking

     * is done on the parent surface, we need to be careful to unhook

     * the image->parent pointer before finalizing the image.

     */

    cairo_surface_t *parent;

    pixman_format_code_t pixman_format;

    cairo_format_t format;

    unsigned char *data;

    int width;

    int height;

    int stride;

    int depth;

    unsigned owns_data : 1;

    unsigned transparency : 2;

    unsigned color : 2;

};

#define to_image_surface(S) ((cairo_image_surface_t *)(S))

/* A wrapper for holding pixman images returned by create_for_pattern */

typedef struct _cairo_image_source {

    cairo_surface_t base;

    pixman_image_t *pixman_image;

    unsigned is_opaque_solid : 1;

} cairo_image_source_t;

cairo_private extern const cairo_surface_backend_t _cairo_image_surface_backend;

cairo_private extern const cairo_surface_backend_t _cairo_image_source_backend;

cairo_private const cairo_compositor_t *

_cairo_image_mask_compositor_get (void);

cairo_private const cairo_compositor_t *

_cairo_image_traps_compositor_get (void);

cairo_private const cairo_compositor_t *

_cairo_image_spans_compositor_get (void);

#define _cairo_image_default_compositor_get _cairo_image_spans_compositor_get

cairo_private cairo_int_status_t

_cairo_image_surface_paint (void			*abstract_surface,

			    cairo_operator_t		 op,

			    const cairo_pattern_t	*source,

			    const cairo_clip_t		*clip);

cairo_private cairo_int_status_t

_cairo_image_surface_mask (void				*abstract_surface,

			   cairo_operator_t		 op,

			   const cairo_pattern_t	*source,

			   const cairo_pattern_t	*mask,

			   const cairo_clip_t		*clip);

cairo_private cairo_int_status_t

_cairo_image_surface_stroke (void			*abstract_surface,

			     cairo_operator_t		 op,

			     const cairo_pattern_t	*source,

			     const cairo_path_fixed_t	*path,

			     const cairo_stroke_style_t	*style,

			     const cairo_matrix_t	*ctm,

			     const cairo_matrix_t	*ctm_inverse,

			     double			 tolerance,

			     cairo_antialias_t		 antialias,

			     const cairo_clip_t		*clip);

cairo_private cairo_int_status_t

_cairo_image_surface_fill (void				*abstract_surface,

			   cairo_operator_t		 op,

			   const cairo_pattern_t	*source,

			   const cairo_path_fixed_t	*path,

			   cairo_fill_rule_t		 fill_rule,

			   double			 tolerance,

			   cairo_antialias_t		 antialias,

			   const cairo_clip_t		*clip);

cairo_private cairo_int_status_t

_cairo_image_surface_glyphs (void			*abstract_surface,

			     cairo_operator_t		 op,

			     const cairo_pattern_t	*source,

			     cairo_glyph_t		*glyphs,

			     int			 num_glyphs,

			     cairo_scaled_font_t	*scaled_font,

			     const cairo_clip_t		*clip);

cairo_private void

_cairo_image_surface_init (cairo_image_surface_t *surface,

			   pixman_image_t	*pixman_image,

			   pixman_format_code_t	 pixman_format);

cairo_private cairo_surface_t *

_cairo_image_surface_create_similar (void	       *abstract_other,

				     cairo_content_t	content,

				     int		width,

				     int		height);

cairo_private cairo_image_surface_t *

_cairo_image_surface_map_to_image (void *abstract_other,

				   const cairo_rectangle_int_t *extents);

cairo_private cairo_int_status_t

_cairo_image_surface_unmap_image (void *abstract_surface,

				  cairo_image_surface_t *image);

cairo_private cairo_surface_t *

_cairo_image_surface_source (void			*abstract_surface,

			     cairo_rectangle_int_t	*extents);

cairo_private cairo_status_t

_cairo_image_surface_acquire_source_image (void                    *abstract_surface,

					   cairo_image_surface_t  **image_out,

					   void                   **image_extra);

cairo_private void

_cairo_image_surface_release_source_image (void                   *abstract_surface,

					   cairo_image_surface_t  *image,

					   void                   *image_extra);

cairo_private cairo_surface_t *

_cairo_image_surface_snapshot (void *abstract_surface);

cairo_private_no_warn cairo_bool_t

_cairo_image_surface_get_extents (void			  *abstract_surface,

				  cairo_rectangle_int_t   *rectangle);

cairo_private void

_cairo_image_surface_get_font_options (void                  *abstract_surface,

				       cairo_font_options_t  *options);

cairo_private cairo_surface_t *

_cairo_image_source_create_for_pattern (cairo_surface_t *dst,

					const cairo_pattern_t *pattern,

					cairo_bool_t is_mask,

					const cairo_rectangle_int_t *extents,

					const cairo_rectangle_int_t *sample,

					int *src_x, int *src_y);

cairo_private cairo_status_t

_cairo_image_surface_finish (void *abstract_surface);

cairo_private pixman_image_t *

_pixman_image_for_color (const cairo_color_t *cairo_color);

cairo_private pixman_image_t *

_pixman_image_for_pattern (cairo_image_surface_t *dst,

			   const cairo_pattern_t *pattern,

			   cairo_bool_t is_mask,

			   const cairo_rectangle_int_t *extents,

			   const cairo_rectangle_int_t *sample,

			   int *tx, int *ty);

cairo_private void

_pixman_image_add_traps (pixman_image_t *image,

			 int dst_x, int dst_y,

			 cairo_traps_t *traps);

cairo_private void

_pixman_image_add_tristrip (pixman_image_t *image,

			    int dst_x, int dst_y,

			    cairo_tristrip_t *strip);

cairo_private cairo_image_surface_t *

_cairo_image_surface_clone_subimage (cairo_surface_t             *surface,

				     const cairo_rectangle_int_t *extents);

/* Similar to clone; but allow format conversion */

cairo_private cairo_image_surface_t *

_cairo_image_surface_create_from_image (cairo_image_surface_t *other,

					pixman_format_code_t format,

					int x, int y, int width, int height,

					int stride);

CAIRO_END_DECLS

#endif /* CAIRO_IMAGE_SURFACE_PRIVATE_H */