This command will draw text at a particular position on the screen, aligning the text in a box.

a2BoxText fontID, x1, y1, x2, y2, text, halign, valign, wordWrap, color

fontID

Integer
Unique value assigned by the a2CreateFont() command.

x1

Integer
This value specifies the top left corner X coordinate of the text box.

y1

Integer
This value specifies the top left corner Y coordinate of the text box.

x2

Integer
This value specifies the bottom right corner X coordinate of the text box.

y2

Integer
This value specifies the bottom right corner Y coordinate of the text box.

text

String
This is the text string to be displayed.

halign

Integer
Determines the horizontal alignment of the text.
Set to 0 for left-aligned, 1 for centered, or 2 for right-aligned.

valign

Integer
Determines the vertical alignment of the text.
Set to 0 for top-aligned, 1 for centered, or 2 for bottom-aligned.

wordWrap

Boolean
Set to 1 to enable wordwrap, or 0 to disable wordwrap.

color

Integer
This value is a 32 bit integer specifying alpha, red, green, and blue color values for the text.

This command does not return a value.

This command will draw text at a particular position on the screen, aligning the text in a box. Note that the text will not be clipped by the box coordinates.

rem Set up the font
myFont = a2CreateFont("ariel", 20, a2Size_Char(), a2Style_Normal() ,1)

rem Draw a bounding box, so we can see how the command works
a2Box 10, 10, 200, 200, 0x88FFFFFF

rem Set up some variables
a$ = "Now is the time for all quick foxes to jump over their lazy dogs."
valign = 0
halign = 0
wordWrap = 1
color = 0xFFFFFF00

rem Draw the text
a2BoxText myFont, 10, 10, 200, 200, a$, halign, valign, wordWrap, color

WAIT KEY

a2CreateFont
a2DeleteFont
a2GetLineHeight
a2GetTextWidth
a2Text
Advanced 2D Index
Main Menu