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,
529 pixman_format_code_t src_format, mask_format, dest_format;
530 uint32_t src_flags, mask_flags, dest_flags;
531 pixman_region32_t region;
533 get_image_info (src, &src_format, &src_flags);
534 get_image_info (mask, &mask_format, &mask_flags);
535 get_image_info (dest, &dest_format, &dest_flags);
537 /* Check for pixbufs */
538 if ((mask_format == PIXMAN_a8r8g8b8 || mask_format == PIXMAN_a8b8g8r8) &&
539 (src->type == BITS && src->bits.bits == mask->bits.bits) &&
540 (src->common.repeat == mask->common.repeat) &&
541 (src_x == mask_x && src_y == mask_y))
543 if (src_format == PIXMAN_x8b8g8r8)
544 src_format = mask_format = PIXMAN_pixbuf;
545 else if (src_format == PIXMAN_x8r8g8b8)
546 src_format = mask_format = PIXMAN_rpixbuf;
549 pixman_region32_init (®ion);
551 if (!pixman_compute_composite_region32 (
552 ®ion, src, mask, dest,
553 src_x, src_y, mask_x, mask_y, dest_x, dest_y, width, height))
561 pixman_composite_func_t func;
562 const pixman_fast_path_t *info;
563 pixman_bool_t result;
564 pixman_box32_t *extents;
568 extents = pixman_region32_extents (®ion);
570 if (image_covers (src, extents, dest_x - src_x, dest_y - src_y))
571 src_flags |= FAST_PATH_COVERS_CLIP;
573 if (mask && image_covers (mask, extents, dest_x - mask_x, dest_y - mask_y))
574 mask_flags |= FAST_PATH_COVERS_CLIP;
577 for (info = imp->fast_paths; info->op != PIXMAN_OP_NONE; ++info)
579 if ((info->op == op || info->op == PIXMAN_OP_any) &&
581 ((info->src_format == src_format) ||
582 (info->src_format == PIXMAN_any)) &&
583 (info->src_flags & src_flags) == info->src_flags &&
585 ((info->mask_format == mask_format) ||
586 (info->mask_format == PIXMAN_any)) &&
587 (info->mask_flags & mask_flags) == info->mask_flags &&
589 ((info->dest_format == dest_format) ||
590 (info->dest_format == PIXMAN_any)) &&
591 (info->dest_flags & dest_flags) == info->dest_flags)
600 pixman_bool_t src_repeat, mask_repeat;
604 src_flags & FAST_PATH_ID_TRANSFORM &&
605 src->common.repeat == PIXMAN_REPEAT_NORMAL &&
606 src_format != PIXMAN_solid;
610 mask->type == BITS &&
611 mask_flags & FAST_PATH_ID_TRANSFORM &&
612 mask->common.repeat == PIXMAN_REPEAT_NORMAL &&
613 mask_format != PIXMAN_solid;
615 walk_region_internal (imp, op,
617 src_x, src_y, mask_x, mask_y,
620 src_repeat, mask_repeat,
634 pixman_region32_fini (®ion);
638 * Work around GCC bug causing crashes in Mozilla with SSE2
640 * When using -msse, gcc generates movdqa instructions assuming that
641 * the stack is 16 byte aligned. Unfortunately some applications, such
642 * as Mozilla and Mono, end up aligning the stack to 4 bytes, which
643 * causes the movdqa instructions to fail.
645 * The __force_align_arg_pointer__ makes gcc generate a prologue that
646 * realigns the stack pointer to 16 bytes.
648 * On x86-64 this is not necessary because the standard ABI already
649 * calls for a 16 byte aligned stack.
651 * See https://bugs.freedesktop.org/show_bug.cgi?id=15693
653 #if defined (USE_SSE2) && defined(__GNUC__) && !defined(__x86_64__) && !defined(__amd64__)
654 __attribute__((__force_align_arg_pointer__))
657 pixman_image_composite (pixman_op_t op,
658 pixman_image_t * src,
659 pixman_image_t * mask,
660 pixman_image_t * dest,
670 pixman_image_composite32 (op, src, mask, dest, src_x, src_y,
671 mask_x, mask_y, dest_x, dest_y, width, height);
675 pixman_image_composite32 (pixman_op_t op,
676 pixman_image_t * src,
677 pixman_image_t * mask,
678 pixman_image_t * dest,
691 int mask_dx, mask_dy;
693 int dest_dx, dest_dy;
694 pixman_bool_t need_workaround;
696 _pixman_image_validate (src);
698 _pixman_image_validate (mask);
699 _pixman_image_validate (dest);
702 * Check if we can replace our operator by a simpler one
703 * if the src or dest are opaque. The output operator should be
704 * mathematically equivalent to the source.
706 op = pixman_optimize_operator(op, src, mask, dest);
707 if (op == PIXMAN_OP_DST ||
708 op == PIXMAN_OP_CONJOINT_DST ||
709 op == PIXMAN_OP_DISJOINT_DST)
715 imp = _pixman_choose_implementation ();
718 (src->common.need_workaround) ||
719 (mask && mask->common.need_workaround) ||
720 (dest->common.need_workaround);
724 apply_workaround (src, &src_x, &src_y, &src_bits, &src_dx, &src_dy);
725 apply_workaround (mask, &mask_x, &mask_y, &mask_bits, &mask_dx, &mask_dy);
726 apply_workaround (dest, &dest_x, &dest_y, &dest_bits, &dest_dx, &dest_dy);
729 do_composite (imp, op,
738 if (src->common.need_workaround)
739 unapply_workaround (src, src_bits, src_dx, src_dy);
740 if (mask && mask->common.need_workaround)
741 unapply_workaround (mask, mask_bits, mask_dx, mask_dy);
742 if (dest->common.need_workaround)
743 unapply_workaround (dest, dest_bits, dest_dx, dest_dy);
747 PIXMAN_EXPORT pixman_bool_t
748 pixman_blt (uint32_t *src_bits,
762 imp = _pixman_choose_implementation ();
764 return _pixman_implementation_blt (imp, src_bits, dst_bits, src_stride, dst_stride,
771 PIXMAN_EXPORT pixman_bool_t
772 pixman_fill (uint32_t *bits,
782 imp = _pixman_choose_implementation ();
784 return _pixman_implementation_fill (imp, bits, stride, bpp, x, y, width, height, xor);
788 color_to_uint32 (const pixman_color_t *color)
791 (color->alpha >> 8 << 24) |
792 (color->red >> 8 << 16) |
793 (color->green & 0xff00) |
798 color_to_pixel (pixman_color_t * color,
800 pixman_format_code_t format)
802 uint32_t c = color_to_uint32 (color);
804 if (!(format == PIXMAN_a8r8g8b8 ||
805 format == PIXMAN_x8r8g8b8 ||
806 format == PIXMAN_a8b8g8r8 ||
807 format == PIXMAN_x8b8g8r8 ||
808 format == PIXMAN_b8g8r8a8 ||
809 format == PIXMAN_b8g8r8x8 ||
810 format == PIXMAN_r5g6b5 ||
811 format == PIXMAN_b5g6r5 ||
812 format == PIXMAN_a8))
817 if (PIXMAN_FORMAT_TYPE (format) == PIXMAN_TYPE_ABGR)
819 c = ((c & 0xff000000) >> 0) |
820 ((c & 0x00ff0000) >> 16) |
821 ((c & 0x0000ff00) >> 0) |
822 ((c & 0x000000ff) << 16);
824 if (PIXMAN_FORMAT_TYPE (format) == PIXMAN_TYPE_BGRA)
826 c = ((c & 0xff000000) >> 24) |
827 ((c & 0x00ff0000) >> 8) |
828 ((c & 0x0000ff00) << 8) |
829 ((c & 0x000000ff) << 24);
832 if (format == PIXMAN_a8)
834 else if (format == PIXMAN_r5g6b5 ||
835 format == PIXMAN_b5g6r5)
836 c = CONVERT_8888_TO_0565 (c);
839 printf ("color: %x %x %x %x\n", color->alpha, color->red, color->green, color->blue);
840 printf ("pixel: %x\n", c);
847 PIXMAN_EXPORT pixman_bool_t
848 pixman_image_fill_rectangles (pixman_op_t op,
849 pixman_image_t * dest,
850 pixman_color_t * color,
852 const pixman_rectangle16_t *rects)
854 pixman_box32_t stack_boxes[6];
855 pixman_box32_t *boxes;
856 pixman_bool_t result;
861 boxes = pixman_malloc_ab (sizeof (pixman_box32_t), n_rects);
870 for (i = 0; i < n_rects; ++i)
872 boxes[i].x1 = rects[i].x;
873 boxes[i].y1 = rects[i].y;
874 boxes[i].x2 = boxes[i].x1 + rects[i].width;
875 boxes[i].y2 = boxes[i].y1 + rects[i].height;
878 result = pixman_image_fill_boxes (op, dest, color, n_rects, boxes);
880 if (boxes != stack_boxes)
886 PIXMAN_EXPORT pixman_bool_t
887 pixman_image_fill_boxes (pixman_op_t op,
888 pixman_image_t * dest,
889 pixman_color_t * color,
891 const pixman_box32_t *boxes)
893 pixman_image_t *solid;
897 _pixman_image_validate (dest);
899 if (color->alpha == 0xffff)
901 if (op == PIXMAN_OP_OVER)
905 if (op == PIXMAN_OP_CLEAR)
917 if (op == PIXMAN_OP_SRC)
921 if (color_to_pixel (color, &pixel, dest->bits.format))
923 pixman_region32_t fill_region;
925 pixman_box32_t *rects;
927 if (!pixman_region32_init_rects (&fill_region, boxes, n_boxes))
930 if (dest->common.have_clip_region)
932 if (!pixman_region32_intersect (&fill_region,
934 &dest->common.clip_region))
938 rects = pixman_region32_rectangles (&fill_region, &n_rects);
939 for (j = 0; j < n_rects; ++j)
941 const pixman_box32_t *rect = &(rects[j]);
942 pixman_fill (dest->bits.bits, dest->bits.rowstride, PIXMAN_FORMAT_BPP (dest->bits.format),
943 rect->x1, rect->y1, rect->x2 - rect->x1, rect->y2 - rect->y1,
947 pixman_region32_fini (&fill_region);
952 solid = pixman_image_create_solid_fill (color);
956 for (i = 0; i < n_boxes; ++i)
958 const pixman_box32_t *box = &(boxes[i]);
960 pixman_image_composite32 (op, solid, NULL, dest,
963 box->x2 - box->x1, box->y2 - box->y1);
966 pixman_image_unref (solid);
974 * Returns the version of the pixman library encoded in a single
975 * integer as per %PIXMAN_VERSION_ENCODE. The encoding ensures that
976 * later versions compare greater than earlier versions.
978 * A run-time comparison to check that pixman's version is greater than
979 * or equal to version X.Y.Z could be performed as follows:
981 * <informalexample><programlisting>
982 * if (pixman_version() >= PIXMAN_VERSION_ENCODE(X,Y,Z)) {...}
983 * </programlisting></informalexample>
985 * See also pixman_version_string() as well as the compile-time
986 * equivalents %PIXMAN_VERSION and %PIXMAN_VERSION_STRING.
988 * Return value: the encoded version.
991 pixman_version (void)
993 return PIXMAN_VERSION;
997 * pixman_version_string:
999 * Returns the version of the pixman library as a human-readable string
1000 * of the form "X.Y.Z".
1002 * See also pixman_version() as well as the compile-time equivalents
1003 * %PIXMAN_VERSION_STRING and %PIXMAN_VERSION.
1005 * Return value: a string containing the version.
1007 PIXMAN_EXPORT const char*
1008 pixman_version_string (void)
1010 return PIXMAN_VERSION_STRING;
1014 * pixman_format_supported_source:
1015 * @format: A pixman_format_code_t format
1017 * Return value: whether the provided format code is a supported
1018 * format for a pixman surface used as a source in
1021 * Currently, all pixman_format_code_t values are supported.
1023 PIXMAN_EXPORT pixman_bool_t
1024 pixman_format_supported_source (pixman_format_code_t format)
1028 /* 32 bpp formats */
1029 case PIXMAN_a2b10g10r10:
1030 case PIXMAN_x2b10g10r10:
1031 case PIXMAN_a2r10g10b10:
1032 case PIXMAN_x2r10g10b10:
1033 case PIXMAN_a8r8g8b8:
1034 case PIXMAN_x8r8g8b8:
1035 case PIXMAN_a8b8g8r8:
1036 case PIXMAN_x8b8g8r8:
1037 case PIXMAN_b8g8r8a8:
1038 case PIXMAN_b8g8r8x8:
1043 /* 16 bpp formats */
1044 case PIXMAN_a1r5g5b5:
1045 case PIXMAN_x1r5g5b5:
1046 case PIXMAN_a1b5g5r5:
1047 case PIXMAN_x1b5g5r5:
1048 case PIXMAN_a4r4g4b4:
1049 case PIXMAN_x4r4g4b4:
1050 case PIXMAN_a4b4g4r4:
1051 case PIXMAN_x4b4g4r4:
1056 case PIXMAN_a2r2g2b2:
1057 case PIXMAN_a2b2g2r2:
1061 /* Collides with PIXMAN_c8
1064 /* Collides with PIXMAN_g8
1071 case PIXMAN_a1r1g1b1:
1072 case PIXMAN_a1b1g1r1:
1089 * pixman_format_supported_destination:
1090 * @format: A pixman_format_code_t format
1092 * Return value: whether the provided format code is a supported
1093 * format for a pixman surface used as a destination in
1096 * Currently, all pixman_format_code_t values are supported
1097 * except for the YUV formats.
1099 PIXMAN_EXPORT pixman_bool_t
1100 pixman_format_supported_destination (pixman_format_code_t format)
1102 /* YUV formats cannot be written to at the moment */
1103 if (format == PIXMAN_yuy2 || format == PIXMAN_yv12)
1106 return pixman_format_supported_source (format);
1109 PIXMAN_EXPORT pixman_bool_t
1110 pixman_compute_composite_region (pixman_region16_t * region,
1111 pixman_image_t * src_image,
1112 pixman_image_t * mask_image,
1113 pixman_image_t * dst_image,
1123 pixman_region32_t r32;
1124 pixman_bool_t retval;
1126 pixman_region32_init (&r32);
1128 retval = pixman_compute_composite_region32 (
1129 &r32, src_image, mask_image, dst_image,
1130 src_x, src_y, mask_x, mask_y, dest_x, dest_y,
1135 if (!pixman_region16_copy_from_region32 (region, &r32))
1139 pixman_region32_fini (&r32);