penguins-game/placement_8h_source.html

 #pragma once


 #include "game.h"

 #include "utils.h"

 #include <stdbool.h>


 #ifdef __cplusplus

 extern "C" {

 #endif


 typedef enum PlacementError {

   PLACEMENT_VALID = 0,

   PLACEMENT_OUT_OF_BOUNDS,

   PLACEMENT_EMPTY_TILE,

   PLACEMENT_ENEMY_PENGUIN,

   PLACEMENT_OWN_PENGUIN,

   PLACEMENT_MULTIPLE_FISH,

 } PlacementError;


 typedef enum PlacementSwitchError {

   PLACEMENT_ALL_PENGUINS_PLACED = -1,

   PLACEMENT_NO_MORE_FREE_TILES = -2,

 } PlacementSwitchError;


 void placement_begin(Game* game);

 void placement_end(Game* game);


 int placement_switch_player(Game* game);

 bool any_valid_placement_exists(const Game* game);


 bool validate_placement_simple(const Game* game, Coords target);

 PlacementError validate_placement(const Game* game, Coords target);

 void place_penguin(Game* game, Coords target);

 void undo_place_penguin(Game* game);


 #ifdef __cplusplus

 }

 #endif

game.h
The core of the unified game logic library, contains the Game struct.

PlacementSwitchError
PlacementSwitchError
Return values of placement_switch_player, must all be negative.
Definition: placement.h:24

PLACEMENT_ALL_PENGUINS_PLACED
@ PLACEMENT_ALL_PENGUINS_PLACED
Definition: placement.h:25

PLACEMENT_NO_MORE_FREE_TILES
@ PLACEMENT_NO_MORE_FREE_TILES
Definition: placement.h:26

PlacementError
PlacementError
Definition: placement.h:14

PLACEMENT_VALID
@ PLACEMENT_VALID
Definition: placement.h:15

PLACEMENT_OWN_PENGUIN
@ PLACEMENT_OWN_PENGUIN
Definition: placement.h:19

PLACEMENT_MULTIPLE_FISH
@ PLACEMENT_MULTIPLE_FISH
Definition: placement.h:20

PLACEMENT_ENEMY_PENGUIN
@ PLACEMENT_ENEMY_PENGUIN
Definition: placement.h:18

PLACEMENT_EMPTY_TILE
@ PLACEMENT_EMPTY_TILE
Definition: placement.h:17

PLACEMENT_OUT_OF_BOUNDS
@ PLACEMENT_OUT_OF_BOUNDS
Definition: placement.h:16

Coords
A pair of 2D coordinates, used for addressing the Game::board_grid.
Definition: utils.h:15

Game
The central struct of the application, holds the game data and settings.
Definition: game.h:237

Game::undo_place_penguin
void undo_place_penguin(Game *game)
Removes a GameLogPlacement entry from the log and undoes it.
Definition: placement.c:115

Game::validate_placement_simple
bool validate_placement_simple(const Game *game, Coords target)
Definition: placement.c:64

Game::any_valid_placement_exists
bool any_valid_placement_exists(const Game *game)
Definition: placement.c:51

Game::placement_begin
void placement_begin(Game *game)
Enters the GAME_PHASE_PLACEMENT phase, can only be called in GAME_PHASE_SETUP_DONE.
Definition: placement.c:11

Game::validate_placement
PlacementError validate_placement(const Game *game, Coords target)
Definition: placement.c:70

Game::placement_switch_player
int placement_switch_player(Game *game)
Performs the player switching logic for the placement phase.
Definition: placement.c:32

Game::place_penguin
void place_penguin(Game *game, Coords target)
Creates a GameLogPlacement entry. The requested placement must be valid.
Definition: placement.c:93

Game::placement_end
void placement_end(Game *game)
Exits the GAME_PHASE_PLACEMENT phase and switches to GAME_PHASE_SETUP_DONE.
Definition: placement.c:20

utils.h