|
| 게임 프로그래밍 라이브러리 | 언어: English español Deutsch français polski Italiano |
|
Allegro가 동작하지 않을 때 할 일
목차
서론무언가 잘못될 때는 보통 다른 사람에게 도움을 청하는 것이 좋습니다. 다행스럽게도 당신에게 이런 종류의 질문에 답하기 위해 시간을 기꺼이 할애할 많은 사람들(Allegro 개발자들과 사용자들)이 있지만, 도움을 받는 과정을 보다 효율적으로 만들 수 있는 다양한 할 일들이 있습니다. 이 문서는 Allegro 프로그램을 작성하면서 문제를 만날때마다 그것을 스스로 해결할 수 있는 방법을 제시하며, 도움을 청할 때와 방법에 대한 몇가지 조언에 대해 다루고 있습니다. 이 문서의 안내를 따르면 (모든 관련 정보가 그들에게 간결하고 유용한 방법으로 제시될 것이기 때문에) 도움을 주는 사람들의 삶이 보다 편하도록 할 것이며, (답변을 빠르고 정확하게 받을 가능성이 높아지기 때문에) 도움을 받는 사람들도 편해질 것입니다.
파트 1 - 누가 범인인가?문제의 원인이 Allegro의 버그인가 또는 당신의 프로그램의 버그인가? 이것을 알아내기 위해 Allegro의 테스트 프로그램을 실행시켜 보십시오. 특히 test.exe(그래픽 관련 문제), play.exe(사운드 카드 문제), examples 디렉토리에 있는 내용들(잘 못 동작하는 어떠한 문제에 대해서라도)을 시도해 보십시오. 이것들을 이용해서 문제점을 해결해 가지 못한다면 그것은 당신의 문제입니다. 이 경우 파트 3을 보십시오. 프로그램이 DOS 그래픽 모드와 관련되어 있다면 Display Doctor를 http://www.scitechsoft.com에서 가져와야 할 것입니다. 만일 이것으로 문제가 해결된다면 이것은 거의 확실하게 가지고 있는 VESA 드라이버가 어떤 이유에선가 깨져 있던 것을 의미합니다. 저는 이러한 종류의 문제점에 대한 보고를 듣는 것을 좋아하지 않습니다: 그런 문제를 해결하기 위해 제가 할 수 있는 일이 없으므로 죄송하게도 당신의 유일한 선택 사항은 제조 업체를 졸라 드라이버의 버그를 고치거나, Display Doctor를 구입하거나, 당신의 카드에 맞는 FreeBE/AF 드라이버를 작성하는 것입니다 (http://www.talula.demon.co.uk/freebe/를 보십시오).
파트 2 - Allegro가 잘 못 동작할 때문제가 아직 Allegro에 있다고 생각한다면 문제점에 대한 자세한 설명, 사용하고 있는 프랫폼과 라이브러리 버전, 정확히 어떤 프로그램과 함께 사용한 경우 문제가 발생하는가(이것은 어떤 프로그램이 문제를 가지고 있는가 뿐만 아니라 올바르게 동작하는 것이 있다면 어떤 것인가를 아는데 중요합니다)를 포함하는 시스템 보고서를 보내주십시오. 문제가 DOS 그래픽 모드에 있다면 afinfo와 vesainfo 프로그램을 실행시켜 얻은 결과(-v 스위치를 명시하여 구하지 않았다 하더라도 간략한 버전의 결과로 충분합니다: 추가되는 모든 데이터는 보통 필요하지 않습니다)를 보내야 합니다. test.exe 프로그램에서 여러 가지의 Allegro 드라이버(당신의 카드에서 동작할 것이라고 생각되는 드라이버들, VESA 2.0, VESA 1.x 드리이버)를 선택하여 여러 가지 비디오 모드를 테스트 해 보고, 정확히 어떠한 모드와 컬러 설정에서 문제가 발생하는지 알려 주십시오. 당신이 어떠한 SVGA 해상도를 사용할 수 있었다면 test.exe에서 Autodetect 옵션을 선택하고 화면 중앙에 표시되는 전체 문자를 보고하여 주십시오. 문제가 DOS 사운드 시스템과 관련되어 있다면 setup 프로그램을 사용하여 사운드 카드를 수동으로 설정해 보십시오. 하드웨어 파라미터를 수동으로 입력하여야 할 수 도 있습니다. SB 호환 카드라면 자동 검출되는 것 (SB Pro, SB 2.0, SB 1.0)보다 이전의 카드를 선택해 보십시오. 아직까지 아무것도 동작되는 것이 없다면 자동으로 검출되는 digital/MIDI 사운드 드라이버의 이름과 설명(이 정보는 play.exe 프로그램을 실행하면 표시됩니다)을 포함하여 알려 주셔야 합니다.
파트 3 - 프로그램이 다운될 때djgpp 프로그램이 다운될 때, 보통 다음과 같은 스택 역추적(stack traceback) 화면을 보게 될 것입니다:
Exiting due to signal SIGSEGV
General Protection Fault at eip=00001eca
[snip]
Call frame traceback EIPs:
0x00001eca
0x00001590
0x00001aea
이 정보는 정확히 어디에서 프로그램이 다운되었나를 알려줍니다. 이것이 의미를
갖도록 하려면 프로그램을 디버깅 정보를 갖도록(-g 스위치를 이용합니다)
컴파일 하여야 하며, 그리고 나서 이 역추적 화면이 표시되는 동안에
"symify program.exe"를 실행시킵니다. 그러면 스택 역추적 정보는 다음과 같은
것으로 바뀔 것입니다:
Call frame traceback EIPs:
0x00001eca _strcpy+14
0x00001590 _main+56, line 7 of t.c
0x00001aea ___crt1_startup+138
이 경우, 프로그램 다운이 t.c 소스 파일 안의 main()의 7번째 행의 strcpy() 함수에서
일어난 것을 알 수 있습니다.이제 할 일은 그 행으로 가서 거기서 무었을 하고 있는지
보거 올바르게 고치는 것입니다 :-)
주의: 프로그램 다운이 Allegro 함수의 깊은 곳에서 생겼다면 스택 역추적 정보는 그다지 유용하지 않을 수 있습니다. 이 경우에는 Allegro를 디버깅 정보와 함께 컴파일하여 (readme 파일을 참고하십시오) 만들어진 디버깅 라이브러리 버전과 당신의 프록그램을 링크하여 테스트하십시오. 주의 2: 프로그램 다운의 스택 역추적 위치가 Allegro 함수를 가리킬 경우라 해도 Allegro 루틴이 잘 못 되어 있다는 것을 의미하지는 않습니다. 잘못된 파라미터를 넣을 경우 어떠한 함수라도 다운을 유발시킬 수 있으므로, Allegro 예제 프로그램 중 어떤 것에서라도 동일한 문제를 발생시키지 않는다면 원인을 사용자가 잘못한 경우라는 가정을 가지고 Allegro 함수에 들어가는 값들이 정확히 어떠한 것인지 거듭 점검하여야 할 것입니다.
파트 4 - 사람들이 잘 하지 않는(그렇지만 해야할) 것들프로그래머들이 저지르는 가장 흔한 잘못 중의 하나는 실패할 수도 있는 함수의 리턴값 검사를 하지 않는 것입니다. 이러한 잘못은 종종 예측하지 못한 이상한 에러를 발생시키며, 디버깅의 악몽이 되어버립니다. Allegro의 도처에 여러가지 변화하는 환경에 따라 바뀌는 많은 함수들이 있습니다. 그렇지만 그것들은 문서화된 리턴값으로 수행이 성공하였는지 아닌지를 알려줄 만큼 훌륭합니다. 실패할 가능성이 있는 함수(가장 중요한 것으로 set_gfx_mode(), install_sound(), 그리고 디스크에서 읽어들이는 모든것)을 호출할 때는 언제나 리턴값을 점검하여 그것에 따라 동작하도록 하는 것이 _필수적_ 입니다. 또 하나의 자주 잊어버리지만 중요한 도구는 당신의 코드를 컴파일 할 때 엄격한 경고 (warning)을 표시하도록 하는 옵션(gcc는 -Wall을 사용합니다)을 사용하는 것입니다. 이 옵션에 따라 지적된 어떠한 경도도 다른 것을 하기 전에 고쳐져야 할 것입니다. gcc를 이용하는 경우 -O를 함께 설정하여 컴파하는 것도 좋은 방법입니다. 이것은 더욱 유용한 경고를 표시합니다. 일반적인 경우 디버깅 할 때에는 최적화를 하지 않도록 하여야 합니다. 최적화를 하는 것이 컴파일 할 때의 경고를 적게 주지만, 그것은 나중에 사용할 지도 모르는 디버깅 도구를 혼란시킬 가능성이 많습니다.
파트 5 - 도움을 청하기좋습니다. 당신은 위에서 설명된 모든 것을 시도해 보았지만 아직 당신의 프로그램은 동작하지 않습니다. 당신은 이제 무엇을 할 지 모르고 있으므로, 이제는 인터넷의 자비속으로 당신을 던져 당신의 질문에 답을 갖고 있을 몇몇의 현자나 예지자(seer), 혹은 신탁(oracle)을 찾기를 바라야 할 때입니다... (역자주: 위의 번역이 좀 이상하지만 인터넷 상에서 관련 문제에 도를 통한 전문가를 찾아야 한다는 뜻입니다.) 질문을 할 가장 좋은 곳은 Allegro 메일링 리스트입니다: readme.txt에 자세히 설명되어 있습니다. 하지만 이 곳은 Allegro에 한정된 리스트임을 명심하십시오. C 언어나 djgpp 컴파일러와 관련된 문제는 다른 포럼에 속해 있습니다(각각 comp.lang.c와 comp.os.msdos.djgpp입니다). Allegro와 djgpp 메일링 리스트는 보관되어 있으며, 각각의 홈페이지에서 찾을 수 있습니다. 당신의 문제에 대한 답을 지나간 질문과 답변에서 찾아 내어 질문을 게시할 필요가 없어지는 경우가 상당히 많이 있습니다. 적절한 네티켓에 따르면, 당신이 인터넷 상의 어떠한 포럼에 게시할 때는 적어도 관련 문서를 모두 읽지는 않더라도 먼저 참조해 보았다고 가정합니다. 당신이 가지고 있는 문제가 수백명의 사람들에게 물어볼 만한 것이라면 그것은 분명히 당신 스스로 문제를 해결하기 위해 약간의 시간을 투자할 가치가 있습니다. Allegro는 광범위하게 심혈을 기울여 문서화 되어 있으므로, 질문을 게시하기에 앞서 문서를 읽고 예제 프로그램 또한 조사하는 것이 선행되어야 할 것입니다.
파트 6 - 실수로부터 배우시오하지 말아야 할 것, 첫번째:
"내 프로그램이 다운됩니다. 왜 그런지 알려주세요."
그렇습니다. 사람들은 실제로 때때로 저에게 이런 질문을 보내옵니다 :-)
몇년의 수행에도 불구하고 저는 아직 마음을 읽지 못합니다. 따라서 이것은
매우 무의미한 질문입니다.
문제에 대한 도움을 구하기 위해서는 먼저 그것을 충분히 자세히 설명하여 다른
사람들이 이해하고 그것을 재현해 볼 수 있게 해야 합니다: 이것은 종종
소스 코드의 일부를 게시하는 것을 의미합니다.
"제 프로그램에 문제가 있습니다. 10,000줄의 소스와 모든 그래픽,
사운드 데이터를 압축한 500k의 zip 파일을 함께 보냅니다: 이것을
디버깅하여 무엇이 문제였는지 알려주시겠습니까?"
이같은 많은 양의 뒤죽박죽인 정보를 읽고 이해하는데 걸리는 시간은 생각하지 않더라도
이와 같은 큰 파일을 다운로드하기 위해 시간과 전화 요금을 써버리면서라면
아무도 당신을 _도와주려하지_ 않을 것 같습니다.
당신은 문제를 보여주는 전체 코드 중의 작은 부분을 분리하도록 하여야 할 것입니다:
더 작게 분리할 수록 누군가 당신을 도와줄 가능성이 높습니다.
당신은 다른 사람에게 도와줄 것을 부탁하고 있다는 것을 기억하십시오.
가능한한 다른 사람이 편하게 도울 수 있도록 하는 것은 당신의 책임입니다.
파트 7 - 질문을 올리는 방법가장 중요한 것은 당신의 메시지를 읽는 사람이 컴파일하여 테스트해 볼 수 있는 코드를 포함시키는 것입니다. 전체 프로그램을 모두 게시하지 마십시오: 문제를 발생시키는 특정 행들을 포함하는 작은 부분을 선별하거나 보다 간단한 방법으로 문제를 재현할 수 있도록 하십시오 (작은 버전을 만드는 과정에서 오류의 발생 위치를 찾게 되는 경우가 많으므로 이것은 그 자체로도 좋은 연습입니다). 이 코드는 작지만 실제로 컴파일되고 실행될 수 있는 완전한 것이어야 합니다. 불완전한 코드 조각을 디버깅하는 것은 매우 힘든 일이기 때문입니다. email 메시지의 텍스트 안에 직접 코드를 포함시키큰 것이 가장 좋은데, 이것은 추가 파일을 읽어오는 것보다 메시지에서 직접 읽는 것이 더 편한 방법이기 때문입니다. 이상적으로는 외부의 그래픽이나 데이터 파일을 사용하기 않는 예제여야 합니다. 그래픽이나 데이터를 포함하는 작은(최대 2k) zip 파일이나 필요한 다른 파일에 대한 설명(예를 들면 "tile.pcx라는 이름의 32x32 .pcx파일을 프로그램과 같은 디렉토리에 넣으시오") 정도는 괜찮습니다. 이 정도로 간단하게 만들 방벙이 없다면 프로그램과 데이터를 웹사이트에 올리고 URL을 메시지에 넣어 게시하여야 할 것입니다. 프로그램을 빌드할 때 어떠한 gcc 명령어행을 사용하였는지 명시하여야 하며 -Wall 스위치가 반드시 포함되어 있어야 합니다. 프로그램이 의도하는 것(이것은 다른 사람들에게는 즉시 분명하게 이해되지 않을 수 있습니다) 과 실제로 실행시켰을 때의 동작을 설명하십시오. 보통은 다운될 때의 스택 역추적 내용(코드를 컴파일하고 실행시킬 수 있다면 이것을 재현할 수 있습니다)을 게시할 필요는 없습니다만, 당신은 스택 역추적, 정지(lockup), 혹은 잘못된 결과가 나왔는가(결과가 틀리다면 당신이 생각하고 있던 것과 정확하게 어떤 방식으로 틀렸는지를)는 말해 주어야 합니다. 다운되며 스택 역추적이 나온 행을 표시하는 주석문을 소스에 달아 주는 것도 좋습니다. 포함시킬 수 있는 다른 정보들도 역시 유용할 수 있습니다. 가장 중요한 것은 시스템 하드웨어와 드라이버, Allegro 버전(그냥 "WIP"라고 하지 말고 공식적으로 번호가 붙은 배포본을 사용하고 있는 경우라면 정확한 날짜를 명시하십시오) 에 대한 정보입니다.
파트 8 - 완벽한 질문의 예참고로 여기서는 이상적인 문제 보고서라고 생각하는 한 예를 보이겠습니다:
저는 하이컬러 비디오 모드를 사용할 때 프로그램에 문제가 있습니다.
Allegro 테스트 프로그램은 잘 동작합니다. 저는 Allegro 3.0과 djgpp 2.02
(gcc 버전 2.8.1)을 펜티엄166, 윈도우즈95환경에서 내장 VESA 2.0 드리이버
와 함께 사용하고 있으며, vesainfo 프로그램의 결과는 "Matrox Graphics Inc
." 입니다.
이 프로그램은 640x480 16비트 해상도를 선택하도록 하였으며, 스크린의 왼쪽
위 근처에 푸른색 사각형을 그리고 나서 종료하기 전에 키 입력을 기다리는
것이지만, 실행시키면 General Protection Fault가 나옵니다.
컴파일은 "gcc -Wall t.c -o t.exe -lalleg"와 같이 하였으며 경고는 하나도
없었습니다.
--- 여기서 자르시오, t.c ---
#include <stdio.h>
#include <allegro.h>
void main()
{
BITMAP *bmp = screen;
install_keyboard();
if (set_gfx_mode(GFX_AUTODETECT, 640, 480, 0, 0) != 0) {
printf("Error setting video mode\n");
return;
}
set_color_depth(16);
/* 이 사각형 함수를 부를 때 다운됩니다! */
rectfill(bmp, 32, 32, 64, 64, 0x001F);
readkey();
}
|
| 마지막 수정일: 2003년 4월 8일 21:58 (UTC). 웹마스터에게 연락하려면. |
