text()
Draws text onto the display positioned at x and y.
You are not limited to just drawing shapes and lines in the display, you can also write text. Use textFont() and textSize() to change the default font, Arial, and the default size, 12 pixels. Use textAlign() to change where the text is displayed relative to the (x,y) position specified. The default is that (x,y) is the top left corner of the text.
Text that does not fit completely within the display area will not be drawn or seen. Use the fourth and fifth parameters to create a text box to display the text in with automatic line wrapping.
Examples
Changing color and size
Use additional text blocks to change the appearance of text on the screen. You can change: size, color, alignment, and other properties.
textSize(60);
textAlign(CENTER, TOP);
textFont("Impact");
fill("yellow");
stroke("red");
strokeWeight(5);
text("Ada Lovelace was one of the first computer programmers!", 0, 0, 400, 400);
// Display Hello World in top left corner.
text("Hello world.", 10, 10);
No line wrap vs. line wrap
Use parameters four and five to create a text box with line wrapping.
// No text wrapping
text("Four score and seven years ago our fathers brought forth on this continent, a new nation, conceived in Liberty, and dedicated to the proposition that all men are created equal.", 10, 100);
// Use parameters four and five to create a text box with line wrapping.
// This will wrap text in a 100 by 100 box
text("Four score and seven years ago our fathers brought forth on this continent, a new nation, conceived in Liberty, and dedicated to the proposition that all men are created equal.", 10, 200, 110, 300);
Syntax
text(str, x, y, width, height)
Parameters
| Name | Type | Required? | Description |
|---|---|---|---|
| str | String | The text to be displayed. | |
| x | Number | The x-location in pixels of the text from left to right on the display. Should be a number from 0 to 400, but negative numbers will start the text to the left of the display and numbers greater than 400 will start the text to the right of the display (possibly unseen). | |
| y | Number | The y-location in pixels of the text from top to bottom on the display. Should be a number from 0 to 400, but negative numbers will start the text above the display and numbers greater than 400 will start the text below the display (possibly unseen). | |
| width | Number | The width of the rectangular area to display the text. Should be a number from 0 to 400. When the text reaches the end of this width, it will wrap to a new line. | |
| height | Number | The height of the rectangular area to display the text. Should be a number from 0 to 400. When the text reaches the end of this width, it will wrap to a new line. |
Returns
No return value. Outputs to the display only.
Tips
- you can also specify
fill(),stroke()andstrokeWeight()before calling text to change the color and outline used.
Found a bug in the documentation? Let us know at documentation@code.org