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