The "vngen_char_modify_pos" Function

Syntax#

vngen_char_modify_pos(name, x, y, z, scale, rot, duration, [ease]);

Argument	Type	Description
`name`	string	The ID of the character to modify (or keyword `all` for all characters)
`x`	real	The horizontal position to display the character, relative to the global offset
`y`	real	The vertical position to display the character, relative to the global offset
`z`	real	The drawing depth of the character, relative to other characters only
`scale`	real	The character scale multiplier, where 1 is default
`rot`	real	The character rotation, in degrees
`duration`	real	Sets the length of the modification transition, in seconds
`[ease]`	integer/macro	Optional: Sets the ease mode to perform the transition in

note

The scale multiplier here should not be confused with the scaling mode available in *_create_ext functions. The scale mode sets the entity's default scale, while the scale multiplier modifies the default scale.

Description#

Applies a new position, rotation, and scale 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_pos("John Doe", 150, 150, -1, 1.5, 45, 2);
}