The "vngen_scene_replace_ext" Function

Syntax

vngen_scene_replace_ext(id, sprite, xorig, yorig, scaling, duration, ease);

Argument	Type	Description
id	real/string	The ID of the scene to replace
sprite	sprite	The new sprite to draw as a scene
xorig	real/macro	The new horizontal sprite offset, or origin point, relative to the top-left corner
yorig	real/macro	The new vertical sprite offset, or origin point, relative to the top-left corner
scaling	integer/macro	Sets the new automatic scaling mode for the scene
duration	real	Sets the duration of the fade transition, in seconds
ease	integer/macro	Sets the ease mode to perform the fade transition in

Description

Replaces the input entity ID with a new sprite and extra sprite properties and fades the old sprite to the new one over the input duration.

As with other types of modifications, replacements made with this script are permanent and will persist until another replacement is performed. This script cannot be performed simultaneously with other replacement actions operating on the same entity ID.

See Macros & Keywords for a list of available origin points, scaling modes, and ease modes.

Example

vngen_event() {

vngen_scene_replace_ext("bg", spr_new, orig_center, orig_center, scale_none, 1, ease_sin_in_out);

}