pixman.h@ 105930

Last change on this file since 105930 was 105930, checked in by vboxsync, 3 months ago
Additions: Linux: Fix build error for new pixman-0.40.0, bugref:10758.
Property svn:eol-style set to `native`
File size: 47.4 KB

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

Note: See TracBrowser for help on using the repository browser.

source: vbox/trunk/src/VBox/Additions/x11/x11include/pixman-0.43.4/pixman.h@ 105930

Download in other formats: