1 /* -*- Mode: c; c-basic-offset: 4; tab-width: 8; indent-tabs-mode: t; -*- */
3 * Copyright © 2000 SuSE, Inc.
4 * Copyright © 2007 Red Hat, Inc.
6 * Permission to use, copy, modify, distribute, and sell this software and its
7 * documentation for any purpose is hereby granted without fee, provided that
8 * the above copyright notice appear in all copies and that both that
9 * copyright notice and this permission notice appear in supporting
10 * documentation, and that the name of SuSE not be used in advertising or
11 * publicity pertaining to distribution of the software without specific,
12 * written prior permission. SuSE makes no representations about the
13 * suitability of this software for any purpose. It is provided "as is"
14 * without express or implied warranty.
16 * SuSE DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL
17 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL SuSE
18 * BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
19 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
20 * OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
21 * CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
23 * Author: Keith Packard, SuSE, Inc.
29 #include "pixman-private.h"
34 * Operator optimizations based on source or destination opacity
39 pixman_op_t op_src_dst_opaque;
40 pixman_op_t op_src_opaque;
41 pixman_op_t op_dst_opaque;
42 } optimized_operator_info_t;
44 static const optimized_operator_info_t optimized_operators[] =
46 /* Input Operator SRC&DST Opaque SRC Opaque DST Opaque */
47 { PIXMAN_OP_OVER, PIXMAN_OP_SRC, PIXMAN_OP_SRC, PIXMAN_OP_OVER },
48 { PIXMAN_OP_OVER_REVERSE, PIXMAN_OP_DST, PIXMAN_OP_OVER_REVERSE, PIXMAN_OP_DST },
49 { PIXMAN_OP_IN, PIXMAN_OP_SRC, PIXMAN_OP_IN, PIXMAN_OP_SRC },
50 { PIXMAN_OP_IN_REVERSE, PIXMAN_OP_DST, PIXMAN_OP_DST, PIXMAN_OP_IN_REVERSE },
51 { PIXMAN_OP_OUT, PIXMAN_OP_CLEAR, PIXMAN_OP_OUT, PIXMAN_OP_CLEAR },
52 { PIXMAN_OP_OUT_REVERSE, PIXMAN_OP_CLEAR, PIXMAN_OP_CLEAR, PIXMAN_OP_OUT_REVERSE },
53 { PIXMAN_OP_ATOP, PIXMAN_OP_SRC, PIXMAN_OP_IN, PIXMAN_OP_OVER },
54 { PIXMAN_OP_ATOP_REVERSE, PIXMAN_OP_DST, PIXMAN_OP_OVER_REVERSE, PIXMAN_OP_IN_REVERSE },
55 { PIXMAN_OP_XOR, PIXMAN_OP_CLEAR, PIXMAN_OP_OUT, PIXMAN_OP_OUT_REVERSE },
56 { PIXMAN_OP_SATURATE, PIXMAN_OP_DST, PIXMAN_OP_OVER_REVERSE, PIXMAN_OP_DST },
60 static pixman_implementation_t *imp;
63 * Check if the current operator could be optimized
65 static const optimized_operator_info_t*
66 pixman_operator_can_be_optimized (pixman_op_t op)
68 const optimized_operator_info_t *info;
70 for (info = optimized_operators; info->op != PIXMAN_OP_NONE; info++)
79 * Optimize the current operator based on opacity of source or destination
80 * The output operator should be mathematically equivalent to the source.
83 pixman_optimize_operator (pixman_op_t op,
84 pixman_image_t *src_image,
85 pixman_image_t *mask_image,
86 pixman_image_t *dst_image)
88 pixman_bool_t is_source_opaque;
89 pixman_bool_t is_dest_opaque;
90 const optimized_operator_info_t *info = pixman_operator_can_be_optimized (op);
92 if (!info || mask_image)
95 is_source_opaque = _pixman_image_is_opaque (src_image);
96 is_dest_opaque = _pixman_image_is_opaque (dst_image);
98 if (is_source_opaque == FALSE && is_dest_opaque == FALSE)
101 if (is_source_opaque && is_dest_opaque)
102 return info->op_src_dst_opaque;
103 else if (is_source_opaque)
104 return info->op_src_opaque;
105 else if (is_dest_opaque)
106 return info->op_dst_opaque;
113 apply_workaround (pixman_image_t *image,
116 uint32_t ** save_bits,
120 if (image && image->common.need_workaround)
122 /* Some X servers generate images that point to the
123 * wrong place in memory, but then set the clip region
124 * to point to the right place. Because of an old bug
125 * in pixman, this would actually work.
127 * Here we try and undo the damage
129 int bpp = PIXMAN_FORMAT_BPP (image->bits.format) / 8;
130 pixman_box32_t *extents;
134 extents = pixman_region32_extents (&(image->common.clip_region));
138 *save_bits = image->bits.bits;
142 pixman_region32_translate (&(image->common.clip_region), -dx, -dy);
144 t = (uint8_t *)image->bits.bits;
145 t += dy * image->bits.rowstride * 4 + dx * bpp;
146 image->bits.bits = (uint32_t *)t;
154 unapply_workaround (pixman_image_t *image, uint32_t *bits, int dx, int dy)
156 if (image && image->common.need_workaround)
158 image->bits.bits = bits;
159 pixman_region32_translate (&image->common.clip_region, dx, dy);
164 * Computing composite region
166 static inline pixman_bool_t
167 clip_general_image (pixman_region32_t * region,
168 pixman_region32_t * clip,
172 if (pixman_region32_n_rects (region) == 1 &&
173 pixman_region32_n_rects (clip) == 1)
175 pixman_box32_t * rbox = pixman_region32_rectangles (region, NULL);
176 pixman_box32_t * cbox = pixman_region32_rectangles (clip, NULL);
179 if (rbox->x1 < (v = cbox->x1 + dx))
181 if (rbox->x2 > (v = cbox->x2 + dx))
183 if (rbox->y1 < (v = cbox->y1 + dy))
185 if (rbox->y2 > (v = cbox->y2 + dy))
187 if (rbox->x1 >= rbox->x2 || rbox->y1 >= rbox->y2)
189 pixman_region32_init (region);
193 else if (!pixman_region32_not_empty (clip))
200 pixman_region32_translate (region, -dx, -dy);
202 if (!pixman_region32_intersect (region, region, clip))
206 pixman_region32_translate (region, dx, dy);
209 return pixman_region32_not_empty (region);
212 static inline pixman_bool_t
213 clip_source_image (pixman_region32_t * region,
214 pixman_image_t * image,
218 /* Source clips are ignored, unless they are explicitly turned on
219 * and the clip in question was set by an X client. (Because if
220 * the clip was not set by a client, then it is a hierarchy
221 * clip and those should always be ignored for sources).
223 if (!image->common.clip_sources || !image->common.client_clip)
226 return clip_general_image (region,
227 &image->common.clip_region,
232 * returns FALSE if the final region is empty. Indistinguishable from
233 * an allocation failure, but rendering ignores those anyways.
236 pixman_compute_composite_region32 (pixman_region32_t * region,
237 pixman_image_t * src_image,
238 pixman_image_t * mask_image,
239 pixman_image_t * dst_image,
249 region->extents.x1 = dest_x;
250 region->extents.x2 = dest_x + width;
251 region->extents.y1 = dest_y;
252 region->extents.y2 = dest_y + height;
254 region->extents.x1 = MAX (region->extents.x1, 0);
255 region->extents.y1 = MAX (region->extents.y1, 0);
256 region->extents.x2 = MIN (region->extents.x2, dst_image->bits.width);
257 region->extents.y2 = MIN (region->extents.y2, dst_image->bits.height);
261 /* Check for empty operation */
262 if (region->extents.x1 >= region->extents.x2 ||
263 region->extents.y1 >= region->extents.y2)
265 pixman_region32_init (region);
269 if (dst_image->common.have_clip_region)
271 if (!clip_general_image (region, &dst_image->common.clip_region, 0, 0))
273 pixman_region32_fini (region);
278 if (dst_image->common.alpha_map && dst_image->common.alpha_map->common.have_clip_region)
280 if (!clip_general_image (region, &dst_image->common.alpha_map->common.clip_region,
281 -dst_image->common.alpha_origin_x,
282 -dst_image->common.alpha_origin_y))
284 pixman_region32_fini (region);
289 /* clip against src */
290 if (src_image->common.have_clip_region)
292 if (!clip_source_image (region, src_image, dest_x - src_x, dest_y - src_y))
294 pixman_region32_fini (region);
298 if (src_image->common.alpha_map && src_image->common.alpha_map->common.have_clip_region)
300 if (!clip_source_image (region, (pixman_image_t *)src_image->common.alpha_map,
301 dest_x - (src_x - src_image->common.alpha_origin_x),
302 dest_y - (src_y - src_image->common.alpha_origin_y)))
304 pixman_region32_fini (region);
308 /* clip against mask */
309 if (mask_image && mask_image->common.have_clip_region)
311 if (!clip_source_image (region, mask_image, dest_x - mask_x, dest_y - mask_y))
313 pixman_region32_fini (region);
316 if (mask_image->common.alpha_map && mask_image->common.alpha_map->common.have_clip_region)
318 if (!clip_source_image (region, (pixman_image_t *)mask_image->common.alpha_map,
319 dest_x - (mask_x - mask_image->common.alpha_origin_x),
320 dest_y - (mask_y - mask_image->common.alpha_origin_y)))
322 pixman_region32_fini (region);
332 walk_region_internal (pixman_implementation_t *imp,
334 pixman_image_t * src_image,
335 pixman_image_t * mask_image,
336 pixman_image_t * dst_image,
345 pixman_bool_t src_repeat,
346 pixman_bool_t mask_repeat,
347 pixman_region32_t * region,
348 pixman_composite_func_t composite_rect)
351 const pixman_box32_t *pbox;
352 int w, h, w_this, h_this;
353 int x_msk, y_msk, x_src, y_src, x_dst, y_dst;
355 pbox = pixman_region32_rectangles (region, &n);
358 h = pbox->y2 - pbox->y1;
359 y_src = pbox->y1 - dest_y + src_y;
360 y_msk = pbox->y1 - dest_y + mask_y;
366 w = pbox->x2 - pbox->x1;
367 x_src = pbox->x1 - dest_x + src_x;
368 x_msk = pbox->x1 - dest_x + mask_x;
373 y_msk = MOD (y_msk, mask_image->bits.height);
374 if (h_this > mask_image->bits.height - y_msk)
375 h_this = mask_image->bits.height - y_msk;
380 y_src = MOD (y_src, src_image->bits.height);
381 if (h_this > src_image->bits.height - y_src)
382 h_this = src_image->bits.height - y_src;
391 x_msk = MOD (x_msk, mask_image->bits.width);
392 if (w_this > mask_image->bits.width - x_msk)
393 w_this = mask_image->bits.width - x_msk;
398 x_src = MOD (x_src, src_image->bits.width);
399 if (w_this > src_image->bits.width - x_src)
400 w_this = src_image->bits.width - x_src;
403 (*composite_rect) (imp, op,
404 src_image, mask_image, dst_image,
405 x_src, y_src, x_msk, y_msk, x_dst, y_dst,
425 get_image_info (pixman_image_t *image,
426 pixman_format_code_t *code,
437 if (!image->common.transform)
439 *flags |= FAST_PATH_ID_TRANSFORM;
443 if (image->common.transform->matrix[0][1] == 0 &&
444 image->common.transform->matrix[1][0] == 0 &&
445 image->common.transform->matrix[2][0] == 0 &&
446 image->common.transform->matrix[2][1] == 0 &&
447 image->common.transform->matrix[2][2] == pixman_fixed_1)
449 *flags |= FAST_PATH_SCALE_TRANSFORM;
453 if (!image->common.alpha_map)
454 *flags |= FAST_PATH_NO_ALPHA_MAP;
456 if (image->common.filter != PIXMAN_FILTER_CONVOLUTION)
458 *flags |= FAST_PATH_NO_CONVOLUTION_FILTER;
460 if (image->common.filter == PIXMAN_FILTER_NEAREST)
461 *flags |= FAST_PATH_NEAREST_FILTER;
464 if (image->common.repeat != PIXMAN_REPEAT_PAD)
465 *flags |= FAST_PATH_NO_PAD_REPEAT;
467 if (image->common.repeat != PIXMAN_REPEAT_REFLECT)
468 *flags |= FAST_PATH_NO_REFLECT_REPEAT;
470 *flags |= (FAST_PATH_NO_ACCESSORS | FAST_PATH_NO_WIDE_FORMAT);
471 if (image->type == BITS)
473 if (image->bits.read_func || image->bits.write_func)
474 *flags &= ~FAST_PATH_NO_ACCESSORS;
476 if (PIXMAN_FORMAT_IS_WIDE (image->bits.format))
477 *flags &= ~FAST_PATH_NO_WIDE_FORMAT;
480 if (image->common.component_alpha)
481 *flags |= FAST_PATH_COMPONENT_ALPHA;
483 *flags |= FAST_PATH_UNIFIED_ALPHA;
485 if (_pixman_image_is_solid (image))
486 *code = PIXMAN_solid;
487 else if (image->common.type == BITS)
488 *code = image->bits.format;
490 *code = PIXMAN_unknown;
494 static force_inline pixman_bool_t
495 image_covers (pixman_image_t *image,
496 pixman_box32_t *extents,
500 if (image->common.type == BITS &&
501 image->common.repeat == PIXMAN_REPEAT_NONE)
503 if (x > extents->x1 || y > extents->y1 ||
504 x + image->bits.width < extents->x2 ||
505 y + image->bits.height < extents->y2)
515 do_composite (pixman_implementation_t *imp,
518 pixman_image_t *mask,
519 pixman_image_t *dest,
532 pixman_format_code_t src_format, mask_format, dest_format;
533 uint32_t src_flags, mask_flags, dest_flags;
534 pixman_composite_func_t func;
535 const pixman_fast_path_t *info;
536 pixman_bool_t result;
537 pixman_region32_t region;
538 pixman_box32_t *extents;
540 get_image_info (src, &src_format, &src_flags);
541 get_image_info (mask, &mask_format, &mask_flags);
542 get_image_info (dest, &dest_format, &dest_flags);
544 /* Check for pixbufs */
545 if ((mask_format == PIXMAN_a8r8g8b8 || mask_format == PIXMAN_a8b8g8r8) &&
546 (src->type == BITS && src->bits.bits == mask->bits.bits) &&
547 (src->common.repeat == mask->common.repeat) &&
548 (src_x == mask_x && src_y == mask_y))
550 if (src_format == PIXMAN_x8b8g8r8)
551 src_format = mask_format = PIXMAN_pixbuf;
552 else if (src_format == PIXMAN_x8r8g8b8)
553 src_format = mask_format = PIXMAN_rpixbuf;
556 pixman_region32_init (®ion);
558 if (!pixman_compute_composite_region32 (
559 ®ion, src, mask, dest,
560 src_x, src_y, mask_x, mask_y, dest_x, dest_y, width, height))
567 extents = pixman_region32_extents (®ion);
569 if (image_covers (src, extents, dest_x - src_x, dest_y - src_y))
570 src_flags |= FAST_PATH_COVERS_CLIP;
572 if (mask && image_covers (mask, extents, dest_x - mask_x, dest_y - mask_y))
573 mask_flags |= FAST_PATH_COVERS_CLIP;
576 for (info = imp->fast_paths; info->op != PIXMAN_OP_NONE; ++info)
578 if ((info->op == op || info->op == PIXMAN_OP_any) &&
580 ((info->src_format == src_format) ||
581 (info->src_format == PIXMAN_any)) &&
582 (info->src_flags & src_flags) == info->src_flags &&
584 ((info->mask_format == mask_format) ||
585 (info->mask_format == PIXMAN_any)) &&
586 (info->mask_flags & mask_flags) == info->mask_flags &&
588 ((info->dest_format == dest_format) ||
589 (info->dest_format == PIXMAN_any)) &&
590 (info->dest_flags & dest_flags) == info->dest_flags)
599 pixman_bool_t src_repeat, mask_repeat;
603 src_flags & FAST_PATH_ID_TRANSFORM &&
604 src->common.repeat == PIXMAN_REPEAT_NORMAL &&
605 src_format != PIXMAN_solid;
609 mask->type == BITS &&
610 mask_flags & FAST_PATH_ID_TRANSFORM &&
611 mask->common.repeat == PIXMAN_REPEAT_NORMAL &&
612 mask_format != PIXMAN_solid;
614 walk_region_internal (imp, op,
616 src_x, src_y, mask_x, mask_y,
619 src_repeat, mask_repeat,
626 pixman_region32_fini (®ion);
636 * Work around GCC bug causing crashes in Mozilla with SSE2
638 * When using -msse, gcc generates movdqa instructions assuming that
639 * the stack is 16 byte aligned. Unfortunately some applications, such
640 * as Mozilla and Mono, end up aligning the stack to 4 bytes, which
641 * causes the movdqa instructions to fail.
643 * The __force_align_arg_pointer__ makes gcc generate a prologue that
644 * realigns the stack pointer to 16 bytes.
646 * On x86-64 this is not necessary because the standard ABI already
647 * calls for a 16 byte aligned stack.
649 * See https://bugs.freedesktop.org/show_bug.cgi?id=15693
651 #if defined (USE_SSE2) && defined(__GNUC__) && !defined(__x86_64__) && !defined(__amd64__)
652 __attribute__((__force_align_arg_pointer__))
655 pixman_image_composite (pixman_op_t op,
656 pixman_image_t * src,
657 pixman_image_t * mask,
658 pixman_image_t * dest,
668 pixman_image_composite32 (op, src, mask, dest, src_x, src_y,
669 mask_x, mask_y, dest_x, dest_y, width, height);
673 pixman_image_composite32 (pixman_op_t op,
674 pixman_image_t * src,
675 pixman_image_t * mask,
676 pixman_image_t * dest,
689 int mask_dx, mask_dy;
691 int dest_dx, dest_dy;
692 pixman_bool_t need_workaround;
694 _pixman_image_validate (src);
696 _pixman_image_validate (mask);
697 _pixman_image_validate (dest);
700 * Check if we can replace our operator by a simpler one
701 * if the src or dest are opaque. The output operator should be
702 * mathematically equivalent to the source.
704 op = pixman_optimize_operator(op, src, mask, dest);
705 if (op == PIXMAN_OP_DST ||
706 op == PIXMAN_OP_CONJOINT_DST ||
707 op == PIXMAN_OP_DISJOINT_DST)
713 imp = _pixman_choose_implementation ();
716 (src->common.need_workaround) ||
717 (mask && mask->common.need_workaround) ||
718 (dest->common.need_workaround);
722 apply_workaround (src, &src_x, &src_y, &src_bits, &src_dx, &src_dy);
723 apply_workaround (mask, &mask_x, &mask_y, &mask_bits, &mask_dx, &mask_dy);
724 apply_workaround (dest, &dest_x, &dest_y, &dest_bits, &dest_dx, &dest_dy);
727 do_composite (imp, op,
736 if (src->common.need_workaround)
737 unapply_workaround (src, src_bits, src_dx, src_dy);
738 if (mask && mask->common.need_workaround)
739 unapply_workaround (mask, mask_bits, mask_dx, mask_dy);
740 if (dest->common.need_workaround)
741 unapply_workaround (dest, dest_bits, dest_dx, dest_dy);
745 PIXMAN_EXPORT pixman_bool_t
746 pixman_blt (uint32_t *src_bits,
760 imp = _pixman_choose_implementation ();
762 return _pixman_implementation_blt (imp, src_bits, dst_bits, src_stride, dst_stride,
769 PIXMAN_EXPORT pixman_bool_t
770 pixman_fill (uint32_t *bits,
780 imp = _pixman_choose_implementation ();
782 return _pixman_implementation_fill (imp, bits, stride, bpp, x, y, width, height, xor);
786 color_to_uint32 (const pixman_color_t *color)
789 (color->alpha >> 8 << 24) |
790 (color->red >> 8 << 16) |
791 (color->green & 0xff00) |
796 color_to_pixel (pixman_color_t * color,
798 pixman_format_code_t format)
800 uint32_t c = color_to_uint32 (color);
802 if (!(format == PIXMAN_a8r8g8b8 ||
803 format == PIXMAN_x8r8g8b8 ||
804 format == PIXMAN_a8b8g8r8 ||
805 format == PIXMAN_x8b8g8r8 ||
806 format == PIXMAN_b8g8r8a8 ||
807 format == PIXMAN_b8g8r8x8 ||
808 format == PIXMAN_r5g6b5 ||
809 format == PIXMAN_b5g6r5 ||
810 format == PIXMAN_a8))
815 if (PIXMAN_FORMAT_TYPE (format) == PIXMAN_TYPE_ABGR)
817 c = ((c & 0xff000000) >> 0) |
818 ((c & 0x00ff0000) >> 16) |
819 ((c & 0x0000ff00) >> 0) |
820 ((c & 0x000000ff) << 16);
822 if (PIXMAN_FORMAT_TYPE (format) == PIXMAN_TYPE_BGRA)
824 c = ((c & 0xff000000) >> 24) |
825 ((c & 0x00ff0000) >> 8) |
826 ((c & 0x0000ff00) << 8) |
827 ((c & 0x000000ff) << 24);
830 if (format == PIXMAN_a8)
832 else if (format == PIXMAN_r5g6b5 ||
833 format == PIXMAN_b5g6r5)
834 c = CONVERT_8888_TO_0565 (c);
837 printf ("color: %x %x %x %x\n", color->alpha, color->red, color->green, color->blue);
838 printf ("pixel: %x\n", c);
845 PIXMAN_EXPORT pixman_bool_t
846 pixman_image_fill_rectangles (pixman_op_t op,
847 pixman_image_t * dest,
848 pixman_color_t * color,
850 const pixman_rectangle16_t *rects)
852 pixman_box32_t stack_boxes[6];
853 pixman_box32_t *boxes;
854 pixman_bool_t result;
859 boxes = pixman_malloc_ab (sizeof (pixman_box32_t), n_rects);
868 for (i = 0; i < n_rects; ++i)
870 boxes[i].x1 = rects[i].x;
871 boxes[i].y1 = rects[i].y;
872 boxes[i].x2 = boxes[i].x1 + rects[i].width;
873 boxes[i].y2 = boxes[i].y1 + rects[i].height;
876 result = pixman_image_fill_boxes (op, dest, color, n_rects, boxes);
878 if (boxes != stack_boxes)
884 PIXMAN_EXPORT pixman_bool_t
885 pixman_image_fill_boxes (pixman_op_t op,
886 pixman_image_t * dest,
887 pixman_color_t * color,
889 const pixman_box32_t *boxes)
891 pixman_image_t *solid;
895 _pixman_image_validate (dest);
897 if (color->alpha == 0xffff)
899 if (op == PIXMAN_OP_OVER)
903 if (op == PIXMAN_OP_CLEAR)
915 if (op == PIXMAN_OP_SRC)
919 if (color_to_pixel (color, &pixel, dest->bits.format))
921 pixman_region32_t fill_region;
923 pixman_box32_t *rects;
925 if (!pixman_region32_init_rects (&fill_region, boxes, n_boxes))
928 if (dest->common.have_clip_region)
930 if (!pixman_region32_intersect (&fill_region,
932 &dest->common.clip_region))
936 rects = pixman_region32_rectangles (&fill_region, &n_rects);
937 for (j = 0; j < n_rects; ++j)
939 const pixman_box32_t *rect = &(rects[j]);
940 pixman_fill (dest->bits.bits, dest->bits.rowstride, PIXMAN_FORMAT_BPP (dest->bits.format),
941 rect->x1, rect->y1, rect->x2 - rect->x1, rect->y2 - rect->y1,
945 pixman_region32_fini (&fill_region);
950 solid = pixman_image_create_solid_fill (color);
954 for (i = 0; i < n_boxes; ++i)
956 const pixman_box32_t *box = &(boxes[i]);
958 pixman_image_composite32 (op, solid, NULL, dest,
961 box->x2 - box->x1, box->y2 - box->y1);
964 pixman_image_unref (solid);
972 * Returns the version of the pixman library encoded in a single
973 * integer as per %PIXMAN_VERSION_ENCODE. The encoding ensures that
974 * later versions compare greater than earlier versions.
976 * A run-time comparison to check that pixman's version is greater than
977 * or equal to version X.Y.Z could be performed as follows:
979 * <informalexample><programlisting>
980 * if (pixman_version() >= PIXMAN_VERSION_ENCODE(X,Y,Z)) {...}
981 * </programlisting></informalexample>
983 * See also pixman_version_string() as well as the compile-time
984 * equivalents %PIXMAN_VERSION and %PIXMAN_VERSION_STRING.
986 * Return value: the encoded version.
989 pixman_version (void)
991 return PIXMAN_VERSION;
995 * pixman_version_string:
997 * Returns the version of the pixman library as a human-readable string
998 * of the form "X.Y.Z".
1000 * See also pixman_version() as well as the compile-time equivalents
1001 * %PIXMAN_VERSION_STRING and %PIXMAN_VERSION.
1003 * Return value: a string containing the version.
1005 PIXMAN_EXPORT const char*
1006 pixman_version_string (void)
1008 return PIXMAN_VERSION_STRING;
1012 * pixman_format_supported_source:
1013 * @format: A pixman_format_code_t format
1015 * Return value: whether the provided format code is a supported
1016 * format for a pixman surface used as a source in
1019 * Currently, all pixman_format_code_t values are supported.
1021 PIXMAN_EXPORT pixman_bool_t
1022 pixman_format_supported_source (pixman_format_code_t format)
1026 /* 32 bpp formats */
1027 case PIXMAN_a2b10g10r10:
1028 case PIXMAN_x2b10g10r10:
1029 case PIXMAN_a2r10g10b10:
1030 case PIXMAN_x2r10g10b10:
1031 case PIXMAN_a8r8g8b8:
1032 case PIXMAN_x8r8g8b8:
1033 case PIXMAN_a8b8g8r8:
1034 case PIXMAN_x8b8g8r8:
1035 case PIXMAN_b8g8r8a8:
1036 case PIXMAN_b8g8r8x8:
1041 /* 16 bpp formats */
1042 case PIXMAN_a1r5g5b5:
1043 case PIXMAN_x1r5g5b5:
1044 case PIXMAN_a1b5g5r5:
1045 case PIXMAN_x1b5g5r5:
1046 case PIXMAN_a4r4g4b4:
1047 case PIXMAN_x4r4g4b4:
1048 case PIXMAN_a4b4g4r4:
1049 case PIXMAN_x4b4g4r4:
1054 case PIXMAN_a2r2g2b2:
1055 case PIXMAN_a2b2g2r2:
1059 /* Collides with PIXMAN_c8
1062 /* Collides with PIXMAN_g8
1069 case PIXMAN_a1r1g1b1:
1070 case PIXMAN_a1b1g1r1:
1087 * pixman_format_supported_destination:
1088 * @format: A pixman_format_code_t format
1090 * Return value: whether the provided format code is a supported
1091 * format for a pixman surface used as a destination in
1094 * Currently, all pixman_format_code_t values are supported
1095 * except for the YUV formats.
1097 PIXMAN_EXPORT pixman_bool_t
1098 pixman_format_supported_destination (pixman_format_code_t format)
1100 /* YUV formats cannot be written to at the moment */
1101 if (format == PIXMAN_yuy2 || format == PIXMAN_yv12)
1104 return pixman_format_supported_source (format);
1107 PIXMAN_EXPORT pixman_bool_t
1108 pixman_compute_composite_region (pixman_region16_t * region,
1109 pixman_image_t * src_image,
1110 pixman_image_t * mask_image,
1111 pixman_image_t * dst_image,
1121 pixman_region32_t r32;
1122 pixman_bool_t retval;
1124 pixman_region32_init (&r32);
1126 retval = pixman_compute_composite_region32 (
1127 &r32, src_image, mask_image, dst_image,
1128 src_x, src_y, mask_x, mask_y, dest_x, dest_y,
1133 if (!pixman_region16_copy_from_region32 (region, &r32))
1137 pixman_region32_fini (&r32);