Draw_text_ext_transformed - 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. xscale and yscale is the horizontal scale and vertical scale (default: 1). angle is the direction to which rotate the text. 0 is right direction and 90 is up. 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.
• xscale: Horizontal scaling of the text. Value of 1 being no scaling.
• yscale: Vertical scaling of the text. Value of 1 being no scaling.
• angle: Direction to which rotate the text. 0 is right direction and 90 is up.

Return Values

none

Example Call

str = "This is drawn using draw_text_ext_transformed and it splits when exceeding 300 pixels.";
draw_text_ext_transformed(200,200,str,-1,300,1,1,300);