os/graphics/egl/eglinterface/group/eglheaders.mmh
author sl
Tue, 10 Jun 2014 14:32:02 +0200
changeset 1 260cb5ec6c19
permissions -rw-r--r--
Update contrib.
     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