1/* $Revision: 9203 $ on $Date:: 2009-10-07 02:21:52 -0700 #$ */
2
3/*------------------------------------------------------------------------
4 *
5 * OpenVG 1.1 Reference Implementation
6 * -------------------------------------
7 *
8 * Copyright (c) 2008 The Khronos Group Inc.
9 *
10 * Permission is hereby granted, free of charge, to any person obtaining a
11 * copy of this software and /or associated documentation files
12 * (the "Materials "), to deal in the Materials without restriction,
13 * including without limitation the rights to use, copy, modify, merge,
14 * publish, distribute, sublicense, and/or sell copies of the Materials,
15 * and to permit persons to whom the Materials are furnished to do so,
16 * subject to the following conditions:
17 *
18 * The above copyright notice and this permission notice shall be included
19 * in all copies or substantial portions of the Materials.
20 *
21 * THE MATERIALS ARE PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
22 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
23 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
24 * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
25 * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
26 * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE MATERIALS OR
27 * THE USE OR OTHER DEALINGS IN THE MATERIALS.
28 *
29 *//**
30 * \file
31 * \brief	OpenVG 1.1 API.
32 *//*-------------------------------------------------------------------*/
33
34#ifndef _OPENVG_H
35#define _OPENVG_H
36
37#include <VG/vgplatform.h>
38
39#ifdef __cplusplus
40extern "C" {
41#endif
42
43#define OPENVG_VERSION_1_0		1
44#define OPENVG_VERSION_1_0_1	1
45#define OPENVG_VERSION_1_1		2
46
47#ifndef VG_MAXSHORT
48#define VG_MAXSHORT 0x7FFF
49#endif
50
51#ifndef VG_MAXINT
52#define VG_MAXINT 0x7FFFFFFF
53#endif
54
55#ifndef VG_MAX_ENUM
56#define VG_MAX_ENUM 0x7FFFFFFF
57#endif
58
59typedef VGuint VGHandle;
60
61typedef VGHandle VGPath;
62typedef VGHandle VGImage;
63typedef VGHandle VGMaskLayer;
64typedef VGHandle VGFont;
65typedef VGHandle VGPaint;
66
67#define VG_INVALID_HANDLE ((VGHandle)0)
68
69typedef enum {
70  VG_FALSE               = 0,
71  VG_TRUE                = 1,
72
73  VG_BOOLEAN_FORCE_SIZE  = VG_MAX_ENUM
74} VGboolean;
75
76typedef enum {
77  VG_NO_ERROR                                 = 0,
78  VG_BAD_HANDLE_ERROR                         = 0x1000,
79  VG_ILLEGAL_ARGUMENT_ERROR                   = 0x1001,
80  VG_OUT_OF_MEMORY_ERROR                      = 0x1002,
81  VG_PATH_CAPABILITY_ERROR                    = 0x1003,
82  VG_UNSUPPORTED_IMAGE_FORMAT_ERROR           = 0x1004,
83  VG_UNSUPPORTED_PATH_FORMAT_ERROR            = 0x1005,
84  VG_IMAGE_IN_USE_ERROR                       = 0x1006,
85  VG_NO_CONTEXT_ERROR                         = 0x1007,
86
87  VG_ERROR_CODE_FORCE_SIZE                    = VG_MAX_ENUM
88} VGErrorCode;
89
90typedef enum {
91  /* Mode settings */
92  VG_MATRIX_MODE                              = 0x1100,
93  VG_FILL_RULE                                = 0x1101,
94  VG_IMAGE_QUALITY                            = 0x1102,
95  VG_RENDERING_QUALITY                        = 0x1103,
96  VG_BLEND_MODE                               = 0x1104,
97  VG_IMAGE_MODE                               = 0x1105,
98
99  /* Scissoring rectangles */
100  VG_SCISSOR_RECTS                            = 0x1106,
101
102  /* Color Transformation */
103  VG_COLOR_TRANSFORM                          = 0x1170,
104  VG_COLOR_TRANSFORM_VALUES                   = 0x1171,
105
106  /* Stroke parameters */
107  VG_STROKE_LINE_WIDTH                        = 0x1110,
108  VG_STROKE_CAP_STYLE                         = 0x1111,
109  VG_STROKE_JOIN_STYLE                        = 0x1112,
110  VG_STROKE_MITER_LIMIT                       = 0x1113,
111  VG_STROKE_DASH_PATTERN                      = 0x1114,
112  VG_STROKE_DASH_PHASE                        = 0x1115,
113  VG_STROKE_DASH_PHASE_RESET                  = 0x1116,
114
115  /* Edge fill color for VG_TILE_FILL tiling mode */
116  VG_TILE_FILL_COLOR                          = 0x1120,
117
118  /* Color for vgClear */
119  VG_CLEAR_COLOR                              = 0x1121,
120
121  /* Glyph origin */
122  VG_GLYPH_ORIGIN                             = 0x1122,
123
124  /* Enable/disable alpha masking and scissoring */
125  VG_MASKING                                  = 0x1130,
126  VG_SCISSORING                               = 0x1131,
127
128  /* Pixel layout information */
129  VG_PIXEL_LAYOUT                             = 0x1140,
130  VG_SCREEN_LAYOUT                            = 0x1141,
131
132  /* Source format selection for image filters */
133  VG_FILTER_FORMAT_LINEAR                     = 0x1150,
134  VG_FILTER_FORMAT_PREMULTIPLIED              = 0x1151,
135
136  /* Destination write enable mask for image filters */
137  VG_FILTER_CHANNEL_MASK                      = 0x1152,
138
139  /* Implementation limits (read-only) */
140  VG_MAX_SCISSOR_RECTS                        = 0x1160,
141  VG_MAX_DASH_COUNT                           = 0x1161,
142  VG_MAX_KERNEL_SIZE                          = 0x1162,
143  VG_MAX_SEPARABLE_KERNEL_SIZE                = 0x1163,
144  VG_MAX_COLOR_RAMP_STOPS                     = 0x1164,
145  VG_MAX_IMAGE_WIDTH                          = 0x1165,
146  VG_MAX_IMAGE_HEIGHT                         = 0x1166,
147  VG_MAX_IMAGE_PIXELS                         = 0x1167,
148  VG_MAX_IMAGE_BYTES                          = 0x1168,
149  VG_MAX_FLOAT                                = 0x1169,
150  VG_MAX_GAUSSIAN_STD_DEVIATION               = 0x116A,
151
152  VG_PARAM_TYPE_FORCE_SIZE                    = VG_MAX_ENUM
153} VGParamType;
154
155typedef enum {
156  VG_RENDERING_QUALITY_NONANTIALIASED         = 0x1200,
157  VG_RENDERING_QUALITY_FASTER                 = 0x1201,
158  VG_RENDERING_QUALITY_BETTER                 = 0x1202, /* Default */
159
160  VG_RENDERING_QUALITY_FORCE_SIZE             = VG_MAX_ENUM
161} VGRenderingQuality;
162
163typedef enum {
164  VG_PIXEL_LAYOUT_UNKNOWN                     = 0x1300,
165  VG_PIXEL_LAYOUT_RGB_VERTICAL                = 0x1301,
166  VG_PIXEL_LAYOUT_BGR_VERTICAL                = 0x1302,
167  VG_PIXEL_LAYOUT_RGB_HORIZONTAL              = 0x1303,
168  VG_PIXEL_LAYOUT_BGR_HORIZONTAL              = 0x1304,
169
170  VG_PIXEL_LAYOUT_FORCE_SIZE                  = VG_MAX_ENUM
171} VGPixelLayout;
172
173typedef enum {
174  VG_MATRIX_PATH_USER_TO_SURFACE              = 0x1400,
175  VG_MATRIX_IMAGE_USER_TO_SURFACE             = 0x1401,
176  VG_MATRIX_FILL_PAINT_TO_USER                = 0x1402,
177  VG_MATRIX_STROKE_PAINT_TO_USER              = 0x1403,
178  VG_MATRIX_GLYPH_USER_TO_SURFACE             = 0x1404,
179
180  VG_MATRIX_MODE_FORCE_SIZE                   = VG_MAX_ENUM
181} VGMatrixMode;
182
183typedef enum {
184  VG_CLEAR_MASK                               = 0x1500,
185  VG_FILL_MASK                                = 0x1501,
186  VG_SET_MASK                                 = 0x1502,
187  VG_UNION_MASK                               = 0x1503,
188  VG_INTERSECT_MASK                           = 0x1504,
189  VG_SUBTRACT_MASK                            = 0x1505,
190
191  VG_MASK_OPERATION_FORCE_SIZE                = VG_MAX_ENUM
192} VGMaskOperation;
193
194#define VG_PATH_FORMAT_STANDARD 0
195
196typedef enum {
197  VG_PATH_DATATYPE_S_8                        =  0,
198  VG_PATH_DATATYPE_S_16                       =  1,
199  VG_PATH_DATATYPE_S_32                       =  2,
200  VG_PATH_DATATYPE_F                          =  3,
201
202  VG_PATH_DATATYPE_FORCE_SIZE                 = VG_MAX_ENUM
203} VGPathDatatype;
204
205typedef enum {
206  VG_ABSOLUTE                                 = 0,
207  VG_RELATIVE                                 = 1,
208
209  VG_PATH_ABS_REL_FORCE_SIZE                  = VG_MAX_ENUM
210} VGPathAbsRel;
211
212typedef enum {
213  VG_CLOSE_PATH                               = ( 0 << 1),
214  VG_MOVE_TO                                  = ( 1 << 1),
215  VG_LINE_TO                                  = ( 2 << 1),
216  VG_HLINE_TO                                 = ( 3 << 1),
217  VG_VLINE_TO                                 = ( 4 << 1),
218  VG_QUAD_TO                                  = ( 5 << 1),
219  VG_CUBIC_TO                                 = ( 6 << 1),
220  VG_SQUAD_TO                                 = ( 7 << 1),
221  VG_SCUBIC_TO                                = ( 8 << 1),
222  VG_SCCWARC_TO                               = ( 9 << 1),
223  VG_SCWARC_TO                                = (10 << 1),
224  VG_LCCWARC_TO                               = (11 << 1),
225  VG_LCWARC_TO                                = (12 << 1),
226
227  VG_PATH_SEGMENT_FORCE_SIZE                  = VG_MAX_ENUM
228} VGPathSegment;
229
230typedef enum {
231  VG_MOVE_TO_ABS                              = VG_MOVE_TO    | VG_ABSOLUTE,
232  VG_MOVE_TO_REL                              = VG_MOVE_TO    | VG_RELATIVE,
233  VG_LINE_TO_ABS                              = VG_LINE_TO    | VG_ABSOLUTE,
234  VG_LINE_TO_REL                              = VG_LINE_TO    | VG_RELATIVE,
235  VG_HLINE_TO_ABS                             = VG_HLINE_TO   | VG_ABSOLUTE,
236  VG_HLINE_TO_REL                             = VG_HLINE_TO   | VG_RELATIVE,
237  VG_VLINE_TO_ABS                             = VG_VLINE_TO   | VG_ABSOLUTE,
238  VG_VLINE_TO_REL                             = VG_VLINE_TO   | VG_RELATIVE,
239  VG_QUAD_TO_ABS                              = VG_QUAD_TO    | VG_ABSOLUTE,
240  VG_QUAD_TO_REL                              = VG_QUAD_TO    | VG_RELATIVE,
241  VG_CUBIC_TO_ABS                             = VG_CUBIC_TO   | VG_ABSOLUTE,
242  VG_CUBIC_TO_REL                             = VG_CUBIC_TO   | VG_RELATIVE,
243  VG_SQUAD_TO_ABS                             = VG_SQUAD_TO   | VG_ABSOLUTE,
244  VG_SQUAD_TO_REL                             = VG_SQUAD_TO   | VG_RELATIVE,
245  VG_SCUBIC_TO_ABS                            = VG_SCUBIC_TO  | VG_ABSOLUTE,
246  VG_SCUBIC_TO_REL                            = VG_SCUBIC_TO  | VG_RELATIVE,
247  VG_SCCWARC_TO_ABS                           = VG_SCCWARC_TO | VG_ABSOLUTE,
248  VG_SCCWARC_TO_REL                           = VG_SCCWARC_TO | VG_RELATIVE,
249  VG_SCWARC_TO_ABS                            = VG_SCWARC_TO  | VG_ABSOLUTE,
250  VG_SCWARC_TO_REL                            = VG_SCWARC_TO  | VG_RELATIVE,
251  VG_LCCWARC_TO_ABS                           = VG_LCCWARC_TO | VG_ABSOLUTE,
252  VG_LCCWARC_TO_REL                           = VG_LCCWARC_TO | VG_RELATIVE,
253  VG_LCWARC_TO_ABS                            = VG_LCWARC_TO  | VG_ABSOLUTE,
254  VG_LCWARC_TO_REL                            = VG_LCWARC_TO  | VG_RELATIVE,
255
256  VG_PATH_COMMAND_FORCE_SIZE                  = VG_MAX_ENUM
257} VGPathCommand;
258
259typedef enum {
260  VG_PATH_CAPABILITY_APPEND_FROM              = (1 <<  0),
261  VG_PATH_CAPABILITY_APPEND_TO                = (1 <<  1),
262  VG_PATH_CAPABILITY_MODIFY                   = (1 <<  2),
263  VG_PATH_CAPABILITY_TRANSFORM_FROM           = (1 <<  3),
264  VG_PATH_CAPABILITY_TRANSFORM_TO             = (1 <<  4),
265  VG_PATH_CAPABILITY_INTERPOLATE_FROM         = (1 <<  5),
266  VG_PATH_CAPABILITY_INTERPOLATE_TO           = (1 <<  6),
267  VG_PATH_CAPABILITY_PATH_LENGTH              = (1 <<  7),
268  VG_PATH_CAPABILITY_POINT_ALONG_PATH         = (1 <<  8),
269  VG_PATH_CAPABILITY_TANGENT_ALONG_PATH       = (1 <<  9),
270  VG_PATH_CAPABILITY_PATH_BOUNDS              = (1 << 10),
271  VG_PATH_CAPABILITY_PATH_TRANSFORMED_BOUNDS  = (1 << 11),
272  VG_PATH_CAPABILITY_ALL                      = (1 << 12) - 1,
273
274  VG_PATH_CAPABILITIES_FORCE_SIZE             = VG_MAX_ENUM
275} VGPathCapabilities;
276
277typedef enum {
278  VG_PATH_FORMAT                              = 0x1600,
279  VG_PATH_DATATYPE                            = 0x1601,
280  VG_PATH_SCALE                               = 0x1602,
281  VG_PATH_BIAS                                = 0x1603,
282  VG_PATH_NUM_SEGMENTS                        = 0x1604,
283  VG_PATH_NUM_COORDS                          = 0x1605,
284
285  VG_PATH_PARAM_TYPE_FORCE_SIZE               = VG_MAX_ENUM
286} VGPathParamType;
287
288typedef enum {
289  VG_CAP_BUTT                                 = 0x1700,
290  VG_CAP_ROUND                                = 0x1701,
291  VG_CAP_SQUARE                               = 0x1702,
292
293  VG_CAP_STYLE_FORCE_SIZE                     = VG_MAX_ENUM
294} VGCapStyle;
295
296typedef enum {
297  VG_JOIN_MITER                               = 0x1800,
298  VG_JOIN_ROUND                               = 0x1801,
299  VG_JOIN_BEVEL                               = 0x1802,
300
301  VG_JOIN_STYLE_FORCE_SIZE                    = VG_MAX_ENUM
302} VGJoinStyle;
303
304typedef enum {
305  VG_EVEN_ODD                                 = 0x1900,
306  VG_NON_ZERO                                 = 0x1901,
307
308  VG_FILL_RULE_FORCE_SIZE                     = VG_MAX_ENUM
309} VGFillRule;
310
311typedef enum {
312  VG_STROKE_PATH                              = (1 << 0),
313  VG_FILL_PATH                                = (1 << 1),
314
315  VG_PAINT_MODE_FORCE_SIZE                    = VG_MAX_ENUM
316} VGPaintMode;
317
318typedef enum {
319  /* Color paint parameters */
320  VG_PAINT_TYPE                               = 0x1A00,
321  VG_PAINT_COLOR                              = 0x1A01,
322  VG_PAINT_COLOR_RAMP_SPREAD_MODE             = 0x1A02,
323  VG_PAINT_COLOR_RAMP_PREMULTIPLIED           = 0x1A07,
324  VG_PAINT_COLOR_RAMP_STOPS                   = 0x1A03,
325
326  /* Linear gradient paint parameters */
327  VG_PAINT_LINEAR_GRADIENT                    = 0x1A04,
328
329  /* Radial gradient paint parameters */
330  VG_PAINT_RADIAL_GRADIENT                    = 0x1A05,
331
332  /* Pattern paint parameters */
333  VG_PAINT_PATTERN_TILING_MODE                = 0x1A06,
334
335  VG_PAINT_PARAM_TYPE_FORCE_SIZE              = VG_MAX_ENUM
336} VGPaintParamType;
337
338typedef enum {
339  VG_PAINT_TYPE_COLOR                         = 0x1B00,
340  VG_PAINT_TYPE_LINEAR_GRADIENT               = 0x1B01,
341  VG_PAINT_TYPE_RADIAL_GRADIENT               = 0x1B02,
342  VG_PAINT_TYPE_PATTERN                       = 0x1B03,
343
344  VG_PAINT_TYPE_FORCE_SIZE                    = VG_MAX_ENUM
345} VGPaintType;
346
347typedef enum {
348  VG_COLOR_RAMP_SPREAD_PAD                    = 0x1C00,
349  VG_COLOR_RAMP_SPREAD_REPEAT                 = 0x1C01,
350  VG_COLOR_RAMP_SPREAD_REFLECT                = 0x1C02,
351
352  VG_COLOR_RAMP_SPREAD_MODE_FORCE_SIZE        = VG_MAX_ENUM
353} VGColorRampSpreadMode;
354
355typedef enum {
356  VG_TILE_FILL                                = 0x1D00,
357  VG_TILE_PAD                                 = 0x1D01,
358  VG_TILE_REPEAT                              = 0x1D02,
359  VG_TILE_REFLECT                             = 0x1D03,
360
361  VG_TILING_MODE_FORCE_SIZE                   = VG_MAX_ENUM
362} VGTilingMode;
363
364typedef enum {
365  /* RGB{A,X} channel ordering */
366  VG_sRGBX_8888                               =  0,
367  VG_sRGBA_8888                               =  1,
368  VG_sRGBA_8888_PRE                           =  2,
369  VG_sRGB_565                                 =  3,
370  VG_sRGBA_5551                               =  4,
371  VG_sRGBA_4444                               =  5,
372  VG_sL_8                                     =  6,
373  VG_lRGBX_8888                               =  7,
374  VG_lRGBA_8888                               =  8,
375  VG_lRGBA_8888_PRE                           =  9,
376  VG_lL_8                                     = 10,
377  VG_A_8                                      = 11,
378  VG_BW_1                                     = 12,
379  VG_A_1                                      = 13,
380  VG_A_4                                      = 14,
381
382  /* {A,X}RGB channel ordering */
383  VG_sXRGB_8888                               =  0 | (1 << 6),
384  VG_sARGB_8888                               =  1 | (1 << 6),
385  VG_sARGB_8888_PRE                           =  2 | (1 << 6),
386  VG_sARGB_1555                               =  4 | (1 << 6),
387  VG_sARGB_4444                               =  5 | (1 << 6),
388  VG_lXRGB_8888                               =  7 | (1 << 6),
389  VG_lARGB_8888                               =  8 | (1 << 6),
390  VG_lARGB_8888_PRE                           =  9 | (1 << 6),
391
392  /* BGR{A,X} channel ordering */
393  VG_sBGRX_8888                               =  0 | (1 << 7),
394  VG_sBGRA_8888                               =  1 | (1 << 7),
395  VG_sBGRA_8888_PRE                           =  2 | (1 << 7),
396  VG_sBGR_565                                 =  3 | (1 << 7),
397  VG_sBGRA_5551                               =  4 | (1 << 7),
398  VG_sBGRA_4444                               =  5 | (1 << 7),
399  VG_lBGRX_8888                               =  7 | (1 << 7),
400  VG_lBGRA_8888                               =  8 | (1 << 7),
401  VG_lBGRA_8888_PRE                           =  9 | (1 << 7),
402
403  /* {A,X}BGR channel ordering */
404  VG_sXBGR_8888                               =  0 | (1 << 6) | (1 << 7),
405  VG_sABGR_8888                               =  1 | (1 << 6) | (1 << 7),
406  VG_sABGR_8888_PRE                           =  2 | (1 << 6) | (1 << 7),
407  VG_sABGR_1555                               =  4 | (1 << 6) | (1 << 7),
408  VG_sABGR_4444                               =  5 | (1 << 6) | (1 << 7),
409  VG_lXBGR_8888                               =  7 | (1 << 6) | (1 << 7),
410  VG_lABGR_8888                               =  8 | (1 << 6) | (1 << 7),
411  VG_lABGR_8888_PRE                           =  9 | (1 << 6) | (1 << 7),
412
413  VG_IMAGE_FORMAT_FORCE_SIZE                  = VG_MAX_ENUM
414} VGImageFormat;
415
416typedef enum {
417  VG_IMAGE_QUALITY_NONANTIALIASED             = (1 << 0),
418  VG_IMAGE_QUALITY_FASTER                     = (1 << 1),
419  VG_IMAGE_QUALITY_BETTER                     = (1 << 2),
420
421  VG_IMAGE_QUALITY_FORCE_SIZE                 = VG_MAX_ENUM
422} VGImageQuality;
423
424typedef enum {
425  VG_IMAGE_FORMAT                             = 0x1E00,
426  VG_IMAGE_WIDTH                              = 0x1E01,
427  VG_IMAGE_HEIGHT                             = 0x1E02,
428
429  VG_IMAGE_PARAM_TYPE_FORCE_SIZE              = VG_MAX_ENUM
430} VGImageParamType;
431
432typedef enum {
433  VG_DRAW_IMAGE_NORMAL                        = 0x1F00,
434  VG_DRAW_IMAGE_MULTIPLY                      = 0x1F01,
435  VG_DRAW_IMAGE_STENCIL                       = 0x1F02,
436
437  VG_IMAGE_MODE_FORCE_SIZE                    = VG_MAX_ENUM
438} VGImageMode;
439
440typedef enum {
441  VG_RED                                      = (1 << 3),
442  VG_GREEN                                    = (1 << 2),
443  VG_BLUE                                     = (1 << 1),
444  VG_ALPHA                                    = (1 << 0),
445
446  VG_IMAGE_CHANNEL_FORCE_SIZE                 = VG_MAX_ENUM
447} VGImageChannel;
448
449typedef enum {
450  VG_BLEND_SRC                                = 0x2000,
451  VG_BLEND_SRC_OVER                           = 0x2001,
452  VG_BLEND_DST_OVER                           = 0x2002,
453  VG_BLEND_SRC_IN                             = 0x2003,
454  VG_BLEND_DST_IN                             = 0x2004,
455  VG_BLEND_MULTIPLY                           = 0x2005,
456  VG_BLEND_SCREEN                             = 0x2006,
457  VG_BLEND_DARKEN                             = 0x2007,
458  VG_BLEND_LIGHTEN                            = 0x2008,
459  VG_BLEND_ADDITIVE                           = 0x2009,
460
461  VG_BLEND_MODE_FORCE_SIZE                    = VG_MAX_ENUM
462} VGBlendMode;
463
464typedef enum {
465  VG_FONT_NUM_GLYPHS                          = 0x2F00,
466
467  VG_FONT_PARAM_TYPE_FORCE_SIZE               = VG_MAX_ENUM
468} VGFontParamType;
469
470typedef enum {
471  VG_IMAGE_FORMAT_QUERY                       = 0x2100,
472  VG_PATH_DATATYPE_QUERY                      = 0x2101,
473
474  VG_HARDWARE_QUERY_TYPE_FORCE_SIZE           = VG_MAX_ENUM
475} VGHardwareQueryType;
476
477typedef enum {
478  VG_HARDWARE_ACCELERATED                     = 0x2200,
479  VG_HARDWARE_UNACCELERATED                   = 0x2201,
480
481  VG_HARDWARE_QUERY_RESULT_FORCE_SIZE         = VG_MAX_ENUM
482} VGHardwareQueryResult;
483
484typedef enum {
485  VG_VENDOR                                   = 0x2300,
486  VG_RENDERER                                 = 0x2301,
487  VG_VERSION                                  = 0x2302,
488  VG_EXTENSIONS                               = 0x2303,
489
490  VG_STRING_ID_FORCE_SIZE                     = VG_MAX_ENUM
491} VGStringID;
492
493/* Function Prototypes */
494
495#ifndef VG_API_CALL
496#	error VG_API_CALL must be defined
497#endif
498
499#ifndef VG_API_ENTRY
500#   error VG_API_ENTRY must be defined
501#endif
502
503#ifndef VG_API_EXIT
504#   error VG_API_EXIT must be defined
505#endif
506
507VG_API_CALL VGErrorCode VG_API_ENTRY vgGetError(void) VG_API_EXIT;
508
509VG_API_CALL void VG_API_ENTRY vgFlush(void) VG_API_EXIT;
510VG_API_CALL void VG_API_ENTRY vgFinish(void) VG_API_EXIT;
511
512/* Getters and Setters */
513VG_API_CALL void VG_API_ENTRY vgSetf (VGParamType type, VGfloat value) VG_API_EXIT;
514VG_API_CALL void VG_API_ENTRY vgSeti (VGParamType type, VGint value) VG_API_EXIT;
515VG_API_CALL void VG_API_ENTRY vgSetfv(VGParamType type, VGint count,
516                         const VGfloat * values) VG_API_EXIT;
517VG_API_CALL void VG_API_ENTRY vgSetiv(VGParamType type, VGint count,
518                         const VGint * values) VG_API_EXIT;
519
520VG_API_CALL VGfloat VG_API_ENTRY vgGetf(VGParamType type) VG_API_EXIT;
521VG_API_CALL VGint VG_API_ENTRY vgGeti(VGParamType type) VG_API_EXIT;
522VG_API_CALL VGint VG_API_ENTRY vgGetVectorSize(VGParamType type) VG_API_EXIT;
523VG_API_CALL void VG_API_ENTRY vgGetfv(VGParamType type, VGint count, VGfloat * values) VG_API_EXIT;
524VG_API_CALL void VG_API_ENTRY vgGetiv(VGParamType type, VGint count, VGint * values) VG_API_EXIT;
525
526VG_API_CALL void VG_API_ENTRY vgSetParameterf(VGHandle object,
527                                 VGint paramType,
528                                 VGfloat value) VG_API_EXIT;
529VG_API_CALL void VG_API_ENTRY vgSetParameteri(VGHandle object,
530                                 VGint paramType,
531                                 VGint value) VG_API_EXIT;
532VG_API_CALL void VG_API_ENTRY vgSetParameterfv(VGHandle object,
533                                  VGint paramType,
534                                  VGint count, const VGfloat * values) VG_API_EXIT;
535VG_API_CALL void VG_API_ENTRY vgSetParameteriv(VGHandle object,
536                                  VGint paramType,
537                                  VGint count, const VGint * values) VG_API_EXIT;
538
539VG_API_CALL VGfloat VG_API_ENTRY vgGetParameterf(VGHandle object,
540                                    VGint paramType) VG_API_EXIT;
541VG_API_CALL VGint VG_API_ENTRY vgGetParameteri(VGHandle object,
542                                  VGint paramType);
543VG_API_CALL VGint VG_API_ENTRY vgGetParameterVectorSize(VGHandle object,
544                                           VGint paramType) VG_API_EXIT;
545VG_API_CALL void VG_API_ENTRY vgGetParameterfv(VGHandle object,
546                                  VGint paramType,
547                                  VGint count, VGfloat * values) VG_API_EXIT;
548VG_API_CALL void VG_API_ENTRY vgGetParameteriv(VGHandle object,
549                                  VGint paramType,
550                                  VGint count, VGint * values) VG_API_EXIT;
551
552/* Matrix Manipulation */
553VG_API_CALL void VG_API_ENTRY vgLoadIdentity(void) VG_API_EXIT;
554VG_API_CALL void VG_API_ENTRY vgLoadMatrix(const VGfloat * m) VG_API_EXIT;
555VG_API_CALL void VG_API_ENTRY vgGetMatrix(VGfloat * m) VG_API_EXIT;
556VG_API_CALL void VG_API_ENTRY vgMultMatrix(const VGfloat * m) VG_API_EXIT;
557VG_API_CALL void VG_API_ENTRY vgTranslate(VGfloat tx, VGfloat ty) VG_API_EXIT;
558VG_API_CALL void VG_API_ENTRY vgScale(VGfloat sx, VGfloat sy) VG_API_EXIT;
559VG_API_CALL void VG_API_ENTRY vgShear(VGfloat shx, VGfloat shy) VG_API_EXIT;
560VG_API_CALL void VG_API_ENTRY vgRotate(VGfloat angle) VG_API_EXIT;
561
562/* Masking and Clearing */
563VG_API_CALL void VG_API_ENTRY vgMask(VGHandle mask, VGMaskOperation operation,
564                                     VGint x, VGint y,
565                                     VGint width, VGint height) VG_API_EXIT;
566VG_API_CALL void VG_API_ENTRY vgRenderToMask(VGPath path,
567                                            VGbitfield paintModes,
568                                            VGMaskOperation operation) VG_API_EXIT;
569VG_API_CALL VGMaskLayer VG_API_ENTRY vgCreateMaskLayer(VGint width, VGint height) VG_API_EXIT;
570VG_API_CALL void VG_API_ENTRY vgDestroyMaskLayer(VGMaskLayer maskLayer) VG_API_EXIT;
571VG_API_CALL void VG_API_ENTRY vgFillMaskLayer(VGMaskLayer maskLayer,
572                                             VGint x, VGint y,
573                                             VGint width, VGint height,
574                                             VGfloat value) VG_API_EXIT;
575VG_API_CALL void VG_API_ENTRY vgCopyMask(VGMaskLayer maskLayer,
576                                        VGint dx, VGint dy,
577                                        VGint sx, VGint sy,
578                                        VGint width, VGint height) VG_API_EXIT;
579VG_API_CALL void VG_API_ENTRY vgClear(VGint x, VGint y, VGint width, VGint height) VG_API_EXIT;
580
581/* Paths */
582VG_API_CALL VGPath VG_API_ENTRY vgCreatePath(VGint pathFormat,
583                                VGPathDatatype datatype,
584                                VGfloat scale, VGfloat bias,
585                                VGint segmentCapacityHint,
586                                VGint coordCapacityHint,
587                                VGbitfield capabilities) VG_API_EXIT;
588VG_API_CALL void VG_API_ENTRY vgClearPath(VGPath path, VGbitfield capabilities) VG_API_EXIT;
589VG_API_CALL void VG_API_ENTRY vgDestroyPath(VGPath path) VG_API_EXIT;
590VG_API_CALL void VG_API_ENTRY vgRemovePathCapabilities(VGPath path,
591                                          VGbitfield capabilities) VG_API_EXIT;
592VG_API_CALL VGbitfield VG_API_ENTRY vgGetPathCapabilities(VGPath path) VG_API_EXIT;
593VG_API_CALL void VG_API_ENTRY vgAppendPath(VGPath dstPath, VGPath srcPath) VG_API_EXIT;
594VG_API_CALL void VG_API_ENTRY vgAppendPathData(VGPath dstPath,
595                                  VGint numSegments,
596                                  const VGubyte * pathSegments,
597                                  const void * pathData) VG_API_EXIT;
598VG_API_CALL void VG_API_ENTRY vgModifyPathCoords(VGPath dstPath, VGint startIndex,
599                                    VGint numSegments,
600                                    const void * pathData) VG_API_EXIT;
601VG_API_CALL void VG_API_ENTRY vgTransformPath(VGPath dstPath, VGPath srcPath) VG_API_EXIT;
602VG_API_CALL VGboolean VG_API_ENTRY vgInterpolatePath(VGPath dstPath,
603                                        VGPath startPath,
604                                        VGPath endPath,
605                                        VGfloat amount) VG_API_EXIT;
606VG_API_CALL VGfloat VG_API_ENTRY vgPathLength(VGPath path,
607                                 VGint startSegment, VGint numSegments) VG_API_EXIT;
608VG_API_CALL void VG_API_ENTRY vgPointAlongPath(VGPath path,
609                                  VGint startSegment, VGint numSegments,
610                                  VGfloat distance,
611                                  VGfloat * x, VGfloat * y,
612                                  VGfloat * tangentX, VGfloat * tangentY) VG_API_EXIT;
613VG_API_CALL void VG_API_ENTRY vgPathBounds(VGPath path,
614                              VGfloat * minX, VGfloat * minY,
615                              VGfloat * width, VGfloat * height) VG_API_EXIT;
616VG_API_CALL void VG_API_ENTRY vgPathTransformedBounds(VGPath path,
617                                         VGfloat * minX, VGfloat * minY,
618                                         VGfloat * width, VGfloat * height) VG_API_EXIT;
619VG_API_CALL void VG_API_ENTRY vgDrawPath(VGPath path, VGbitfield paintModes) VG_API_EXIT;
620
621/* Paint */
622VG_API_CALL VGPaint VG_API_ENTRY vgCreatePaint(void) VG_API_EXIT;
623VG_API_CALL void VG_API_ENTRY vgDestroyPaint(VGPaint paint) VG_API_EXIT;
624VG_API_CALL void VG_API_ENTRY vgSetPaint(VGPaint paint, VGbitfield paintModes) VG_API_EXIT;
625VG_API_CALL VGPaint VG_API_ENTRY vgGetPaint(VGPaintMode paintMode) VG_API_EXIT;
626VG_API_CALL void VG_API_ENTRY vgSetColor(VGPaint paint, VGuint rgba) VG_API_EXIT;
627VG_API_CALL VGuint VG_API_ENTRY vgGetColor(VGPaint paint) VG_API_EXIT;
628VG_API_CALL void VG_API_ENTRY vgPaintPattern(VGPaint paint, VGImage pattern) VG_API_EXIT;
629
630/* Images */
631VG_API_CALL VGImage VG_API_ENTRY vgCreateImage(VGImageFormat format,
632                                  VGint width, VGint height,
633                                  VGbitfield allowedQuality) VG_API_EXIT;
634VG_API_CALL void VG_API_ENTRY vgDestroyImage(VGImage image) VG_API_EXIT;
635VG_API_CALL void VG_API_ENTRY vgClearImage(VGImage image,
636                              VGint x, VGint y, VGint width, VGint height) VG_API_EXIT;
637VG_API_CALL void VG_API_ENTRY vgImageSubData(VGImage image,
638                                const void * data, VGint dataStride,
639                                VGImageFormat dataFormat,
640                                VGint x, VGint y, VGint width, VGint height) VG_API_EXIT;
641VG_API_CALL void VG_API_ENTRY vgGetImageSubData(VGImage image,
642                                   void * data, VGint dataStride,
643                                   VGImageFormat dataFormat,
644                                   VGint x, VGint y,
645                                   VGint width, VGint height) VG_API_EXIT;
646VG_API_CALL VGImage VG_API_ENTRY vgChildImage(VGImage parent,
647                                 VGint x, VGint y, VGint width, VGint height) VG_API_EXIT;
648VG_API_CALL VGImage VG_API_ENTRY vgGetParent(VGImage image) VG_API_EXIT;
649VG_API_CALL void VG_API_ENTRY vgCopyImage(VGImage dst, VGint dx, VGint dy,
650                             VGImage src, VGint sx, VGint sy,
651                             VGint width, VGint height,
652                             VGboolean dither) VG_API_EXIT;
653VG_API_CALL void VG_API_ENTRY vgDrawImage(VGImage image) VG_API_EXIT;
654VG_API_CALL void VG_API_ENTRY vgSetPixels(VGint dx, VGint dy,
655                             VGImage src, VGint sx, VGint sy,
656                             VGint width, VGint height) VG_API_EXIT;
657VG_API_CALL void VG_API_ENTRY vgWritePixels(const void * data, VGint dataStride,
658                               VGImageFormat dataFormat,
659                               VGint dx, VGint dy,
660                               VGint width, VGint height) VG_API_EXIT;
661VG_API_CALL void VG_API_ENTRY vgGetPixels(VGImage dst, VGint dx, VGint dy,
662                             VGint sx, VGint sy,
663                             VGint width, VGint height) VG_API_EXIT;
664VG_API_CALL void VG_API_ENTRY vgReadPixels(void * data, VGint dataStride,
665                              VGImageFormat dataFormat,
666                              VGint sx, VGint sy,
667                              VGint width, VGint height) VG_API_EXIT;
668VG_API_CALL void VG_API_ENTRY vgCopyPixels(VGint dx, VGint dy,
669                              VGint sx, VGint sy,
670                              VGint width, VGint height) VG_API_EXIT;
671
672/* Text */
673VG_API_CALL VGFont VG_API_ENTRY vgCreateFont(VGint glyphCapacityHint) VG_API_EXIT;
674VG_API_CALL void VG_API_ENTRY vgDestroyFont(VGFont font) VG_API_EXIT;
675VG_API_CALL void VG_API_ENTRY vgSetGlyphToPath(VGFont font,
676                                              VGuint glyphIndex,
677                                              VGPath path,
678                                              VGboolean isHinted,
679                                              const VGfloat glyphOrigin [2],
680                                              const VGfloat escapement[2]) VG_API_EXIT;
681VG_API_CALL void VG_API_ENTRY vgSetGlyphToImage(VGFont font,
682                                               VGuint glyphIndex,
683                                               VGImage image,
684                                               const VGfloat glyphOrigin [2],
685                                               const VGfloat escapement[2]) VG_API_EXIT;
686VG_API_CALL void VG_API_ENTRY vgClearGlyph(VGFont font,VGuint glyphIndex) VG_API_EXIT;
687VG_API_CALL void VG_API_ENTRY vgDrawGlyph(VGFont font,
688                                         VGuint glyphIndex,
689                                         VGbitfield paintModes,
690                                         VGboolean allowAutoHinting) VG_API_EXIT;
691VG_API_CALL void VG_API_ENTRY vgDrawGlyphs(VGFont font,
692                                          VGint glyphCount,
693                                          const VGuint *glyphIndices,
694                                          const VGfloat *adjustments_x,
695                                          const VGfloat *adjustments_y,
696                                          VGbitfield paintModes,
697                                          VGboolean allowAutoHinting) VG_API_EXIT;
698
699/* Image Filters */
700VG_API_CALL void VG_API_ENTRY vgColorMatrix(VGImage dst, VGImage src,
701                               const VGfloat * matrix) VG_API_EXIT;
702VG_API_CALL void VG_API_ENTRY vgConvolve(VGImage dst, VGImage src,
703                            VGint kernelWidth, VGint kernelHeight,
704                            VGint shiftX, VGint shiftY,
705                            const VGshort * kernel,
706                            VGfloat scale,
707                            VGfloat bias,
708                            VGTilingMode tilingMode) VG_API_EXIT;
709VG_API_CALL void VG_API_ENTRY vgSeparableConvolve(VGImage dst, VGImage src,
710                                     VGint kernelWidth,
711                                     VGint kernelHeight,
712                                     VGint shiftX, VGint shiftY,
713                                     const VGshort * kernelX,
714                                     const VGshort * kernelY,
715                                     VGfloat scale,
716                                     VGfloat bias,
717                                     VGTilingMode tilingMode) VG_API_EXIT;
718VG_API_CALL void VG_API_ENTRY vgGaussianBlur(VGImage dst, VGImage src,
719                                VGfloat stdDeviationX,
720                                VGfloat stdDeviationY,
721                                VGTilingMode tilingMode) VG_API_EXIT;
722VG_API_CALL void VG_API_ENTRY vgLookup(VGImage dst, VGImage src,
723                          const VGubyte * redLUT,
724                          const VGubyte * greenLUT,
725                          const VGubyte * blueLUT,
726                          const VGubyte * alphaLUT,
727                          VGboolean outputLinear,
728                          VGboolean outputPremultiplied) VG_API_EXIT;
729VG_API_CALL void VG_API_ENTRY vgLookupSingle(VGImage dst, VGImage src,
730                                const VGuint * lookupTable,
731                                VGImageChannel sourceChannel,
732                                VGboolean outputLinear,
733                                VGboolean outputPremultiplied) VG_API_EXIT;
734
735/* Hardware Queries */
736VG_API_CALL VGHardwareQueryResult VG_API_ENTRY vgHardwareQuery(VGHardwareQueryType key,
737                                                  VGint setting) VG_API_EXIT;
738
739/* Renderer and Extension Information */
740VG_API_CALL const VGubyte * VG_API_ENTRY vgGetString(VGStringID name) VG_API_EXIT;
741
742#ifdef __cplusplus
743} /* extern "C" */
744#endif
745
746#endif /* _OPENVG_H */
747