ofTrueTypeFont

methods

bind()
drawString()
drawStringAsShapes()
getLetterSpacing()
getLineHeight()
getNumCharacters()
getSize()
getSpaceSize()
getStringAsPoints()
getStringBoundingBox()
hasFullCharacterSet()
isAntiAliased()
isLoaded()
loadFont()
setGlobalDpi()
setLetterSpacing()
setLineHeight()
setSpaceSize()
stringHeight()
stringWidth()
unbind()

variables

bool bAntiAlised
bool bFullCharacterSet
bool bLoadedOk
int nCharacters

The ofTrueTypeFont class provides an interface to load fonts into openframeworks. The fonts are converted to textures, and can be drawn on screen. There are some options when you load the font - what size the font is rendered at, wether or not it is anti-aliased, and wether the font object will be the full character set or a subset (ie, extended ascii, which can include accents, umlauts, or normal ascii). The default is anti-aliased, non-full character set. The library uses freetype, which has certain patent problems in regards to true type hinting, especially at small sizes, so non-anti-aliased type doesn't always render beautifully. But we find it quite adequate, and at larger sizes it seems to works well.

bind()

void ofTrueTypeFont::bind()

↑

drawString(...)

void ofTrueTypeFont::drawString(string s, float x, float y)

Draws a string with that typeface, on screen, at point(x,y). For example, you can write some text on screen like this:


// in the h file:
ofTrueTypeFont myfont;
.....

// in setup:
myfont.loadFont("arial.ttf", 32);

// in draw:
myfont.drawString("hi!!", 100,100);

Your strings can even be multiline:


myfont.drawString("a test of multiline text", 300,300);

you can also using dynamically generated strings. For example, to print the frame rate:


char fpsStr[255]; // an array of chars
sprintf(fpsStr, "frame rate: %f", ofGetFrameRate());
myfont.drawString(fpsStr, 100,100);

↑

drawStringAsShapes(...)

void ofTrueTypeFont::drawStringAsShapes(string s, float x, float y)

drawStringAsShapes function draws the s string as if it was a geometrical shapes using the information contained in ofTTFContour and ofTTFCharacter. Parameters x and y sets the position of the shape.

↑

getLetterSpacing()

float ofTrueTypeFont::getLetterSpacing()

↑

getLineHeight()

float ofTrueTypeFont::getLineHeight()

The line height is computed, based on the font size, and can be adjusted. Useful if you are print multi-line text.

↑

getNumCharacters()

int ofTrueTypeFont::getNumCharacters()

↑

getSize()

int ofTrueTypeFont::getSize()

↑

getSpaceSize()

float ofTrueTypeFont::getSpaceSize()

↑

getStringAsPoints(...)

ofTTFCharacter ofTrueTypeFont::getStringAsPoints(string str)

↑

getStringBoundingBox(...)

ofRectangle ofTrueTypeFont::getStringBoundingBox(string s, float x, float y)

e.g:


//in setup() 

franklinBook.loadFont("frabk.ttf", 32);

//in update()

char tempString[255];
ofRectangle rect = franklinBook.getStringBoundingBox(tempString, 0,0);

//in draw

ofSetColor(0xcccccc);
ofRect(rect.x, rect.y, rect.width, rect.height);

↑

hasFullCharacterSet()

bool ofTrueTypeFont::hasFullCharacterSet()

↑

isAntiAliased()

bool ofTrueTypeFont::isAntiAliased()

↑

isLoaded()

bool ofTrueTypeFont::isLoaded()

↑

loadFont(...)

void ofTrueTypeFont::loadFont(string filename, int fontsize)

Loads a fonts of a given filename in, and renders it to a texture at a given size (fontsize). It will look for the font file in the data/ folder. For example, to load the font arial at type size 32:


// int the h file:

ofTrueTypeFont myFont;
...

myFont.loadFont("arial.ttf", 32);

↑

loadFont(...)

void ofTrueTypeFont::loadFont(string filename, int fontsize, bool _bAntiAliased, bool _bFullCharacterSet, bool makeContours)

This loads a font, but in addition to setting the font name and size, you can also pass in two flags: is this font antiAliased, and does it include the full character set?

↑