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

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

2019-10-20T16:43:00Z

>Zachary.logsdon at 19:11, 13 October 2019

2019-10-13T19:11:35Z

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

2019-10-13T19:04:34Z

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

New page

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

== 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 SetNextGameStateForced() allows you to reset your current game state, while [[GSDP:GAM100/CProcessing/SetNextGameState()|SetNextGameState()]] with the current game state will not.

===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. This occurs when you call [[GSDP:GAM100/CProcessing/SetNextGameState()|SetNextGameState()]] or 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 39: / Line 39: @@
+}
-int main(void)
+CP_main
+{
    // Set the initial game state
@@ Line 53: / Line 53: @@
 * [[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 14: / Line 14: @@
 == Example Usage ==
 <syntaxhighlight lang='c'>
-void init(void)
+// Horizontal position of the square
+{
-   /* Set the size of the window */
+   // Start the square at the left of the screen
-   size(500, 500);
+  x_pos = 0;
+}
-void update(void)
+void update()
+{
-   /* Set the background color to black every frame */
+   // Set background to black
    background(color(0, 0, 0, 255));
-   /* Draw a rectangle at the mouse position */
+   // Draw the square
-   rect(mouseX, mouseY, 50, 50);
+   rect(x_pos, (float)canvasHeight / 2.0f, 100, 100);
+}