파이게임 자습서
화면표시 모드 설정법
작성 피트 쉬너스(Pete Shinners)
pete@shinners.org
Revision 1.1, May 21, 2002
한글판 johnsonj 2005.05.02
들어가는 말
파이게임에서는 화면 표시 모드를 설정해야 모니터에 이미지 표면이 만들어지고 그래야 볼 수 있다. 이 표면(surface)은 전체 화면일 수도 있고, 또는 창 관리자를 지원하는 플랫폼이라면 창이 될 수도 있다. 화면 표시 표면은 표준적인 파이게임 표면 객체에 불과하다. 이미지 표면소(역주: 표면을 채우는 내용)를 모니터에 업데이트하려면 pygame.display 모듈에 있는 특별한 함수들이 필요하다.
대부분의 그래픽 라이브러리에서 그런 것 보다 더 쉽게 파이게임에서 화면표시 모드를 설정할 수 있다. 장점이 있다면 화면표시 모드가 설정이 불가능하면 pygame은 요청한 화면표시 모드를 흉내내 준다는 것이다. Pygame은 요청한 설정에 가장 부합하는 화면표시 해상도와 색상 깊이를 선택한다. 그래서 요청한 형태의 화면에 접근할 수 있다. 사실, pygame.display 모듈은 SDL 라이브러리를 둘러싼 바인딩이며, SDL이 실제로 이 모든 일을 해 주는 것이다.
이런 식으로 화면표시 모드를 설정하는 것은 장단점이 있다. 장점은 게임에서 특정한 화면표시 모드를 요구할 때, 플랫폼에서 지원되지 않다라도 게임이 실행된다는 것이다. 또 무언가를 시작하기에도 더 편하다. 언제나 쉽게 다시 되돌아가 모드 선택을 좀 더 구체적으로 지정할 수 있다. 단점은 요청한 대로 언제나 돌려받는 것은 아니라는 것이다. 또 화면표시 모드가 에뮬레이드 되야만 하는 경우라면수행성능도 저하된다. 이 자습서는 플랫폼 화면표시 능력을 질의하고, 게임을 위해 화면표시 모드를 설정하는데 사용되는 다양한 방법을 이해하도록 도와 줄 것이다.
설정의 기본
제일 먼저 알아야 할 것은 현재 화면표시 모드를 실제로 설정하는 방법이다. 화면표시 모드는 pygame.display 모듈이 초기화 된 후라면 언제든지 설정해도 좋다. 이전에 화면 표시 모드를 설정한 적이 있더라도, 다시 설정하면 현재 모드가 바뀐다. 화면표시 모드를 설정하는 것은 pygame.display.set_mode((width, height), flags, depth) 함수로 처리된다. 이 함수에 요구되는 유일한 인자는 새로운 화면표시 모드를 지시하는 너비와 높이를 담고 있는 연속열이다. 깊이(depth) 플래그는 표면에 대하여 픽셀당 요구되는 비트개수이다. 주어진 깊이가 8이라면, pygame은 색깔-짝짓기된 표면을 만든다. 좀 더 많은 비트의 깊이가 주어지면, pygame은 팩 컬러 모드를 사용한다. 깊이와 색상에 관한 더 많은 정보는 화면표시(display) 모듈과 표면(surface) 모듈에 대한 문서에 찾아 볼 수 있다. 깊이에 대한 기본 값은 0이다. 인자가 0으로 주어지면, pygame은 사용하기에 가장 적합한 비트 깊이를 선택하는데, 보통 시스템의 현재 비트 깊이와 동일하다. 플래그(flags) 인자로 화면 표시 모드의 기타 특징들을 제어할 수 있다. HWSURFACE 플래그로는 화면표시 표면을 하드웨어 메모리에 만들 수 있다. 역시, 이에 관한 더 자세한 정보는 pygame 참조 문서를 보자.
결정하는 법
그래서 어떻게 하면 게임이 실행될 플랫폼과 그래픽 자원에 가장 잘 작동하는 화면 표시 모드를 선택할 수 있는가? 화면표시 장치에 관한 정보를 모으는데는 여러가지 방법이 있다. 이 모든 방법들은 반드시 화면표시 모듈이 초기화된 다음에 호출되어야 하지만, 화면표시 모드를 설정하기 전에 호출하고 싶을지도 모르겠다. 먼저, pygame.display.get_info() 함수는 VidInfo라는 특별한 객체 유형을 돌려주는데, 이 객체에서 그래픽 드라이버의 능력에 관하여 많은 정보를 알 수 있다. pygame.display.list_modes(depth, flags) 함수는 시스템에서 지원하는 그래픽 모드를 찾는데 사용될 수 있다. Pygame.display.mode_ok((width, height), flags, depth) 함수는 set_mode()와 똑 같은 인자를 받지만, 요청에 가장 가깝게 부합하는 비트 깊이를 돌려준다. 마지막으로, pygame.display.get_driver() 함수는 pygame에서 선택된 그래픽 드라이버의 이름을 돌려준다.
황금률을 꼭 기억하자. Pygame은 요청한 어떤 화면표시 모드와도 잘 작동할 것이다. 어떤 화면표시 모드는 에뮬레이트될 필요가 있는데, 이 때문에 게임의 속도가 떨어질 것이다. 왜냐하면 pygame은 "실제" 화면표시 모드에 업데이트를 요청할 때마다 변환할 필요가 있기 때문이다. 가장 좋은 선택은 pygame이 언제나 최적의 비트 깊이를 골라서, 그래픽 자원들이 적재될 때마다 그 포맷에 맞추어 모두 변환하도록 그대로 두는 것이다. pygame이 아무 인자 없이 또는 깊이를 0으로 해서 set_mode()를 호출해서 비트 깊이를 고르도록 그대로 두어도 된다. 또는 mode_ok()를 직접 호출하여 필요에 가장 부합하는 비트 깊이를 찾아도 된다.
화면표시 모드가 창이라면, 보통 데스크탑의 비트 깊이와 동일하게 맞추어야 한다. 전화면 모드라면, 어떤 플랫폼에서는 요구에 가장 적합한 비트 깊이로 얼마든지 전환할 수 있다. 화면표시 모드를 설정하기 전에 VidInfo 객체를 얻는다면 현재 데스크탑의 비트 깊이를 알 수 있다.
화면표시 모드를 설정하고 나면, VidInfo 객체를 얻거나 또는 화면표시 표면에 Surface.get* 메쏘드들을 아무거나 호출해서 설정에 관한 정보를 얻을 수 있다.
함수
다음은 가장 적절한 화면표시 모드를 결정하는데 사용할 수 있는 루틴들이다. 이런 함수들에 관한 더 자세한 정보는 화면표시 모듈 문서에서 알 수 있다.
pygame.display.mode_ok(size, flags, depth)
이 함수는 pygame.display.set_mode() 함수와 정확하게 똑같은 인자들을 받는다. 기술한 모드에 가장 적합한 비트 깊이를 돌려준다. 0을 돌려준다면, 원하는 화면표시 모드는 사용할 수 없고 에뮬레이션된다.
pygame.display.list_modes(depth, flags)
요청된 깊이와 플래그로 지원되는 화면표시 모드를 담은 리스트를 돌려준다. 모드가 존재하지 않으면 빈 리스트가 반환된다. 플래그 인자는 기본 값이 FULLSCREEN이다. FULLSCREEN 없이 따로 플래그를 지정하면, 반환 값이 아마도 -1이 될 것이다. 이는 화면표시가 창이 될 것이기 때문에 어떤 화면표시 크기도 괜찮다는 뜻이다. 모드 리스트는 큰 값에서 작은값 순으로 정렬되어 있음을 주목하자.
pygame.display.get_info()
이 함수가 돌려주는 객체에는 화면표시 장치를 기술하는 많은 멤버들이 있다. VidInfo 객체를 인쇄하면 즉시 이 객체에 대한 멤버와 값을 모두 볼 수 있을 것이다.
>>> import pygame.display
>>> pygame.display.init()
>>> info = pygame.display.get_info()
>>> print info
<VideoInfo(hw = 1, wm = 1,video_mem = 27354
blit_hw = 1, blit_hw_CC = 1, blit_hw_A = 0,
blit_sw = 1, blit_sw_CC = 1, blit_sw_A = 0,
bitsize = 32, bytesize = 4,
masks = (16711680, 65280, 255, 0),
shifts = (16, 8, 0, 0),
losses = (0, 0, 0, 8)>
단순히 VidInfo 객체의 구성원인 이 모든 플래그들을 테스트해 볼 수 있다. 서로 다른 blit 플래그는 다양한 유형의 표면으로부터 하드웨어 표면으로 블럭전송할 때 하드웨어 가속이 지원되는지 알려준다.
예제들
다음은 그래픽 화면을 초기화하는 여러 방법들을 보여준다. 화면표시 모드를 설정하는 방법에 관하여 아이디어를 얻을 수 있으리라 믿는다.
>>> # 640 x 480 창 디스플레이에 최적 깊이를 돌려준다
>>> pygame.display.set_mode((640, 480))
>>> # 가장 큰 16비트 디스플레이를 돌려준다
>>> modes = pygame.display.list_modes(16)
>>> if not modes:
... print '16bit not supported'
... else:
... print 'Found Resolution:', modes[0]
... pygame.display.set.mode(modes[0], FULLSCREEN, 16)
>>> # 8비트 표면이 필요하다. 다른 것들은 안됨
>>> if pygame.display.mode_ok((800, 600), 0, 8) != 8:
... print 'Can only work with an 8bit display, sorry'
... else:
... pygame.display.set_mode((800, 600), 0, 8)