pixman/pixman.h

   1 /***********************************************************
   2
   3 Copyright 1987, 1998  The Open Group
   4
   5 Permission to use, copy, modify, distribute, and sell this software and its
   6 documentation for any purpose is hereby granted without fee, provided that
   7 the above copyright notice appear in all copies and that both that
   8 copyright notice and this permission notice appear in supporting
   9 documentation.
  10
  11 The above copyright notice and this permission notice shall be included in
  12 all copies or substantial portions of the Software.
  13
  14 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  15 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  16 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
  17 OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
  18 AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
  19 CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  20
  21 Except as contained in this notice, the name of The Open Group shall not be
  22 used in advertising or otherwise to promote the sale, use or other dealings
  23 in this Software without prior written authorization from The Open Group.
  24
  25 Copyright 1987 by Digital Equipment Corporation, Maynard, Massachusetts.
  26
  27                         All Rights Reserved
  28
  29 Permission to use, copy, modify, and distribute this software and its
  30 documentation for any purpose and without fee is hereby granted,
  31 provided that the above copyright notice appear in all copies and that
  32 both that copyright notice and this permission notice appear in
  33 supporting documentation, and that the name of Digital not be
  34 used in advertising or publicity pertaining to distribution of the
  35 software without specific, written prior permission.
  36
  37 DIGITAL DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING
  38 ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL
  39 DIGITAL BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR
  40 ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
  41 WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
  42 ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
  43 SOFTWARE.
  44
  45 ******************************************************************/
  46 /*
  47  * Copyright © 1998, 2004 Keith Packard
  48  * Copyright   2007 Red Hat, Inc.
  49  *
  50  * Permission to use, copy, modify, distribute, and sell this software and its
  51  * documentation for any purpose is hereby granted without fee, provided that
  52  * the above copyright notice appear in all copies and that both that
  53  * copyright notice and this permission notice appear in supporting
  54  * documentation, and that the name of Keith Packard not be used in
  55  * advertising or publicity pertaining to distribution of the software without
  56  * specific, written prior permission.  Keith Packard makes no
  57  * representations about the suitability of this software for any purpose.  It
  58  * is provided "as is" without express or implied warranty.
  59  *
  60  * KEITH PACKARD DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
  61  * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
  62  * EVENT SHALL KEITH PACKARD BE LIABLE FOR ANY SPECIAL, INDIRECT OR
  63  * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
  64  * DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
  65  * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
  66  * PERFORMANCE OF THIS SOFTWARE.
  67  */
  68
  69 #ifndef PIXMAN_H__
  70 #define PIXMAN_H__
  71
  72 #include <pixman-version.h>
  73
  74 /*
  75  * Standard integers
  76  */
  77 #if defined (_SVR4) || defined (SVR4) || defined (__OpenBSD__) || defined (_sgi)
  78 #  include <inttypes.h>
  79 #elif defined (_MSC_VER)
  80 typedef __int8 int8_t;
  81 typedef unsigned __int8 uint8_t;
  82 typedef __int16 int16_t;
  83 typedef unsigned __int16 uint16_t;
  84 typedef __int32 int32_t;
  85 typedef unsigned __int32 uint32_t;
  86 typedef __int64 int64_t;
  87 typedef unsigned __int64 uint64_t;
  88 #else
  89 #  include <stdint.h>
  90 #endif
  91
  92 /*
  93  * Boolean
  94  */
  95 typedef int pixman_bool_t;
  96
  97 /*
  98  * Fixpoint numbers
  99  */
 100 typedef int64_t                 pixman_fixed_32_32_t;
 101 typedef pixman_fixed_32_32_t    pixman_fixed_48_16_t;
 102 typedef uint32_t                pixman_fixed_1_31_t;
 103 typedef uint32_t                pixman_fixed_1_16_t;
 104 typedef int32_t                 pixman_fixed_16_16_t;
 105 typedef pixman_fixed_16_16_t    pixman_fixed_t;
 106
 107 #define pixman_fixed_e                  ((pixman_fixed_t) 1)
 108 #define pixman_fixed_1                  (pixman_int_to_fixed(1))
 109 #define pixman_fixed_1_minus_e          (pixman_fixed_1 - pixman_fixed_e)
 110 #define pixman_fixed_to_int(f)          ((int) ((f) >> 16))
 111 #define pixman_int_to_fixed(i)          ((pixman_fixed_t) ((i) << 16))
 112 #define pixman_fixed_to_double(f)       (double) ((f) / (double) pixman_fixed_1)
 113 #define pixman_double_to_fixed(d)       ((pixman_fixed_t) ((d) * 65536.0))
 114 #define pixman_fixed_frac(f)            ((f) & pixman_fixed_1_minus_e)
 115 #define pixman_fixed_floor(f)           ((f) & ~pixman_fixed_1_minus_e)
 116 #define pixman_fixed_ceil(f)            pixman_fixed_floor ((f) + pixman_fixed_1_minus_e)
 117 #define pixman_fixed_fraction(f)        ((f) & pixman_fixed_1_minus_e)
 118 #define pixman_fixed_mod_2(f)           ((f) & (pixman_fixed1 | pixman_fixed_1_minus_e))
 119 #define pixman_max_fixed_48_16          ((pixman_fixed_48_16_t) 0x7fffffff)
 120 #define pixman_min_fixed_48_16          (-((pixman_fixed_48_16_t) 1 << 31))
 121
 122 /*
 123  * Misc structs
 124  */
 125 typedef struct pixman_color pixman_color_t;
 126 typedef struct pixman_point_fixed pixman_point_fixed_t;
 127 typedef struct pixman_line_fixed pixman_line_fixed_t;
 128 typedef struct pixman_vector pixman_vector_t;
 129 typedef struct pixman_transform pixman_transform_t;
 130
 131 struct pixman_color
 132 {
 133     uint16_t    red;
 134     uint16_t    green;
 135     uint16_t    blue;
 136     uint16_t    alpha;
 137 };
 138
 139 struct pixman_point_fixed
 140 {
 141     pixman_fixed_t      x;
 142     pixman_fixed_t      y;
 143 };
 144
 145 struct pixman_line_fixed
 146 {
 147     pixman_point_fixed_t        p1, p2;
 148 };
 149
 150 struct pixman_vector
 151 {
 152     pixman_fixed_t      vector[3];
 153 };
 154
 155 struct pixman_transform
 156 {
 157     pixman_fixed_t      matrix[3][3];
 158 };
 159
 160 /* Don't blame me, blame XRender */
 161 typedef enum
 162 {
 163     PIXMAN_REPEAT_NONE,
 164     PIXMAN_REPEAT_NORMAL,
 165     PIXMAN_REPEAT_PAD,
 166     PIXMAN_REPEAT_REFLECT
 167 } pixman_repeat_t;
 168
 169 typedef enum
 170 {
 171     PIXMAN_FILTER_FAST,
 172     PIXMAN_FILTER_GOOD,
 173     PIXMAN_FILTER_BEST,
 174     PIXMAN_FILTER_NEAREST,
 175     PIXMAN_FILTER_BILINEAR,
 176     PIXMAN_FILTER_CONVOLUTION
 177 } pixman_filter_t;
 178
 179 typedef enum
 180 {
 181     PIXMAN_OP_CLEAR                     = 0x00,
 182     PIXMAN_OP_SRC                       = 0x01,
 183     PIXMAN_OP_DST                       = 0x02,
 184     PIXMAN_OP_OVER                      = 0x03,
 185     PIXMAN_OP_OVER_REVERSE              = 0x04,
 186     PIXMAN_OP_IN                        = 0x05,
 187     PIXMAN_OP_IN_REVERSE                = 0x06,
 188     PIXMAN_OP_OUT                       = 0x07,
 189     PIXMAN_OP_OUT_REVERSE               = 0x08,
 190     PIXMAN_OP_ATOP                      = 0x09,
 191     PIXMAN_OP_ATOP_REVERSE              = 0x0a,
 192     PIXMAN_OP_XOR                       = 0x0b,
 193     PIXMAN_OP_ADD                       = 0x0c,
 194     PIXMAN_OP_SATURATE                  = 0x0d,
 195
 196     PIXMAN_OP_DISJOINT_CLEAR            = 0x10,
 197     PIXMAN_OP_DISJOINT_SRC              = 0x11,
 198     PIXMAN_OP_DISJOINT_DST              = 0x12,
 199     PIXMAN_OP_DISJOINT_OVER             = 0x13,
 200     PIXMAN_OP_DISJOINT_OVER_REVERSE     = 0x14,
 201     PIXMAN_OP_DISJOINT_IN               = 0x15,
 202     PIXMAN_OP_DISJOINT_IN_REVERSE       = 0x16,
 203     PIXMAN_OP_DISJOINT_OUT              = 0x17,
 204     PIXMAN_OP_DISJOINT_OUT_REVERSE      = 0x18,
 205     PIXMAN_OP_DISJOINT_ATOP             = 0x19,
 206     PIXMAN_OP_DISJOINT_ATOP_REVERSE     = 0x1a,
 207     PIXMAN_OP_DISJOINT_XOR              = 0x1b,
 208
 209     PIXMAN_OP_CONJOINT_CLEAR            = 0x20,
 210     PIXMAN_OP_CONJOINT_SRC              = 0x21,
 211     PIXMAN_OP_CONJOINT_DST              = 0x22,
 212     PIXMAN_OP_CONJOINT_OVER             = 0x23,
 213     PIXMAN_OP_CONJOINT_OVER_REVERSE     = 0x24,
 214     PIXMAN_OP_CONJOINT_IN               = 0x25,
 215     PIXMAN_OP_CONJOINT_IN_REVERSE       = 0x26,
 216     PIXMAN_OP_CONJOINT_OUT              = 0x27,
 217     PIXMAN_OP_CONJOINT_OUT_REVERSE      = 0x28,
 218     PIXMAN_OP_CONJOINT_ATOP             = 0x29,
 219     PIXMAN_OP_CONJOINT_ATOP_REVERSE     = 0x2a,
 220     PIXMAN_OP_CONJOINT_XOR              = 0x2b,
 221
 222     PIXMAN_OP_NONE
 223 } pixman_op_t;
 224
 225 /*
 226  * Regions
 227  */
 228 typedef struct pixman_region16_data     pixman_region16_data_t;
 229 typedef struct pixman_box16             pixman_box16_t;
 230 typedef struct pixman_rectangle16       pixman_rectangle16_t;
 231 typedef struct pixman_region16          pixman_region16_t;
 232
 233 struct pixman_region16_data {
 234     long                size;
 235     long                numRects;
 236 /*  pixman_box16_t      rects[size];   in memory but not explicitly declared */
 237 };
 238
 239 struct pixman_rectangle16
 240 {
 241     int16_t x, y;
 242     uint16_t width, height;
 243 };
 244
 245 struct pixman_box16
 246 {
 247     int16_t x1, y1, x2, y2;
 248 };
 249
 250 struct pixman_region16
 251 {
 252     pixman_box16_t          extents;
 253     pixman_region16_data_t  *data;
 254 };
 255
 256 typedef enum
 257 {
 258     PIXMAN_REGION_OUT,
 259     PIXMAN_REGION_IN,
 260     PIXMAN_REGION_PART
 261 } pixman_region_overlap_t;
 262
 263 /* This function exists only to make it possible to preserve the X ABI - it should
 264  * go away at first opportunity.
 265  */
 266 void                    pixman_region_set_static_pointers (pixman_box16_t         *empty_box,
 267                                                            pixman_region16_data_t *empty_data,
 268                                                            pixman_region16_data_t *broken_data);
 269
 270
 271 /* creation/destruction */
 272 void                    pixman_region_init                (pixman_region16_t      *region);
 273 void                    pixman_region_init_rect           (pixman_region16_t      *region,
 274                                                            int                     x,
 275                                                            int                     y,
 276                                                            unsigned int            width,
 277                                                            unsigned int            height);
 278 pixman_bool_t           pixman_region_init_rects          (pixman_region16_t      *region,
 279                                                            pixman_box16_t         *boxes,
 280                                                            int                     count);
 281 void                    pixman_region_init_with_extents   (pixman_region16_t      *region,
 282                                                            pixman_box16_t         *extents);
 283 void                    pixman_region_fini                (pixman_region16_t      *region);
 284
 285
 286 /* manipulation */
 287 void                    pixman_region_translate           (pixman_region16_t      *region,
 288                                                            int                     x,
 289                                                            int                     y);
 290 pixman_bool_t           pixman_region_copy                (pixman_region16_t      *dest,
 291                                                            pixman_region16_t      *source);
 292 pixman_bool_t           pixman_region_intersect           (pixman_region16_t      *newReg,
 293                                                            pixman_region16_t      *reg1,
 294                                                            pixman_region16_t      *reg2);
 295 pixman_bool_t           pixman_region_union               (pixman_region16_t      *newReg,
 296                                                            pixman_region16_t      *reg1,
 297                                                            pixman_region16_t      *reg2);
 298 pixman_bool_t           pixman_region_union_rect          (pixman_region16_t      *dest,
 299                                                            pixman_region16_t      *source,
 300                                                            int                     x,
 301                                                            int                     y,
 302                                                            unsigned int            width,
 303                                                            unsigned int            height);
 304 pixman_bool_t           pixman_region_subtract            (pixman_region16_t      *regD,
 305                                                            pixman_region16_t      *regM,
 306                                                            pixman_region16_t      *regS);
 307 pixman_bool_t           pixman_region_inverse             (pixman_region16_t      *newReg,
 308                                                            pixman_region16_t      *reg1,
 309                                                            pixman_box16_t         *invRect);
 310 pixman_bool_t           pixman_region_contains_point      (pixman_region16_t      *region,
 311                                                            int                     x,
 312                                                            int                     y,
 313                                                            pixman_box16_t         *box);
 314 pixman_region_overlap_t pixman_region_contains_rectangle  (pixman_region16_t      *pixman_region16_t,
 315                                                            pixman_box16_t         *prect);
 316 pixman_bool_t           pixman_region_not_empty           (pixman_region16_t      *region);
 317 pixman_box16_t *        pixman_region_extents             (pixman_region16_t      *region);
 318 int                     pixman_region_n_rects             (pixman_region16_t      *region);
 319 pixman_box16_t *        pixman_region_rectangles          (pixman_region16_t      *region,
 320                                                            int                    *n_rects);
 321 pixman_bool_t           pixman_region_equal               (pixman_region16_t      *region1,
 322                                                            pixman_region16_t      *region2);
 323 pixman_bool_t           pixman_region_selfcheck           (pixman_region16_t      *region);
 324 void                    pixman_region_reset               (pixman_region16_t      *region,
 325                                                            pixman_box16_t         *box);
 326
 327 /*
 328  * 32 bit regions
 329  */
 330 typedef struct pixman_region32_data     pixman_region32_data_t;
 331 typedef struct pixman_box32             pixman_box32_t;
 332 typedef struct pixman_rectangle32       pixman_rectangle32_t;
 333 typedef struct pixman_region32          pixman_region32_t;
 334
 335 struct pixman_region32_data {
 336     long                size;
 337     long                numRects;
 338 /*  pixman_box32_t      rects[size];   in memory but not explicitly declared */
 339 };
 340
 341 struct pixman_rectangle32
 342 {
 343     int32_t x, y;
 344     uint32_t width, height;
 345 };
 346
 347 struct pixman_box32
 348 {
 349     int32_t x1, y1, x2, y2;
 350 };
 351
 352 struct pixman_region32
 353 {
 354     pixman_box32_t          extents;
 355     pixman_region32_data_t  *data;
 356 };
 357
 358 /* creation/destruction */
 359 void                    pixman_region32_init               (pixman_region32_t *region);
 360 void                    pixman_region32_init_rect          (pixman_region32_t *region,
 361                                                             int                x,
 362                                                             int                y,
 363                                                             unsigned int       width,
 364                                                             unsigned int       height);
 365 pixman_bool_t           pixman_region32_init_rects         (pixman_region32_t *region,
 366                                                             pixman_box32_t    *boxes,
 367                                                             int                count);
 368 void                    pixman_region32_init_with_extents  (pixman_region32_t *region,
 369                                                             pixman_box32_t    *extents);
 370 void                    pixman_region32_fini               (pixman_region32_t *region);
 371
 372
 373 /* manipulation */
 374 void                    pixman_region32_translate          (pixman_region32_t *region,
 375                                                             int                x,
 376                                                             int                y);
 377 pixman_bool_t           pixman_region32_copy               (pixman_region32_t *dest,
 378                                                             pixman_region32_t *source);
 379 pixman_bool_t           pixman_region32_intersect          (pixman_region32_t *newReg,
 380                                                             pixman_region32_t *reg1,
 381                                                             pixman_region32_t *reg2);
 382 pixman_bool_t           pixman_region32_union              (pixman_region32_t *newReg,
 383                                                             pixman_region32_t *reg1,
 384                                                             pixman_region32_t *reg2);
 385 pixman_bool_t           pixman_region32_union_rect         (pixman_region32_t *dest,
 386                                                             pixman_region32_t *source,
 387                                                             int                x,
 388                                                             int                y,
 389                                                             unsigned int       width,
 390                                                             unsigned int       height);
 391 pixman_bool_t           pixman_region32_subtract           (pixman_region32_t *regD,
 392                                                             pixman_region32_t *regM,
 393                                                             pixman_region32_t *regS);
 394 pixman_bool_t           pixman_region32_inverse            (pixman_region32_t *newReg,
 395                                                             pixman_region32_t *reg1,
 396                                                             pixman_box32_t    *invRect);
 397 pixman_bool_t           pixman_region32_contains_point     (pixman_region32_t *region,
 398                                                             int                x,
 399                                                             int                y,
 400                                                             pixman_box32_t    *box);
 401 pixman_region_overlap_t pixman_region32_contains_rectangle (pixman_region32_t *region,
 402                                                             pixman_box32_t    *prect);
 403 pixman_bool_t           pixman_region32_not_empty          (pixman_region32_t *region);
 404 pixman_box32_t *        pixman_region32_extents            (pixman_region32_t *region);
 405 int                     pixman_region32_n_rects            (pixman_region32_t *region);
 406 pixman_box32_t *        pixman_region32_rectangles         (pixman_region32_t *region,
 407                                                             int               *n_rects);
 408 pixman_bool_t           pixman_region32_equal              (pixman_region32_t *region1,
 409                                                             pixman_region32_t *region2);
 410 pixman_bool_t           pixman_region32_selfcheck          (pixman_region32_t *region);
 411 void                    pixman_region32_reset              (pixman_region32_t *region,
 412                                                             pixman_box32_t    *box);
 413
 414
 415 /* Copy / Fill / Misc */
 416 pixman_bool_t pixman_blt                (uint32_t           *src_bits,
 417                                          uint32_t           *dst_bits,
 418                                          int                 src_stride,
 419                                          int                 dst_stride,
 420                                          int                 src_bpp,
 421                                          int                 dst_bpp,
 422                                          int                 src_x,
 423                                          int                 src_y,
 424                                          int                 dst_x,
 425                                          int                 dst_y,
 426                                          int                 width,
 427                                          int                 height);
 428 pixman_bool_t pixman_fill               (uint32_t           *bits,
 429                                          int                 stride,
 430                                          int                 bpp,
 431                                          int                 x,
 432                                          int                 y,
 433                                          int                 width,
 434                                          int                 height,
 435                                          uint32_t            _xor);
 436
 437 pixman_bool_t pixman_transform_point_3d (pixman_transform_t *transform,
 438                                          pixman_vector_t    *vector);
 439
 440 int           pixman_version            (void);
 441 const char*   pixman_version_string     (void);
 442
 443 /*
 444  * Images
 445  */
 446 typedef  union pixman_image             pixman_image_t;
 447 typedef struct pixman_indexed           pixman_indexed_t;
 448 typedef struct pixman_gradient_stop     pixman_gradient_stop_t;
 449
 450 typedef uint32_t (* pixman_read_memory_func_t) (const void *src, int size);
 451 typedef void     (* pixman_write_memory_func_t) (void *dst, uint32_t value, int size);
 452
 453 struct pixman_gradient_stop {
 454     pixman_fixed_t x;
 455     pixman_color_t color;
 456 };
 457
 458 #define PIXMAN_MAX_INDEXED  256 /* XXX depth must be <= 8 */
 459
 460 #if PIXMAN_MAX_INDEXED <= 256
 461 typedef uint8_t pixman_index_type;
 462 #endif
 463
 464 struct pixman_indexed
 465 {
 466     pixman_bool_t       color;
 467     uint32_t            rgba[PIXMAN_MAX_INDEXED];
 468     pixman_index_type   ent[32768];
 469 };
 470
 471 /*
 472  * While the protocol is generous in format support, the
 473  * sample implementation allows only packed RGB and GBR
 474  * representations for data to simplify software rendering,
 475  */
 476 #define PIXMAN_FORMAT(bpp,type,a,r,g,b) (((bpp) << 24) |  \
 477                                          ((type) << 16) | \
 478                                          ((a) << 12) |    \
 479                                          ((r) << 8) |     \
 480                                          ((g) << 4) |     \
 481                                          ((b)))
 482
 483 #define PIXMAN_FORMAT_BPP(f)    (((f) >> 24)       )
 484 #define PIXMAN_FORMAT_TYPE(f)   (((f) >> 16) & 0xff)
 485 #define PIXMAN_FORMAT_A(f)      (((f) >> 12) & 0x0f)
 486 #define PIXMAN_FORMAT_R(f)      (((f) >>  8) & 0x0f)
 487 #define PIXMAN_FORMAT_G(f)      (((f) >>  4) & 0x0f)
 488 #define PIXMAN_FORMAT_B(f)      (((f)      ) & 0x0f)
 489 #define PIXMAN_FORMAT_RGB(f)    (((f)      ) & 0xfff)
 490 #define PIXMAN_FORMAT_VIS(f)    (((f)      ) & 0xffff)
 491 #define PIXMAN_FORMAT_DEPTH(f)  (PIXMAN_FORMAT_A(f) +   \
 492                                  PIXMAN_FORMAT_R(f) +   \
 493                                  PIXMAN_FORMAT_G(f) +   \
 494                                  PIXMAN_FORMAT_B(f))
 495
 496 #define PIXMAN_TYPE_OTHER       0
 497 #define PIXMAN_TYPE_A           1
 498 #define PIXMAN_TYPE_ARGB        2
 499 #define PIXMAN_TYPE_ABGR        3
 500 #define PIXMAN_TYPE_COLOR       4
 501 #define PIXMAN_TYPE_GRAY        5
 502 #define PIXMAN_TYPE_YUY2        6
 503 #define PIXMAN_TYPE_YV12        7
 504
 505 #define PIXMAN_FORMAT_COLOR(f)  (PIXMAN_FORMAT_TYPE(f) & 2)
 506
 507 /* 32bpp formats */
 508 typedef enum {
 509     PIXMAN_a8r8g8b8 =   PIXMAN_FORMAT(32,PIXMAN_TYPE_ARGB,8,8,8,8),
 510     PIXMAN_x8r8g8b8 =   PIXMAN_FORMAT(32,PIXMAN_TYPE_ARGB,0,8,8,8),
 511     PIXMAN_a8b8g8r8 =   PIXMAN_FORMAT(32,PIXMAN_TYPE_ABGR,8,8,8,8),
 512     PIXMAN_x8b8g8r8 =   PIXMAN_FORMAT(32,PIXMAN_TYPE_ABGR,0,8,8,8),
 513     PIXMAN_x2b10g10r10 = PIXMAN_FORMAT(32,PIXMAN_TYPE_ABGR,0,10,10,10),
 514     PIXMAN_a2b10g10r10 = PIXMAN_FORMAT(32,PIXMAN_TYPE_ABGR,2,10,10,10),
 515
 516 /* 24bpp formats */
 517     PIXMAN_r8g8b8 =     PIXMAN_FORMAT(24,PIXMAN_TYPE_ARGB,0,8,8,8),
 518     PIXMAN_b8g8r8 =     PIXMAN_FORMAT(24,PIXMAN_TYPE_ABGR,0,8,8,8),
 519
 520 /* 16bpp formats */
 521     PIXMAN_r5g6b5 =     PIXMAN_FORMAT(16,PIXMAN_TYPE_ARGB,0,5,6,5),
 522     PIXMAN_b5g6r5 =     PIXMAN_FORMAT(16,PIXMAN_TYPE_ABGR,0,5,6,5),
 523
 524     PIXMAN_a1r5g5b5 =   PIXMAN_FORMAT(16,PIXMAN_TYPE_ARGB,1,5,5,5),
 525     PIXMAN_x1r5g5b5 =   PIXMAN_FORMAT(16,PIXMAN_TYPE_ARGB,0,5,5,5),
 526     PIXMAN_a1b5g5r5 =   PIXMAN_FORMAT(16,PIXMAN_TYPE_ABGR,1,5,5,5),
 527     PIXMAN_x1b5g5r5 =   PIXMAN_FORMAT(16,PIXMAN_TYPE_ABGR,0,5,5,5),
 528     PIXMAN_a4r4g4b4 =   PIXMAN_FORMAT(16,PIXMAN_TYPE_ARGB,4,4,4,4),
 529     PIXMAN_x4r4g4b4 =   PIXMAN_FORMAT(16,PIXMAN_TYPE_ARGB,0,4,4,4),
 530     PIXMAN_a4b4g4r4 =   PIXMAN_FORMAT(16,PIXMAN_TYPE_ABGR,4,4,4,4),
 531     PIXMAN_x4b4g4r4 =   PIXMAN_FORMAT(16,PIXMAN_TYPE_ABGR,0,4,4,4),
 532
 533 /* 8bpp formats */
 534     PIXMAN_a8 =         PIXMAN_FORMAT(8,PIXMAN_TYPE_A,8,0,0,0),
 535     PIXMAN_r3g3b2 =     PIXMAN_FORMAT(8,PIXMAN_TYPE_ARGB,0,3,3,2),
 536     PIXMAN_b2g3r3 =     PIXMAN_FORMAT(8,PIXMAN_TYPE_ABGR,0,3,3,2),
 537     PIXMAN_a2r2g2b2 =   PIXMAN_FORMAT(8,PIXMAN_TYPE_ARGB,2,2,2,2),
 538     PIXMAN_a2b2g2r2 =   PIXMAN_FORMAT(8,PIXMAN_TYPE_ABGR,2,2,2,2),
 539
 540     PIXMAN_c8 =         PIXMAN_FORMAT(8,PIXMAN_TYPE_COLOR,0,0,0,0),
 541     PIXMAN_g8 =         PIXMAN_FORMAT(8,PIXMAN_TYPE_GRAY,0,0,0,0),
 542
 543     PIXMAN_x4a4 =       PIXMAN_FORMAT(8,PIXMAN_TYPE_A,4,0,0,0),
 544
 545     PIXMAN_x4c4 =       PIXMAN_FORMAT(8,PIXMAN_TYPE_COLOR,0,0,0,0),
 546     PIXMAN_x4g4 =       PIXMAN_FORMAT(8,PIXMAN_TYPE_GRAY,0,0,0,0),
 547
 548 /* 4bpp formats */
 549     PIXMAN_a4 =         PIXMAN_FORMAT(4,PIXMAN_TYPE_A,4,0,0,0),
 550     PIXMAN_r1g2b1 =     PIXMAN_FORMAT(4,PIXMAN_TYPE_ARGB,0,1,2,1),
 551     PIXMAN_b1g2r1 =     PIXMAN_FORMAT(4,PIXMAN_TYPE_ABGR,0,1,2,1),
 552     PIXMAN_a1r1g1b1 =   PIXMAN_FORMAT(4,PIXMAN_TYPE_ARGB,1,1,1,1),
 553     PIXMAN_a1b1g1r1 =   PIXMAN_FORMAT(4,PIXMAN_TYPE_ABGR,1,1,1,1),
 554
 555     PIXMAN_c4 =         PIXMAN_FORMAT(4,PIXMAN_TYPE_COLOR,0,0,0,0),
 556     PIXMAN_g4 =         PIXMAN_FORMAT(4,PIXMAN_TYPE_GRAY,0,0,0,0),
 557
 558 /* 1bpp formats */
 559     PIXMAN_a1 =         PIXMAN_FORMAT(1,PIXMAN_TYPE_A,1,0,0,0),
 560
 561     PIXMAN_g1 =         PIXMAN_FORMAT(1,PIXMAN_TYPE_GRAY,0,0,0,0),
 562
 563 /* YUV formats */
 564     PIXMAN_yuy2 =       PIXMAN_FORMAT(16,PIXMAN_TYPE_YUY2,0,0,0,0),
 565     PIXMAN_yv12 =       PIXMAN_FORMAT(12,PIXMAN_TYPE_YV12,0,0,0,0)
 566 } pixman_format_code_t;
 567
 568 /* Querying supported format values. */
 569 pixman_bool_t pixman_format_supported_destination (pixman_format_code_t format);
 570 pixman_bool_t pixman_format_supported_source      (pixman_format_code_t format);
 571
 572 /* Constructors */
 573 pixman_image_t *pixman_image_create_solid_fill       (pixman_color_t               *color);
 574 pixman_image_t *pixman_image_create_linear_gradient  (pixman_point_fixed_t         *p1,
 575                                                       pixman_point_fixed_t         *p2,
 576                                                       const pixman_gradient_stop_t *stops,
 577                                                       int                           n_stops);
 578 pixman_image_t *pixman_image_create_radial_gradient  (pixman_point_fixed_t         *inner,
 579                                                       pixman_point_fixed_t         *outer,
 580                                                       pixman_fixed_t                inner_radius,
 581                                                       pixman_fixed_t                outer_radius,
 582                                                       const pixman_gradient_stop_t *stops,
 583                                                       int                           n_stops);
 584 pixman_image_t *pixman_image_create_conical_gradient (pixman_point_fixed_t         *center,
 585                                                       pixman_fixed_t                angle,
 586                                                       const pixman_gradient_stop_t *stops,
 587                                                       int                           n_stops);
 588 pixman_image_t *pixman_image_create_bits             (pixman_format_code_t          format,
 589                                                       int                           width,
 590                                                       int                           height,
 591                                                       uint32_t                     *bits,
 592                                                       int                           rowstride_bytes);
 593
 594 /* Destructor */
 595 pixman_image_t *pixman_image_ref                     (pixman_image_t               *image);
 596 pixman_bool_t   pixman_image_unref                   (pixman_image_t               *image);
 597
 598
 599 /* Set properties */
 600 pixman_bool_t   pixman_image_set_clip_region         (pixman_image_t               *image,
 601                                                       pixman_region16_t            *region);
 602 pixman_bool_t   pixman_image_set_clip_region32       (pixman_image_t               *image,
 603                                                       pixman_region32_t            *region);
 604 void            pixman_image_set_has_client_clip     (pixman_image_t               *image,
 605                                                       pixman_bool_t                 clien_clip);
 606 pixman_bool_t   pixman_image_set_transform           (pixman_image_t               *image,
 607                                                       const pixman_transform_t     *transform);
 608 void            pixman_image_set_repeat              (pixman_image_t               *image,
 609                                                       pixman_repeat_t               repeat);
 610 pixman_bool_t   pixman_image_set_filter              (pixman_image_t               *image,
 611                                                       pixman_filter_t               filter,
 612                                                       const pixman_fixed_t         *filter_params,
 613                                                       int                           n_filter_params);
 614 void            pixman_image_set_source_clipping     (pixman_image_t               *image,
 615                                                       pixman_bool_t                 source_clipping);
 616 void            pixman_image_set_alpha_map           (pixman_image_t               *image,
 617                                                       pixman_image_t               *alpha_map,
 618                                                       int16_t                       x,
 619                                                       int16_t                       y);
 620 void            pixman_image_set_component_alpha     (pixman_image_t               *image,
 621                                                       pixman_bool_t                 component_alpha);
 622 void            pixman_image_set_accessors           (pixman_image_t               *image,
 623                                                       pixman_read_memory_func_t     read_func,
 624                                                       pixman_write_memory_func_t    write_func);
 625 void            pixman_image_set_indexed             (pixman_image_t               *image,
 626                                                       const pixman_indexed_t       *indexed);
 627 uint32_t       *pixman_image_get_data                (pixman_image_t               *image);
 628 int             pixman_image_get_width               (pixman_image_t               *image);
 629 int             pixman_image_get_height              (pixman_image_t               *image);
 630 int             pixman_image_get_stride              (pixman_image_t               *image);
 631 int             pixman_image_get_depth               (pixman_image_t               *image);
 632 pixman_bool_t   pixman_image_fill_rectangles         (pixman_op_t                   op,
 633                                                       pixman_image_t               *image,
 634                                                       pixman_color_t               *color,
 635                                                       int                           n_rects,
 636                                                       const pixman_rectangle16_t   *rects);
 637
 638 /* Composite */
 639 pixman_bool_t pixman_compute_composite_region (pixman_region16_t *pRegion,
 640                                                pixman_image_t    *pSrc,
 641                                                pixman_image_t    *pMask,
 642                                                pixman_image_t    *pDst,
 643                                                int16_t            xSrc,
 644                                                int16_t            ySrc,
 645                                                int16_t            xMask,
 646                                                int16_t            yMask,
 647                                                int16_t            xDst,
 648                                                int16_t            yDst,
 649                                                uint16_t           width,
 650                                                uint16_t           height);
 651 void          pixman_image_composite          (pixman_op_t        op,
 652                                                pixman_image_t    *src,
 653                                                pixman_image_t    *mask,
 654                                                pixman_image_t    *dest,
 655                                                int16_t            src_x,
 656                                                int16_t            src_y,
 657                                                int16_t            mask_x,
 658                                                int16_t            mask_y,
 659                                                int16_t            dest_x,
 660                                                int16_t            dest_y,
 661                                                uint16_t           width,
 662                                                uint16_t           height);
 663
 664 /*
 665  * Trapezoids
 666  */
 667 typedef struct pixman_edge pixman_edge_t;
 668 typedef struct pixman_trapezoid pixman_trapezoid_t;
 669 typedef struct pixman_trap pixman_trap_t;
 670 typedef struct pixman_span_fix pixman_span_fix_t;
 671
 672 /*
 673  * An edge structure.  This represents a single polygon edge
 674  * and can be quickly stepped across small or large gaps in the
 675  * sample grid
 676  */
 677 struct pixman_edge
 678 {
 679     pixman_fixed_t      x;
 680     pixman_fixed_t      e;
 681     pixman_fixed_t   stepx;
 682     pixman_fixed_t   signdx;
 683     pixman_fixed_t   dy;
 684     pixman_fixed_t   dx;
 685
 686     pixman_fixed_t   stepx_small;
 687     pixman_fixed_t   stepx_big;
 688     pixman_fixed_t   dx_small;
 689     pixman_fixed_t   dx_big;
 690 };
 691
 692 struct pixman_trapezoid
 693 {
 694     pixman_fixed_t  top, bottom;
 695     pixman_line_fixed_t left, right;
 696 };
 697
 698
 699 /* whether 't' is a well defined not obviously empty trapezoid */
 700 #define pixman_trapezoid_valid(t)                               \
 701     ((t)->left.p1.y != (t)->left.p2.y &&                           \
 702      (t)->right.p1.y != (t)->right.p2.y &&                         \
 703      (int) ((t)->bottom - (t)->top) > 0)
 704
 705 struct pixman_span_fix
 706 {
 707     pixman_fixed_t      l, r, y;
 708 };
 709
 710 struct pixman_trap
 711 {
 712     pixman_span_fix_t   top, bot;
 713 };
 714
 715 pixman_fixed_t pixman_sample_ceil_y        (pixman_fixed_t             y,
 716                                             int                        bpp);
 717 pixman_fixed_t pixman_sample_floor_y       (pixman_fixed_t             y,
 718                                             int                        bpp);
 719 void           pixman_edge_step            (pixman_edge_t             *e,
 720                                             int                        n);
 721 void           pixman_edge_init            (pixman_edge_t             *e,
 722                                             int                        bpp,
 723                                             pixman_fixed_t             y_start,
 724                                             pixman_fixed_t             x_top,
 725                                             pixman_fixed_t             y_top,
 726                                             pixman_fixed_t             x_bot,
 727                                             pixman_fixed_t             y_bot);
 728 void           pixman_line_fixed_edge_init (pixman_edge_t             *e,
 729                                             int                        bpp,
 730                                             pixman_fixed_t             y,
 731                                             const pixman_line_fixed_t *line,
 732                                             int                        x_off,
 733                                             int                        y_off);
 734 void           pixman_rasterize_edges      (pixman_image_t            *image,
 735                                             pixman_edge_t             *l,
 736                                             pixman_edge_t             *r,
 737                                             pixman_fixed_t             t,
 738                                             pixman_fixed_t             b);
 739 void           pixman_add_traps            (pixman_image_t            *image,
 740                                             int16_t                    x_off,
 741                                             int16_t                    y_off,
 742                                             int                        ntrap,
 743                                             pixman_trap_t             *traps);
 744 void           pixman_add_trapezoids       (pixman_image_t            *image,
 745                                             int16_t                    x_off,
 746                                             int                        y_off,
 747                                             int                        ntraps,
 748                                             const pixman_trapezoid_t  *traps);
 749 void           pixman_rasterize_trapezoid  (pixman_image_t            *image,
 750                                             const pixman_trapezoid_t  *trap,
 751                                             int                        x_off,
 752                                             int                        y_off);
 753
 754
 755 #endif /* PIXMAN_H__ */