epoc32/include/gles/egl.h
author William Roberts <williamr@symbian.org>
Tue, 16 Mar 2010 16:12:26 +0000
branchSymbian2
changeset 2 2fe1408b6811
parent 0 061f57f2323e
permissions -rw-r--r--
Final list of Symbian^2 public API header files
     1 // Copyright (c) 2007-2009 Nokia Corporation and/or its subsidiary(-ies).
     2 // All rights reserved.
     3 // This component and the accompanying materials are made available
     4 // under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
     5 // which accompanies this distribution, and is available
     6 // at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
     7 //
     8 // Initial Contributors:
     9 // Nokia Corporation - initial contribution.
    10 //
    11 // Contributors:
    12 //
    13 // Description:
    14 // GLES/EGL.H
    15 // 
    16 //
    17 
    18 #ifndef __GLES_EGL_H_
    19 #define __GLES_EGL_H_
    20 
    21 /**
    22 @publishedPartner
    23 
    24 __OPENGLESHEADERS_LEGACY_EGL_1_1
    25 
    26 The purpose of this define is to allow the staged migration to
    27 EGL 1.3 from EGL 1.1 taken from the perspective of OpenGL ES 1.X
    28 
    29 If __OPENGLESHEADERS_LEGACY_EGL_1_1 is defined, then GLES/egl.h and
    30 GLES/egltypes.h will only provide the EGL 1.1 API; in particular no
    31 symbols from a later version of EGL will be seen at a source code level.
    32 This is considered to be legacy behaviour.  If
    33 __OPENGLESHEADERS_LEGACY_EGL_1_1 is not defined, the GLES/egl.h
    34 and GLES/egltypes.h header files will re-direct to the system-wide
    35 EGL/egl.h. and EGL/egltypes.h respectively.
    36 
    37 The use of GLES/egl.h or GLES/egltypes.h by applications is considered
    38 legacy behaviour because applications should instead use EGL/egl.h
    39 or EGL/egltypes.h respectively.
    40 
    41 When this legacy behaviour is desired, the define should be placed in an
    42 OEM-specific system-wide .hrh file.  Symbian product configurations
    43 never set this legacy behaviour.
    44 */
    45 #ifdef __OPENGLESHEADERS_LEGACY_EGL_1_1
    46 #include <GLES/legacy_egl_1_1/egl.h>
    47 #else
    48 #include <EGL/egl.h>
    49 #include <GLES/gl.h>
    50 #endif
    51 
    52 #endif /* __GLES_EGL_H_ */