The "vngen_label_modify_style" Function

Syntax#

vngen_label_modify_style(id, 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)
`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	Optional: Sets the ease mode to perform the transition in

Description#

Applies a four-color gradient and transparency modifications to the input entity ID. Color values can be input using GameMaker Studio's built-in color constants or functions like VNgen's make_color_hex_to_rgb.

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_style("label", c_red, c_blue, c_green, c_yellow, c_black, c_white, 1, 2);
}