The "vngen_scene_modify_pos" Function

Syntax#

vngen_scene_modify_pos(id, x, y, z, scale, rot, duration, [ease]);

Argument	Type	Description
`id`	real/string	The ID of the scene to modify (or keyword `all` for all scenes)
`x`	real	The horizontal position to display the scene, relative to the global offset
`y`	real	The vertical position to display the scene, relative to the global offset
`z`	real	The drawing depth of the scene, relative to other scenes only
`scale`	real	The scene scale multiplier, where 1 is default
`rot`	real	The scene 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_scene_modify_pos("bg", 150, 150, -1, 1.5, 45, 2);
}