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