⌨️: 2025년 2월 10일 → 2025년 2월 11일

✏️ : 2025년 2월 11일

Pygame

• Python으로 2D 게임을 만들 수 있게 도와주는 라이브러리
• 이벤트 기반 프로그래밍 사용
• 도형, 이미지, 그래픽, 사운드, 충돌 처리 등의 기능 제공

🕹️ Pygame 주요 기능 정리

1️⃣ 화면 생성

screen = pygame.display.set_mode((가로, 세로))

• 게임 창을 생성하는 함수

2️⃣ 이벤트 처리

for event in pygame.event.get():
    if event.type == pygame.QUIT:
        running = False

• 사용자가 창을 닫는 등의 이벤트를 감지하고 반응

3️⃣ 색상 정의

WHITE = (255, 255, 255)  # RGB 값

• 색상은 (R, G, B) 튜플로 표현

4️⃣ 화면 채우기

screen.fill(WHITE)

• 배경 색을 설정하는 코드

5️⃣ 화면 업데이트

pygame.display.update()

• 화면을 새로고침해서 변경 사항을 반영

---

🔹 추가 기능

🏃‍♂️ 키보드 입력 받기

for event in pygame.event.get():
    if event.type == pygame.KEYDOWN:  # 키를 눌렀을 때
        if event.key == pygame.K_LEFT:
            print("왼쪽 화살표 키 눌림")

• KEYDOWN → 키가 눌렸을 때
• KEYUP → 키에서 손을 뗄 때

🖱️ 마우스 입력 받기

for event in pygame.event.get():
    if event.type == pygame.MOUSEBUTTONDOWN:
        print("마우스 클릭됨!", event.pos)  # 클릭 위치 출력

🎨 도형 그리기

pygame.draw.rect(screen, (255, 0, 0), (50, 50, 100, 100))  # 빨간색 사각형
pygame.draw.circle(screen, (0, 0, 255), (250, 200), 50)  # 파란색 원

• draw.rect(화면, 색상, (x, y, 너비, 높이))
• draw.circle(화면, 색상, (x, y), 반지름)

🎭 이미지 불러오기

image = pygame.image.load("character.png")
screen.blit(image, (100, 100))  # (100, 100) 위치에 이미지 출력

🔊 사운드 재생

sound = pygame.mixer.Sound("jump.wav")
sound.play()  # 사운드 재생

---

📚 Pygame Library

🔹 주요 이벤트 타입 상수들

pygame.event 모듈에서는 여러 가지 이벤트 타입 상수가 정의되어 있습니다. 이 상수들을 사용해서 이벤트를 처리할 수 있습니다.

1. pygame.QUIT

   • 윈도우 닫기 이벤트. 사용자가 게임 창의 "X" 버튼을 눌렀을 때 발생.

   
   if event.type == pygame.QUIT:
       running = False
   

2. pygame.KEYDOWN / pygame.KEYUP

   • 키보드 키가 눌렸을 때(KEYDOWN)와 떼었을 때(KEYUP) 발생하는 이벤트.

   
   if event.type == pygame.KEYDOWN:
       if event.key == pygame.K_LEFT:
           print("왼쪽 화살표 키 눌림")
   

3. pygame.MOUSEBUTTONDOWN / pygame.MOUSEBUTTONUP

   • 마우스 버튼이 눌렸을 때(MOUSEBUTTONDOWN)와 떼었을 때(MOUSEBUTTONUP) 발생하는 이벤트.

   
   if event.type == pygame.MOUSEBUTTONDOWN:
       print("마우스 버튼 클릭됨", event.pos)  # 클릭된 위치
   

4. pygame.MOUSEMOTION

   • 마우스가 움직일 때 발생하는 이벤트.

   
   if event.type == pygame.MOUSEMOTION:
       print("마우스 위치:", event.pos)
   

5. pygame.ACTIVEEVENT

   • 윈도우가 활성화되었을 때 또는 비활성화될 때 발생하는 이벤트.

   
   if event.type == pygame.ACTIVEEVENT:
       if event.state == pygame.APPINPUTFOCUS:
           print("앱 활성화됨")
       elif event.state == pygame.APPINPUTFOCUSLOSS:
           print("앱 비활성화됨")
   

6. pygame.VIDEORESIZE

   • 윈도우 크기 조절 이벤트.

   
   if event.type == pygame.VIDEORESIZE:
       screen = pygame.display.set_mode(event.size, pygame.RESIZABLE)
   

7. pygame.USEREVENT

   • 사용자 정의 이벤트로, pygame.event.post()를 사용하여 큐에 추가할 수 있습니다.

   
   pygame.event.post(pygame.event.Event(pygame.USEREVENT, {"data": "example"}))
   

---

⌨️게임 구현하기

1. 🌉 초기화부터 배경 설정까지

- 라이브러리 호출 , 게임 색상 정의: RGB Tuple

import pygame
import sys
from pygame.locals import * #pygame 라이브러리 안 모든 지역 변수 호출

BLACK  = (0, 0, 0)
WHITE = (255, 255, 255)
RED = (255, 0, 0)

- 게임 시작, 파이게임 초기화: init()

pygame.init()

- FPS 설정: pygame.time.Clock().tick(숫자)

clock = pygame.time.Clock()
clock.tick(60)

• tick()을 사용하지 않으면 CPU 사용량이 과도하게 증가할 수 있습니다!

- 제목 표시줄 설정: pygame.display.set_caption("제목표시줄명")

pygame.display.set_caption("Crazy Driver")

• display 라이브러리: 화면 표시 관리

- 게임 화면 초기화: pygame.display.set_mode(( , ))

screen = pygame.display.set_mode((500,800))

- 화면 출력: screen.fill(WHITE)

screen.fill(WHITE)

- 화면 업데이트: pygame.display.update()

pygame.display.update()

- 메인 게임 루프: While True 활용

#메인 게임 루프
while True:
    #배경 두기
    screen.blit(IMG_ROAD,(0,0))
    
    #플레이어 화면에 두기
    screen.blit(player.image, player.rect)
    
    #적 화면에 두기
    screen.blit(enemy.image, enemy.rect)
    #이벤트 확인하기
    for event in pygame.event.get():
        #플레이어가 게임을 그만두는지?
        if event.type == QUIT:#pygame.QUIT
            #게임 끝내기
            pygame.quit()
            sys.exit()
    #화면 업데이트하기
    pygame.display.update()

- 게임 경로 설정, 이미지 불러오기: os.path.dirname(**file**)활용

import os
GAME_ROOT_FOLDER = os.path.dirname(__file__) #게임루트
IMAGE_FOLDER = os.path.join(GAME_ROOT_FOLDER,"Images") 
#게임루트에 Images 추가해서 이미지 루트 저장

• 게임루트에 Images join해서 이미지 루트 저장

- 이미지 불러오기: pygame.image.load(이미지명)

IMG_ROAD = pygame.image.load(os.path.join(IMAGE_FOLDER,"Road.png")

• 이미지 루트에 png명 join해서 이미지 파일 내 해당 이미지 호출

- 복사할 이미지와 복사할 곳 x,y좌표 받기: blit(복사할곳이름,(x,y))

screen.blit(IMG_ROAD, (0,0))

2. 🚗 자동차 표시하기

**Sprite

• 큰 이미지 위에 놓인 2차원 이미지 객체입니다.
• 게임 화면에서 움직임 등을 표현할 때 사용합니다.

- 플레이어 초기 위치 계산하기

h = IMG_ROAD.get_width()//2
v = IMG_ROAD.get_height() - (IMG_PLAYER.get_height()//2)

아래쪽 가운데에 플레이어 자동차를 배치합니다.

• 가로 위치는 가로 도로 길이의 절반
• 도로 높이를 세로 위치로 사용하면 화면의 가장 아래에 중심이 오므로 자동차의 절반만 표시됩니다.
• 따라서 세로 위치는 (도로 높이 - 플레이어 자동차 높이의 절반) 으로 설정해야 합니다.

- 플레이어 스프라이트 만들기

player = pygame.sprite.Sprite()
player.image = IMG_PLAYER
player.surf = pygame.Surface(IMG_PLAYER.get_size())
player.rect = player.surf.get_rect(center = (h,v)) 
#스프라이트를 담을 직사각형 정의

- 적 스프라이트 만들기

# 적
# 적 초기 위치 계산하기
hl = IMG_ENEMY.get_width()//2 #가장왼쪽
hr = IMG_ROAD.get_width() - (IMG_ENEMY.get_width()//2) #가장오른쪽
h = random.randrange(hl, hr) #랜덤
v = 0 #세로
# enemy 스프라이트 만들기
enemy = pygame.sprite.Sprite()
enemy.image = IMG_ENEMY
enemy.surf = pygame.Surface(IMG_ENEMY.get_size())
enemy.rect = enemy.surf.get_rect(center = (h, v))

• hl = IMG_ENEMY.get_width()//2 #가장왼쪽 hr = IMG_ROAD.get_width() - (IMG_ENEMY.get_width()//2) #가장오른쪽 h = random.randrange(hl, hr) #랜덤

cf. Surface() vs get_rect()

속성	설명	용도	주요 특징
surf	Surface 객체로, 게임 객체의 이미지나 도형을 담고 있습니다.	스프라이트의 비주얼을 정의하고 화면에 그립니다.	- 실제 게임 화면에 그려질 이미지나 도형을 담고 있음.
			- surf는 스프라이트의 내용을 담당.
rect	사각형 영역을 나타내는 pygame.Rect 객체로, 위치와 크기를 관리합니다.	스프라이트의 위치와 크기를 관리하고 충돌을 처리합니다.	- 스프라이트의 위치와 크기를 정의.
			- 충돌 감지나 스프라이트 배치를 위해 사용됨

- 메인 게임 루프 수정: screen.blit(player.image, player.rect)

#메인 게임 루프
while True:
    #배경 두기
    screen.blit(IMG_ROAD,(0,0))
    
    #플레이어 화면에 두기
    screen.blit(player.image, player.rect)
    
    #적 화면에 두기
    screen.blit(enemy.image, enemy.rect)
    #이벤트 확인하기
    for event in pygame.event.get():
        #플레이어가 게임을 그만두는지?
        if event.type == QUIT:#pygame.QUIT
            #게임 끝내기
            pygame.quit()
            sys.exit()
    #화면 업데이트하기
    pygame.display.update()

3. 🚘 적 움직이기

- 스피드 초기화

#게임 변수 초기화
moveSpeed =  5

- 적을 아래쪽으로 움직이기

#적 화면에 두기
    screen.blit(enemy.image, enemy.rect)
    
    #적을 아래쪽으로 움직이기
    enemy.rect.move_ip(0, moveSpeed)
    
    #화면 밖으로 나갔는지 체크, 나갔으면 위쪽 랜덤으로 되돌림
    if (enemy.rect.bottom) > IMG_ROAD.get_height():
        hl = IMG_ENEMY.get_width()//2
        hr = IMG_ROAD.get_width() - (IMG_ENEMY.get_width()//2)
        h = random.randrange(hl, hr)
        v = 0
        
        #화면에 두기
        enemy.rect.center = (h,v)
    

4. 🚖 플레이어 움직이기

- 키보드 제어: keys[K_LEFT] keys[K_RIGHT]

#플레이어 화면에 두기
    screen.blit(player.image, player.rect)
    #키보드를 눌렀을 때
    keys = pygame.key.get_pressed()
    if keys[K_LEFT] and player.rect.left > 0:
        player.rect.move_ip(-moveSpeed, 0)
        if player.rect.left < 0:
            player.rect.left = 0
    if keys[K_RIGHT] and player.rect.right < IMG_ROAD.get_width():
        player.rect.move_ip(moveSpeed,0)
        if player.rect.right > IMG_ROAD.get_width():
            player.rect.right = IMG_ROAD.get_width()

• cf. ip는 in place의 약자입니다.

5. ⏩ 점점 어렵게 만들기

- 조건문 활용해서 속도 높이기

moveSpeed = 5
maxSpeed = 12
#속도 업데이트
        if score % 3 == 0 and moveSpeed <= maxSpeed:
             moveSpeed += 0.5

• 지나간 자동차(적)의 수를 score라고 할 때, 자동차(적) 3개 지나갈 때 속도가 0.5씩 빨라집니다.

6. ✋🏻 게임 오버

- 게임 오버 함수 생성

#폰트 설정
textFonts = ['minecraftia']
textSize = 48

#게임오버 함수
def GameOver():
    # 게임 끝내기 문자열 만들기
    fontGameOver = pygame.font.SysFont(textFonts, textSize)
    textGameOver = fontGameOver.render("Game Over!", True, RED)
    rectGameOver = textGameOver.get_rect()
    rectGameOver.center = (IMG_ROAD.get_width()//2,
                           IMG_ROAD.get_height()//2)
    # 검은색 배경에 게임 오버 메시지 출력하기
    screen.fill(BLACK)
    screen.blit(textGameOver, rectGameOver)
    # 출력 업데이트하기
    pygame.display.update()
    # 객체 없애기
    player.kill()
    enemy.kill()
    # 일시 정지하기
    time.sleep(2)
    # 게임 끝내기 
    pygame.quit()
    sys.exit()

- 자동차 충돌 시 게임 오버

#충돌 확인하기
    if pygame.sprite.collide_rect(player,enemy):
        GameOver()

---

⌨️프로그래밍에 사용한 라이브러리, 함수

1. pygame.init()

• 설명: Pygame의 모든 모듈을 초기화하는 함수입니다.
• 역할: 게임을 실행하기 전에 반드시 호출해야 하며, Pygame의 기능을 사용할 수 있도록 설정합니다.

2. pygame.time.Clock()

• 설명: 게임의 프레임 속도를 관리하는 객체를 생성합니다.
• 역할: clock.tick(60)을 사용하여 초당 60프레임으로 제한하는 등의 기능을 수행합니다.

3. pygame.display.set_caption("Crazy Driver")

• 설명: 게임 창의 제목을 설정합니다.
• 역할: 사용자가 실행한 게임 창의 상단 바에 "Crazy Driver"라는 이름이 표시됩니다.

4. pygame.image.load(os.path.join(IMAGE_FOLDER, "파일명"))

• 설명: 지정된 경로의 이미지를 불러옵니다.
• 역할: 게임에서 사용할 배경, 플레이어, 적 등의 이미지를 로드하는 역할을 합니다.

5. pygame.display.set_mode(IMG_ROAD.get_size())

• 설명: 게임 화면을 생성하는 함수입니다.
• 역할: 게임의 창 크기를 IMG_ROAD 이미지 크기와 동일하게 설정합니다.

6. pygame.sprite.Sprite()

• 설명: Pygame의 스프라이트 객체를 생성하는 클래스입니다.
• 역할: 게임에서 플레이어나 적과 같은 개체를 스프라이트로 관리할 수 있도록 합니다.

7. pygame.Surface(IMG_PLAYER.get_size())

• 설명: 지정된 크기의 Surface(표면)를 생성합니다.
• 역할: 이미지 크기에 맞는 Surface를 생성하여 게임 객체의 시각적 요소를 관리합니다.

8. player.rect = player.surf.get_rect(center = (h, v))

• 설명: Surface 객체의 사각형(Rect) 속성을 설정합니다.
• 역할: 스프라이트의 위치와 충돌 감지를 위한 좌표를 설정합니다.

9. pygame.display.update()

• 설명: 화면을 업데이트하는 함수입니다.
• 역할: 배경과 스프라이트가 올바르게 화면에 표시되도록 합니다.

10. pygame.key.get_pressed()

• 설명: 현재 눌린 키들의 상태를 반환합니다.
• 역할: 플레이어가 왼쪽 또는 오른쪽 화살표 키를 눌렀는지 확인하여, 플레이어를 이동시킵니다.

11. player.rect.move_ip(-moveSpeed, 0)

• 설명: 플레이어의 위치를 왼쪽(-) 또는 오른쪽(+)으로 이동시킵니다.
• 역할: 키 입력에 따라 플레이어의 rect 좌표를 변경하여 이동을 구현합니다.

12. pygame.QUIT

• 설명: 게임 창을 닫을 때 발생하는 이벤트입니다.
• 역할: 사용자가 게임을 종료하면 pygame.quit()을 호출하여 Pygame을 정리합니다.

13. pygame.quit()

• 설명: Pygame을 종료하는 함수입니다.
• 역할: 프로그램이 종료될 때 호출되며, Pygame 관련 리소스를 해제합니다.

14. sys.exit()

• 설명: 프로그램을 종료하는 함수입니다.
• 역할: Pygame 종료 후 시스템적으로 게임을 완전히 종료합니다.

15. pygame.event.get()

• 설명: Pygame에서 발생한 모든 이벤트를 가져옵니다.
• 역할: 키 입력, 마우스 클릭, 창 닫기 등의 이벤트를 감지하고 처리할 수 있도록 합니다.

16. screen.blit(IMG_ROAD, (0,0))

• 설명: 배경 이미지를 화면에 배치하는 함수입니다.
• 역할: 매 프레임마다 배경을 화면에 다시 그려줍니다.

17. enemy.rect.move_ip(0, moveSpeed)

• 설명: 적을 아래쪽으로 이동시키는 함수입니다.
• 역할: 적이 지속적으로 화면 아래쪽으로 이동하도록 합니다.

18. time.sleep(2)

• 설명: 일정 시간 동안 프로그램을 멈추는 함수입니다.
• 역할: 게임 오버 화면을 2초간 유지한 후 종료하도록 합니다.