The "vngen_text_modify_ext" Function

Syntax#

vngen_text_modify_ext(id, x, y, z, xscale, yscale, rot, col1, col2, col3, col4, shadow, outline, alpha, duration, ease);

Argument	Type	Description
`id`	real/string	The ID of the text to modify (or keyword `all` for all text)
`x`	real	The horizontal position to display the text, relative to the global offset
`y`	real	The vertical position to display the text, relative to the global offset
`z`	real	The drawing depth of the text, relative to other text only
`xscale`	real	The horizontal scale multiplier, where 1 is default
`yscale`	real	The vertical scale multiplier, where 1 is default
`rot`	real	The text rotation, in degrees
`col1`	color/macro	The text top-left gradient color, where `c_white` is default (or keyword `previous` for no change, or keyword `inherit` for saved style)
`col2`	color/macro	The text top-right gradient color, where `c_white` is default (or keyword `previous` for no change, or keyword `inherit` for saved style)
`col3`	color/macro	The text bottom-right gradient color, where `c_white` is default (or keyword `previous` for no change, or keyword `inherit` for saved style)
`col4`	color/macro	The text bottom-left gradient color, where `c_white` is default (or keyword `previous` for no change, or keyword `inherit` for saved style)
`shadow`	color/macro	The text shadow color, where 'none' is default (or keyword `previous` for no change, keyword `inherit` for saved style, or 'none' for none)
`outline`	color/macro	The text outline color, where 'none' is default (or keyword `previous` for no change, keyword `inherit` for saved style, or 'none' for none)
`alpha`	real (0-1)	The alpha transparency value, where 1 is default and 0 is fully transparent
`duration`	real	Sets the length of the modification transition, in seconds
`ease`	integer/macro	Sets the ease mode for the modification transition

Description#

Combines vngen_text_modify_style and vngen_text_modify_pos with a few extra options, applying a new position, scale, rotation, four-color gradient, and transparency modifications to the input entity ID.

All modifications made with this script are permanent and will persist until another modification is performed. This script cannot be performed simultaneously with other modification actions operating on the same entity ID.

Unlike other entities, color modifications applied to text elements are applied to each individual character in the string rather than to the string as a whole. The exception to this is animations, which are applied as normal.

See Macros & Keywords for a list of available style modes and ease modes.

Example#

vngen_event() {
   vngen_text_modify_ext("text", 0, 0, -1, 1.5, 1.5, 0, c_yellow, c_yellow, c_orange, c_orange, 1, 2, ease_sin_out);
}