iigs-game-engine/docs/toolboxref.html
2022-06-29 14:27:18 -05:00

2367 lines
56 KiB
HTML

---
layout: page
title: Toolbox Reference
style: toolref
---
<link rel="stylesheet" href="{{ 'assets/css/toolref.css' | relative_url }}">
<div id="content">
<ul>
<li><a href="#Init">Intialization Functions</a></li>
<li><a href="#Sprite">Sprite Functions</a></li>
<li><a href="#Tile">Tile Functions</a></li>
<li><a href="#Buffer">Buffer Functions</a></li>
<li><a href="#IO">I/O Functions</a></li>
</ul>
<div class="api_intro">
<h1>GTE Tool Set</h1>
<p>
The <em>Generic Tile Engine (GTE)</em> Tool Set enables tile-based games to be implemented in an efficient manner.
The tool set provides support for sprites, animations, large scrolling backgrounds and special effects.
</p>
<p>
To effectively use this tool set, a user should be familiar with the following
</p>
<ul>
<li>The IIgs Hardware Reference</li>
<li>The QuickDraw II tool set</li>
<li>IIgs Technical Note #70</li>
</ul>
<p></p>
<h2>A preview of the GTE Tool Set routines</h2>
<p>
To introduce you to the capabilities of the GTE Tool Set the routines are grouped by function and briefly
described in Table 1. These routines are descibed in detail later where they are separated into housekeeping
routines (discussed in routine number order) and the rest of the GTE Tool Set routines (discussed in alphabetical
order).
</p>
<table class="intro">
<tbody>
<tr>
<th colspan="2">Table 1</th>
</tr>
<tr>
<th colspan="2" style="font-weight: normal;">GTE Tool Set routines and their functions</th>
</tr>
<tr class="intro_header">
<th>Routine</th>
<th>Description</th>
</tr>
<tr>
<th colspan="2">Housekeeping Routines</th>
</tr>
<tr>
<td>GTEBootInit</td>
<td>Initializes the GTE Tool Set; called only by the Tool Locator — must not be called by an application</td>
</tr>
<tr>
<td>GTEStartUp</td>
<td>Starts up the GTE Tool Set for use by an application</td>
</tr>
<tr>
<td>GTEShutDown</td>
<td>Shuts down the GTE Tool Set when an application quits</td>
</tr>
<tr>
<td>GTEVersion</td>
<td>Returns the version number of the GTE Tool Set</td>
</tr>
<tr>
<td>GTEReset</td>
<td>Resets the GTE Tool Set; called only when the system is reset — must not be called by an application</td>
</tr>
<tr>
<td>GTEStatus</td>
<td>Indicates whether the GTE Tool Set is active</td>
</tr>
<tr>
<th colspan="2">Sprite Routines</th>
<th></th>
</tr>
<tr>
<td>GTECreateSpriteStamp</td>
<td> Creates a sprite stamp from the tile set</td>
</tr>
<tr>
<td>GTEAddSprite</td>
<td>Add a active sprite to the scene</td>
</tr>
<tr>
<td>GTEMoveSprite</td>
<td>Changes a sprite's location</td>
</tr>
<tr>
<td>GTEUpdateSprite</td>
<td>Changes a sprite's tile set reference and display flags</td>
</tr>
<tr>
<td>GTERemoveSprite</td>
<td> Removes a sprite from the scene</td>
</tr>
<tr>
<th colspan="2">Tile Routines</th>
</tr>
<tr>
<td>GTELoadTileSet</td>
<td>Copies a tileset into the GTE tileset memory</td>
</tr>
<tr>
<td>GTESetTile</td>
<td>Assigns a tile to a tile store</td>
</tr>
<tr>
<td>GTEGetTileAt</td>
<td>Retrieves the tile ID stored in the tile store</td>
</tr>
<tr>
<td>GTECopyTileToDynamic</td>
<td>Copies a tile from the tileset memory into the managed dynamic tile memory. Changing the dynamic tile data
will result in all of the tiles updating
on the next call the <tt>GTERender()</tt></td>
</tr>
<tr>
<td>GTEGetTileDataAddr</td>
<td>Returns the base address of the tiledata memory</td>
</tr>
<tr>
<td>GTEFillTileStore</td>
<td>Fills the entire tile store with a tile ID.</td>
</tr>
<tr>
<th colspan="2">Primary Background Routines</th>
</tr>
<tr>
<td>GTESetBG0Origin</td>
<td>Sets the upper-left origin point in the primary background</td>
</tr>
<tr>
<td>GTERender</td>
<td>Draws the current scene to the graphics screen</td>
</tr>
<tr>
<td>GTEGetBG0TileMapInfo</td>
<td>Returns a record describing the number of tiles in the primary tilemap and a pointer to the tilemap data.
</td>
</tr>
<tr>
<td>GTESetBG0TileMapInfo</td>
<td>Defines a tile map for the primary background</td>
</tr>
<tr>
<td>GTERefresh</td>
<td>Forces all of the tiles in the tile store to be refreshed on the next render.</td>
</tr>
<tr>
<th colspan="2">Secondary Background Routines</th>
</tr>
<tr>
<td>GTESetBG1Origin</td>
<td>Sets the upper-left origin point in the secondary background</td>
</tr>
<tr>
<td>GTECopyPicToBG1</td>
<td>Copies an uncompressed pixel image into the secondard background buffer</td>
</tr>
<tr>
<td>GTESetBG1TileMapInfo</td>
<td>Defines a tile map for the secondary background</td>
</tr>
<tr>
<th colspan="2">Timer Routines</th>
</tr>
<tr>
<td>GTEAddTimer</td>
<td>Add a timer callback that is fired after a designated number of VBL ticks</td>
</tr>
<tr>
<td>GTERemoveTimer</td>
<td>Removes an active timer</td>
</tr>
<tr>
<td>GTEStartScript</td>
<td>Registers a GTE script to be handled in the background</td>
</tr>
<tr>
<th colspan="2">Overlay Routines</th>
</tr>
<tr>
<td>GTESetOverlay</td>
<td>Registers an overlay routine to be integrated into the renderer. Typically used for status bars or
messages.</td>
</tr>
<tr>
<td>GTEClearOverlay</td>
<td>Removes the current overlay from the renderer</td>
</tr>
<tr>
<th colspan="2">Functions affecting the global state</th>
</tr>
<tr>
<td>GTESetScreenMode</td>
<td>Sets the playing field's port rectangle to a pre-defined size, or a specified width and height</td>
</tr>
<tr>
<td>GTESetPalette</td>
<td>Copies a palette to the Super HiRes palette memory</td>
</tr>
<tr>
<td>GTEBindSCBArray</td>
<td>Takes an array of SCB bytes and binds them to either the Primary or Secondary background's vertical
position</td>
</tr>
<tr>
<td>GTEGetScreenInfo</td>
<td>Returns a records describing the origin, width and height of the playfield on the physical graphics
screen.</td>
</tr>
<tr>
<th colspan="2">Misc. Functions</th>
</tr>
<tr>
<td>GTEReadControl</td>
<td>Reads the keyboard and returns key events in a gamepad structure</td>
</tr>
<tr>
<td>GTEGetSeconds</td>
<td>Returns the number of seconds elapsed since the toolset was started</td>
</tr>
</tbody>
</table>
<h2>Using the GTE Tool Set</h2>
<p>
This section discusses how the GTE Tool Set routines fit into the general flow of an application and gives you an
idea of which routines you'll need to use under normal circumstances. Each routine is described in detail later in
this chapter.
The GTE Tool Set depends on the presence of the tool sets shown in Table 2 and requires at least the indicated
version of each tool set be present.
</p>
<table class="intro">
<tbody>
<tr>
<th colspan="4">Table 2</th>
</tr>
<tr>
<th colspan="4" style="font-weight: normal;">GTE Tool Set — other tool sets required</th>
</tr>
<tr class="intro_header">
<th colspan="2">Tool set number</th>
<th>Tool set name</th>
<th>Minimal version needed</th>
</tr>
<tr>
<td>$01</td>
<td>#01</td>
<td>Tool Locator</td>
<td>3.x</td>
</tr>
<tr>
<td>$02</td>
<td>#02</td>
<td>Memory Manager</td>
<td>3.x</td>
</tr>
<tr>
<td>$03</td>
<td>#03</td>
<td>Miscellaneous Tool Set</td>
<td>3.2</td>
</tr>
</tbody>
</table>
<p>
To use the GTE Tool Set routines, your application must call the GTEStartUp routine before making any other GTE
calls. To save memory, the GTE Tool Set may be started up with some features disabled. See the section <a
href="#GTEStartUp">GTEStartUp</a> in this chapter for further details.
</p>
<p>
Your application should also make the GTEShutDown call when the application quits.
</p>
</div>
<div class="api">
<h4 class="tn">$01XX</h4>
<h4>GTEBootInit</h4>
<p>
Initializes the GTE Tool Set; called only by the Tool Locator.
</p>
<div class="warning">
<p>
An application must never make this call
</p>
</div>
<div class="section">
<h5>Parameters</h5>
<p>
The stack is not affected by this call. There are no input or output parameters.
</p>
</div>
<div class="section">
<h5>Errors</h5>
<p>None</p>
</div>
<div class="section">
<h5>C</h5>
<p>Call must not be made by an application.</p>
</div>
</div>
<div class="api">
<h4 class="tn">$02XX</h4>
<h4>GTEStartUp</h4>
<p>
Starts up the GTE Tool Set for use by an application.
</p>
<div class="important">
<p>
Your application must make this call before it makes any other GTE Tool Set calls.
</p>
</div>
<p>
The GTE Tool Set uses two consecutive pages of bank zero for its direct page space starting at <it>dPageAddr</it>.
If the <tt>ENGINE_MODE_DYN_TILES</tt> flag is set in the <it>capFlags</it>, the GTE will attempt to allocate an
<em>additional</em> eight pages of bank zero space. If the <tt>ENGINE_MODE_BNK0_BUFF</tt> flag is set, then GTE
will attempt to allocate an ~32KB buffer from $2000 to $9CFF in Bank 0.
</p>
<div class="section">
<h5>Parameters</h5>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack before call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot">dPageAddr</td>
<td></td>
<td><em>Word</em> &mdash; 16-bit address of two pages of page-aligned Bank 0 memory</td>
</tr>
<tr>
<td class="bot">capFlags</td>
<td></td>
<td><em>Word</em> &mdash; Capability flags to set the engine mode</td>
</tr>
<tr>
<td class="bot">userID</td>
<td></td>
<td><em>Word</em> &mdash; User ID to be associated with the block. All memory allocated by GTE will use this
ID</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack after call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
<table role="table">
<thead>
<tr>
<th>capFlags</th>
<th></th>
<th></th>
</tr>
</thead>
<tbody>
<tr>
<td>ENGINE_MODE_TWO_LAYER</td>
<td>$0001</td>
<td>Enables the second background layer. This will have a moderate impact on rendering performance.</td>
</tr>
<tr>
<td>ENGINE_MODE_DYN_TILES</td>
<td>$0002</td>
<td>Enables the use of dynamic (animated) tiles. This will have a small impact on performance and requires
allocating 8 pages of Bank 0 memory</td>
</tr>
<tr>
<td>ENGINE_MODE_BNK0_BUFF</td>
<td>$0004</td>
<td>Allocates a 32KB buffer in Bank 0 for advanced graphical effects and customizations.</td>
</tr>
</tbody>
</table>
</div>
<div class="section">
<h5>Errors</h5>
<table>
<tbody>
<tr>
<td colspan="2">Memory Manager Errors</td>
<td>Returned unchanged</td>
</tr>
</tbody>
</table>
</div>
<div class="section">
<h5>C</h5>
<table style="font-family: courier, monospace; font-size: smaller;">
<tbody>
<tr>
<td>extern pascal GTEStartUp(dPageAddr, capFlags, userID)</td>
</tr>
<tr>
<td>Word dPageAddr</td>
</tr>
<tr>
<td>Word capFlags</td>
</tr>
<tr>
<td>Word userID</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="api">
<h4 class="tn">$03XX</h4>
<h4>GTEShutDown</h4>
<p>
Shuts down the GTE Toolset when an application quits.
</p>
<div class="section">
<h5>Parameters</h5>
<p>
The stack is not affected by this call. There are no input or output parameters.
</p>
</div>
<div class="section">
<h5>Errors</h5>
<p>None</p>
</div>
<div class="section">
<h5>C</h5>
<p><tt>extern pascal void GTEShutDown()</tt></p>
</div>
</div>
<div class="api">
<h4 class="tn">$04XX</h4>
<h4>GTEVersion</h4>
<p>
Returns the version number of the GTE Tool Set.
</p>
<div class="section">
<h5>Parameters</h5>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack before call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot">wordspace</td>
<td></td>
<td><em>Word</em> &mdash; Space for result</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack after call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot">versionInfo</td>
<td></td>
<td><em>Word</em> &mdash; Version number of the GTE Tool Set.</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
</div>
<div class="section">
<h5>Errors</h5>
<p>None</p>
</div>
<div class="section">
<h5>C</h5>
<p><tt>extern pascal Word GTEVersion()</tt></p>
</div>
</div>
<div class="api">
<h4 class="tn">$05XX</h4>
<h4>GTEReset</h4>
<p>
Resets the GTE Tool Set; called only when the system is reset.
</p>
<div class="warning">
<p>
An application must never make this call
</p>
</div>
<div class="section">
<h5>Parameters</h5>
<p>The stack is not affected by this call. There are no input or output parameters</p>
</div>
<div class="section">
<h5>Errors</h5>
<p>None</p>
</div>
<div class="section">
<h5>C</h5>
<p>Call must not be made by an application.</p>
</div>
</div>
<div class="api">
<h4 class="tn">$06XX</h4>
<h4>GTEStatus</h4>
<p>
Indicates whether the GTE Tool Set is active.
</p>
<div class="section">
<h5>Parameters</h5>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack before call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot">wordspace</td>
<td></td>
<td><em>Word</em> &mdash; Space for result</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack after call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot">activeFlag</td>
<td></td>
<td><em>Word</em> &mdash; <span class="sc">boolean</span>; TRUE if GTE Tool Set active, FALSE if inactive
</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
</div>
<div class="section">
<h5>Errors</h5>
<p>None</p>
</div>
<div class="section">
<h5>C</h5>
<p><tt>extern pascal Boolean GTEStatus()</tt></p>
</div>
</div>
<div class="transition">
GTE Tool Set routines
</div>
<div class="api">
<h4 class="tn">$09XX</h4>
<h4>GTEReadControl</h4>
<p></p>
<div class="section">
<h5>Parameters</h5>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack before call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot">wordspace</td>
<td></td>
<td><em>Word</em> &mdash; Space for result</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack after call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot">userInput</td>
<td></td>
<td><em>Word</em> &mdash; packed representation of user input
</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
</div>
<div class="section">
<h5>Errors</h5>
</div>
<div class="section">
<h5>C</h5>
</div>
</div>
<div class="api">
<h4 class="tn">$0AXX</h4>
<h4>GTESetScreenMode</h4>
<p></p>
<div class="section">
<h5>Parameters</h5>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack before call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack after call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
</div>
<div class="section">
<h5>Errors</h5>
</div>
<div class="section">
<h5>C</h5>
</div>
</div>
<div class="api">
<h4 class="tn">$0BXX</h4>
<h4>GTESetTile</h4>
<p></p>
<div class="section">
<h5>Parameters</h5>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack before call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack after call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
</div>
<div class="section">
<h5>Errors</h5>
</div>
<div class="section">
<h5>C</h5>
</div>
</div>
<div class="api">
<h4 class="tn">$0CXX</h4>
<h4>GTESetBG0Origin</h4>
<p></p>
<div class="section">
<h5>Parameters</h5>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack before call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack after call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
</div>
<div class="section">
<h5>Errors</h5>
</div>
<div class="section">
<h5>C</h5>
</div>
</div>
<div class="api">
<h4 class="tn">$0DXX</h4>
<h4>GTERender</h4>
<p></p>
<div class="section">
<h5>Parameters</h5>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack before call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack after call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
</div>
<div class="section">
<h5>Errors</h5>
</div>
<div class="section">
<h5>C</h5>
</div>
</div>
<div class="api">
<h4 class="tn">$0EXX</h4>
<h4>GTELoadTileSet</h4>
<p></p>
<div class="section">
<h5>Parameters</h5>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack before call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack after call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
</div>
<div class="section">
<h5>Errors</h5>
</div>
<div class="section">
<h5>C</h5>
</div>
</div>
<div class="api">
<h4 class="tn">$0FXX</h4>
<h4>GTECreateSpriteStamp</h4>
<p></p>
<div class="section">
<h5>Parameters</h5>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack before call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack after call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
</div>
<div class="section">
<h5>Errors</h5>
</div>
<div class="section">
<h5>C</h5>
</div>
</div>
<div class="api">
<h4 class="tn">$10XX</h4>
<h4>GTEAddSprite</h4>
<p></p>
<div class="section">
<h5>Parameters</h5>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack before call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack after call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
</div>
<div class="section">
<h5>Errors</h5>
</div>
<div class="section">
<h5>C</h5>
</div>
</div>
<div class="api">
<h4 class="tn">$11XX</h4>
<h4>GTEMoveSprite</h4>
<p></p>
<div class="section">
<h5>Parameters</h5>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack before call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack after call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
</div>
<div class="section">
<h5>Errors</h5>
</div>
<div class="section">
<h5>C</h5>
</div>
</div>
<div class="api">
<h4 class="tn">$12XX</h4>
<h4>GTEUpdateSprite</h4>
<p></p>
<div class="section">
<h5>Parameters</h5>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack before call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack after call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
</div>
<div class="section">
<h5>Errors</h5>
</div>
<div class="section">
<h5>C</h5>
</div>
</div>
<div class="api">
<h4 class="tn">$13XX</h4>
<h4>GTERemoveSprite</h4>
<p></p>
<div class="section">
<h5>Parameters</h5>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack before call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack after call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
</div>
<div class="section">
<h5>Errors</h5>
</div>
<div class="section">
<h5>C</h5>
</div>
</div>
<div class="api">
<h4 class="tn">$14XX</h4>
<h4>GTEGetSeconds</h4>
<p></p>
<div class="section">
<h5>Parameters</h5>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack before call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack after call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
</div>
<div class="section">
<h5>Errors</h5>
</div>
<div class="section">
<h5>C</h5>
</div>
</div>
<div class="api">
<h4 class="tn">$15XX</h4>
<h4>GTECopyTileToDynamic</h4>
<p></p>
<div class="section">
<h5>Parameters</h5>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack before call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack after call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
</div>
<div class="section">
<h5>Errors</h5>
</div>
<div class="section">
<h5>C</h5>
</div>
</div>
<div class="api">
<h4 class="tn">$16XX</h4>
<h4>GTESetPalette</h4>
<p></p>
<div class="section">
<h5>Parameters</h5>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack before call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack after call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
</div>
<div class="section">
<h5>Errors</h5>
</div>
<div class="section">
<h5>C</h5>
</div>
</div>
<div class="api">
<h4 class="tn">$17XX</h4>
<h4>GTECopyPicToBG1</h4>
<p></p>
<div class="section">
<h5>Parameters</h5>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack before call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack after call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
</div>
<div class="section">
<h5>Errors</h5>
</div>
<div class="section">
<h5>C</h5>
</div>
</div>
<div class="api">
<h4 class="tn">$18XX</h4>
<h4>GTEBindSCBArray</h4>
<p></p>
<div class="section">
<h5>Parameters</h5>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack before call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack after call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
</div>
<div class="section">
<h5>Errors</h5>
</div>
<div class="section">
<h5>C</h5>
</div>
</div>
<div class="api">
<h4 class="tn">$19XX</h4>
<h4>GTEGetBG0TileMapInfo</h4>
<p></p>
<div class="section">
<h5>Parameters</h5>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack before call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack after call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
</div>
<div class="section">
<h5>Errors</h5>
</div>
<div class="section">
<h5>C</h5>
</div>
</div>
<div class="api">
<h4 class="tn">$1AXX</h4>
<h4>GTEGetScreenInfo</h4>
<p></p>
<div class="section">
<h5>Parameters</h5>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack before call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack after call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
</div>
<div class="section">
<h5>Errors</h5>
</div>
<div class="section">
<h5>C</h5>
</div>
</div>
<div class="api">
<h4 class="tn">$1BXX</h4>
<h4>GTESetBG1Origin</h4>
<p></p>
<div class="section">
<h5>Parameters</h5>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack before call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack after call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
</div>
<div class="section">
<h5>Errors</h5>
</div>
<div class="section">
<h5>C</h5>
</div>
</div>
<div class="api">
<h4 class="tn">$1CXX</h4>
<h4>GTEGetTileAt</h4>
<p></p>
<div class="section">
<h5>Parameters</h5>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack before call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack after call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
</div>
<div class="section">
<h5>Errors</h5>
</div>
<div class="section">
<h5>C</h5>
</div>
</div>
<div class="api">
<h4 class="tn">$1DXX</h4>
<h4>GTESetBG0TileMapInfo</h4>
<p></p>
<div class="section">
<h5>Parameters</h5>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack before call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack after call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
</div>
<div class="section">
<h5>Errors</h5>
</div>
<div class="section">
<h5>C</h5>
</div>
</div>
<div class="api">
<h4 class="tn">$1EXX</h4>
<h4>GTESetBG1TileMapInfo</h4>
<p></p>
<div class="section">
<h5>Parameters</h5>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack before call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack after call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
</div>
<div class="section">
<h5>Errors</h5>
</div>
<div class="section">
<h5>C</h5>
</div>
</div>
<div class="api">
<h4 class="tn">$1FXX</h4>
<h4>GTEAddTimer</h4>
<p></p>
<div class="section">
<h5>Parameters</h5>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack before call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack after call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
</div>
<div class="section">
<h5>Errors</h5>
</div>
<div class="section">
<h5>C</h5>
</div>
</div>
<div class="api">
<h4 class="tn">$20XX</h4>
<h4>GTERemoveTimer</h4>
<p></p>
<div class="section">
<h5>Parameters</h5>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack before call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack after call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
</div>
<div class="section">
<h5>Errors</h5>
</div>
<div class="section">
<h5>C</h5>
</div>
</div>
<div class="api">
<h4 class="tn">$21XX</h4>
<h4>GTEStartScript</h4>
<p></p>
<div class="section">
<h5>Parameters</h5>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack before call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack after call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
</div>
<div class="section">
<h5>Errors</h5>
</div>
<div class="section">
<h5>C</h5>
</div>
</div>
<div class="api">
<h4 class="tn">$22XX</h4>
<h4>GTESetOverlay</h4>
<p></p>
<div class="section">
<h5>Parameters</h5>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack before call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack after call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
</div>
<div class="section">
<h5>Errors</h5>
</div>
<div class="section">
<h5>C</h5>
</div>
</div>
<div class="api">
<h4 class="tn">$23XX</h4>
<h4>GTEClearOverlay</h4>
<p></p>
<div class="section">
<h5>Parameters</h5>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack before call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack after call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
</div>
<div class="section">
<h5>Errors</h5>
</div>
<div class="section">
<h5>C</h5>
</div>
</div>
<div class="api">
<h4 class="tn">$24XX</h4>
<h4>GTEGetTileDataAddr</h4>
<p></p>
<div class="section">
<h5>Parameters</h5>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack before call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack after call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
</div>
<div class="section">
<h5>Errors</h5>
</div>
<div class="section">
<h5>C</h5>
</div>
</div>
<div class="api">
<h4 class="tn">$25XX</h4>
<h4>GTEFillTileStore</h4>
<p></p>
<div class="section">
<h5>Parameters</h5>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack before call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack after call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
</div>
<div class="section">
<h5>Errors</h5>
</div>
<div class="section">
<h5>C</h5>
</div>
</div>
<div class="api">
<h4 class="tn">$26XX</h4>
<h4>GTERefresh</h4>
<p></p>
<div class="section">
<h5>Parameters</h5>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack before call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
<table class="stack">
<colgroup>
<col class="col-1">
<col class="col-2">
<col class="col-3">
</colgroup>
<tbody>
<tr>
<th>Stack after call</th>
</tr>
<tr>
<td class="top">previous contents</td>
</tr>
<tr>
<td class="bot"></td>
<td><em></em></td>
<td><em>SP</em></td>
</tr>
</tbody>
</table>
</div>
<div class="section">
<h5>Errors</h5>
</div>
<div class="section">
<h5>C</h5>
</div>
</div>
</div>