Engine02 Script Commands - Level Control
Index:
Miscellaneous:
| 1 | (D) (E) | Func_LevAniFreeze |
| 42 | (D) (E) | Func_Set_Level |
| 846 | (D) (E) | Func_Abort_Boundary_Event |
Viewport Control:
| 26 | (D) (E) | Func_Move_VPX |
| 27 | (D) (E) | Func_Move_VPY |
| 31 | (D) (E) | Func_Set_VPX |
| 32 | (D) (E) | Func_Set_VPY |
| 89 | (D) (E) | Func_Set_Player_TargetBounds |
Level Manipulation:
| 29 | (D) (E) | Func_Show_Layer |
| 1432 | (D) (E) | Func_Show_Layer_OneScreen |
| 825 | (D) (E) | Func_Copy_Plane_Section |
Plane Data Retrieval:
| 827 | (D) (E) | Func_Reg_Get_Tile_Info_From_Reg |
| 828 | (D) (E) | Func_Reg_Get_Tile_Info_From_Chr |
| 829 | (D) (E) | Func_Reg_Get_Tile_Info_From_Obj |
| 830 | (D) (E) | Func_Reg_Get_Tile_Info_From_Chr_Hotspot |
| 831 | (D) (E) | Func_Reg_Get_Tile_Info_From_Obj_Hotspot |
| 832 | (D) (E) | Func_Chr_Get_Tile_Info_From_Reg |
| 833 | (D) (E) | Func_Chr_Get_Tile_Info_From_Chr |
| 834 | (D) (E) | Func_Chr_Get_Tile_Info_From_Obj |
| 835 | (D) (E) | Func_Chr_Get_Tile_Info_From_Chr_Hotspot |
| 836 | (D) (E) | Func_Chr_Get_Tile_Info_From_Obj_Hotspot |
| 837 | (D) (E) | Func_Obj_Get_Tile_Info_From_Reg |
| 838 | (D) (E) | Func_Obj_Get_Tile_Info_From_Chr |
| 839 | (D) (E) | Func_Obj_Get_Tile_Info_From_Obj |
| 840 | (D) (E) | Func_Obj_Get_Tile_Info_From_Chr_Hotspot |
| 841 | (D) (E) | Func_Obj_Get_Tile_Info_From_Obj_Hotspot |
| 1202 | (D) (E) | Func_Reg_Get_TiledObj_Info_From_Reg |
| 1203 | (D) (E) | Func_Reg_Get_TiledObj_Info_From_Chr |
| 1204 | (D) (E) | Func_Reg_Get_TiledObj_Info_From_Obj |
| 1205 | (D) (E) | Func_Reg_Get_TiledObj_Info_From_Chr_Hotspot |
| 1206 | (D) (E) | Func_Reg_Get_TiledObj_Info_From_Obj_Hotspot |
| 1207 | (D) (E) | Func_Chr_Get_TiledObj_Info_From_Reg |
| 1208 | (D) (E) | Func_Chr_Get_TiledObj_Info_From_Chr |
| 1209 | (D) (E) | Func_Chr_Get_TiledObj_Info_From_Obj |
| 1210 | (D) (E) | Func_Chr_Get_TiledObj_Info_From_Chr_Hotspot |
| 1211 | (D) (E) | Func_Chr_Get_TiledObj_Info_From_Obj_Hotspot |
| 1212 | (D) (E) | Func_Obj_Get_TiledObj_Info_From_Reg |
| 1213 | (D) (E) | Func_Obj_Get_TiledObj_Info_From_Chr |
| 1214 | (D) (E) | Func_Obj_Get_TiledObj_Info_From_Obj |
| 1215 | (D) (E) | Func_Obj_Get_TiledObj_Info_From_Chr_Hotspot |
| 1216 | (D) (E) | Func_Obj_Get_TiledObj_Info_From_Obj_Hotspot |
Plane Effects:
| 1262 | (D) (E) | Func_Set_Plane_Effect_Function |
| 1263 | (D) (E) | Func_Adjust_LayerR_ParalaxR_OffsetR |
| 1264 | (D) (E) | Func_Adjust_LayerR_ParalaxR_OffsetC |
| 1265 | (D) (E) | Func_Adjust_LayerR_ParalaxC_OffsetR |
| 1266 | (D) (E) | Func_Adjust_LayerR_ParalaxC_OffsetC |
| 1267 | (D) (E) | Func_Adjust_LayerC_ParalaxR_OffsetR |
| 1268 | (D) (E) | Func_Adjust_LayerC_ParalaxR_OffsetC |
| 1269 | (D) (E) | Func_Adjust_LayerC_ParalaxC_OffsetR |
| 1270 | (D) (E) | Func_Adjust_LayerC_ParalaxC_OffsetC |
| 1271 | (D) (E) | Func_Adjust_LayerR_Single_OffsetR |
| 1272 | (D) (E) | Func_Adjust_LayerR_Single_OffsetC |
| 1273 | (D) (E) | Func_Adjust_LayerC_Single_OffsetR |
| 1274 | (D) (E) | Func_Adjust_LayerC_Single_OffsetC |
| 1275 | (D) (E) | Func_Adjust_LayerT_ParalaxR_OffsetR |
| 1276 | (D) (E) | Func_Adjust_LayerT_ParalaxR_OffsetC |
| 1277 | (D) (E) | Func_Adjust_LayerT_ParalaxC_OffsetR |
| 1278 | (D) (E) | Func_Adjust_LayerT_ParalaxC_OffsetC |
| 1279 | (D) (E) | Func_Adjust_LayerT_Single_OffsetR |
| 1280 | (D) (E) | Func_Adjust_LayerT_Single_OffsetC |
Descriptions:
Miscellaneous:
1 - Func_LevAniFreeze
(ALL) (Example)
Toggles "Level Freezing" by modifying both the FreezeObjects
Register and the Player_Freeze for both Players, causing
the processing of Objects, Players,
Tile Animation, and
Palette Animation to be suspended or resumed.
Status Objects and "Game"/"Zone"/"Act" Functions will remain active.
Parameters:
- Flag
0- Suspended, FreezeObjects set to 65535 and Player_Freeze set to 1
1- Active, FreezeObjects and Player_Freeze both set to 0
42 - Func_Set_Level
(ALL) (REG) (Example)
Changes the current level by setting the current "Zone" and "Act", and changing
the "InLevel" Register to 0 to trigger level init.
The "R" or "r" tags may be used to obtain a value from a Register for either Parameter.
Parameters:
846 - Func_Abort_Boundary_Event
(FUNC) (Example)
Stops a Function working as a Boundary Event Function, and instructs the
"Current Player" not to set its Player_Curr_Boundary variable equal to that Event's ID.
This is useful when Boundary
Events should only be activated under certain conditions, enabling the
Boundary and condition to be tested again during the next Game Frame. If the
"Func_Stop_Current_Function" Command is used instead, the player will receive
the Boundary's ID, causing the Boundary not to be tested again until a
different Event is triggered first
Parameters:
None
Viewport Control:
26 - Func_Move_VPX
27 - Func_Move_VPY
(ALL) (Example)
These Commands add a value to the X or Y positions of both "ViewPorts".
They aren't effective when a Player Movement Object is active,
and its corresponding Player is flagged for Automatic Viewport Update.
The usefulness of these Commands is limited, and has been superceded by the ability to directly modify the "ViewPort" Registers.
Parameters:
- Num of Pixels
This value specifies how far to move the "ViewPort", in pixels
31 - Func_Set_VPX
32 - Func_Set_VPY
(ALL) (Example)
These Commands set the X or Y positions of both "ViewPorts".
They aren't effective when a Player Movement Object is active,
and its corresponding Player is flagged for Automatic Viewport Update.
The usefulness of these Commands is limited, and has been superceded by the ability to directly modify the "Viewport" Registers.
Parameters:
- Position
New position at which to set the "ViewPorts"
89 - Func_Set_Player_TargetBounds
(ALL) (REG) (Example)
Sets the Target Level Boundaries for the specified player.
The Player and his
Camera cannot move outside of these boundaries if Level Section Looping is not
active, and if they differ from the current boundaries, the screen will scroll
until they are met.
If Level Section Looping is active, the boundaries set by
this Command will serve as the start and end points of the looping segment.
This Command will also automatically update the size of the current level
section, which is absolutely necesary when looping is active.
Parameters:
- Player ID
ID number of the Player who's Boundaries will be set.
The "R" or "r" tags
may be used to obtain a value from a Register.
The "Curr_Player"
Register may be used if this Command is called from within a Player Function
or during a "Boundary Event",
otherwise it may not have the desired effect.
- Bound X1
- Bound Y1
- Bound X2
- Bound Y2
These values give the new boundary positions to set for the given player.
The "R" or "r" tags
may be used to obtain a value from a Register for each of these values.
Level Manipulation:
29 - Func_Show_Layer
(ALL) (Example)
Enables or disables visibility of a Tile Plane on both Players' screens.
To toggle a Tile Plane's visibility on only one Player's screen, use Func_Show_Layer_OneScreen
For a Tile Plane to be visible,
a Tile Plane Object must have been spawned using that Plane's
ID. Flagging the Plane with this Command does not create or destroy
a Tile Plane Object, it simply toggles the visibility of an existing one. If an
Object for the desired plane does not exist, this Function will have no effect.
Parameters:
- Plane ID
ID number of the tile plane to toggle
- Visibility
The Tile Plane's visibility state:
0- Invisible
1- Visible
1432 - Func_Show_Layer_OneScreen
(ALL) (Example)
Enables or disables visibility of a Tile Plane on one Player's screen.
To toggle a Tile Plane's visibility on both Players' screens, use Func_Show_Layer
For a Tile Plane to be visible,
a Tile Plane Object must have been spawned using that Plane's
ID. Flagging the Plane with this Command does not create or destroy
a Tile Plane Object, it simply toggles the visibility of an existing one. If an
Object for the desired plane does not exist, this Function will have no effect.
Parameters:
- Plane ID
ID number of the tile plane to toggle
- Player ID
ID number of the player for whose screen the Plane should be toggled.
The "R" or "r" tags
may be used to obtain a value from a Register, including the "Curr_Player" Register.
- Visibility
The Tile Plane's visibility state:
0- Invisible
1- Visible
825 - Func_Copy_Plane_Section
(ALL) (REG) (Example)
Copies a rectangular region of Tile data of the specified size from one portion
of a Tile Plane to another. If scroll data exists for either plane, it is left
unaffected.
The "R" or "r" tags
may be used to obtain a value from a Register for any of the Parameters.
Parameters:
- Source Plane ID
ID number of the source Tile Plane from which to copy.
- Source X
- Source Y
Starting X and Y position of the top-left Tile of the source region.
This is measured in Tiles, not pixels.
- Dest Plane ID
ID number of the Destination Tile Plane where the data should be pasted.
- Dest X
- Dest Y
Starting X and Y position of the top-left tile at which to paste the data.
This is measured in Tiles, not pixels.
- Width
- Height
The width and height of the Tile area that should be copied.
This is measured in Tiles, not pixels.
Plane Data Retrieval:
827 - Func_Reg_Get_Tile_Info_From_Reg
828 - Func_Reg_Get_Tile_Info_From_Chr
829 - Func_Reg_Get_Tile_Info_From_Obj
830 - Func_Reg_Get_Tile_Info_From_Chr_Hotspot
831 - Func_Reg_Get_Tile_Info_From_Obj_Hotspot
832 - Func_Chr_Get_Tile_Info_From_Reg
833 - Func_Chr_Get_Tile_Info_From_Chr
834 - Func_Chr_Get_Tile_Info_From_Obj
835 - Func_Chr_Get_Tile_Info_From_Chr_Hotspot
836 - Func_Chr_Get_Tile_Info_From_Obj_Hotspot
837 - Func_Obj_Get_Tile_Info_From_Reg
838 - Func_Obj_Get_Tile_Info_From_Chr
839 - Func_Obj_Get_Tile_Info_From_Obj
840 - Func_Obj_Get_Tile_Info_From_Chr_Hotspot
841 - Func_Obj_Get_Tile_Info_From_Obj_Hotspot
1203 - Func_Reg_Get_TiledObj_Info_From_Chr
1204 - Func_Reg_Get_TiledObj_Info_From_Obj
1205 - Func_Reg_Get_TiledObj_Info_From_Chr_Hotspot
1206 - Func_Reg_Get_TiledObj_Info_From_Obj_Hotspot
1207 - Func_Chr_Get_TiledObj_Info_From_Reg
1208 - Func_Chr_Get_TiledObj_Info_From_Chr
1209 - Func_Chr_Get_TiledObj_Info_From_Obj
1210 - Func_Chr_Get_TiledObj_Info_From_Chr_Hotspot
1211 - Func_Chr_Get_TiledObj_Info_From_Obj_Hotspot
1212 - Func_Obj_Get_TiledObj_Info_From_Reg
1213 - Func_Obj_Get_TiledObj_Info_From_Chr
1214 - Func_Obj_Get_TiledObj_Info_From_Obj
1215 - Func_Obj_Get_TiledObj_Info_From_Chr_Hotspot
1216 - Func_Obj_Get_TiledObj_Info_From_Obj_Hotspot
(ALL) (Example)
Retrieves the four basic types of data pertaining to any Tile at any point in any
Tile Plane or Tiled Path Object:
- ID of the Tile
- Tile's Floor Type
- Tile's "Angle" Value
- The Solidity at the given pixel point within the Tile's Solidity Map
These values are stored into the given variables.
The "_TiledObj" versions of these Commands attempt to retreive Tile data from the "Current Object".
Parameters:
- Var ID for X Pos
- Var ID for Y Pos
- Var ID for Plane ID
The first two Parameters are the IDs of the variables from which to obtain the X and
Y level coordinates, and the third is the ID of the variable from which to obtain the
ID of the Tile Plane that should be tested. (The "Plane ID" Parameter is present, but ignored when using "TiledObj" versions)
In the case of Hotspots, the X and Y position
Parameters are the ID numbers of the
Hotspot(s) from which to take the X and Y position. This effectively allows the use of
separate Hotspots to obtain X and Y testing coordinates. In this case, the Plane ID
is taken from a variable from the same Object/Player whose Hotspots were used, which
is the Object/Player "Fetched" to "Reference 0".
In the case of "Registers", "Var ID" are the IDs of the "Registers" that contain the X and Y coordinates, and the Plane ID. The "U" tag may be used
to specify a user-defined Register. Otherwise, the ID will refer to a Game Register
In the case of Player Variables, "Var ID" are the IDs of the Player Variables for the Player that is "Fetched" to "Reference 0" that contain the X and Y coordinates, and the Plane ID. The capital "A"
tag may be used to specify an "Active" variable, the lower-case "a" to specify a user-
defined "Active" variable, and the lower-case "c" to specify a user-defined Constant.
Otherwise, the ID will refer to one of the Player's required Constants
In the case of Object Variables, "Var ID" are the IDs of the Object Variables for the Object that is "Fetched" to "Reference 0" that contain the X and Y coordinates, and the Plane ID. The "E" tag may
be used to specify an "Extra" variable. Otherwise, the ID will refer to one of the
Object's standard variables
- Var ID for Tile ID
- Var ID for Floor Type
- Var ID for Slope Type
- Var ID for Solid Type
These Parameters are the IDs of the destination variables which are to receive the data.
All of this data is collected and stored in variables (all
of these Parameters are required), however, a variable that will otherwise not be used
may be given for each value that isn't desired. Unnecessary values do not need to be
stored in unique variables
In the case of "Registers", "Var ID" are the IDs of the "Registers" that should receive the acquired Tile data. The "U" tag may be used
to specify a user-defined Register. Otherwise, the ID will refer to a Game Register
In the case of Player Variables, "Var ID" are the IDs of the Player Variables for the Player that is "Fetched" to "Reference 2" that should receive the acquired Tile data. The capital "A"
tag may be used to specify an "Active" variable, the lower-case "a" to specify a user-
defined "Active" variable, and the lower-case "c" to specify a user-defined Constant.
Otherwise, the ID will refer to one of the Player's required Constants
In the case of Object Variables, "Var ID" are the IDs of the Object Variables for the Object that is "Fetched" to "Reference 2" that should receive the acquired Tile data. The "E" tag may
be used to specify an "Extra" variable. Otherwise, the ID will refer to one of the
Object's standard variables
Plane Effects:
1262 - Func_Set_Plane_Effect_Function
(ALL) (REG) (Example)
Assigns a Function that was loaded by a "Game Def" or "Zone Def"
to a Tile Plane, to be run as its "Effect Function".
This Function will be run just before the Tile Plane is drawn on either active game screen, and would generally
contain Func_Adjust_Layer?_Paralax?_Offset? Commands for controlling
its scrolling offsets.
The "R" or "r" tags may be used to obtain a value from a Register for either Parameter.
Parameters:
- Plane ID
ID number of the Tile Plane whose "Effect Function" should be set.
- Function ID
ID number of the Function that should be assigned to the given Tile Plane. The "G", "Z", and "A" tags may be used to reference "Game", "Zone", and "Act" Functions, respectively.
1263 - Func_Adjust_LayerR_ParalaxR_OffsetR
1264 - Func_Adjust_LayerR_ParalaxR_OffsetC
1265 - Func_Adjust_LayerR_ParalaxC_OffsetR
1266 - Func_Adjust_LayerR_ParalaxC_OffsetC
1267 - Func_Adjust_LayerC_ParalaxR_OffsetR
1268 - Func_Adjust_LayerC_ParalaxR_OffsetC
1269 - Func_Adjust_LayerC_ParalaxC_OffsetR
1270 - Func_Adjust_LayerC_ParalaxC_OffsetC
(ALL) (Example)
These Commands set scrolling offsets for individual rows/colums of the given Tile Plane, depending
on that Plane's type setting.
"Paralax" refers to the X axis on "Horizontal" and "Relative" planes, while for "Vertical" Planes, "Paralax"
sets offsets on the Y axis.
These Commands may be used within "Plane Effect Functions", however, the "Func_Adjust_LayerT_Paralax?_Offset?"
Commands exist for manipulating the Plane that is running the Function.
"R" signifies that the ID will be obtained from a "Register, while "C" signifies that a Constant Value should be used to provide the ID.
Parameters:
- Plane
In the case of Registers, this is the ID number of the Register that contains the ID of the Plane to manipulate.
In the case of Constant Values, this is the ID of the Plane to manipulate.
- Row/Column
In the case of Registers, this is the ID number of the Register that contains the ID of the Tile/Pixel Row/Column to offset.
In the case of Constant Values, this is the ID of the Tile/Pixel Row/Column to offset.
- Offset
In the case of Registers, this is the ID number of the Register that contains the offset value to apply to the given Row/Column.
In the case of Constant Values, this is the offset value to apply to the given Row/Column.
1271 - Func_Adjust_LayerR_Single_OffsetR
1272 - Func_Adjust_LayerR_Single_OffsetC
1273 - Func_Adjust_LayerC_Single_OffsetR
1274 - Func_Adjust_LayerC_Single_OffsetC
(ALL) (Example)
These Commands set scrolling offsets for individual rows/colums of the given Tile Plane, depending
on that Plane's type setting.
"Single" refers to the Y axis on "Horizontal" and "Relative" planes, while for "Vertical" Planes, "Single"
sets offsets on the X axis.
These Commands may be used within "Plane Effect Functions", however, the "Func_Adjust_LayerT_Single_Offset?"
Commands exist for manipulating the Plane that is running the Function.
"R" signifies that the ID will be obtained from a "Register, while "C" signifies that a Constant Value should be used to provide the ID.
Parameters:
- Plane
In the case of Registers, this is the ID number of the Register that contains the ID of the Plane to manipulate.
In the case of Constant Values, this is the ID of the Plane to manipulate.
- Offset
In the case of Registers, this is the ID number of the Register that contains the offset value to apply to the given Row/Column.
In the case of Constant Values, this is the offset value to apply to the given Row/Column.
1275 - Func_Adjust_LayerT_ParalaxR_OffsetR
1276 - Func_Adjust_LayerT_ParalaxR_OffsetC
1277 - Func_Adjust_LayerT_ParalaxC_OffsetR
1278 - Func_Adjust_LayerT_ParalaxC_OffsetC
(PLANE EFFECT) (Example)
These Commands set scrolling offsets for individual rows/colums of the Tile Plane that is running
the Plane Effect Function that uses them, depending on that Plane's type setting.
"Paralax" refers to the X axis on "Horizontal" and "Relative" planes, while for "Vertical" Planes, "Paralax"
sets offsets on the Y axis.
"R" signifies that the ID will be obtained from a "Register, while "C" signifies that a Constant Value should be used to provide the ID.
Parameters:
- Row/Column
In the case of Registers, this is the ID number of the Register that contains the ID of the Tile/Pixel Row/Column to offset.
In the case of Constant Values, this is the ID of the Tile/Pixel Row/Column to offset.
- Offset
In the case of Registers, this is the ID number of the Register that contains the offset value to apply to the given Row/Column.
In the case of Constant Values, this is the offset value to apply to the given Row/Column.
1279 - Func_Adjust_LayerT_Single_OffsetR
1280 - Func_Adjust_LayerT_Single_OffsetC
(PLANE EFFECT) (Example)
These Commands set scrolling offsets for individual rows/colums of the Tile Plane that is running
the Plane Effect Function that uses them, depending on that Plane's type setting.
"Single" refers to the Y axis on "Horizontal" and "Relative" planes, while for "Vertical" Planes, "Single"
sets offsets on the X axis.
"R" signifies that the ID will be obtained from a "Register, while "C" signifies that a Constant Value should be used to provide the ID.
Parameters:
- Offset
In the case of Registers, this is the ID number of the Register that contains the offset value to apply to the given Row/Column.
In the case of Constant Values, this is the offset value to apply to the given Row/Column.
Examples:
# 1 ;Action Activation (Suspend Object, Player, and Tile/Palette Animation Processing)
: 0 ;Off
; ----------
# 1 ;Action Activation (Resume Object, Player, and Tile/Palette Animation Processing)
: 1 ;On
42 - Func_Set_Level
(Description)
# 42 ;Set Level (Load and run Zone 7, Act 0)
: 7 ;(Zone) Zone 7
: 0 ;(Act) Act 0
; ----------
# 42 ;Set Level (Load and run the level whose Zone and Act IDs are stored in "User Registers" 2 and 3, respectively)
: R2 ;(Zone) Zone whose ID is stored in "User Register" 2
: R3 ;(Act) Act whose ID is stored in "User Register" 3
846 - Func_Abort_Boundary_Event
(Description)
# 846 ;Abort Boundary Event (Exit the Function, and don't allow the Player to take the Boundary's ID, leaving him able to test for this boundary again on the next Game Frame)
Viewport Control:
# 26 ;Move VPX (Move the X Position of the ViewPorts right by 4 pixels)
: 4 ;4 Pixels
; ----------
# 27 ;Move VPY (Move the Y Position of the ViewPorts up by 2 pixels)
: -2 ;2 Pixels
31 - Func_Set_VPX
32 - Func_Set_VPY
(Description)
# 31 ;Set VPX (Set the X Position of the ViewPorts to level position 1024)
:1024 ;Level Position 1024
; ----------
# 32 ;Set VPY (Set the Y Position of the ViewPorts to level position 224)
: 224 ;Level Position 224
89 - Func_Set_Player_TargetBounds
(Description)
# 89 ;Set Player TargetBound (Set the target level boundaries for the "Current Player" to start at 10592,0 for the upper-left, and 10912,992 for the lower-right)
: r9 ;(Plyr) Curr_Player
:10592;(X1) Horizontal level position 10592 for the left side
: 0 ;(Y1) Vertical level position 0 for the upper side
:10912;(X2) Horizontal level position 10912 for the right side
: 992 ;(Y2) Vertical level position 992 for the lower side
; ----------
# 89 ;Set Player TargetBound (Set the target X1, Y1, X2, and Y2 level boundaries for Player 1 to the values stored in "User Registers" 4, 5, 6, and 7, respectively)
: 0 ;(Plyr) Player 1
: R4 ;(X1) Value stored in "User Register" 4 for the left side
: R5 ;(Y1) Value stored in "User Register" 5 for the upper side
: R6 ;(X2) Value stored in "User Register" 6 for the right side
: R7 ;(Y2) Value stored in "User Register" 7 for the lower side
Level Manipulation:
# 29 ;Set Plane Visibility (Set Tile Plane 0 as visible for both Players)
: 0 ;(ID) Plane 0
: 1 ;(Toggle) Visible
1432 - Func_Show_Layer_OneScreen
(Description)
#1432 ;Set Plane Visibility OneScreen (Set Tile Plane 2 as invisible for the "Current Player")
: 2 ;(ID) Plane 2
: r9 ;(Player) Current Player
: 0 ;(Toggle) Invisible
825 - Func_Copy_Plane_Section
(Description)
# 825 ;Copy Tile Plane (Copy a Tile area of 6x6 from Tile location 36,0 in Plane 1, to Tile location 0,0 in Plane 1)
: 1 ;(Src Plane) Plane 1
: 36 ;(Src X) Tile X location 36
: 0 ;(Src Y) Tile Y location 0
: 1 ;(Dest Plane) Plane 1
: 0 ;(Dest X) Tile X location 0
: 0 ;(Dest Y) Tile Y location 0
: 6 ;(Width) 6 Tiles width
: 6 ;(Height) 6 Tiles height
; ----------
# 825 ;Copy Tile Plane (Copy a Tile area of size defined by "User Registers" 7 and 8 from Tile location defined by "User Registers" 9 and 10 in the Plane whose ID is stored in "User Register" 11, to Tile location defined by "User Registers" 12 and 13 in the Plane whose ID is stored in "User Register" 14)
: r9 ;(Src Plane) Plane whose ID is stored in "User Register" 9
: R10 ;(Src X) Tile X location is the value stored in "User Register" 10
: R11 ;(Src Y) Tile Y location is the value stored in "User Register" 11
: R12 ;(Dest Plane) Plane whose ID is stored in "User Register" 12
: R13 ;(Dest X) Tile X location is the value stored in "User Register" 13
: R14 ;(Dest Y) Tile Y location is the value stored in "User Register" 14
: R7 ;(Width) Width is the value stored in "User Register" 7
: R8 ;(Height) Height is the value stored in "User Register" 7
Plane Data Retrieval:
827 - Func_Reg_Get_Tile_Info_From_Reg
828 - Func_Reg_Get_Tile_Info_From_Chr
829 - Func_Reg_Get_Tile_Info_From_Obj
830 - Func_Reg_Get_Tile_Info_From_Chr_Hotspot
831 - Func_Reg_Get_Tile_Info_From_Obj_Hotspot
832 - Func_Chr_Get_Tile_Info_From_Reg
833 - Func_Chr_Get_Tile_Info_From_Chr
834 - Func_Chr_Get_Tile_Info_From_Obj
835 - Func_Chr_Get_Tile_Info_From_Chr_Hotspot
836 - Func_Chr_Get_Tile_Info_From_Obj_Hotspot
837 - Func_Obj_Get_Tile_Info_From_Reg
838 - Func_Obj_Get_Tile_Info_From_Chr
839 - Func_Obj_Get_Tile_Info_From_Obj
840 - Func_Obj_Get_Tile_Info_From_Chr_Hotspot
841 - Func_Obj_Get_Tile_Info_From_Obj_Hotspot
1203 - Func_Reg_Get_TiledObj_Info_From_Chr
1204 - Func_Reg_Get_TiledObj_Info_From_Obj
1205 - Func_Reg_Get_TiledObj_Info_From_Chr_Hotspot
1206 - Func_Reg_Get_TiledObj_Info_From_Obj_Hotspot
1207 - Func_Chr_Get_TiledObj_Info_From_Reg
1208 - Func_Chr_Get_TiledObj_Info_From_Chr
1209 - Func_Chr_Get_TiledObj_Info_From_Obj
1210 - Func_Chr_Get_TiledObj_Info_From_Chr_Hotspot
1211 - Func_Chr_Get_TiledObj_Info_From_Obj_Hotspot
1212 - Func_Obj_Get_TiledObj_Info_From_Reg
1213 - Func_Obj_Get_TiledObj_Info_From_Chr
1214 - Func_Obj_Get_TiledObj_Info_From_Obj
1215 - Func_Obj_Get_TiledObj_Info_From_Chr_Hotspot
1216 - Func_Obj_Get_TiledObj_Info_From_Obj_Hotspot
(Description)
# 828 ;Reg = Chr0 Tile Data (Use "Player_X_Pos", User-created "Active Variable 2", and "Player_Solid_Plane" of the Player "Fetched" to "Reference 0" as the X,Y Position and Tile Plane ID from which to obtain Level Tile Data, and store the Tile ID, "Floor Type", "Angle", and Solidity Type into "User Registers" 25, 26, 27, and 28, respectively)
: A3 ;(Chr0 X) "Active Variable" 3 (Player_X_Pos) of the Player "Fetched" to "Reference 0"
: a2 ;(Chr0 Y) User-created "Active Variable" 2 of the Player "Fetched" to "Reference 0"
: A28 ;(Chr0 PlaneID) "Active Variable" 28 (Player_Solid_Plane) of the Player "Fetched" to "Reference 0"
: U25 ;(Reg TileID) "User Register" 25
: U26 ;(Reg Floor) "User Register" 26
: U27 ;(Reg Angle) "User Register" 27
: U28 ;(Reg Solid) "User Register" 28
; ----------
#1210 ;Chr2 = Chr0 Hotspot TiledObject Data (Assume the "Current Object" is a Tiled Path Object. From the current Sprite Frame of the Player "Fetched" to "Reference 0", use Hotspot 1 for the X level Position, and Hotspot 2 for the Y level position at which to test against the Object's Tile Map, storing the Tile ID, "Floor Type", "Angle", and Solidity Type From the Tile at that location into User-created "Active Variables" 14, 15, 16, and 17 of the Player "Fetched" to "Reference 2", respectively)
: 1 ;(Spot X) Hotspot 1 from the current Sprite Frame of the Player "Fetched" to "Reference 0"
: 2 ;(Spot Y) Hotspot 2 from the current Sprite Frame of the Player "Fetched" to "Reference 0"
: 0 ;Ignored for TiledObject
: a14 ;(Chr2 TileID) User-created "Active Variable" 14 of the Player "Fetched" to "Reference 2"
: a15 ;(Chr2 Floor) User-created "Active Variable" 15 of the Player "Fetched" to "Reference 2"
: a16 ;(Chr2 Angle) User-created "Active Variable" 16 of the Player "Fetched" to "Reference 2"
: a17 ;(Chr2 Solid) User-created "Active Variable" 17 of the Player "Fetched" to "Reference 2"
; ----------
#1208 ;Obj2 = Obj0 Tile Data (Use "Object_X", "Object_Y", and "Extra Variable" 8 of the Object "Fetched" to "Reference 0" as the X,Y Position and Tile Plane ID from which to obtain Level Tile Data, and store the Tile ID, "Floor Type", "Angle", and Solidity Type into "Extra Variables" 13, 14, 15, and 16 of the Object "Fetched" to "Reference 2", respectively)
: 1 ;(Obj0 X) Main Variable 1 (Object_X) of the Object "Fetched" to "Reference 0"
: 2 ;(Obj0 Y) Main Variable 2 (Object_Y) of the Object "Fetched" to "Reference 0"
: E8 ;(Obj0 PlaneID) "Extra Variable" 8 of the Object "Fetched" to "Reference 0"
: E13 ;(Obj2 TileID) "Extra Variable" 13 of the Object "Fetched" to "Reference 2"
: E14 ;(Obj2 Floor) "Extra Variable" 14 of the Object "Fetched" to "Reference 2"
: E15 ;(Obj2 Angle) "Extra Variable" 15 of the Object "Fetched" to "Reference 2"
: E16 ;(Obj2 Solid) "Extra Variable" 16 of the Object "Fetched" to "Reference 2"
Plane Effects:
#1262 ;Set Plane Effect Function (Assign "Zone" Function 1 as Plane 0's "Effect Function")
: 0 ;(Plane ID) Plane 0
: Z1 ;(Func ID) "Zone" Function 1
; ----------
#1262 ;Set Plane Effect Function (Assign the Function whose ID is stored in "User Register 19 as the "Effect Function" for the Plane whose ID is stored in "User Register" 18)
: R18 ;(Plane ID) Plane whose ID is stored in "User Register" 18
: R19 ;(Func ID) Function whose ID is stored in "User Register 19
1263 - Func_Adjust_LayerR_ParalaxR_OffsetR
1264 - Func_Adjust_LayerR_ParalaxR_OffsetC
1265 - Func_Adjust_LayerR_ParalaxC_OffsetR
1266 - Func_Adjust_LayerR_ParalaxC_OffsetC
1267 - Func_Adjust_LayerC_ParalaxR_OffsetR
1268 - Func_Adjust_LayerC_ParalaxR_OffsetC
1269 - Func_Adjust_LayerC_ParalaxC_OffsetR
1270 - Func_Adjust_LayerC_ParalaxC_OffsetC
(Description)
#1267 ;Adjust LayerC ParalaxR OffsetR (In Plane 0, set the offset of the row/column whose ID is stored in "User Register" 31 to the value stored in "User Register 32"
: 0 ;(PlaneID) Plane 0
: U31 ;(ScrollID) "User Register" 31
: U32 ;(Offset) "User Register" 32
; ----------
#1266 ;Adjust LayerR ParalaxC OffsetC (In the Plane whose ID is stored in "User Register 30", set the offset of row/column 130 to 4096"
: U30 ;(PlaneID) "User Register" 30
: 130 ;(ScrollID) Row/Column 130
:4096 ;(Offset) 4096 pixel offset
1271 - Func_Adjust_LayerR_Single_OffsetR
1272 - Func_Adjust_LayerR_Single_OffsetC
1273 - Func_Adjust_LayerC_Single_OffsetR
1274 - Func_Adjust_LayerC_Single_OffsetC
(Description)
#1271 ;Adjust LayerR Single OffsetR (Set the offset of the flat-scrolling axis of the Plane whose ID is stored in "User Register" 27 to the value stored in "User Register" 28)
: U27 ;(PlaneID) "User Register 27"
: U28 ;(Offset) "User Register 28"
; ----------
#1274 ;Adjust LayerC Single OffsetC (Set the offset of the flat-scrolling axis of Plane 1 to 2048)
: 1 ;(PlaneID) Plane 1
:2048 ;(Offset) 2048 pixel offset
1275 - Func_Adjust_LayerT_ParalaxR_OffsetR
1276 - Func_Adjust_LayerT_ParalaxR_OffsetC
1277 - Func_Adjust_LayerT_ParalaxC_OffsetR
1278 - Func_Adjust_LayerT_ParalaxC_OffsetC
(Description)
#1275 ;Adjust ThisLayer ParalaxR OffsetR (In the Plane whose "Effect Function" called this command, set the offset of the row/column whose ID is stored in "User Register" 6 to the value stored in "User Register 7")
: U6 ;(ScrollID) "User Register" 6
: U7 ;(Offset) "User Register" 7
; ----------
#1278 ;Adjust ThisLayer ParalaxC OffsetC (In the Plane whose "Effect Function" called this command, set the offset of row/column 50 to 1024)
: 50 ;(ScrollID)
:1024 ;(Offset)
1279 - Func_Adjust_LayerT_Single_OffsetR
1280 - Func_Adjust_LayerT_Single_OffsetC
(Description)
#1280 ;Adjust ThisLayer Single OffsetR (In the Plane whose "Effect Function" called this command, set the offset of its flat-scrolling axis to the value stored in "User Register 17")
: U17 ;(Offset) "User Register 17"
; ----------
#1280 ;Adjust ThisLayer Single OffsetR (In the Plane whose "Effect Function" called this command, set the offset of its flat-scrolling axis to 3072)
:3072 ;(Offset)