Name

text()

Description

Draws text to the screen. Displays the information specified in the first parameter on the screen in the position specified by the additional parameters. A default font will be used unless a font is set with the textFont() function and a default size will be used unless a font is set with textSize(). Change the color of the text with the fill() function. The text displays in relation to the textAlign() function, which gives the option to draw to the left, right, and center of the coordinates.

The x2 and y2 parameters define a rectangular area to display within and may only be used with string data. When these parameters are specified, they are interpreted based on the current rectMode() setting. Text that does not fit completely within the rectangle specified will not be drawn to the screen.

Note that Processing now lets you call text() without first specifying a PFont with textFont(). In that case, a generic sans-serif font will be used instead. (See the third example above.)

Examples

  • size(400, 400);
    textSize(128);
    text("word", 40, 120); 
    fill(0, 408, 612);
    text("word", 40, 240);
    fill(0, 408, 612, 204);
    text("word", 40, 360);
    Image output for example 1
  • size(400, 400, P3D);
    textSize(128);
    fill(0, 408, 612, 816);
    text("word", 48, 180, -120);  // Specify a z-axis value
    text("word", 48, 240);  // Default depth, no z-value specified
    Image output for example 2
  • size(400, 400);
    String s = "The quick brown fox jumps over the lazy dog.";
    fill(200);
    text(s, 40, 40, 280, 320);  // Text wraps within text box
    Image output for example 3

Syntax

  • text(c, x, y)
  • text(c, x, y, z)
  • text(str, x, y)
  • text(chars, start, stop, x, y)
  • text(str, x, y, z)
  • text(chars, start, stop, x, y, z)
  • text(str, x1, y1, x2, y2)
  • text(num, x, y)
  • text(num, x, y, z)

Parameters

  • c(char)the alphanumeric character to be displayed
  • x(float)x-coordinate of text
  • y(float)y-coordinate of text
  • z(float)z-coordinate of text
  • chars(char[])the alphanumeric symbols to be displayed
  • start(int)array index at which to start writing characters
  • stop(int)array index at which to stop writing characters
  • x1(float)by default, the x-coordinate of text, see rectMode() for more info
  • y1(float)by default, the y-coordinate of text, see rectMode() for more info
  • x2(float)by default, the width of the text box, see rectMode() for more info
  • y2(float)by default, the height of the text box, see rectMode() for more info
  • num(float, int)the numeric value to be displayed

Return

  • void