draw_text_ext_color - 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 specified corner colors c1, c2, c3, c4 and the specified alpha. Colors are interpolated between corners and for each line separately. 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.
  • c1: Color of the top left corner of the string.
  • c2: Color of the top right corner of the string.
  • c3: Color of the bottom right corner of the string.
  • c4: Color of the bottom left corner of the string.
  • alpha: Alpha component for the color.

Return Values

none

Example Call

draw_text_ext_color(100,100,"This is a long line which certainly exceed 150 pixels",20,150,c_red,c_lime,c_black,c_yellow,0.5);
⚠️ **GitHub.com Fallback** ⚠️