The "vngen_label_modify_pos" Function

Syntax#

vngen_label_modify_pos(id, x, y, z, scale, rot, 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
`scale`	real	The label scale multiplier, where 1 is default
`rot`	real	The label 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_label_modify_pos("label", 150, 150, -1, 1.5, 45, 2);
}