search

parkgeonhu / snake-game

C++ 프로그래밍 언어로 ncurses 라이브러리를 사용하여 Snake Game 을 구현한다.
MIT License
4 stars 2 forks source link

[Report] 레포트 작성과 분담 #33

Closed parkgeonhu closed 4 years ago

parkgeonhu commented 4 years ago

레포트 작성

민대인 작업 목록 @bamin0422

1. 개요

이번 프로젝트에 사용한 외부 라이브러리는 ncurses 한 가지입니다. 개발환경인 리눅스 우분투를 기준으로 획득/설치 방법은 sudo apt-get install libncurses5-dev libncursesw5-dev 입력하여 설치했습니다. 그 후 코드 내에서 #include 를 기입하여 개발했습니다. 또한 make 유틸리티를 이용하여 컴파일을 다음과 같이 진행하고 실행합니다.

all:
    g++ src/GameScene.cpp src/GameOverScene.cpp src/Snake.cpp src/Stage.cpp src/myFunction.cpp src/ItemManager.cpp src/WaitingScene.cpp src/Item.cpp src/main.cpp -lncurses -o /tmp/a.out && /tmp/a.out

개발 방법으로는, git flow 방식과 github template을 이용하여 Pull Request 를 하였습니다. 저희팀의 협업방식은 feature/기능 이란 브런치를 만들어 commit을 원격 브런치로 푸시하고, Pull Request를 했습니다. Pull Request를 할 때, 자신이 작업한 브런치에서는 어떤 점이 개선되었고, 버그가 있다면 어떤 버그가 있는지 간략하게 요약해 첨부하였습니다.

저희팀의 snake-game 구조는 Scene으로 구성되어 있습니다. 현재 사용자가 어떤 Scene에 있는지에 따라 다른 화면을 렌더링하는 구조를 택했습니다. 예를 들어 프로그램에서 대기 화면을 출력하고자 했을 때, 화면이 Update 되는 부분, Render 하는 부분이 반복될 것입니다. Update 부분은 사용자의 입력을 받거나, Scene이 바뀌어야 하는 조건들이 있습니다. Render 부분은 화면에 출력해야 하는 오브젝트를 출력하는 기능을 담고 있습니다. 따라서 myFunction.cpp 부분은 myFunction.h 를 include 하였습니다. 그리고 이것을 main.cpp에 include를 함으로써 현재의 Scene을 Update와 Rendering 합니다. Scene이 바뀌려면 myFunction.h에 있는 ChangeScene이라는 기능을 이용하여 이전의 Scene을 delete하고, nowScene에 바꾸려고 하는 Scene으로 초기화 해줍니다.

myFunction.cpp

#include "myFunction.h"
#include "WaitingScene.h"

IScene *nowScene;
bool lkey[256],rkey[256];

int currentWidth;
int currentHeight;

std::chrono::steady_clock::time_point startTime;

void Init(){
    startTime = std::chrono::steady_clock::now();
    nowScene = new WaitingScene();
}

void Update(float eTime){
    nowScene->Update(eTime);
}

void Render(){
    nowScene->Render();
}

void Destroy(){
    delete nowScene;
}

float GetElapsedTime(){
    auto endTime = std::chrono::steady_clock::now();
    std::chrono::duration<float> elapsed_seconds = endTime-startTime;
    float eTime = (float)elapsed_seconds.count();
    return eTime;
}

void ChangeScene(IScene *p,bool nowSceneErase){
    if(nowSceneErase) delete nowScene;
    nowScene = p;
}

myFunction.cpp 에서 GetElapsedTime() 함수는 프로그램이 실행된 시각에서 현재의 시각을 빼준 값입니다. 그 값을 실수로 처리하여 21.21312 등의 형식으로 main에서 계산되어 모든 Scene과 Object에 Update 매개변수로 넣어줍니다. 이것은 아이템을 생성할 때, 생성 후 시간이 몇 초간 지났는지 알기 위해서 만들었습니다.

IScene.cpp

#pragma once
#include "Stage.h"
class IScene
{
public:
    IScene() {}
    virtual ~IScene() {}
    virtual void Render() = 0;
    virtual void Update(float eTime) = 0;
};

IObject.cpp

#pragma once
class IObject
{
public:
    IObject() {}
    virtual ~IObject() {}
    virtual void Update(float eTime) = 0;
    virtual void Render() = 0;
};

main.cpp

int main()
{
    Init();
    do
    {
        Update(GetElapsedTime());
        Render();
    } while (true);
    Destroy();
    return 0;
}

게임에서의 핵심 Object는 Player(사용자), Snake(뱀 캐릭터) 입니다. Player는 사용자의 점수를 관리하기 위해 사용합니다. Snake는 뱀이 움직일 때마다 각 요소(몸통, 꼬리, 머리)의 데이터를 저장하기 위해 사용합니다. 그래서 이 오브젝트를 GameScene 이라고 하는 파일에서 관리합니다. GameScene에서 뱀이 죽거나, 시간이 초과되거나 등의 이벤트가 발생한다면 ChangeScene을 통해 Scene을 바꿔줍니다.

게임에서 Snake를 추상화하면, (몸통, 꼬리, 머리)라는 데이터를 저장해야하는 vector와 독 아이템을 먹었을 때 몸집이 줄어드는 Shrink 함수, 과일을 먹었을 때 몸집이 커지는 Grow 함수, 일정시간이 지나면 움직이는 Update 함수, Snake의 데이터를 출력하는 Render 함수로 추상화할 수 있습니다.

2. 개발 내용 및 결과물

2.1 목표

적용단계 내용 적용 여부
1단계 Map의 구현 적용/미적용
2단계 Snake 표현 및 조작 적용/미적용
3단계 Item 요소의 구현 적용/미적용
4단계 Gate 요소의 구현 적용/미적용
5단계 점수 요소의 구현 적용/미적용

1단계. Map의 구현

2단계. Snake 표현 및 조작

3단계. Item 요소의 구현

4단계. Gate 요소의 구현

5단계. 점수 요소의 구현

6단계. 메인 화면 구현 및 스테이지 번호 구현

2.2 개발 내용 및 결과물 6

2.2.1 개발 내용 6

1단계: map의 구현

Map은 2차원 배열로 구성되어 있습니다. 첫 번째 index엔 Map의 세로 길이를, 두 번째 index에는 가로 길이를 저장합니다. 각 stage별로 map의 모양을 바꾸어 난이도 조절을 하였습니다. Map의 구성 요소인 빈 공간, Wall등을 switch문과 ncurses함수 mvwaddch()을 활용하여 각각 ‘ ‘,‘-’등으로 나타냅니다. MapManager의 char data 배열의 값 중 0은 뱀이 움직일 수 있는 빈칸, 1은 Snake의 머리와 충돌할 경우의 죽는 벽, 2는 gate가 생성될 수 없는 벽, 3은 Snake의 머리, 4는 Snake의 몸통, 5는 Snake의 크기가 늘어나는 아이템, 6은 Snake의 크기가 줄어드는 아이템, 7은 Gate, 8은 빈칸입니다.

2단계: Snake 표현 및 조작

3단계: Item의 구현

Item은 Item의 좌표, 아이템의 개수, 종류, 모양을 서로 다른 변수로 지정하였습니다. 아이템의 모양은 종류에 따라 Growth라면 출력은 ‘G’로 Map에는 5로, Poison이라면 출력은 ‘P’로 Map에는 6으로 나타납니다. Item이 생성될 때 lastDropTime을 프로젝트 구조 내 float eTime으로 받아와 저장하고 현재 시각과 비교하여 5초가 지나면 Item을 재 생성하도록 함수를 만들었습니다. 이때 좌표는 getRandPoisition 함수를 통해 Snake가 움직일 수 있는 '0' 좌표에만 생성 가능하게 해놓았습니다. Item의 종류는 Item 클래스의 string type으로 구분하며, "poison" type 아이템과 충돌하면 Snake의 Size를 1씩 줄입니다. "fruit" type 아이템과 충돌하면 Snake의 Size를 1씩 늘립니다.

4단계: Gate의 구현

벽을 표현하는 '2'에만 Gate가 생성될 수 있도록 합니다.두 개의 Gate 좌표를 random하게 정합니다. Gate는 Snake의 Size가 4보다 클 때 생성됩니다. Gate가 생성될 때 lastDropTime을 프로젝트 구조 내 float eTime으로 받아와 저장하고 현재 시각과 비교하여 5초가 지나면 Gate를 재생성하도록 함수를 만들었습니다. Snake가 통과 중에는 사라지지 않아야 하므로 꼬리의 위치가 다음 게이트의 위치의 좌표에 도달한 경우 사라지게 했습니다. Gate 진입 시, 다른 Gate로 나올 Snake의 위치는 프로젝트 명세서에 따르어 계산된 Gate의 위치입니다.

5단계: 점수 요소의 구현

6단계: 메인 화면 구현 및 스테이지 번호 구현

2.2.2 시스템 구조 및 설계도 6

1단계. Map의 구현

#pragma once

struct CharPosition 
{
    int32 x, y;
    CharPosition(int col, int row) : x(col), y(row) {}
    CharPosition() : x(0), y(0) {}
};

CharPosition는 Object의 좌표 x,y를 효율적으로 나타내기 위해서 사용했습니다. CharPosition test; 와 같은 코드를 타이핑 했다면 test.x, test.y 형식으로 접근할 수 있습니다. 이는 Snake의 몸을 표현할 때도 쓰이고, 아이템, 게이트의 위치를 표현할 때 사용됩니다.

MapManager라는 클래스는 data라는 char 배열을 담고 있습니다. 처음 GameScene이 초기화될 때, MapManager의 Load라는 함수를 호출합니다. Load 함수는 텍스트파일로 저장되어있는 맵 파일을 ifstream을 사용하여 한 줄씩 끝까지 읽습니다. 읽을 때마다 data배열에 값을 넣어줍니다.

data 배열에 접근하여 뱀이 움직여 위치가 바뀐다던지, 아이템이 spawn된다던지 등 이벤트가 발생하여 생성된 object의 위치에 해당 object를 기입하여 줍니다. 예를 들어 (3,4) 에서 아이템이 spawn 됐다면, data[3] [4] 위치에 아이템을 넣어줍니다. 그래서 ItemManager, GateManager, Snake에서는 MapManger의 PatchData라는 함수를 이용해 Map을 업데이트해줍니다.

#include "MapManager.h"
#include "myFunction.h"
#include <vector>
#include <fstream>

extern Stage *stage;

MapManager::MapManager() // load txt file. named stageName. ex) 1.txt 2.txt 3.txt 4.txt
{
}

void MapManager::Load(){

    std::ifstream readFile;
    string src = "map/map"+std::to_string(stage->getNowStage()+1) + ".txt";

    readFile.open(src);
    int height = 0;

    while (!readFile.eof()){
        char temp[120];
        readFile.getline(temp, 120);

        for(int i=0;i<WIDTH;i++){
            data[height][i]=temp[i];
        }

        height++;
    }

    /* data가 올바르게 들어갔는지 확인하기 위한 검증 코드*/
    // std::string Path = "test.txt";

    // std::ofstream writeFile(Path);
    // if (writeFile.is_open())
    // {
    // for(int i=0;i<HEIGHT;i++){
    // for(int j = 0; j < WIDTH; j++){
    // writeFile <<data[i][j];
    // // cout<<data[i][j];
    // }
    // writeFile << "\n";
    // }

    // }
}

void * MapManager::GetData(){
    return data;
}

void MapManager::PatchData(int y, int x, char patchData){
    data[y][x]=patchData;
}

MapManager::~MapManager()
{
}

void MapManager::Render()
{
}

void MapManager::Update(float eTime)
{
}

GameScene에서 관리하는 MapManager 클래스를 이용해 GameScene::Render() 에서 MapManager 안의 데이터를 출력합니다. MapManager 안의 data 배열은 0~8 문자가 들어가 있습니다. 0은 뱀이 움직일 수 있는 빈칸, 1은 Snake의 머리와 충돌할 경우의 죽는 벽, 2는 gate가 생성될 수 없는 벽, 3은 Snake의 머리, 4는 Snake의 몸통, 5는 Snake의 크기가 늘어나는 아이템, 6은 Snake의 크기가 줄어드는 아이템, 7은 Gate, 8은 빈칸입니다. 다시 말해, GameScene::Render() 부분은 Map을 출력하는 역할을 합니다.

void GameScene::Render()
{
  format->Render();

  for (int i = 0; i < HEIGHT; i++)
  {
    for (int j = 0; j < WIDTH; j++)
    {
      switch (mapManager->data[i][j])
      {
      case '0':
        mvaddch(i, j, ' ');
        break;
      case '1':
        mvaddch(i, j, '-');
        break;
      case '2':
        mvaddch(i, j, 'X');
        break;
      case '3':
        mvaddch(i, j, 'H');
        break;
      case '4':
        mvaddch(i, j, 'B');
        break;
      case '5':
        mvaddch(i, j, 'G');
        break;
      case '6':
        mvaddch(i, j, 'P');
        break;
      case '7':
        mvaddch(i, j, '?');
        break;
      case '8':
        mvaddch(i, j, ' ');
      }
    }
  }

  refresh();
}

2단계. Snake 표현 및 조작

Snake가 처음 생성될 때 entire vector에 30, 31, 32, 33, 34 위치에 CharPosition을 넣어줍니다. Snake::Update 부분은 뱀이 움직이는 부분입니다. 예를 들어 왼쪽 방향키를 눌렀다면, 이전 direction 'r'인 경우 반대되는 방향을 입력한 것이므로 뱀이 죽습니다. 이전 direction이 'r'이 아닐 경우 direction을 'l'로 초기화해줍니다.

그 뒤로 이전 head의 위치를 불러와 direction에 맞게 CharPosition을 만들어줍니다. 그리고 그것을 entire vector 시작 부분(첫번째 배열)에 insert를 해줍니다. 예를 들어 왼쪽 방향키를 눌러 현재의 direction이 'l'이면 entire.insert(entire.begin(), CharPosition(entire[0].x - 1, entire[0].y)); 를 수행합니다.

IsCollision 부분은 뱀의 머리가 어떤 오브젝트랑 충돌했는지 판단해주는 함수입니다. 현재 뱀이 움직이려고 하는 위치와 MapManager를 이용하여 맵 배열 값이 '0' 인 경우에는 문제가 없지만, '6', '7' 등 게이트, 아이템인 경우 충돌 판정을 내립니다.

Snake가 아이템과 충돌하여 GameScene에서 snake->Grow() 또는 snake->Shrink() 를 호출했다면, 각각 isGrow와 isShrink를 true로 설정합니다. entire vector의 첫번째에 갱신된 head의 좌표가 insertion되니 매번 꼬리를 잘라줘야합니다. 꼬리를 자르지 않을 경우는 과일을 먹어 Snake의 몸집의 커져야 할 경우입니다. 그래서 isGrow가 true인 경우 CutTail을 하지 않습니다. isShrink가 true인 경우 CutTail을 최종적으로 두 번 호출하게끔 구성했습니다. 그 이유는 게임이 진행되면서 기본적으로 잘려야 하는 꼬리 하나, 독 아이템을 먹어서 몸집이 줄어들어야 하니 잘려야 하는 꼬리 하나 때문에 두 번 호출하게끔 구성했습니다.

그 뒤로 Snake의 entire vector를 맵 데이터에 patching 해줘야하기 때문에, PushData 함수를 호출합니다. entire vector의 첫번째 요소는 Snake의 head이기 때문에 i==0 일 때 mapManager->PatchData(entire[i].y, entire[i].x, '3'); 을 실행하고, 그 외에는 mapManager->PatchData(entire[i].y, entire[i].x, '4'); 를 실행합니다.

3단계. Item 요소의 구현

모든 아이템을 관리하는 것은 ItemManager 클래스입니다. 이 클래스는 아이템을 일정 시간이 지나면 생성해줍니다. 또, 아이템이 생성된 뒤, 모든 아이템을 isExceedTime 함수로 일정 시간이 지났는지 검사합니다. 참값을 반환한다면 일정 시간이 지난 것이고 그 아이템은 vector로 생성된 data 에서 사라집니다. 아이템이 생성될 때는 PositionItem 함수를 호출합니다. 이 함수는 data vector에 Item을 생성하여 push_back 해줍니다. 아이템이 생성될 때는 x, y 좌표를 랜덤 생성하는데 아이템이 알맞은 위치에 있어야 합니다. 따라서 Item 클래스에서는 아이템이 놓여질 수 있는 부분에만 놓아지도록 생성된 x, y좌표와 MapManager의 map data배열을 비교합니다. 생성된 x,y 좌표에 '0' 이 놓여져 있으면 뱀이 움직일 수 있는 좌표이므로, 아이템이 생성되는 위치로 적절합니다. 아이템이 생성될 때 poision인지 fruit인지 구별하기 위해서 클래스 안에 string type을 넣어놨습니다. 또한 DeleteCollisionData를 통해 data vector에서 충돌한 데이터를 찾고 그것을 지워줍니다.

4단계. Gate 요소의 구현

게이트를 관리하는 것은 GateManager 클래스입니다. getRandPosition 함수로 게이트가 적절하게 위치하도록 합니다. 게이트가 스네이크의 머리와 충돌했을 때는 getNextGate 함수로 Snake의 몸이 어디로 가야할지 좌표를 알려줍니다. 부딪힌 게이트가 어떤 게이트인지 구분하기 위해서 Snake의 머리의 위치를 가져오고, 게이트의 위치를 담고있는 data vector를 검사합니다. 그래서 다음 게이트가 무엇인지 알 수 있습니다. 다음 게이트의 위치에 따라서 Snake가 나오는 위치가 달라지니 게이트가 위치한 곳을 MapManager에서 data 배열을 가져와 동서남북 검사하여 어느 쪽으로 나갈지 구분합니다. 동서남북 검사한다는 말의 의미는 snake가 나갈 수 있는 쪽을 탐색한다는 것입니다. 예를 들어 게이트의 동쪽 좌표에 '0' 이 있다면 Snake가 나갈 수 있습니다. 따라서 possibleRight=true; 로 만들어주어 if 문으로 다음 게이트 좌표에서 나갈 수 있는 좌표를 반환합니다. 게이트 위치 우선순위 판단 기준은 e-campus에 업로드하신 프로젝트 명세 pdf와 같습니다. 또한 DeleteCollisionData를 통해 data vector에서 충돌한 데이터를 찾고 그것을 지워줍니다. Snake가 통과 중에는 사라지지 않아야 하므로 꼬리의 위치가 다음 게이트의 위치의 좌표에 도달한 경우 사라지게 했습니다.

3,4 단계 통합 구현

GameScene의 Update 함수 구조는 다음과 같습니다. 먼저 미션이 완료되었는지 체크합니다. 완료됐다면 Stage 클래스의 nowStage를 한 단계 올립니다. 그리고 새로운 GameScene으로 초기화해줍니다. Player 객체에는 현재 점수를 기록하기 위해 player->SetLengthScore(snake->entire.size()); player->SetTotalScore(stage->nowStage); 를 수행합니다. Snake를 Update(키 입력을 받아 움직이게 하는 함수) 하고 snake의 head 좌표가 업데이트 되니 머리가 혹여나 어떤 것과 충돌하지 않았는지 판단합니다. snake->isCollision() 을 통해 충돌이라고 참값이 반환되면 ProcessCollision 함수를 수행합니다.

void GameScene::ProcessCollision()
{
  int y = snake->GetHead().y;
  int x = snake->GetHead().x;

  char temp = mapManager->data[y][x];

  if (temp == '1')
  {
    snake->isDied = true;
  }
  else if (temp == '5')
  {
    itemManager->DeleteCollisionData(y, x);
    player->growScore += 1;
    snake->Grow();
  }
  else if (temp == '6')
  {
    itemManager->DeleteCollisionData(y, x);
    player->poisonScore += 1;
    snake->Shrink();
  }
  else if (temp == '7')
  {
    CharPosition nextGate = gateManager->GetNextGate();
    player->gateScore += 1;
    gateManager->isUsed = true;
    snake->SetHeadPos(nextGate.y, nextGate.x);
  }
}

GameScene에서 충돌 판정 함수는 ProcessCollision 함수입니다. 이 함수에서는 Snake 머리의 현재 위치를 받아와 MapManager의 map data 배열과 비교합니다. 맵 배열 값이 '0' 인 경우에는 문제가 없지만, '6', '7' 등 게이트, 아이템인 경우 충돌 판정을 내리고 Snake를 커지게 하거나 줄어들게 하거나 다음 게이트의 위치로 보내주는 등의 작업이 이뤄져야 합니다.

ProcessCollision을 거치고 나면 Snake가 죽었는지 안 죽었는지 판단하기 위해 snake->isDied 를 체크하고 참값이라면 게임오버라고 판정합니다. 게임오버가 아니라면 Snake의 데이터를 MapManger에 Push 하기 위해 snake->pushData() 를 수행합니다. 또한 format으로 업데이트된 사용자의 점수와 시간을 표시하기 위해 format->Update(eTime); 를 수행합니다. ItemManager 클래스, GateManager 클래스 역시 게임에서 이벤트(뱀이 아이템을 먹었다던지, 게이트와 충돌했다던지)가 발생했을 수도 있으니 그것을 판정하고자 itemManager->Update(eTime); gateManager->Update(eTime); 를 수행합니다. 이 모든 것을 수행했다면 usleep(150000); 이라는 함수로 일정시간 멈춥니다. 이는 Snake의 움직임을 1.5초마다 움직이게 하기 위한 것입니다.

5단계. 점수 요소의 구현

6단계. 메인 화면 구현 및 스테이지 번호 구현

2.2.3 활용/개발된 기술 6

이 프로젝트에서 사용한 라이브러리로는 ncurses와 vector가 있습니다. 가변적인 Snake의 길이, 데이터가 앞에서 삽입되는 것의 자료구조로서 vector가 어울린다고 생각했습니다. 프로젝트 구조를 짜는 데 있어서 예전에 DirectX를 이용한 게임을 만들어 본 적이 있어 예전의 코드를 가져왔습니다. Scene 을 만들어 nowScene에 새로운 Scene을 할당하는 구조는 이번 Snake Game에 적합하다고 생각했습니다.

Game을 Update하고 Rendering 하는 데에 ncurses를 사용하였고, mvaddch, printw 등을 이용하여 cli 환경에서 게임에서 오브젝트의 결과를 출력해보았습니다. 또한 ncurses의 usleep 함수를 이용해 게임 속도를 조절했으며, 1.5초마다 움직이게끔 구성했습니다.

새롭게 고안한 알고리즘은 게이트 출입 시, 어느 좌표로 Snake를 보내줘야 하는지 판단하는 알고리즘입니다. 게이트가 Snake의 머리와 충돌했을 때는 getNextGate 함수로 Snake의 몸이 어디로 가야할지 좌표를 알려줍니다. 부딪힌 게이트가 어떤 게이트인지 구분하기 위해서 Snake의 머리의 위치를 가져오고, 게이트의 위치를 담고있는 data vector를 검사합니다. 그래서 다음 게이트가 무엇인지 알 수 있습니다. 다음 게이트의 위치에 따라서 Snake가 나오는 위치가 달라지니 게이트가 위치한 곳을 MapManager에서 data 배열을 가져와 동서남북 검사하여 어느 쪽으로 나갈지 구분합니다. 동서남북 검사한다는 말의 의미는 snake가 나갈 수 있는 쪽을 탐색한다는 것입니다. 예를 들어 게이트의 동쪽 좌표에 '0' 이 있다면 Snake가 나갈 수 있습니다. 따라서 possibleRight=true; 로 만들어주어 if 문으로 다음 게이트 좌표에서 나갈 수 있는 좌표를 반환합니다.

2.2.4 현실적 제한 요소 및 그 해결 방안 6

3단계에서 Item을 어떻게 구분하고 vector에 넣을 수 있는지 고민을 많이 해봤습니다. 초기 version에도 ItemManager라는 것이 있었지만, 그것은 지금처럼 Item vector로 관리한 것이 아니었습니다. 아이템을 나누어 Fruit, Poision 클래스를 만들었고 각각 vector를 만들어주었습니다. 이렇게 하니 통합성이라는 측면에서 굉장히 비효율적이었습니다. 그래서 생각한 것이 Item이라는 클래스를 하나 만들어 통합 관리를 하고 Item 클래스에 있는 string type을 이용하여 아이템을 구분지어주기로 했습니다. 그 뒤로 ItemManager에서 통합 관리하여 기능을 개발할 때 불필요한 코드를 줄일 수 있었습니다.

3단계에서는 Snake가 item을 먹었을 경우 Snake의 Body를 어떻게 줄이고 늘리는지에 대한 어려움이 있었습니다. 이는 MapManager의 data vector에서 Snake의 꼬리 부분을 ‘0’으로 바꿔주고, Snake에서는 entire.pop_back()을 이용하여 해결하였습니다. Snake가 아이템과 충돌하여 GameScene에서 snake->Grow() 또는 snake->Shrink() 를 호출했다면, 각각 isGrow와 isShrink를 true로 설정합니다. entire vector의 첫번째에 갱신된 head의 좌표가 insertion되니 매번 꼬리를 잘라줘야합니다. 꼬리를 자르지 않을 경우는 과일을 먹어 Snake의 몸집의 커져야 할 경우입니다. 그래서 isGrow가 true인 경우 CutTail을 하지 않습니다. isShrink가 true인 경우 CutTail을 최종적으로 두 번 호출하게끔 구성했습니다. 그 이유는 게임이 진행되면서 기본적으로 잘려야 하는 꼬리 하나, 독 아이템을 먹어서 몸집이 줄어들어야 하니 잘려야 하는 꼬리 하나 때문에 두 번 호출하게끔 구성했습니다.

4단계에서는 Gate가 생성되는 방식에서 개선점을 찾았습니다. Gate는 Wall에서만 생성되어야만 합니다. Gate의 생성 방식은 랜덤으로 뽑은 좌표가 '1'(벽)일 경우 Gate가 생성 가능하다고 판단했습니다. 따라서 몇 백번의 랜덤 좌표 연산이 이루어질 수 있습니다. Gate를 생성하는 좌표를 찾는데 시간이 오래 걸릴 수 밖에 없어 Gate를 생성할 때 Wall의 좌표를 따로 모으기 위해 WallManager를 만들까 고민했습니다. 이 설계는 WallManager의 데이터 vector에 wall 좌표 데이터들을 추가하여, data의 size 내에서 무작위 숫자를 뽑아 무작위 숫자에 해당하는 데이터의 요소를 불러오는 설계입니다. 그렇게 진행한다면 gate generation 때, 많은 연산을 진행하지 않아도 된다 생각합니다. 다만 아직까지 눈에 띠는 게임 렉 현상은 없어 지금과 같은 구조를 유지하고 있습니다. 추후 feature 브런치로 작업할 예정입니다.

2.2.5 결과물 목록 7

프로젝트 tree 하나 복사해서 설명 ㄱㄱ

3. 자기평가

박건후

역할

Project Manager를 담당했으며, 협업을 위한 git flow 방식을 적용했습니다. git flow 방식과 github template을 이용하여 Pull Request 를 하는 방법을 팀원에게 알려주었습니다. 저희의 협업방식은 feature/기능 이란 브런치를 만들어 commit을 원격 브런치로 푸시하고, Pull Request를 했습니다. Pull Request를 할 때, 자신이 작업한 브런치에서는 어떤 점이 개선되었고, 버그가 있다면 어떤 버그가 있는지 간략하게 요약해 첨부하였습니다. 또한 그 브런치를 develop 브런치에 merge 하기 전 모두의 동의가 필요하다고 생각해서 모든 이가 코드리뷰를 하고 별다른 의견이 없다면 merge 하는 방식으로 했습니다. 그래서 이번 프로젝트의 제 역할은 이러한 소통의 규격을 만들었고, 프로젝트의 구조를 담당했습니다. Scene을 바꾼다는 개념을 코드화해보았고, 이를 응용한 ItemManager, GateManager 클래스 작성과 snake의 충돌판정을 통해 snake의 변화가 제대로 적용될 수 있도록 클래스를 세분화하고 구현해보았습니다.

프로젝트 수행 시 어려운 점

ncurses 라이브러리를 사용해본 것은 처음이었습니다. 익숙하지 않은 라이브러리에 타 라이브러리에 비해 영어 문서가 많아 해석하는데 애를 먹기도 했습니다. 또한 리눅스라는 환경에서 make 유틸리티를 이용한 컴파일은 처음이었고, gdb로 디버깅해본 경험도 처음이어서 개발하는데 있어 진전속도가 빠르지 않았습니다. 이번 프로젝트는 구조에 신경을 굉장히 많이 썼습니다. 게임을 Scene이라는 개념을 이용하여 구현해보겠다는 일념 하에 일관성 있는 추상적 접근을 해봤습니다. 또한 그렇게 하나의 개념으로 구체화 하다보니 자연스레 팀원이 프로젝트 구조를 이해하는데 많은 도움이 된 것 같습니다.

프로젝트 운영에 개선이 필요하다고 생각하는 점

역시나 변수명이나 함수명을 짓기 어렵습니다. 어쩌다보니 Snake 클래스의 데이터 vector의 이름을 다른 클래스와 달리 통합하지 않았습니다. 다른 클래스에서는 데이터를 저장하는 vector이름을 data라고 지었지만, Snake 클래스에서는 entire 이라고 지었습니다. 그 이유는 github에서 다른 사람의 코드를 참고하다가 몇 가지 부분을 긁었는데 프로젝트 규모가 엄청 커질지는 몰랐어서 entire라고 지어진 부분을 냅뒀습니다. Snake 클래스가 여러 파일에서 쓰이다보니 변수명을 한번 수정하려면 여러가지 파일을 손봐야했습니다. 그것이 엄두가 안나 아직까지 변수명을 고치지 못하고 있습니다. 다음에 이렇게 규격화하고 협업에 쓰일 프로젝트는 변수명을 짓는 데 있어서 고민을 많이 해보고 설계해야겠습니다.

팀원 평가

팀원이 훌륭하게 잘 따라왔습니다. 제 코드를 팀원이 볼 때 이해하지 못할 것 같다는 생각도 했는데, 제가 설명하는 구조를 잘 이해해주었고 그 구조에 맞게 코딩을 잘했습니다. 특히 팀원이 제가 만든 IObject 클래스를 이용해 Format 클래스를 짠 것을 보면 정말 기특하다는 생각을 많이합니다. 이번 프로젝트 덕분에 협업이란 무엇인가라는 것을 제대로 배웠고, git flow 방식은 앞으로 다른 프로젝트에서도 사용할 예정입니다. 재밌었습니다.

4. 참고 문헌

https://github.com/parkgeonhu/Where-is-Tipy // 프로젝트 구조를 짤 때, 전에 direct X로 게임 만들던 구조가 생각나 그것을 베이스로 구조를 짰습니다.

https://widian.tistory.com/58 //ncurses 라이브러리를 사용할 때 모르는 함수가 있으면 여기에서 예시를 확인하고 작업했습니다.

https://www.cplusplus.com/ // c++ 코딩할 때 모르는 stl 라이브러리가 있으면 검색해보았습니다. 특히 vector를 활용할 때 좋았습니다.

https://doitnow-man.tistory.com/98 // 세그먼테이션 오류가 날 때 gdb 디버깅 검색

5. 부록

5.1 사용자 매뉴얼 8

5.2 설치 방법 8

https://github.com/parkgeonhu/Where-is-Tipy 로 이동하여 clone합니다.

프로젝트 최상단에서 make 명령어를 실행하면

all:
    g++ src/GameScene.cpp src/GameOverScene.cpp src/Snake.cpp src/Stage.cpp src/myFunction.cpp src/ItemManager.cpp src/WaitingScene.cpp src/Item.cpp src/main.cpp -lncurses -o /tmp/a.out && /tmp/a.out

이런 형식으로 실행됩니다.

parkgeonhu commented 4 years ago

어우 죽겠다 ^^

bamin0422 commented 4 years ago

master branch에 word파일이랑 pdf파일로 업로드 해놓았어요 ㅎ 수정사항 있으면 feedback 달아주세요.