Print

Signatures

bool print(string text)
bool print(string text, u32 duration)
bool print(string text, u32 duration, bool forceClose)

Description

Asynchronously queues a converted text to be displayed in a system window in the top-left corner of the screen for a given duration.

It doesn’t block the flow of execution and lets other tasks proceed without waiting for the function to complete.

Returns whether the operation was successful (true) or not (false).

If a window is open and the new message does not fit within it, the window will be closed and reopened.

Arguments

Text

The converted text that will be displayed.

Duration

The duration, in milliseconds, for which the text will be displayed.

If set to 0 or omitted (same as 0), the message will display for 2 seconds but will be removed early if another message is added to the queue.

Set to 0 by default.

Force Close

If set to true, forces the window to close and reopen even if the text fits within the window and reopening is unnecessary.

Set to false by default.

Notes

There are a total of 8 windows (0 -> 7) that can be used to simultaneously display several dialogues, shapes (textures), etc. at the same time.

This function uses window identifier 7 to display text.