OtherLayers

[kyonides]

OtherLayers
XP + VX + ACE

by Kyonides

Introduction

This script allows you to use a static picture or a series of pictures as a custom upper layer for the current map.

I am sure there gotta be other scripts that provide similar features and you know what?
I don't care about that!

Embedded Notes for XP & VX

First of all, both engines have no Map Note Boxes so you must use the Map's Name as a substitute.

Code:

# This script lets you add another layer where you can place images that can
# be either static or animated.

# Create a directory called Layers inside the Graphics folder.
# Thereafter you can add as many images as deemed necessary.

# Examples: fall_1.png, fall_2.png, fall_3.png

# The state of a specific Game Switch will determine whether or not a given
# layer is visible at that moment.

# - Set a Map's Total Number of Upper Layers
# - Pattern: <LUMn> - Example: <LUM2>

# - Predefine an Upper Layer
#   - It must follow one of these patterns:
#   The n's there stand for LayerID, No. Pictures, Frames and SwitchID (if any)
# <LUn filename n n>
# <LUn filename n n Sn>
# - Examples Using the fall_ image files:
# <LU1 fall 3 20>
# <LU2 fall 3 20 S10>

Embedded Notes for VX ACE

Code:

# Create a directory called Layers inside the Graphics folder.
# Thereafter you can add as many images as deemed necessary.

# Examples: fall_1.png, fall_2.png, fall_3.png

# The state of a specific Game Switch will determine whether or not a given
# layer is visible at that moment.

# - Set a Map's Total Number of Upper Layers - Pattern: <layers n>
# - Example: <layers 2>

# - Predefine an Upper Layer
#   - It must follow one of these patterns:
# <layer up n filename pix n frames n>
# <layer up n filename pix n frames n switch n>
# - Examples Using the fall_ image files:
# <layer up 1 fall pix 3 frames 20>
# <layer up 2 fall pix 3 frames 20 switch 10>

If you ever need to change the map's default upper layer, you can use any of the following...

Optional Script Calls Available For ALL Engines

Code:

# - Change the Map's Upper Layer - It will replace any previous one!
upper_layer(Number).name = "BaseFileName"

# - Change the Upper Layer's Number of Pictures - if Animated
upper_layer(Number).total = TotalPictures

# - Change the Upper Layer's Timer (in Frames)
upper_layer(Number).timer = Frames

# - Change the Upper Layer's Switch ID
upper_layer(Number).switch_id = SwitchID

# - Change the Upper Layer's Data With a Single Call
upper_layer(Number).set_data(TotalPictures, Frames, SwitchID)

# - Freeze or Thaw the Upper Layer
# upper_layer(Number).freeze!
# upper_layer(Number).thaw!

# - Check whether or not the Upper Layer is Frozen
# upper_layer(Number).frozen?

Screenshots

3 Snapshots

DOWNLOAD DEMOS

Terms & Conditions

Free for use in non commercial games.
Due credit is mandatory.
Do not repost it anywhere!
That's it!