src/cairo-xlib-private.h

   1 /* Cairo - a vector graphics library with display and print output
   2  *
   3  * Copyright © 2005 Red Hat, Inc.
   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 Red Hat, Inc.
  31  *
  32  * Contributors(s):
  33  *      Chris Wilson <chris@chris-wilson.co.uk>
  34  *      Karl Tomlinson <karlt+@karlt.net>, Mozilla Corporation
  35  */
  36
  37 #ifndef CAIRO_XLIB_PRIVATE_H
  38 #define CAIRO_XLIB_PRIVATE_H
  39
  40 #include "cairo-xlib.h"
  41 #include "cairo-xlib-xrender-private.h"
  42
  43 #include "cairo-compiler-private.h"
  44 #include "cairo-device-private.h"
  45 #include "cairo-freelist-type-private.h"
  46 #include "cairo-list-private.h"
  47 #include "cairo-reference-count-private.h"
  48 #include "cairo-types-private.h"
  49 #include "cairo-scaled-font-private.h"
  50 #include "cairo-surface-private.h"
  51
  52 #include <pixman.h>
  53 #include <string.h>
  54
  55 typedef struct _cairo_xlib_display cairo_xlib_display_t;
  56 typedef struct _cairo_xlib_shm_display cairo_xlib_shm_display_t;
  57 typedef struct _cairo_xlib_screen cairo_xlib_screen_t;
  58 typedef struct _cairo_xlib_source cairo_xlib_source_t;
  59 typedef struct _cairo_xlib_proxy cairo_xlib_proxy_t;
  60 typedef struct _cairo_xlib_surface cairo_xlib_surface_t;
  61
  62 /* size of color cube */
  63 #define CUBE_SIZE 6
  64 /* size of gray ramp */
  65 #define RAMP_SIZE 16
  66 /* maximum number of cached GC's */
  67 #define GC_CACHE_SIZE 4
  68
  69 struct _cairo_xlib_display {
  70     cairo_device_t base;
  71
  72     cairo_xlib_display_t *next;
  73
  74     Display *display;
  75     cairo_list_t screens;
  76     cairo_list_t fonts;
  77
  78     cairo_xlib_shm_display_t *shm;
  79
  80     const cairo_compositor_t *compositor;
  81
  82     int render_major;
  83     int render_minor;
  84     XRenderPictFormat *cached_xrender_formats[CAIRO_FORMAT_RGB16_565 + 1];
  85
  86     int force_precision;
  87
  88     cairo_surface_t *white;
  89     cairo_surface_t *alpha[256];
  90     cairo_surface_t *solid[32];
  91     uint32_t solid_cache[32]; /* low 16 are opaque, high 16 transparent */
  92     struct {
  93         uint32_t color;
  94         int index;
  95     } last_solid_cache[2];
  96
  97     /* TRUE if the server has a bug with repeating pictures
  98      *
  99      *  https://bugs.freedesktop.org/show_bug.cgi?id=3566
 100      *
 101      * We can't test for this because it depends on whether the
 102      * picture is in video memory or not.
 103      *
 104      * We also use this variable as a guard against a second
 105      * independent bug with transformed repeating pictures:
 106      *
 107      * http://lists.freedesktop.org/archives/cairo/2004-September/001839.html
 108      *
 109      * Both are fixed in xorg >= 6.9 and hopefully in > 6.8.2, so
 110      * we can reuse the test for now.
 111      */
 112     unsigned int buggy_gradients : 1;
 113     unsigned int buggy_pad_reflect : 1;
 114     unsigned int buggy_repeat : 1;
 115     unsigned int closed :1;
 116 };
 117
 118 typedef struct _cairo_xlib_visual_info {
 119     cairo_list_t link;
 120     VisualID visualid;
 121     struct { uint8_t a, r, g, b; } colors[256];
 122     uint8_t cube_to_pseudocolor[CUBE_SIZE][CUBE_SIZE][CUBE_SIZE];
 123     uint8_t field8_to_cube[256];
 124     int8_t  dither8_to_cube[256];
 125     uint8_t gray8_to_pseudocolor[256];
 126 } cairo_xlib_visual_info_t;
 127
 128 struct _cairo_xlib_screen {
 129     cairo_list_t link;
 130
 131     cairo_device_t *device;
 132     Screen *screen;
 133
 134     cairo_list_t surfaces;
 135
 136     cairo_bool_t has_font_options;
 137     cairo_font_options_t font_options;
 138
 139     GC gc[GC_CACHE_SIZE];
 140     uint8_t gc_depths[GC_CACHE_SIZE];
 141
 142     cairo_list_t visuals;
 143 };
 144
 145 enum {
 146     GLYPHSET_INDEX_ARGB32,
 147     GLYPHSET_INDEX_A8,
 148     GLYPHSET_INDEX_A1,
 149     NUM_GLYPHSETS
 150 };
 151
 152 typedef struct _cairo_xlib_font_glyphset {
 153     GlyphSet            glyphset;
 154     cairo_format_t      format;
 155     XRenderPictFormat   *xrender_format;
 156     struct _cairo_xlib_font_glyphset_free_glyphs {
 157         int             count;
 158         unsigned long   indices[128];
 159     } to_free;
 160 } cairo_xlib_font_glyphset_t;
 161
 162 typedef struct _cairo_xlib_font {
 163     cairo_scaled_font_private_t         base;
 164     cairo_scaled_font_t                 *font;
 165     cairo_device_t                      *device;
 166     cairo_list_t                        link;
 167     cairo_xlib_font_glyphset_t          glyphset[NUM_GLYPHSETS];
 168 } cairo_xlib_font_t;
 169
 170 struct _cairo_xlib_surface {
 171     cairo_surface_t base;
 172
 173     Picture picture;
 174
 175     const cairo_compositor_t *compositor;
 176     cairo_surface_t *shm;
 177     int fallback;
 178
 179     cairo_xlib_display_t *display;
 180     cairo_xlib_screen_t *screen;
 181     cairo_list_t link;
 182
 183     Display *dpy; /* only valid between acquire/release */
 184     Drawable drawable;
 185     cairo_bool_t owns_pixmap;
 186     Visual *visual;
 187
 188     int use_pixmap;
 189
 190     int width;
 191     int height;
 192     int depth;
 193
 194     int precision;
 195     XRenderPictFormat *xrender_format;
 196     /* XXX pixman_format instead of masks? */
 197     uint32_t a_mask;
 198     uint32_t r_mask;
 199     uint32_t g_mask;
 200     uint32_t b_mask;
 201
 202     struct _cairo_xlib_source {
 203         cairo_surface_t base;
 204
 205         Picture picture;
 206         Display *dpy;
 207
 208         unsigned int filter:3;
 209         unsigned int extend:3;
 210         unsigned int has_matrix:1;
 211         unsigned int has_component_alpha:1;
 212     } embedded_source;
 213 };
 214
 215 struct _cairo_xlib_proxy {
 216     struct _cairo_xlib_source source;
 217     cairo_surface_t *owner;
 218 };
 219
 220 inline static cairo_bool_t
 221 _cairo_xlib_vendor_is_xorg (Display *dpy)
 222 {
 223     const char *const vendor = ServerVendor (dpy);
 224     return strstr (vendor, "X.Org") || strstr (vendor, "Xorg");
 225 }
 226
 227 cairo_private cairo_status_t
 228 _cairo_xlib_surface_get_gc (cairo_xlib_display_t *display,
 229                             cairo_xlib_surface_t *surface,
 230                             GC                   *gc);
 231
 232 cairo_private cairo_device_t *
 233 _cairo_xlib_device_create (Display *display);
 234
 235 cairo_private void
 236 _cairo_xlib_display_init_shm (cairo_xlib_display_t *display);
 237
 238 cairo_private void
 239 _cairo_xlib_display_fini_shm (cairo_xlib_display_t *display);
 240
 241 cairo_private cairo_xlib_screen_t *
 242 _cairo_xlib_display_get_screen (cairo_xlib_display_t *display,
 243                                 Screen *screen);
 244
 245 cairo_private cairo_status_t
 246 _cairo_xlib_display_acquire (cairo_device_t *device,
 247                              cairo_xlib_display_t **display);
 248
 249 cairo_private cairo_bool_t
 250 _cairo_xlib_display_has_repeat (cairo_device_t *device);
 251
 252 cairo_private cairo_bool_t
 253 _cairo_xlib_display_has_reflect (cairo_device_t *device);
 254
 255 cairo_private cairo_bool_t
 256 _cairo_xlib_display_has_gradients (cairo_device_t *device);
 257
 258 cairo_private void
 259 _cairo_xlib_display_set_precision(cairo_device_t *device,
 260                                   int precision);
 261
 262 cairo_private XRenderPictFormat *
 263 _cairo_xlib_display_get_xrender_format (cairo_xlib_display_t    *display,
 264                                         cairo_format_t           format);
 265
 266 cairo_private XRenderPictFormat *
 267 _cairo_xlib_display_get_xrender_format_for_pixman (cairo_xlib_display_t *display,
 268                                                    pixman_format_code_t format);
 269
 270 cairo_private cairo_status_t
 271 _cairo_xlib_screen_get (Display *dpy,
 272                         Screen *screen,
 273                         cairo_xlib_screen_t **out);
 274
 275 cairo_private void
 276 _cairo_xlib_screen_destroy (cairo_xlib_display_t *display,
 277                             cairo_xlib_screen_t *info);
 278
 279 cairo_private GC
 280 _cairo_xlib_screen_get_gc (cairo_xlib_display_t *display,
 281                            cairo_xlib_screen_t *info,
 282                            int depth,
 283                            Drawable drawable);
 284 cairo_private void
 285 _cairo_xlib_screen_put_gc (cairo_xlib_display_t *display,
 286                            cairo_xlib_screen_t *info,
 287                            int depth,
 288                            GC gc);
 289
 290 cairo_private cairo_font_options_t *
 291 _cairo_xlib_screen_get_font_options (cairo_xlib_screen_t *info);
 292
 293 cairo_private cairo_status_t
 294 _cairo_xlib_screen_get_visual_info (cairo_xlib_display_t *display,
 295                                     cairo_xlib_screen_t *info,
 296                                     Visual *visual,
 297                                     cairo_xlib_visual_info_t **out);
 298
 299 cairo_private cairo_status_t
 300 _cairo_xlib_visual_info_create (Display *dpy,
 301                                 int screen,
 302                                 VisualID visualid,
 303                                 cairo_xlib_visual_info_t **out);
 304
 305 cairo_private void
 306 _cairo_xlib_visual_info_destroy (cairo_xlib_visual_info_t *info);
 307
 308 cairo_private const cairo_compositor_t *
 309 _cairo_xlib_core_compositor_get (void);
 310
 311 cairo_private const cairo_compositor_t *
 312 _cairo_xlib_fallback_compositor_get (void);
 313
 314 cairo_private const cairo_compositor_t *
 315 _cairo_xlib_mask_compositor_get (void);
 316
 317 cairo_private const cairo_compositor_t *
 318 _cairo_xlib_traps_compositor_get (void);
 319
 320 cairo_private void
 321 _cairo_xlib_surface_ensure_picture (cairo_xlib_surface_t    *surface);
 322
 323 cairo_private void
 324 _cairo_xlib_surface_set_precision (cairo_xlib_surface_t *surface,
 325                                    cairo_antialias_t     antialias);
 326
 327 cairo_private cairo_int_status_t
 328 _cairo_xlib_surface_set_attributes (cairo_xlib_display_t       *display,
 329                                     cairo_xlib_surface_t       *surface,
 330                                     cairo_surface_attributes_t *attributes,
 331                                     double                      xc,
 332                                     double                      yc);
 333
 334 cairo_private cairo_status_t
 335 _cairo_xlib_surface_draw_image (cairo_xlib_surface_t   *surface,
 336                                 cairo_image_surface_t  *image,
 337                                 int                    src_x,
 338                                 int                    src_y,
 339                                 int                    width,
 340                                 int                    height,
 341                                 int                    dst_x,
 342                                 int                    dst_y);
 343
 344 cairo_private cairo_surface_t *
 345 _cairo_xlib_source_create_for_pattern (cairo_surface_t *dst,
 346                                        const cairo_pattern_t *pattern,
 347                                        cairo_bool_t is_mask,
 348                                        const cairo_rectangle_int_t *extents,
 349                                        const cairo_rectangle_int_t *sample,
 350                                        int *src_x, int *src_y);
 351
 352 cairo_private void
 353 _cairo_xlib_font_close (cairo_xlib_font_t *font);
 354
 355 #define CAIRO_RENDER_AT_LEAST(surface, major, minor)    \
 356         (((surface)->render_major > major) ||                   \
 357          (((surface)->render_major == major) && ((surface)->render_minor >= minor)))
 358
 359 #define CAIRO_RENDER_HAS_CREATE_PICTURE(surface)                CAIRO_RENDER_AT_LEAST((surface), 0, 0)
 360 #define CAIRO_RENDER_HAS_COMPOSITE(surface)             CAIRO_RENDER_AT_LEAST((surface), 0, 0)
 361 #define CAIRO_RENDER_HAS_COMPOSITE_TEXT(surface)        CAIRO_RENDER_AT_LEAST((surface), 0, 0)
 362
 363 #define CAIRO_RENDER_HAS_FILL_RECTANGLES(surface)               CAIRO_RENDER_AT_LEAST((surface), 0, 1)
 364
 365 #define CAIRO_RENDER_HAS_DISJOINT(surface)                      CAIRO_RENDER_AT_LEAST((surface), 0, 2)
 366 #define CAIRO_RENDER_HAS_CONJOINT(surface)                      CAIRO_RENDER_AT_LEAST((surface), 0, 2)
 367
 368 #define CAIRO_RENDER_HAS_TRAPEZOIDS(surface)            CAIRO_RENDER_AT_LEAST((surface), 0, 4)
 369 #define CAIRO_RENDER_HAS_TRIANGLES(surface)             CAIRO_RENDER_AT_LEAST((surface), 0, 4)
 370 #define CAIRO_RENDER_HAS_TRISTRIP(surface)                      CAIRO_RENDER_AT_LEAST((surface), 0, 4)
 371 #define CAIRO_RENDER_HAS_TRIFAN(surface)                        CAIRO_RENDER_AT_LEAST((surface), 0, 4)
 372
 373 #define CAIRO_RENDER_HAS_PICTURE_TRANSFORM(surface)     CAIRO_RENDER_AT_LEAST((surface), 0, 6)
 374 #define CAIRO_RENDER_HAS_FILTERS(surface)       CAIRO_RENDER_AT_LEAST((surface), 0, 6)
 375
 376 #define CAIRO_RENDER_HAS_EXTENDED_REPEAT(surface)       CAIRO_RENDER_AT_LEAST((surface), 0, 10)
 377 #define CAIRO_RENDER_HAS_GRADIENTS(surface)     CAIRO_RENDER_AT_LEAST((surface), 0, 10)
 378
 379 #define CAIRO_RENDER_HAS_PDF_OPERATORS(surface) CAIRO_RENDER_AT_LEAST((surface), 0, 11)
 380
 381 #define CAIRO_RENDER_SUPPORTS_OPERATOR(surface, op)     \
 382      ((op) <= CAIRO_OPERATOR_SATURATE ||                        \
 383       (CAIRO_RENDER_HAS_PDF_OPERATORS(surface) &&       \
 384        (op) <= CAIRO_OPERATOR_HSL_LUMINOSITY))
 385
 386 /*
 387  * Return whether two xlib surfaces share the same
 388  * screen.  Both core and Render drawing require this
 389  * when using multiple drawables in an operation.
 390  */
 391 static inline cairo_bool_t
 392 _cairo_xlib_surface_same_screen (cairo_xlib_surface_t *dst,
 393                                  cairo_xlib_surface_t *src)
 394 {
 395     return dst->screen == src->screen;
 396 }
 397
 398 static inline void
 399 _cairo_xlib_surface_put_gc (cairo_xlib_display_t *display,
 400                             cairo_xlib_surface_t *surface,
 401                             GC                    gc)
 402 {
 403     _cairo_xlib_screen_put_gc (display,
 404                                surface->screen,
 405                                surface->depth,
 406                                gc);
 407 }
 408
 409 cairo_private cairo_surface_t *
 410 _cairo_xlib_surface_create_similar_shm (void *surface,
 411                                         cairo_format_t format,
 412                                         int width, int height);
 413
 414 cairo_private cairo_surface_t *
 415 _cairo_xlib_surface_get_shm (cairo_xlib_surface_t *surface,
 416                              cairo_bool_t overwrite);
 417
 418 cairo_private cairo_int_status_t
 419 _cairo_xlib_surface_put_shm (cairo_xlib_surface_t *surface);
 420
 421 cairo_private cairo_surface_t *
 422 _cairo_xlib_surface_create_shm (cairo_xlib_surface_t *other,
 423                                 pixman_format_code_t format,
 424                                 int width, int height);
 425
 426 cairo_private cairo_surface_t *
 427 _cairo_xlib_surface_create_shm__image (cairo_xlib_surface_t *surface,
 428                                        pixman_format_code_t format,
 429                                        int width, int height);
 430
 431 cairo_private void
 432 _cairo_xlib_shm_surface_get_ximage (cairo_surface_t *surface,
 433                                     XImage *ximage);
 434
 435 cairo_private void *
 436 _cairo_xlib_shm_surface_get_obdata (cairo_surface_t *surface);
 437
 438 cairo_private void
 439 _cairo_xlib_shm_surface_mark_active (cairo_surface_t *shm);
 440
 441 cairo_private cairo_bool_t
 442 _cairo_xlib_shm_surface_is_active (cairo_surface_t *surface);
 443
 444 cairo_private cairo_bool_t
 445 _cairo_xlib_shm_surface_is_idle (cairo_surface_t *surface);
 446
 447 cairo_private Pixmap
 448 _cairo_xlib_shm_surface_get_pixmap (cairo_surface_t *surface);
 449
 450 cairo_private XRenderPictFormat *
 451 _cairo_xlib_shm_surface_get_xrender_format (cairo_surface_t *surface);
 452
 453 cairo_private pixman_format_code_t
 454 _pixman_format_for_xlib_surface (cairo_xlib_surface_t *surface);
 455
 456
 457 #endif /* CAIRO_XLIB_PRIVATE_H */