|real/string||The unique identifier to use for the new scene|
|sprite||The sprite to draw as a scene|
|real||The horizontal position to display the scene, relative to the global offset|
|real||The vertical position to display the scene, relative to the global offset|
|real||The drawing depth of the scene, relative to other scenes only|
|boolean||Enables or disables endlessly tiling the scene|
|boolean||Enables or disables drawing the scene as a foreground|
|script||Sets the transition animation to perform|
|real||Sets the duration of the transition animation, in seconds|
|integer/macro||Optional: Sets the ease override for the transition script|
Creates a new scene as either a background (if
false) or foreground (if
true) which will be displayed until
vngen_scene_destroy is run. Multiple scenes can exist simultaneously, however no two scenes may share the same ID. VNgen entity IDs are arbitrary and most can be either numbers or strings, but bear in mind that -1 is reserved as 'null' and cannot be used as an ID.
VNgen uses texture extrapolation to draw tiled scenes by default. This allows tiled scenes to behave exactly like non-tiled ones, with support for rotation, gradient color blending, and deformations. However, not all platforms correctly support drawing scenes this way. For these platforms, see
vngen_set_renderlevel to enable drawing tiled scenes using the old method. Legacy tiled scenes will still appear tiled, but will lack the features described above.