This repository has been archived on 2024-06-25. You can view files and clone it, but cannot push or open issues or pull requests.
FreeGLUT-Vita/freeglut/web-src/docs/gles.php

102 lines
3.1 KiB
PHP
Raw Normal View History

<?php
require("../template.php");
# Now set the title of the page:
setPageTitle("OpenGL ES");
# Make the header.
generateHeader($_SERVER['PHP_SELF']);
?>
<ul>
<li><a name="#intro">Introduction</a></li>
<li><a href="#compiling">Compiling</a></li>
<li><a href="#using">Using in your projects</a></li>
</ul>
<a name="intro"></a>
<h1>Introduction</h1>
<p>FreeGLUT can initialize an OpenGL ES (GLES) context. It works under platforms that supports EGL:</p>
<ul>
<li>Android (see <a href="android.php">dedicated page</a>)</li>
<li>BlackBerry 10/BlackBerry PlayBook</li>
<li>Unix X11 with Mesa EGL</li>
<li>TODO: Raspberry PI: Mesa EGL doesn't work due to X11's fbdev limitation (no GL);
it needs to use libraries from <tt>libraspeberrypi-dev</tt> which will shortcut X11
[<a href="https://github.com/openframeworks/openFrameworks/blob/master/libs/openFrameworks/app/ofAppEGLWindow.cpp">1</a>]
[<a href="http://sourceforge.net/p/freeglut/feature-requests/71/">2</a>]
[<a href="https://github.com/raspberrypi/userland/">3</a>]
</li>
</ul>
<p>FreeGLUT ES is provided as a separate library, because OpenGL ES
has a distinct library from plain OpenGL (<tt>-lGLESv1_CM
-lGLESv2</tt> instead of <tt>-lGL</tt>, and different headers too).
We could consider dynamically loading the OpenGL symbols we need,
like <a href="http://libsdl.org/">libSDL</a>.</p>
<p>It is possible to select OpenGL ES 1, 2 or 3 (if the device and
driver supports it) by calling
e.g. <code>glutInitContextVersion(3,0)</code> before creating a
window.</p>
<a name="compiling"></a>
<h1>Compiling</h1>
<p>The following explains how to use FreeGLUT ES for Mesa EGL.<br />
See also the <a href="android.php">Android page</a>.</p>
<p>First, check <tt>README.cmake</tt> to install the dependencies for your system.</p>
<p>Then:</p>
<pre>
apt-get install libgles1-mesa-dev libgles2-mesa-dev
cd /usr/src/freeglut-3.0.0/
mkdir native-gles/ && cd native-gles/
cmake \
-DCMAKE_INSTALL_PREFIX=/tmp/freeglut-native-gles \
-D CMAKE_BUILD_TYPE=Debug \
-DFREEGLUT_GLES=ON \
-DFREEGLUT_BUILD_DEMOS=NO \
..
make -j4
make install
</pre>
<a name="using"></a>
<h1>Using in your projects</h1>
<p>Get the 'freeglut-gles' module through pkg-config.</p>
<p>If you use CMake, you can do that with:</p>
<pre>
include(FindPkgConfig)
pkg_check_modules(freeglut REQUIRED freeglut-gles>=3.0.0)
if(freeglut_FOUND)
include_directories(${freeglut_STATIC_INCLUDE_DIRS})
link_directories(${freeglut_STATIC_LIBRARY_DIRS})
set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} ${freeglut_STATIC_CFLAGS_OTHER}")
add_definitions(${freeglut_STATIC_CFLAGS_OTHER})
endif()
</pre>
<pre>
cd your_project/
mkdir native-gles/ && cd native-gles/
PKG_CONFIG_PATH=/tmp/freeglut-native-gles/share/pkgconfig/ cmake ..
</pre>
<p>Examples:</p>
<ul>
<li>OpenGL Wikibook's
<a href="https://gitorious.org/wikibooks-opengl/modern-tutorials/source/HEAD:tut04_transform-gles2"><tt>tut04_transform-gles2</tt>
example</a>: it uses a basic Makefile targeting <tt>freeglut-gles</tt></li>
<li><tt>progs/test-shapes-gles1/</tt> in the source distribution:
it is a standalone CMake app that uses FreeGLUT GLES (v1).</li>
</ul>
<?php generateFooter(); ?>