NCURSES-Programming-HOWTO
|
[edit]
NCURSES Programming HOWTO ¶첫 번역이라 많이 미흡합니다 모자란 점이 있으면 지적해 주시기 바랍니다. --gsong
번역
gsong
작성
Pradeep Padala
#! v1.7.1, 2002-06-25 Revision History Revision 1.7.1 2002-06-25 Revised by: ppadala Added a README file for building and instructions for building from source. Revision 1.7 2002-06-25 Revised by: ppadala Added "Other formats" section and made lot of fancy changes to the programs. Inlining of programs is gone. Revision 1.6.1 2002-02-24 Revised by: ppadala Removed the old Changelog section, cleaned the makefiles Revision 1.6 2002-02-16 Revised by: ppadala Corrected lot of spelling mistakes, added ACS variables section Revision 1.5 2002-01-05 Revised by: ppadala Changed structure to present proper TOC Revision 1.3.1 2001-07-26 Revised by: ppadala Corrected maintainers paragraph, Corrected stable release number Revision 1.3 2001-07-24 Revised by: ppadala Added copyright notice(LDP license) to main document, Put copyright notice (GPL) for programs as well, Corrected printw_example. Revision 1.2 2001-06-05 Revised by: ppadala Incorporated ravi's changes. Mainly to introduction, menu, form, justforfun sections Revision 1.1 2001-05-22 Revised by: ppadala Added "a word about window" section, Added scanw_example. 이 문서는 ncurses 와 그 자매 라이브러리로 프로그래밍을 하는 데 있어 "All in One" 가이드를 지향하고 있다. 간단한 "Hello World" 프로그램 부터 보다 더 복잡한 폼 처리 까지 다룬다. ncurses 의 선행경험은 필요치 않다. 이 문서의 최신 버전은
![[http]](/imgs/http.png) 나의 웹 사이트 에서 찾을 수 있다.  p_padala_at_yahoo.com 이 주소로 비평을 보내주길 바란다.
목차
[edit]
1.1 Introduction ¶예전 원거리 터미널은 컴퓨터로부터 떨어진 채 시리얼 케이블을 통해 연결되어 있었다. 그 터미널들에 어떤 특정한 바이트들을 보냄으로써 터미널을 설정할 수 있었다. 터미널의 이 모든 기능들 (커서를 새 위치로 옮기거나, 화면의 일부를 지우거나, 화면을 스크롤 하거나, 모드를 바꾸거나, 화면의 형태, 색, 밝기, 깜빡임, 밑줄, reverse video 등을 설정하는 등) 은 흔히 escape sequences 라 불리는 바이트들에 의해서 이뤄졌다. 이 바이트들은 escape(0x1B) 문자로 시작하기 때문에 escape sequences 라 불린다. 심지어 오늘날에도 적절한 에뮬레이션 기능이 있으면, 우리는 escape sequences 를 에뮬레이터에 보내어 터미널 창에서 똑같은 효과를 볼 수 있다.
큭
만약 당신이 컬러로 한 줄을 찍고 싶다면, 다음을 당신의 콘솔에서 실행해보아라.
echo "^[[0;31;40mIn Color" ^ 와 [ 의 두개의 문자처럼 보이는 첫번째 캐릭터는 이스케이프 캐릭터 이다. 저것을 찍어볼려면 CTRL+V키를 누르고나서 ESC 키를 누르면 된다. 다른 모든 문자들은 일반적으로 입력하는 것과 같다. 그리고 당신은 문자들인 붉은색으로 찍히는 걸 보게 될 것 이다. 따로 변경을 하지 않으면 계속 그 상태이고, 원래대로 돌아갈려면 다음을 입력하라.
echo "^[[0;37;40m" 자, 저 마술같은 캐릭터들이 뭘 의미할까? 이해하기 어려운가? 게다가 저 문자들은 터미널들이 다르다면 또 달라질 수도 있다. 그래서 UNIX 의 디자이너들은 termcap 이라 불리는 매커니즘을 발명했다. 그것은 각각의 터미널들의 기능과 거기에 따른 특정한 효과를 내기위한 escape sequence 들을 나열해 놓은 파일이다. 후에 이것은 terminfo 에 의해 대체되었다. 이 매커니즘의 개념을 간략히 얘기하자면, 어플리케이션 프로그램에서 terminfo 데이터베이스에 쿼리를 하여 터미널이나 터미널 에뮬레이터에 보낼 control 문자들을 얻어오게 하는 것이다.
[edit]
1.1.1 NCURSES 란 무엇인가? ¶아마 당신은 이 모든 기술적인 횡수들이 뭘 얘기하고자 하는 것인지 궁금할 것이다. 앞서에서 모든 어플리케이션 프로그램은 terminfo 를 쿼리하고 필요한 일들을 수행한다고 얘기했었다(control 문자들을 보내는 일 등등.). 이 복잡한 것을 다루는 것은 금방 어려워지며 이로 인해 'CURSES' 가 탄생하게 된다. Curses 는 "cursor optimization"을 재밌게 발음한 것이다. Curses 라이브러리는 raw 터미널코드 위에 wrapper 를 형성하고 있으며, 상당히 유연하고 효율적인 API(Application Programing Interface) 를 제공한다. 그것은 커서를 움직이거나, 윈도우를 생성하고, 색깔을 만들고, 마우스를 가지고 노는것 등의 함수를 제공한다. 어플리케이션 프로그램은 그 근간을 이루는 터미널의 기능에 대해서는 걱정할 필요가 없다.
자 그럼 NCURSES 는 무엇인가? NCURSES 는 원래의 System V Release 4.0(SVr4) curses 의 클론이다. 그것은 자유롭게 배포될수 있는 라이브러리이며, curses 의 구버전과 완벽히 호환된다. 쉽게말해 어플리케이션의 문자표현 -cell terminals 을 다루는 함수들의 라이브러리이다. 이제 이후로는 curses 와 ncurses 는 같은 뜻으로 쓰일 것이다.
ncurses 패키지는 원래 Pavel Curtis 에 의해 개발되었다. 이 패키지의 원 관리자는 Zeyd Ben-Halim <
zmbenhal_at_netcom.com> 이다. Eric S. Raymond <esr_at_snark.thyrsus.com> 는 1.8.1 버전에서 많은 새로운 기능을 추가하였다. Jürgen Pfeifer 는 menu 와 form 에 관련된 모든 코드는 물론 Ada95 에 대한 바인딩을 추가하였다. 현재 Thomas Dickey <dickey_at_herndon4.his.com> 와 Jürgen Pfeifer <juergen.pfeifer_at_gmx.net>
에 의해 개발이 진행되고 있다. Florian La Roche <florian_at_gnu.org> 는 ncurses 의 copyright 를 가진 Free Software Foundation 의 관리자로 활동하고 있다. 현재 관리자에게 메일을 보내기 위해서는 bug-ncurses_at_gnu.org로 연락하기 바란다.
[edit]
1.1.2 NCURSES 로 무엇을 할 수 있는가? ¶Ncurses 는 터미널 기능의 wrapper 를 만들어줄 뿐만 아니라 텍스트모드에서 멋진 UI (User Interface)를 만들수 있는 튼튼한 프레임웍도 제공한다. 그것은 윈도우등을 만들 수 있는 함수를 제공한다. 그것의 자매 라이브러리인 패널, 메뉴, 폼등은 기본적인 curses 라이브러리에 확장성을 제공한다. 이 라이브러리들은 보통 curses 와 같이 설치된다. 누구나 다중 윈도우와 메뉴, 패털 그리고 폼을 포함하고 있는 어플리케이션을 작성할 수 있다. 윈도우들은 각각 독립적으로 다뤄지며, 'scrollability' 기능도 있고, 심지어 hidden 될 수도 있다.
메뉴들은 사용자에게 쉬운 명령선택을 할 수 있게 해준다. 폼은 data entry 를 사용하는 것과 윈도우를 표현하는 것을 쉽게 해준다. 패널들은 겹쳐지거나 쌓인 윈도우들을 다룰 수 있게 ncurses 의 기능을 확장시켜 준다.
이것들은 우리가 ncurses 로 할 수 있는 기본적인 것들에 불과하다. 다음으로 넘어갈 수록 우리는 이 라이브러리들의 모든 기능들을 알게 될 것이다.
[edit]
1.1.3 어디서 그것을 구하는가? ¶자, ncurses로 어떤 일이 가능한지 알았으니, 써보고 싶어 근질근질하실 것 같다. ncurses 는 보통 설치할때 자동으로 깔린다. 만약 그것이 없거나, 당신만의 라이브러리로 컴파일하고 싶다면 아래를 계속 읽어보아라.
패키지 컴파일하기
ncurses 는
![[ftp]](/imgs/ftp.png) ftp://ftp.gnu.org/pub/gnu/ncurses/ncurses.tar.gz 나 http://www.gnu.org/order/ftp.html 에 나와있는 아무 ftp 사이트에서 얻을 수 있다. 최근 안정화 버전은 5.2 20001021 이다.
설치하는 방법을 자세히 알고자 한다면 README 와 INSTALL 파일을 읽어보아라. 보통 다음과 같은 작업들을 포함하고 있다.
tar zxvf ncurses<version>.tar.gz # unzip and untar the archive
cd ncurses<version> # cd to the directory
./configure # configure the build according to your
# environment
make # make it
su root # become root
make install # install it
RPM 을 이용한 설치
ncurses RPM 은
http://rpmfind.net 에서 찾아서 다운로드하면 된다. RPM 은 루트 권한으로 다음의 명령을 실행하면 설치가 된다.
rpm -i <downloaded rpm>
[edit]
1.1.4 문서의 목적 및 범위 ¶이 문서는 ncurses 와 그것의 자매 라이브러리로 프로그래밍 하는 데 있어 통합 가이드가 되는 것을 목표로 하고 있다. 단순한 "Hello World" 프로그램부터 더 복잡한 기능의 프로그램까지 다룰 것이다. ncurses 의 선행경험을 필요로 하지는 않는다.
[edit]
1.1.5 프로그램들에 대해 ¶문서에 있는 모든 프로그램들은
여기에서 압축된 형태로 받을 수 있다. 그것들의 압축을 풀고 tar 로 파일을 풀면 된다. 디렉토리 구조는 아래와 같다.
#! ncurses | |----> <a class='nonexistent' href='/wiki.php/JustForFun'>?</a>JustForFun -- just for fun programs |----> basics -- basic programs |----> demo -- output files go into this directory after make | | | |----> exe -- exe files of all example programs |----> forms -- programs related to form library |----> menus -- programs related to menus library |----> panels -- programs related to panels library |----> Makefile -- the top level Makefile |----> README -- the top level README file. contains instructions |----> COPYING -- copyright notice 각각의 디렉토리에 있는 파일들과 그 설명은 다음과 같다.
#!
<a class='nonexistent' href='/wiki.php/JustForFun'>?</a>JustForFun
|
|----> hanoi.c -- The Towers of Hanoi Solver
|----> life.c -- The Game of Life demo
|----> magic.c -- An Odd Order Magic Square builder
|----> queens.c -- The famous N-Queens Solver
|----> shuffle.c -- A fun game, if you have time to kill
|----> tt.c -- A very trivial typing tutor
basics
|
|----> acs_vars.c -- ACS_ variables example
|----> hello_world.c -- Simple "Hello World" Program
|----> init_func_example.c -- Initialization functions example
|----> key_code.c -- Shows the scan code of the key pressed
|----> mouse_menu.c -- A menu accessible by mouse
|----> other_border.c -- Shows usage of other border functions apa
| -- rt from box()
|----> printw_example.c -- A very simple printw() example
|----> scanw_example.c -- A very simple getstr() example
|----> simple_attr.c -- A program that can print a c file with
| -- comments in attribute
|----> simple_color.c -- A simple example demonstrating colors
|----> simple_key.c -- A menu accessible with keyboard UP, DOWN
| -- arrows
|----> temp_leave.c -- Demonstrates temporarily leaving curses mode
|----> win_border.c -- Shows Creation of windows and borders
|----> with_chgat.c -- chgat() usage example
forms
|
|----> form_attrib.c -- Usage of field attributes
|----> form_options.c -- Usage of field options
|----> form_simple.c -- A simple form example
|----> form_win.c -- Demo of windows associated with forms
menus
|
|----> menu_attrib.c -- Usage of menu attributes
|----> menu_item_data.c -- Usage of item_name() etc.. functions
|----> menu_multi_column.c -- Creates multi columnar menus
|----> menu_scroll.c -- Demonstrates scrolling capability of menus
|----> menu_simple.c -- A simple menu accessed by arrow keys
|----> menu_toggle.c -- Creates multi valued menus and explains
| -- REQ_TOGGLE_ITEM
|----> menu_userptr.c -- Usage of user pointer
|----> menu_win.c -- Demo of windows associated with menus
panels
|
|----> panel_browse.c -- Panel browsing through tab. Usage of user
| -- pointer
|----> panel_hide.c -- Hiding and Un hiding of panels
|----> panel_resize.c -- Moving and resizing of panels
|----> panel_simple.c -- A simple panel example
메인 디렉토리에 최상위 Makefile 이 있다. 그것은 모든 파일들을 빌드하고, 사용할 준비가된 실행파일들을 demo/exe 디렉토리에 넣어둔다. 또, 각각의 디렉토리에서 선택적으로 파일들을 메이크 할 수도 있다. 각 디렉토리는 거기에 있는 파일들의 용도가 무엇인지 설명하는 README 파일들이 있다.
모든 예제에서 나는 ncurses 디렉토리에 대한 상대 경로명을 쓰고 있다.
만약 각각의 프로그램 별로 보기를 원한다면,
http://tldp.org/HOWTO/NCURSES-Programming-HOWTO/ncurses_programs/ 에서 볼 수 있다.
모든 프로그램들은
GPL 하에 배포되며 당신은 그것을 당신이 원하는 대로 쓸 수 있다.
[edit]
1.1.6.2 소스로 부터 빌드하기 ¶만약 위의 링크들이 깨졌거나 sgml 파일로 무언가를 해보고 싶다면 이 절을 읽어보기 바란다.
sgml 문서 소스와 tar 와 gzip 으로 묶인 프로그램을 아래의 링크에서 다운받는다.
http://cvsview.tldp.org/index.cgi/LDP/howto/docbook/
NCURSES-HOWTO/NCURSES-Programming-HOWTO.sgml
http://cvsview.tldp.org/index.cgi/LDP/howto/docbook/
NCURSES-HOWTO/ncurses_programs.tar.gz
ncurses_programs.tar.gz 파일의 압축을 푼다
tar zxvf ncurses_programs.tar.gz jade 프로그램을 사용하여 다양한 포맷의 문서를 만들어 낸다. 예를 들어 여러 개의 문서로 나누어진 html 파일을 생성하고 싶다면 아래와 같이 입력해 보자.
jade -t sgml -i html -d <docbook html 스타일 시트의 경로> NCURSES-Programming-HOWTO.sgml pdf 문서를 생성하려면 먼저 하나의 문서로 된 html 파일을 생성한다.
jade -t sgml -i html -d <docbook html 스타일 시트의 경로> -V nochunks NCURSES-Programming-HOWTO.sgml > NCURSES-ONE-BIG-FILE.html then use htmldoc to get pdf file with
그리고 htmldoc 을 사용하여 pdf 파일을 생성한다.
htmldoc --size universal -t pdf --firstpage p1 -f <output file name.pdf> NCURSES-ONE-BIG-FILE.html ps 파일을 생성하기 위해서는 다음과 같이 입력한다.
htmldoc --size universal -t ps --firstpage p1 -f <출력 파일 이름> NCURSES-ONE-BIG-FILE.html 자세한 사항은
http://www.tldp.org/LDP/LDP-Author-Guide/ 문서를 참조하기 바란다. 만약 문서 생성에 실패한 경우에는 p_padala_at_yahoo.com 으로 메일을 보내주기 바란다.
[edit]
1.1.7 크레디트 ¶I thank Sharath <
sharath_1_at_usa.net> and Emre Akbas for helping me with
few sections. The introduction was initially written by sharath. I rewrote it
with few excerpts taken from his initial work. Emre helped in writing printw
and scanw sections.
Then comes Ravi Parimi <
parimi_at_ece.arizona.edu>, my dearest friend,
who has been on this project before even one line was written. He constantly
bombarded me with suggestions and patiently reviewed the whole text. He also
checked each program on Linux and Solaris. See his notes to check on your
problems.
[edit]
1.1.8 Wish List ¶This is the wish list, in the order of priority. If you have a wish or you
want to work on completing the wish, mail
p_padala_at_yahoo.com me.
ashoknn_at_cisco.com N.N.Ashok is working on it)
[edit]
1.1.9 Copyright ¶Copyright (c) 2001 by Pradeep Padala. This document may be distributed under
the terms set forth in the LDP license at [
http://www.linuxdoc.org/
COPYRIGHT.html] linuxdoc.org/COPYRIGHT.html.
This HOWTO is free documentation; you can redistribute it and/or modify it
under the terms of the LDP license. This document is distributed in the hope
that it will be useful, but without any warranty; without even the implied
warranty of merchantability or fitness for a particular purpose. See the LDP
license for more details.
[edit]
1.2 The Hello World 프로그램 ¶curses 의 세계에 온 걸 환영한다. 라이브러리로 뛰어들어 그것의 다양한 특징들을 살펴보기 전에, bells and whistles, 세계에 안녕을 표하는 간단한 프로그램을 만들어보자.
[edit]
1.2.1 Ncurses 라이브러리와 같이 컴파일 하기 ¶ncurses 라이브러리의 함수들을 쓰기 위해선 ncurses.h 가 인클루드 되어야 하고 프로그램을 ncurses 와 링크시키는 -lncurses 플래그가 더해져야 한다.
ncurses.h 는 stdio.h 에 이미 인클루드 되어 있다.
#include <ncurses.h>
.
.
.
compile and link: gcc <program file> -lncurses
Example 1. The Hello World !!! Program
#include <ncurses.h>
int main()
{
initscr(); /* Start curses mode */
printw("Hello World !!!"); /* Print Hello World */
refresh(); /* Print it on to the real screen */
getch(); /* Wait for user input */
endwin(); /* End curses mode */
return 0;
}
[edit]
1.2.2 분석 ¶위 프로그램은 화면에 "Hello World !!!" 를 찍고 종료한다. 이 프로그램은 어떻게 curses 를 초기화 하고, 스크린을 다루는지 또 어떻게 curses 모드를 종료하는지 보여준다. 자 이제 한줄 한줄 분석해보자.
[edit]
1.2.2.1 initscr() 에 대해 ¶initscr() 함수는 curses mode 로 터미널을 초기화 한다. 몇몇 구현에서는 화면을 클리어하고 빈 화면을 보여주기도 한다. curses 패키지를 이용해서 스크린 처리를 할려면 이 함수를 반드시 먼저 콜해야 한다. 이 함수는 curses 시스템을 초기화 하고 'stdscr' 이라 불리는 우리의 현재 윈도우와 몇몇 데이터들-구조체- 들을 위한 메모리를 할당한다. 아주 극한 상황에서나 이 함수는 curses 라이브러리의 데이터 구조체를 위한 메모리를 할당실패로 에러는 낼 것이다.
이것이 수행된 후 우리는 curses 세팅을 편의에 맞추기위한 다양한 초기화를 할 수 있다. 여기에 대한 상세 설명은 차차 다루기로 한다.
[edit]
1.2.2.2 신기한 refresh() ¶다음 줄의 printw 는 "Hello World !!!" 를 화면에 찍는다. 이 함수는 stdscr 이라 불리는 윈도우 내에 (y,x)위치에 데이터를 찍는다는 점을 제외하고는 printf 함수와 비슷하다. 위 프로그램에서는 커서위치가 0,0 이기 때문에 윈도우의 왼쪽 맨 위 구석에 스트링을 찍게 된다.
다음은 신비한 refresh() 함수를 볼 차례이다. 우리가 printw 함수를 호출하면 사실상 데이터는 stdscr 이란 불리는 가상의 윈도우에만 쓰여지고 화면에는 아직 나타나지 않는다. printw 가 하는 일은 몇몇 플래그들과 데이터 구조체들을 갱신하고 stdscr 에 해당하는 버퍼에 데이터들을 쓰는 것이다. 그것을 화면에 표시하기 위해서는 refresh() 함수를 호출하여 curses 시스템이 그 버퍼의 내용들을 화면에 나타내도록 해야 한다.
여기엔 프로그래머가 가상의 스크린이나 윈도우에 여러번 갱신을 한다음 한번의 refresh 로 화면을 전부 갱신한다는 철학이 깔려 있다. refresh() 함수는 윈도우를 확인하고 변화된 부분만 갱신한다. 이것은 빠른 반응속도와 훨씬 좋은 유연함을 제공한다. 그러나 초보자에게는 조금 혼란스러운 면이 있다. 초보자들이 행하는 일반적인 실수는 printw() 류의 함수들을 써서 작업을 한다음 refresh() 를 까먹곤 한다는 것이다. 나 또한 여전히 이걸 때때로 까먹곤 한다
[edit]
1.2.2.3 endwin() 에 대해 ¶그리고 최종적으로 curses 모드를 끝내는 걸 잊어서는 안된다. 그렇지않으면 프로그램 종료 후에 당신의 터미널은 이상하게 작동할 것이다. endwin() 함수는 curses 의 하위 시스템들과 데이터 구조체가 점유했던 메모리를 해제하고 터미널을 일반적인 모드로 바꿔 놓는다. 이 기능은 curses 모드에서 작업을 마치게 되면 반드시 호출해야 한다.
[edit]
1.3 The Gory Details ¶자 이제 우리는 간단한 curses 프로그램을 어떻게 작성하는지 살펴보았다. 이제 좀 더 상세한 것들을 알아보자. 당신이 화면에서 보는 것들을 바꿀 수 있는 많은 함수들이 있으면 앞으로 많이 사용될 다양한 특징들이 있다.
자 시작합니다...
[edit]
1.4 초기화 ¶우리는 이제 curses 시스템을 초기화 하기 위해서는 initscr() 함수를 호출해야 한다는 것을 안다. 이 초기화 이후에 curses 세션을 설정하기 위해 호출할 수 있는 함수들이 더 있다. 이걸 통해 우리는 curses 시스템에 터미널을 raw 모드로 세팅해달라고 하거나 색을 초기화 하거나 마우스등을 초기화 할 수도 있다. 그럼 initscr() 함수 이후에 보통 호출되는 함수들에 어떤것들이 있는지 살펴보도록 하자.
[edit]
1.4.2 raw() 와 cbreak() ¶보통 터미널 드라이버는 new line 이나 캐리지리턴이 들어올 때까지 사용자가 입력한 내용을 버퍼링한다. 그러나 대부분의 프로그램들은 사용자가 타이핑을 하고나서 될 수 있는 한 빨리 그 문자들을 필요로 한다. 위의 두 함수는 라인 버퍼링을 비활성화 시키는 데 자주 사용된다. 이 두 함수의 차이점은 suspend (CTRL-Z) 나 interrupt 그리고 quit (CTRL-C) 와 같은 control 문자들이 프로그램에 전달되는 방법에 있다. raw() 모드에서 이 control 문자들은 signal 을 발생시키지 않고 바로 프로그램에 전달된다. cbreak() 모드에서 이 control 문자들은 터미널 드라이버에 의해 다른 어떤 문자로 번역된다. 나는 개인적으로 사용자들을 보다 더 잘 제어하는 연습을 하기 위해서 raw() 를 애용하는 편이다.
[edit]
1.4.3 echo() 와 noecho() ¶이 함수들은 사용자들이 터미널에 입력한 문자들을 echoing 할 것인지 제어한다. echoing 에 대한 더 많은 제어를 하기 위해서나 또는 getch() 등의 함수로 사용자들에게서 입력을 받고 있을 때 불필요한 echoing 을 없애기 위해서 이 함수들이 필요할 것이다. 대부분의 인터랙티브한 프로그램들은 noecho() 를 초기화때 호출하고 필요할때면 제어를 통해 echoing 을 한다. 이렇게 하면 프로그래머는 윈도우의 (y,x) 의 위치를 굳이 갱신시키지 않더라도 필요한 위치에 문자들을 echoing 할수 있는 융통성을 가지게 된다.
[edit]
1.4.4 keypad() ¶이 함수는 내가 좋아하는 초기화 함수중 하나이다. 이것은 F1, F2, 방향키 같은 기능키들을 입력받을 수 있게 한다. 방향키들은 어떠한 사용자 인터페이스에서도 큰 비중을 차지하듯이, 거의 모든 인터랙티브한 프로그램들은 이 기능들을 필요로 한다. keypad(stdscr, TRUE) 를 호출하는 것은 일반 화면인 (stdscr) 에서 이 기능을 쓰게 한다. 이 문서의 차후 섹션에서 더 많은 키 사용법을 배우게 될 것이다.
[edit]
1.4.5 halfdelay() ¶이 함수는 자주 쓰이지는 않지만 때론 매우 유용하게 쓰인다. halfdelay() 함수는 타이핑된 문자들이 프로그램에서 바로 사용가능하게 하는 cbreak() 모드와 비슷한 half-delay 모드를 쓰게 한다. 그러나 이 함수는 입력에 대해서 십분의 'X' 초 만큼 기다리며 만약 아무 입력이 없다면 ERR 을 리턴한다. 'X' 는 halfdelay() 함수에 전달되는 타임아웃 값이다. 이 함수는 당신이 사용자에게 입력을 요구하고 만약 특정 시간 동안 입력이 없다면 다른 어떤 작업을 할때에 사용된다. 패스워드 프롬프트 등에서 타임아웃이 있는 것등이 그 좋은 예이다.
[edit]
1.4.6 그외 잡다한 초기화 함수들 ¶위에서 얘기한 것 말고도 커서의 움직임을 설정하는 초기화 함수들이 좀 더 있다. 그러나 그것들은 위에서 언급한 것들만큼 잘 쓰이지 않는다. 이 중 몇몇은 부록에서 설명할 것이다.
[edit]
1.4.7 예제 ¶이 함수들의 사용법을 명확히 이해할 수 있는 프로그램을 짜보자.
Example 2. Initialization Function Usage example
#include <ncurses.h>
int main()
{ int ch;
initscr(); /* Start curses mode */
raw(); /* Line buffering disabled */
keypad(stdscr, TRUE); /* We get F1, F2 etc.. */
noecho(); /* Don't echo() while we do getch */
printw("Type any character to see it in bold\n");
ch = getch(); /* If raw() hadn't been called
* we have to press enter before it
* gets to the program */
if(ch == KEY_F(1)) /* Without keypad enabled this will */
printw("F1 Key pressed");/* not get to us either */
/* Without noecho() some ugly escape
* charachters might have been printed
* on screen */
else
{ printw("The pressed key is ");
attron(A_BOLD);
printw("%c", ch);
attroff(A_BOLD);
}
refresh(); /* Print it on to the real screen */
getch(); /* Wait for user input */
endwin(); /* End curses mode */
return 0;
}
이 프로그램은 자체 주석이 되어 있다. 그러나 아직 설명하지 않은 함수가 하나 있는데, 사용자로부터 문자를 입력받는 getch() 함수가 그것이다. 이 함수는 입력후 <enter> 를 피하기 위해 라인 버퍼링을 해제할 수 있다는 것을 제외하면 getchar() 함수와 동일하다. getch() 의 더 많은 정보와 키를 입력받는 것에 대해서는 key management 섹션을 참고하길 바란다. attron 과 attroff 함수는 어떤 특성을 끄고 켜기 위해 사용된다. 예제에서는 문자를 bold 체로 찍기위해 사용하였다. 이 함수들도 후에 자세히 설명한다.
[edit]
1.5 윈도우에 관해 ¶ncurses 의 무수한 함수들로 뛰어들기 전에, 윈도우 에 대해 몇가지만 명확히 하도록 하자. 윈도우의 자세한 사항에 대해서는 다음 섹션에서 설명할 것이다.
윈도우는 curses 시스템에 의해 정의된 가상 화면이다. 그러나 윈도우는 당신이 Win9X 플랫폼에서 흔히 보던 테두리가 있는 창을 뜻하지는 않는다. curses 가 초기화될 때, 당신의 80x25 (또는 현재 실행되는 창의 크기만큼) 스크린을 의미하는 stdscr 이라는 기본 윈도우가 생성된다. 만약 당신이 몇몇 스트링을 찍거나, 입력을 받는 등의 간단한 작업들을 할 것이라면, 이 기본 윈도우만 써도 된다. 반면 창을 생성해서, 그 특정 윈도우에서 깔끔히 작동할 함수들을 호출해도 된다.
예를 들어, 만약 당신이 아래를 호출한다면
printw("Hi There !!!");
refresh();
이것은 stdscr 의 현재 커서 위치에 스트링을 찍을 것이다. 비슷하게 refresh() 함수 호출 또한 stdscr 에서만 작동할 것이다.
당신이 만약 윈도우를 만들었다면, 보통함수 이름 앞에 'w' 가 붙은 함수들을 호출해야만 한다.
wprintw(win, "Hi There !!!");
wrefresh(win);
문서의 나머지 부분에서 배울 것이지만, 함수의 이름은 같은 작명법을 따른다. 각각의 함수에는 보통 비슷한 세개의 함수가 더 있다.
printw(string); /* Print on stdscr at present cursor position */
mvprintw(y, x, string);/* Move to (y, x) then print string */
wprintw(win, string); /* Print on window win at present cursor position */
/* in the window */
mvwprintw(win, y, x, string); /* Move to (y, x) relative to window */
/* co-ordinates and then print */
보통 w 가 붙지 않은 함수는 윈도우 파라메터로 stdscr 을 사용하는 w 가 붙은 함수들에 대한 매크로이다.
[edit]
1.6 printw() 같은 출력 함수에 대해 ¶아마 당신은 이제 무언가를 하고 싶어 안달이 났을 것 같다. curses 함수들의 모험으로 다시 돌아가자. 자 이제 curses 는 초기화 되었다면, 세계와 interact 를 해보자.
화면에 출력을 하는 함수에는 크게 세종류가 있다.
[edit]
1.6.1 addch() 류의 함수들 ¶이 함수들은 현재 커서 위치에 한 문자를 찍고 커서의 위치를 다음으로 옮긴다. 당신은 이걸 통해 문자를 찍을 수도 있지만, 보통 이 함수들은 몇몇 속성이 있는 문자들을 찍을 때 쓰인다. 속성에 대한 자세한 설명은 뒤에 다루고 있다. 만약 문자에 어떠한 속성들 (굵은 글씨, 반전색 등등) 이 결합되어 있다면 curses 가 그 문자를 출력할때 그 속성에 맞게 출력하게 된다.
문자에 특정 속성들을 넣으려면 다음의 두가지 방법이 있다.
addch(ch | A_BOLD | A_UNDERLINE);
[edit]
1.6.2 mvaddch(), waddch() 와 mvwaddch() ¶mvaddch() 함수는 커서를 주어진 위치로 옮기고 문자를 출력한다. 다음과 같이 쓴다.
move(row,col); /* moves the cursor to rowth row and colth column */
addch(ch);
can be replaced by
mvaddch(row,col,ch);
waddch() 함수는 addch() 와 비슷하다. 단 주어진 윈도우에 문자를 찍는다는 점을 제외하곤 말이다. (addch() 함수는 stdscr 윈도우에 문자를 찍는다는 것에 주의하라.)
이와 유사하게 mvwaddch() 함수도 주어진 윈도우내에서 주어진 위치에 문자를 찍을 때 사용된다.
자 우리는 기본적인 출력 함수인 addch() 에 대해 알아보았다. 그런데 만약 우리가 스트링을 찍길 원한다면 한글자씩 찍는 것은 매우 번거로운 일이 될 것이다. 운좋게도 ncurses 는 printf 류나 puts 류의 함수들을 제공한다.
[edit]
1.6.3.1 printw() 와 mvprintw ¶이 두개의 함수는 printf() 와 작동법이 유사하다. mvprintw() 는 커서를 특정위치로 옮기고 출력할때 쓰인다. 만약 당신이 커서를 일단 먼저 옮기고 그 후에 printw() 함수로 출력을 하고자 한다면, move() 함수를 먼저 쓰고 printw() 함수를 쓰면된다. 이런 경우엔 mvprintw() 함수를 쓰면 되겠지만, 아무튼 당신이 원하는 대로 융통성있게 작성할 수 있다.
[edit]
1.6.3.4 간단한 printw 예제 ¶Example 3. A Simple printw example
#include <ncurses.h> /* ncurses.h includes stdio.h */
#include <string.h>
int main()
{
char mesg[]="Just a string"; /* message to be appeared on the screen */
int row,col; /* to store the number of rows and *
* the number of colums of the screen */
initscr(); /* start the curses mode */
getmaxyx(stdscr,row,col); /* get the number of rows and columns */
mvprintw(row/2,(col-strlen(mesg))/2,"%s",mesg);
/* print the message at the center of the screen */
mvprintw(row-2,0,"This screen has %d rows and %d columns\n",row,col);
printw("Try resizing your window(if possible) and then run this program again");
refresh();
getch();
endwin();
return 0;
}
위 프로그램은 printw 함수를 사용하는 것이 얼마나 쉬운지 보여주고 있다. 단지 위치와 화면에 나타날 메세지를 넘겨주기만 하면 된다.
위 프로그램에는 ncurses.h 에 정의된 매크로 함수 getmaxyx() 가 사용되었다. 이 함수는 주어진 윈도우의 행과 열의 최대값을 구해서 리턴한다. getmaxyx() 함수는 주어진 변수의 값을 갱신하게 되는데, 이유는 우리가 그 함수에 변수에대한 포인터를 넘겨준 것이 아니라 단지 변수를 넘겨줬기 때문이다.
[edit]
1.6.4 addstr() 류의 함수들 ¶addstr() 함수는 주어진 윈도우에 문자열을 찍을 때 사용한다. 이것은 주어진 문자열의 각 문자에 대해 addch() 를 매번 호출하는 것과 유사한데, 이는 모든 출력 함수들에 대해서도 마찬가지이다. 여기에도 curses 의 작명법을 따르는 mvaddstr(), mvwaddstr(), waddstr() 등의 유사함수들이 있다.(e.g. mvaddstr() 함수는 move() 를 호출하고나서 addstr() 을 호출하는 것과 같다.) 이외에도 정수 인자(n 이라하자) 를 추가로 받는 addnstr() 이라는 함수가 있는데, 이 함수는 최대 n 개의 문자를 화면에 출력한다. 만약 n 이 음수라면, 문자열을 모두 찍게된다.
[edit]
1.6.5 주의 사항 ¶이 함수들은 전부 y 위치 값을 먼저 인자로 받고 그 뒤에 x 를 받는다. 초보자가 흔히 하는 실수중 하나가 x,y 순서로 값을 전달하는 것이다. 만약 당신이 (y,x) 좌표로 많은 작업을 해야 한다면, 스크린을 윈도우로 나눠서 각각을 따로 처리하는 방법을 생각해 보도록 하여라. 윈도우즈는 windows 섹션에서 다루고 있다.
[edit]
1.7 scanw() 같은 입력함수에 대해 ¶입력 없이 출력만 하는 것은 지루하지 않은가? 이제 사용자로부터 입력을 받는 함수들을 알아보도록 하자. 이 함수들도 역시 세개의 큰 분류로 나눌 수 있다.
[edit]
1.7.1 getch() 류의 함수들 ¶이 함수들은 터미널로 부터 문자 하나를 입력받는다. 그러나 여기에는 반드시 짚고 넘어가야할 몇몇 문제가 있다. 예를 들어 만약 cbreak() 함수를 사용하지 않는다면, curses 는 당신의 입력문자들을 연속으로 읽지 않고 new line 이나 EOF 문자가 들어왔을 때만 입력을 읽기 시작할 것이다. 이것을 막기 위해서는 cbreak() 함수를 반드시 사용해서 프로그램에서 문자들을 즉각 활용하게 해야한다. 또 다른 널리 사용되는 함수는 noecho() 이다. 이름에서 알 수 있듯이, 이 함수가 설정되면 사용자들이 누른 키의 문자가 화면에 나타나지 않는다. cbreak() 와 noecho() 두 함수는 키 관리의 전형적인 예이다. 이런 류의 함수들은 key management 섹션에서 설명하고 있다.
[edit]
1.7.2.1 scanw() 와 mvscanw ¶이 함수들의 사용법은 sscanf() 함수와 비슷한데, 입력받을 줄이 wgetstr() 함수에 의해 제공된다. 즉 이 함수들은 wgetstr() 함수 (아래에서 설명함) 을 호출하고 그 결과로 받은 줄을 스캔에 사용한다.
[edit]
1.7.3 getstr() 류의 함수들 ¶이 함수들은 터미널로 부터 문자열을 입력받을 때 사용된다. 본질적으론 이 함수는 getch() 함수를 newline, 캐리지리턴, EOF 를 받을때 까지 계속 호출하는 것과 같은 일을 한다. 결과 문자열은 사용자가 제공한 문자열 포인터인 str 변수에 저장된다.
[edit]
1.7.4 몇몇 예제 ¶Example 4. A Simple scanw example
#include <ncurses.h> /* ncurses.h includes stdio.h */
#include <string.h>
int main()
{
char mesg[]="Enter a string: "; /* message to be appeared on the screen */
char str[80];
int row,col; /* to store the number of rows and *
* the number of colums of the screen */
initscr(); /* start the curses mode */
getmaxyx(stdscr,row,col); /* get the number of rows and columns */
mvprintw(row/2,(col-strlen(mesg))/2,"%s",mesg);
/* print the message at the center of the screen */
getstr(str);
mvprintw(LINES - 2, 0, "You Entered: %s", str);
getch();
endwin();
return 0;
}
[edit]
1.8 속성 ¶우리는 문자를 출력할때 특별한 효과를 주기위해서 속성을 어떻게 사용하는지 이미 알아본 적이 있다. 속성은 잘 사용하기만 하면 정보를 쉽고 이해하기 좋게 표현할 수가 있다. 다음 프로그램은 C 파일을 입력으로 읽어 주석들을 굵게 표현한다. 코드를 살펴보도록 하자.
Example 5. A Simple Attributes example
#include <ncurses.h>
int main(int argc, char *argv[])
{
int ch, prev;
FILE *fp;
int goto_prev = FALSE, y, x;
if(argc != 2)
{ printf("Usage: %s <a c file name>\n", argv[0]);
exit(1);
}
fp = fopen(argv[1], "r");
if(fp == NULL)
{ perror("Cannot open input file");
exit(1);
}
initscr(); /* Start curses mode */
prev = EOF;
while((ch = fgetc(fp)) != EOF)
{ if(prev == '/' && ch == '*') /* If it is / and * then olny
* switch bold on */
{ attron(A_BOLD);
goto_prev = TRUE; /* Go to previous char / and
* print it in BOLD */
}
if(goto_prev == TRUE)
{ getyx(stdscr, y, x);
move(y, x - 1);
printw("%c%c", '/', ch); /* The actual printing is done
* here */
ch = 'a'; /* 'a' is just a dummy
* character to prevent */
// "/*/" comments.
goto_prev = FALSE; /* Set it to FALSE or every
* thing from here will be / */
} else
printw("%c", ch);
refresh();
if(prev == '*' && ch == '/')
attroff(A_BOLD); /* Switch it off once we got *
and then / */
prev = ch;
}
getch();
endwin(); /* End curses mode */
return 0;
}
저 초기화들과 다른 쓸데 없는 것들은 신경쓰지 말고, while 루프 에만 집중해라. 그것은 파일에서 문자들을 읽어서 /* 와 같은 패턴을 찾는다. 한번 패턴을 찾게되면 attron() 함수를 써서 BOLD 속성을 켠다. 그 후 */ 패턴을 찾으면 attroff() 로 속성을 다시 끄게 된다.
또한 위 프로그램은 getyx() 와 move() 라는 유용한 함수들도 소개해주고 있다. 첫번째 함수는 현재 커서의 위치에 해당하는 값을 변수 y, x 에 저장한다. getyx() 함수는 매크로 함수이기 때문에 변수에 대한 포인터를 전달할 필요가 없다. move() 함수는 커서를 주어진 위치로 옮기는 함수이다.
위 프로그램은 그다지 많은 일을 하지 않는 정말 간단한 것이다. 이 코드 위에 C 파일을 읽고 그것을 파싱해서 서로 다른 색으로 출력하는 보다 더 유용한 기능을 추가해 볼 수도 있을 것이다. 또한 저것을 다른 언어들에 대해서도 확장해 볼 수 있을 것이다.
[edit]
1.8.1 세부 사항 ¶속성에 대해 좀 더 자세히 알아보도록 하자. attron(), attroff(), attrset() 및 그외 attr_get() 등의 함수들은 속성을 끄고 켜거나, 속성을 가져오고 컬러풀한 화면을 만들어내는데 쓰인다.
attron 과 attroff 함수는 속성들에 대한 bit-mask 를 가지고 그것들을 껐다 켰다 한다. <curses.h> 에 정의되어 있는 다음의 비디오 속성들이 이 함수에 쓰일 수 있다.
#!
A_NORMAL Normal display (no highlight)
A_STANDOUT Best highlighting mode of the terminal.
A_UNDERLINE Underlining
A_REVERSE Reverse video
A_BLINK Blinking
A_DIM Half bright
A_BOLD Extra bright or bold
A_PROTECT Protected mode
A_INVIS Invisible or blank mode
A_ALTCHARSET Alternate character set
A_CHARTEXT Bit-mask to extract a character
COLOR_PAIR(n) Color-pair number n
마지막 것이 가장 화려한 것중 하나다. 색상들(#color)은 다음 섹션에서 설명한다.
여러 효과를 겹쳐낼려면 위의 아무 값들을 OR(|) 연산을 하면 된다. 만약 반전되고 깜빡이는 문자들을 원한다면 다음처럼 해라.
attron(A_REVERSE | A_BLINK);
[edit]
1.8.2 attron() 대 attrset() ¶그럼 대체 attron() 함수와 attrset() 함수의 차이는 무엇일까? attron 이 그것에 주어진 속성만을 켤 수 있는데 반해 attrset 은 윈도우의 속성들을 설정할 수 있다. 즉 attset() 는 윈도우가 현재 어떤 속성을 가지고 있는지 상관없이 새 속성들을 설정할 수 있다. attroff() 또한 그것에 인자로 주어진 속성만을 끌 수 있다. 이런 기능은 속성을 쉽게 다룰 수 있는 유용함을 제공하는 반면, 만약 당신이 주의깊게 그것을 사용하지 않는다면 윈도우가 어떤 속성을 가지고 있는지 놓칠 수도 있고 화면표시를 모두 망칠 수도 있을 것이다. 이것 특히 메뉴를 다룰때에 잘 일어나는 문제다. 그러니 미리 속성에 대한 정책을 세워놓고 그것을 고수하도록 하라. 아 또한 모든 속성을 끄고 일반 모드로 돌려놓는 attrset(A_NORMAL) 함수와 동일한 기능의 standend() 함수를 언제든지 호출할 수도 있다.
[edit]
1.8.3 attr_get() ¶attr_get() 함수는 윈도우의 현재 속성과 색상들 값을 얻어온다. 비록 위 함수들만큼 자주 쓰지는 않겠지만, 이것은 스크린의 영역들을 스캔하는데 유용하다. 예를들어 스크린에 복잡한 변경을 가해야 되는데, 각각의 문자들이 어떤속성을 가지고 있는지 확실하지 않다고 하자. 이 경우에 attrset 또는 attron 등의 원하는 효과를 내는 함수들과 함께 이 함수를 써서 해결할 수 있다.
[edit]
1.8.4 attr_ 함수들 ¶attr_set(), attr_on 과 같은 류의 함수들이 더 있다. 이것들은 attr_t 타입의 인자를 받는다는 걸 제외하면 위의 함수들과 비슷하다.
[edit]
1.8.5 wattr 함수들 ¶위에서 얘기한 각각의 함수에 대해서 특정 윈도우에서 작동하는 이름에 'w' 가 붙은 함수들이 있다. 위의 함수들은 stdscr 에서 작동하는 것들이다.
[edit]
1.8.6 chgat() 함수들 ¶chgat() 함수는 curs_attr 의 man 페이지의 맨 끝에 나열되어 있다. 그러나 사실 이건 유용한 함수중 하나다. 이 함수는 움직이지 않고 문자들의 그룹에 속성을 설정할 수 있다. 커서 말이다. 그것을 움직이지 않고 가능하다. 이 함수는 현재 커서 위치에서 시작하는 문자들에서 주어진 수만큼의 속성을 변경한다.
줄의 끝까지 변경할려면 문자의 갯수에 -1 을 주면된다. 만약 현재 위치에서 줄의 끝까지 문자들의 속성들 바꾸고자 한다면 다음 처럼 해라.
chgat(-1, A_REVERSE, 0, NULL);
이 함수는 이미 화면에 나타나 있는 글자들의 속성을 바꾸는데 유용하다. 바꾸고자 하는 것의 시작위치로 커서를 옮긴다음 속성을 바꿔라.
다른 wchgat(), mvchgat(), wchgat() 이런 함수들도 w 로 시작하는 함수들이 특정 윈도우에서 작동한다는 것을 제외하면 위와 비슷하게 돌아간다. mv 로 시작하는 함수는 먼저 커서를 옮기고 주어진 일을 한다. 사실 chgat 함수는 wchgat() 함수에 stdscr 을 윈도우로 넘겨주는 매크로 함수 이다. 대부분의 w 로 시작하지 않는 함수들은 매크로 함수들이다.
Example 6. Chgat() Usage example
#include <ncurses.h>
int main(int argc, char *argv[])
{ initscr(); /* Start curses mode */
start_color(); /* Start color functionality */
init_pair(1, COLOR_CYAN, COLOR_BLACK);
printw("A Big string which i didn't care to type fully ");
mvchgat(0, 0, -1, A_BLINK, 1, NULL);
/*
* First two parameters specify the position at which to start
* Third parameter number of characters to update. -1 means till
* end of line
* Forth parameter is the normal attribute you wanted to give
* to the charcter
* Fifth is the color index. It is the index given during init_pair()
* use 0 if you didn't want color
* Sixth one is always NULL
*/
refresh();
getch();
endwin(); /* End curses mode */
return 0;
}
이 예제는 curses 의 색상들에 대해 보여주고 있다. 색상에 관해서는 후에 자세히 다룬다. 색을 사용하지 않으려면 0 값을 넣으면 된다.
[edit]
1.9 윈도우 함수의 모든 것 ¶윈도우는 curses 에서 가장 중요한 개념이다. 이미 당신은 모든 함수들이 은연중에 작동하는 stdscr 이라는 표준 윈도우에 대해 알고 있을 것이다. 자 이제 가장 간단한 GUI 를 만든다고 해도 당신은 윈도우를 필요로 할 것이다. 윈도우를 써야하는 주된 이유중 하나는 스크린의 일부만 따로 처리함으로서 바뀌어야할 필요가 있는 윈도우들만 변경하게되어 효율성을 높일 수 있다는 것이다. 또 보다 더 나은 디자인이 필요할 때도 마찬가지 이다. 난 윈도우를 사용하는 제일 중요한 이유는 후자라고 말하고 싶다. 당신은 당신의 프로그램에서 항상 더 낫고 더 다루기 쉬운 디자인을 갈구할 것이다. 만약 당신이 크고 복잡한 GUI 를 만든다면 이것은 다른 무엇보다 선행하는 핵심적인 중요 요소이다.
[edit]
1.9.1 개괄 ¶윈도우는 newwin() 함수를 호출해서 만들 수가 있다. 이것은 사실상 화면에는 아무것도 생성하지 않는다. 이 함수는 윈도우를 처리하기 위한 구조체의 메모리를 할당받고 그 윈도우에 해당하는 크기, 시작x위치, 시작y위치 등의 정보를 갱신한다. 이렇기 때문에 curses 에서 윈도우는 단지 화면의 다른 부분과 독립적으로 처리할 수 있는 가상의 윈도우의 abstraction 이다. newwin() 함수는 WINDOW 에 대한 포인터를 리턴한다. 이 포인터는 wprintw() 등과 같이 윈도우와 관련된 함수에 인자로 넘겨질 수 있다. 최종적으로 윈도우는 delwin() 함수에 의해 파괴될 수 있다. 이 함수는 윈도우 구조체에 할당되어 있는 메모리 영역을 해제할 것이다.
[edit]
1.9.2 윈도우가 있으라 !!! ¶윈도우가 생성되었고 우리가 그것을 볼 수가 없다면 웃기지 않을까. 이제 재밌는 윈도우 나타내기가 시작된다. box() 함수는 윈도우의 테두리를 그리는데 쓸 수 있다. 예제를 통해 이 함수들을 보다 자세하게 둘러보도록 하자.
Example 7. Window Border example
#include <ncurses.h>
WINDOW *create_newwin(int height, int width, int starty, int startx);
void destroy_win(WINDOW *local_win);
int main(int argc, char *argv[])
{ WINDOW *my_win;
int startx, starty, width, height;
int ch;
initscr(); /* Start curses mode */
cbreak(); /* Line buffering disabled, Pass on
* everty thing to me */
keypad(stdscr, TRUE); /* I need that nifty F1 */
height = 3;
width = 10;
starty = (LINES - height) / 2; /* Calculating for a center placement */
startx = (COLS - width) / 2; /* of the window */
printw("Press F1 to exit");
refresh();
my_win = create_newwin(height, width, starty, startx);
while((ch = getch()) != KEY_F(1))
{ switch(ch)
{ case KEY_LEFT:
destroy_win(my_win);
my_win = create_newwin(height, width, starty,--startx);
break;
case KEY_RIGHT:
destroy_win(my_win);
my_win = create_newwin(height, width, starty,++startx);
break;
case KEY_UP:
destroy_win(my_win);
my_win = create_newwin(height, width, --starty,startx);
break;
case KEY_DOWN:
destroy_win(my_win);
my_win = create_newwin(height, width, ++starty,startx);
break;
}
}
endwin(); /* End curses mode */
return 0;
}
WINDOW *create_newwin(int height, int width, int starty, int startx)
{ WINDOW *local_win;
local_win = newwin(height, width, starty, startx);
box(local_win, 0 , 0); /* 0, 0 gives default characters
* for the vertical and horizontal
* lines */
wrefresh(local_win); /* Show that box */
return local_win;
}
void destroy_win(WINDOW *local_win)
{
/* box(local_win, ' ', ' '); : This won't produce the desired
* result of erasing the window. It will leave it's four corners
* and so an ugly remnant of window.
*/
wborder(local_win, ' ', ' ', ' ',' ',' ',' ',' ',' ');
/* The parameters taken are
* 1. win: the window on which to operate
* 2. ls: character to be used for the left side of the window
* 3. rs: character to be used for the right side of the window
* 4. ts: character to be used for the top side of the window
* 5. bs: character to be used for the bottom side of the window
* 6. tl: character to be used for the top left corner of the window
* 7. tr: character to be used for the top right corner of the window
* 8. bl: character to be used for the bottom left corner of the window
* 9. br: character to be used for the bottom right corner of the window
*/
wrefresh(local_win);
delwin(local_win);
}
[edit]
1.9.3 설명 ¶괴성을 지르진마라. 나도 이게 양이 많은 예제란걸 알고 있다. 그러나 여기서 몇몇 중요한 것들을 설명해야만 한다 :-). 이 프로그램은 상하좌우의 방향키로 이동할 수 있는 직사각형의 윈도우를 생성한다. 그리고 사용자가 키를 누를때마다 반복적으로 윈도우를 없애고 다시 만든다. 화면의 한계 넘어까진 가지마라. 그 한계들을 체크하는 것은 독자들을 위한 연습으로 남겨두겠다. 이제 저것을 한줄한줄 분석해 보자.
create_newwin() 함수는 newwin() 을 통해 윈도우를 생성하고 box 함수로 그 테두리를 보여준다. destroy_win() 함수는 먼저 윈도우의 테두리를 ' ' 문자로 그림으로서 윈도우를 지우고 그 후 delwin() 함수를 호출해서 관련된 메모리를 해제한다. 사용자가 누르는 키에 따라 starty 또는 startx 값이 바뀌고 새 윈도우가 만들어진다.
보다시피 destroy_win 에서 box 함수 대신에 wborder 을 사용하였다. 이유는 주석에 쓰여있다. (읽지 않았을 것이다. 안다. 코드를 읽어보라 :-)). wborder 함수는 아래와 같이 호출할 경우 4개의 코너와 4개의 줄에 대해 주어진 문자로 윈도우를 그린다:
wborder(win, '|', '|', '-', '-', '+', '+', '+', '+');
이렇게 생긴 창이 생성된다.
#!
+-----------------------+
| |
| |
| |
| |
| |
| |
+-----------------------+
[edit]
1.9.4 예제의 다른 부분 ¶또한 위의 예제에서 볼 수 있듯이, 난 COLS, LINES 라는 변수를 사용했다. 이것들은 initscr() 이후에 화면의 크기에 맞게 값이 초기화된다. 이 변수들은 화면의 넓이나 위 예제처럼 화면의 정중앙의 위치를 찾는데 유용하다. getch() 함수는 흔히 쓰듯 키보드로부터 입력을 받는다. 그리고 입력된 키에따라 해당하는 일을 하게 된다. 이런 류의 switch-case 문은 GUI 기반 프로그램에서 매운 일반적인 형태이다.
[edit]
1.9.5 다른 테두리 함수들 ¶위 프로그램은 키가 눌려질때마다 윈도우가 없어지고 다른것이 생기기 때문에 굉장히 비효율적이다. 이제 다른 테두리관련 함수를 써서 프로그램을 좀 더 효율적으로 만들어보자.
다음의 프로그램은 mvhline() 와 mvvline() 함수를 써서 같은 효과를 내었다. 이 두 함수는 단순하다. 이것들은 수평 또는 수직의 선을 특정 위치에서 특정 길이만큼 생성한다.
Example 8. More border functions
#include <ncurses.h>
typedef struct _win_border_struct {
chtype ls, rs, ts, bs,
tl, tr, bl, br;
}WIN_BORDER;
typedef struct _WIN_struct {
int startx, starty;
int height, width;
WIN_BORDER border;
}WIN;
void init_win_params(WIN *p_win);
void print_win_params(WIN *p_win);
void create_box(WIN *win, int bool);
int main(int argc, char *argv[])
{ WIN win;
int ch;
initscr(); /* Start curses mode */
start_color(); /* Start the color functionality */
cbreak(); /* Line buffering disabled, Pass on
* everty thing to me */
keypad(stdscr, TRUE); /* I need that nifty F1 */
noecho();
init_pair(1, COLOR_CYAN, COLOR_BLACK);
/* Initialize the window parameters */
init_win_params(&win);
print_win_params(&win);
attron(COLOR_PAIR(1));
printw("Press F1 to exit");
refresh();
attroff(COLOR_PAIR(1));
create_box(&win, TRUE);
while((ch = getch()) != KEY_F(1))
{ switch(ch)
{ case KEY_LEFT:
create_box(&win, FALSE);
--win.startx;
create_box(&win, TRUE);
break;
case KEY_RIGHT:
create_box(&win, FALSE);
++win.startx;
create_box(&win, TRUE);
break;
case KEY_UP:
create_box(&win, FALSE);
--win.starty;
create_box(&win, TRUE);
break;
case KEY_DOWN:
create_box(&win, FALSE);
++win.starty;
create_box(&win, TRUE);
break;
}
}
endwin(); /* End curses mode */
return 0;
}
void init_win_params(WIN *p_win)
{
p_win->height = 3;
p_win->width = 10;
p_win->starty = (LINES - p_win->height)/2;
p_win->startx = (COLS - p_win->width)/2;
p_win->border.ls = '|';
p_win->border.rs = '|';
p_win->border.ts = '-';
p_win->border.bs = '-';
p_win->border.tl = '+';
p_win->border.tr = '+';
p_win->border.bl = '+';
p_win->border.br = '+';
}
void print_win_params(WIN *p_win)
{
#ifdef _DEBUG
mvprintw(25, 0, "%d %d %d %d", p_win->startx, p_win->starty,
p_win->width, p_win->height);
refresh();
#endif
}
void create_box(WIN *p_win, int bool)
{ int i, j;
int x, y, w, h;
x = p_win->startx;
y = p_win->starty;
w = p_win->width;
h = p_win->height;
if(bool == TRUE)
{ mvaddch(y, x, p_win->border.tl);
mvaddch(y, x + w, p_win->border.tr);
mvaddch(y + h, x, p_win->border.bl);
mvaddch(y + h, x + w, p_win->border.br);
mvhline(y, x + 1, p_win->border.ts, w - 1);
mvhline(y + h, x + 1, p_win->border.bs, w - 1);
mvvline(y + 1, x, p_win->border.ls, h - 1);
mvvline(y + 1, x + w, p_win->border.rs, h - 1);
}
else
for(j = y; j <= y + h; ++j)
for(i = x; i <= x + w; ++i)
mvaddch(j, i, ' ');
refresh();
}
[edit]
1.10.1 개괄 ¶색이 없다면 삶은 참 우울할 것이다. curses 는 색을 다루는 멋진 메커니즘을 가지고 있다. 자 그럼 짧은 프로그램으로 천천히 한번 시작해보자.
Example 9. A Simple Color example
#include <ncurses.h>
void print_in_middle(WINDOW *win, int starty, int startx, int width, char *string);
int main(int argc, char *argv[])
{ initscr(); /* Start curses mode */
if(has_colors() == FALSE)
{ endwin();
printf("You terminal does not support color\n");
exit(1);
}
start_color(); /* Start color */
init_pair(1, COLOR_RED, COLOR_BLACK);
attron(COLOR_PAIR(1));
print_in_middle(stdscr, LINES / 2, 0, 0, "Viola !!! In color ...");
attroff(COLOR_PAIR(1));
getch();
endwin();
}
void print_in_middle(WINDOW *win, int starty, int startx, int width, char *string)
{ int length, x, y;
float temp;
if(win == NULL)
win = stdscr;
getyx(win, y, x);
if(startx != 0)
x = startx;
if(starty != 0)
y = starty;
if(width == 0)
width = 80;
length = strlen(string);
temp = (width - length)/ 2;
x = startx + (int)temp;
mvwprintw(win, y, x, "%s", string);
refresh();
}
보다시피, 색을 사용할려면 먼저 start_color() 함수를 호출해야 한다. 그 후 다양한 함수들을 통해 당신의 터미널의 색상기능들을 사용할 수 있다. 터미널이 색상 기능이 있는지 아닌지 알아볼려면, has_colors() 함수를 써라. 만약 터미널이 색을 지원하지 않는다면 FALSE 가 리턴될 것이다.
curses 는 start_color() 이 호출될 때 터미널에서 지원되는 모든 색들을 초기화해서 준비한다. 이 색들은 미리 정의된 COLOR_BLACK 등등의 상수를 통해 쓸 수 있다. 자 이제 실제로 색을 쓸려면, 색상짝을 정의해야 한다. 색들은 항상 색상짝의 꼴로 쓰여진다. 즉, init_pair() 함수를 통해 전경 및 후경색을 정의해야만 이 색상짝 값을 쓸 수 있단 말이다. 이렇게 한다음에야 색상짝의 값은 COLOR_PAIR() 함수와 함께 일반 속성 처럼 쓰여질 수 있다. 이는 처음엔 좀 성가셔 보이는 일들이나, 이 방법은 우리가 색상짝들을 매우 쉽게 쓸 수 있는 우아한 기법이다. 쉘 스크립트에서 다이얼로그 상자를 보여주는 유틸리티인 "dialog" 의 소스 코드를 보게 되면 이를 알 수 있다. 이것의 개발자는 필요한 모든 전경 및 후경 색상짝에 대해서 정의를 해놓고, 프로그램 시작시에 이를 초기화하고 있다. 이 방법은 우리가 미리 상수처럼 정의해놓은 색상짝을 씀으로써 색상 속성을 설정하는 것을 매우 쉽게 해준다.
다음의 색들은 curses.h 에 정의되어 있다. 당신은 이것들을 다양한 색관련 함수들에 쓸 수 있다.
#!
COLOR_BLACK 0
COLOR_RED 1
COLOR_GREEN 2
COLOR_YELLOW 3
COLOR_BLUE 4
COLOR_MAGENTA 5
COLOR_CYAN 6
COLOR_WHITE 7
[edit]
1.10.2 색상 정의 바꾸기 ¶init_color() 함수는 curses 에 의해 정의된 색상의 rgb 값을 변경할 수 있다. 예를 들어 당신이 빨간색의 강도를 아주 약간 줄이고 싶다고 하자. 그렇다면 이 함수를 다음과 같이 호출한다.
init_color(COLOR_RED, 700, 0, 0);
/* param 1 : color name
* param 2, 3, 4 : rgb content min = 0, max = 1000 */
만약 당신의 터미널이 색상 정의를 변경하지 못한다면, 이 함수는 ERR 을 리턴한다. can_change_color() 함수는 터미널이 색상을 바꿀 수 있는 기능이 있는지 없는지 확인하는 함수이다. rgb 값의 범위는 0 부터 1000 까지이다. 처음에 RED 색이 1000(r), 0(g), 0(b) 로 정의된다.
|