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