1 /* Cairo - a vector graphics library with display and print output
3 * Copyright © 2007 Red Hat, Inc.
5 * This library is free software; you can redistribute it and/or
6 * modify it either under the terms of the GNU Lesser General Public
7 * License version 2.1 as published by the Free Software Foundation
8 * (the "LGPL") or, at your option, under the terms of the Mozilla
9 * Public License Version 1.1 (the "MPL"). If you do not alter this
10 * notice, a recipient may use your version of this file under either
11 * the MPL or the LGPL.
13 * You should have received a copy of the LGPL along with this library
14 * in the file COPYING-LGPL-2.1; if not, write to the Free Software
15 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
16 * You should have received a copy of the MPL along with this library
17 * in the file COPYING-MPL-1.1
19 * The contents of this file are subject to the Mozilla Public License
20 * Version 1.1 (the "License"); you may not use this file except in
21 * compliance with the License. You may obtain a copy of the License at
22 * http://www.mozilla.org/MPL/
24 * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY
25 * OF ANY KIND, either express or implied. See the LGPL or the MPL for
26 * the specific language governing rights and limitations.
28 * The Original Code is the cairo graphics library.
30 * The Initial Developer of the Original Code is Red Hat, Inc.
33 #ifndef CAIRO_XLIB_XRENDER_PRIVATE_H
34 #define CAIRO_XLIB_XRENDER_PRIVATE_H
36 #include "cairo-features.h"
37 #include "cairo-compiler-private.h"
41 #if CAIRO_HAS_XLIB_XRENDER_SURFACE
43 #include "cairo-xlib-xrender.h"
45 #include <X11/extensions/Xrender.h>
46 #include <X11/extensions/renderproto.h>
48 /* We require Render >= 0.6. The following defines were only added in
49 * 0.10. Make sure they are defined.
52 /* Filters included in 0.10 */
53 #ifndef FilterConvolution
54 #define FilterConvolution "convolution"
57 /* Extended repeat attributes included in 0.10 */
60 #define RepeatNormal 1
62 #define RepeatReflect 3
66 #else /* !CAIRO_HAS_XLIB_XRENDER_SURFACE */
68 /* Provide dummy symbols and macros to get it compile and take the fallback
69 * route, just like as if Xrender is not available in the server at run-time. */
74 /* As it happens, it is the case that, all libxrender functions
75 * take a pointer as first argument */
77 __attribute__((__unused__
)) static void _void_consume (void *p
, ...) { }
78 __attribute__((__unused__
)) static void * _voidp_consume (void *p
, ...) { return (void *)0; }
79 __attribute__((__unused__
)) static int _int_consume (void *p
, ...) { return 0; }
80 __attribute__((__unused__
)) static void _void_consume_free (Display
*p
, XID n
) { }
82 #define XRenderQueryExtension _int_consume
83 #define XRenderQueryVersion _int_consume
84 #define XRenderQueryFormats _int_consume
85 #define XRenderQuerySubpixelOrder _int_consume
86 #define XRenderSetSubpixelOrder _int_consume
87 #define XRenderFindVisualFormat _voidp_consume
88 #define XRenderFindFormat _voidp_consume
89 #define XRenderFindStandardFormat _voidp_consume
90 #define XRenderQueryPictIndexValues _voidp_consume
91 #define XRenderCreatePicture _int_consume
92 #define XRenderChangePicture _void_consume
93 #define XRenderSetPictureClipRectangles _void_consume
94 #define XRenderSetPictureClipRegion _void_consume
95 #define XRenderSetPictureTransform _void_consume
96 #define XRenderFreePicture _void_consume_free
97 #define XRenderComposite _void_consume
98 #define XRenderCreateGlyphSet _int_consume
99 #define XRenderReferenceGlyphSet _int_consume
100 #define XRenderFreeGlyphSet _void_consume_free
101 #define XRenderAddGlyphs _void_consume
102 #define XRenderFreeGlyphs _void_consume
103 #define XRenderCompositeString8 _void_consume
104 #define XRenderCompositeString16 _void_consume
105 #define XRenderCompositeString32 _void_consume
106 #define XRenderCompositeText8 (cairo_xrender_composite_text_func_t) _void_consume
107 #define XRenderCompositeText16 _void_consume
108 #define XRenderCompositeText32 _void_consume
109 #define XRenderFillRectangle _void_consume
110 #define XRenderFillRectangles _void_consume
111 #define XRenderCompositeTrapezoids _void_consume
112 #define XRenderCompositeTriangles _void_consume
113 #define XRenderCompositeTriStrip _void_consume
114 #define XRenderCompositeTriFan _void_consume
115 #define XRenderCompositeDoublePoly _void_consume
116 #define XRenderParseColor _int_consume
117 #define XRenderCreateCursor _int_consume
118 #define XRenderQueryFilters _voidp_consume
119 #define XRenderSetPictureFilter _void_consume
120 #define XRenderCreateAnimCursor _int_consume
121 #define XRenderAddTraps _void_consume
122 #define XRenderCreateSolidFill _int_consume
123 #define XRenderCreateLinearGradient _int_consume
124 #define XRenderCreateRadialGradient _int_consume
125 #define XRenderCreateConicalGradient _int_consume
127 #define cairo_xlib_surface_create_with_xrender_format _voidp_consume
131 /* The rest of this file is copied from various Xrender header files, with
132 * the following copyright/license information:
134 * Copyright © 2000 SuSE, Inc.
136 * Permission to use, copy, modify, distribute, and sell this software and its
137 * documentation for any purpose is hereby granted without fee, provided that
138 * the above copyright notice appear in all copies and that both that
139 * copyright notice and this permission notice appear in supporting
140 * documentation, and that the name of SuSE not be used in advertising or
141 * publicity pertaining to distribution of the software without specific,
142 * written prior permission. SuSE makes no representations about the
143 * suitability of this software for any purpose. It is provided "as is"
144 * without express or implied warranty.
146 * SuSE DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL
147 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL SuSE
148 * BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
149 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
150 * OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
151 * CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
153 * Author: Keith Packard, SuSE, Inc.
157 /* Copied from X11/extensions/render.h */
159 typedef unsigned long Glyph
;
160 typedef unsigned long GlyphSet
;
161 typedef unsigned long Picture
;
162 typedef unsigned long PictFormat
;
164 #define BadPictFormat 0
167 #define BadGlyphSet 3
169 #define RenderNumberErrors (BadGlyph+1)
171 #define PictTypeIndexed 0
172 #define PictTypeDirect 1
174 #define PictOpMinimum 0
175 #define PictOpClear 0
179 #define PictOpOverReverse 4
181 #define PictOpInReverse 6
183 #define PictOpOutReverse 8
185 #define PictOpAtopReverse 10
188 #define PictOpSaturate 13
189 #define PictOpMaximum 13
192 * Operators only available in version 0.2
194 #define PictOpDisjointMinimum 0x10
195 #define PictOpDisjointClear 0x10
196 #define PictOpDisjointSrc 0x11
197 #define PictOpDisjointDst 0x12
198 #define PictOpDisjointOver 0x13
199 #define PictOpDisjointOverReverse 0x14
200 #define PictOpDisjointIn 0x15
201 #define PictOpDisjointInReverse 0x16
202 #define PictOpDisjointOut 0x17
203 #define PictOpDisjointOutReverse 0x18
204 #define PictOpDisjointAtop 0x19
205 #define PictOpDisjointAtopReverse 0x1a
206 #define PictOpDisjointXor 0x1b
207 #define PictOpDisjointMaximum 0x1b
209 #define PictOpConjointMinimum 0x20
210 #define PictOpConjointClear 0x20
211 #define PictOpConjointSrc 0x21
212 #define PictOpConjointDst 0x22
213 #define PictOpConjointOver 0x23
214 #define PictOpConjointOverReverse 0x24
215 #define PictOpConjointIn 0x25
216 #define PictOpConjointInReverse 0x26
217 #define PictOpConjointOut 0x27
218 #define PictOpConjointOutReverse 0x28
219 #define PictOpConjointAtop 0x29
220 #define PictOpConjointAtopReverse 0x2a
221 #define PictOpConjointXor 0x2b
222 #define PictOpConjointMaximum 0x2b
224 #define PolyEdgeSharp 0
225 #define PolyEdgeSmooth 1
227 #define PolyModePrecise 0
228 #define PolyModeImprecise 1
230 #define CPRepeat (1 << 0)
231 #define CPAlphaMap (1 << 1)
232 #define CPAlphaXOrigin (1 << 2)
233 #define CPAlphaYOrigin (1 << 3)
234 #define CPClipXOrigin (1 << 4)
235 #define CPClipYOrigin (1 << 5)
236 #define CPClipMask (1 << 6)
237 #define CPGraphicsExposure (1 << 7)
238 #define CPSubwindowMode (1 << 8)
239 #define CPPolyEdge (1 << 9)
240 #define CPPolyMode (1 << 10)
241 #define CPDither (1 << 11)
242 #define CPComponentAlpha (1 << 12)
245 /* Filters included in 0.6 */
246 #define FilterNearest "nearest"
247 #define FilterBilinear "bilinear"
248 /* Filters included in 0.10 */
249 #define FilterConvolution "convolution"
251 #define FilterFast "fast"
252 #define FilterGood "good"
253 #define FilterBest "best"
255 #define FilterAliasNone -1
257 /* Subpixel orders included in 0.6 */
258 #define SubPixelUnknown 0
259 #define SubPixelHorizontalRGB 1
260 #define SubPixelHorizontalBGR 2
261 #define SubPixelVerticalRGB 3
262 #define SubPixelVerticalBGR 4
263 #define SubPixelNone 5
265 /* Extended repeat attributes included in 0.10 */
267 #define RepeatNormal 1
269 #define RepeatReflect 3
273 /* Copied from X11/extensions/Xrender.h */
284 } XRenderDirectFormat
;
290 XRenderDirectFormat direct
;
294 #define PictFormatID (1 << 0)
295 #define PictFormatType (1 << 1)
296 #define PictFormatDepth (1 << 2)
297 #define PictFormatRed (1 << 3)
298 #define PictFormatRedMask (1 << 4)
299 #define PictFormatGreen (1 << 5)
300 #define PictFormatGreenMask (1 << 6)
301 #define PictFormatBlue (1 << 7)
302 #define PictFormatBlueMask (1 << 8)
303 #define PictFormatAlpha (1 << 9)
304 #define PictFormatAlphaMask (1 << 10)
305 #define PictFormatColormap (1 << 11)
307 typedef struct _XRenderPictureAttributes
{
315 Bool graphics_exposures
;
320 Bool component_alpha
;
321 } XRenderPictureAttributes
;
325 unsigned short green
;
327 unsigned short alpha
;
330 typedef struct _XGlyphInfo
{
331 unsigned short width
;
332 unsigned short height
;
339 typedef struct _XGlyphElt8
{
347 typedef struct _XGlyphElt16
{
349 _Xconst
unsigned short *chars
;
355 typedef struct _XGlyphElt32
{
357 _Xconst
unsigned int *chars
;
363 typedef double XDouble
;
365 typedef struct _XPointDouble
{
369 #define XDoubleToFixed(f) ((XFixed) ((f) * 65536))
370 #define XFixedToDouble(f) (((XDouble) (f)) / 65536)
374 typedef struct _XPointFixed
{
378 typedef struct _XLineFixed
{
382 typedef struct _XTriangle
{
383 XPointFixed p1
, p2
, p3
;
386 typedef struct _XCircle
{
392 typedef struct _XTrapezoid
{
394 XLineFixed left
, right
;
397 typedef struct _XTransform
{
401 typedef struct _XFilters
{
408 typedef struct _XIndexValue
{
410 unsigned short red
, green
, blue
, alpha
;
413 typedef struct _XAnimCursor
{
418 typedef struct _XSpanFix
{
419 XFixed left
, right
, y
;
422 typedef struct _XTrap
{
423 XSpanFix top
, bottom
;
426 typedef struct _XLinearGradient
{
431 typedef struct _XRadialGradient
{
436 typedef struct _XConicalGradient
{
438 XFixed angle
; /* in degrees */
441 #define PictStandardARGB32 0
442 #define PictStandardRGB24 1
443 #define PictStandardA8 2
444 #define PictStandardA4 3
445 #define PictStandardA1 4
446 #define PictStandardNUM 5
450 /* Copied from X11/extensions/renderproto.h */
454 #define Window CARD32
455 #define Drawable CARD32
457 #define Pixmap CARD32
458 #define Cursor CARD32
459 #define Colormap CARD32
460 #define GContext CARD32
462 #define VisualID CARD32
464 #define KeyCode CARD8
465 #define KeySym CARD32
467 #define Picture CARD32
468 #define PictFormat CARD32
470 #define Glyphset CARD32
481 CARD16 greenMask B16
;
485 CARD16 alphaMask B16
;
488 #define sz_xDirectFormat 16
495 xDirectFormat direct
;
499 #define sz_xPictFormInfo 28
506 #define sz_xPictVisual 8
511 CARD16 nPictVisuals B16
;
515 #define sz_xPictDepth 8
519 PictFormat fallback B32
;
522 #define sz_xPictScreen 8
532 #define sz_xIndexValue 12
541 #define sz_xRenderColor 8
548 #define sz_xPointFixed 8
555 #define sz_xLineFixed 16
558 xPointFixed p1
, p2
, p3
;
561 #define sz_xTriangle 24
570 #define sz_xTrapezoid 40
581 #define sz_xGlyphInfo 12
591 #define sz_xGlyphElt 8
597 #define sz_xSpanFix 12
606 * requests and replies
612 CARD32 majorVersion B32
;
613 CARD32 minorVersion B32
;
614 } xRenderQueryVersionReq
;
616 #define sz_xRenderQueryVersionReq 12
619 BYTE type
; /* X_Reply */
621 CARD16 sequenceNumber B16
;
623 CARD32 majorVersion B32
;
624 CARD32 minorVersion B32
;
629 } xRenderQueryVersionReply
;
631 #define sz_xRenderQueryVersionReply 32
637 } xRenderQueryPictFormatsReq
;
639 #define sz_xRenderQueryPictFormatsReq 4
642 BYTE type
; /* X_Reply */
644 CARD16 sequenceNumber B16
;
646 CARD32 numFormats B32
;
647 CARD32 numScreens B32
;
648 CARD32 numDepths B32
;
649 CARD32 numVisuals B32
;
650 CARD32 numSubpixel B32
; /* Version 0.6 */
652 } xRenderQueryPictFormatsReply
;
654 #define sz_xRenderQueryPictFormatsReply 32
660 PictFormat format B32
;
661 } xRenderQueryPictIndexValuesReq
;
663 #define sz_xRenderQueryPictIndexValuesReq 8
666 BYTE type
; /* X_Reply */
668 CARD16 sequenceNumber B16
;
670 CARD32 numIndexValues
;
676 } xRenderQueryPictIndexValuesReply
;
678 #define sz_xRenderQueryPictIndexValuesReply 32
685 Drawable drawable B32
;
686 PictFormat format B32
;
688 } xRenderCreatePictureReq
;
690 #define sz_xRenderCreatePictureReq 20
698 } xRenderChangePictureReq
;
700 #define sz_xRenderChangePictureReq 12
709 } xRenderSetPictureClipRectanglesReq
;
711 #define sz_xRenderSetPictureClipRectanglesReq 12
718 } xRenderFreePictureReq
;
720 #define sz_xRenderFreePictureReq 8
740 } xRenderCompositeReq
;
742 #define sz_xRenderCompositeReq 36
750 CARD32 colorScale B32
;
751 CARD32 alphaScale B32
;
760 #define sz_xRenderScaleReq 32
771 PictFormat maskFormat B32
;
774 } xRenderTrapezoidsReq
;
776 #define sz_xRenderTrapezoidsReq 24
787 PictFormat maskFormat B32
;
790 } xRenderTrianglesReq
;
792 #define sz_xRenderTrianglesReq 24
803 PictFormat maskFormat B32
;
806 } xRenderTriStripReq
;
808 #define sz_xRenderTriStripReq 24
819 PictFormat maskFormat B32
;
824 #define sz_xRenderTriFanReq 24
831 PictFormat format B32
;
832 } xRenderCreateGlyphSetReq
;
834 #define sz_xRenderCreateGlyphSetReq 12
841 Glyphset existing B32
;
842 } xRenderReferenceGlyphSetReq
;
844 #define sz_xRenderReferenceGlyphSetReq 24
850 Glyphset glyphset B32
;
851 } xRenderFreeGlyphSetReq
;
853 #define sz_xRenderFreeGlyphSetReq 8
859 Glyphset glyphset B32
;
861 } xRenderAddGlyphsReq
;
863 #define sz_xRenderAddGlyphsReq 12
869 Glyphset glyphset B32
;
870 } xRenderFreeGlyphsReq
;
872 #define sz_xRenderFreeGlyphsReq 8
883 PictFormat maskFormat B32
;
884 Glyphset glyphset B32
;
887 } xRenderCompositeGlyphsReq
, xRenderCompositeGlyphs8Req
,
888 xRenderCompositeGlyphs16Req
, xRenderCompositeGlyphs32Req
;
890 #define sz_xRenderCompositeGlyphs8Req 28
891 #define sz_xRenderCompositeGlyphs16Req 28
892 #define sz_xRenderCompositeGlyphs32Req 28
905 } xRenderFillRectanglesReq
;
907 #define sz_xRenderFillRectanglesReq 20
919 } xRenderCreateCursorReq
;
921 #define sz_xRenderCreateCursorReq 16
926 * This can't use an array because 32-bit values may be in bitfields
940 #define sz_xRenderTransform 36
947 xRenderTransform transform
;
948 } xRenderSetPictureTransformReq
;
950 #define sz_xRenderSetPictureTransformReq 44
956 Drawable drawable B32
;
957 } xRenderQueryFiltersReq
;
959 #define sz_xRenderQueryFiltersReq 8
962 BYTE type
; /* X_Reply */
964 CARD16 sequenceNumber B16
;
966 CARD32 numAliases B32
; /* LISTofCARD16 */
967 CARD32 numFilters B32
; /* LISTofSTRING8 */
972 } xRenderQueryFiltersReply
;
974 #define sz_xRenderQueryFiltersReply 32
981 CARD16 nbytes B16
; /* number of bytes in name */
983 } xRenderSetPictureFilterReq
;
985 #define sz_xRenderSetPictureFilterReq 12
994 #define sz_xAnimCursorElt 8
1001 } xRenderCreateAnimCursorReq
;
1003 #define sz_xRenderCreateAnimCursorReq 8
1005 /* 0.9 and higher */
1009 CARD8 renderReqType
;
1014 } xRenderAddTrapsReq
;
1016 #define sz_xRenderAddTrapsReq 12
1018 /* 0.10 and higher */
1022 CARD8 renderReqType
;
1026 } xRenderCreateSolidFillReq
;
1028 #define sz_xRenderCreateSolidFillReq 16
1032 CARD8 renderReqType
;
1038 } xRenderCreateLinearGradientReq
;
1040 #define sz_xRenderCreateLinearGradientReq 28
1044 CARD8 renderReqType
;
1052 } xRenderCreateRadialGradientReq
;
1054 #define sz_xRenderCreateRadialGradientReq 36
1058 CARD8 renderReqType
;
1062 Fixed angle
; /* in degrees */
1064 } xRenderCreateConicalGradientReq
;
1066 #define sz_xRenderCreateConicalGradientReq 24
1088 #endif /* CAIRO_HAS_XLIB_XRENDER_SURFACE */
1090 #endif /* CAIRO_XLIB_XRENDER_PRIVATE_H */