The "vngen_textbox_modify_ext" Function

Syntax#

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

Argument	Type	Description
`id`	real/string	The ID of the textbox to modify (or keyword `all` for all textboxes)
`x`	real	The horizontal position to display the textbox, relative to the global offset
`y`	real	The vertical position to display the textbox, relative to the global offset
`z`	real	The drawing depth of the textbox, relative to other textboxes only
`xscale`	real	The horizontal scale multiplier, where 1 is default
`yscale`	real	The vertical scale multiplier, where 1 is default
`rot`	real	The textbox 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_textbox_modify_style and vngen_textbox_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_textbox_modify_ext("tb", 0, 0, -1, 1.5, 1.5, 0, c_yellow, c_yellow, c_orange, c_orange, 1, 2, ease_sin_out);
}