diff --git a/docs/toolboxref.html b/docs/toolboxref.html index 6d03460..d33526a 100644 --- a/docs/toolboxref.html +++ b/docs/toolboxref.html @@ -1594,7 +1594,7 @@ style: toolref

$14XX

GTEGetSeconds

-

+

Returns the number of seconds that have elapsed since the engine was started. This is a 16-bit value and will wrap around after 65536 seconds (~18 hours)

Parameters
@@ -1610,6 +1610,11 @@ style: toolref + + + + + @@ -1631,6 +1636,11 @@ style: toolref + + + + + @@ -1644,13 +1654,20 @@ style: toolref
C
+

extern pascal Word GTEGetSeconds()

$15XX

GTECopyTileToDynamic

-

+

+ Copies a tile by ID into one of the dynamic tile slots. If a dynamic tile associated with the + slot is visible, it will show the new data after the next call to GETRender. +

+

+ The ENGINE_MODE_DYN_TILES flag must be set, otherwise this function does nothing. +

Parameters
previous contents
wordspaceWord—Space for result.
previous contents
numSecondsWord—Number of elapsed seconds.
@@ -1666,6 +1683,16 @@ style: toolref + + + + + + + + + + @@ -1700,13 +1727,19 @@ style: toolref
C
+

extern pascal void GTECopyTileToDynamic(tileID, dynID)

+

Word tileID;

+

Word dynID;

$16XX

GTESetPalette

-

+

+ Sets one of the 16 palettes to the RGB values in the passed array. This is a convenience function that + immediately updated the visible palette. The palette change is not deferred. +

Parameters
previous contents
tileIDWord—ID of the tile (0 to 511)
dynIDWord—ID of the dynamic tile slot (0 to 31)
@@ -1722,6 +1755,16 @@ style: toolref + + + + + + + + + + @@ -1756,13 +1799,19 @@ style: toolref
C
+

extern pascal void GTESetPalette(palNum, palettePtr)

+

Word palNum;

+

Pointer palettePtr;

$17XX

GTECopyPicToBG1

-

+

+ Copies an uncompressed SHR image into the secondard background pixel buffer. This is an easy way to load a + background image into the secondary layer. SCB values and palettes are not copied. +

Parameters
previous contents
palNumWord—Palette number to changes (0 - 15)
palettePtrLongpointer to the 32 bytes of RGB values.
@@ -1778,6 +1827,11 @@ style: toolref + + + + + @@ -1812,13 +1866,23 @@ style: toolref
C
+

extern pascal void GTECopyPicToBG1(picPtr)

+

Pointer picPtr;

$18XX

GTEBindSCBArray

-

+

+ Binds an array of SCB values to either the primary or secondard background layer. This will automatically + update the SHR screen SCB values as the vertical offset of the designated background layer changes. +

+

+ The SCB updates are not synchronized with the VBL, so care should be taken to select palette values that + minimize flicker when adjacent lines have different palette assignements and the page is scrolling + quickly. +

Parameters
previous contents
picPtrLongpointer to the uncompressed SHR data
@@ -1834,6 +1898,11 @@ style: toolref + + + + + @@ -1868,6 +1937,8 @@ style: toolref
C
+

extern pascal void GTEBindSCBArray(scbPtr)

+

Pointer scbPtr;

@@ -1877,6 +1948,7 @@ style: toolref

Parameters
+
previous contents
scbPtrLongpointer to an array of SCB values. The size of the array is defined by the largest verical offset that the application expects to use.
@@ -1890,6 +1962,21 @@ style: toolref + + + + + + + + + + + + + + + @@ -1911,6 +1998,21 @@ style: toolref + + + + + + + + + + + + + + + @@ -1924,6 +2026,7 @@ style: toolref
C
+

extern pascal struct TileMapInfo GTEGetBG0TileMapInfo()

@@ -1933,6 +2036,7 @@ style: toolref

Parameters
+
previous contents
longspaceLong—Space for result
wordspaceWord—Space for result
wordspaceWord—Space for result
previous contents
tileMapPtrLongpointer to the tile map.
heightWord—Height of the tilemap in tiles.
widthWord—Width of the tilemap in tiles.
@@ -1946,6 +2050,26 @@ style: toolref + + + + + + + + + + + + + + + + + + + + @@ -1967,6 +2091,26 @@ style: toolref + + + + + + + + + + + + + + + + + + + + @@ -1980,6 +2124,7 @@ style: toolref
C
+

extern pascal struct ScreenInfo GTEGetScreenInfo()

previous contents
wordspaceWord—Space for result
wordspaceWord—Space for result
wordspaceWord—Space for result
wordspaceWord—Space for result
previous contents
heightWord—Height of the playfield in lines.
widthWord—Width of the playfield in bytes.
yWord—Vertical coordinate of the upper-left corner.
xWord—Horizontal coordinate of the upper-left corner.