PyGame - 이벤트 pygame.QUIT

pygame을 사용할 때 pygame 자체적으로 제공하는 Event 목록을 적절하게 이용하게 되면, 훨씬 게임을 유용하게 코딩할 수 있게 됩니다.

이벤트는 마우스, 키보드, 조이스틱, 디스플레이 및 기타 여러 가지 행동에 대한 상태 정보를 인지하여 좀 더 유용한 코딩을 가능하게 합니다.

먼저 이벤트 목록에 대해 알아보겠습니다.

00. pygame Event 목록

pygame에서 제공하는 Event 목록은 다음과 같습니다.

이벤트 이름	이벤트 속성	설명
pygame.QUIT	none	게임 종료 버튼(창 닫기 버튼) 클릭 시 발생하거나 커맨드창에서 Ctrl + C를 입력하면 발생함
pygame.ACTIVEEVENT	gain, state	화면 활성화에 대한 이벤트로, 화면(GUI)에 마우스가 들어가거나 나가면 발생함  혹은 화면이 활성화 상태이면 발생함
pygame.KEYDOWN	unicode, key, mod	키보드를 누른 후 뗄 때 발생함
pygame.KEYUP	key, mod	키보드를 누를 때 발생함
pygame.MOUSEMOTION	pos, rel, buttons	마우스가 움직일 때 발생함
pygame.MOUSEBUTTONUP	pos, button	마우스 버튼을 누른 후 뗄 때 발생함
pygame.MOUSEBUTTONDOWN	pos, button	마우스 버튼을 눌렀을 때 발생함
pygame.JOYAXISMOTION	joy, axis, value	조이스틱 축이 변경되면 발생함
pygame.JOYBALLMOTION	joy, ball, rel	조이스틱 볼이 움직이면(회전하면) 발생함
pygame.JOYHATMOTION	joy, hat, value	조이스틱 hat이 바뀌면 발생함
pygame.JOYBUTTONUP	joy, button	조이스틱 버튼을 눌렀을 때 발생함
pygame.JOYBUTTONDOWN	joy, button	조이스틱 버튼을 누른 후 뗄 때 발생함
pygame.VIDEORESIZE	size, w, h	디스플레이가 pygame.RESIZABLE 플래그로 설정되면, 사용자가 창 크기를 조정하기 위해 발생함
pygame.VIDEOEXPOSE	none	화면의 일부를 다시 그려야 하는 경우 화면에 직접 그리는 하드웨어 디스플레이가 발생시킴
pygame.USEREVENT	code	사용자가 임의로 설정하는 이벤트

위와 같이 다양한 이벤트 목록을 제공합니다.

우리는 여기서 pygame.QUIT의 이벤트에 대해 알아보도록 하겠습니다.

만약 다른 pygame 이벤트에 대한 자료를 참고하고 싶으시다면 아래의 링크에서 선택하시면 될 것 같습니다.

---

화면 활성화 이벤트 ACTIVEEVENT

키보드 입력 이벤트 KEYDOWN/UP

마우스 움직임 이벤트 MOUSEMOTION

마우스 클릭 이벤트 MOUSEBUTTONDOWN/UP

---

01. pygame.QUIT 이벤트 예제

pygame.QUIT은 게임 종료 버튼(창 닫기 버튼)을 클릭하게 되면 발생하는 이벤트입니다.

다음 예제를 먼저 살펴보도록 하겠습니다.

# Import a library of functions called 'pygame'
import pygame

# Initialize the game engine
pygame.init()

# Define the colors we will use in RGB format
BLACK = (  0,   0,   0)
WHITE = (255, 255, 255)
BLUE  = (  0,   0, 255)
GREEN = (  0, 255,   0)
RED   = (255,   0,   0)

# Set the height and width of the screen
size   = [400, 300]
screen = pygame.display.set_mode(size)
 
pygame.display.set_caption("Game Title")
 
#Loop until the user clicks the close button.
done  = False
flag  = False
clock = pygame.time.Clock()
x     = 0
y     = 0
count = 0

while not done:

    # This limits the while loop to a max of 10 times per second.
    # Leave this out and we will use all CPU we can.
    clock.tick(10)
    
    # Main Event Loop
    for event in pygame.event.get(): # User did something
        if event.type == pygame.QUIT: # If user clicked close
            if count >= 15:
                done = True # Flag that we are done so we exit this loop
            flag = True
 
    # All drawing code happens after the for loop and but
    # inside the main while done==False loop.
     
    # Clear the screen and set the screen background
    screen.fill(WHITE)

    # Drawing House 
    pygame.draw.polygon(screen, GREEN, [[30, 150], [125, 100], [220, 150]], 5)
    pygame.draw.polygon(screen, GREEN, [[30, 150], [125, 100], [220, 150]], 0)
    pygame.draw.lines(screen, RED, False, [[50, 150], [50, 250], [200, 250], [200, 150]], 5)
    pygame.draw.rect(screen, BLACK, [75, 175, 75, 50], 5)
    pygame.draw.rect(screen, BLUE, [75, 175, 75, 50], 0)
    pygame.draw.line(screen, BLACK, [112, 175], [112, 225], 5)
    pygame.draw.line(screen, BLACK, [75, 200], [150, 200], 5)

    if flag == True:
        x     += 10
        y     += 10
        count += 1
        flag  = False
    pygame.draw.line(screen, BLACK, [0, 0], [x, y], 5)

    # Go ahead and update the screen with what we've drawn.
    # This MUST happen after all the other drawing commands.
    pygame.display.flip()
 
# Be IDLE friendly
pygame.quit()

위의 예제의 결과는 다음과 같습니다.

02. pygame.QUIT 이벤트 예제 설명

결과를 확인하셨다면, 어떤 원리인지 위의 예제의 특정 라인을 통해 자세히 설명해보도록 하겠습니다.

먼저 35번째 라인에서 39번째 라인을 보도록 하겠습니다.

    # Main Event Loop
    for event in pygame.event.get(): # User did something
        if event.type == pygame.QUIT: # If user clicked close
            if count >= 15:
                done = True # Flag that we are done so we exit this loop
            flag = True

35번째 라인에서는 pygame.event.get() 함수를 통해 사용자가 발생시킨 이벤트를 가져옵니다.

가져온 이벤트 중 하나를 event라는 변수로 생각하고, 해당 이벤트의 type을 검사합니다.

36번째 라인에서는 pygame의 이벤트 중 QUIT 타입인지 확인합니다.

해당 이벤트는 게임 창에서 닫기 버튼을 클릭했는지 여부에 따라 발생합니다.

그외의 37번째 ~ 38번째 라인은 무한루프에 빠지지 않도록 하기위해 제가 임의로 작성한 라인입니다.

이는 닫기 버튼을 15번 누르게 되면 꺼지도록 하기 위한 코드입니다.

56번째 라인에서 60번째 라인을 보도록 하겠습니다.

    if flag == True:
        x     += 10
        y     += 10
        count += 1
        flag  = False
    pygame.draw.line(screen, BLACK, [0, 0], [x, y], 5)

56번째 라인은 위의 39번째 라인에서 flag라는 변수를 True로 바꿨을 때 출력되도록 설정한 코드입니다.

한 번 클릭할 때마다 x좌표와 y좌표가 10씩 증가하는 모습을 보입니다.

그리고 증가하게되는 좌표에 의해, 한 번 클릭하면 선이 늘어나는 모습을 보여주기 위해 위와 같이 작성하였습니다.

여기서 중요한 것은, 36번째 라인에서 닫기 버튼을 눌렀을 때, 우리가 임의의 작업을 넣어줄 수 있음을 의미합니다.

원래 모든 프로그램은 닫기 버튼을 누를 때 닫아지는 기능을 수행하지만, 위와 같이 임의의 기능을 삽입하였을 때 프로그램이 닫히지 않고, 선이 늘어나도록 작성할 수 있음을 보여드리고 싶었습니다.