GSDP:GAM100/CProcessing/SetNextGameState() - Revision history

>Zachary.logsdon at 16:41, 20 October 2019

2019-10-20T16:41:41Z

>Zachary.logsdon at 16:41, 20 October 2019

2019-10-20T16:41:26Z

>Zachary.logsdon at 18:51, 13 October 2019

2019-10-13T18:51:22Z

>Zachary.logsdon: New page: {{GSDP:GAM100API.css}} = SetNextGameState() = == Description == This sets the next state for the program to enter. This will call the shutdown function of the current state if own exists....

2019-10-13T18:50:58Z

New page: {{GSDP:GAM100API.css}} = SetNextGameState() = == Description == This sets the next state for the program to enter. This will call the shutdown function of the current state if own exists....

New page

{{GSDP:GAM100API.css}}
= SetNextGameState() =

== Description ==
This sets the next state for the program to enter. This will call the shutdown function of the current state if own exists. Calling SetNextGameState() on the same state you are currently in will have no effect, but calling [[GSDP:GAM100/CProcessing/SetNextGameStateForced()|SetNextGameStateForced()]] will restart the current state.

===Parameters===
SetNextGameState(FunctionPtr init, FunctionPtr update, FunctionPtr shutdown)

* init - (FunctionPtr) The name of the function called once when the state first begins. This can be NULL if no initialization is needed for your state.
* update - (FunctionPtr) The name of the function called every frame to update the state.
* shutdown - (FunctionPtr) The name of the function called when you leave a state, that is when you call SetNextGameState or [[GSDP:GAM100/CProcessing/SetNextGameStateForced()|SetNextGameStateForced()]] to change states. This can be NULL if no cleanup is needed for your state.

== Example Usage ==
<syntaxhighlight lang='c'>
void init(void)
{
/* Set the size of the window */
size(500, 500);
}

void update(void)
{
/* Set the background color to black every frame */
background(color(0, 0, 0, 255));

/* Draw a rectangle at the mouse position */
rect(mouseX, mouseY, 50, 50);
}

int main(void)
{
// Set the initial game state
SetNextGameState(init, update, NULL);

// Run the program
Run();
}

</syntaxhighlight>

=== See Also ===
* [[GSDP:GAM100/CProcessing|Main Page]]
* [[GSDP:GAM100/CProcessing/Run()|Run()]]
* [[GSDP:GAM100/CProcessing/Terminate()|Terminate()]]
* [[GSDP:GAM100/CProcessing/SetNextGameState()|SetNextGameState()]]
* [[GSDP:GAM100/CProcessing/SetNextGameStateForced()|SetNextGameStateForced()]]

@@ Line 29: / Line 29: @@
+}
-int main(void)
+CP_main
+{
    // Set the initial game state

@@ Line 43: / Line 43: @@
 * [[GSDP:GAM100/CProcessing|Main Page]]
 * [[GSDP:GAM100/CProcessing/Run()|Run()]]
 * [[GSDP:GAM100/CProcessing/Terminate()|Terminate()]]
 * [[GSDP:GAM100/CProcessing/SetNextGameState()|SetNextGameState()]]
 * [[GSDP:GAM100/CProcessing/SetNextGameStateForced()|SetNextGameStateForced()]]

@@ Line 10: / Line 10: @@
 * init - (FunctionPtr) The name of the function called once when the state first begins. This can be NULL if no initialization is needed for your state.
 * update - (FunctionPtr) The name of the function called every frame to update the state.
-* shutdown - (FunctionPtr) The name of the function called when you leave a state, that is when you call SetNextGameState or [[GSDP:GAM100/CProcessing/SetNextGameStateForced()|SetNextGameStateForced()]] to change states. This can be NULL if no cleanup is needed for your state.
+* shutdown - (FunctionPtr) The name of the function called when you leave a state. This occurs when you call SetNextGameState or [[GSDP:GAM100/CProcessing/SetNextGameStateForced()|SetNextGameStateForced()]] to change states. This can be NULL if no cleanup is needed for your state.
 == Example Usage ==