The "vngen_char_modify_ext" Function

Syntax#

vngen_char_modify_ext(name, x, y, z, xscale, yscale, rot, col1, col2, col3, col4, alpha, duration, ease);

Argument	Type	Description
`name`	string	The ID of the character to modify (or keyword `all` for all characters)
`x`	real	The horizontal position to display the character, relative to the global offset
`y`	real	The vertical position to display the character, relative to the global offset
`z`	real	The drawing depth of the character, relative to other characters only
`xscale`	real	The horizontal scale multiplier, where 1 is default
`yscale`	real	The vertical scale multiplier, where 1 is default
`rot`	real	The character rotation, in degrees
`col1`	color	The top-left gradient color, where `c_white` is default
`col2`	color	The top-right gradient color, where `c_white` is default
`col3`	color	The bottom-right gradient color, where `c_white` is default
`col4`	color	The bottom-left gradient color, where `c_white` is default
`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_char_modify_style and vngen_char_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.

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

Example#

vngen_event() {
   vngen_char_modify_ext("John Doe", 0, 0, -1, 1.5, 1.5, 0, c_yellow, c_yellow, c_orange, c_orange, 1, 2, ease_sin_out);
}

This will increase the characters's scale, simulating a zoom while fading to a warm gradient suggesting an evening environment.