The "vngen_label_modify_ext" Function

Syntax#

vngen_label_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 label to modify (or keyword `all` for all labels)
`x`	real	The horizontal position to display the label, relative to the global offset
`y`	real	The vertical position to display the label, relative to the global offset
`z`	real	The drawing depth of the label, relative to other labels only
`xscale`	real	The horizontal scale multiplier, where 1 is default
`yscale`	real	The vertical scale multiplier, where 1 is default
`rot`	real	The label 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_label_modify_style and vngen_label_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 labels 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_label_modify_ext("label", 0, 0, -1, 1.5, 1.5, 0, c_yellow, c_yellow, c_orange, c_orange, 1, 2, ease_sin_out);
}