Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A truetype font rendering library for OpenGL ES on iOS devices (iPad and iPhone)
C Shell C++ Perl Python Objective-C Other
branch: gles2

This branch is 4 commits ahead, 11 commits behind cdave1:gles2

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
Demos/iOS
Xcode
freetype-2.3.9
ftgles
.gitignore
INSTALL.md
LICENSE.md
README.md
TUTORIAL.md

README.md

IMPORTANT NOTE

This is an experimental version of the FTGLES library for OpenGL ES 2.0. Use at your own risk, as the library is subject to change.

The only demo project that currently supports OpenGL ES 2.0 is GLES2Demo. All other demos in this branch default back to OpenGL ES 1.1.

FTGLES 0.2.1

FTGLES is a C++ library for rendering fonts on mobile operating systems with OpenGL ES. It is a port of FTGL. It currently targets the iPhone and iPad, with an Android port in development. iOS 4.2 is currently supported.

From the FTGL notes:

"Unlike other OpenGL font libraries FTGL uses standard font file formats so doesn't need a preprocessing step to convert the high quality font data into a lesser quality, proprietary format."

"FTGL uses the Freetype font library to open and 'decode' the fonts. It then takes that output and stores it in a format most efficient for OpenGL rendering."

INSTALL

See INSTALL NOTES for instructions on how to add FTGLES to your Xcode project or build using automake.

USAGE

Include the library in your code:

#include "FTGL/ftgles.h"

Create a font from a truetype file or opentype font:

FTFont *font = new FTTextureFont("/path/to/myfont.ttf");
FTFont *font2 = new FTTextureFont("/path/to/myotherfont.otf");
font->FaceSize(72);

To render the text within your render loop (fonts are rendered at the origin along the positive x-axis):

glColor4f(0.0f, 0.0f, 0.0f, 1.0f); // Black text
font->Render("Lorem ipsum dolor sit amet");

The Hello World Demo example class shows a minimal implementation of a render loop.

See the Demos folder for several comprehensive sample iPhone apps. The demo apps include a unicode demo, as well as a demonstration of how to use layouts to easily align and position your text.

Differences between FTGL and FTGLES

FTGLES 0.2.1 supports the following font types from the original FTGL library:

  • FTBufferFont
  • FTGLOutlineFont
  • FTGLPolygonFont
  • FTGLTextureFont

Extrusion and pixmap rendering from the original FTGL library are currently not supported. Bitmap font support is currently in progress.

Performance Notes

If you need to render large amounts of text, Texture fonts are preferable, and also currently look much better than other font types. Texture fonts allow you to render a full screen of text without any appreciable drop in frame rate.

For Polygon and Outline fonts, rendering speeds depend very much on the type face being rendered. More complex glyphs will almost always contain more vertices, and thus FTGLES will need to draw more polygons or lines.

While you may get acceptable results by switching to a simple typeface, it is generally recommended that you avoid excessive use of Polygon and Outline fonts in iOS applications. Expect to see large drops in frame rate when drawing any more than 100-200 Polygon or Outline glyphs on screen.

Performance of the SimpleLayout class was previously very slow, but was recently improved in a recent build.

There is a Performance test application that will show the framerate of a screen full of text rendered using the SimpleLayout class, along with several font faces.

Licenses

  • FTGLES License here
  • Original FTGL License here
  • Freetype 2 License here
Something went wrong with that request. Please try again.