VirtualBox

source: vbox/trunk/src/VBox/Additions/x11/x11include/pixman-0.40.0/pixman.h@ 97956

最後變更 在這個檔案從97956是 96469,由 vboxsync 提交於 3 年 前

Add/x11/x11includes: Export the files inside pixman-0.40.0 too, not just the directory. bugref:8515
  • 屬性 svn:eol-style 設為 native
檔案大小: 46.7 KB
行 
1/***********************************************************
2
3Copyright 1987, 1998 The Open Group
4
5Permission to use, copy, modify, distribute, and sell this software and its
6documentation for any purpose is hereby granted without fee, provided that
7the above copyright notice appear in all copies and that both that
8copyright notice and this permission notice appear in supporting
9documentation.
10
11The above copyright notice and this permission notice shall be included in
12all copies or substantial portions of the Software.
13
14THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
17OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
18AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
19CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
20
21Except as contained in this notice, the name of The Open Group shall not be
22used in advertising or otherwise to promote the sale, use or other dealings
23in this Software without prior written authorization from The Open Group.
24
25Copyright 1987 by Digital Equipment Corporation, Maynard, Massachusetts.
26
27 All Rights Reserved
28
29Permission to use, copy, modify, and distribute this software and its
30documentation for any purpose and without fee is hereby granted,
31provided that the above copyright notice appear in all copies and that
32both that copyright notice and this permission notice appear in
33supporting documentation, and that the name of Digital not be
34used in advertising or publicity pertaining to distribution of the
35software without specific, written prior permission.
36
37DIGITAL DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING
38ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL
39DIGITAL BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR
40ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
41WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
42ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
43SOFTWARE.
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#ifdef __cplusplus
75#define PIXMAN_BEGIN_DECLS extern "C" {
76#define PIXMAN_END_DECLS }
77#else
78#define PIXMAN_BEGIN_DECLS
79#define PIXMAN_END_DECLS
80#endif
81
82PIXMAN_BEGIN_DECLS
83
84/*
85 * Standard integers
86 */
87
88#if !defined (PIXMAN_DONT_DEFINE_STDINT)
89
90#if defined (_SVR4) || defined (SVR4) || defined (__OpenBSD__) || defined (_sgi) || defined (__sun) || defined (sun) || defined (__digital__) || defined (__HP_cc)
91# include <inttypes.h>
92/* VS 2010 (_MSC_VER 1600) has stdint.h */
93#elif defined (_MSC_VER) && _MSC_VER < 1600
94typedef __int8 int8_t;
95typedef unsigned __int8 uint8_t;
96typedef __int16 int16_t;
97typedef unsigned __int16 uint16_t;
98typedef __int32 int32_t;
99typedef unsigned __int32 uint32_t;
100typedef __int64 int64_t;
101typedef unsigned __int64 uint64_t;
102#elif defined (_AIX)
103# include <sys/inttypes.h>
104#else
105# include <stdint.h>
106#endif
107
108#endif
109
110/*
111 * Boolean
112 */
113typedef int pixman_bool_t;
114
115/*
116 * Fixpoint numbers
117 */
118typedef int64_t pixman_fixed_32_32_t;
119typedef pixman_fixed_32_32_t pixman_fixed_48_16_t;
120typedef uint32_t pixman_fixed_1_31_t;
121typedef uint32_t pixman_fixed_1_16_t;
122typedef int32_t pixman_fixed_16_16_t;
123typedef pixman_fixed_16_16_t pixman_fixed_t;
124
125#define pixman_fixed_e ((pixman_fixed_t) 1)
126#define pixman_fixed_1 (pixman_int_to_fixed(1))
127#define pixman_fixed_1_minus_e (pixman_fixed_1 - pixman_fixed_e)
128#define pixman_fixed_minus_1 (pixman_int_to_fixed(-1))
129#define pixman_fixed_to_int(f) ((int) ((f) >> 16))
130#define pixman_int_to_fixed(i) ((pixman_fixed_t) ((uint32_t) (i) << 16))
131#define pixman_fixed_to_double(f) (double) ((f) / (double) pixman_fixed_1)
132#define pixman_double_to_fixed(d) ((pixman_fixed_t) ((d) * 65536.0))
133#define pixman_fixed_frac(f) ((f) & pixman_fixed_1_minus_e)
134#define pixman_fixed_floor(f) ((f) & ~pixman_fixed_1_minus_e)
135#define pixman_fixed_ceil(f) pixman_fixed_floor ((f) + pixman_fixed_1_minus_e)
136#define pixman_fixed_fraction(f) ((f) & pixman_fixed_1_minus_e)
137#define pixman_fixed_mod_2(f) ((f) & (pixman_fixed1 | pixman_fixed_1_minus_e))
138#define pixman_max_fixed_48_16 ((pixman_fixed_48_16_t) 0x7fffffff)
139#define pixman_min_fixed_48_16 (-((pixman_fixed_48_16_t) 1 << 31))
140
141/*
142 * Misc structs
143 */
144typedef struct pixman_color pixman_color_t;
145typedef struct pixman_point_fixed pixman_point_fixed_t;
146typedef struct pixman_line_fixed pixman_line_fixed_t;
147typedef struct pixman_vector pixman_vector_t;
148typedef struct pixman_transform pixman_transform_t;
149
150struct pixman_color
151{
152 uint16_t red;
153 uint16_t green;
154 uint16_t blue;
155 uint16_t alpha;
156};
157
158struct pixman_point_fixed
159{
160 pixman_fixed_t x;
161 pixman_fixed_t y;
162};
163
164struct pixman_line_fixed
165{
166 pixman_point_fixed_t p1, p2;
167};
168
169/*
170 * Fixed point matrices
171 */
172
173struct pixman_vector
174{
175 pixman_fixed_t vector[3];
176};
177
178struct pixman_transform
179{
180 pixman_fixed_t matrix[3][3];
181};
182
183/* forward declaration (sorry) */
184struct pixman_box16;
185typedef union pixman_image pixman_image_t;
186
187PIXMAN_API
188void pixman_transform_init_identity (struct pixman_transform *matrix);
189
190PIXMAN_API
191pixman_bool_t pixman_transform_point_3d (const struct pixman_transform *transform,
192 struct pixman_vector *vector);
193
194PIXMAN_API
195pixman_bool_t pixman_transform_point (const struct pixman_transform *transform,
196 struct pixman_vector *vector);
197
198PIXMAN_API
199pixman_bool_t pixman_transform_multiply (struct pixman_transform *dst,
200 const struct pixman_transform *l,
201 const struct pixman_transform *r);
202
203PIXMAN_API
204void pixman_transform_init_scale (struct pixman_transform *t,
205 pixman_fixed_t sx,
206 pixman_fixed_t sy);
207
208PIXMAN_API
209pixman_bool_t pixman_transform_scale (struct pixman_transform *forward,
210 struct pixman_transform *reverse,
211 pixman_fixed_t sx,
212 pixman_fixed_t sy);
213
214PIXMAN_API
215void pixman_transform_init_rotate (struct pixman_transform *t,
216 pixman_fixed_t cos,
217 pixman_fixed_t sin);
218
219PIXMAN_API
220pixman_bool_t pixman_transform_rotate (struct pixman_transform *forward,
221 struct pixman_transform *reverse,
222 pixman_fixed_t c,
223 pixman_fixed_t s);
224
225PIXMAN_API
226void pixman_transform_init_translate (struct pixman_transform *t,
227 pixman_fixed_t tx,
228 pixman_fixed_t ty);
229
230PIXMAN_API
231pixman_bool_t pixman_transform_translate (struct pixman_transform *forward,
232 struct pixman_transform *reverse,
233 pixman_fixed_t tx,
234 pixman_fixed_t ty);
235
236PIXMAN_API
237pixman_bool_t pixman_transform_bounds (const struct pixman_transform *matrix,
238 struct pixman_box16 *b);
239
240PIXMAN_API
241pixman_bool_t pixman_transform_invert (struct pixman_transform *dst,
242 const struct pixman_transform *src);
243
244PIXMAN_API
245pixman_bool_t pixman_transform_is_identity (const struct pixman_transform *t);
246
247PIXMAN_API
248pixman_bool_t pixman_transform_is_scale (const struct pixman_transform *t);
249
250PIXMAN_API
251pixman_bool_t pixman_transform_is_int_translate (const struct pixman_transform *t);
252
253PIXMAN_API
254pixman_bool_t pixman_transform_is_inverse (const struct pixman_transform *a,
255 const struct pixman_transform *b);
256
257/*
258 * Floating point matrices
259 */
260typedef struct pixman_f_transform pixman_f_transform_t;
261typedef struct pixman_f_vector pixman_f_vector_t;
262
263struct pixman_f_vector
264{
265 double v[3];
266};
267
268struct pixman_f_transform
269{
270 double m[3][3];
271};
272
273
274PIXMAN_API
275pixman_bool_t pixman_transform_from_pixman_f_transform (struct pixman_transform *t,
276 const struct pixman_f_transform *ft);
277
278PIXMAN_API
279void pixman_f_transform_from_pixman_transform (struct pixman_f_transform *ft,
280 const struct pixman_transform *t);
281
282PIXMAN_API
283pixman_bool_t pixman_f_transform_invert (struct pixman_f_transform *dst,
284 const struct pixman_f_transform *src);
285
286PIXMAN_API
287pixman_bool_t pixman_f_transform_point (const struct pixman_f_transform *t,
288 struct pixman_f_vector *v);
289
290PIXMAN_API
291void pixman_f_transform_point_3d (const struct pixman_f_transform *t,
292 struct pixman_f_vector *v);
293
294PIXMAN_API
295void pixman_f_transform_multiply (struct pixman_f_transform *dst,
296 const struct pixman_f_transform *l,
297 const struct pixman_f_transform *r);
298
299PIXMAN_API
300void pixman_f_transform_init_scale (struct pixman_f_transform *t,
301 double sx,
302 double sy);
303
304PIXMAN_API
305pixman_bool_t pixman_f_transform_scale (struct pixman_f_transform *forward,
306 struct pixman_f_transform *reverse,
307 double sx,
308 double sy);
309
310PIXMAN_API
311void pixman_f_transform_init_rotate (struct pixman_f_transform *t,
312 double cos,
313 double sin);
314
315PIXMAN_API
316pixman_bool_t pixman_f_transform_rotate (struct pixman_f_transform *forward,
317 struct pixman_f_transform *reverse,
318 double c,
319 double s);
320
321PIXMAN_API
322void pixman_f_transform_init_translate (struct pixman_f_transform *t,
323 double tx,
324 double ty);
325
326PIXMAN_API
327pixman_bool_t pixman_f_transform_translate (struct pixman_f_transform *forward,
328 struct pixman_f_transform *reverse,
329 double tx,
330 double ty);
331
332PIXMAN_API
333pixman_bool_t pixman_f_transform_bounds (const struct pixman_f_transform *t,
334 struct pixman_box16 *b);
335
336PIXMAN_API
337void pixman_f_transform_init_identity (struct pixman_f_transform *t);
338
339typedef enum
340{
341 PIXMAN_REPEAT_NONE,
342 PIXMAN_REPEAT_NORMAL,
343 PIXMAN_REPEAT_PAD,
344 PIXMAN_REPEAT_REFLECT
345} pixman_repeat_t;
346
347typedef enum
348{
349 PIXMAN_DITHER_NONE,
350 PIXMAN_DITHER_FAST,
351 PIXMAN_DITHER_GOOD,
352 PIXMAN_DITHER_BEST,
353 PIXMAN_DITHER_ORDERED_BAYER_8,
354#ifndef VBOX
355 PIXMAN_DITHER_ORDERED_BLUE_NOISE_64,
356#else
357 PIXMAN_DITHER_ORDERED_BLUE_NOISE_64
358#endif
359} pixman_dither_t;
360
361typedef enum
362{
363 PIXMAN_FILTER_FAST,
364 PIXMAN_FILTER_GOOD,
365 PIXMAN_FILTER_BEST,
366 PIXMAN_FILTER_NEAREST,
367 PIXMAN_FILTER_BILINEAR,
368 PIXMAN_FILTER_CONVOLUTION,
369
370 /* The SEPARABLE_CONVOLUTION filter takes the following parameters:
371 *
372 * width: integer given as 16.16 fixpoint number
373 * height: integer given as 16.16 fixpoint number
374 * x_phase_bits: integer given as 16.16 fixpoint
375 * y_phase_bits: integer given as 16.16 fixpoint
376 * xtables: (1 << x_phase_bits) tables of size width
377 * ytables: (1 << y_phase_bits) tables of size height
378 *
379 * When sampling at (x, y), the location is first rounded to one of
380 * n_x_phases * n_y_phases subpixel positions. These subpixel positions
381 * determine an xtable and a ytable to use.
382 *
383 * Conceptually a width x height matrix is then formed in which each entry
384 * is the product of the corresponding entries in the x and y tables.
385 * This matrix is then aligned with the image pixels such that its center
386 * is as close as possible to the subpixel location chosen earlier. Then
387 * the image is convolved with the matrix and the resulting pixel returned.
388 */
389 PIXMAN_FILTER_SEPARABLE_CONVOLUTION
390} pixman_filter_t;
391
392typedef enum
393{
394 PIXMAN_OP_CLEAR = 0x00,
395 PIXMAN_OP_SRC = 0x01,
396 PIXMAN_OP_DST = 0x02,
397 PIXMAN_OP_OVER = 0x03,
398 PIXMAN_OP_OVER_REVERSE = 0x04,
399 PIXMAN_OP_IN = 0x05,
400 PIXMAN_OP_IN_REVERSE = 0x06,
401 PIXMAN_OP_OUT = 0x07,
402 PIXMAN_OP_OUT_REVERSE = 0x08,
403 PIXMAN_OP_ATOP = 0x09,
404 PIXMAN_OP_ATOP_REVERSE = 0x0a,
405 PIXMAN_OP_XOR = 0x0b,
406 PIXMAN_OP_ADD = 0x0c,
407 PIXMAN_OP_SATURATE = 0x0d,
408
409 PIXMAN_OP_DISJOINT_CLEAR = 0x10,
410 PIXMAN_OP_DISJOINT_SRC = 0x11,
411 PIXMAN_OP_DISJOINT_DST = 0x12,
412 PIXMAN_OP_DISJOINT_OVER = 0x13,
413 PIXMAN_OP_DISJOINT_OVER_REVERSE = 0x14,
414 PIXMAN_OP_DISJOINT_IN = 0x15,
415 PIXMAN_OP_DISJOINT_IN_REVERSE = 0x16,
416 PIXMAN_OP_DISJOINT_OUT = 0x17,
417 PIXMAN_OP_DISJOINT_OUT_REVERSE = 0x18,
418 PIXMAN_OP_DISJOINT_ATOP = 0x19,
419 PIXMAN_OP_DISJOINT_ATOP_REVERSE = 0x1a,
420 PIXMAN_OP_DISJOINT_XOR = 0x1b,
421
422 PIXMAN_OP_CONJOINT_CLEAR = 0x20,
423 PIXMAN_OP_CONJOINT_SRC = 0x21,
424 PIXMAN_OP_CONJOINT_DST = 0x22,
425 PIXMAN_OP_CONJOINT_OVER = 0x23,
426 PIXMAN_OP_CONJOINT_OVER_REVERSE = 0x24,
427 PIXMAN_OP_CONJOINT_IN = 0x25,
428 PIXMAN_OP_CONJOINT_IN_REVERSE = 0x26,
429 PIXMAN_OP_CONJOINT_OUT = 0x27,
430 PIXMAN_OP_CONJOINT_OUT_REVERSE = 0x28,
431 PIXMAN_OP_CONJOINT_ATOP = 0x29,
432 PIXMAN_OP_CONJOINT_ATOP_REVERSE = 0x2a,
433 PIXMAN_OP_CONJOINT_XOR = 0x2b,
434
435 PIXMAN_OP_MULTIPLY = 0x30,
436 PIXMAN_OP_SCREEN = 0x31,
437 PIXMAN_OP_OVERLAY = 0x32,
438 PIXMAN_OP_DARKEN = 0x33,
439 PIXMAN_OP_LIGHTEN = 0x34,
440 PIXMAN_OP_COLOR_DODGE = 0x35,
441 PIXMAN_OP_COLOR_BURN = 0x36,
442 PIXMAN_OP_HARD_LIGHT = 0x37,
443 PIXMAN_OP_SOFT_LIGHT = 0x38,
444 PIXMAN_OP_DIFFERENCE = 0x39,
445 PIXMAN_OP_EXCLUSION = 0x3a,
446 PIXMAN_OP_HSL_HUE = 0x3b,
447 PIXMAN_OP_HSL_SATURATION = 0x3c,
448 PIXMAN_OP_HSL_COLOR = 0x3d,
449 PIXMAN_OP_HSL_LUMINOSITY = 0x3e
450
451#ifdef PIXMAN_USE_INTERNAL_API
452 ,
453 PIXMAN_N_OPERATORS,
454 PIXMAN_OP_NONE = PIXMAN_N_OPERATORS
455#endif
456} pixman_op_t;
457
458/*
459 * Regions
460 */
461typedef struct pixman_region16_data pixman_region16_data_t;
462typedef struct pixman_box16 pixman_box16_t;
463typedef struct pixman_rectangle16 pixman_rectangle16_t;
464typedef struct pixman_region16 pixman_region16_t;
465
466struct pixman_region16_data {
467 long size;
468 long numRects;
469/* pixman_box16_t rects[size]; in memory but not explicitly declared */
470};
471
472struct pixman_rectangle16
473{
474 int16_t x, y;
475 uint16_t width, height;
476};
477
478struct pixman_box16
479{
480 int16_t x1, y1, x2, y2;
481};
482
483struct pixman_region16
484{
485 pixman_box16_t extents;
486 pixman_region16_data_t *data;
487};
488
489typedef enum
490{
491 PIXMAN_REGION_OUT,
492 PIXMAN_REGION_IN,
493 PIXMAN_REGION_PART
494} pixman_region_overlap_t;
495
496/* This function exists only to make it possible to preserve
497 * the X ABI - it should go away at first opportunity.
498 */
499PIXMAN_API
500void pixman_region_set_static_pointers (pixman_box16_t *empty_box,
501 pixman_region16_data_t *empty_data,
502 pixman_region16_data_t *broken_data);
503
504/* creation/destruction */
505PIXMAN_API
506void pixman_region_init (pixman_region16_t *region);
507
508PIXMAN_API
509void pixman_region_init_rect (pixman_region16_t *region,
510 int x,
511 int y,
512 unsigned int width,
513 unsigned int height);
514
515PIXMAN_API
516pixman_bool_t pixman_region_init_rects (pixman_region16_t *region,
517 const pixman_box16_t *boxes,
518 int count);
519
520PIXMAN_API
521void pixman_region_init_with_extents (pixman_region16_t *region,
522 pixman_box16_t *extents);
523
524PIXMAN_API
525void pixman_region_init_from_image (pixman_region16_t *region,
526 pixman_image_t *image);
527
528PIXMAN_API
529void pixman_region_fini (pixman_region16_t *region);
530
531
532/* manipulation */
533PIXMAN_API
534void pixman_region_translate (pixman_region16_t *region,
535 int x,
536 int y);
537
538PIXMAN_API
539pixman_bool_t pixman_region_copy (pixman_region16_t *dest,
540 pixman_region16_t *source);
541
542PIXMAN_API
543pixman_bool_t pixman_region_intersect (pixman_region16_t *new_reg,
544 pixman_region16_t *reg1,
545 pixman_region16_t *reg2);
546
547PIXMAN_API
548pixman_bool_t pixman_region_union (pixman_region16_t *new_reg,
549 pixman_region16_t *reg1,
550 pixman_region16_t *reg2);
551
552PIXMAN_API
553pixman_bool_t pixman_region_union_rect (pixman_region16_t *dest,
554 pixman_region16_t *source,
555 int x,
556 int y,
557 unsigned int width,
558 unsigned int height);
559
560PIXMAN_API
561pixman_bool_t pixman_region_intersect_rect (pixman_region16_t *dest,
562 pixman_region16_t *source,
563 int x,
564 int y,
565 unsigned int width,
566 unsigned int height);
567
568PIXMAN_API
569pixman_bool_t pixman_region_subtract (pixman_region16_t *reg_d,
570 pixman_region16_t *reg_m,
571 pixman_region16_t *reg_s);
572
573PIXMAN_API
574pixman_bool_t pixman_region_inverse (pixman_region16_t *new_reg,
575 pixman_region16_t *reg1,
576 pixman_box16_t *inv_rect);
577
578PIXMAN_API
579pixman_bool_t pixman_region_contains_point (pixman_region16_t *region,
580 int x,
581 int y,
582 pixman_box16_t *box);
583
584PIXMAN_API
585pixman_region_overlap_t pixman_region_contains_rectangle (pixman_region16_t *region,
586 pixman_box16_t *prect);
587
588PIXMAN_API
589pixman_bool_t pixman_region_not_empty (pixman_region16_t *region);
590
591PIXMAN_API
592pixman_box16_t * pixman_region_extents (pixman_region16_t *region);
593
594PIXMAN_API
595int pixman_region_n_rects (pixman_region16_t *region);
596
597PIXMAN_API
598pixman_box16_t * pixman_region_rectangles (pixman_region16_t *region,
599 int *n_rects);
600
601PIXMAN_API
602pixman_bool_t pixman_region_equal (pixman_region16_t *region1,
603 pixman_region16_t *region2);
604
605PIXMAN_API
606pixman_bool_t pixman_region_selfcheck (pixman_region16_t *region);
607
608PIXMAN_API
609void pixman_region_reset (pixman_region16_t *region,
610 pixman_box16_t *box);
611
612PIXMAN_API
613void pixman_region_clear (pixman_region16_t *region);
614/*
615 * 32 bit regions
616 */
617typedef struct pixman_region32_data pixman_region32_data_t;
618typedef struct pixman_box32 pixman_box32_t;
619typedef struct pixman_rectangle32 pixman_rectangle32_t;
620typedef struct pixman_region32 pixman_region32_t;
621
622struct pixman_region32_data {
623 long size;
624 long numRects;
625/* pixman_box32_t rects[size]; in memory but not explicitly declared */
626};
627
628struct pixman_rectangle32
629{
630 int32_t x, y;
631 uint32_t width, height;
632};
633
634struct pixman_box32
635{
636 int32_t x1, y1, x2, y2;
637};
638
639struct pixman_region32
640{
641 pixman_box32_t extents;
642 pixman_region32_data_t *data;
643};
644
645/* creation/destruction */
646PIXMAN_API
647void pixman_region32_init (pixman_region32_t *region);
648
649PIXMAN_API
650void pixman_region32_init_rect (pixman_region32_t *region,
651 int x,
652 int y,
653 unsigned int width,
654 unsigned int height);
655
656PIXMAN_API
657pixman_bool_t pixman_region32_init_rects (pixman_region32_t *region,
658 const pixman_box32_t *boxes,
659 int count);
660
661PIXMAN_API
662void pixman_region32_init_with_extents (pixman_region32_t *region,
663 pixman_box32_t *extents);
664
665PIXMAN_API
666void pixman_region32_init_from_image (pixman_region32_t *region,
667 pixman_image_t *image);
668
669PIXMAN_API
670void pixman_region32_fini (pixman_region32_t *region);
671
672
673/* manipulation */
674PIXMAN_API
675void pixman_region32_translate (pixman_region32_t *region,
676 int x,
677 int y);
678
679PIXMAN_API
680pixman_bool_t pixman_region32_copy (pixman_region32_t *dest,
681 pixman_region32_t *source);
682
683PIXMAN_API
684pixman_bool_t pixman_region32_intersect (pixman_region32_t *new_reg,
685 pixman_region32_t *reg1,
686 pixman_region32_t *reg2);
687
688PIXMAN_API
689pixman_bool_t pixman_region32_union (pixman_region32_t *new_reg,
690 pixman_region32_t *reg1,
691 pixman_region32_t *reg2);
692
693PIXMAN_API
694pixman_bool_t pixman_region32_intersect_rect (pixman_region32_t *dest,
695 pixman_region32_t *source,
696 int x,
697 int y,
698 unsigned int width,
699 unsigned int height);
700
701PIXMAN_API
702pixman_bool_t pixman_region32_union_rect (pixman_region32_t *dest,
703 pixman_region32_t *source,
704 int x,
705 int y,
706 unsigned int width,
707 unsigned int height);
708
709PIXMAN_API
710pixman_bool_t pixman_region32_subtract (pixman_region32_t *reg_d,
711 pixman_region32_t *reg_m,
712 pixman_region32_t *reg_s);
713
714PIXMAN_API
715pixman_bool_t pixman_region32_inverse (pixman_region32_t *new_reg,
716 pixman_region32_t *reg1,
717 pixman_box32_t *inv_rect);
718
719PIXMAN_API
720pixman_bool_t pixman_region32_contains_point (pixman_region32_t *region,
721 int x,
722 int y,
723 pixman_box32_t *box);
724
725PIXMAN_API
726pixman_region_overlap_t pixman_region32_contains_rectangle (pixman_region32_t *region,
727 pixman_box32_t *prect);
728
729PIXMAN_API
730pixman_bool_t pixman_region32_not_empty (pixman_region32_t *region);
731
732PIXMAN_API
733pixman_box32_t * pixman_region32_extents (pixman_region32_t *region);
734
735PIXMAN_API
736int pixman_region32_n_rects (pixman_region32_t *region);
737
738PIXMAN_API
739pixman_box32_t * pixman_region32_rectangles (pixman_region32_t *region,
740 int *n_rects);
741
742PIXMAN_API
743pixman_bool_t pixman_region32_equal (pixman_region32_t *region1,
744 pixman_region32_t *region2);
745
746PIXMAN_API
747pixman_bool_t pixman_region32_selfcheck (pixman_region32_t *region);
748
749PIXMAN_API
750void pixman_region32_reset (pixman_region32_t *region,
751 pixman_box32_t *box);
752
753PIXMAN_API
754void pixman_region32_clear (pixman_region32_t *region);
755
756
757/* Copy / Fill / Misc */
758PIXMAN_API
759pixman_bool_t pixman_blt (uint32_t *src_bits,
760 uint32_t *dst_bits,
761 int src_stride,
762 int dst_stride,
763 int src_bpp,
764 int dst_bpp,
765 int src_x,
766 int src_y,
767 int dest_x,
768 int dest_y,
769 int width,
770 int height);
771
772PIXMAN_API
773pixman_bool_t pixman_fill (uint32_t *bits,
774 int stride,
775 int bpp,
776 int x,
777 int y,
778 int width,
779 int height,
780 uint32_t _xor);
781
782
783PIXMAN_API
784int pixman_version (void);
785
786PIXMAN_API
787const char* pixman_version_string (void);
788
789/*
790 * Images
791 */
792typedef struct pixman_indexed pixman_indexed_t;
793typedef struct pixman_gradient_stop pixman_gradient_stop_t;
794
795typedef uint32_t (* pixman_read_memory_func_t) (const void *src, int size);
796typedef void (* pixman_write_memory_func_t) (void *dst, uint32_t value, int size);
797
798typedef void (* pixman_image_destroy_func_t) (pixman_image_t *image, void *data);
799
800struct pixman_gradient_stop {
801 pixman_fixed_t x;
802 pixman_color_t color;
803};
804
805#define PIXMAN_MAX_INDEXED 256 /* XXX depth must be <= 8 */
806
807#if PIXMAN_MAX_INDEXED <= 256
808typedef uint8_t pixman_index_type;
809#endif
810
811struct pixman_indexed
812{
813 pixman_bool_t color;
814 uint32_t rgba[PIXMAN_MAX_INDEXED];
815 pixman_index_type ent[32768];
816};
817
818/*
819 * While the protocol is generous in format support, the
820 * sample implementation allows only packed RGB and GBR
821 * representations for data to simplify software rendering,
822 */
823#define PIXMAN_FORMAT(bpp,type,a,r,g,b) (((bpp) << 24) | \
824 ((type) << 16) | \
825 ((a) << 12) | \
826 ((r) << 8) | \
827 ((g) << 4) | \
828 ((b)))
829
830#define PIXMAN_FORMAT_BYTE(bpp,type,a,r,g,b) \
831 (((bpp >> 3) << 24) | \
832 (3 << 22) | ((type) << 16) | \
833 ((a >> 3) << 12) | \
834 ((r >> 3) << 8) | \
835 ((g >> 3) << 4) | \
836 ((b >> 3)))
837
838#define PIXMAN_FORMAT_RESHIFT(val, ofs, num) \
839 (((val >> (ofs)) & ((1 << (num)) - 1)) << ((val >> 22) & 3))
840
841#define PIXMAN_FORMAT_BPP(f) PIXMAN_FORMAT_RESHIFT(f, 24, 8)
842#define PIXMAN_FORMAT_SHIFT(f) ((uint32_t)((f >> 22) & 3))
843#define PIXMAN_FORMAT_TYPE(f) (((f) >> 16) & 0x3f)
844#define PIXMAN_FORMAT_A(f) PIXMAN_FORMAT_RESHIFT(f, 12, 4)
845#define PIXMAN_FORMAT_R(f) PIXMAN_FORMAT_RESHIFT(f, 8, 4)
846#define PIXMAN_FORMAT_G(f) PIXMAN_FORMAT_RESHIFT(f, 4, 4)
847#define PIXMAN_FORMAT_B(f) PIXMAN_FORMAT_RESHIFT(f, 0, 4)
848#define PIXMAN_FORMAT_RGB(f) (((f) ) & 0xfff)
849#define PIXMAN_FORMAT_VIS(f) (((f) ) & 0xffff)
850#define PIXMAN_FORMAT_DEPTH(f) (PIXMAN_FORMAT_A(f) + \
851 PIXMAN_FORMAT_R(f) + \
852 PIXMAN_FORMAT_G(f) + \
853 PIXMAN_FORMAT_B(f))
854
855#define PIXMAN_TYPE_OTHER 0
856#define PIXMAN_TYPE_A 1
857#define PIXMAN_TYPE_ARGB 2
858#define PIXMAN_TYPE_ABGR 3
859#define PIXMAN_TYPE_COLOR 4
860#define PIXMAN_TYPE_GRAY 5
861#define PIXMAN_TYPE_YUY2 6
862#define PIXMAN_TYPE_YV12 7
863#define PIXMAN_TYPE_BGRA 8
864#define PIXMAN_TYPE_RGBA 9
865#define PIXMAN_TYPE_ARGB_SRGB 10
866#define PIXMAN_TYPE_RGBA_FLOAT 11
867
868#define PIXMAN_FORMAT_COLOR(f) \
869 (PIXMAN_FORMAT_TYPE(f) == PIXMAN_TYPE_ARGB || \
870 PIXMAN_FORMAT_TYPE(f) == PIXMAN_TYPE_ABGR || \
871 PIXMAN_FORMAT_TYPE(f) == PIXMAN_TYPE_BGRA || \
872 PIXMAN_FORMAT_TYPE(f) == PIXMAN_TYPE_RGBA || \
873 PIXMAN_FORMAT_TYPE(f) == PIXMAN_TYPE_RGBA_FLOAT)
874
875typedef enum {
876/* 128bpp formats */
877 PIXMAN_rgba_float = PIXMAN_FORMAT_BYTE(128,PIXMAN_TYPE_RGBA_FLOAT,32,32,32,32),
878/* 96bpp formats */
879 PIXMAN_rgb_float = PIXMAN_FORMAT_BYTE(96,PIXMAN_TYPE_RGBA_FLOAT,0,32,32,32),
880
881/* 32bpp formats */
882 PIXMAN_a8r8g8b8 = PIXMAN_FORMAT(32,PIXMAN_TYPE_ARGB,8,8,8,8),
883 PIXMAN_x8r8g8b8 = PIXMAN_FORMAT(32,PIXMAN_TYPE_ARGB,0,8,8,8),
884 PIXMAN_a8b8g8r8 = PIXMAN_FORMAT(32,PIXMAN_TYPE_ABGR,8,8,8,8),
885 PIXMAN_x8b8g8r8 = PIXMAN_FORMAT(32,PIXMAN_TYPE_ABGR,0,8,8,8),
886 PIXMAN_b8g8r8a8 = PIXMAN_FORMAT(32,PIXMAN_TYPE_BGRA,8,8,8,8),
887 PIXMAN_b8g8r8x8 = PIXMAN_FORMAT(32,PIXMAN_TYPE_BGRA,0,8,8,8),
888 PIXMAN_r8g8b8a8 = PIXMAN_FORMAT(32,PIXMAN_TYPE_RGBA,8,8,8,8),
889 PIXMAN_r8g8b8x8 = PIXMAN_FORMAT(32,PIXMAN_TYPE_RGBA,0,8,8,8),
890 PIXMAN_x14r6g6b6 = PIXMAN_FORMAT(32,PIXMAN_TYPE_ARGB,0,6,6,6),
891 PIXMAN_x2r10g10b10 = PIXMAN_FORMAT(32,PIXMAN_TYPE_ARGB,0,10,10,10),
892 PIXMAN_a2r10g10b10 = PIXMAN_FORMAT(32,PIXMAN_TYPE_ARGB,2,10,10,10),
893 PIXMAN_x2b10g10r10 = PIXMAN_FORMAT(32,PIXMAN_TYPE_ABGR,0,10,10,10),
894 PIXMAN_a2b10g10r10 = PIXMAN_FORMAT(32,PIXMAN_TYPE_ABGR,2,10,10,10),
895
896/* sRGB formats */
897 PIXMAN_a8r8g8b8_sRGB = PIXMAN_FORMAT(32,PIXMAN_TYPE_ARGB_SRGB,8,8,8,8),
898
899/* 24bpp formats */
900 PIXMAN_r8g8b8 = PIXMAN_FORMAT(24,PIXMAN_TYPE_ARGB,0,8,8,8),
901 PIXMAN_b8g8r8 = PIXMAN_FORMAT(24,PIXMAN_TYPE_ABGR,0,8,8,8),
902
903/* 16bpp formats */
904 PIXMAN_r5g6b5 = PIXMAN_FORMAT(16,PIXMAN_TYPE_ARGB,0,5,6,5),
905 PIXMAN_b5g6r5 = PIXMAN_FORMAT(16,PIXMAN_TYPE_ABGR,0,5,6,5),
906
907 PIXMAN_a1r5g5b5 = PIXMAN_FORMAT(16,PIXMAN_TYPE_ARGB,1,5,5,5),
908 PIXMAN_x1r5g5b5 = PIXMAN_FORMAT(16,PIXMAN_TYPE_ARGB,0,5,5,5),
909 PIXMAN_a1b5g5r5 = PIXMAN_FORMAT(16,PIXMAN_TYPE_ABGR,1,5,5,5),
910 PIXMAN_x1b5g5r5 = PIXMAN_FORMAT(16,PIXMAN_TYPE_ABGR,0,5,5,5),
911 PIXMAN_a4r4g4b4 = PIXMAN_FORMAT(16,PIXMAN_TYPE_ARGB,4,4,4,4),
912 PIXMAN_x4r4g4b4 = PIXMAN_FORMAT(16,PIXMAN_TYPE_ARGB,0,4,4,4),
913 PIXMAN_a4b4g4r4 = PIXMAN_FORMAT(16,PIXMAN_TYPE_ABGR,4,4,4,4),
914 PIXMAN_x4b4g4r4 = PIXMAN_FORMAT(16,PIXMAN_TYPE_ABGR,0,4,4,4),
915
916/* 8bpp formats */
917 PIXMAN_a8 = PIXMAN_FORMAT(8,PIXMAN_TYPE_A,8,0,0,0),
918 PIXMAN_r3g3b2 = PIXMAN_FORMAT(8,PIXMAN_TYPE_ARGB,0,3,3,2),
919 PIXMAN_b2g3r3 = PIXMAN_FORMAT(8,PIXMAN_TYPE_ABGR,0,3,3,2),
920 PIXMAN_a2r2g2b2 = PIXMAN_FORMAT(8,PIXMAN_TYPE_ARGB,2,2,2,2),
921 PIXMAN_a2b2g2r2 = PIXMAN_FORMAT(8,PIXMAN_TYPE_ABGR,2,2,2,2),
922
923 PIXMAN_c8 = PIXMAN_FORMAT(8,PIXMAN_TYPE_COLOR,0,0,0,0),
924 PIXMAN_g8 = PIXMAN_FORMAT(8,PIXMAN_TYPE_GRAY,0,0,0,0),
925
926 PIXMAN_x4a4 = PIXMAN_FORMAT(8,PIXMAN_TYPE_A,4,0,0,0),
927
928 PIXMAN_x4c4 = PIXMAN_FORMAT(8,PIXMAN_TYPE_COLOR,0,0,0,0),
929 PIXMAN_x4g4 = PIXMAN_FORMAT(8,PIXMAN_TYPE_GRAY,0,0,0,0),
930
931/* 4bpp formats */
932 PIXMAN_a4 = PIXMAN_FORMAT(4,PIXMAN_TYPE_A,4,0,0,0),
933 PIXMAN_r1g2b1 = PIXMAN_FORMAT(4,PIXMAN_TYPE_ARGB,0,1,2,1),
934 PIXMAN_b1g2r1 = PIXMAN_FORMAT(4,PIXMAN_TYPE_ABGR,0,1,2,1),
935 PIXMAN_a1r1g1b1 = PIXMAN_FORMAT(4,PIXMAN_TYPE_ARGB,1,1,1,1),
936 PIXMAN_a1b1g1r1 = PIXMAN_FORMAT(4,PIXMAN_TYPE_ABGR,1,1,1,1),
937
938 PIXMAN_c4 = PIXMAN_FORMAT(4,PIXMAN_TYPE_COLOR,0,0,0,0),
939 PIXMAN_g4 = PIXMAN_FORMAT(4,PIXMAN_TYPE_GRAY,0,0,0,0),
940
941/* 1bpp formats */
942 PIXMAN_a1 = PIXMAN_FORMAT(1,PIXMAN_TYPE_A,1,0,0,0),
943
944 PIXMAN_g1 = PIXMAN_FORMAT(1,PIXMAN_TYPE_GRAY,0,0,0,0),
945
946/* YUV formats */
947 PIXMAN_yuy2 = PIXMAN_FORMAT(16,PIXMAN_TYPE_YUY2,0,0,0,0),
948 PIXMAN_yv12 = PIXMAN_FORMAT(12,PIXMAN_TYPE_YV12,0,0,0,0)
949} pixman_format_code_t;
950
951/* Querying supported format values. */
952PIXMAN_API
953pixman_bool_t pixman_format_supported_destination (pixman_format_code_t format);
954
955PIXMAN_API
956pixman_bool_t pixman_format_supported_source (pixman_format_code_t format);
957
958/* Constructors */
959PIXMAN_API
960pixman_image_t *pixman_image_create_solid_fill (const pixman_color_t *color);
961
962PIXMAN_API
963pixman_image_t *pixman_image_create_linear_gradient (const pixman_point_fixed_t *p1,
964 const pixman_point_fixed_t *p2,
965 const pixman_gradient_stop_t *stops,
966 int n_stops);
967
968PIXMAN_API
969pixman_image_t *pixman_image_create_radial_gradient (const pixman_point_fixed_t *inner,
970 const pixman_point_fixed_t *outer,
971 pixman_fixed_t inner_radius,
972 pixman_fixed_t outer_radius,
973 const pixman_gradient_stop_t *stops,
974 int n_stops);
975
976PIXMAN_API
977pixman_image_t *pixman_image_create_conical_gradient (const pixman_point_fixed_t *center,
978 pixman_fixed_t angle,
979 const pixman_gradient_stop_t *stops,
980 int n_stops);
981
982PIXMAN_API
983pixman_image_t *pixman_image_create_bits (pixman_format_code_t format,
984 int width,
985 int height,
986 uint32_t *bits,
987 int rowstride_bytes);
988
989PIXMAN_API
990pixman_image_t *pixman_image_create_bits_no_clear (pixman_format_code_t format,
991 int width,
992 int height,
993 uint32_t * bits,
994 int rowstride_bytes);
995
996/* Destructor */
997PIXMAN_API
998pixman_image_t *pixman_image_ref (pixman_image_t *image);
999
1000PIXMAN_API
1001pixman_bool_t pixman_image_unref (pixman_image_t *image);
1002
1003
1004PIXMAN_API
1005void pixman_image_set_destroy_function (pixman_image_t *image,
1006 pixman_image_destroy_func_t function,
1007 void *data);
1008
1009PIXMAN_API
1010void * pixman_image_get_destroy_data (pixman_image_t *image);
1011
1012/* Set properties */
1013PIXMAN_API
1014pixman_bool_t pixman_image_set_clip_region (pixman_image_t *image,
1015 pixman_region16_t *region);
1016
1017PIXMAN_API
1018pixman_bool_t pixman_image_set_clip_region32 (pixman_image_t *image,
1019 pixman_region32_t *region);
1020
1021PIXMAN_API
1022void pixman_image_set_has_client_clip (pixman_image_t *image,
1023 pixman_bool_t clien_clip);
1024
1025PIXMAN_API
1026pixman_bool_t pixman_image_set_transform (pixman_image_t *image,
1027 const pixman_transform_t *transform);
1028
1029PIXMAN_API
1030void pixman_image_set_repeat (pixman_image_t *image,
1031 pixman_repeat_t repeat);
1032
1033PIXMAN_API
1034void pixman_image_set_dither (pixman_image_t *image,
1035 pixman_dither_t dither);
1036
1037PIXMAN_API
1038void pixman_image_set_dither_offset (pixman_image_t *image,
1039 int offset_x,
1040 int offset_y);
1041
1042PIXMAN_API
1043pixman_bool_t pixman_image_set_filter (pixman_image_t *image,
1044 pixman_filter_t filter,
1045 const pixman_fixed_t *filter_params,
1046 int n_filter_params);
1047
1048PIXMAN_API
1049void pixman_image_set_source_clipping (pixman_image_t *image,
1050 pixman_bool_t source_clipping);
1051
1052PIXMAN_API
1053void pixman_image_set_alpha_map (pixman_image_t *image,
1054 pixman_image_t *alpha_map,
1055 int16_t x,
1056 int16_t y);
1057
1058PIXMAN_API
1059void pixman_image_set_component_alpha (pixman_image_t *image,
1060 pixman_bool_t component_alpha);
1061
1062PIXMAN_API
1063pixman_bool_t pixman_image_get_component_alpha (pixman_image_t *image);
1064
1065PIXMAN_API
1066void pixman_image_set_accessors (pixman_image_t *image,
1067 pixman_read_memory_func_t read_func,
1068 pixman_write_memory_func_t write_func);
1069
1070PIXMAN_API
1071void pixman_image_set_indexed (pixman_image_t *image,
1072 const pixman_indexed_t *indexed);
1073
1074PIXMAN_API
1075uint32_t *pixman_image_get_data (pixman_image_t *image);
1076
1077PIXMAN_API
1078int pixman_image_get_width (pixman_image_t *image);
1079
1080PIXMAN_API
1081int pixman_image_get_height (pixman_image_t *image);
1082
1083PIXMAN_API
1084int pixman_image_get_stride (pixman_image_t *image); /* in bytes */
1085
1086PIXMAN_API
1087int pixman_image_get_depth (pixman_image_t *image);
1088
1089PIXMAN_API
1090pixman_format_code_t pixman_image_get_format (pixman_image_t *image);
1091
1092typedef enum
1093{
1094 PIXMAN_KERNEL_IMPULSE,
1095 PIXMAN_KERNEL_BOX,
1096 PIXMAN_KERNEL_LINEAR,
1097 PIXMAN_KERNEL_CUBIC,
1098 PIXMAN_KERNEL_GAUSSIAN,
1099 PIXMAN_KERNEL_LANCZOS2,
1100 PIXMAN_KERNEL_LANCZOS3,
1101 PIXMAN_KERNEL_LANCZOS3_STRETCHED /* Jim Blinn's 'nice' filter */
1102} pixman_kernel_t;
1103
1104/* Create the parameter list for a SEPARABLE_CONVOLUTION filter
1105 * with the given kernels and scale parameters.
1106 */
1107PIXMAN_API
1108pixman_fixed_t *
1109pixman_filter_create_separable_convolution (int *n_values,
1110 pixman_fixed_t scale_x,
1111 pixman_fixed_t scale_y,
1112 pixman_kernel_t reconstruct_x,
1113 pixman_kernel_t reconstruct_y,
1114 pixman_kernel_t sample_x,
1115 pixman_kernel_t sample_y,
1116 int subsample_bits_x,
1117 int subsample_bits_y);
1118
1119
1120PIXMAN_API
1121pixman_bool_t pixman_image_fill_rectangles (pixman_op_t op,
1122 pixman_image_t *image,
1123 const pixman_color_t *color,
1124 int n_rects,
1125 const pixman_rectangle16_t *rects);
1126
1127PIXMAN_API
1128pixman_bool_t pixman_image_fill_boxes (pixman_op_t op,
1129 pixman_image_t *dest,
1130 const pixman_color_t *color,
1131 int n_boxes,
1132 const pixman_box32_t *boxes);
1133
1134/* Composite */
1135PIXMAN_API
1136pixman_bool_t pixman_compute_composite_region (pixman_region16_t *region,
1137 pixman_image_t *src_image,
1138 pixman_image_t *mask_image,
1139 pixman_image_t *dest_image,
1140 int16_t src_x,
1141 int16_t src_y,
1142 int16_t mask_x,
1143 int16_t mask_y,
1144 int16_t dest_x,
1145 int16_t dest_y,
1146 uint16_t width,
1147 uint16_t height);
1148
1149PIXMAN_API
1150void pixman_image_composite (pixman_op_t op,
1151 pixman_image_t *src,
1152 pixman_image_t *mask,
1153 pixman_image_t *dest,
1154 int16_t src_x,
1155 int16_t src_y,
1156 int16_t mask_x,
1157 int16_t mask_y,
1158 int16_t dest_x,
1159 int16_t dest_y,
1160 uint16_t width,
1161 uint16_t height);
1162
1163PIXMAN_API
1164void pixman_image_composite32 (pixman_op_t op,
1165 pixman_image_t *src,
1166 pixman_image_t *mask,
1167 pixman_image_t *dest,
1168 int32_t src_x,
1169 int32_t src_y,
1170 int32_t mask_x,
1171 int32_t mask_y,
1172 int32_t dest_x,
1173 int32_t dest_y,
1174 int32_t width,
1175 int32_t height);
1176
1177/* Executive Summary: This function is a no-op that only exists
1178 * for historical reasons.
1179 *
1180 * There used to be a bug in the X server where it would rely on
1181 * out-of-bounds accesses when it was asked to composite with a
1182 * window as the source. It would create a pixman image pointing
1183 * to some bogus position in memory, but then set a clip region
1184 * to the position where the actual bits were.
1185 *
1186 * Due to a bug in old versions of pixman, where it would not clip
1187 * against the image bounds when a clip region was set, this would
1188 * actually work. So when the pixman bug was fixed, a workaround was
1189 * added to allow certain out-of-bound accesses. This function disabled
1190 * those workarounds.
1191 *
1192 * Since 0.21.2, pixman doesn't do these workarounds anymore, so now this
1193 * function is a no-op.
1194 */
1195PIXMAN_API
1196void pixman_disable_out_of_bounds_workaround (void);
1197
1198/*
1199 * Glyphs
1200 */
1201typedef struct pixman_glyph_cache_t pixman_glyph_cache_t;
1202typedef struct
1203{
1204 int x, y;
1205 const void *glyph;
1206} pixman_glyph_t;
1207
1208PIXMAN_API
1209pixman_glyph_cache_t *pixman_glyph_cache_create (void);
1210
1211PIXMAN_API
1212void pixman_glyph_cache_destroy (pixman_glyph_cache_t *cache);
1213
1214PIXMAN_API
1215void pixman_glyph_cache_freeze (pixman_glyph_cache_t *cache);
1216
1217PIXMAN_API
1218void pixman_glyph_cache_thaw (pixman_glyph_cache_t *cache);
1219
1220PIXMAN_API
1221const void * pixman_glyph_cache_lookup (pixman_glyph_cache_t *cache,
1222 void *font_key,
1223 void *glyph_key);
1224
1225PIXMAN_API
1226const void * pixman_glyph_cache_insert (pixman_glyph_cache_t *cache,
1227 void *font_key,
1228 void *glyph_key,
1229 int origin_x,
1230 int origin_y,
1231 pixman_image_t *glyph_image);
1232
1233PIXMAN_API
1234void pixman_glyph_cache_remove (pixman_glyph_cache_t *cache,
1235 void *font_key,
1236 void *glyph_key);
1237
1238PIXMAN_API
1239void pixman_glyph_get_extents (pixman_glyph_cache_t *cache,
1240 int n_glyphs,
1241 pixman_glyph_t *glyphs,
1242 pixman_box32_t *extents);
1243
1244PIXMAN_API
1245pixman_format_code_t pixman_glyph_get_mask_format (pixman_glyph_cache_t *cache,
1246 int n_glyphs,
1247 const pixman_glyph_t *glyphs);
1248
1249PIXMAN_API
1250void pixman_composite_glyphs (pixman_op_t op,
1251 pixman_image_t *src,
1252 pixman_image_t *dest,
1253 pixman_format_code_t mask_format,
1254 int32_t src_x,
1255 int32_t src_y,
1256 int32_t mask_x,
1257 int32_t mask_y,
1258 int32_t dest_x,
1259 int32_t dest_y,
1260 int32_t width,
1261 int32_t height,
1262 pixman_glyph_cache_t *cache,
1263 int n_glyphs,
1264 const pixman_glyph_t *glyphs);
1265
1266PIXMAN_API
1267void pixman_composite_glyphs_no_mask (pixman_op_t op,
1268 pixman_image_t *src,
1269 pixman_image_t *dest,
1270 int32_t src_x,
1271 int32_t src_y,
1272 int32_t dest_x,
1273 int32_t dest_y,
1274 pixman_glyph_cache_t *cache,
1275 int n_glyphs,
1276 const pixman_glyph_t *glyphs);
1277
1278/*
1279 * Trapezoids
1280 */
1281typedef struct pixman_edge pixman_edge_t;
1282typedef struct pixman_trapezoid pixman_trapezoid_t;
1283typedef struct pixman_trap pixman_trap_t;
1284typedef struct pixman_span_fix pixman_span_fix_t;
1285typedef struct pixman_triangle pixman_triangle_t;
1286
1287/*
1288 * An edge structure. This represents a single polygon edge
1289 * and can be quickly stepped across small or large gaps in the
1290 * sample grid
1291 */
1292struct pixman_edge
1293{
1294 pixman_fixed_t x;
1295 pixman_fixed_t e;
1296 pixman_fixed_t stepx;
1297 pixman_fixed_t signdx;
1298 pixman_fixed_t dy;
1299 pixman_fixed_t dx;
1300
1301 pixman_fixed_t stepx_small;
1302 pixman_fixed_t stepx_big;
1303 pixman_fixed_t dx_small;
1304 pixman_fixed_t dx_big;
1305};
1306
1307struct pixman_trapezoid
1308{
1309 pixman_fixed_t top, bottom;
1310 pixman_line_fixed_t left, right;
1311};
1312
1313struct pixman_triangle
1314{
1315 pixman_point_fixed_t p1, p2, p3;
1316};
1317
1318/* whether 't' is a well defined not obviously empty trapezoid */
1319#define pixman_trapezoid_valid(t) \
1320 ((t)->left.p1.y != (t)->left.p2.y && \
1321 (t)->right.p1.y != (t)->right.p2.y && \
1322 ((t)->bottom > (t)->top))
1323
1324struct pixman_span_fix
1325{
1326 pixman_fixed_t l, r, y;
1327};
1328
1329struct pixman_trap
1330{
1331 pixman_span_fix_t top, bot;
1332};
1333
1334PIXMAN_API
1335pixman_fixed_t pixman_sample_ceil_y (pixman_fixed_t y,
1336 int bpp);
1337
1338PIXMAN_API
1339pixman_fixed_t pixman_sample_floor_y (pixman_fixed_t y,
1340 int bpp);
1341
1342PIXMAN_API
1343void pixman_edge_step (pixman_edge_t *e,
1344 int n);
1345
1346PIXMAN_API
1347void pixman_edge_init (pixman_edge_t *e,
1348 int bpp,
1349 pixman_fixed_t y_start,
1350 pixman_fixed_t x_top,
1351 pixman_fixed_t y_top,
1352 pixman_fixed_t x_bot,
1353 pixman_fixed_t y_bot);
1354
1355PIXMAN_API
1356void pixman_line_fixed_edge_init (pixman_edge_t *e,
1357 int bpp,
1358 pixman_fixed_t y,
1359 const pixman_line_fixed_t *line,
1360 int x_off,
1361 int y_off);
1362
1363PIXMAN_API
1364void pixman_rasterize_edges (pixman_image_t *image,
1365 pixman_edge_t *l,
1366 pixman_edge_t *r,
1367 pixman_fixed_t t,
1368 pixman_fixed_t b);
1369
1370PIXMAN_API
1371void pixman_add_traps (pixman_image_t *image,
1372 int16_t x_off,
1373 int16_t y_off,
1374 int ntrap,
1375 const pixman_trap_t *traps);
1376
1377PIXMAN_API
1378void pixman_add_trapezoids (pixman_image_t *image,
1379 int16_t x_off,
1380 int y_off,
1381 int ntraps,
1382 const pixman_trapezoid_t *traps);
1383
1384PIXMAN_API
1385void pixman_rasterize_trapezoid (pixman_image_t *image,
1386 const pixman_trapezoid_t *trap,
1387 int x_off,
1388 int y_off);
1389
1390PIXMAN_API
1391void pixman_composite_trapezoids (pixman_op_t op,
1392 pixman_image_t * src,
1393 pixman_image_t * dst,
1394 pixman_format_code_t mask_format,
1395 int x_src,
1396 int y_src,
1397 int x_dst,
1398 int y_dst,
1399 int n_traps,
1400 const pixman_trapezoid_t * traps);
1401
1402PIXMAN_API
1403void pixman_composite_triangles (pixman_op_t op,
1404 pixman_image_t * src,
1405 pixman_image_t * dst,
1406 pixman_format_code_t mask_format,
1407 int x_src,
1408 int y_src,
1409 int x_dst,
1410 int y_dst,
1411 int n_tris,
1412 const pixman_triangle_t * tris);
1413
1414PIXMAN_API
1415void pixman_add_triangles (pixman_image_t *image,
1416 int32_t x_off,
1417 int32_t y_off,
1418 int n_tris,
1419 const pixman_triangle_t *tris);
1420
1421PIXMAN_END_DECLS
1422
1423#endif /* PIXMAN_H__ */
注意: 瀏覽 TracBrowser 來幫助您使用儲存庫瀏覽器

© 2025 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette