테트리스 ver 0.1 (8) - 소스코드 구현 (TetrisView)

[TetrisView 클래스의 Class Diagram]

이제는, 테트리스의 UI 를 담당하는 클래스인 TetrisView 에 대해서 말씀드릴 차례입니다. TetrisView.h 와 TetrisView.c 를 분석해 보겠습니다.

[TetrisView.h]

#ifndef _TETRIS_VIEW_H
#define _TETRIS_VIEW_H

#include "TetrisManager.h"

typedef struct _tetrisView{
	TetrisManager tetrisManager;
}TetrisView;

void TetrisView_StartGame(TetrisView* tetrisView);
void TetrisView_ProcessGame(TetrisView* tetrisView, int processType, int direction);
void TetrisView_EndGame(TetrisView* tetrisView);

#endif

1 ~ 2, 14 라인

이 헤더파일을 include 하는 곳들에서 중복 포함 하지 않게 하기 위한 guard 입니다.

6 ~ 8 라인

TetrisView 구조체의 정의부입니다. 멤버로는 tetrisManager 를 가지고 있습니다.

10 ~ 12 라인

TetrisView.c 에서 정의될 함수들의 선언부입니다.

[TetrisView.c]

#include <stdio.h>
#include <windows.h>
#include <mmsystem.h>
#include "TetrisView.h"
#include "TetrisManager.h"
#include "Constant.h"

#pragma comment(lib, "winmm.lib")

#define TETRIS_BACKGROUND_MUSIC_FILE_NAME "..\\res\\tetris_background_music.wav"

void TetrisView_StartGame(TetrisView* tetrisView){
	int speedLevel;
	PlaySound(TEXT(TETRIS_BACKGROUND_MUSIC_FILE_NAME), NULL, SND_ASYNC | SND_LOOP);
	printf("***** Tetris *****\nSpeed level (1 ~ 10) : ");
	scanf_s("%d", &speedLevel);
	if (speedLevel > MAX_SPEED_LEVEL || speedLevel < MIN_SPEED_LEVEL){
		speedLevel = MIN_SPEED_LEVEL;
	}
	TetrisManager_Init(&tetrisView->tetrisManager, speedLevel);
	TetrisManager_Print(&tetrisView->tetrisManager);
}

void TetrisView_ProcessGame(TetrisView* tetrisView, int processType, int direction){
	if (processType == DIRECTION){
		TetrisManager_ChangeBoardByDirection(&tetrisView->tetrisManager, direction);
	}
	else if (processType == DIRECT_DOWN){
		TetrisManager_ProcessDirectDown(&tetrisView->tetrisManager);
	}
	else if (processType == AUTO){
		TetrisManager_ChangeBoardByAuto(&tetrisView->tetrisManager);
	}
	if (TetrisManager_IsReachedToBottom(&tetrisView->tetrisManager)){
		//if you are going to move the block which has bottom wall or bottom fixed block, permit the block to move the direction
		if (processType == DIRECTION && direction == LEFT && (TetrisManager_CheckValidPosition(&tetrisView->tetrisManager, LEFT) == EMPTY) || 
			processType == DIRECTION && direction == RIGHT && (TetrisManager_CheckValidPosition(&tetrisView->tetrisManager, RIGHT) == EMPTY)){
			TetrisManager_ChangeBoardByDirection(&tetrisView->tetrisManager, direction);
		}
		if (TetrisManager_ProcessReachedCase(&tetrisView->tetrisManager) == END){
			TetrisView_EndGame(tetrisView);
		}
	}
	TetrisManager_ProcessDeletingLines(&tetrisView->tetrisManager);
	TetrisManager_Print(&tetrisView->tetrisManager);
	if (processType == AUTO){
		TetrisManager_Sleep(&tetrisView->tetrisManager);
	}
}

void TetrisView_EndGame(TetrisView* tetrisView){
	PlaySound(NULL, 0, 0);
	system("cls");
	printf("***** End *****\n%d level / %d lines deleted\n",
		tetrisView->tetrisManager.speedLevel,
		tetrisView->tetrisManager.deletedLineCount);
	system("pause");
	exit(-1);
}

1 ~ 6 라인

현재 소스 파일에서 필요한 헤더파일들을 include 합니다.

8 라인

소리 및 음악 재생을 위해서 winmm.lib 라이브러리를 로드합니다.

10 라인

테트리스 배경 음악 파일명을 상수화 합니다. (상대 경로 포함)

12 라인

TetrisView_StartGame 함수의 정의부입니다. 매개변수로 tetrisView 를 받아서, 테트리스 게임을 시작하기 위한 설정을 하고, 시작을 하는 역할을 합니다.

14 라인

PlaySound 함수를 호출하여 테트리스 배경음악을 재생합니다.

(소리 및 음악 재생하기 - WinApi 참고)

http://kkikkodev.tistory.com/54

16 ~ 19 라인

사용자로부터 원하는 시작 speedLevel 을 입력받은 뒤, 그 speedLevel 이 유효하지 않으면 (MAX_SPEED_LEVEL (= 10) 보다 크거나, MIIN_SPEED_LEVEL (= 1) 보다 작은 경우) speedLevel 에 임의로 MIN_SPEED_LEVEL 로 설정합니다.

20 라인

TetrisManager_Init 함수를 호출하여, tetrisView->tetrisManager 변수를 초기화합니다. 

21 라인

TetrisManager_Print 함수를 호출하여 테트리스 판, 블럭, 게임 상태 등을 화면에 출력합니다.

24 라인

TetrisView_ProcessGame 함수의 정의부입니다. 매개변수로, tetrisView 와 processType (사용자가 방향키를 눌렀는지, 스페이스바를 눌렀는지, 자동으로 내려오는지를 구분하는 변수), direction (방향) 을 전달받아서, 실제 테트리스 게임을 진행합니다.

25 ~ 33 라인

크게, processType 을 확인하여, DIRECTION (방향키를 누른 경우), DIRECT_DOWN (스페이스바를 누른 경우), AUTO (자동으로 내려오는 경우) 의 3 가지 경우로 구분하여 게임을 진행합니다. 먼저, processType 이 DIRECTION 인 경우는, TetrisManager_ChangeBoardByDirection 함수를 호출하여, 블럭의 방향을 업데이트 해 준뒤, 화면을 갱신합니다. 두 번째로, processType 이 DIRECT_DOWN 인 경우에는, TetrisManager_ProcessDirectDown 함수를 호출하여 현재 블럭이 내려갈 수 있을 때까지 내리고, 화면을 갱신합니다. 마지막으로, processType 이 AUTO 인 경우는, TetrisManager_ChangeBoardByAuto 함수를 호출하여 한 칸 밑으로 블럭을 내린 뒤 화면을 갱신합니다. 

34 ~ 43 라인

TetrisManager_IsReachedToBottom 함수를 호출하여 현재 블럭이 바닥에 닿았는지를 체크합니다. (바닥은, 아래 벽 말고도, 굳어진 블럭도 포함합니다.) 만약 바닥에 닿았으면, 먼저, 사용자가 좌우키를 눌렀는지 확인하여, 그 방향이 비었는지 확인합니다. (즉. 블럭이 바닥에 닿기는 했찌만, 좌우로 한번더 이동 가능한 경우를 말합니다.) 이것은, 사용자가 LEFT 방향을 원했을 때, 블럭의 왼쪽이 빈 경우와 사용자가 RIGHT 방향을 원했을 때, 블럭의 오른쪽이 빈 경우를 말합니다. 왼쪽이나 오른쪽이 비었는지는 TetrisManager_CheckValidPosition 함수를 호출하여 체크합니다. 만약 이 두 가지 경우중 하나에 해당된다면, TetrisManager_ChanageBoardByDirection 함수를 호출하여 사용자가 원하는 방향으로 블럭을 이동하게 합니다. 

그리고 나서, TetrisManager_ProcessReachedCase 함수를 호출하여 현재 블럭이 바닥에 닿은 경우의 처리를 합니다. 추가적으로, 이 함수의 반환값을 확인하여 END 인 경우에 TetrisView_EndGame 을 호출하여 테트리스 게임을 종료합니다.

44 라인

TetrisManageR_ProcessDeletingLines 함수를 호출하여 굳어진 블럭들이 한 줄을 이뤘을 경우를 처리합니다.

45 라인

TetrisManager_Print 함수를 호출하여 게임 화면을 갱신합니다.

46 ~ 48 라인

processType 이 AUTO 인 경우에는, TetrisManager_Sleep 함수를 호출하여 speedLevel 에 기반한 일정 시간동안 게임을 지연시킵니다.

51 라인

TetrisView_EndGame 함수의 정의부입니다. 매개변수로 tetrisView 를 받아서, 테트리스 게임을 종료합니다.

52 라인

PlaySound 함수를 호출하여 테트리스 배경 음악 재생을 정지합니다.

53 라인

system("cls") 함수를 호출하여 화면을 지웁니다.

(콘솔 화면 지우기 참고)

http://kkikkodev.tistory.com/64

54 ~ 56 라인

게임의 현재 속도 레벨과 총 지운 라인의 개수를 출력합니다.

57 라인

system("pause") 함수를 호출하여 콘솔이 바로 닫히지 않도록 프로그램을 일시정지합니다. (사용자가 키 입력을 해야 다음을 실행합니다.)

58 라인

exit(-1) 함수를 호출하여 프로그램을 종료합니다.

(프로그램 강제로 종료시키기 참고)

http://kkikkodev.tistory.com/65