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., 51 Franklin Street, Suite 500, Boston, MA 02110-1335, 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 /* These prototypes are used when defining interfaces missing from the
42 * render headers. As it happens, it is the case that all libxrender
43 * functions take a pointer as first argument. */
45 __attribute__((__unused__
)) static void _void_consume (void *p
, ...) { }
46 __attribute__((__unused__
)) static void * _voidp_consume (void *p
, ...) { return (void *)0; }
47 __attribute__((__unused__
)) static int _int_consume (void *p
, ...) { return 0; }
48 __attribute__((__unused__
)) static void _void_consume_free (Display
*p
, XID n
) { }
51 #if CAIRO_HAS_XLIB_XRENDER_SURFACE
53 #include "cairo-xlib-xrender.h"
55 #include <X11/extensions/Xrender.h>
56 #include <X11/extensions/renderproto.h>
58 /* We require Render >= 0.6. The following defines were only added in
59 * 0.10. Make sure they are defined.
62 /* Filters included in 0.10 */
63 #ifndef FilterConvolution
64 #define FilterConvolution "convolution"
67 /* Extended repeat attributes included in 0.10 */
70 #define RepeatNormal 1
72 #define RepeatReflect 3
76 #ifndef PictOptBlendMinimum
78 * Operators only available in version 0.11
80 #define PictOpBlendMinimum 0x30
81 #define PictOpMultiply 0x30
82 #define PictOpScreen 0x31
83 #define PictOpOverlay 0x32
84 #define PictOpDarken 0x33
85 #define PictOpLighten 0x34
86 #define PictOpColorDodge 0x35
87 #define PictOpColorBurn 0x36
88 #define PictOpHardLight 0x37
89 #define PictOpSoftLight 0x38
90 #define PictOpDifference 0x39
91 #define PictOpExclusion 0x3a
92 #define PictOpHSLHue 0x3b
93 #define PictOpHSLSaturation 0x3c
94 #define PictOpHSLColor 0x3d
95 #define PictOpHSLLuminosity 0x3e
96 #define PictOpBlendMaximum 0x3e
99 #if !HAVE_XRENDERCREATESOLIDFILL
100 #define XRenderCreateSolidFill _int_consume
103 #if !HAVE_XRENDERCREATELINEARGRADIENT
104 #define XRenderCreateLinearGradient _int_consume
106 typedef struct _XLinearGradient
{
112 #if !HAVE_XRENDERCREATERADIALGRADIENT
113 #define XRenderCreateRadialGradient _int_consume
115 typedef struct _XCircle
{
120 typedef struct _XRadialGradient
{
126 #if !HAVE_XRENDERCREATECONICALGRADIENT
127 #define XRenderCreateConicalGradient _int_consume
129 typedef struct _XConicalGradient
{
131 XFixed angle
; /* in degrees */
136 #else /* !CAIRO_HAS_XLIB_XRENDER_SURFACE */
138 /* Provide dummy symbols and macros to get it compile and take the fallback
139 * route, just like as if Xrender is not available in the server at run-time. */
144 #define XRenderQueryExtension _int_consume
145 #define XRenderQueryVersion _int_consume
146 #define XRenderQueryFormats _int_consume
147 #define XRenderQuerySubpixelOrder _int_consume
148 #define XRenderSetSubpixelOrder _int_consume
149 #define XRenderFindVisualFormat _voidp_consume
150 #define XRenderFindFormat _voidp_consume
151 #define XRenderFindStandardFormat _voidp_consume
152 #define XRenderQueryPictIndexValues _voidp_consume
153 #define XRenderCreatePicture _int_consume
154 #define XRenderChangePicture _void_consume
155 #define XRenderSetPictureClipRectangles _void_consume
156 #define XRenderSetPictureClipRegion _void_consume
157 #define XRenderSetPictureTransform _void_consume
158 #define XRenderFreePicture _void_consume_free
159 #define XRenderComposite _void_consume
160 #define XRenderCreateGlyphSet _int_consume
161 #define XRenderReferenceGlyphSet _int_consume
162 #define XRenderFreeGlyphSet _void_consume_free
163 #define XRenderAddGlyphs _void_consume
164 #define XRenderFreeGlyphs _void_consume
165 #define XRenderCompositeString8 _void_consume
166 #define XRenderCompositeString16 _void_consume
167 #define XRenderCompositeString32 _void_consume
168 #define XRenderCompositeText8 (cairo_xrender_composite_text_func_t) _void_consume
169 #define XRenderCompositeText16 _void_consume
170 #define XRenderCompositeText32 _void_consume
171 #define XRenderFillRectangle _void_consume
172 #define XRenderFillRectangles _void_consume
173 #define XRenderCompositeTrapezoids _void_consume
174 #define XRenderCompositeTriangles _void_consume
175 #define XRenderCompositeTriStrip _void_consume
176 #define XRenderCompositeTriFan _void_consume
177 #define XRenderCompositeDoublePoly _void_consume
178 #define XRenderParseColor _int_consume
179 #define XRenderCreateCursor _int_consume
180 #define XRenderQueryFilters _voidp_consume
181 #define XRenderSetPictureFilter _void_consume
182 #define XRenderCreateAnimCursor _int_consume
183 #define XRenderAddTraps _void_consume
184 #define XRenderCreateSolidFill _int_consume
185 #define XRenderCreateLinearGradient _int_consume
186 #define XRenderCreateRadialGradient _int_consume
187 #define XRenderCreateConicalGradient _int_consume
189 #define cairo_xlib_surface_create_with_xrender_format _voidp_consume
193 /* The rest of this file is copied from various Xrender header files, with
194 * the following copyright/license information:
196 * Copyright © 2000 SuSE, Inc.
198 * Permission to use, copy, modify, distribute, and sell this software and its
199 * documentation for any purpose is hereby granted without fee, provided that
200 * the above copyright notice appear in all copies and that both that
201 * copyright notice and this permission notice appear in supporting
202 * documentation, and that the name of SuSE not be used in advertising or
203 * publicity pertaining to distribution of the software without specific,
204 * written prior permission. SuSE makes no representations about the
205 * suitability of this software for any purpose. It is provided "as is"
206 * without express or implied warranty.
208 * SuSE DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL
209 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL SuSE
210 * BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
211 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
212 * OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
213 * CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
215 * Author: Keith Packard, SuSE, Inc.
219 /* Copied from X11/extensions/render.h */
221 typedef unsigned long Glyph
;
222 typedef unsigned long GlyphSet
;
223 typedef unsigned long Picture
;
224 typedef unsigned long PictFormat
;
226 #define BadPictFormat 0
229 #define BadGlyphSet 3
231 #define RenderNumberErrors (BadGlyph+1)
233 #define PictTypeIndexed 0
234 #define PictTypeDirect 1
236 #define PictOpMinimum 0
237 #define PictOpClear 0
241 #define PictOpOverReverse 4
243 #define PictOpInReverse 6
245 #define PictOpOutReverse 8
247 #define PictOpAtopReverse 10
250 #define PictOpSaturate 13
251 #define PictOpMaximum 13
254 * Operators only available in version 0.2
256 #define PictOpDisjointMinimum 0x10
257 #define PictOpDisjointClear 0x10
258 #define PictOpDisjointSrc 0x11
259 #define PictOpDisjointDst 0x12
260 #define PictOpDisjointOver 0x13
261 #define PictOpDisjointOverReverse 0x14
262 #define PictOpDisjointIn 0x15
263 #define PictOpDisjointInReverse 0x16
264 #define PictOpDisjointOut 0x17
265 #define PictOpDisjointOutReverse 0x18
266 #define PictOpDisjointAtop 0x19
267 #define PictOpDisjointAtopReverse 0x1a
268 #define PictOpDisjointXor 0x1b
269 #define PictOpDisjointMaximum 0x1b
271 #define PictOpConjointMinimum 0x20
272 #define PictOpConjointClear 0x20
273 #define PictOpConjointSrc 0x21
274 #define PictOpConjointDst 0x22
275 #define PictOpConjointOver 0x23
276 #define PictOpConjointOverReverse 0x24
277 #define PictOpConjointIn 0x25
278 #define PictOpConjointInReverse 0x26
279 #define PictOpConjointOut 0x27
280 #define PictOpConjointOutReverse 0x28
281 #define PictOpConjointAtop 0x29
282 #define PictOpConjointAtopReverse 0x2a
283 #define PictOpConjointXor 0x2b
284 #define PictOpConjointMaximum 0x2b
287 * Operators only available in version 0.11
289 #define PictOpBlendMinimum 0x30
290 #define PictOpMultiply 0x30
291 #define PictOpScreen 0x31
292 #define PictOpOverlay 0x32
293 #define PictOpDarken 0x33
294 #define PictOpLighten 0x34
295 #define PictOpColorDodge 0x35
296 #define PictOpColorBurn 0x36
297 #define PictOpHardLight 0x37
298 #define PictOpSoftLight 0x38
299 #define PictOpDifference 0x39
300 #define PictOpExclusion 0x3a
301 #define PictOpHSLHue 0x3b
302 #define PictOpHSLSaturation 0x3c
303 #define PictOpHSLColor 0x3d
304 #define PictOpHSLLuminosity 0x3e
305 #define PictOpBlendMaximum 0x3e
307 #define PolyEdgeSharp 0
308 #define PolyEdgeSmooth 1
310 #define PolyModePrecise 0
311 #define PolyModeImprecise 1
313 #define CPRepeat (1 << 0)
314 #define CPAlphaMap (1 << 1)
315 #define CPAlphaXOrigin (1 << 2)
316 #define CPAlphaYOrigin (1 << 3)
317 #define CPClipXOrigin (1 << 4)
318 #define CPClipYOrigin (1 << 5)
319 #define CPClipMask (1 << 6)
320 #define CPGraphicsExposure (1 << 7)
321 #define CPSubwindowMode (1 << 8)
322 #define CPPolyEdge (1 << 9)
323 #define CPPolyMode (1 << 10)
324 #define CPDither (1 << 11)
325 #define CPComponentAlpha (1 << 12)
328 /* Filters included in 0.6 */
329 #define FilterNearest "nearest"
330 #define FilterBilinear "bilinear"
331 /* Filters included in 0.10 */
332 #define FilterConvolution "convolution"
334 #define FilterFast "fast"
335 #define FilterGood "good"
336 #define FilterBest "best"
338 #define FilterAliasNone -1
340 /* Subpixel orders included in 0.6 */
341 #define SubPixelUnknown 0
342 #define SubPixelHorizontalRGB 1
343 #define SubPixelHorizontalBGR 2
344 #define SubPixelVerticalRGB 3
345 #define SubPixelVerticalBGR 4
346 #define SubPixelNone 5
348 /* Extended repeat attributes included in 0.10 */
350 #define RepeatNormal 1
352 #define RepeatReflect 3
356 /* Copied from X11/extensions/Xrender.h */
367 } XRenderDirectFormat
;
373 XRenderDirectFormat direct
;
377 #define PictFormatID (1 << 0)
378 #define PictFormatType (1 << 1)
379 #define PictFormatDepth (1 << 2)
380 #define PictFormatRed (1 << 3)
381 #define PictFormatRedMask (1 << 4)
382 #define PictFormatGreen (1 << 5)
383 #define PictFormatGreenMask (1 << 6)
384 #define PictFormatBlue (1 << 7)
385 #define PictFormatBlueMask (1 << 8)
386 #define PictFormatAlpha (1 << 9)
387 #define PictFormatAlphaMask (1 << 10)
388 #define PictFormatColormap (1 << 11)
390 typedef struct _XRenderPictureAttributes
{
398 Bool graphics_exposures
;
403 Bool component_alpha
;
404 } XRenderPictureAttributes
;
408 unsigned short green
;
410 unsigned short alpha
;
413 typedef struct _XGlyphInfo
{
414 unsigned short width
;
415 unsigned short height
;
422 typedef struct _XGlyphElt8
{
430 typedef struct _XGlyphElt16
{
432 _Xconst
unsigned short *chars
;
438 typedef struct _XGlyphElt32
{
440 _Xconst
unsigned int *chars
;
446 typedef double XDouble
;
448 typedef struct _XPointDouble
{
452 #define XDoubleToFixed(f) ((XFixed) ((f) * 65536))
453 #define XFixedToDouble(f) (((XDouble) (f)) / 65536)
457 typedef struct _XPointFixed
{
461 typedef struct _XLineFixed
{
465 typedef struct _XTriangle
{
466 XPointFixed p1
, p2
, p3
;
469 typedef struct _XCircle
{
475 typedef struct _XTrapezoid
{
477 XLineFixed left
, right
;
480 typedef struct _XTransform
{
484 typedef struct _XFilters
{
491 typedef struct _XIndexValue
{
493 unsigned short red
, green
, blue
, alpha
;
496 typedef struct _XAnimCursor
{
501 typedef struct _XSpanFix
{
502 XFixed left
, right
, y
;
505 typedef struct _XTrap
{
506 XSpanFix top
, bottom
;
509 typedef struct _XLinearGradient
{
514 typedef struct _XRadialGradient
{
519 typedef struct _XConicalGradient
{
521 XFixed angle
; /* in degrees */
524 #define PictStandardARGB32 0
525 #define PictStandardRGB24 1
526 #define PictStandardA8 2
527 #define PictStandardA4 3
528 #define PictStandardA1 4
529 #define PictStandardNUM 5
533 /* Copied from X11/extensions/renderproto.h */
537 #define Window CARD32
538 #define Drawable CARD32
540 #define Pixmap CARD32
541 #define Cursor CARD32
542 #define Colormap CARD32
543 #define GContext CARD32
545 #define VisualID CARD32
547 #define KeyCode CARD8
548 #define KeySym CARD32
550 #define Picture CARD32
551 #define PictFormat CARD32
553 #define Glyphset CARD32
564 CARD16 greenMask B16
;
568 CARD16 alphaMask B16
;
571 #define sz_xDirectFormat 16
578 xDirectFormat direct
;
582 #define sz_xPictFormInfo 28
589 #define sz_xPictVisual 8
594 CARD16 nPictVisuals B16
;
598 #define sz_xPictDepth 8
602 PictFormat fallback B32
;
605 #define sz_xPictScreen 8
615 #define sz_xIndexValue 12
624 #define sz_xRenderColor 8
631 #define sz_xPointFixed 8
638 #define sz_xLineFixed 16
641 xPointFixed p1
, p2
, p3
;
644 #define sz_xTriangle 24
653 #define sz_xTrapezoid 40
664 #define sz_xGlyphInfo 12
674 #define sz_xGlyphElt 8
680 #define sz_xSpanFix 12
689 * requests and replies
695 CARD32 majorVersion B32
;
696 CARD32 minorVersion B32
;
697 } xRenderQueryVersionReq
;
699 #define sz_xRenderQueryVersionReq 12
702 BYTE type
; /* X_Reply */
704 CARD16 sequenceNumber B16
;
706 CARD32 majorVersion B32
;
707 CARD32 minorVersion B32
;
712 } xRenderQueryVersionReply
;
714 #define sz_xRenderQueryVersionReply 32
720 } xRenderQueryPictFormatsReq
;
722 #define sz_xRenderQueryPictFormatsReq 4
725 BYTE type
; /* X_Reply */
727 CARD16 sequenceNumber B16
;
729 CARD32 numFormats B32
;
730 CARD32 numScreens B32
;
731 CARD32 numDepths B32
;
732 CARD32 numVisuals B32
;
733 CARD32 numSubpixel B32
; /* Version 0.6 */
735 } xRenderQueryPictFormatsReply
;
737 #define sz_xRenderQueryPictFormatsReply 32
743 PictFormat format B32
;
744 } xRenderQueryPictIndexValuesReq
;
746 #define sz_xRenderQueryPictIndexValuesReq 8
749 BYTE type
; /* X_Reply */
751 CARD16 sequenceNumber B16
;
753 CARD32 numIndexValues
;
759 } xRenderQueryPictIndexValuesReply
;
761 #define sz_xRenderQueryPictIndexValuesReply 32
768 Drawable drawable B32
;
769 PictFormat format B32
;
771 } xRenderCreatePictureReq
;
773 #define sz_xRenderCreatePictureReq 20
781 } xRenderChangePictureReq
;
783 #define sz_xRenderChangePictureReq 12
792 } xRenderSetPictureClipRectanglesReq
;
794 #define sz_xRenderSetPictureClipRectanglesReq 12
801 } xRenderFreePictureReq
;
803 #define sz_xRenderFreePictureReq 8
823 } xRenderCompositeReq
;
825 #define sz_xRenderCompositeReq 36
833 CARD32 colorScale B32
;
834 CARD32 alphaScale B32
;
843 #define sz_xRenderScaleReq 32
854 PictFormat maskFormat B32
;
857 } xRenderTrapezoidsReq
;
859 #define sz_xRenderTrapezoidsReq 24
870 PictFormat maskFormat B32
;
873 } xRenderTrianglesReq
;
875 #define sz_xRenderTrianglesReq 24
886 PictFormat maskFormat B32
;
889 } xRenderTriStripReq
;
891 #define sz_xRenderTriStripReq 24
902 PictFormat maskFormat B32
;
907 #define sz_xRenderTriFanReq 24
914 PictFormat format B32
;
915 } xRenderCreateGlyphSetReq
;
917 #define sz_xRenderCreateGlyphSetReq 12
924 Glyphset existing B32
;
925 } xRenderReferenceGlyphSetReq
;
927 #define sz_xRenderReferenceGlyphSetReq 24
933 Glyphset glyphset B32
;
934 } xRenderFreeGlyphSetReq
;
936 #define sz_xRenderFreeGlyphSetReq 8
942 Glyphset glyphset B32
;
944 } xRenderAddGlyphsReq
;
946 #define sz_xRenderAddGlyphsReq 12
952 Glyphset glyphset B32
;
953 } xRenderFreeGlyphsReq
;
955 #define sz_xRenderFreeGlyphsReq 8
966 PictFormat maskFormat B32
;
967 Glyphset glyphset B32
;
970 } xRenderCompositeGlyphsReq
, xRenderCompositeGlyphs8Req
,
971 xRenderCompositeGlyphs16Req
, xRenderCompositeGlyphs32Req
;
973 #define sz_xRenderCompositeGlyphs8Req 28
974 #define sz_xRenderCompositeGlyphs16Req 28
975 #define sz_xRenderCompositeGlyphs32Req 28
988 } xRenderFillRectanglesReq
;
990 #define sz_xRenderFillRectanglesReq 20
1002 } xRenderCreateCursorReq
;
1004 #define sz_xRenderCreateCursorReq 16
1006 /* 0.6 and higher */
1009 * This can't use an array because 32-bit values may be in bitfields
1023 #define sz_xRenderTransform 36
1027 CARD8 renderReqType
;
1029 Picture picture B32
;
1030 xRenderTransform transform
;
1031 } xRenderSetPictureTransformReq
;
1033 #define sz_xRenderSetPictureTransformReq 44
1037 CARD8 renderReqType
;
1039 Drawable drawable B32
;
1040 } xRenderQueryFiltersReq
;
1042 #define sz_xRenderQueryFiltersReq 8
1045 BYTE type
; /* X_Reply */
1047 CARD16 sequenceNumber B16
;
1049 CARD32 numAliases B32
; /* LISTofCARD16 */
1050 CARD32 numFilters B32
; /* LISTofSTRING8 */
1055 } xRenderQueryFiltersReply
;
1057 #define sz_xRenderQueryFiltersReply 32
1061 CARD8 renderReqType
;
1063 Picture picture B32
;
1064 CARD16 nbytes B16
; /* number of bytes in name */
1066 } xRenderSetPictureFilterReq
;
1068 #define sz_xRenderSetPictureFilterReq 12
1070 /* 0.8 and higher */
1077 #define sz_xAnimCursorElt 8
1081 CARD8 renderReqType
;
1084 } xRenderCreateAnimCursorReq
;
1086 #define sz_xRenderCreateAnimCursorReq 8
1088 /* 0.9 and higher */
1092 CARD8 renderReqType
;
1097 } xRenderAddTrapsReq
;
1099 #define sz_xRenderAddTrapsReq 12
1101 /* 0.10 and higher */
1105 CARD8 renderReqType
;
1109 } xRenderCreateSolidFillReq
;
1111 #define sz_xRenderCreateSolidFillReq 16
1115 CARD8 renderReqType
;
1121 } xRenderCreateLinearGradientReq
;
1123 #define sz_xRenderCreateLinearGradientReq 28
1127 CARD8 renderReqType
;
1135 } xRenderCreateRadialGradientReq
;
1137 #define sz_xRenderCreateRadialGradientReq 36
1141 CARD8 renderReqType
;
1145 Fixed angle
; /* in degrees */
1147 } xRenderCreateConicalGradientReq
;
1149 #define sz_xRenderCreateConicalGradientReq 24
1171 #endif /* CAIRO_HAS_XLIB_XRENDER_SURFACE */
1173 #endif /* CAIRO_XLIB_XRENDER_PRIVATE_H */