Skip to content
/ ftgles Public

A truetype font rendering library for OpenGL ES on iOS devices (iPad and iPhone)

License

Notifications You must be signed in to change notification settings

cdave1/ftgles

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

FTGLES

FTGLES is a C++ library for rendering fonts on mobile operating systems with OpenGL ES 1.1. It is a port of FTGL. It currently targets the iPhone and iPad. Up to iOS 11.0 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."

OpenGL ES 2.0 support has not yet been added to the main branch. Please see the gles2 branch for an experimental version of FTGLES that supports OpenGL ES 2.0.

Examples

Paragraphs

Polygons

Unicode

Performance Test

Should run at 60fps on a 2nd gen iPad.

QUICK INSTALL

There is default Xcode project within the repository. This also depends on another Xcode project containing the Freetype2 source code, configured for iOS. You can get both projects with these git commands:

git clone https://github.com/cdave1/ftgles.git ftgles
git clone https://github.com/cdave1/freetype2-ios.git freetype2

At this point, it should be possible to compile and run the Xcode projects in your ftgles/Demos/iOS folder.

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 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

MIT License:

  • FTGLES License here
  • Original FTGL License here
  • Freetype 2 License here

About

A truetype font rendering library for OpenGL ES on iOS devices (iPad and iPhone)

Resources

License

Stars

Watchers

Forks

Packages

No packages published