picture.h revision 05b261ec 
1/*
2 *
3 * Copyright © 2000 SuSE, Inc.
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, and that the name of SuSE not be used in advertising or
10 * publicity pertaining to distribution of the software without specific,
11 * written prior permission.  SuSE makes no representations about the
12 * suitability of this software for any purpose.  It is provided "as is"
13 * without express or implied warranty.
14 *
15 * SuSE DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL
16 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL SuSE
17 * BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
18 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
19 * OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
20 * CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
21 *
22 * Author:  Keith Packard, SuSE, Inc.
23 */
24
25#ifndef _PICTURE_H_
26#define _PICTURE_H_
27
28#include <pixman.h>
29
30typedef struct _DirectFormat	*DirectFormatPtr;
31typedef struct _PictFormat	*PictFormatPtr;
32typedef struct _Picture		*PicturePtr;
33
34/*
35 * While the protocol is generous in format support, the
36 * sample implementation allows only packed RGB and GBR
37 * representations for data to simplify software rendering,
38 */
39#define PICT_FORMAT(bpp,type,a,r,g,b)	PIXMAN_FORMAT(bpp, type, a, r, g, b)
40
41/*
42 * gray/color formats use a visual index instead of argb
43 */
44#define PICT_VISFORMAT(bpp,type,vi)	(((bpp) << 24) |  \
45					 ((type) << 16) | \
46					 ((vi)))
47
48#define PICT_FORMAT_BPP(f)	PIXMAN_FORMAT_BPP(f)
49#define PICT_FORMAT_TYPE(f)	PIXMAN_FORMAT_TYPE(f)
50#define PICT_FORMAT_A(f)	PIXMAN_FORMAT_A(f)
51#define PICT_FORMAT_R(f)	PIXMAN_FORMAT_R(f)
52#define PICT_FORMAT_G(f)	PIXMAN_FORMAT_G(f)
53#define PICT_FORMAT_B(f)	PIXMAN_FORMAT_B(f)
54#define PICT_FORMAT_RGB(f)	PIXMAN_FORMAT_RGB(f)
55#define PICT_FORMAT_VIS(f)	PIXMAN_FORMAT_VIS(f)
56
57#define PICT_TYPE_OTHER		PIXMAN_TYPE_OTHER
58#define PICT_TYPE_A		PIXMAN_TYPE_A
59#define PICT_TYPE_ARGB		PIXMAN_TYPE_ARGB
60#define PICT_TYPE_ABGR		PIXMAN_TYPE_ABGR
61#define PICT_TYPE_COLOR		PIXMAN_TYPE_COLOR
62#define PICT_TYPE_GRAY		PIXMAN_TYPE_GRAY
63
64#define PICT_FORMAT_COLOR(f)	PIXMAN_FORMAT_COLOR(f)
65
66/* 32bpp formats */
67typedef enum _PictFormatShort {
68    PICT_a8r8g8b8 =	PIXMAN_a8r8g8b8,
69    PICT_x8r8g8b8 =	PIXMAN_x8r8g8b8,
70    PICT_a8b8g8r8 =	PIXMAN_a8b8g8r8,
71    PICT_x8b8g8r8 =	PIXMAN_x8b8g8r8,
72
73/* 24bpp formats */
74    PICT_r8g8b8 =	PIXMAN_r8g8b8,
75    PICT_b8g8r8 =	PIXMAN_b8g8r8,
76
77/* 16bpp formats */
78    PICT_r5g6b5 =	PIXMAN_r5g6b5,
79    PICT_b5g6r5 =	PIXMAN_b5g6r5,
80
81    PICT_a1r5g5b5 =	PIXMAN_a1r5g5b5,
82    PICT_x1r5g5b5 =	PIXMAN_x1r5g5b5,
83    PICT_a1b5g5r5 =	PIXMAN_a1b5g5r5,
84    PICT_x1b5g5r5 =	PIXMAN_x1b5g5r5,
85    PICT_a4r4g4b4 =	PIXMAN_a4r4g4b4,
86    PICT_x4r4g4b4 =	PIXMAN_x4r4g4b4,
87    PICT_a4b4g4r4 =	PIXMAN_a4b4g4r4,
88    PICT_x4b4g4r4 =	PIXMAN_x4b4g4r4,
89
90/* 8bpp formats */
91    PICT_a8 =		PIXMAN_a8,
92    PICT_r3g3b2 =	PIXMAN_r3g3b2,
93    PICT_b2g3r3 =	PIXMAN_b2g3r3,
94    PICT_a2r2g2b2 =	PIXMAN_a2r2g2b2,
95    PICT_a2b2g2r2 =	PIXMAN_a2b2g2r2,
96
97    PICT_c8 =		PIXMAN_c8,
98    PICT_g8 =		PIXMAN_g8,
99
100    PICT_x4a4 =		PIXMAN_x4a4,
101
102    PICT_x4c4 =		PIXMAN_x4c4,
103    PICT_x4g4 =		PIXMAN_x4g4,
104
105/* 4bpp formats */
106    PICT_a4 =		PIXMAN_a4,
107    PICT_r1g2b1 =	PIXMAN_r1g2b1,
108    PICT_b1g2r1 =	PIXMAN_b1g2r1,
109    PICT_a1r1g1b1 =	PIXMAN_a1r1g1b1,
110    PICT_a1b1g1r1 =	PIXMAN_a1b1g1r1,
111
112    PICT_c4 =		PIXMAN_c4,
113    PICT_g4 =		PIXMAN_g4,
114
115/* 1bpp formats */
116    PICT_a1 =		PIXMAN_a1,
117
118    PICT_g1 =		PIXMAN_g1,
119} PictFormatShort;
120
121/*
122 * For dynamic indexed visuals (GrayScale and PseudoColor), these control the
123 * selection of colors allocated for drawing to Pictures.  The default
124 * policy depends on the size of the colormap:
125 *
126 * Size		Default Policy
127 * ----------------------------
128 *  < 64	PolicyMono
129 *  < 256	PolicyGray
130 *  256		PolicyColor (only on PseudoColor)
131 *
132 * The actual allocation code lives in miindex.c, and so is
133 * austensibly server dependent, but that code does:
134 *
135 * PolicyMono	    Allocate no additional colors, use black and white
136 * PolicyGray	    Allocate 13 gray levels (11 cells used)
137 * PolicyColor	    Allocate a 4x4x4 cube and 13 gray levels (71 cells used)
138 * PolicyAll	    Allocate as big a cube as possible, fill with gray (all)
139 *
140 * Here's a picture to help understand how many colors are
141 * actually allocated (this is just the gray ramp):
142 *
143 *                 gray level
144 * all   0000 1555 2aaa 4000 5555 6aaa 8000 9555 aaaa bfff d555 eaaa ffff
145 * b/w   0000                                                        ffff
146 * 4x4x4                     5555                aaaa
147 * extra      1555 2aaa 4000      6aaa 8000 9555      bfff d555 eaaa
148 *
149 * The default colormap supplies two gray levels (black/white), the
150 * 4x4x4 cube allocates another two and nine more are allocated to fill
151 * in the 13 levels.  When the 4x4x4 cube is not allocated, a total of
152 * 11 cells are allocated.
153 */
154
155#define PictureCmapPolicyInvalid    -1
156#define PictureCmapPolicyDefault    0
157#define PictureCmapPolicyMono	    1
158#define PictureCmapPolicyGray	    2
159#define PictureCmapPolicyColor	    3
160#define PictureCmapPolicyAll	    4
161
162extern int  PictureCmapPolicy;
163
164int	PictureParseCmapPolicy (const char *name);
165
166extern int	RenderErrBase;
167extern int	RenderClientPrivateIndex;
168
169/* Fixed point updates from Carl Worth, USC, Information Sciences Institute */
170
171typedef pixman_fixed_32_32_t	xFixed_32_32;
172
173typedef pixman_fixed_48_16_t	xFixed_48_16;
174
175#define MAX_FIXED_48_16		pixman_max_fixed_48_16
176#define MIN_FIXED_48_16		pixman_min_fixed_48_16
177
178typedef pixman_fixed_1_31_t	xFixed_1_31;
179typedef pixman_fixed_1_16_t	xFixed_1_16;
180typedef pixman_fixed_16_16_t	xFixed_16_16;
181
182/*
183 * An unadorned "xFixed" is the same as xFixed_16_16,
184 * (since it's quite common in the code)
185 */
186typedef	pixman_fixed_t	xFixed;
187#define XFIXED_BITS	16
188
189#define xFixedToInt(f)	pixman_fixed_to_int(f)
190#define IntToxFixed(i)	pixman_int_to_fixed(i)
191#define xFixedE		pixman_fixed_e
192#define xFixed1		pixman_fixed_1
193#define xFixed1MinusE	pixman_fixed_1_minus_e
194#define xFixedFrac(f)	pixman_fixed_frac(f)
195#define xFixedFloor(f)	pixman_fixed_floor(f)
196#define xFixedCeil(f)	pixman_fixed_ceil(f)
197
198#define xFixedFraction(f)	pixman_fixed_fraction(f)
199#define xFixedMod2(f)		pixman_fixed_mod2(f)
200
201/* whether 't' is a well defined not obviously empty trapezoid */
202#define xTrapezoidValid(t)  ((t)->left.p1.y != (t)->left.p2.y && \
203			     (t)->right.p1.y != (t)->right.p2.y && \
204			     (int) ((t)->bottom - (t)->top) > 0)
205
206/*
207 * Standard NTSC luminance conversions:
208 *
209 *  y = r * 0.299 + g * 0.587 + b * 0.114
210 *
211 * Approximate this for a bit more speed:
212 *
213 *  y = (r * 153 + g * 301 + b * 58) / 512
214 *
215 * This gives 17 bits of luminance; to get 15 bits, lop the low two
216 */
217
218#define CvtR8G8B8toY15(s)	(((((s) >> 16) & 0xff) * 153 + \
219				  (((s) >>  8) & 0xff) * 301 + \
220				  (((s)      ) & 0xff) * 58) >> 2)
221
222#endif /* _PICTURE_H_ */
223