|
1 <?xml version="1.0" encoding="utf-8"?> |
|
2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
|
3 <!-- This component and the accompanying materials are made available under the terms of the License |
|
4 "Eclipse Public License v1.0" which accompanies this distribution, |
|
5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
|
6 <!-- Initial Contributors: |
|
7 Nokia Corporation - initial contribution. |
|
8 Contributors: |
|
9 --> |
|
10 <!DOCTYPE concept |
|
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
|
12 <concept id="GUID-A5914CFF-6F86-53E8-9928-36D3379835B1" xml:lang="en"><title>EGL |
|
13 Interface Overview</title><shortdesc>The EGL Interface component defines the interface to EGL on the |
|
14 Symbian platform. The component standardizes the source and binary interfaces |
|
15 by providing header and LIB/DSO files for EGL users as well as DEF files for |
|
16 EGL implementers. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
17 <section><title>Supported APIs</title> <p>The EGL specifications are defined |
|
18 by the Khronos Group (<xref href="http://www.khronos.org" scope="external">www.khronos.org</xref>). |
|
19 The following table provides links to the relevant specifications. </p> <table id="GUID-43D6B812-B4AB-506E-8159-61FA0DEC6F2A"> |
|
20 <tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/> |
|
21 <thead> |
|
22 <row> |
|
23 <entry>APIs</entry> |
|
24 <entry>Specification</entry> |
|
25 </row> |
|
26 </thead> |
|
27 <tbody> |
|
28 <row> |
|
29 <entry>EGL 1.4 </entry> |
|
30 <entry><xref href="http://www.khronos.org/registry/egl/specs/eglspec.1.4.pdf" scope="external">http://www.khronos.org/registry/egl/specs/eglspec.1.4.pdf</xref> </entry> |
|
31 </row> |
|
32 <row> |
|
33 <entry>EGL 1.3 </entry> |
|
34 <entry><xref href="http://www.khronos.org/registry/egl/specs/eglspec.1.3.pdf" scope="external">http://www.khronos.org/registry/egl/specs/eglspec.1.3.pdf </xref> </entry> |
|
35 </row> |
|
36 <row> |
|
37 <entry>EGL 1.2 </entry> |
|
38 <entry><xref href="http://www.khronos.org/files/egl_1_2.pdf" scope="external">http://www.khronos.org/files/egl_1_2.pdf</xref> </entry> |
|
39 </row> |
|
40 </tbody> |
|
41 </tgroup> |
|
42 </table> </section> |
|
43 <section><title>Header files</title> <p>The EGL Interface component includes |
|
44 the Khronos-released header file, <filepath>egl.h</filepath>, and <filepath>egltypes.h</filepath>, |
|
45 which is the Symbian equivalent of the Khronos <filepath>eglplatform.h</filepath>. |
|
46 Use of the header files supplied in the EGL Interface component helps to ensure |
|
47 binary compatibility for applications across different Symbian platforms. |
|
48 It also provides source compatibility between different operating systems. |
|
49 These header files incorporate minor changes such as Doxygen tags (/** comments) |
|
50 but these have no effect on the functionality. </p> <p>The header files are |
|
51 provided for EGL 1.2, 1.3 and 1.4. The EGL 1.4 headers are used by default. |
|
52 However, there is a variability point that can expose the headers for EGL |
|
53 1.3 or 1.2 instead. </p> <p>The Symbian-defined header file <filepath>\epoc32\include\khronos_types.h</filepath> maps |
|
54 the Khronos-defined basic types to native Symbian types. </p> </section> |
|
55 <section><title> Library file</title> <p>The following library is provided |
|
56 by the EGL Interface component. </p> <table id="GUID-0AA8A4D7-72F2-5C6D-A32B-11CB5631F5E0"> |
|
57 <tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/> |
|
58 <thead> |
|
59 <row> |
|
60 <entry>Library</entry> |
|
61 <entry>Name</entry> |
|
62 </row> |
|
63 </thead> |
|
64 <tbody> |
|
65 <row> |
|
66 <entry>EGL </entry> |
|
67 <entry><filepath> libEGL.lib</filepath> </entry> |
|
68 </row> |
|
69 </tbody> |
|
70 </tgroup> |
|
71 </table> </section> |
|
72 <section><title> DEF files</title> <p>The EGL Interface component also supplies |
|
73 DEF files to further ensure binary compatibility between different platforms. |
|
74 These files exist for the WINS and WINSCW emulator and ARM hardware platforms. |
|
75 Although the names have a trailing 'u', this is not specified by MMP file |
|
76 entries as it is appended to references automatically. </p> <p><b>DEF files |
|
77 for WINS and WINSCW </b> </p> <table id="GUID-1FF2D995-AAB9-5B86-9EAD-C6E533A7B339"> |
|
78 <tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/> |
|
79 <thead> |
|
80 <row> |
|
81 <entry>Library</entry> |
|
82 <entry>Name</entry> |
|
83 </row> |
|
84 </thead> |
|
85 <tbody> |
|
86 <row> |
|
87 <entry>EGL 1.4 </entry> |
|
88 <entry><filepath>\epoc32\include\platform\def\win32\libegl14u.def </filepath> </entry> |
|
89 </row> |
|
90 <row> |
|
91 <entry>EGL 1.3 </entry> |
|
92 <entry><filepath>\epoc32\include\platform\def\win32\libegl13u.def </filepath> </entry> |
|
93 </row> |
|
94 <row> |
|
95 <entry>EGL 1.2 </entry> |
|
96 <entry><filepath>\epoc32\include\platform\def\win32\libegl12u.def </filepath> </entry> |
|
97 </row> |
|
98 </tbody> |
|
99 </tgroup> |
|
100 </table> <p><b>DEF files for ARM </b> </p> <table id="GUID-153A4DF2-F1AA-5878-914C-D6D4A7270549"> |
|
101 <tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/> |
|
102 <thead> |
|
103 <row> |
|
104 <entry>Library</entry> |
|
105 <entry>Name</entry> |
|
106 </row> |
|
107 </thead> |
|
108 <tbody> |
|
109 <row> |
|
110 <entry>EGL 1.4 </entry> |
|
111 <entry><filepath>\epoc32\include\platform\def\eabi\libegl14u.def </filepath> </entry> |
|
112 </row> |
|
113 <row> |
|
114 <entry>EGL 1.3 </entry> |
|
115 <entry><filepath>\epoc32\include\platform\def\eabi\libegl13u.def </filepath> </entry> |
|
116 </row> |
|
117 <row> |
|
118 <entry>EGL 1.2 </entry> |
|
119 <entry><filepath>\epoc32\include\platform\def\eabi\libegl12u.def </filepath> </entry> |
|
120 </row> |
|
121 </tbody> |
|
122 </tgroup> |
|
123 </table> </section> |
|
124 </conbody><related-links> |
|
125 <link href="GUID-D252E75C-C8CA-5C51-8DA3-95B937A1295C.dita"><linktext>EGL Interface |
|
126 Component</linktext></link> |
|
127 </related-links></concept> |