1 // eglheaders.mmh

     2 

     3 // Copyright (c) 2008-2009 Nokia Corporation and/or its subsidiary(-ies).

     4 // All rights reserved.

     5 // This component and the accompanying materials are made available

     6 // under the terms of "Eclipse Public License v1.0"

     7 // which accompanies this distribution, and is available

     8 // at the URL "http://www.eclipse.org/legal/epl-v10.html".

     9 //

    10 // Initial Contributors:

    11 // Nokia Corporation - initial contribution.

    12 //

    13 // Contributors:

    14 //

    15 // Description:

    16 // Determines which version of EGL API is declared on this platform.

    17 // 

    18 //

    19 

    20 #ifndef __EGLHEADERS_MMH__

    21 #define __EGLHEADERS_MMH__

    22 

    23 /*

    24 @internalAll

    25 @released

    26 

    27 SYMBIAN_EGLHEADERS_API_VERSION_1_4

    28 

    29 This macro introduces the declaration of version 1.4 of EGL.  It is

    30 mutually exclusive with the macro SYMBIAN_EGLHEADERS_API_VERSION_1_3

    31 and SYMBIAN_EGLHEADERS_API_VERSION_1_2

    32 

    33 Symbian component "eglinterface" provides the declared interface for EGL

    34 Symbian component "eglimplementation" provides a reference implementation of EGL

    35 

    36 EGL implementations enable the provision of the following APIs which

    37 sit on top of EGL; the choice of *those* APIs therefore governs the version

    38 of EGL needed.  Newer versions of EGL are binary compatible with older versions

    39 of EGL so that newer EGL versions support the APIs supported by previous EGL

    40 versions.  Newer versions of EGL are source compatible with older EGL versions

    41 apart from the fact that newer EGL versions introduce new tokens as #defines

    42 and also specify the version of the EGL API in a #define.  This means that

    43 applications written to detect such #defines could have modified behaviour

    44 after a re-compile.

    45 

    46 EGL 1.4 Allows control of swap behavior (preserving back buffer contents) using

    47 the EGL_SWAP_BEHAVIOR bit in the EGL_SURFACE_TYPE EGLSurface attribute.

    48 */

    49 #define SYMBIAN_EGLHEADERS_API_VERSION_1_4

    50 

    51 /*

    52 @internalAll

    53 @released

    54 SYMBIAN_EGLHEADERS_API_VERSION_1_3

    55 

    56 This macro introduces the declaration of version 1.3 of EGL.  It is

    57 mutually exclusive with the macro SYMBIAN_EGLHEADERS_API_VERSION_1_4

    58 and SYMBIAN_EGLHEADERS_API_VERSION_1_2

    59 

    60 Symbian component "eglinterface" provides the declared interface for EGL

    61 Symbian component "eglimplementation" provides a reference implementation of EGL

    62 

    63 EGL implementations enable the provision of the following APIs which

    64 sit on top of EGL; the choice of *those* APIs therefore governs the version

    65 of EGL needed.  Newer versions of EGL are binary compatible with older versions

    66 of EGL so that newer EGL versions support the APIs supported by previous EGL

    67 versions.  Newer versions of EGL are source compatible with older EGL versions

    68 apart from the fact that newer EGL versions introduce new tokens as #defines

    69 and also specify the version of the EGL API in a #define.  This means that

    70 applications written to detect such #defines could have modified behaviour

    71 after a re-compile.

    72 

    73 EGL 1.1 adds OpenGL ES 1.X support

    74 EGL 1.2 adds OpenVG support

    75 EGL 1.3 adds OpenGL ES 2.0 support

    76 */

    77 //#define SYMBIAN_EGLHEADERS_API_VERSION_1_3

    78 

    79 /*

    80 @internalAll

    81 @released

    82 

    83 SYMBIAN_EGLHEADERS_API_VERSION_1_2

    84 

    85 This macro introduces the declaration of version 1.2 of EGL.  It is

    86 mutually exclusive with the macro SYMBIAN_EGLHEADERS_API_VERSION_1_4

    87 and SYMBIAN_EGLHEADERS_API_VERSION_1_3

    88 

    89 @see SYMBIAN_EGLHEADERS_API_VERSION_1_3

    90 */

    91 //#define SYMBIAN_EGLHEADERS_API_VERSION_1_2

    92 

    93 

    94 #endif