Subversion Repositories Kolibri OS

/* cairo - a vector graphics library with display and print output

 *

 * Copyright © 2009 Eric Anholt

 * Copyright © 2009 Chris Wilson

 * Copyright © 2005,2010 Red Hat, Inc

 * Copyright © 2011 Linaro Limited

 *

 * 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., 51 Franklin Street, Suite 500, Boston, MA 02110-1335, 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 Red Hat, Inc.

 *

 * Contributor(s):

 *	Benjamin Otte 

 *	Carl Worth 

 *	Chris Wilson 

 *	Eric Anholt 

 *	T. Zachary Laine 

 *	Alexandros Frantzis 

 */

#ifndef CAIRO_GL_PRIVATE_H

#define CAIRO_GL_PRIVATE_H

#define GL_GLEXT_PROTOTYPES

#include "cairoint.h"

#include "cairo-gl.h"

#include "cairo-gl-gradient-private.h"

#include "cairo-device-private.h"

#include "cairo-error-private.h"

#include "cairo-rtree-private.h"

#include "cairo-scaled-font-private.h"

#include "cairo-spans-compositor-private.h"

#include "cairo-array-private.h"

#include 

#if CAIRO_HAS_GL_SURFACE

#include 

#include 

#elif CAIRO_HAS_GLESV2_SURFACE

#include 

#include 

#endif

#include "cairo-gl-ext-def-private.h"

#define DEBUG_GL 0

#if DEBUG_GL && __GNUC__

#define UNSUPPORTED(reason) ({ \

    fprintf (stderr, \

	     "cairo-gl: hit unsupported operation in %s(), line %d: %s\n", \

	     __FUNCTION__, __LINE__, reason); \

    CAIRO_INT_STATUS_UNSUPPORTED; \

})

#else

#define UNSUPPORTED(reason) CAIRO_INT_STATUS_UNSUPPORTED

#endif

#define CAIRO_GL_VERSION_ENCODE(major, minor) (	\

	  ((major) * 256)			\

	+ ((minor) *   1))

/* maximal number of shaders we keep in the cache.

 * Random number that is hopefully big enough to not cause many cache evictions. */

#define CAIRO_GL_MAX_SHADERS_PER_CONTEXT 64

/* VBO size that we allocate, smaller size means we gotta flush more often,

 * but larger means hogging more memory and can cause trouble for drivers

 * (especially on embedded devices). */

#define CAIRO_GL_VBO_SIZE (16*1024)

typedef struct _cairo_gl_surface cairo_gl_surface_t;

/* GL flavor */

typedef enum cairo_gl_flavor {

    CAIRO_GL_FLAVOR_NONE = 0,

    CAIRO_GL_FLAVOR_DESKTOP = 1,

    CAIRO_GL_FLAVOR_ES = 2

} cairo_gl_flavor_t;

/* Indices for vertex attributes used by BindAttribLocation etc */

enum {

    CAIRO_GL_VERTEX_ATTRIB_INDEX = 0,

    CAIRO_GL_COLOR_ATTRIB_INDEX  = 1,

    CAIRO_GL_TEXCOORD0_ATTRIB_INDEX = 2,

    CAIRO_GL_TEXCOORD1_ATTRIB_INDEX = CAIRO_GL_TEXCOORD0_ATTRIB_INDEX + 1

};

typedef enum cairo_gl_operand_type {

    CAIRO_GL_OPERAND_NONE,

    CAIRO_GL_OPERAND_CONSTANT,

    CAIRO_GL_OPERAND_TEXTURE,

    CAIRO_GL_OPERAND_LINEAR_GRADIENT,

    CAIRO_GL_OPERAND_RADIAL_GRADIENT_A0,

    CAIRO_GL_OPERAND_RADIAL_GRADIENT_NONE,

    CAIRO_GL_OPERAND_RADIAL_GRADIENT_EXT,

    CAIRO_GL_OPERAND_COUNT

} cairo_gl_operand_type_t;

/* This union structure describes a potential source or mask operand to the

 * compositing equation.

 */

typedef struct cairo_gl_operand {

    cairo_gl_operand_type_t type;

    union {

	struct {

	    GLuint tex;

	    cairo_gl_surface_t *surface;

	    cairo_gl_surface_t *owns_surface;

	    cairo_surface_attributes_t attributes;

	    int texgen;

	} texture;

	struct {

	    GLfloat color[4];

	} constant;

	struct {

	    cairo_gl_gradient_t *gradient;

	    cairo_matrix_t m;

	    cairo_circle_double_t circle_d;

	    double radius_0, a;

	    cairo_extend_t extend;

	    int texgen;

	} gradient;

    };

    unsigned int vertex_offset;

} cairo_gl_operand_t;

typedef struct cairo_gl_source {

    cairo_surface_t base;

    cairo_gl_operand_t operand;

} cairo_gl_source_t;

struct _cairo_gl_surface {

    cairo_surface_t base;

    cairo_gl_operand_t operand;

    int width, height;

    GLuint tex; /* GL texture object containing our data. */

    GLuint fb; /* GL framebuffer object wrapping our data. */

    GLuint depth_stencil; /* GL renderbuffer object for holding stencil buffer clip. */

#if CAIRO_HAS_GL_SURFACE

    GLuint msaa_rb; /* The ARB MSAA path uses a renderbuffer. */

    GLuint msaa_fb;

#endif

    GLuint msaa_depth_stencil;

    cairo_bool_t stencil_and_msaa_caps_initialized;

    cairo_bool_t supports_stencil; /* Stencil support for for non-texture surfaces. */

    cairo_bool_t supports_msaa;

    cairo_bool_t msaa_active; /* Whether the multisampling

			         framebuffer is active or not. */

    cairo_clip_t *clip_on_stencil_buffer;

    int owns_tex;

    cairo_bool_t needs_update;

    cairo_region_t *clip_region;

};

typedef struct cairo_gl_glyph_cache {

    cairo_rtree_t rtree;

    cairo_gl_surface_t *surface;

} cairo_gl_glyph_cache_t;

typedef enum cairo_gl_tex {

    CAIRO_GL_TEX_SOURCE = 0,

    CAIRO_GL_TEX_MASK = 1,

    CAIRO_GL_TEX_TEMP = 2

} cairo_gl_tex_t;

typedef struct cairo_gl_shader {

    GLuint fragment_shader;

    GLuint program;

    GLint mvp_location;

    GLint constant_location[2];

    GLint a_location[2];

    GLint circle_d_location[2];

    GLint radius_0_location[2];

    GLint texdims_location[2];

    GLint texgen_location[2];

} cairo_gl_shader_t;

typedef enum cairo_gl_shader_in {

    CAIRO_GL_SHADER_IN_NORMAL,

    CAIRO_GL_SHADER_IN_CA_SOURCE,

    CAIRO_GL_SHADER_IN_CA_SOURCE_ALPHA,

    CAIRO_GL_SHADER_IN_COUNT

} cairo_gl_shader_in_t;

typedef enum cairo_gl_var_type {

  CAIRO_GL_VAR_NONE,

  CAIRO_GL_VAR_TEXCOORDS,

  CAIRO_GL_VAR_TEXGEN,

} cairo_gl_var_type_t;

typedef enum cairo_gl_primitive_type {

    CAIRO_GL_PRIMITIVE_TYPE_TRIANGLES,

    CAIRO_GL_PRIMITIVE_TYPE_TRISTRIPS

} cairo_gl_primitive_type_t;

typedef void (*cairo_gl_emit_rect_t) (cairo_gl_context_t *ctx,

				      GLfloat x1, GLfloat y1,

				      GLfloat x2, GLfloat y2);

typedef void (*cairo_gl_emit_span_t) (cairo_gl_context_t *ctx,

				      GLfloat x1, GLfloat y1,

				      GLfloat x2, GLfloat y2,

				      uint8_t alpha);

typedef void (*cairo_gl_emit_glyph_t) (cairo_gl_context_t *ctx,

				       GLfloat x1, GLfloat y1,

				       GLfloat x2, GLfloat y2,

				       GLfloat glyph_x1, GLfloat glyph_y1,

				       GLfloat glyph_x2, GLfloat glyph_y2);

#define cairo_gl_var_type_hash(src,mask,spans,dest) ((spans) << 5) | ((mask) << 3 | (src << 1) | (dest))

#define CAIRO_GL_VAR_TYPE_MAX (1 << 6)

typedef void (*cairo_gl_generic_func_t)(void);

typedef cairo_gl_generic_func_t (*cairo_gl_get_proc_addr_func_t)(const char *procname);

typedef struct _cairo_gl_dispatch {

    /* Buffers */

    void (*GenBuffers) (GLsizei n, GLuint *buffers);

    void (*BindBuffer) (GLenum target, GLuint buffer);

    void (*BufferData) (GLenum target, GLsizeiptr size,

			  const GLvoid* data, GLenum usage);

    GLvoid *(*MapBuffer) (GLenum target, GLenum access);

    GLboolean (*UnmapBuffer) (GLenum target);

    /* Shaders */

    GLuint (*CreateShader) (GLenum type);

    void (*ShaderSource) (GLuint shader, GLsizei count,

			    const GLchar** string, const GLint* length);

    void (*CompileShader) (GLuint shader);

    void (*GetShaderiv) (GLuint shader, GLenum pname, GLint *params);

    void (*GetShaderInfoLog) (GLuint shader, GLsizei bufSize,

				GLsizei *length, GLchar *infoLog);

    void (*DeleteShader) (GLuint shader);

    /* Programs */

    GLuint (*CreateProgram) (void);

    void (*AttachShader) (GLuint program, GLuint shader);

    void (*DeleteProgram) (GLuint program);

    void (*LinkProgram) (GLuint program);

    void (*UseProgram) (GLuint program);

    void (*GetProgramiv) (GLuint program, GLenum pname, GLint *params);

    void (*GetProgramInfoLog) (GLuint program, GLsizei bufSize,

				 GLsizei *length, GLchar *infoLog);

    /* Uniforms */

    GLint (*GetUniformLocation) (GLuint program, const GLchar* name);

    void (*Uniform1f) (GLint location, GLfloat x);

    void (*Uniform2f) (GLint location, GLfloat x, GLfloat y);

    void (*Uniform3f) (GLint location, GLfloat x, GLfloat y, GLfloat z);

    void (*Uniform4f) (GLint location, GLfloat x, GLfloat y, GLfloat z,

			 GLfloat w);

    void (*UniformMatrix3fv) (GLint location, GLsizei count,

				GLboolean transpose, const GLfloat *value);

    void (*UniformMatrix4fv) (GLint location, GLsizei count,

			      GLboolean transpose, const GLfloat *value);

    void (*Uniform1i) (GLint location, GLint x);

    /* Attributes */

    void (*BindAttribLocation) (GLuint program, GLuint index,

				const GLchar *name);

    void (*VertexAttribPointer) (GLuint index, GLint size, GLenum type,

				 GLboolean normalized, GLsizei stride,

				 const GLvoid *pointer);

    void (*EnableVertexAttribArray) (GLuint index);

    void (*DisableVertexAttribArray) (GLuint index);

    /* Framebuffer objects */

    void (*GenFramebuffers) (GLsizei n, GLuint* framebuffers);

    void (*BindFramebuffer) (GLenum target, GLuint framebuffer);

    void (*FramebufferTexture2D) (GLenum target, GLenum attachment,

				    GLenum textarget, GLuint texture,

				    GLint level);

    GLenum (*CheckFramebufferStatus) (GLenum target);

    void (*DeleteFramebuffers) (GLsizei n, const GLuint* framebuffers);

    void (*GenRenderbuffers) (GLsizei n, GLuint *renderbuffers);

    void (*BindRenderbuffer) (GLenum target, GLuint renderbuffer);

    void (*RenderbufferStorage) (GLenum target, GLenum internal_format,

				 GLsizei width, GLsizei height);

    void (*FramebufferRenderbuffer) (GLenum target, GLenum attachment,

				     GLenum renderbuffer_ttarget, GLuint renderbuffer);

    void (*DeleteRenderbuffers) (GLsizei n, GLuint *renderbuffers);

    void (*BlitFramebuffer) (GLint srcX0, GLint srcY0, GLint srcX1, GLint srcY1,

			     GLint dstX0, GLint dstY0, GLint dstX1, GLint dstY1,

			     GLbitfield mask, GLenum filter);

    void (*RenderbufferStorageMultisample) (GLenum target, GLsizei samples,

					    GLenum internalformat,

					    GLsizei width, GLsizei height);

    void (*FramebufferTexture2DMultisample) (GLenum target, GLenum attachment,

					     GLenum textarget, GLuint texture,

					     GLint level, GLsizei samples);

} cairo_gl_dispatch_t;

struct _cairo_gl_context {

    cairo_device_t base;

    const cairo_compositor_t *compositor;

    GLuint texture_load_pbo;

    GLint max_framebuffer_size;

    GLint max_texture_size;

    GLint max_textures;

    GLenum tex_target;

    GLint num_samples;

    cairo_bool_t supports_msaa;

    char *vb;

    cairo_bool_t has_shader_support;

    GLuint vertex_shaders[CAIRO_GL_VAR_TYPE_MAX];

    cairo_gl_shader_t fill_rectangles_shader;

    cairo_cache_t shaders;

    cairo_cache_t gradients;

    cairo_gl_glyph_cache_t glyph_cache[2];

    cairo_list_t fonts;

    cairo_gl_surface_t *current_target;

    cairo_operator_t current_operator;

    cairo_gl_shader_t *pre_shader; /* for component alpha */

    cairo_gl_shader_t *current_shader;

    cairo_gl_operand_t operands[2];

    cairo_bool_t spans;

    unsigned int vb_offset;

    unsigned int vertex_size;

    cairo_region_t *clip_region;

    cairo_clip_t *clip;

    cairo_gl_primitive_type_t primitive_type;

    cairo_array_t tristrip_indices;

    cairo_bool_t has_mesa_pack_invert;

    cairo_gl_dispatch_t dispatch;

    GLfloat modelviewprojection_matrix[16];

    cairo_gl_flavor_t gl_flavor;

    cairo_bool_t has_map_buffer;

    cairo_bool_t has_packed_depth_stencil;

    cairo_bool_t has_npot_repeat;

    cairo_bool_t can_read_bgra;

    cairo_bool_t thread_aware;

    void (*acquire) (void *ctx);

    void (*release) (void *ctx);

    void (*make_current) (void *ctx, cairo_gl_surface_t *surface);

    void (*swap_buffers)(void *ctx, cairo_gl_surface_t *surface);

    void (*destroy) (void *ctx);

};

typedef struct _cairo_gl_composite {

    cairo_gl_surface_t *dst;

    cairo_operator_t op;

    cairo_region_t *clip_region;

    cairo_gl_operand_t src;

    cairo_gl_operand_t mask;

    cairo_bool_t spans;

    cairo_clip_t *clip;

    cairo_bool_t multisample;

} cairo_gl_composite_t;

typedef struct _cairo_gl_font {

    cairo_scaled_font_private_t		base;

    cairo_device_t			*device;

    cairo_list_t			link;

} cairo_gl_font_t;

static cairo_always_inline GLenum

_cairo_gl_get_error (void)

{

    GLenum err = glGetError();

    if (unlikely (err))

        while (glGetError ());

    return err;

}

static inline cairo_device_t *

_cairo_gl_context_create_in_error (cairo_status_t status)

{

    return (cairo_device_t *) _cairo_device_create_in_error (status);

}

cairo_private cairo_status_t

_cairo_gl_context_init (cairo_gl_context_t *ctx);

cairo_private void

_cairo_gl_surface_init (cairo_device_t *device,

			cairo_gl_surface_t *surface,

			cairo_content_t content,

			int width, int height);

static cairo_always_inline cairo_bool_t cairo_warn

_cairo_gl_surface_is_texture (cairo_gl_surface_t *surface)

{

    return surface->tex != 0;

}

cairo_private cairo_status_t

_cairo_gl_surface_draw_image (cairo_gl_surface_t *dst,

			      cairo_image_surface_t *src,

			      int src_x, int src_y,

			      int width, int height,

			      int dst_x, int dst_y,

			      cairo_bool_t force_flush);

cairo_private cairo_int_status_t

_cairo_gl_surface_resolve_multisampling (cairo_gl_surface_t *surface);

static cairo_always_inline cairo_bool_t

_cairo_gl_device_has_glsl (cairo_device_t *device)

{

    return ((cairo_gl_context_t *) device)->has_shader_support;

}

static cairo_always_inline cairo_bool_t

_cairo_gl_device_requires_power_of_two_textures (cairo_device_t *device)

{

    return ((cairo_gl_context_t *) device)->tex_target == GL_TEXTURE_RECTANGLE;

}

static cairo_always_inline cairo_status_t cairo_warn

_cairo_gl_context_acquire (cairo_device_t *device,

			   cairo_gl_context_t **ctx)

{

    cairo_status_t status;

    status = cairo_device_acquire (device);

    if (unlikely (status))

	return status;

    /* clear potential previous GL errors */

    _cairo_gl_get_error ();

    *ctx = (cairo_gl_context_t *) device;

    return CAIRO_STATUS_SUCCESS;

}

static cairo_always_inline cairo_warn cairo_status_t

_cairo_gl_context_release (cairo_gl_context_t *ctx, cairo_status_t status)

{

    GLenum err;

    err = _cairo_gl_get_error ();

    if (unlikely (err)) {

        cairo_status_t new_status;

	new_status = _cairo_error (CAIRO_STATUS_DEVICE_ERROR);

        if (status == CAIRO_STATUS_SUCCESS)

            status = new_status;

    }

    cairo_device_release (&(ctx)->base);

    return status;

}

cairo_private void

_cairo_gl_context_set_destination (cairo_gl_context_t *ctx,

				   cairo_gl_surface_t *surface,

				   cairo_bool_t multisampling);

cairo_private void

_cairo_gl_context_bind_framebuffer (cairo_gl_context_t *ctx,

				    cairo_gl_surface_t *surface,

				    cairo_bool_t multisampling);

cairo_private cairo_gl_emit_rect_t

_cairo_gl_context_choose_emit_rect (cairo_gl_context_t *ctx);

cairo_private void

_cairo_gl_context_emit_rect (cairo_gl_context_t *ctx,

			     GLfloat x1, GLfloat y1,

			     GLfloat x2, GLfloat y2);

cairo_private cairo_gl_emit_span_t

_cairo_gl_context_choose_emit_span (cairo_gl_context_t *ctx);

cairo_private cairo_gl_emit_glyph_t

_cairo_gl_context_choose_emit_glyph (cairo_gl_context_t *ctx);

cairo_private void

_cairo_gl_context_activate (cairo_gl_context_t *ctx,

                            cairo_gl_tex_t      tex_unit);

cairo_private cairo_bool_t

_cairo_gl_operator_is_supported (cairo_operator_t op);

cairo_private cairo_bool_t

_cairo_gl_ensure_stencil (cairo_gl_context_t *ctx,

			  cairo_gl_surface_t *surface);

cairo_private cairo_status_t

_cairo_gl_composite_init (cairo_gl_composite_t *setup,

                          cairo_operator_t op,

                          cairo_gl_surface_t *dst,

                          cairo_bool_t has_component_alpha);

cairo_private void

_cairo_gl_composite_fini (cairo_gl_composite_t *setup);

cairo_private cairo_status_t

_cairo_gl_composite_set_operator (cairo_gl_composite_t *setup,

				  cairo_operator_t op,

				  cairo_bool_t assume_component_alpha);

cairo_private void

_cairo_gl_composite_set_clip_region (cairo_gl_composite_t *setup,

                                     cairo_region_t *clip_region);

cairo_private void

_cairo_gl_composite_set_clip(cairo_gl_composite_t *setup,

			     cairo_clip_t *clip);

cairo_private cairo_int_status_t

_cairo_gl_composite_set_source (cairo_gl_composite_t *setup,

				const cairo_pattern_t *pattern,

				const cairo_rectangle_int_t *sample,

				const cairo_rectangle_int_t *extents,

				cairo_bool_t use_texgen);

cairo_private void

_cairo_gl_composite_set_solid_source (cairo_gl_composite_t *setup,

				      const cairo_color_t *color);

cairo_private void

_cairo_gl_composite_set_source_operand (cairo_gl_composite_t *setup,

					const cairo_gl_operand_t *source);

cairo_private cairo_int_status_t

_cairo_gl_composite_set_mask (cairo_gl_composite_t *setup,

			      const cairo_pattern_t *pattern,

			      const cairo_rectangle_int_t *sample,

			      const cairo_rectangle_int_t *extents,

			      cairo_bool_t use_texgen);

cairo_private void

_cairo_gl_composite_set_mask_operand (cairo_gl_composite_t *setup,

				      const cairo_gl_operand_t *mask);

cairo_private void

_cairo_gl_composite_set_spans (cairo_gl_composite_t *setup);

cairo_private void

_cairo_gl_composite_set_multisample (cairo_gl_composite_t *setup);

cairo_private cairo_status_t

_cairo_gl_composite_begin (cairo_gl_composite_t *setup,

                           cairo_gl_context_t **ctx);

cairo_private cairo_status_t

_cairo_gl_set_operands_and_operator (cairo_gl_composite_t *setup,

				     cairo_gl_context_t *ctx);

cairo_private void

_cairo_gl_composite_flush (cairo_gl_context_t *ctx);

cairo_private cairo_int_status_t

_cairo_gl_composite_emit_quad_as_tristrip (cairo_gl_context_t	*ctx,

					   cairo_gl_composite_t	*setup,

					   const cairo_point_t	 quad[4]);

cairo_private cairo_int_status_t

_cairo_gl_composite_emit_triangle_as_tristrip (cairo_gl_context_t	*ctx,

					       cairo_gl_composite_t	*setup,

					       const cairo_point_t	 triangle[3]);

cairo_private void

_cairo_gl_context_destroy_operand (cairo_gl_context_t *ctx,

                                   cairo_gl_tex_t tex_unit);

cairo_private cairo_bool_t

_cairo_gl_get_image_format_and_type (cairo_gl_flavor_t flavor,

				     pixman_format_code_t pixman_format,

				     GLenum *internal_format, GLenum *format,

				     GLenum *type, cairo_bool_t *has_alpha,

				     cairo_bool_t *needs_swap);

cairo_private void

_cairo_gl_glyph_cache_init (cairo_gl_glyph_cache_t *cache);

cairo_private void

_cairo_gl_glyph_cache_fini (cairo_gl_context_t *ctx,

			    cairo_gl_glyph_cache_t *cache);

cairo_private cairo_int_status_t

_cairo_gl_surface_show_glyphs (void			*abstract_dst,

			       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,

			       int			*remaining_glyphs);

cairo_private cairo_status_t

_cairo_gl_context_init_shaders (cairo_gl_context_t *ctx);

cairo_private void

_cairo_gl_context_fini_shaders (cairo_gl_context_t *ctx);

static cairo_always_inline cairo_bool_t

_cairo_gl_context_is_flushed (cairo_gl_context_t *ctx)

{

    return ctx->vb_offset == 0;

}

cairo_private cairo_status_t

_cairo_gl_get_shader_by_type (cairo_gl_context_t *ctx,

                              cairo_gl_operand_t *source,

                              cairo_gl_operand_t *mask,

			      cairo_bool_t use_coverage,

                              cairo_gl_shader_in_t in,

                              cairo_gl_shader_t **shader);

cairo_private void

_cairo_gl_shader_bind_float (cairo_gl_context_t *ctx,

			     GLint location,

			     float value);

cairo_private void

_cairo_gl_shader_bind_vec2 (cairo_gl_context_t *ctx,

			    GLint location,

			    float value0, float value1);

cairo_private void

_cairo_gl_shader_bind_vec3 (cairo_gl_context_t *ctx,

			    GLint location,

			    float value0,

			    float value1,

			    float value2);

cairo_private void

_cairo_gl_shader_bind_vec4 (cairo_gl_context_t *ctx,

			    GLint location,

			    float value0, float value1,

			    float value2, float value3);

cairo_private void

_cairo_gl_shader_bind_matrix (cairo_gl_context_t *ctx,

			      GLint location,

			      const cairo_matrix_t* m);

cairo_private void

_cairo_gl_shader_bind_matrix4f (cairo_gl_context_t *ctx,

				GLint location,

				GLfloat* gl_m);

cairo_private void

_cairo_gl_set_shader (cairo_gl_context_t *ctx,

		      cairo_gl_shader_t *shader);

cairo_private void

_cairo_gl_shader_fini (cairo_gl_context_t *ctx, cairo_gl_shader_t *shader);

cairo_private int

_cairo_gl_get_version (void);

cairo_private cairo_gl_flavor_t

_cairo_gl_get_flavor (void);

cairo_private cairo_bool_t

_cairo_gl_has_extension (const char *ext);

cairo_private cairo_status_t

_cairo_gl_dispatch_init(cairo_gl_dispatch_t *dispatch,

			cairo_gl_get_proc_addr_func_t get_proc_addr);

cairo_private cairo_int_status_t

_cairo_gl_operand_init (cairo_gl_operand_t *operand,

		        const cairo_pattern_t *pattern,

		        cairo_gl_surface_t *dst,

			const cairo_rectangle_int_t *sample,

			const cairo_rectangle_int_t *extents,

			cairo_bool_t use_texgen);

cairo_private void

_cairo_gl_solid_operand_init (cairo_gl_operand_t *operand,

	                      const cairo_color_t *color);

cairo_private cairo_filter_t

_cairo_gl_operand_get_filter (cairo_gl_operand_t *operand);

cairo_private GLint

_cairo_gl_operand_get_gl_filter (cairo_gl_operand_t *operand);

cairo_private cairo_extend_t

_cairo_gl_operand_get_extend (cairo_gl_operand_t *operand);

cairo_private unsigned int

_cairo_gl_operand_get_vertex_size (const cairo_gl_operand_t *operand);

cairo_private cairo_bool_t

_cairo_gl_operand_needs_setup (cairo_gl_operand_t *dest,

                               cairo_gl_operand_t *source,

                               unsigned int        vertex_offset);

cairo_private void

_cairo_gl_operand_bind_to_shader (cairo_gl_context_t *ctx,

                                  cairo_gl_operand_t *operand,

                                  cairo_gl_tex_t      tex_unit);

cairo_private void

_cairo_gl_operand_emit (cairo_gl_operand_t *operand,

                        GLfloat ** vb,

                        GLfloat x,

                        GLfloat y);

cairo_private void

_cairo_gl_operand_copy (cairo_gl_operand_t *dst,

			const cairo_gl_operand_t *src);

cairo_private void

_cairo_gl_operand_translate (cairo_gl_operand_t *operand,

			     double tx, double ty);

cairo_private void

_cairo_gl_operand_destroy (cairo_gl_operand_t *operand);

cairo_private const cairo_compositor_t *

_cairo_gl_msaa_compositor_get (void);

cairo_private const cairo_compositor_t *

_cairo_gl_span_compositor_get (void);

cairo_private const cairo_compositor_t *

_cairo_gl_traps_compositor_get (void);

cairo_private cairo_int_status_t

_cairo_gl_check_composite_glyphs (const cairo_composite_rectangles_t *extents,

				  cairo_scaled_font_t *scaled_font,

				  cairo_glyph_t *glyphs,

				  int *num_glyphs);

cairo_private cairo_int_status_t

_cairo_gl_composite_glyphs (void			*_dst,

			    cairo_operator_t		 op,

			    cairo_surface_t		*_src,

			    int				 src_x,

			    int				 src_y,

			    int				 dst_x,

			    int				 dst_y,

			    cairo_composite_glyphs_info_t *info);

cairo_private cairo_int_status_t

_cairo_gl_composite_glyphs_with_clip (void			    *_dst,

				      cairo_operator_t		     op,

				      cairo_surface_t		    *_src,

				      int			     src_x,

				      int			     src_y,

				      int			     dst_x,

				      int			     dst_y,

				      cairo_composite_glyphs_info_t *info,

				      cairo_clip_t		    *clip);

cairo_private cairo_surface_t *

_cairo_gl_surface_create_scratch (cairo_gl_context_t   *ctx,

				  cairo_content_t	content,

				  int			width,

				  int			height);

cairo_private cairo_surface_t *

_cairo_gl_surface_create_scratch_for_caching (cairo_gl_context_t *ctx,

					      cairo_content_t content,

					      int width,

					      int height);

cairo_private cairo_surface_t *

_cairo_gl_pattern_to_source (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_int_status_t

_cairo_gl_msaa_compositor_draw_clip (cairo_gl_context_t *ctx,

				     cairo_gl_composite_t *setup,

				     cairo_clip_t *clip);

cairo_private cairo_surface_t *

_cairo_gl_white_source (void);

cairo_private void

_cairo_gl_scissor_to_rectangle (cairo_gl_surface_t *surface,

				const cairo_rectangle_int_t *r);

static inline cairo_gl_operand_t *

source_to_operand (cairo_surface_t *surface)

{

    cairo_gl_source_t *source = (cairo_gl_source_t *)surface;

    return source ? &source->operand : NULL;

}

static inline void

_cairo_gl_glyph_cache_unlock (cairo_gl_glyph_cache_t *cache)

{

    _cairo_rtree_unpin (&cache->rtree);

}

slim_hidden_proto (cairo_gl_surface_create);

slim_hidden_proto (cairo_gl_surface_create_for_texture);

#endif /* CAIRO_GL_PRIVATE_H */