제목 : 허르미 한글 라이브러리 2.0 [10] 안녕하세요 허르미입니다. 오늘은 Quick 루틴에 대해서 알아보도록 하겠읍니다. 지금까지 설계해온 라이브러리의 특징을 결론짓자면 세세한 제어입니다. 그래픽 루틴,출력커널,입력커널 등은 각각 Heap 영역에 포인터를 가지고 있고.. 이 포인터를 초 기화 함으로써 사용이 가능하게 됩니다. 따라서 불필요한 스태틱 영역을 점유하는 일은 없게 됩니다. 하지만 프로그램 시작시 매 번 이렇게 초기화 하려면 번거롭습니다. 사실 매번 초기화 하는 것이 세세한 처리에는 알맞지만 대부분의 경우 이를 간단히 하는 Quick 루틴은 필요한 법입니다. 저는 출력,입력,그래픽,모드설정 이렇게 4 가지의 Quickinit 루틴을 만들었읍니다. 출력은 VGA 출 력커널.. 폰트는 HMAPPLE 체(한글) SMALL 체(영문) 을 사용하였 읍니다. 글자 속성은 7 가지 모두 사용가능하게 하였읍니다.입력 은 한글 2,3 벌을 모두 가능하게 하였고. 그래픽은 box,boxfill,image,hline,vline 등을 Enable 하였읍니다. 모드 설정부분은 VGA 640x480x16 을 기준으로 하였읍니다. 윈도우 루 틴을 사용하고자 한다면 위의 입,출력,그래픽 초기화 루틴을 모 두 먼저 실행해 주어야 합니다. 아래의 함수 Call 을 보겠읍니 다. hgQuickInit(); // 모드 설정 hgQuickInInit(); // 입력 초기화 hgQuickOutInit(); // 출력 초기화 hgQuickGraphInit(); // 그래픽 초기화 . . . hgQuickOutEnd(); // 출력 끝 hgQuickInEnd(); // 입력 끝 hgQuickEnd(); // 텍스트 모드로.. 보통 위의 구조를 택하게 되는데.. hgQuickGraphEnd(); 가 없는 데 주의하세요. graphic 루틴은 Table 의 확보등이 없기때문에 다시 End 작업을 해줄 필요가 없읍니다. 그럼 위의 함수들의 소 스 리스트를 보겠읍니다. void hgQuickGraphInit() { hgEnableBoxFill(&hgVBoxFill); hgEnableImage(&hgVGetImage,&hgVPutImage); hgEnableHVline(&hgVhline,&hgVvline); } void hgQuickInInit() { hgHanInInit(); hg2bulInit(); hg3bulInit(); hgEnableAttr(fREVERSE); } void hgQuickInEnd() { hgHanInFree(); } void hgQuickInit() { hgSetDisplay(hgVGA640x480x16); hgSetMode(hgGRAPHICS); hgSetPalette(); hgSetBack(LIGHTGRAY); hgColorClearScreen(); } void hgQuickEnd() { hgSetMode(hgTEXT); } void hgQuickOutInit() { hgSetHanOut(&vputchh); hgSetEngOut(&vputche); hgSetCodeTable(); hgSetCtable(HAN_8x4x4); hgEnableAttr(fDIM); hgEnableAttr(fREVERSE); hgEnableAttr(fUNDER); hgEnableAttr(fOUTLINE); hgEnableAttr(fTHREED); hgEnableAttr(fBOLD); hgEnableAttr(fSHADOW); hgSetMaxFontRoom(HAN_8x4x4,ENG_256); hgSetHanFont(HMAPPLE_HAN); hgSetEngFont(SMALL_ENG); } void hgQuickOutEnd() { hgFreeFont(); hgFreeCodeTable(); } 이 함수들을 보면 이번 라이브러리의 특징이 잘 나타나 있읍니 다. 위의 루틴은 일단 편의를 위해서 거의 모든 루틴을 링크하고 있읍니다만.. 사실 사용자의 제어에 따라서 이 루틴들의 적절한 조합이 가능합니다. 사용의 기본이 되는 함수들이니 그 내용의 형식을 잘 봐두도록 하세요. 그럼 이제 Quick window 루틴을 봅시다. 자세한 소스의 설명은 안하겠읍니다. 함수의 기능에 중점을 두고 보세요. int wintitlefore=WHITE; int wintitleback=DARKGRAY; char *gbuff; int gx1,gy1,gx2,gy2; int saveflag; extern int dft_bstyle[8][4]; /* extern 선언 */ void savearea(int x1,int y1,int x2,int y2); // some prototype 일단 ret_~~ 두 함수들은 뒤의 함수들을 위해서 필요한 함수들입 니다. ret_number 는 string 배열을 인수로 받아서 string 의 갯 수를 세줍니다. ret_maxlength 는 최고길이를 계산해 냅니다. int ret_number(char *text[]) { int pos=0; while (strcmp(text[pos],"")) pos++; return pos*16; } int ret_maxlength(char *text[]) { int pos=0; int length=-1; int slen; while (strcmp(text[pos],"")) { slen=strlen(text[pos]); if (slen>=length) length=slen; pos++; } return length*8; // for graphic } 아래 함수는 x1,y1~x2,y2 에 title 로 윈도우를 표시해줍니다. hgPrtWTextXy 라는 함수를 호출하는데 이 함수는 윈도우를 그리 고 내부에 Text 를 출력하는 함수입니다. 이때 Text 가 "" 인 경 우가 바로 윈도우만을 그리는 경우겠죠. void hgPrtWindowXy(int x1,int y1,int x2,int y2,char *title) { char *text[]={ "" }; hgPrtWTextXy(x1,y1,x2,y2,title,text); } 아래와 같이 끝에 Q 가 붙은 함수들의 특징은 Text Item 들을 가 지고 있으며 x1,y1~x2,y2 대신에 x,y 만으로 입력을 받는 다는 데 있읍니다. 이러한 함수들은 Text Item 의 길이,수를 자동으로 계산하여 x,y 만 지정하면 그 크기를 알맞게 정해 줍니다. 편의 를 위해 출력할때 좋은 함수입니다. void hgPrtWTextXyQ(int x,int y,char *title,char *text[]) { int max=ret_maxlength(text); int num=ret_number(text); hgPrtWTextXy(x,y,x+max+32,y+num+54,title,text); } hgPrtWTextXy 함수가 위의 두 함수의 실제적인 처리를 담당합니 다. 전 강좌에서 했던 것처럼 hwindow 를 선언하여 이를 이용해 서 윈도우를 그리고 알맞은 영역에 text 를 출력해 줍니다. text 의 세로간격은 16 dot 입니다. 별로 특별한 사항은 없지만 savearea 라는 함수가 중간에 나옵니다. saveflag 라는 플래그에 의해서 이 함수가 수행되기도 하는데... 이 플래그의 기능은 출 력전 화면저장 ON ? OFF 의 기능을 합니다. Default 처럼 이 플 래그가 OFF 이면 그저 함수들은 출력할 뿐입니다. 그러나 ON 이 면 (hgSetSaveOn(); 에 의해서 ON 이 됨) 출력전에 전역버퍼에 화면을 저장합니다. 이 함수로 부터 되돌아 와서 프로그래머가 편한 시기에 hgRestore(); 함수를 부르면 아까 저장되었던 부분 이 복귀되면서 버퍼가 delete 됩니다. 이는 이 SelectBox ,ButtonBar 등에도 모두 해당되는 사항입니다. 즉 출력만 할 것 이냐,저장/복귀를 할 것이냐를 결정하는 문제가 되겠죠. void hgPrtWTextXy(int x1,int y1,int x2,int y2,char *title,char *text[]) { int xwidth=x2-x1+1; int ywidth=y2-y1+1; int ch; wcolor msgc(2,wintitlefore,wintitleback,0); width msgs(xwidth,ywidth); hwindow msgw(title,msgc,msgs); if (saveflag) savearea(x1,y1,x1+xwidth,y1+ywidth); msgw.draw_hwindow(x1,y1); int pos=0; int save=hgGetTFcolor(); hgSetTFcolor(ZERO); // for text color while (strcmp(text[pos],"")) { hgOutTextXy(x1+16,y1+38+pos*16,text[pos]); pos++; } hgSetTFcolor(save); } 음.. 아래의 함수는 x1,y1~x2,y2 에 Box 를 열고 items 를 출력 해 준후 Selection Bar 를 그려서 선택하게 합니다. 이때의 선택 결과를 리턴값으로 가집니다. ESC 의 경우에는 -1 을 리턴하게 됩니다. 소스는 간결하므로 별다른 설명은 생략합니다. int hgSelectXy(int x1,int y1,int x2,int y2,char *items[]) { int xwidth=x2-x1+1; int ywidth=y2-y1+1; /* message box define */ width mesgs(xwidth,ywidth); wcolor mesgc(2,ZERO,LIGHTGRAY,0); hbox mesgb(items,mesgc,mesgs); /* message bar define */ width mbars(xwidth-4,20); bcolor mbarc(2,0); hbar mbarb(mbarc,mbars); int pos=0; // bar position int ch; // key input int max; // number of items while (strcmp(items[pos],"")) pos++; max=pos; pos=0; if (saveflag) mesgb.save_hbox(x1,y1); mesgb.draw_hbox(x1,y1); while (1) { mbarb.draw_hbar(x1+2,y1+pos*20+2,DRAW); ch=inkey(WAIT); mbarb.draw_hbar(x1+2,y1+pos*20+2,ERASE); if (ch==UP) pos--; if (ch==DOWN) pos++; if (ch==ESC || ch==RETURN) break; if (pos<0) pos=max-1; if (pos>=max) pos=0; }; if (saveflag) mesgb.restore_hbox(x1,y1); if (ch==ESC) return -1; /* for ESC */ return pos; } 아래 함수는 역시 끝에 Q 가 붙은 함수..즉 길이 자동계산 Selection Bar 함수입니다. int hgSelectXyQ(int x,int y,char *items[]) { int flag; int max=ret_maxlength(items); int num=ret_number(items); flag=hgSelectXy(x,y,x+max+12,y+num+19,items); return flag; } 아래의 작은 함수들은 작은 기능들을 수행합니다. hgClearWindowXy 함수는 x1,y1,x2,y2 사이에 윈도우가 그려져 있 다면 화면을 윈도우 내부영역만 지워줍니다. 그밖에 Title 의 색 을 결정하는 함수들이 있고. saveflag 를 on/off 하는 함수도 있 읍니다. void hgClearWindowXy(int x1,int y1,int x2,int y2) { hgBoxFill(x1+13,y1+33,x2-13,y2-13,WHITE); } void hgSetTitleFore(int color) { wintitlefore=color; } void hgSetTitleBack(int color) { wintitleback=color; } int hgGetTitleFore() { return wintitlefore; } int hgGetTitleBack() { return wintitleback; } void hgSetSaveOn() { saveflag=1; } void hgSetSaveOff() { saveflag=0; } 그다음은 input window 를 title 로 열고 x,y 부터 길이 n 자만 큼 받아들여서 str 로 리턴해 주는 함수입니다. 어떤 내용을 입 력받을때 사용하면 편하게 쓸 수 있읍니다. 물론 hgInitStr 함수 는 미리 실행되어져야 합니다. (1.0 과 같음) int hgInWTextXy(int x,int y,char *title,char *str,int n) { int y2,x2; int flag; x2=x+n*8+40; /* 40 is adding margin */ y2=y+16+58; hgPrtWindowXy(x,y,x2,y2,title); flag=hgInTextXy(x+20,y+40,str,n); return flag; } Box 를 그리는 함수도 두개가 있읍니다. 단순하지만 화면에 box 를 그려주고 items 를 표시하게 됩니다. void hgPrtBoxXy(int x1,int y1,int x2,int y2,char *items[]) { wcolor boxc(2,ZERO,LIGHTGRAY,0); width boxw(x2-x1+1,y2-y1+1); hbox boxb(items,boxc,boxw); if (saveflag) savearea(x1,y1,x2+1,y2+1); boxb.draw_hbox(x1,y1); } void hgPrtBoxXyQ(int x,int y,char *items[]) { int max=ret_maxlength(items); int num=ret_number(items); hgPrtBoxXy(x,y,x+max+12,y+num+19,items); } 그다음은 bar 를 표시합니다. 이 함수는 Q 가 붙은 편의 함수가 없읍니다. Text 를 인자로 포함하지 않기 때문이죠. 또한 ERASE 옵션이 있으므로 특별히 saveflag 에 대한 처리를 하지는 않습니 다. void hgPrtBarXy(int x1,int x2,int y,int mode) { bcolor barc(2,0); width barw(x2-x1+1,20); hbar barb(barc,barw); barb.draw_hbar(x1,y,mode); } 아래는 Button 을 그려주는 함수입니다. void hgPrtButtonXy(int x,int y,char *text,int mode) { int max=strlen(text); wcolor btc(2,ZERO,LIGHTGRAY,0); width btw(max*8+10,20); hbutton btb(text,btc,btw); btb.draw_hbutton(x,y,mode); } 마지막으로 ButtonBar 를 설계했읍니다. Button Bar 의 구성은 msg,items 로 구성됩니다. x1,y1~x2,y2 사이에 복선 box 를 그리 고 msg 를 표시한후 hgDHline 함수로 가로 복선을 긋고 그 아래 에 items 의 길이와 수에 따라 적당히 버튼을 그려줍니다. 그리 고 첫번째 버튼위치에 음각 box 를 그려줍니다. TAB 키이나 LEFT/RIGHT 화살표에 의해서 선택이 가능하며 선택하면 그 버튼 이 눌리게 됩니다. 리턴값은 버튼의 번호입니다. 이는 여러가지 사실중에서 하나를 선택할 때 쓰이게 됩니다. 사실 프로그램 하 다보면 참 요긴한 함수이죠. 생각보다 이렇게 몇가지 중에서 선 int hgPrtButtonBarXy(int x1,int y1,int x2,int y2,char *msg[],char *items[]) { int fore,back; int pos=y1+10; int ch; int length; if (saveflag) savearea(x1,y1,x2,y2); hgDrawBorder(x1,y1,x2,y2,dft_bstyle[2],FILL); hgDrawBorder(x1+4,y1+4,x2-4,y2-4,dft_bstyle[3],NOFIL L); fore=hgGetTFcolor(); back=hgGetTBcolor(); hgSetTFcolor(ZERO); hgSetTBcolor(LIGHTGRAY); int num=ret_number(msg)/16; for (int i=0;inum-1) { xpos=16+xincre/2+x1;i=0; } if (ch==RETURN) break; } while (1); hgSetTFcolor(fore); hgSetTBcolor(back); hgPrtButtonXy(xpos-strlen(items[i])*4,pos,items[i],P USH); return i; } 그다음은 Q 붙은거.. int hgPrtButtonBarXyQ(int x,int y,char *msg[],char *items[]) { int max=ret_maxlength(msg); int num=ret_number(msg); int flag; int x2=x+max+32; int y2=y+num+70; flag=hgPrtButtonBarXy(x,y,x2,y2,msg,items); return flag; } 이제 saveflag 에 관련된 함수만 남았읍니다. savearea 는 일단 화면을 저장하고 위치를 기억해 둡니다. void savearea(int x1,int y1,int x2,int y2) { gbuff=new char[ hgImgSize(x1,y1,x2,y2) ]; hgGetImage(x1,y1,x2,y2,gbuff); gx1=x1;gy1=y1; gx2=x2;gy2=y2; } hgRestore 는 그 위치에 복귀하고 gbuff 를 delete 해줍니다. void hgRestore() { hgPutImage(gx1,gy1,gx2,gy2,gbuff); delete gbuff; } 그럼..허르미!