From 4b9d4233b3158bb5ac452ffeff60975db871ef5a Mon Sep 17 00:00:00 2001 From: Lucas Scharenbroich Date: Fri, 22 Jul 2022 16:31:49 -0500 Subject: [PATCH] Add in new toolbox calls --- docs/toolboxref.html | 376 +++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 366 insertions(+), 10 deletions(-) diff --git a/docs/toolboxref.html b/docs/toolboxref.html index 36f37d1..769d8cc 100644 --- a/docs/toolboxref.html +++ b/docs/toolboxref.html @@ -814,6 +814,7 @@ style: toolref
Errors
+

None

C
@@ -998,6 +999,7 @@ style: toolref
Errors
+

None

C
@@ -1059,14 +1061,12 @@ style: toolref previous contents - - xpos + xpos Word—Unsigned horizontal position - - ypos + ypos Word—Unsigned vertical position @@ -1101,6 +1101,7 @@ style: toolref
Errors
+

None

C
@@ -1116,16 +1117,93 @@ style: toolref

Renders the current playfield to the graphics screen.

Parameters
-

- The stack is not affected by this call. There are no input or output parameters. -

+ + + + + + + + + + + + + + + + + + + + + + + + +
Stack before call
previous contents
flagsWord—Render control flags
←SP
+ + + + + + + + + + + + + + + + + + + + +
Stack after call
previous contents
←SP
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
flags
RENDER_ALT_BG1$0001Set the data bank register to the alternate secondary background.
RENDER_BG1_HORZ_OFFSET$0002Offsets each scanline of the secondary background's horizontal position.
RENDER_BG1_VERT_OFFSET$0004Offsets each column of the secondary background's vertical position. Unimplemented.
RENDER_BG1_ROTATIONT$0004Use the internal rotation tables to render the secondary background
+
Errors
+

None

C
-

extern pascal void GTERender()

+

extern pascal void GTERender(flags)

+

Word flags;

@@ -1192,6 +1270,7 @@ style: toolref
Errors
+

None

C
@@ -1265,6 +1344,7 @@ style: toolref
Errors
+

None

C
@@ -1382,6 +1462,7 @@ style: toolref
Errors
+

None

C
@@ -1489,6 +1570,7 @@ style: toolref
Errors
+

None

C
@@ -1568,6 +1650,7 @@ style: toolref
Errors
+

None

C
@@ -1633,6 +1716,7 @@ style: toolref
Errors
+

None

C
@@ -1701,6 +1785,7 @@ style: toolref
Errors
+

None

C
@@ -1774,6 +1859,7 @@ style: toolref
Errors
+

None

C
@@ -1846,6 +1932,7 @@ style: toolref
Errors
+

None

C
@@ -1877,6 +1964,21 @@ style: toolref previous contents + + width + + Word—Width of the source image data to be copied in bytes. Maximum value of 256. + + + height + + Word—Height of the source image data to be copied in rows. Maximum value of 208. + + + stride + + Word—Number of bytes in each row + picPtr @@ -1913,10 +2015,14 @@ style: toolref
Errors
+

None

C
-

extern pascal void GTECopyPicToBG1(picPtr)

+

extern pascal void GTECopyPicToBG1(width, height, stride, picPtr)

+

Word width;

+

Word height;

+

Word stride;

Pointer picPtr;

@@ -1984,6 +2090,7 @@ style: toolref
Errors
+

None

C
@@ -2075,6 +2182,7 @@ style: toolref
Errors
+

None

C
@@ -2175,6 +2283,7 @@ style: toolref
Errors
+

None

C
@@ -2247,6 +2356,7 @@ style: toolref
Errors
+

None

C
@@ -2329,6 +2439,7 @@ style: toolref
Errors
+

None

C
@@ -2406,6 +2517,7 @@ style: toolref
Errors
+

None

C
@@ -2484,6 +2596,7 @@ style: toolref
Errors
+

None

C
@@ -2580,6 +2693,7 @@ style: toolref
Errors
+

None

C
@@ -2645,6 +2759,7 @@ style: toolref
Errors
+

None

C
@@ -2672,6 +2787,16 @@ style: toolref previous contents + + numTicks + + Word—Number of ticks between script invocations. + + + scriptAddr + + Long—pointer to the script bytecode. + ← @@ -2703,9 +2828,13 @@ style: toolref
Errors
+

None

C
+

extern pascal Word GTEStartScript(numTicks, scriptAddr)

+

Word numTicks;

+

Pointer scriptAddr;

@@ -2728,6 +2857,21 @@ style: toolref previous contents + + top + + Word—Top screen line of the overlay + + + bottom + + Word—Bottom screen line of the overlay. + + + procPtr + + Long—pointer to the callback function. + ← @@ -2759,16 +2903,21 @@ style: toolref
Errors
+

None

C
+

extern pascal Word GTESetOverlay(top, bottom, procPtr)

+

Word top;

+

Word bottom;

+

Pointer procPtr;

$23XX

GTEClearOverlay

-

This API is under active development at this time.

+

Removes the active overlay. This API is under active development at this time.

Parameters
@@ -2815,9 +2964,11 @@ style: toolref
Errors
+

None

C
+

extern pascal Word GTEClearOverlay()

@@ -2871,6 +3022,7 @@ style: toolref
Errors
+

None

C
@@ -2934,6 +3086,7 @@ style: toolref
Errors
+

None

C
@@ -2957,6 +3110,7 @@ style: toolref
Errors
+

None

C
@@ -2964,4 +3118,206 @@ style: toolref
+ +
+

$27XX

+

GTESetBG1Displacement

+

+ Sets a displacement into the BG1 offset table. Must be a value between 0 and 31. +

+
+
Parameters
+
+ + + + + + + + + + + + + + + + + + + + + + + +
Stack before call
previous contents
offsetWord—Offset index.
←SP
+ + + + + + + + + + + + + + + + + + + + +
Stack after call
previous contents
←SP
+
+
+
Errors
+

None

+
+
+
C
+

extern pascal void GTESetBG1Displacement(offset)

+

Word offset;

+
+
+ +
+

$28XX

+

GTESetBG1Rotation

+

+ Sets the rotation angle of the BG1 buffer. There are 64 sets in the angle tables, so + the value must be between 0 and 63. +

+
+
Parameters
+ + + + + + + + + + + + + + + + + + + + + + + + +
Stack before call
previous contents
rotIndexWord—Rotation index. Must be between 0 and 63.
←SP
+ + + + + + + + + + + + + + + + + + + + +
Stack after call
previous contents
←SP
+
+
+
Errors
+

None

+
+
+
C
+

extern pascal void GTESetBG1Rotation(rotIndex)

+

Word rotIndex;

+
+
+ + +
+

$29XX

+

GTEClearBG1Buffer

+

+ Clears the BG1 pixel buffer with a 16-bit value. +

+
+
Parameters
+ + + + + + + + + + + + + + + + + + + + + + + + +
Stack before call
previous contents
valueWord—16-bit value to fill all of BG1 memeory.
←SP
+ + + + + + + + + + + + + + + + + + + + +
Stack after call
previous contents
←SP
+
+
+
Errors
+

None

+
+
+
C
+

extern pascal void GTEClearBG1Buffer(value)

+

Word value;

+
+
+ +