The "vngen_attach_modify_ext" Function

Syntax#

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

Argument	Type	Description
`name`	string	The ID of the attachment parent character
`id`	real/string	The ID of the attachment to modify (or keyword `all` for all attachments)
`x`	real	The horizontal position to display the attachment, relative to the parent character
`y`	real	The vertical position to display the attachment, relative to the parent character
`z`	real	The drawing depth of the attachment, relative to other attachments only
`xscale`	real	The horizontal scale multiplier, where 1 is default
`yscale`	real	The vertical scale multiplier, where 1 is default
`rot`	real	The attachment 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_attach_modify_style and vngen_attach_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_attach_modify_ext("John Doe", "attach", 0, 0, -1, 1.5, 1.5, 0, c_yellow, c_yellow, c_orange, c_orange, 1, 2, ease_sin_out);
}