View source for GSDP:GAM100/CProcessing/CP Engine Terminate()

{{GSDP:GAM100API.css}}
= CP_Engine_Terminate() =
== Description ==
This will end the program after completing the current frame.

== Example Usage ==
<syntaxhighlight lang='c'>
// Horizontal position of the square
float x_pos;
void init()
{
  // Start the square at the left of the screen
  x_pos = 0;

  // Set the square to draw yellow
  CP_Settings_Fill(CP_Color_Create(255, 255, 0, 255));
}

void update()
{
  // Set background to black
  CP_Settings_Background(CP_Color_Create(0, 0, 0, 255));

  // Draw the square
  CP_Graphics_DrawRect(x_pos, (float)CP_System_GetWindowHeight()/ 2.0f, 100, 100);
  x_pos += 2;

  // If space pressed, reset the state 
  if (CP_Input_KeyTriggered(KEY_SPACE))
  {
    CP_Engine_SetNextGameStateForced(init, update, NULL);
  }

  // If escape is pressed, end the program
  if (CP_Input_KeyTriggered(KEY_ESCAPE))
  {
    CP_Engine_Terminate();
  }
}

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

  // Run the program
  CP_Engine_Run();    
}

</syntaxhighlight>

=== See Also ===
* [[GSDP:GAM100/CProcessing                                   |Main Page                         ]]
* [[GSDP:GAM100/CProcessing/CP_Engine_Run()                   |CP_Engine_Run()                   ]]
* [[GSDP:GAM100/CProcessing/CP_Engine_SetNextGameState()      |CP_Engine_SetNextGameState()      ]]
* [[GSDP:GAM100/CProcessing/CP_Engine_SetNextGameStateForced()|CP_Engine_SetNextGameStateForced()]]
* [[GSDP:GAM100/CProcessing/CP_Engine_GetWindowHandle()       |CP_Engine_GetWindowHandle()       ]]
* [[GSDP:GAM100/CProcessing/CP_Settings_Fill()                |CP_Settings_Fill()                ]]
* [[GSDP:GAM100/CProcessing/CP_Color_Create()                 |CP_Color_Create()                 ]]
* [[GSDP:GAM100/CProcessing/CP_Settings_Background()          |CP_Settings_Background()          ]]
* [[GSDP:GAM100/CProcessing/CP_Graphics_DrawRect()            |CP_Graphics_DrawRect()            ]]
* [[GSDP:GAM100/CProcessing/CP_System_GetWindowHeight()       |CP_System_GetWindowHeight()       ]]
* [[GSDP:GAM100/CProcessing/CP_Input_KeyTriggered()           |CP_Input_KeyTriggered()           ]]