README.md - Examples

  1# Snake Game Examples
  2
  3터미널 기반 뱀 게임 프로젝트 예제 파일들입니다.
  4
  5## 파일 구성
  6
  7### 1. `ansi_demo.c`
  8ANSI escape codes 시연 프로그램
  9- 커서 이동, 색상, 박스 그리기 등을 보여줍니다.
 10
 11**컴파일 및 실행:**
 12```bash
 13gcc -o ansi_demo ansi_demo.c
 14./ansi_demo
 15```
 16
 17### 2. `input_demo.c`
 18비동기 키보드 입력 시연 프로그램
 19- termios를 사용한 non-blocking 입력 처리
 20- 방향키와 WASD 키 지원
 21
 22**컴파일 및 실행:**
 23```bash
 24gcc -o input_demo input_demo.c
 25./input_demo
 26```
 27
 28**조작법:**
 29- 방향키 또는 WASD: 이동
 30- 스페이스: 점프
 31- Q: 종료
 32
 33### 3. `snake_types.h`
 34뱀 게임 데이터 구조 정의
 35- 게임에 필요한 모든 타입과 상수 정의
 36- 다른 파일에서 include하여 사용
 37
 38### 4. `snake.c`
 39뱀 게임 핵심 로직 구현
 40- 뱀 생성/해제, 이동, 충돌 검사 등
 41- `snake_types.h`를 사용하는 모듈형 구현
 42
 43**컴파일 (단독 실행 불가):**
 44```bash
 45# 다른 파일과 함께 링크해야 함
 46gcc -c snake.c -o snake.o
 47```
 48
 49### 5. `snake_game.c`
 50완성된 뱀 게임 (ANSI escape codes 사용)
 51- 독립적으로 동작하는 완전한 게임
 52- 외부 라이브러리 필요 없음
 53
 54**컴파일 및 실행:**
 55```bash
 56gcc -o snake_game snake_game.c
 57./snake_game
 58```
 59
 60**조작법:**
 61- 방향키 또는 WASD: 뱀 이동
 62- P: 일시정지
 63- Q: 종료
 64- R: 재시작 (게임 오버 후)
 65
 66**기능:**
 67- 점수 시스템
 68- 속도 증가 (음식 먹을수록 빨라짐)
 69- 최고 점수 저장 (`.snake_highscore` 파일)
 70- 일시정지
 71- 색상 표시
 72
 73### 6. `snake_ncurses.c`
 74NCurses 라이브러리를 사용한 향상된 버전
 75
 76**⚠️ 이 파일은 ncurses 라이브러리가 필요합니다!**
 77
 78**라이브러리 설치:**
 79```bash
 80# macOS
 81brew install ncurses
 82
 83# Ubuntu/Debian
 84sudo apt install libncurses5-dev
 85
 86# Fedora/RHEL
 87sudo dnf install ncurses-devel
 88```
 89
 90**컴파일 및 실행:**
 91```bash
 92# macOS
 93gcc -o snake_ncurses snake_ncurses.c -lncurses
 94
 95# Linux
 96gcc -o snake_ncurses snake_ncurses.c -lncurses
 97
 98# 실행
 99./snake_ncurses
100```
101
102**조작법:**
103- 방향키 또는 WASD: 뱀 이동
104- P: 일시정지
105- Q: 종료
106- R: 재시작 (게임 오버 후)
107
108**ncurses 버전의 장점:**
109- 더 깔끔한 화면 처리
110- 자동 버퍼링 및 깜빡임 방지
111- 표준 박스 문자 사용
112- 더 나은 색상 관리
113
114## 학습 순서
115
1161. **`ansi_demo.c`** - ANSI escape codes 이해
1172. **`input_demo.c`** - 비동기 입력 처리 이해
1183. **`snake_types.h`** - 게임 데이터 구조 파악
1194. **`snake.c`** - 게임 로직 구현 학습
1205. **`snake_game.c`** - 완성된 게임 분석
1216. **`snake_ncurses.c`** - ncurses 라이브러리 활용 (선택)
122
123## 개발 환경
124
125- C11 표준
126- POSIX 호환 시스템 (Linux, macOS, BSD)
127- 터미널: UTF-8 지원 필요
128- 컴파일러: GCC 또는 Clang
129
130## 참고 자료
131
132이 예제는 다음 학습 자료를 기반으로 합니다:
133- `/content/ko/C_Programming/11_Project_Snake_Game.md`
134
135## 문제 해결
136
137### 문제: 박스 문자가 깨져 보임
138**해결:** 터미널이 UTF-8을 지원하는지 확인
139```bash
140echo $LANG
141# 출력 예: en_US.UTF-8 또는 ko_KR.UTF-8
142```
143
144### 문제: 키 입력이 작동하지 않음
145**해결:** 터미널이 ANSI escape sequences를 지원하는지 확인
146
147### 문제: ncurses 링크 오류
148**해결:** ncurses 개발 패키지 설치 확인
149```bash
150# macOS
151brew list ncurses
152
153# Ubuntu
154dpkg -l | grep libncurses
155```
156
157## 라이선스
158
159교육 목적으로 자유롭게 사용 가능합니다.