Search processing.org:

Reference for Processing (BETA) version 0135+. If you have a previous version, use the reference included with your software. If you see any errors or have any comments, let us know.

Name

### textAlign()

Examples

    PFont font;
    // The font must be located in the current sketch's
    // "data" directory to load successfully
    font = loadFont("EurekaMonoCond-Bold-20.vlw");
    textFont(font, 20);
    textAlign(RIGHT);
    text("word", 50, 30);
    textAlign(CENTER);
    text("word", 50, 50);
    textAlign(LEFT);
    text("word", 50, 70);

Description

Sets the current alignment for drawing text. The parameters LEFT, CENTER, and RIGHT set the display characteristics of the letters in relation to the values for the x and y parameters of the text() function.
In Processing 0125 and later, an optional second parameter can be used to vertically align the text. BASELINE is the default, and the vertical alignment will be reset to BASELINE if the second parameter is not used. The TOP and CENTER parameters are straightforward. The BOTTOM parameter is the same as BASELINE when only one line of text is used, but for multiple lines, the final line will be aligned to the baseline, with the previous lines appearing above it.
The vertical alignment setting is ignored with the variation of text() that draws text inside a box. Text in a box is always drawn with the equivalent of TOP as its vertical alignment.
The vertical alignment is based on the value of textAscent(), which many fonts do not specify correctly. It may be necessary to use a hack and offset by a few pixels by hand so that the offset looks correct. To do this as less of a hack, use some percentage of textAscent() or textDescent() so that the hack works across size changes.

Syntax

    textAlign(ALIGN)
    textAlign(ALIGN, YALIGN)

Parameters

ALIGN | Horizontal alignment, either LEFT, CENTER, or RIGHT
YALIGN | Vertical alignment, either TOP, BOTTOM, CENTER, or BASELINE

Usage | Web & Application
Related | loadFont() PFont text()

Updated on February 09, 2008 04:38:52pm PST