Skip to main content

The "vngen_scene_replace_ext" Function

Syntax#

vngen_scene_replace_ext(id, sprite, xorig, yorig, scaling, duration, ease);
ArgumentTypeDescription
idreal/stringThe ID of the scene to replace
spritespriteThe new sprite to draw as a scene
xorigreal/macroThe new horizontal sprite offset, or origin point, relative to the top-left corner
yorigreal/macroThe new vertical sprite offset, or origin point, relative to the top-left corner
scalinginteger/macroSets the new automatic scaling mode for the scene
durationrealSets the duration of the fade transition, in seconds
easeinteger/macroSets 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);
}