/*------------------------------------------------------------------------

 *

 * OpenVG 1.1 Reference Implementation

 * -------------------------------------

 *

 * Copyright (c) 2008-2009 The Khronos Group Inc.

 *

 * Permission is hereby granted, free of charge, to any person obtaining a

 * copy of this software and /or associated documentation files

 * (the "Materials "), to deal in the Materials without restriction,

 * including without limitation the rights to use, copy, modify, merge,

 * publish, distribute, sublicense, and/or sell copies of the Materials,

 * and to permit persons to whom the Materials are furnished to do so,

 * subject to the following conditions: 

 *

 * The above copyright notice and this permission notice shall be included 

 * in all copies or substantial portions of the Materials. 

 *

 * THE MATERIALS ARE PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,

 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF

 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.

 * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,

 * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR

 * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE MATERIALS OR

 * THE USE OR OTHER DEALINGS IN THE MATERIALS.

 *

 *//**

 * \file

 * \brief	OpenVG 1.1 API.

 *//*-------------------------------------------------------------------*/

#ifndef __VG_1_1_OPENVG_H

#define __VG_1_1_OPENVG_H

#ifndef __VG_OPENVG_H_

#error Do not include this file directly. Use <VG/openvg.h>.

#endif

/* differences from the actual sample implemtation provided by Khronos:

- this comment

- the Doxygen comment with tag 'publishedAll', and tag 'released'

- changing 

	#define VG_API_CALL extern 

	to 

	#define VG_API_CALL IMPORT_C

- the addition of __SOFTFP to all function prototypes

- the addition of VG_PATH_DATATYPE_INVALID in VGPathDatatype

- the addition of VG_IMAGE_FORMAT_INVALID in VGImageFormat

- the addition of VGeglImageKHR typedef for the VG_KHR_EGL_image extension

 */

/**

@publishedAll

@released

*/

#ifdef __cplusplus

extern "C" {

#endif

#include <khronos_types.h>

#define OPENVG_VERSION_1_0		1

#define OPENVG_VERSION_1_0_1	1

#define OPENVG_VERSION_1_1		2

typedef khronos_float_t  VGfloat;

typedef khronos_int8_t   VGbyte;

typedef khronos_uint8_t  VGubyte;

typedef khronos_int16_t  VGshort;

typedef khronos_int32_t  VGint;

typedef khronos_uint32_t VGuint;

typedef khronos_uint32_t VGbitfield;

typedef enum {

  VG_FALSE = 0,

  VG_TRUE  = 1

} VGboolean;

#define VG_MAXSHORT ((VGshort)((~((unsigned)0)) >> 1))

#define VG_MAXINT ((VGint)((~((unsigned)0)) >> 1))

typedef VGuint VGHandle;

#define VG_INVALID_HANDLE ((VGHandle)0)

typedef enum {

  VG_NO_ERROR                                 = 0,

  VG_BAD_HANDLE_ERROR                         = 0x1000,

  VG_ILLEGAL_ARGUMENT_ERROR                   = 0x1001,

  VG_OUT_OF_MEMORY_ERROR                      = 0x1002,

  VG_PATH_CAPABILITY_ERROR                    = 0x1003,

  VG_UNSUPPORTED_IMAGE_FORMAT_ERROR           = 0x1004,

  VG_UNSUPPORTED_PATH_FORMAT_ERROR            = 0x1005,

  VG_IMAGE_IN_USE_ERROR                       = 0x1006,

  VG_NO_CONTEXT_ERROR                         = 0x1007

} VGErrorCode;

typedef enum {

  /* Mode settings */

  VG_MATRIX_MODE                              = 0x1100,

  VG_FILL_RULE                                = 0x1101,

  VG_IMAGE_QUALITY                            = 0x1102,

  VG_RENDERING_QUALITY                        = 0x1103,

  VG_BLEND_MODE                               = 0x1104,

  VG_IMAGE_MODE                               = 0x1105,

  /* Scissoring rectangles */

  VG_SCISSOR_RECTS                            = 0x1106,

  /* Color Transformation */

  VG_COLOR_TRANSFORM                          = 0x1170,

  VG_COLOR_TRANSFORM_VALUES                   = 0x1171,

  /* Stroke parameters */

  VG_STROKE_LINE_WIDTH                        = 0x1110,

  VG_STROKE_CAP_STYLE                         = 0x1111,

  VG_STROKE_JOIN_STYLE                        = 0x1112,

  VG_STROKE_MITER_LIMIT                       = 0x1113,

  VG_STROKE_DASH_PATTERN                      = 0x1114,

  VG_STROKE_DASH_PHASE                        = 0x1115,

  VG_STROKE_DASH_PHASE_RESET                  = 0x1116,

  /* Edge fill color for VG_TILE_FILL tiling mode */

  VG_TILE_FILL_COLOR                          = 0x1120,

  /* Color for vgClear */

  VG_CLEAR_COLOR                              = 0x1121,

  /* Glyph origin */

  VG_GLYPH_ORIGIN                             = 0x1122,

  /* Enable/disable alpha masking and scissoring */

  VG_MASKING                                  = 0x1130,

  VG_SCISSORING                               = 0x1131,

  /* Pixel layout information */

  VG_PIXEL_LAYOUT                             = 0x1140,

  VG_SCREEN_LAYOUT                            = 0x1141,

  /* Source format selection for image filters */

  VG_FILTER_FORMAT_LINEAR                     = 0x1150,

  VG_FILTER_FORMAT_PREMULTIPLIED              = 0x1151,

  /* Destination write enable mask for image filters */

  VG_FILTER_CHANNEL_MASK                      = 0x1152,

  /* Implementation limits (read-only) */

  VG_MAX_SCISSOR_RECTS                        = 0x1160,

  VG_MAX_DASH_COUNT                           = 0x1161,

  VG_MAX_KERNEL_SIZE                          = 0x1162,

  VG_MAX_SEPARABLE_KERNEL_SIZE                = 0x1163,

  VG_MAX_COLOR_RAMP_STOPS                     = 0x1164,

  VG_MAX_IMAGE_WIDTH                          = 0x1165,

  VG_MAX_IMAGE_HEIGHT                         = 0x1166,

  VG_MAX_IMAGE_PIXELS                         = 0x1167,

  VG_MAX_IMAGE_BYTES                          = 0x1168,

  VG_MAX_FLOAT                                = 0x1169,

  VG_MAX_GAUSSIAN_STD_DEVIATION               = 0x116A

} VGParamType;

typedef enum {

  VG_RENDERING_QUALITY_NONANTIALIASED         = 0x1200,

  VG_RENDERING_QUALITY_FASTER                 = 0x1201,

  VG_RENDERING_QUALITY_BETTER                 = 0x1202  /* Default */

} VGRenderingQuality;

typedef enum {

  VG_PIXEL_LAYOUT_UNKNOWN                     = 0x1300,

  VG_PIXEL_LAYOUT_RGB_VERTICAL                = 0x1301,

  VG_PIXEL_LAYOUT_BGR_VERTICAL                = 0x1302,

  VG_PIXEL_LAYOUT_RGB_HORIZONTAL              = 0x1303,

  VG_PIXEL_LAYOUT_BGR_HORIZONTAL              = 0x1304

} VGPixelLayout;

typedef enum {

  VG_MATRIX_PATH_USER_TO_SURFACE              = 0x1400,

  VG_MATRIX_IMAGE_USER_TO_SURFACE             = 0x1401,

  VG_MATRIX_FILL_PAINT_TO_USER                = 0x1402,

  VG_MATRIX_STROKE_PAINT_TO_USER              = 0x1403,

  VG_MATRIX_GLYPH_USER_TO_SURFACE             = 0x1404

} VGMatrixMode;

typedef enum {

  VG_CLEAR_MASK                               = 0x1500,

  VG_FILL_MASK                                = 0x1501,

  VG_SET_MASK                                 = 0x1502,

  VG_UNION_MASK                               = 0x1503,

  VG_INTERSECT_MASK                           = 0x1504,

  VG_SUBTRACT_MASK                            = 0x1505

} VGMaskOperation;

#define VG_PATH_FORMAT_STANDARD 0

typedef enum {

  VG_PATH_DATATYPE_INVALID                    = -1,

  VG_PATH_DATATYPE_S_8                        =  0,

  VG_PATH_DATATYPE_S_16                       =  1,

  VG_PATH_DATATYPE_S_32                       =  2,

  VG_PATH_DATATYPE_F                          =  3

} VGPathDatatype;

typedef enum {

  VG_ABSOLUTE                                 = 0,

  VG_RELATIVE                                 = 1

} VGPathAbsRel;

typedef enum {

  VG_CLOSE_PATH                               = ( 0 << 1),

  VG_MOVE_TO                                  = ( 1 << 1),

  VG_LINE_TO                                  = ( 2 << 1),

  VG_HLINE_TO                                 = ( 3 << 1),

  VG_VLINE_TO                                 = ( 4 << 1),

  VG_QUAD_TO                                  = ( 5 << 1),

  VG_CUBIC_TO                                 = ( 6 << 1),

  VG_SQUAD_TO                                 = ( 7 << 1),

  VG_SCUBIC_TO                                = ( 8 << 1),

  VG_SCCWARC_TO                               = ( 9 << 1),

  VG_SCWARC_TO                                = (10 << 1),

  VG_LCCWARC_TO                               = (11 << 1),

  VG_LCWARC_TO                                = (12 << 1)

} VGPathSegment;

typedef enum {

  VG_MOVE_TO_ABS                              = VG_MOVE_TO    | VG_ABSOLUTE,

  VG_MOVE_TO_REL                              = VG_MOVE_TO    | VG_RELATIVE,

  VG_LINE_TO_ABS                              = VG_LINE_TO    | VG_ABSOLUTE,

  VG_LINE_TO_REL                              = VG_LINE_TO    | VG_RELATIVE,

  VG_HLINE_TO_ABS                             = VG_HLINE_TO   | VG_ABSOLUTE,

  VG_HLINE_TO_REL                             = VG_HLINE_TO   | VG_RELATIVE,

  VG_VLINE_TO_ABS                             = VG_VLINE_TO   | VG_ABSOLUTE,

  VG_VLINE_TO_REL                             = VG_VLINE_TO   | VG_RELATIVE,

  VG_QUAD_TO_ABS                              = VG_QUAD_TO    | VG_ABSOLUTE,

  VG_QUAD_TO_REL                              = VG_QUAD_TO    | VG_RELATIVE,

  VG_CUBIC_TO_ABS                             = VG_CUBIC_TO   | VG_ABSOLUTE,

  VG_CUBIC_TO_REL                             = VG_CUBIC_TO   | VG_RELATIVE,

  VG_SQUAD_TO_ABS                             = VG_SQUAD_TO   | VG_ABSOLUTE,

  VG_SQUAD_TO_REL                             = VG_SQUAD_TO   | VG_RELATIVE,

  VG_SCUBIC_TO_ABS                            = VG_SCUBIC_TO  | VG_ABSOLUTE,

  VG_SCUBIC_TO_REL                            = VG_SCUBIC_TO  | VG_RELATIVE,

  VG_SCCWARC_TO_ABS                           = VG_SCCWARC_TO | VG_ABSOLUTE,

  VG_SCCWARC_TO_REL                           = VG_SCCWARC_TO | VG_RELATIVE,

  VG_SCWARC_TO_ABS                            = VG_SCWARC_TO  | VG_ABSOLUTE,

  VG_SCWARC_TO_REL                            = VG_SCWARC_TO  | VG_RELATIVE,

  VG_LCCWARC_TO_ABS                           = VG_LCCWARC_TO | VG_ABSOLUTE,

  VG_LCCWARC_TO_REL                           = VG_LCCWARC_TO | VG_RELATIVE,

  VG_LCWARC_TO_ABS                            = VG_LCWARC_TO  | VG_ABSOLUTE,

  VG_LCWARC_TO_REL                            = VG_LCWARC_TO  | VG_RELATIVE

} VGPathCommand;

typedef VGHandle VGPath;

typedef enum {

  VG_PATH_CAPABILITY_APPEND_FROM              = (1 <<  0),

  VG_PATH_CAPABILITY_APPEND_TO                = (1 <<  1),

  VG_PATH_CAPABILITY_MODIFY                   = (1 <<  2),

  VG_PATH_CAPABILITY_TRANSFORM_FROM           = (1 <<  3),

  VG_PATH_CAPABILITY_TRANSFORM_TO             = (1 <<  4),

  VG_PATH_CAPABILITY_INTERPOLATE_FROM         = (1 <<  5),

  VG_PATH_CAPABILITY_INTERPOLATE_TO           = (1 <<  6),

  VG_PATH_CAPABILITY_PATH_LENGTH              = (1 <<  7),

  VG_PATH_CAPABILITY_POINT_ALONG_PATH         = (1 <<  8),

  VG_PATH_CAPABILITY_TANGENT_ALONG_PATH       = (1 <<  9),

  VG_PATH_CAPABILITY_PATH_BOUNDS              = (1 << 10),

  VG_PATH_CAPABILITY_PATH_TRANSFORMED_BOUNDS  = (1 << 11),

  VG_PATH_CAPABILITY_ALL                      = (1 << 12) - 1

} VGPathCapabilities;

typedef enum {

  VG_PATH_FORMAT                              = 0x1600,

  VG_PATH_DATATYPE                            = 0x1601,

  VG_PATH_SCALE                               = 0x1602,

  VG_PATH_BIAS                                = 0x1603,

  VG_PATH_NUM_SEGMENTS                        = 0x1604,

  VG_PATH_NUM_COORDS                          = 0x1605

} VGPathParamType;

typedef enum {

  VG_CAP_BUTT                                 = 0x1700,

  VG_CAP_ROUND                                = 0x1701,

  VG_CAP_SQUARE                               = 0x1702

} VGCapStyle;

typedef enum {

  VG_JOIN_MITER                               = 0x1800,

  VG_JOIN_ROUND                               = 0x1801,

  VG_JOIN_BEVEL                               = 0x1802

} VGJoinStyle;

typedef enum {

  VG_EVEN_ODD                                 = 0x1900,

  VG_NON_ZERO                                 = 0x1901

} VGFillRule;

typedef enum {

  VG_STROKE_PATH                              = (1 << 0),

  VG_FILL_PATH                                = (1 << 1)

} VGPaintMode;

typedef VGHandle VGPaint;

typedef enum {

  /* Color paint parameters */

  VG_PAINT_TYPE                               = 0x1A00,

  VG_PAINT_COLOR                              = 0x1A01,

  VG_PAINT_COLOR_RAMP_SPREAD_MODE             = 0x1A02,

  VG_PAINT_COLOR_RAMP_PREMULTIPLIED           = 0x1A07,

  VG_PAINT_COLOR_RAMP_STOPS                   = 0x1A03,

  /* Linear gradient paint parameters */

  VG_PAINT_LINEAR_GRADIENT                    = 0x1A04,

  /* Radial gradient paint parameters */

  VG_PAINT_RADIAL_GRADIENT                    = 0x1A05,

  /* Pattern paint parameters */

  VG_PAINT_PATTERN_TILING_MODE                = 0x1A06

} VGPaintParamType;

typedef enum {

  VG_PAINT_TYPE_COLOR                         = 0x1B00,

  VG_PAINT_TYPE_LINEAR_GRADIENT               = 0x1B01,

  VG_PAINT_TYPE_RADIAL_GRADIENT               = 0x1B02,

  VG_PAINT_TYPE_PATTERN                       = 0x1B03

} VGPaintType;

typedef enum {

  VG_COLOR_RAMP_SPREAD_PAD                    = 0x1C00,

  VG_COLOR_RAMP_SPREAD_REPEAT                 = 0x1C01,

  VG_COLOR_RAMP_SPREAD_REFLECT                = 0x1C02

} VGColorRampSpreadMode;

typedef enum {

  VG_TILE_FILL                                = 0x1D00,

  VG_TILE_PAD                                 = 0x1D01,

  VG_TILE_REPEAT                              = 0x1D02,

  VG_TILE_REFLECT                             = 0x1D03

} VGTilingMode;

typedef enum {

  /* RGB{A,X} channel ordering */

  VG_IMAGE_FORMAT_INVALID                     = -1,

  VG_sRGBX_8888                               =  0,

  VG_sRGBA_8888                               =  1,

  VG_sRGBA_8888_PRE                           =  2,

  VG_sRGB_565                                 =  3,

  VG_sRGBA_5551                               =  4,

  VG_sRGBA_4444                               =  5,

  VG_sL_8                                     =  6,

  VG_lRGBX_8888                               =  7,

  VG_lRGBA_8888                               =  8,

  VG_lRGBA_8888_PRE                           =  9,

  VG_lL_8                                     = 10,

  VG_A_8                                      = 11,

  VG_BW_1                                     = 12,

  VG_A_1                                      = 13,

  VG_A_4                                      = 14,

  /* {A,X}RGB channel ordering */

  VG_sXRGB_8888                               =  0 | (1 << 6),

  VG_sARGB_8888                               =  1 | (1 << 6),

  VG_sARGB_8888_PRE                           =  2 | (1 << 6),

  VG_sARGB_1555                               =  4 | (1 << 6),

  VG_sARGB_4444                               =  5 | (1 << 6),

  VG_lXRGB_8888                               =  7 | (1 << 6),

  VG_lARGB_8888                               =  8 | (1 << 6),

  VG_lARGB_8888_PRE                           =  9 | (1 << 6),

  /* BGR{A,X} channel ordering */

  VG_sBGRX_8888                               =  0 | (1 << 7),

  VG_sBGRA_8888                               =  1 | (1 << 7),

  VG_sBGRA_8888_PRE                           =  2 | (1 << 7),

  VG_sBGR_565                                 =  3 | (1 << 7),

  VG_sBGRA_5551                               =  4 | (1 << 7),

  VG_sBGRA_4444                               =  5 | (1 << 7),

  VG_lBGRX_8888                               =  7 | (1 << 7),

  VG_lBGRA_8888                               =  8 | (1 << 7),

  VG_lBGRA_8888_PRE                           =  9 | (1 << 7),

  /* {A,X}BGR channel ordering */

  VG_sXBGR_8888                               =  0 | (1 << 6) | (1 << 7),

  VG_sABGR_8888                               =  1 | (1 << 6) | (1 << 7),

  VG_sABGR_8888_PRE                           =  2 | (1 << 6) | (1 << 7),

  VG_sABGR_1555                               =  4 | (1 << 6) | (1 << 7),

  VG_sABGR_4444                               =  5 | (1 << 6) | (1 << 7),

  VG_lXBGR_8888                               =  7 | (1 << 6) | (1 << 7),

  VG_lABGR_8888                               =  8 | (1 << 6) | (1 << 7),

  VG_lABGR_8888_PRE                           =  9 | (1 << 6) | (1 << 7)

} VGImageFormat;

typedef VGHandle VGImage;

typedef int VGeglImageKHR;

typedef enum {

  VG_IMAGE_QUALITY_NONANTIALIASED             = (1 << 0),

  VG_IMAGE_QUALITY_FASTER                     = (1 << 1),

  VG_IMAGE_QUALITY_BETTER                     = (1 << 2)

} VGImageQuality;

typedef enum {

  VG_IMAGE_FORMAT                             = 0x1E00,

  VG_IMAGE_WIDTH                              = 0x1E01,

  VG_IMAGE_HEIGHT                             = 0x1E02

} VGImageParamType;

typedef enum {

  VG_DRAW_IMAGE_NORMAL                        = 0x1F00,

  VG_DRAW_IMAGE_MULTIPLY                      = 0x1F01,

  VG_DRAW_IMAGE_STENCIL                       = 0x1F02

} VGImageMode;

typedef enum {

  VG_RED                                      = (1 << 3),

  VG_GREEN                                    = (1 << 2),

  VG_BLUE                                     = (1 << 1),

  VG_ALPHA                                    = (1 << 0)

} VGImageChannel;

typedef enum {

  VG_BLEND_SRC                                = 0x2000,

  VG_BLEND_SRC_OVER                           = 0x2001,

  VG_BLEND_DST_OVER                           = 0x2002,

  VG_BLEND_SRC_IN                             = 0x2003,

  VG_BLEND_DST_IN                             = 0x2004,

  VG_BLEND_MULTIPLY                           = 0x2005,

  VG_BLEND_SCREEN                             = 0x2006,

  VG_BLEND_DARKEN                             = 0x2007,

  VG_BLEND_LIGHTEN                            = 0x2008,

  VG_BLEND_ADDITIVE                           = 0x2009

} VGBlendMode;

typedef enum {

  VG_IMAGE_FORMAT_QUERY                       = 0x2100,

  VG_PATH_DATATYPE_QUERY                      = 0x2101

} VGHardwareQueryType;

typedef enum {

  VG_HARDWARE_ACCELERATED                     = 0x2200,

  VG_HARDWARE_UNACCELERATED                   = 0x2201

} VGHardwareQueryResult;

typedef enum {

  VG_VENDOR                                   = 0x2300,

  VG_RENDERER                                 = 0x2301,

  VG_VERSION                                  = 0x2302,

  VG_EXTENSIONS                               = 0x2303

} VGStringID;

typedef enum {

  VG_FONT_NUM_GLYPHS                          = 0x2F00

} VGFontParamType;

/* Function Prototypes */

#ifndef VG_API_CALL

#   if defined(SYMBIAN_VG_DLL_EXPORTS) 

#       define VG_API_CALL EXPORT_C

#   else

#       define VG_API_CALL IMPORT_C

#   endif //defined(SYMBIAN_VG_DLL_EXPORTS)

#endif

#ifndef VG_APIENTRY

#define VG_APIENTRY /* nothing */

#endif

#ifndef VG_APIEXIT

#define VG_APIEXIT __SOFTFP

#endif

VG_API_CALL VGErrorCode VG_APIENTRY

    vgGetError(void) VG_APIEXIT;

VG_API_CALL void VG_APIENTRY

    vgFlush(void) VG_APIEXIT;

VG_API_CALL void VG_APIENTRY

    vgFinish(void) VG_APIEXIT;

/* Getters and Setters */

VG_API_CALL void VG_APIENTRY

   vgSetf (VGParamType type, VGfloat value) VG_APIEXIT;

VG_API_CALL void VG_APIENTRY

    vgSeti (VGParamType type, VGint value) VG_APIEXIT;

VG_API_CALL void VG_APIENTRY

    vgSetfv(VGParamType type, VGint count,

        const VGfloat * values) VG_APIEXIT;

VG_API_CALL void VG_APIENTRY

    vgSetiv(VGParamType type, VGint count,

        const VGint * values) VG_APIEXIT;

VG_API_CALL VGfloat VG_APIENTRY

    vgGetf(VGParamType type) VG_APIEXIT;

VG_API_CALL VGint   VG_APIENTRY

    vgGeti(VGParamType type) VG_APIEXIT;

VG_API_CALL VGint   VG_APIENTRY

    vgGetVectorSize(VGParamType type) VG_APIEXIT;

VG_API_CALL void    VG_APIENTRY

    vgGetfv(VGParamType type, VGint count,

        VGfloat * values) VG_APIEXIT;

VG_API_CALL void    VG_APIENTRY

    vgGetiv(VGParamType type, VGint count,

        VGint * values) VG_APIEXIT;

VG_API_CALL void VG_APIENTRY

    vgSetParameterf(VGHandle object,

        VGint paramType,

        VGfloat value) VG_APIEXIT;

VG_API_CALL void VG_APIENTRY

    vgSetParameteri(VGHandle object,

        VGint paramType,

        VGint value) VG_APIEXIT;

VG_API_CALL void VG_APIENTRY

    vgSetParameterfv(VGHandle object,

        VGint paramType,

        VGint count,

        const VGfloat * values) VG_APIEXIT;

VG_API_CALL void VG_APIENTRY

    vgSetParameteriv(VGHandle object,

        VGint paramType,

        VGint count,

        const VGint * values) VG_APIEXIT;

VG_API_CALL VGfloat VG_APIENTRY

    vgGetParameterf(VGHandle object,

        VGint paramType) VG_APIEXIT;

VG_API_CALL VGint VG_APIENTRY

    vgGetParameteri(VGHandle object,

        VGint paramType) VG_APIEXIT;

VG_API_CALL VGint VG_APIENTRY

    vgGetParameterVectorSize(VGHandle object,

        VGint paramType) VG_APIEXIT;