Skip to content

braitsch/ofxParagraph

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
src
 
 
 
 
 
 
 
 

ofxParagraph

A simple paragraph renderer for openFrameworks that allows you to set the alignment, width, indentation, leading and pixel based word spacing of paragraphs.

image

Installation

ofxParagraph uses ofxSmartFont for font management which allows you to safely share ofxParagraph fonts with the rest of your application.

This requires you to clone the repository recursively if you don't already have it installed.

git clone --recursive git@github.com:braitsch/ofxParagraph.git

Usage

Creating a paragraph is as simple as passing in a string and setting a width.

ofxParagraph paragraph = ofxParagraph(text, width);

And then assigning a font you'd like to use:

paragraph.setFont("fonts/helvetica_neue.ttf", 12)

Alternately you can pass in an ofxSmartFont instance:

shared_ptr<ofxSmartFont> helvetica_12;
paragraph.setFont(helvetica_12);

Once you've got some text, a width and a font you're ready to draw:

paragraph.draw();
// or specify a position //
paragraph.draw(int x, int y);

Customization

The following methods are available to customize any ofxParagraph instance.

void setText(string text)

void setWidth(int width)

void setFont(string file, int pointSize)

void setFont(std::shared_ptr<ofxSmartFont> font)

void setColor(ofColor color)

void setColor(int color) // e.g. 0x333333

void setPosition(int x, int y)

void setAlignment(ofxParagraph::Alignment align)

void setIndent(int indent)

void setLeading(int leading) // vertical spacing between lines //

void setSpacing(int spacing) // horizontal spacing between words //

You can also draw a border around paragraphs and boundaries around words.

void drawBorder(bool draw)

void drawBorder(ofColor color)

void setBorderPadding(int padding)

void drawWordBoundaries(bool draw)

And there are also a couple of handy getter functions just in case.

int getWidth()

int getHeight()

int getStringHeight(string s = "")

About

Paragraph renderer for openFrameworks

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published