Game Struct - Revision history

Mzxrules at 15:27, 6 August 2021

2021-08-06T15:27:57Z

Mzxrules: Mzxrules moved page Global Context to Game Struct: chaos chaos

2021-08-06T14:45:56Z

Mzxrules moved page Global Context to Game Struct: chaos chaos

Mzxrules: /* Addresses */

2017-11-07T03:52:02Z

‎Addresses

Mzxrules: /* Input Struct */

2017-10-26T02:54:45Z

‎Input Struct

Mzxrules: Reverted edits by GlitterBerri (talk) to last revision by Mzxrules

2017-09-05T07:44:25Z

Reverted edits by GlitterBerri (talk) to last revision by Mzxrules

Show changes

GlitterBerri: /* Overview */

2017-09-04T22:43:21Z

‎Overview

GlitterBerri: /* Addresses */

2017-09-04T22:41:49Z

‎Addresses

Show changes

Mzxrules: /* Addresses */

2017-07-30T05:24:52Z

‎Addresses

Mzxrules: /* Input Struct */

2016-09-19T11:39:46Z

‎Input Struct

Mzxrules: /* Input Struct */ missin' inputs

2016-09-19T11:39:22Z

‎Input Struct: missin' inputs

@@ Line 1: / Line 1: @@
 {{address3|
 |space=ram
-|name=Global Context (Common)
+|name=Game Struct
 |ver1=Debug|ref1=ram|start1=80212020|size1=a4
 |ver2=NTSC 1.0|ref2=ram|start2=801C84A0|size2=a4
@@ Line 10: / Line 10: @@
 }}
 {{See also|Ram Map}}
-{{for|documentation of the playable [[Game State]]|Global Context (Game)}}
+{{for|documentation of the game_play [[Game State]], historically known as the Global Context|Game Play Struct}}
-The '''Global Context''' is a dynamically allocated space that stores [[Game State]] related variables that only persist during that state's execution. section of ram that contains a set of game engine related variables. The starting address is a very important address as it is argument 0 for many functions. The global context is sometimes abbreviated as 'ctxt'
+The '''Game Struct''' is a shared struct used by the dynamically allocated [[Game State|Game States]]. It contains the barebones variables needed to make a custom game state; a reference to the Graphics Context, state variables for initializing/executing/swapping Game States, input, memory allocations, and provides access to number of update cycles. By chance, Game States happen to always be allocated to the same memory address.
 {{clear}}
@@ Line 27: / Line 27: @@
 | 0C || ptr || 8021202C || 801C84AC || 801C866C || 801C8D6C || 801C64EC || 801C652C || Stores next Game State's "Constructor" when swapping Game States
 |-
-| 10 || ptr || 80212030 || 801C84B0 || 801C8670 || 801C8D70 || 801C64F0 || 801C6530 || Global Context's size (never read, set to 0 after initialization is complete)
+| 10 || ptr || 80212030 || 801C84B0 || 801C8670 || 801C8D70 || 801C64F0 || 801C6530 || [Game State] struct's size (never read, set to 0 after initialization is complete)
 |-
 | 14 || input_struct || 80212034 || 801C84B4 || 801C8674 || 801C8D74 || 801C64F4 || 801C6534 || Controller Port 1

@@ Line 51: / Line 51: @@
 | 94 || ptr || 802120B4 || 801C8534 || 801C86F4 || 801C8DF4 || 801C6574 || 801C65B4 || Pointer to Main Heap node storing the Game State's memory heap
 |-
-| 98 || i32 || 802120B8 || 801C8538 || 801C86F8 || 801C8DF8 || 801C6578 || 801C65B8 || Execute Game State. If zero, swaps game state based on "Constructor" pointer
+| 98 || s32 || 802120B8 || 801C8538 || 801C86F8 || 801C8DF8 || 801C6578 || 801C65B8 || Execute Game State. If zero, swaps game state based on "Constructor" pointer
 |-
-| 9C || i32 || 802120BC || 801C853C || 801C86FC || 801C8DFC || 801C657C || 801C65BC || Frames run while current Game State has been alive
+| 9C || s32 || 802120BC || 801C853C || 801C86FC || 801C8DFC || 801C657C || 801C65BC || Frames run while current Game State has been alive
 |-
-| A0 || i32 || 802120C0 || 801C8540 || 801C8700 || 801C8E00 || 801C6580 || 801C65C0 || Unknown
+| A0 || s32 || 802120C0 || 801C8540 || 801C8700 || 801C8E00 || 801C6580 || 801C65C0 || Unknown
 |}

@@ Line 60: / Line 60: @@
 == Input Struct ==
 <pre>
-x00 short = Buttons 1
+: InputInfo InputCurrent;     //Joystick Input is less than InputReleaseEdge?
-//enumeration
+: InputInfo InputLast;        //computed at 60 fps, thus can appear equal to Current
-= C-Right
+C: InputInfo InputPressEdge;   //Joystick info is actually change in position
-= C-Left
+: InputInfo InputReleaseEdge; //Joystick Info is real-time input
-x02 sbyte = X axis 1, right is positive, left is negative
+InputInfo Struct (0x06 bytes) is as follows:
-x03 sbyte = Y axis 1, up is positive, down is negative</pre>
+: //short = Buttons
 [[Category:Game State]][[Category: Ram]]

@@ Line 202: / Line 202: @@
 | 80224040
 |-
+| 12124
+|
+|

@@ Line 37: / Line 37: @@
 | 5C || input_struct || 8021207C || 801C84FC || 801C86BC || 801C8DBC || 801C653C || 801C657C || Controller Port 4
 |-
-| 74 || u32 || 80212094 || 801C8514 || 801C86D4 || 801C8DD4 || 801C6554 || 801C6594 || Size of Game State's memory heap
+| 74 || u32 || 80212094 || 801C8514 || 801C86D4 || 801C8DD4 || 801C6554 || 801C6594 || Size of Game State's heap
 |-
-| 78 || ptr || 80212098 || 801C8518 || 801C86D8 || 801C8DD8 || 801C6558 || 801C6598 || Pointer to start of Game State's Memory Heap
+| 78 || ptr || 80212098 || 801C8518 || 801C86D8 || 801C8DD8 || 801C6558 || 801C6598 || Game State's heap pointer
 |-
-| 7C || ptr || 8021209C || 801C851C || 801C86DC || 801C8DDC || 801C655C || 801C659C || Start Address of unallocated heap (possibly, doesn't seem to be used)
+| 7C || ptr || 8021209C || 801C851C || 801C86DC || 801C8DDC || 801C655C || 801C659C || Heap Append Start pointer
 |-
-| 80 || ptr || 802120A0 || 801C8520 || 801C86E0 || 801C8DE0 || 801C6560 || 801C65A0 || End Address of unallocated heap
+| 80 || ptr || 802120A0 || 801C8520 || 801C86E0 || 801C8DE0 || 801C6560 || 801C65A0 || Heap Append End pointer
 |-
 | 84 || ptr || 802120A4 || 801C8524 || 801C86E4 || 801C8DE4 || 801C6564 || 801C65A4 || Pointer to Main Heap node storing the Game State's memory heap
@@ Line 53: / Line 53: @@
 | 98 || i32 || 802120B8 || 801C8538 || 801C86F8 || 801C8DF8 || 801C6578 || 801C65B8 || Execute Game State. If zero, swaps game state based on "Constructor" pointer
 |-
-| 9C || i32 || 802120BC || 801C853C || 801C86FC || 801C8DFC || 801C657C || 801C65BC || Number of frames? run while current Game State has been alive
+| 9C || i32 || 802120BC || 801C853C || 801C86FC || 801C8DFC || 801C657C || 801C65BC || Frames run while current Game State has been alive
 |-
 | A0 || i32 || 802120C0 || 801C8540 || 801C8700 || 801C8E00 || 801C6580 || 801C65C0 || Unknown

← Older revision	Revision as of 14:45, 6 August 2021
(No difference)

@@ Line 71: / Line 71: @@
 = D-Left
 = D-Down
-= D-Up button
+= D-Up
 = Start Button
 = Z Button

@@ Line 68: / Line 68: @@
 = R Button
 = L Button
 = D-Up button
 = Start Button