Skip to main content

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);
ArgumentTypeDescription
namestringThe ID of the character to modify (or keyword all for all characters)
xrealThe horizontal position to display the character, relative to the global offset
yrealThe vertical position to display the character, relative to the global offset
zrealThe drawing depth of the character, relative to other characters only
xscalerealThe horizontal scale multiplier, where 1 is default
yscalerealThe vertical scale multiplier, where 1 is default
rotrealThe character rotation, in degrees
col1colorThe top-left gradient color, where c_white is default
col2colorThe top-right gradient color, where c_white is default
col3colorThe bottom-right gradient color, where c_white is default
col4colorThe bottom-left gradient color, where c_white is default
alphareal (0-1)The alpha transparency value, where 1 is default and 0 is fully transparent
durationrealSets the length of the modification transition, in seconds
easeinteger/macroSets 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.