FCL/sf/os/graphics: opengles/openglesinterface/documentation/implementers

0 5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	1	<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><title>Khronos API Implementers' Guidelines</title><link rel="stylesheet" href="igstyle.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.69.1"><meta name="description" content="Guidelines to be followed by implementers of Khronos Group
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	2	APIs"><style type="text/css">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	3	body { background-image: url('draft.png');
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	4	background-repeat: no-repeat;
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	5	background-position: top left;
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	6	/* The following properties make the watermark "fixed" on the page. */
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	7	/* I think that's just a bit too distracting for the reader... */
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	8	/* background-attachment: fixed; */
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	9	/* background-position: center center; */
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	10	}</style></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="article" lang="en"><div class="titlepage"><div><div><h1 class="title"><a name="id4739083"></a>Khronos API Implementers' Guidelines</h1></div><div><div class="authorgroup"><h4 class="editedby">Edited by</h4><h3 class="editor"><span class="firstname">Mark</span> <span class="surname">Callow</span></h3><div class="affiliation"><span class="orgname">HI Corporation<br></span></div><code class="email"><<a href="mailto:callow_mark%20at%20hicorp.co.jp">callow_mark at hicorp.co.jp</a>></code><p></p></div></div><div><p class="copyright">Copyright © 2007 The Khronos Group Inc.</p></div><div><div class="legalnotice"><a name="legal"></a><p>This document is protected by copyright laws and contains
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	11	material proprietary to the Khronos Group, Inc. It or any components
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	12	may not be reproduced, republished, distributed, transmitted,
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	13	displayed, broadcast or otherwise exploited in any manner without
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	14	the express prior written permission of Khronos Group.
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	15	The receipt or possession of this
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	16	document does not convey any rights to reproduce, disclose, or
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	17	distribute its contents, or to manufacture, use, or sell anything
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	18	that it may describe, in whole or in part.</p><p>Khronos Group grants express permission to any current Promoter,
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	19	Contributor or Adopter member of Khronos to copy and redistribute
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	20	UNMODIFIED versions of this document in any fashion, provided
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	21	that NO CHARGE is made for the document and the latest available
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	22	update of the document is used whenever possible.
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	23	Such distributed document may be
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	24	re-formatted AS LONG AS the contents of the document are not
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	25	changed in any way. The document may be incorporated into a
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	26	product that is sold as long as such product includes significant
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	27	independent work developed by the seller. A link to the current
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	28	version of this document on the Khronos Group web-site should
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	29	be included whenever possible with document distributions.</p><p>Khronos Group makes no, and expressly disclaims any,
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	30	representations or warranties, express or implied, regarding this
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	31	document, including, without limitation, any implied warranties
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	32	of merchantability or fitness for a particular purpose or
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	33	non-infringement of any intellectual property. Khronos Group makes
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	34	no, and expressly disclaims any, warranties, express or implied,
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	35	regarding the correctness, accuracy, completeness, timeliness, and
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	36	reliability of the document. Under no circumstances will the Khronos
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	37	Group, or any of its Promoters, Contributors or Members or their
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	38	respective partners, officers, directors, employees, agents or
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	39	representatives be liable for any damages, whether direct, indirect,
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	40	special or consequential damages for lost revenues, lost profits,
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	41	or otherwise, arising from or in connection with these
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	42	materials.</p><p><span class="trademark">Khronos</span>™ is a trademark of
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	43	The Khronos Group Inc. <span class="trademark">OpenGL</span>®
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	44	is a registered trademark, and
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	45	<span class="trademark">OpenGL ES</span>™is a trademark, of
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	46	Silicon Graphics, Inc.</p></div></div><div><div class="revhistory"><table border="1" width="100%" summary="Revision history"><tr><th align="left" valign="top" colspan="3"><b>Revision History</b></th></tr><tr><td align="left">Revision 0.9.0</td><td align="left">2006-12-08 19:15:11 -0800</td><td align="left">msc</td></tr><tr><td align="left" colspan="3">First docbook version</td></tr><tr><td align="left">Revision 0.91.0</td><td align="left">2006-12-12 17:26:03 -0800</td><td align="left">msc</td></tr><tr><td align="left" colspan="3">Public review version: amended copyright notice; changed OpenKODE and GLES utility library names.</td></tr></table></div></div><div><div class="abstract"><p class="title"><b>Abstract</b></p><p>Guidelines to be followed by implementers of Khronos Group
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	47	<em class="glossterm">APIs</em></p></div></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#introduction">Introduction</a></span></dt><dt><span class="section"><a href="#generalguidelines">General Guidelines </a></span></dt><dd><dl><dt><span class="section"><a href="#controlled">Vendor Controlled Platforms (e.g. BREW, SymbianOS)</a></span></dt><dt><span class="section"><a href="#uncontrolled">Uncontrolled Platforms (e.g. GNU/Linux, Windows, Windows CE)</a></span></dt></dl></dd><dt><span class="section"><a href="#id4787332">Acknowledgements</a></span></dt><dt><span class="glossary"><a href="#id4787444">Glossary</a></span></dt></dl></div><div class="list-of-tables"><p><b>List of Tables</b></p><dl><dt>1. <a href="#id4713194">Header File Names and Locations</a></dt><dt>2. <a href="#id4786950">Recommended Library Names</a></dt></dl></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="introduction"></a>Introduction</h2></div></div></div><p> This document provides guidelines for
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	48	<a href="#gls_implementer"><em class="firstterm">implementers
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	49	</em></a>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	50	of OpenGL ES, OpenVG and other <a href="#gls_api"><em class="firstterm">API</em></a>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	51	standards specified by the Khronos Group.
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	52	The aim of these hints is to provide commonality between implementations to
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	53	ease the logistical problems faced by developers using multiple different
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	54	implementations of an <em class="glossterm">API</em>.
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	55	</p><p> One of the primary goals is to allow an application binary to run
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	56	on top of multiple different OpenGL ES / OpenVG / EGL implementations
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	57	on the same platform. </p><p> Implementers are strongly urged to comply with these guidelines.
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	58	</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="generalguidelines"></a>General Guidelines </h2></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="controlled"></a>Vendor Controlled Platforms (e.g. BREW, SymbianOS)</h3></div></div></div><p> Implementers should follow the linkage specifications established
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	59	by the
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	60	<a href="#gls_vendor"><em class="firstterm">platform vendor</em></a>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	61	.
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	62	</p><div class="itemizedlist"><ul type="opencircle"><li style="list-style-type: circle"><p> Use the header files, (e.g., for OpenGL ES, gl.h & egl.h)
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	63	provided by the platform vendor. </p></li><li style="list-style-type: circle"><p> Use the function names specified in those header files. </p></li><li style="list-style-type: circle"><p>Implement all <em class="glossterm">API</em>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	64	entry points in the same way as in the
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	65	<em class="glossterm">vendor</em>-provided
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	66	<a href="#gls_abi"><em class="firstterm">ABI</em></a>. That is,
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	67	functions should be functions, in-line functions should be
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	68	in-line functions and macros should be macros.
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	69	</p></li><li style="list-style-type: circle"><p> Use the platform specified library names. </p></li></ul></div><p>Vendors of controlled platforms are strongly urged to follow the
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	70	recommendations given below for <a href="#uncontrolled" title="Uncontrolled Platforms (e.g. GNU/Linux, Windows, Windows CE)">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	71	Uncontrolled Platforms</a> when adding a Khronos Group
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	72	<em class="glossterm">API</em> to their platform.
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	73	</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="uncontrolled"></a>Uncontrolled Platforms (e.g. GNU/Linux, Windows, Windows CE)</h3></div></div></div><p> When providing implementations for platforms where the vendor
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	74	does not provide standard linkage specifications, implementers
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	75	are urged to follow the following recommendations.</p><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="headerfiles"></a> Header Files </h4></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="hfgeneral"></a>General</h5></div></div></div><div class="itemizedlist"><ul type="disc"><li><p>Use the Khronos provided header files (e.g., for OpenGL
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	76	ES, <code class="filename">gl.h</code> &
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	77	<code class="filename">egl.h</code>). If changes are
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	78	unavoidable, consider contributing your changes back to Khronos
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	79	by updating the standard header files in the Khronos Subversion
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	80	tree. </p></li><li><p> If you make your own header files and the platform is
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	81	Windows, make sure they are suitable for use with
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	82	<a href="#gls_mfc"><em class="firstterm"><span class="acronym">MFC</span></em></a>.
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	83	For example
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	84	<code class="code">#define EGL_DEFAULT_DISPLAY GetDC(0)</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	85	is broken for MFC. You need to use
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	86	<code class="code">::GetDC(0)</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	87	because several MFC have their own
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	88	<code class="code">GetDC(void)</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	89	methods.</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="hfegl"></a>EGL</h5></div></div></div><div class="itemizedlist"><ul type="disc"><li><p> Package the EGL header files
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	90	<code class="filename">egl.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	91	and
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	92	<code class="filename">eglplatform.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	93	in the folder
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	94	<code class="filename">EGL</code>.
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	95	</p></li><li><p> <code class="filename">eglplatform.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	96	contains platform
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	97	dependent items and needs to be modified by the implementer.
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	98	In particular the
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	99	<span class="type">eglNativeDisplayType</span>,
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	100	<span class="type">eglNativeWindowType</span>, and
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	101	<span class="type">eglNativePixmapType</span>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	102	typedefs must be defined as appropriate for the platform
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	103	(typically, they will be typedef'ed to corresponding types
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	104	in the native window system). Developer documentation should
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	105	mention the correspondence so that developers know what
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	106	parameters to pass to
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	107	<code class="function">eglCreateWindowSurface</code>,
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	108	<code class="function">eglCreatePixmapSurface</code>, and
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	109	<code class="function">eglCopyBuffers</code>.
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	110	Documentation should also describe the format of the
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	111	<em class="parameter"><code>display_id</code></em>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	112	parameter to
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	113	<code class="function">eglGetDisplay</code>,
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	114	since this is a platform-specific identifier.</p></li><li><p> Include
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	115	<code class="filename">eglplatform.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	116	in
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	117	<code class="filename">egl.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	118	thus:
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	119	<code class="code">#include <EGL/eglplatform.h></code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	120	. Do not use
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	121	<code class="code">#include <eglplatform.h></code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	122	because app. makefiles will then need 2 different
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	123	<em class="parameter"><code>-I<path></code></em>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	124	options to find both include files. </p></li><li><p> Do not include
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	125	<code class="filename">gl.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	126	in
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	127	<code class="filename">egl.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	128	. </p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="hfgles1x"></a> OpenGL ES 1.x </h5></div></div></div><div class="itemizedlist"><ul type="disc"><li><p> Package the OpenGL ES header files
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	129	<code class="filename">gl.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	130	and
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	131	<code class="filename">glplatform.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	132	in the folder
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	133	<code class="filename">GLES</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	134	. </p></li><li><p> <code class="filename">glplatform.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	135	contains platform dependent items and may need to be
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	136	modified by the implementer. Implementers are encouraged
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	137	to provide their additions for newly supported platforms
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	138	to the Khronos Group for inclusion in the Adopters'
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	139	distribution.</p></li><li><p> For compatibility with GLES 1.0 implementations, include
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	140	in
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	141	<code class="filename">GLES</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	142	a special
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	143	<code class="filename">egl.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	144	containing the following:
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	145	</p><div class="informalexample"><pre class="programlisting">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	146	#include <EGL/egl.h>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	147	#include <GLES/gl.h></pre></div><p>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	148	This is because many early OpenGL ES 1.0 implementations
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	149	included
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	150	<code class="filename">gl.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	151	in
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	152	<code class="filename">egl.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	153	so many existing applications only include
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	154	<code class="filename">egl.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	155	. </p></li><li><p>The name <code class="filename">glu.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	156	is reserved for future use by the Khronos Group.</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="hfgles2x"></a> OpenGL ES 2.x </h5></div></div></div><div class="itemizedlist"><ul type="disc"><li><p>The core header files for OpenGL ES 2.x are called
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	157	<code class="filename">gl2.h</code> and
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	158	<code class="filename">gl2platform.h</code> to
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	159	keep them distinct from the GLES 1.x header files and enable
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	160	application to use both versions.</p></li><li><p>The function declarations and constant definitions for
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	161	OpenGL ES 2.x are divided into 2 header files:
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	162	<code class="filename">gl2.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	163	declares and defines all the core functions and constants;
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	164	<code class="filename">gl2ext.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	165	declares and defines functions and constants for all
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	166	Khronos approved extensions and can be used even if the
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	167	implementation doesn't provide a particular extension.</p><p>Functions and constants for Implementer
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	168	extensions should be declared and defined in an implementer's
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	169	own header file using names and constant values obtained from
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	170	the Khronos Group's Extension Registry.</p></li><li><p>Package all these header files in the folder
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	171	<code class="filename">GLES2</code>.</p></li><li><p>The name <code class="filename">glu2.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	172	is reserved for future use by the Khronos Group.</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="hfopenkode"></a>OpenKODE</h5></div></div></div><div class="itemizedlist"><ul type="disc"><li><p>Package the OpenKODE header files
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	173	<code class="filename">kd.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	174	and
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	175	<code class="filename">kdplatform.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	176	in the folder
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	177	<code class="filename">KD</code>.
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	178	</p></li><li><p>Implementers are encouraged to code
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	179	<code class="filename">kd.h</code> such that it
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	180	includes as few as possible of the platform's include files,
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	181	and to avoid declaring C and POSIX standard functions. This
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	182	will ease the creation of portable OpenKODE applications,
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	183	and help stop non-portable code being added accidentally.
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	184	</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="hfopenvg"></a>OpenVG</h5></div></div></div><div class="itemizedlist"><ul type="disc"><li><p>Package the OpenVG header files
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	185	<code class="filename">openvg.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	186	and, when provided,
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	187	<code class="filename">vgu.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	188	in the folder
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	189	<code class="filename">VG</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	190	.</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="hfsummary"></a>Header File Summary</h5></div></div></div><div class="table"><a name="id4713194"></a><p class="title"><b>Table 1. Header File Names and Locations</b></p><table summary="Header File Names and Locations" border="1"><colgroup><col align="left"><col align="left"><col align="left"><col align="left"><col align="left"></colgroup><thead><tr><th align="left"> API </th><th align="left"> Location </th><th align="left"> Header Files </th><th align="left"> How to include </th><th align="left"> Provider </th></tr></thead><tbody><tr><td rowspan="2" align="left" valign="top"> EGL 1.x </td><td rowspan="2" align="left" valign="top">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	191	<code class="filename">EGL</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	192	</td><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	193	<code class="filename">egl.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	194	</td><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	195	<code class="code">#include <EGL/egl.h></code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	196	</td><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	197	Khronos
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	198	</td></tr><tr><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	199	<code class="filename">eglplatform.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	200	<sup>[<a name="id4713330" href="#ftn.id4713330">1</a>]</sup>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	201	</td><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	202	Included by <code class="filename">egl.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	203	</td><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	204	Vendor or Implementer
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	205	</td></tr><tr><td rowspan="3" align="left" valign="top"> OpenGL ES 1.x </td><td rowspan="3" align="left" valign="top">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	206	<code class="filename">GLES</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	207	</td><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	208	<code class="filename">gl.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	209	</td><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	210	<code class="code">#include <GLES/gl.h></code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	211	</td><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	212	Khronos
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	213	</td></tr><tr><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	214	<code class="filename">glplatform.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	215	<sup>[<a name="id4713439" href="#ftn.id4713439">2</a>]</sup>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	216	</td><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	217	Included by <code class="filename">gl.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	218	</td><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	219	Vendor or Implementer
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	220	</td></tr><tr><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	221	<code class="filename">glu.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	222	</td><td colspan="2" align="center">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	223	Reserved for future use
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	224	</td></tr><tr><td rowspan="4" align="left" valign="top"> OpenGL ES 2.x </td><td rowspan="4" align="left" valign="top">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	225	<code class="filename">GLES2</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	226	</td><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	227	<code class="filename">gl2.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	228	</td><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	229	<code class="code">#include <GLES2/gl2.h></code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	230	</td><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	231	Khronos
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	232	</td></tr><tr><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	233	<code class="filename">gl2platform.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	234	</td><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	235	Included by <code class="filename">gl2.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	236	</td><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	237	Vendor or Implementer
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	238	</td></tr><tr><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	239	<code class="filename">gl2ext.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	240	</td><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	241	<code class="code">#include <GLES2/gl2ext.h></code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	242	</td><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	243	Khronos
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	244	</td></tr><tr><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	245	<code class="filename">glu2.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	246	</td><td colspan="2" align="center">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	247	Reserved for future use
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	248	</td></tr><tr><td rowspan="2" align="left" valign="top"> OpenKODE 1.x </td><td rowspan="2" align="left" valign="top">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	249	<code class="filename">KD</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	250	</td><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	251	<code class="filename">kd.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	252	</td><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	253	<code class="code">#include <KD/kd.h></code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	254	</td><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	255	Khronos
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	256	</td></tr><tr><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	257	<code class="filename">kdplatform.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	258	</td><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	259	Included by <code class="filename">kd.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	260	</td><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	261	Vendor or Implementer
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	262	</td></tr><tr><td rowspan="2" align="left" valign="top"> OpenVG 1.x </td><td rowspan="2" align="left" valign="top">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	263	<code class="filename">VG</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	264	</td><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	265	<code class="filename">openvg.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	266	</td><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	267	<code class="code">#include <VG/openvg.h></code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	268	</td><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	269	Khronos
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	270	</td></tr><tr><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	271	<code class="filename">vgu.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	272	<sup>[<a name="id4786686" href="#ftn.id4786686">3</a>]</sup>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	273	</td><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	274	<code class="code">#include <VG/vgu.h></code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	275	</td><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	276	Khronos
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	277	</td></tr></tbody></table><div class="footnotes"><div class="footnote"><p><sup>[<a name="ftn.id4713330" href="#id4713330">1</a>] </sup>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	278	Many early EGL implementations used
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	279	<code class="filename">egltypes.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	280	instead of the now recommended
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	281	<code class="filename">eglplatform.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	282	.</p></div><div class="footnote"><p><sup>[<a name="ftn.id4713439" href="#id4713439">2</a>] </sup>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	283	<code class="filename">glplatform.h</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	284	does not exist in many early implementations of
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	285	OpenGL ES 1.x. Platform dependent declarations were
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	286	included directly in <code class="filename">gl.h
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	287	</code>.</p></div><div class="footnote"><p><sup>[<a name="ftn.id4786686" href="#id4786686">3</a>] </sup>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	288	Required, if the OpenVG utility library is provided.
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	289	</p></div></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="notes"></a>Notes </h5></div></div></div><div class="itemizedlist"><ul type="disc"><li><p>To find the include files, use appropriate compiler
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	290	options in the makefiles for your sample programs; e.g.
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	291	<em class="parameter"><code>-I</code></em> (gcc, linux) or
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	292	<em class="parameter"><code>/I</code></em> (Visual C++).
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	293	</p></li><li><p>Given the different IDEs & compilers people use,
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	294	especially on Windows, it is not possible to recommend a system
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	295	location to place these include files. Where obvious choices
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	296	exist Khronos recommends implementers take advantage of them.
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	297	</p></li><li><p>In particular, GNU/Linux implementations should
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	298	follow the
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	299	<a href="http://www.pathname.com/fhs/" target="_top">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	300	<em class="citetitle">Filesystem Hierarchy Standard</em>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	301	</a>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	302	for location of headers and libraries.
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	303	</p></li></ul></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="libraries"></a>Libraries</h4></div></div></div><div class="itemizedlist"><ul type="disc"><li><p>It is highly desirable to implement all
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	304	<em class="glossterm">API</em> entry points as
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	305	function calls. However in the OpenKODE core, macros or in-lines
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	306	may be used instead of a function call provided the following
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	307	rules are followed:
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	308	</p><div class="itemizedlist"><ul type="circle"><li><p>When calling a function, each argument must be evaluated
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	309	exactly once (although the order of evaluation is
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	310	undefined).</p></li><li><p>It must be possible to take the address of function.
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	311	</p></li></ul></div></li><li><p>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	312	Except in cases where macros are allowed, ensure the
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	313	<em class="glossterm">API</em> function
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	314	names exported by your lib & dll files match the function
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	315	names specified by the Khronos standard for the
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	316	<em class="glossterm">API</em> you are
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	317	implementing.
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	318	</p></li></ul></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="lpackaging"></a>Packaging</h5></div></div></div><div class="itemizedlist"><ul type="disc"><li><p>OpenGL ES, EGL, OpenVG and OpenKODE entry points should
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	319	be packaged in separate libraries.</p></li><li><p>However to provide backward compatibility for existing
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	320	applications, two OpenGL ES 1.1 libraries should be provided:
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	321	one with and one without the EGL entry points.</p><p>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	322	<span class="emphasis"><em>Note: There are extant implementations of the dual
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	323	OpenGL ES libraries demonstrating this is possible on Symbian,
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	324	GNU/Linux, Win32 and WinCE.</em></span>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	325	</p><p>For OpenGL ES 2.x, only a library without EGL entry points
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	326	is needed.</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="lnaming"></a>Naming</h5></div></div></div><p>Khronos recommends the library names shown in the following
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	327	table: </p><div class="table"><a name="id4786950"></a><p class="title"><b>Table 2. Recommended Library Names</b></p><table summary="Recommended Library Names" border="1"><colgroup><col align="left"><col align="left"></colgroup><thead><tr><th align="left"> API/Entry Points </th><th align="left"> Name </th></tr></thead><tbody><tr><td align="left"> EGL </td><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	328	<code class="filename">libEGL.{lib,dll}</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	329	</td></tr><tr><td align="left"> OpenGL ES 1.x with EGL (Common Profile)</td><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	330	<code class="filename">libGLES_CM.{lib,dll}</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	331	<sup>[<a name="fnreq" href="#ftn.fnreq">1</a>]</sup>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	332	<sup>[<a name="fndepr" href="#ftn.fndepr">2</a>]</sup>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	333	</td></tr><tr><td align="left"> OpenGL ES 1.x with EGL (Lite Profile) </td><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	334	<code class="filename">libGLES_CL.{lib,dll}</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	335	<sup>[<a href="#ftn.fnreq">1</a>]</sup>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	336	<sup>[<a href="#ftn.fndepr">2</a>]</sup>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	337	</td></tr><tr><td align="left"> OpenGL ES 1.x without EGL </td><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	338	<code class="filename">libGLESv1_C[LM].{lib,dll}</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	339	<sup>[<a name="fnsprev" href="#ftn.fnsprev">3</a>]</sup>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	340	</td></tr><tr><td align="left"> OpenGL ES 2.x without EGL </td><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	341	<code class="filename">libGLESv2.{lib,dll}</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	342	</td></tr><tr><td align="left"> </td><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	343	<code class="filename">libGLUESv1.{lib,dll}</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	344	<sup>[<a name="fnreserved" href="#ftn.fnreserved">4</a>]</sup>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	345	</td></tr><tr><td align="left"> </td><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	346	<code class="filename">libGLUESv2.{lib,dll}</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	347	<sup>[<a href="#ftn.fnreserved">4</a>]</sup>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	348	</td></tr><tr><td align="left"> OpenKODE </td><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	349	<code class="filename">libKD{lib,dll}</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	350	</td></tr><tr><td align="left"> OpenVG </td><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	351	<code class="filename">libOpenVG{lib,dll}</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	352	</td></tr><tr><td align="left"> OpenVG Utilities (when present) </td><td align="left">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	353	<code class="filename">libOpenVGU.{lib,dll}</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	354	</td></tr></tbody></table><div class="footnotes"><div class="footnote"><p><sup>[<a name="ftn.fnreq" href="#fnreq">1</a>] </sup> These names are required for OpenGL ES 1.0
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	355	and the libraries must contain the EGL entry points
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	356	as detailed in Chapter 8,
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	357	<span class="emphasis"><em>Packaging</em></span>,
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	358	of the OpenGL ES 1.0 specification.</p></div><div class="footnote"><p><sup>[<a name="ftn.fndepr" href="#fndepr">2</a>] </sup> These names are deprecated for OpenGL ES 1.1
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	359	and beyond and should only be used for a library
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	360	that includes the EGL entry points in order to support
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	361	legacy applications. </p></div><div class="footnote"><p><sup>[<a name="ftn.fnsprev" href="#fnsprev">3</a>] </sup>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	362	<span class="emphasis"><em>The OpenGL ES 1.1 specification at revision 1.1.09
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	363	was updated to specify these alternate names for GLES
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	364	libraries that do not contain the EGL entry points.
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	365	</em></span>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	366	</p></div><div class="footnote"><p><sup>[<a name="ftn.fnreserved" href="#fnreserved">4</a>] </sup>These names are reserved for future use by the
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	367	Khronos Group.</p></div></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="notes2"></a>Notes </h5></div></div></div><div class="itemizedlist"><ul type="disc"><li><p><span class="emphasis"><em>The extensions
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	368	<code class="filename">.lib</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	369	& <code class="filename">.dll</code>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	370	are allowed to vary by platform. On GNU/Linux for example
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	371	they should be .a and .so to match that platform's
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	372	conventions.</em></span></p></li></ul></div></div></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id4787332"></a>Acknowledgements</h2></div></div></div><p class="ackno">
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	373	<p>Thanks to all the members of the Khronos Group for their input
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	374	and in particular to the following:
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	375	</p>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	376	<table class="simplelist" border="0" summary="Simple list"><tr><td>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	377	<span class="othercredit"><span class="firstname">Petri</span> <span class="surname">Kero</span></span>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	378	</td></tr><tr><td>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	379	<span class="othercredit"><span class="firstname">Jon</span> <span class="surname">Leech</span></span>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	380	</td></tr><tr><td>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	381	<span class="othercredit"><span class="firstname">Robert</span> <span class="surname">Palmer</span></span>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	382	</td></tr><tr><td>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	383	<span class="othercredit"><span class="firstname">Jani</span> <span class="surname">Vaarala</span></span>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	384	</td></tr><tr><td>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	385	<span class="othercredit"><span class="firstname">Hans-Martin</span> <span class="surname">Will</span></span>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	386	</td></tr></table>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	387	</p></div><div class="glossary"><div class="titlepage"><div><div><h2 class="title"><a name="id4787444"></a>Glossary</h2></div></div></div><dl><dt><a name="gls_abi"></a>Application Binary Interface (ABI)</dt><dd><p>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	388	The low-level interface between a compiled application program and the
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	389	operating system or its libraries.
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	390	</p></dd><dt><a name="gls_api"></a>Application Programming Interface (API)</dt><dd><p>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	391	The source-code level interface between an application program
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	392	and the operating system or its libraries.
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	393	</p></dd><dt><a name="gls_implementer"></a>Implementer</dt><dd><p>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	394	A company or person who implements a Khronos API.
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	395	</p></dd><dt><a name="gls_mfc"></a>Microsoft Foundation Classes (MFC)</dt><dd><p>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	396	A set of C++ utility classes provided by Microsoft Corporation.
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	397	</p></dd><dt><a name="gls_vendor"></a>Platform Vendor (Vendor)</dt><dd><p>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	398	A company providing an operating system platform that includes an
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	399	<em class="glossterm">ABI</em>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	400	specification for one or more Khronos APIs. E.g., Qualcomm (OpenGL ES
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	401	on BREW) and Symbian (OpenGL ES on Symbian OS). A Vendor may also be
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	402	an <em class="glossterm">Implementer.</em>
5d03bc08d59c Revision: 201003 Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com> parents: diff changeset	403	</p></dd></dl></div></div></body></html>

author	Lars Kurth <larsk@symbian.org>
	Tue, 15 Jun 2010 18:03:59 +0100
branch	GCC_SURGE
changeset 100	16dccf7ef352
parent 0	5d03bc08d59c
permissions	-rw-r--r--