os/graphics/egl/eglinterface/group/eglheaders.mmh
author sl@SLION-WIN7.fritz.box
Fri, 15 Jun 2012 03:10:57 +0200
changeset 0 bde4ae8d615e
permissions -rw-r--r--
First public contribution.
sl@0
     1
// eglheaders.mmh
sl@0
     2
sl@0
     3
// Copyright (c) 2008-2009 Nokia Corporation and/or its subsidiary(-ies).
sl@0
     4
// All rights reserved.
sl@0
     5
// This component and the accompanying materials are made available
sl@0
     6
// under the terms of "Eclipse Public License v1.0"
sl@0
     7
// which accompanies this distribution, and is available
sl@0
     8
// at the URL "http://www.eclipse.org/legal/epl-v10.html".
sl@0
     9
//
sl@0
    10
// Initial Contributors:
sl@0
    11
// Nokia Corporation - initial contribution.
sl@0
    12
//
sl@0
    13
// Contributors:
sl@0
    14
//
sl@0
    15
// Description:
sl@0
    16
// Determines which version of EGL API is declared on this platform.
sl@0
    17
// 
sl@0
    18
//
sl@0
    19
sl@0
    20
#ifndef __EGLHEADERS_MMH__
sl@0
    21
#define __EGLHEADERS_MMH__
sl@0
    22
sl@0
    23
/*
sl@0
    24
@internalAll
sl@0
    25
@released
sl@0
    26
sl@0
    27
SYMBIAN_EGLHEADERS_API_VERSION_1_4
sl@0
    28
sl@0
    29
This macro introduces the declaration of version 1.4 of EGL.  It is
sl@0
    30
mutually exclusive with the macro SYMBIAN_EGLHEADERS_API_VERSION_1_3
sl@0
    31
and SYMBIAN_EGLHEADERS_API_VERSION_1_2
sl@0
    32
sl@0
    33
Symbian component "eglinterface" provides the declared interface for EGL
sl@0
    34
Symbian component "eglimplementation" provides a reference implementation of EGL
sl@0
    35
sl@0
    36
EGL implementations enable the provision of the following APIs which
sl@0
    37
sit on top of EGL; the choice of *those* APIs therefore governs the version
sl@0
    38
of EGL needed.  Newer versions of EGL are binary compatible with older versions
sl@0
    39
of EGL so that newer EGL versions support the APIs supported by previous EGL
sl@0
    40
versions.  Newer versions of EGL are source compatible with older EGL versions
sl@0
    41
apart from the fact that newer EGL versions introduce new tokens as #defines
sl@0
    42
and also specify the version of the EGL API in a #define.  This means that
sl@0
    43
applications written to detect such #defines could have modified behaviour
sl@0
    44
after a re-compile.
sl@0
    45
sl@0
    46
EGL 1.4 Allows control of swap behavior (preserving back buffer contents) using
sl@0
    47
the EGL_SWAP_BEHAVIOR bit in the EGL_SURFACE_TYPE EGLSurface attribute.
sl@0
    48
*/
sl@0
    49
#define SYMBIAN_EGLHEADERS_API_VERSION_1_4
sl@0
    50
sl@0
    51
/*
sl@0
    52
@internalAll
sl@0
    53
@released
sl@0
    54
SYMBIAN_EGLHEADERS_API_VERSION_1_3
sl@0
    55
sl@0
    56
This macro introduces the declaration of version 1.3 of EGL.  It is
sl@0
    57
mutually exclusive with the macro SYMBIAN_EGLHEADERS_API_VERSION_1_4
sl@0
    58
and SYMBIAN_EGLHEADERS_API_VERSION_1_2
sl@0
    59
sl@0
    60
Symbian component "eglinterface" provides the declared interface for EGL
sl@0
    61
Symbian component "eglimplementation" provides a reference implementation of EGL
sl@0
    62
sl@0
    63
EGL implementations enable the provision of the following APIs which
sl@0
    64
sit on top of EGL; the choice of *those* APIs therefore governs the version
sl@0
    65
of EGL needed.  Newer versions of EGL are binary compatible with older versions
sl@0
    66
of EGL so that newer EGL versions support the APIs supported by previous EGL
sl@0
    67
versions.  Newer versions of EGL are source compatible with older EGL versions
sl@0
    68
apart from the fact that newer EGL versions introduce new tokens as #defines
sl@0
    69
and also specify the version of the EGL API in a #define.  This means that
sl@0
    70
applications written to detect such #defines could have modified behaviour
sl@0
    71
after a re-compile.
sl@0
    72
sl@0
    73
EGL 1.1 adds OpenGL ES 1.X support
sl@0
    74
EGL 1.2 adds OpenVG support
sl@0
    75
EGL 1.3 adds OpenGL ES 2.0 support
sl@0
    76
*/
sl@0
    77
//#define SYMBIAN_EGLHEADERS_API_VERSION_1_3
sl@0
    78
sl@0
    79
/*
sl@0
    80
@internalAll
sl@0
    81
@released
sl@0
    82
sl@0
    83
SYMBIAN_EGLHEADERS_API_VERSION_1_2
sl@0
    84
sl@0
    85
This macro introduces the declaration of version 1.2 of EGL.  It is
sl@0
    86
mutually exclusive with the macro SYMBIAN_EGLHEADERS_API_VERSION_1_4
sl@0
    87
and SYMBIAN_EGLHEADERS_API_VERSION_1_3
sl@0
    88
sl@0
    89
@see SYMBIAN_EGLHEADERS_API_VERSION_1_3
sl@0
    90
*/
sl@0
    91
//#define SYMBIAN_EGLHEADERS_API_VERSION_1_2
sl@0
    92
sl@0
    93
sl@0
    94
#endif