feature: create functions to start the game by console

Co-authored-by: Guidolinares <[email protected]>
Co-authored-by: tefhuergo <[email protected]>
Co-authored-by: Tiago Giannotti <[email protected]>

Author: 4 people

libs/utilities.c

@@ -5,10 +5,11 @@
 #include <stdio.h>
 #include <stdlib.h>
 #include <string.h>
+#include <time.h>
 
 #include "./patterns/main.h"
 
-int countNeighbors(TGame* pGame, int cellRow, int cellCol, int radius) {
+int countAliveNeighbors(TGame* pGame, int cellRow, int cellCol, int radius) {
     int i;
     int j;
 
@@ -18,7 +19,7 @@ int countNeighbors(TGame* pGame, int cellRow, int cellCol, int radius) {
     int endRow = cellRow + radius + 1;
     int endCol = cellCol + radius + 1;
 
-    int neighbors = 0;
+    int aliveNeighbors = 0;
 
     for (i = startRow; i < endRow; i++) {
         if (i > pGame->rows - 1) break;
@@ -29,11 +30,13 @@ int countNeighbors(TGame* pGame, int cellRow, int cellCol, int radius) {
             if (j < 0) continue;
 
             if (i == cellRow && j == cellCol) continue;
-            if (pGame->dashboard[i][j] == ALIVE_CELL) neighbors++;
+
+            if (pGame->dashboard[i][j] == ALIVE_CELL || pGame->dashboard[i][j] == DEAD_CELL_NG)
+                aliveNeighbors++;
         }
     }
 
-    return neighbors;
+    return aliveNeighbors;
 }
 
 void drawPattern(TGame* pGame, char* pattern) {
@@ -160,6 +163,69 @@ void setDashboardCenter(TGame* pGame) {
     pGame->center[1] = col;
 }
 
+void sleep(int miliseconds) {
+    clock_t startTime = clock();
+    while (clock() < (startTime + miliseconds));
+}
+
+void startGameByConsole(TGame* pGame, int maxGeneration, int delayBetweenGenerations) {
+    int i;
+    int j;
+
+    int generation = 0;
+    int aliveNeighbors;
+
+    pGame->generation = 0;
+
+    system("cls");
+    printDashboardByConsole(pGame);
+    if (generation == maxGeneration) return;
+    sleep(delayBetweenGenerations);
+
+    while (generation < maxGeneration) {
+        for (i = 0; i < pGame->rows; i++) {
+            for (j = 0; j < pGame->cols; j++) {
+                aliveNeighbors = countAliveNeighbors(pGame, i, j, NEIGHBORHOOD_RADIUS);
+
+                if (pGame->dashboard[i][j] == DEAD_CELL) {
+                    if (aliveNeighbors == 3) {
+                        pGame->cellsDead--;
+                        pGame->cellsAlive++;
+                        pGame->dashboard[i][j] = ALIVE_CELL_NG;
+                    };
+
+                    continue;
+                }
+
+                if (aliveNeighbors < 2 || aliveNeighbors > 3) {
+                    pGame->cellsAlive--;
+                    pGame->cellsDead++;
+                    pGame->dashboard[i][j] = DEAD_CELL_NG;
+                };
+            }
+        }
+
+        for (i = 0; i < pGame->rows; i++) {
+            for (j = 0; j < pGame->cols; j++) {
+                if (pGame->dashboard[i][j] == DEAD_CELL_NG) {
+                    pGame->dashboard[i][j] = DEAD_CELL;
+                    continue;
+                }
+
+                if (pGame->dashboard[i][j] == ALIVE_CELL_NG) pGame->dashboard[i][j] = ALIVE_CELL;
+            }
+        }
+
+        generation++;
+
+        pGame->generation = generation;
+
+        system("cls");
+        printDashboardByConsole(pGame);
+        if (generation != maxGeneration) sleep(delayBetweenGenerations);
+    }
+}
+
 int strcmpi(const char* str01, const char* str02) {
     int i;
 

libs/utilities.h

@@ -26,8 +26,23 @@ typedef struct {
     int generation; /** Represents the generation number. */
 } TGame;
 
-// TODO: Documentation
-int countNeighbors(TGame* pGame, int row, int col, int radius);
+/**
+ * @brief Counts the number of alive neighbors around a given position inside the `dashboard` field
+ * of a Conway's Game of Life structure.
+ *
+ * This function iterates through the cells within a specified radius around the given cell
+ * (excluding the cell itself) and counts how many of those cells are alive.
+ *
+ * @param pGame Pointer to the Conway's Game of Life structure.
+ * @param row Row index of the cell.
+ * @param col Column index of the cell.
+ * @param radius Radius around the cell to check for alive neighbors.
+ *
+ * @return The number of alive neighbors around the specified cell.
+ *
+ * @warning This function assumes that `pGame` has been properly initialized.
+ */
+int countAliveNeighbors(TGame* pGame, int row, int col, int radius);
 
 /**
  * @brief Draws a specified pattern on a Conway's Game of Life board.
@@ -113,6 +128,24 @@ void printDashboardByConsole(TGame* pGame);
  */
 void setDashboardCenter(TGame* pGame);
 
+/**
+ * @brief Pauses the execution of the program.
+ *
+ * @warning The actual delay may be longer than specified due to system timer.
+ */
+void sleep(int milliseconds);
+
+/**
+ * @brief Starts a Conway's Game of Life game using the console as the output.
+ *
+ * @param pGame Pointer to a Conway's Game of Life structure.
+ * @param maxGeneration Maximum number of generations.
+ * @param delayBetweenGenerations Delay in milliseconds between each generation.
+ *
+ * @warning This function assumes that `pGame` has been properly initialized.
+ */
+void startGameByConsole(TGame* pGame, int maxGeneration, int delayBetweenGenerations);
+
 /**
  * @brief Compares two strings case-insensitively.
  *

src/main.c

@@ -11,11 +11,12 @@ int main() {
     int cols = DASHBOARD_COLS;
 
     char* requestedPattern;
-    char* maxGenerations;
+    char* maxGeneration;
     char* delayBetweenGenerations;
     char delayBetweenGenerationsMsg[120];
+    char* platformSelected;
 
-    int maxGenerationsInt;
+    int maxGenerationInt;
     int delayBetweenGenerationsInt;
 
     game.dashboard = dashboard;
@@ -32,7 +33,7 @@ int main() {
     /* ----------------------------- Request Pattern ---------------------------- */
 
     requestedPattern = getUserInputStr(
-        "> Which pattern do you want ('Glider','Toad', 'Press', or 'Glider cannon')? ",
+        "> Which pattern do you want? ('Glider','Toad', 'Press', or 'Glider cannon'): ",
         "> Invalid pattern! Try again...", 50, &validatePattern);
 
     printf("> Pattern received: '%s'.\n\n", requestedPattern);
@@ -41,23 +42,23 @@ int main() {
 
     /* ----------------------- Request Maximum Generation ----------------------- */
 
-    maxGenerations = getUserInputStr(
+    maxGeneration = getUserInputStr(
         "> Which is maximum generation do you want? (a negative number is equal to infinity): ",
         "> Invalid generation! Try again...", 10, &validateGeneration);
 
-    sscanf(maxGenerations, "%d", &maxGenerationsInt);
+    sscanf(maxGeneration, "%d", &maxGenerationInt);
 
-    if (maxGenerationsInt < 0) {
-        maxGenerations = "'infinity'";
-        maxGenerationsInt = INT_MAX;
+    if (maxGenerationInt < 0) {
+        maxGeneration = "'infinity'";
+        maxGenerationInt = INT_MAX;
     };
 
-    printf("> Maximum generation received: %s.\n\n", maxGenerations);
+    printf("> Maximum generation received: %s.\n\n", maxGeneration);
 
     /* ------------------------------ Request Delay ----------------------------- */
 
     sprintf(delayBetweenGenerationsMsg,
-            "> What should be the miliseconds delay between generations? (must be between %d and "
+            "> What should be the milliseconds delay between generations? (must be between %d and "
             "%d, both included): ",
             MINIMUM_DELAY, MAXIMUM_DELAY);
 
@@ -66,7 +67,23 @@ int main() {
 
     sscanf(delayBetweenGenerations, "%d", &delayBetweenGenerationsInt);
 
-    printf("> Delay received: %s miliseconds.\n", delayBetweenGenerations);
+    printf("> Delay received: %s milliseconds.\n\n", delayBetweenGenerations);
+
+    /* ---------------------------- Request Platform ---------------------------- */
+
+    platformSelected = getUserInputStr(
+        "> In which platform do you want to start the Conway's Game of Life game? (console, or "
+        "Simple DirectMedia Layer (SDL)): ",
+        "> Invalid option! Try again...", 32, &validatePlatform);
+
+    printf("> Platform selected: '%s'.\n", platformSelected);
+
+    if (strcmpi(platformSelected, "console") == 0) {
+        startGameByConsole(&game, maxGenerationInt, delayBetweenGenerationsInt);
+        return 0;
+    }
+
+    // TODO: Start game in SDL.
 
     return 0;
 }