string_width_ext

This function will return the maximum width (in pixels) of the input string, taking into account the line separation and line-break width (which is defined as the number of pixels that the string can occupy before a line break is inserted). It is very handy for calculating distances between text elements based on the maximum width of a string that is split over several lines as it would be drawn with draw_text_ext() using the currently defined font. Separation and width can be set to -1 to get the default spacing.

 

Syntax:

string_width_ext(string, sep, w);

ArgumentTypeDescription
stringStringThe string to measure the width of.
sepRealThe distance in pixels between lines of text as if the string was being drawn.
wRealThe maximum width (in pixels) of the string before a line break as if the string was bring drawn.

 

Returns:

Real

 

Example:

var ww = string_width_ext(str_Story_Text[1], -1, 100);
draw_text_ext(32, 32, str_Story_Text[1], -1, 100);
draw_text_ext(32 + ww, 32, str_Story_Text[2], -1, 100);

The above code will get the width of the given string, taking into account the line separation and line-break width, and then draw two lines of text, using the returned total string width as a separator.