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