pixman/pixman-private.h

   1 #ifndef PACKAGE
   2 #  error config.h must be included before pixman-private.h
   3 #endif
   4
   5 #ifndef PIXMAN_PRIVATE_H
   6 #define PIXMAN_PRIVATE_H
   7
   8 #include "pixman.h"
   9 #include <time.h>
  10 #include <assert.h>
  11
  12 #include "pixman-compiler.h"
  13
  14 /*
  15  * Images
  16  */
  17 typedef struct image_common image_common_t;
  18 typedef struct source_image source_image_t;
  19 typedef struct solid_fill solid_fill_t;
  20 typedef struct gradient gradient_t;
  21 typedef struct linear_gradient linear_gradient_t;
  22 typedef struct horizontal_gradient horizontal_gradient_t;
  23 typedef struct vertical_gradient vertical_gradient_t;
  24 typedef struct conical_gradient conical_gradient_t;
  25 typedef struct radial_gradient radial_gradient_t;
  26 typedef struct bits_image bits_image_t;
  27 typedef struct circle circle_t;
  28
  29 typedef void     (*fetch_scanline_t)  (bits_image_t *pict,
  30                                        int x, int y, int width,
  31                                        uint32_t *buffer);
  32 typedef void     (*fetch_pixels_t)    (bits_image_t *image,
  33                                        uint32_t *buffer, int n_pixels);
  34 typedef void     (*store_scanline_t)  (bits_image_t *image,
  35                                        int x, int y, int width,
  36                                        const uint32_t *values);
  37
  38 typedef void     (*scanFetchProc)     (pixman_image_t *,
  39                                        int, int, int, uint32_t *,
  40                                        uint32_t *, uint32_t);
  41
  42 typedef enum
  43 {
  44     BITS,
  45     LINEAR,
  46     CONICAL,
  47     RADIAL,
  48     SOLID
  49 } image_type_t;
  50
  51 typedef enum
  52 {
  53     SOURCE_IMAGE_CLASS_UNKNOWN,
  54     SOURCE_IMAGE_CLASS_HORIZONTAL,
  55     SOURCE_IMAGE_CLASS_VERTICAL,
  56 } source_pict_class_t;
  57
  58 typedef source_pict_class_t (* classify_func_t) (pixman_image_t *image,
  59                                                  int             x,
  60                                                  int             y,
  61                                                  int             width,
  62                                                  int             height);
  63 typedef void (* property_changed_func_t)        (pixman_image_t *image);
  64
  65 struct image_common
  66 {
  67     image_type_t                type;
  68     int32_t                     ref_count;
  69     pixman_region32_t           clip_region;
  70     pixman_bool_t               have_clip_region;   /* FALSE if there is no clip */
  71     pixman_bool_t               client_clip;        /* Whether the source clip was
  72                                                        set by a client */
  73     pixman_bool_t               clip_sources;       /* Whether the clip applies when
  74                                                      * the image is used as a source
  75                                                      */
  76     pixman_transform_t         *transform;
  77     pixman_repeat_t             repeat;
  78     pixman_filter_t             filter;
  79     pixman_fixed_t             *filter_params;
  80     int                         n_filter_params;
  81     bits_image_t               *alpha_map;
  82     int                         alpha_origin_x;
  83     int                         alpha_origin_y;
  84     pixman_bool_t               component_alpha;
  85     pixman_read_memory_func_t   read_func;
  86     pixman_write_memory_func_t  write_func;
  87     classify_func_t             classify;
  88     property_changed_func_t     property_changed;
  89     scanFetchProc               get_scanline_32;
  90     scanFetchProc               get_scanline_64;
  91
  92     pixman_image_destroy_func_t destroy_func;
  93     void *                      destroy_data;
  94 };
  95
  96 struct source_image
  97 {
  98     image_common_t      common;
  99     source_pict_class_t class;
 100 };
 101
 102 struct solid_fill
 103 {
 104     source_image_t      common;
 105     uint32_t            color;          /* FIXME: shouldn't this be a pixman_color_t? */
 106 };
 107
 108 struct gradient
 109 {
 110     source_image_t              common;
 111     int                         n_stops;
 112     pixman_gradient_stop_t *    stops;
 113     int                         stop_range;
 114     uint32_t *                  color_table;
 115     int                         color_table_size;
 116 };
 117
 118 struct linear_gradient
 119 {
 120     gradient_t                  common;
 121     pixman_point_fixed_t        p1;
 122     pixman_point_fixed_t        p2;
 123 };
 124
 125 struct circle
 126 {
 127     pixman_fixed_t x;
 128     pixman_fixed_t y;
 129     pixman_fixed_t radius;
 130 };
 131
 132 struct radial_gradient
 133 {
 134     gradient_t  common;
 135
 136     circle_t    c1;
 137     circle_t    c2;
 138     double      cdx;
 139     double      cdy;
 140     double      dr;
 141     double      A;
 142 };
 143
 144 struct conical_gradient
 145 {
 146     gradient_t                  common;
 147     pixman_point_fixed_t        center;
 148     pixman_fixed_t              angle;
 149 };
 150
 151 struct bits_image
 152 {
 153     image_common_t              common;
 154     pixman_format_code_t        format;
 155     const pixman_indexed_t     *indexed;
 156     int                         width;
 157     int                         height;
 158     uint32_t *                  bits;
 159     uint32_t *                  free_me;
 160     int                         rowstride; /* in number of uint32_t's */
 161
 162     /* Fetch raw pixels, with no regard for transformations, alpha map etc. */
 163     fetch_pixels_t              fetch_pixels_raw_32;
 164     fetch_pixels_t              fetch_pixels_raw_64;
 165
 166     /* Fetch raw scanlines, with no regard for transformations, alpha maps etc. */
 167     fetch_scanline_t                    fetch_scanline_raw_32;
 168     fetch_scanline_t                    fetch_scanline_raw_64;
 169
 170     /* Store scanlines with no regard for alpha maps */
 171     store_scanline_t            store_scanline_raw_32;
 172     store_scanline_t            store_scanline_raw_64;
 173
 174     /* Store a scanline, taking alpha maps into account */
 175     store_scanline_t            store_scanline_32;
 176     store_scanline_t            store_scanline_64;
 177
 178     /* Used for indirect access to the bits */
 179     pixman_read_memory_func_t   read_func;
 180     pixman_write_memory_func_t  write_func;
 181 };
 182
 183 union pixman_image
 184 {
 185     image_type_t                type;
 186     image_common_t              common;
 187     bits_image_t                bits;
 188     source_image_t              source;
 189     gradient_t                  gradient;
 190     linear_gradient_t           linear;
 191     conical_gradient_t          conical;
 192     radial_gradient_t           radial;
 193     solid_fill_t                solid;
 194 };
 195
 196
 197 void
 198 _pixman_bits_image_setup_raw_accessors (bits_image_t   *image);
 199
 200 void
 201 _pixman_image_get_scanline_64_generic  (pixman_image_t *pict,
 202                                         int             x,
 203                                         int             y,
 204                                         int             width,
 205                                         uint32_t       *buffer,
 206                                         uint32_t       *mask,
 207                                         uint32_t        maskBits);
 208
 209 source_pict_class_t
 210 _pixman_image_classify (pixman_image_t *image,
 211                         int             x,
 212                         int             y,
 213                         int             width,
 214                         int             height);
 215
 216 void
 217 _pixman_image_get_scanline_32 (pixman_image_t *image, int x, int y, int width,
 218                                uint32_t *buffer, uint32_t *mask,
 219                                uint32_t mask_bits);
 220
 221 /* Even thought the type of buffer is uint32_t *, the function actually expects
 222  * a uint64_t *buffer.
 223  */
 224 void
 225 _pixman_image_get_scanline_64 (pixman_image_t *image, int x, int y, int width,
 226                                uint32_t *buffer,
 227                                uint32_t *unused, uint32_t unused2);
 228
 229 void
 230 _pixman_image_store_scanline_32 (bits_image_t *image, int x, int y, int width,
 231                                  const uint32_t *buffer);
 232 void
 233 _pixman_image_fetch_pixels (bits_image_t *image, uint32_t *buffer,
 234                             int n_pixels);
 235
 236 /* Even thought the type of buffer is uint32_t *, the function actually expects
 237  * a uint64_t *buffer.
 238  */
 239 void
 240 _pixman_image_store_scanline_64 (bits_image_t *image, int x, int y, int width,
 241                                  const uint32_t *buffer);
 242
 243 pixman_image_t *
 244 _pixman_image_allocate (void);
 245
 246 pixman_bool_t
 247 _pixman_init_gradient (gradient_t                   *gradient,
 248                        const pixman_gradient_stop_t *stops,
 249                        int                           n_stops);
 250 void
 251 _pixman_image_reset_clip_region (pixman_image_t *image);
 252
 253 pixman_bool_t
 254 _pixman_image_is_opaque(pixman_image_t *image);
 255
 256 pixman_bool_t
 257 _pixman_image_is_solid (pixman_image_t *image);
 258
 259 uint32_t
 260 _pixman_image_get_solid (pixman_image_t *image,
 261                         pixman_format_code_t format);
 262
 263 #define fbComposeGetStart(pict,x,y,type,out_stride,line,mul) do {       \
 264         uint32_t        *__bits__;                                      \
 265         int             __stride__;                                     \
 266                                                                         \
 267         __bits__ = pict->bits.bits;                                     \
 268         __stride__ = pict->bits.rowstride;                              \
 269         (out_stride) = __stride__ * (int) sizeof (uint32_t) / (int) sizeof (type); \
 270         (line) = ((type *) __bits__) +                                  \
 271             (out_stride) * (y) + (mul) * (x);                           \
 272     } while (0)
 273
 274 /*
 275  * Gradient walker
 276  */
 277 typedef struct
 278 {
 279     uint32_t        left_ag;
 280     uint32_t        left_rb;
 281     uint32_t        right_ag;
 282     uint32_t        right_rb;
 283     int32_t       left_x;
 284     int32_t       right_x;
 285     int32_t       stepper;
 286
 287     pixman_gradient_stop_t      *stops;
 288     int                      num_stops;
 289     unsigned int             spread;
 290
 291     int           need_reset;
 292 } pixman_gradient_walker_t;
 293
 294 void
 295 _pixman_gradient_walker_init (pixman_gradient_walker_t  *walker,
 296                               gradient_t      *gradient,
 297                               unsigned int     spread);
 298
 299 void
 300 _pixman_gradient_walker_reset (pixman_gradient_walker_t       *walker,
 301                                pixman_fixed_32_32_t  pos);
 302
 303 uint32_t
 304 _pixman_gradient_walker_pixel (pixman_gradient_walker_t       *walker,
 305                                pixman_fixed_32_32_t  x);
 306
 307 /*
 308  * Edges
 309  */
 310
 311 #define MAX_ALPHA(n)    ((1 << (n)) - 1)
 312 #define N_Y_FRAC(n)     ((n) == 1 ? 1 : (1 << ((n)/2)) - 1)
 313 #define N_X_FRAC(n)     ((n) == 1 ? 1 : (1 << ((n)/2)) + 1)
 314
 315 #define STEP_Y_SMALL(n) (pixman_fixed_1 / N_Y_FRAC(n))
 316 #define STEP_Y_BIG(n)   (pixman_fixed_1 - (N_Y_FRAC(n) - 1) * STEP_Y_SMALL(n))
 317
 318 #define Y_FRAC_FIRST(n) (STEP_Y_SMALL(n) / 2)
 319 #define Y_FRAC_LAST(n)  (Y_FRAC_FIRST(n) + (N_Y_FRAC(n) - 1) * STEP_Y_SMALL(n))
 320
 321 #define STEP_X_SMALL(n) (pixman_fixed_1 / N_X_FRAC(n))
 322 #define STEP_X_BIG(n)   (pixman_fixed_1 - (N_X_FRAC(n) - 1) * STEP_X_SMALL(n))
 323
 324 #define X_FRAC_FIRST(n) (STEP_X_SMALL(n) / 2)
 325 #define X_FRAC_LAST(n)  (X_FRAC_FIRST(n) + (N_X_FRAC(n) - 1) * STEP_X_SMALL(n))
 326
 327 #define RenderSamplesX(x,n)     ((n) == 1 ? 0 : (pixman_fixed_frac (x) + X_FRAC_FIRST(n)) / STEP_X_SMALL(n))
 328
 329 void
 330 pixman_rasterize_edges_accessors (pixman_image_t *image,
 331                                   pixman_edge_t *l,
 332                                   pixman_edge_t *r,
 333                                   pixman_fixed_t        t,
 334                                   pixman_fixed_t        b);
 335
 336 /*
 337  * Implementations
 338  */
 339
 340 typedef struct pixman_implementation_t pixman_implementation_t;
 341
 342 typedef void (* pixman_combine_32_func_t) (pixman_implementation_t *    imp,
 343                                            pixman_op_t                  op,
 344                                            uint32_t *                   dest,
 345                                            const uint32_t *             src,
 346                                            const uint32_t *             mask,
 347                                            int                          width);
 348
 349 typedef void (* pixman_combine_64_func_t) (pixman_implementation_t *    imp,
 350                                            pixman_op_t                  op,
 351                                            uint64_t *                   dest,
 352                                            const uint64_t *             src,
 353                                            const uint64_t *             mask,
 354                                            int                          width);
 355
 356 typedef void (* pixman_composite_func_t)  (pixman_implementation_t *    imp,
 357                                            pixman_op_t                  op,
 358                                            pixman_image_t *             src,
 359                                            pixman_image_t *             mask,
 360                                            pixman_image_t *             dest,
 361                                            int32_t                      src_x,
 362                                            int32_t                      src_y,
 363                                            int32_t                      mask_x,
 364                                            int32_t                      mask_y,
 365                                            int32_t                      dest_x,
 366                                            int32_t                      dest_y,
 367                                            int32_t                      width,
 368                                            int32_t                      height);
 369 typedef pixman_bool_t (* pixman_blt_func_t) (pixman_implementation_t *  imp,
 370                                              uint32_t *                 src_bits,
 371                                              uint32_t *                 dst_bits,
 372                                              int                        src_stride,
 373                                              int                        dst_stride,
 374                                              int                        src_bpp,
 375                                              int                        dst_bpp,
 376                                              int                        src_x,
 377                                              int                        src_y,
 378                                              int                        dst_x,
 379                                              int                        dst_y,
 380                                              int                        width,
 381                                              int                        height);
 382 typedef pixman_bool_t (* pixman_fill_func_t) (pixman_implementation_t *imp,
 383                                               uint32_t *bits,
 384                                               int stride,
 385                                               int bpp,
 386                                               int x,
 387                                               int y,
 388                                               int width,
 389                                               int height,
 390                                               uint32_t xor);
 391
 392 void _pixman_setup_combiner_functions_32 (pixman_implementation_t *imp);
 393 void _pixman_setup_combiner_functions_64 (pixman_implementation_t *imp);
 394
 395 struct pixman_implementation_t
 396 {
 397     pixman_implementation_t *   toplevel;
 398     pixman_implementation_t *   delegate;
 399
 400     pixman_composite_func_t     composite;
 401     pixman_blt_func_t           blt;
 402     pixman_fill_func_t          fill;
 403
 404     pixman_combine_32_func_t    combine_32[PIXMAN_OP_LAST];
 405     pixman_combine_32_func_t    combine_32_ca[PIXMAN_OP_LAST];
 406     pixman_combine_64_func_t    combine_64[PIXMAN_OP_LAST];
 407     pixman_combine_64_func_t    combine_64_ca[PIXMAN_OP_LAST];
 408 };
 409
 410 pixman_implementation_t *
 411 _pixman_implementation_create (pixman_implementation_t *delegate);
 412
 413 void
 414 _pixman_implementation_combine_32 (pixman_implementation_t *    imp,
 415                                    pixman_op_t                  op,
 416                                    uint32_t *                   dest,
 417                                    const uint32_t *             src,
 418                                    const uint32_t *             mask,
 419                                    int                          width);
 420 void
 421 _pixman_implementation_combine_64 (pixman_implementation_t *    imp,
 422                                    pixman_op_t                  op,
 423                                    uint64_t *                   dest,
 424                                    const uint64_t *             src,
 425                                    const uint64_t *             mask,
 426                                    int                          width);
 427 void
 428 _pixman_implementation_combine_32_ca (pixman_implementation_t * imp,
 429                                       pixman_op_t               op,
 430                                       uint32_t *                dest,
 431                                       const uint32_t *          src,
 432                                       const uint32_t *          mask,
 433                                       int                       width);
 434 void
 435 _pixman_implementation_combine_64_ca (pixman_implementation_t * imp,
 436                                       pixman_op_t               op,
 437                                       uint64_t *                dest,
 438                                       const uint64_t *          src,
 439                                       const uint64_t *          mask,
 440                                       int                       width);
 441 void
 442 _pixman_implementation_composite (pixman_implementation_t *     imp,
 443                                   pixman_op_t                   op,
 444                                   pixman_image_t *              src,
 445                                   pixman_image_t *              mask,
 446                                   pixman_image_t *              dest,
 447                                   int32_t                       src_x,
 448                                   int32_t                       src_y,
 449                                   int32_t                       mask_x,
 450                                   int32_t                       mask_y,
 451                                   int32_t                       dest_x,
 452                                   int32_t                       dest_y,
 453                                   int32_t                       width,
 454                                   int32_t                       height);
 455
 456 pixman_bool_t
 457 _pixman_implementation_blt (pixman_implementation_t *   imp,
 458                             uint32_t *                  src_bits,
 459                             uint32_t *                  dst_bits,
 460                             int                         src_stride,
 461                             int                         dst_stride,
 462                             int                         src_bpp,
 463                             int                         dst_bpp,
 464                             int                         src_x,
 465                             int                         src_y,
 466                             int                         dst_x,
 467                             int                         dst_y,
 468                             int                         width,
 469                             int                         height);
 470 pixman_bool_t
 471 _pixman_implementation_fill (pixman_implementation_t *   imp,
 472                              uint32_t *bits,
 473                              int stride,
 474                              int bpp,
 475                              int x,
 476                              int y,
 477                              int width,
 478                              int height,
 479                              uint32_t xor);
 480
 481 /* Specific implementations */
 482 pixman_implementation_t *
 483 _pixman_implementation_create_general (void);
 484 pixman_implementation_t *
 485 _pixman_implementation_create_fast_path (void);
 486 #ifdef USE_MMX
 487 pixman_implementation_t *
 488 _pixman_implementation_create_mmx (void);
 489 #endif
 490 #ifdef USE_SSE2
 491 pixman_implementation_t *
 492 _pixman_implementation_create_sse2 (void);
 493 #endif
 494 #ifdef USE_ARM_SIMD
 495 pixman_implementation_t *
 496 _pixman_implementation_create_arm_simd (void);
 497 #endif
 498 #ifdef USE_ARM_NEON
 499 pixman_implementation_t *
 500 _pixman_implementation_create_arm_neon (void);
 501 #endif
 502 #ifdef USE_VMX
 503 pixman_implementation_t *
 504 _pixman_implementation_create_vmx (void);
 505 #endif
 506
 507 pixman_implementation_t *
 508 _pixman_choose_implementation (void);
 509
 510
 511
 512 /*
 513  * Utilities
 514  */
 515
 516 /* These "formats" both have depth 0, so they
 517  * will never clash with any real ones
 518  */
 519 #define PIXMAN_null             PIXMAN_FORMAT(0,0,0,0,0,0)
 520 #define PIXMAN_solid            PIXMAN_FORMAT(0,1,0,0,0,0)
 521
 522 #define NEED_COMPONENT_ALPHA            (1 << 0)
 523 #define NEED_PIXBUF                     (1 << 1)
 524 #define NEED_SOLID_MASK                 (1 << 2)
 525
 526 typedef struct
 527 {
 528     pixman_op_t                 op;
 529     pixman_format_code_t        src_format;
 530     pixman_format_code_t        mask_format;
 531     pixman_format_code_t        dest_format;
 532     pixman_composite_func_t     func;
 533     uint32_t                    flags;
 534 } pixman_fast_path_t;
 535
 536 /* Memory allocation helpers */
 537 void *
 538 pixman_malloc_ab (unsigned int n, unsigned int b);
 539
 540 void *
 541 pixman_malloc_abc (unsigned int a, unsigned int b, unsigned int c);
 542
 543 pixman_bool_t
 544 pixman_multiply_overflows_int (unsigned int a, unsigned int b);
 545
 546 pixman_bool_t
 547 pixman_addition_overflows_int (unsigned int a, unsigned int b);
 548
 549 /* Compositing utilities */
 550 pixman_bool_t
 551 _pixman_run_fast_path (const pixman_fast_path_t *paths,
 552                        pixman_implementation_t *imp,
 553                        pixman_op_t op,
 554                        pixman_image_t *src,
 555                        pixman_image_t *mask,
 556                        pixman_image_t *dest,
 557                        int32_t src_x,
 558                        int32_t src_y,
 559                        int32_t mask_x,
 560                        int32_t mask_y,
 561                        int32_t dest_x,
 562                        int32_t dest_y,
 563                        int32_t width,
 564                        int32_t height);
 565
 566 void
 567 _pixman_walk_composite_region (pixman_implementation_t *imp,
 568                                pixman_op_t op,
 569                                pixman_image_t * pSrc,
 570                                pixman_image_t * pMask,
 571                                pixman_image_t * pDst,
 572                                int16_t xSrc,
 573                                int16_t ySrc,
 574                                int16_t xMask,
 575                                int16_t yMask,
 576                                int16_t xDst,
 577                                int16_t yDst,
 578                                uint16_t width,
 579                                uint16_t height,
 580                                pixman_composite_func_t compositeRect);
 581
 582 void
 583 pixman_expand (uint64_t *dst, const uint32_t *src, pixman_format_code_t, int width);
 584
 585 void
 586 pixman_contract (uint32_t *dst, const uint64_t *src, int width);
 587
 588
 589 /* Region Helpers */
 590 pixman_bool_t
 591 pixman_region32_copy_from_region16 (pixman_region32_t *dst,
 592                                     pixman_region16_t *src);
 593
 594 pixman_bool_t
 595 pixman_region16_copy_from_region32 (pixman_region16_t *dst,
 596                                     pixman_region32_t *src);
 597
 598
 599 /* Misc macros */
 600
 601 #ifndef FALSE
 602 #   define FALSE 0
 603 #endif
 604
 605 #ifndef TRUE
 606 #   define TRUE 1
 607 #endif
 608
 609 #ifndef MIN
 610 #  define MIN(a,b) ((a < b)? a : b)
 611 #endif
 612
 613 #ifndef MAX
 614 #  define MAX(a,b) ((a > b)? a : b)
 615 #endif
 616
 617 /* Integer division that rounds towards -infinity */
 618 #define DIV(a,b) ((((a) < 0) == ((b) < 0)) ? (a) / (b) :                \
 619                   ((a) - (b) + 1 - (((b) < 0) << 1)) / (b))
 620
 621 /* Modulus that produces the remainder wrt. DIV */
 622 #define MOD(a,b) ((a) < 0 ? ((b) - ((-(a) - 1) % (b))) - 1 : (a) % (b))
 623
 624 #define CLIP(v,low,high) ((v) < (low) ? (low) : ((v) > (high) ? (high) : (v)))
 625
 626 /* Conversion between 8888 and 0565 */
 627
 628 #define cvt8888to0565(s)    ((((s) >> 3) & 0x001f) | \
 629                              (((s) >> 5) & 0x07e0) | \
 630                              (((s) >> 8) & 0xf800))
 631 #define cvt0565to0888(s)    (((((s) << 3) & 0xf8) | (((s) >> 2) & 0x7)) | \
 632                              ((((s) << 5) & 0xfc00) | (((s) >> 1) & 0x300)) | \
 633                              ((((s) << 8) & 0xf80000) | (((s) << 3) & 0x70000)))
 634
 635 #define PIXMAN_FORMAT_IS_WIDE(f)        (PIXMAN_FORMAT_A(f) > 8 || \
 636                                          PIXMAN_FORMAT_R(f) > 8 || \
 637                                          PIXMAN_FORMAT_G(f) > 8 || \
 638                                          PIXMAN_FORMAT_B(f) > 8)
 639
 640 /*
 641  * Various debugging code
 642  */
 643
 644 #undef DEBUG
 645 #define DEBUG 0
 646
 647 #if DEBUG
 648
 649 #define return_if_fail(expr)                                            \
 650     do                                                                  \
 651     {                                                                   \
 652         if (!(expr))                                                    \
 653         {                                                               \
 654             fprintf(stderr, "In %s: %s failed\n", FUNC, #expr);         \
 655             return;                                                     \
 656         }                                                               \
 657     }                                                                   \
 658     while (0)
 659
 660 #define return_val_if_fail(expr, retval)                                \
 661     do                                                                  \
 662     {                                                                   \
 663         if (!(expr))                                                    \
 664         {                                                               \
 665             fprintf(stderr, "In %s: %s failed\n", FUNC, #expr);         \
 666             return (retval);                                            \
 667         }                                                               \
 668     }                                                                   \
 669     while (0)
 670
 671 #else
 672
 673 #define return_if_fail(expr)                                            \
 674     do                                                                  \
 675     {                                                                   \
 676         if (!(expr))                                                    \
 677             return;                                                     \
 678     }                                                                   \
 679     while (0)
 680
 681 #define return_val_if_fail(expr, retval)                                \
 682     do                                                                  \
 683     {                                                                   \
 684         if (!(expr))                                                    \
 685             return (retval);                                            \
 686     }                                                                   \
 687     while (0)
 688
 689 #endif
 690
 691 /*
 692  * Timers
 693  */
 694
 695 #ifdef PIXMAN_TIMERS
 696
 697 static inline uint64_t
 698 oil_profile_stamp_rdtsc (void)
 699 {
 700     uint64_t ts;
 701     __asm__ __volatile__("rdtsc\n" : "=A" (ts));
 702     return ts;
 703 }
 704 #define OIL_STAMP oil_profile_stamp_rdtsc
 705
 706 typedef struct pixman_timer_t pixman_timer_t;
 707
 708 struct pixman_timer_t
 709 {
 710     int initialized;
 711     const char *name;
 712     uint64_t n_times;
 713     uint64_t total;
 714     pixman_timer_t *next;
 715 };
 716
 717 extern int timer_defined;
 718 void pixman_timer_register (pixman_timer_t *timer);
 719
 720 #define TIMER_BEGIN(tname)                                              \
 721     {                                                                   \
 722         static pixman_timer_t   timer##tname;                           \
 723         uint64_t                begin##tname;                           \
 724                                                                         \
 725         if (!timer##tname.initialized)                                  \
 726         {                                                               \
 727             timer##tname.initialized = 1;                               \
 728             timer##tname.name = #tname;                                 \
 729             pixman_timer_register (&timer##tname);                      \
 730         }                                                               \
 731                                                                         \
 732         timer##tname.n_times++;                                         \
 733         begin##tname = OIL_STAMP();
 734
 735 #define TIMER_END(tname)                                                \
 736         timer##tname.total += OIL_STAMP() - begin##tname;               \
 737     }
 738
 739 #endif /* PIXMAN_TIMERS */
 740
 741 #endif /* PIXMAN_PRIVATE_H */