HOWTO · Pygame
Pygame의 surface.blit() 함수
Surface.blit()가 Pygame 표면 간에 픽셀을 복사하고, 결과를 배치하고, 원본 영역을 선택하는 방법을 알아봅니다.
이 페이지의 내용
Surface.blit()는 원본 Surface에서 대상 Surface로 픽셀을 복사합니다. Pygame 디스플레이에서는 화면이 대상 표면입니다. 화면 밖의 표면에 그린 다음 그 결과를 화면에 배치할 수도 있습니다. 아래의 짧은 연산 예제는 인수를 설명하고, 마지막 절에서는 이를 완전한 창과 이벤트 루프 안에 넣습니다.
이 예제들은 픽셀을 복사하고 배치하는 데 초점을 맞춥니다. 블렌딩은 보여 주지 않습니다. 설정 방법은 기본 구성의 Pygame 창 예제를 참조하세요. 여기서의 예제는 창을 만드는 것보다는 표면 사이의 그리기에 초점을 맞춥니다.
Surface.blit()가 한 표면을 다른 표면에 그리는 방법
픽셀을 받을 표면에서 blit()를 호출합니다. 첫 번째 인수는 원본 표면이고, 두 번째 인수는 대상 위치, 즉 원본이 그려지는 왼쪽 위 모서리를 지정합니다. 예를 들어, destination.blit(source, (20, 30))은 원본을 대상의 x 좌표 20, y 좌표 30 위치에 배치합니다. 두 개의 항목으로 이루어진 튜플은 그 위치를 표현하는 명확한 방법입니다.
이 메서드는 선택적인 원본 영역과 특수 플래그 값도 허용합니다. 원본 영역은 원본 표면의 왼쪽 위 모서리에서 측정되는 직사각형으로, 복사할 부분을 선택합니다. 이를 생략하면 원본 표면 전체가 사용됩니다. 특수 플래그는 블렌드 연산과 같은 Pygame blit 연산을 선택합니다. 이는 대상 위치 및 원본 영역 인수와는 별개이며, 여기의 예제에서는 기본값으로 둡니다.
호출 형태는 destination.blit(source, destination_position, source_area=None, special_flags=0)입니다. blit() 메서드는 대상에서 영향을 받는 영역을 설명하는 직사각형을 반환하는데, 이는 디스플레이의 일부만 업데이트할 때 유용할 수 있습니다. 대상 위치가 대상 표면 밖에 있으면 겹치는 부분만 그려질 수 있습니다.
원본 영역과 함께 Surface.blit() 사용하기
pygame.Surface((width, height))로 표면을 만든 다음, (200, 100, 100)과 같은 RGB 색상 튜플로 채웁니다. 선택한 원본 영역을 복사하려면 세 번째 인수로 (x, y, width, height) 형식의 직사각형을 전달합니다. 예를 들어, (0, 0, 10, 5)는 원본의 왼쪽 위 모서리에서 시작하는 10x5 직사각형을 선택합니다. 복사된 픽셀은 두 번째 인수로 전달한 대상 위치에서 시작합니다.
화면 밖의 표면에 그린 후에는 이벤트 루프 안에서 그 표면을 디스플레이에 그립니다. pygame.display.flip()를 호출하기 전에 매 프레임마다 디스플레이를 지우거나 다시 그리세요. 그렇지 않으면 이전 프레임의 내용이 계속 보일 수 있습니다. 그림은 원본 영역을 다른 표면에 복사한다는 아이디어를 보여 줍니다.
완전한 Pygame 예제 실행하기
다음 프로그램은 창을 만들고, 두 표면을 채우고, 한 표면에서 선택한 영역을 다른 표면에 복사한 뒤, 닫기 전에 결과를 60프레임 동안 그립니다. 이 예제는 오디오를 사용하지 않으므로 디스플레이 하위 시스템만 초기화합니다. 실행에 사용하는 Python 환경에 Pygame을 설치하세요. 닫을 때까지 열려 있는 창을 만들려면 range(60)을 while running으로 바꾸세요. 제공된 실행에서는 아래에 표시된 Pygame 시작 메시지와 복사 확인이 출력되었습니다.
import sys
import warnings
warnings.filterwarnings(
"ignore",
message="Your system is avx2 capable but pygame was not built with support for it.*",
category=RuntimeWarning,
)
import pygame
pygame.display.init()
screen = pygame.display.set_mode((640, 480), pygame.RESIZABLE)
pygame.display.set_caption("Surface.blit() example")
clock = pygame.time.Clock()
destination = pygame.Surface((100, 100))
destination.fill((200, 100, 100))
source = pygame.Surface((30, 30))
source.fill((100, 200, 100))
# Copy a 10-by-5 region from source to destination at (10, 10).
destination.blit(source, (10, 10), (0, 0, 10, 5))
print("Copied a 10-by-5 source area to (10, 10).")
running = True
for _ in range(60):
for event in pygame.event.get():
if event.type == pygame.QUIT:
running = False
if not running:
break
screen.fill((20, 20, 20))
screen.blit(destination, (10, 10))
pygame.display.flip()
clock.tick(60)
pygame.quit()
sys.exit()
pygame 2.6.1 (SDL 2.26.5, Python 3.14.7)
Hello from the pygame community. https://www.pygame.org/contribute.html
Copied a 10-by-5 source area to (10, 10).