The "vngen_text_create" Function

Syntax#

vngen_text_create(id, name, text, x, y, z, linebreak, font, color, transition, duration, [ease], [lang]);

Argument	Type	Description
`id`	real/string	The unique identifier to use for the new text
`name`	string	The speaker name to associate with the text
`text`	string	The text string to display
`x`	real/macro	The horizontal position to display the text, relative to the global offset (or keyword `auto` to place after previous text)
`y`	real/macro	The vertical position to display the text, relative to the global offset (or keyword `auto` to place after previous text)
`z`	real	The drawing depth of the text, relative to other text only
`linebreak`	real	The width in pixels before text is wrapped into a new line
`font`	font/macro	The font to draw text in, where `fnt_default` is default (or keyword `inherit` for saved style)
`color`	color/macro	The color to draw text in, where `c_white` is default (or keyword `inherit` for saved style)
`transition`	script	Sets the transition animation to perform
`duration`	real	Sets the duration of the transition animation, in seconds
`[ease]`	integer/macro	Optional: Sets the ease override for the transition script
`[lang]`	real/string	Optional: Sets the language flag for the text

Description#

Creates a new string of text which will be displayed until vngen_text_destroy is run. Multiple text elements can exist simultaneously, however no two may share the same ID. VNgen entity IDs are arbitrary and most can be either numbers or strings, but bear in mind that -1 is reserved as 'null' and cannot be used as an ID.

By default, text will be printed onto the screen with a typewriter effect at the rate set by vngen_set_speed, progressing one character at a time until the entire string is displayed. Once the string is complete, the engine will wait for user input before continuing to the next event. Running vngen_continue before the effect is complete will skip it.

Newly-created text will be automatically added to the backlog.

See Included Animations and Macros & Keywords for a list of available style modes, transition animations, and ease modes. See Language Functions for details on multi-language support. See Inline Markup for available markup tags.

Example#

vngen_event() {
   vngen_text_create("text", "John Doe", "Hello, world!", 200, 900, -1, 1500, inherit, inherit, trans_fade, 2);
   vngen_text_create("text", "John Doe", "Hello, world!", 200, 900, -1, 1500, fnt_Arial, c_white, trans_fade, 2, "en-US");  
}