Draw_text_ext - hpgDesigns/hpgdesigns-dev.io GitHub Wiki

NOTOC This function is part of the function set Drawing text

Notation

Description

Draws a regular text string with top left corner placed at (x,y) position using the drawing color and alpha. Newlines are placed sep pixels below the previous line (top to top). Lines longer than w are split at spaces.

A # symbol or carriage return chr(13) or linefeed chr(10) are interpreted as newline characters. Note that EDL string settings can allow you to use the \n escape sequence in place of the # symbol.

To change the text alignment you can use and functions.

Parameters

• x, y: The coordinates to draw the text at. (0,0) indicates the top-left corner of the room.
• string: The textual string to display.
• sep indicates the separation distance between the lines of text in a multiline text. Use -1 to get the default distance. Note that this distance is from the top of each line to the next top. So small distances will make the text to overlap. This means that the default sep is .
• w is the width of the text in pixels. Lines that are longer than this width are split up at spaces. Use -1 to not split up lines. Font size does make an impact where the lines will be split, because width is in pixels and so you can have 10 small words or one big one in a specific size.

Return Values

none

Example Call

//Drawing "This is a long line which certainly exceed 150 pixels" at the 100,100 position. This will split the line up at spaces. Separation will be 20 pixels between each line (top to top).
draw_text_ext(100,100,"This is a long line which certainly exceed 150 pixels",20,150);