| 리눅스 기타 자료 |
|---|
|
|
|
| 제목 | gtk 강좌 #10 1998/07/10 (17:33) |
| 이름 | 김효원 |
| 번호 | 94 |
| 조회 | 394 |
| 본문 |
************ *** 17. glib ************ glib는 GDK 및 GTK 어플을 개발할 때 많은 유용한 함수와 정의들을 제공한다. 나는 여기서 그들을 간단한 설명과 함께 보일 것이다. 상당수는 표준의 libc와 중복되기 때문에 그들에 대해 자세히 다루진 않는다. 이것은 주로 하나의 참고로서, 어떤 것을 이용할 수 있는가를 파악하게 할 것이다. *** *** 17-1. 정의 *** 많은 자료형들에 대한 extreme 값들의 정의는 이렇다. G_MINFLOAT G_MAXFLOAT G_MINDOUBLE G_MAXDOUBLE G_MINSHORT G_MAXSHORT G_MININT G_MAXINT G_MINLONG G_MAXLONG 또한, typedef들도 있다. 왼쪽의 것들은 기계의 architecture에 의해 다르게 세팅된다. 호환성을 유지하려면 포인터의 크기를 재어서는 안된다는 것을 명심 하라. 하나의 포인터는 Alpha 에서 8바이트, 하지만 Intel에서는 4바이트이다. char gchar; short gshort; long glong; int gint; char gboolean; unsigned char guchar; unsigned short gushort; unsigned long gulong; unsigned int guint; float gfloat; double gdouble; long double gldouble; void* gpointer; gint8 guint8 gint16 guint16 gint32 guint32 *** *** 17-2. 이중 연결 리스트들 *** 아래의 함수들은 이중 연결 리스트들을 만들고, 관리하고, 또 파괴하기 위해 쓰이는 것들이다. 이 문서에서 연결리스트가 무엇인지 다룰 순 없기에, 나는 여러분이 그것을 이미 알고 있다고 가정한다. 물론, 그것은 GTK의 일반적인 쓰임새를 알기 위해 꼭 필요한 것은 아니지만, 그래도 알면 좋은 것이다. GList* g_list_alloc (void); void g_list_free (GList *list); void g_list_free_1 (GList *list); GList* g_list_append (GList *list, gpointer data); GList* g_list_prepend (GList *list, gpointer data); GList* g_list_insert (GList *list, gpointer data, gint position); GList* g_list_remove (GList *list, gpointer data); GList* g_list_remove_link (GList *list, GList *link); GList* g_list_reverse (GList *list); GList* g_list_nth (GList *list, gint n); GList* g_list_find (GList *list, gpointer data); GList* g_list_last (GList *list); GList* g_list_first (GList *list); gint g_list_length (GList *list); void g_list_foreach (GList *list, GFunc func, gpointer user_data); *** *** 17-3. 연결 리스트 *** 위에 있는 많은 함수들은 단일 연결리스트들에 대해서도 쓰일 수 있는 것들 이다. 여기 완전한 함수의 리스트가 있다. GSList* g_slist_alloc (void); void g_slist_free (GSList *list); void g_slist_free_1 (GSList *list); GSList* g_slist_append (GSList *list, gpointer data); GSList* g_slist_prepend (GSList *list, gpointer data); GSList* g_slist_insert (GSList *list, gpointer data, gint position); GSList* g_slist_remove (GSList *list, gpointer data); GSList* g_slist_remove_link (GSList *list, GSList *link); GSList* g_slist_reverse (GSList *list); GSList* g_slist_nth (GSList *list, gint n); GSList* g_slist_find (GSList *list, gpointer data); GSList* g_slist_last (GSList *list); gint g_slist_length (GSList *list); void g_slist_foreach (GSList *list, GFunc func, gpointer user_data); *** *** 17-4. 메모리 관리 *** gpointer g_malloc (gulong size); 이것은 malloc()을 대체하는 것이다. 이 함수의 내부에서 리턴값에 대한 체크가 이루어지므로 우리가 따로 그것을 해줄 필요는 없다. gpointer g_malloc0 (gulong size); 위와 같지만, 그것을 향한 포인터를 리턴하기 전까진 0이다. gpointer g_realloc (gpointer mem, gulong size); "mem"에서 시작하여 "size"만큼의 바이트를 다시 할당한다. 물론 그 메모리는 이전에 할당되어 있어야 한다. void g_free (gpointer mem); 간단하다, 메모리를 반납한다. void g_mem_profile (void); 사용된 메모리의 profile을 쏟아내 준다. 하지만 이것을 쓰기 위해선 우리는 glib/gmem.c의 제일 윗부분에 #define MEM_PROFILE을 더해주고 make를 다시 해야 한다. void g_mem_check (gpointer mem); 메모리의 위치가 유효한 것인지 체크한다. gmem.c의 제일 윗부분에 #define MEM_CHECK을 더해주고 make를 다시 해야 한다. *** *** 17-5. 타이머 *** 타이머 함수들이다. GTimer* g_timer_new (void); void g_timer_destroy (GTimer *timer); void g_timer_start (GTimer *timer); void g_timer_stop (GTimer *timer); void g_timer_reset (GTimer *timer); gdouble g_timer_elapsed (GTimer *timer, gulong *microseconds); *** *** 17-6. 문자열 다루기 *** 문자열을 다루는 함수들이다. 이들은 모두 상당히 흥미롭고, 또한 표준 C 문자열 함수들보다 더 많은 기능들이 있을 것이다. 하지만 이들에 문서가 필요 할 것이다. GString* g_string_new (gchar *init); void g_string_free (GString *string, gint free_segment); GString* g_string_assign (GString *lval, gchar *rval); GString* g_string_truncate (GString *string, gint len); GString* g_string_append (GString *string, gchar *val); GString* g_string_append_c (GString *string, gchar c); GString* g_string_prepend (GString *string, gchar *val); GString* g_string_prepend_c (GString *string, gchar c); void g_string_sprintf (GString *string, gchar *fmt, ...); void g_string_sprintfa (GString *string, gchar *fmt, ...); *** *** 17-7. Utility 와 Error 함수들 *** gchar* g_strdup (const gchar *str); strdup함수를 대체한다. 원래의 문자열을 새롭게 할당된 메모리에 복사하고, 그 곳에 대한 포인터를 리턴한다. gchar* g_strerror (gint errnum); 모든 에러 메시지에 이 함수를 이용할 것을 권한다. 이것은 perror()나 다른 것보다 훨씬 멋지고, 확장성 좋은 것이다. 출력은 보통 이런 형식이다. program name:function that failed:file or further description:strerror 이것은 우리의 hello_world 프로그램에 쓰인 예제이다. g_print("hello_world:open:%s:%s\n", filename, g_strerror(errno)); void g_error (gchar *format, ...); 에러 메시지를 출력한다. 형식은 printf와 같지만, 출력의 앞머리에 "** ERROR **: "를 붙이고, 그리고 프로그램을 끝낸다. 치명적인 에러에만 사용하라. void g_warning (gchar *format, ...); 위와 같다, 하지만 "** WARNING **: "을 앞머리에 붙이고, 또한 프로그램을 끝내진 않는다. void g_message (gchar *format, ...); 우리가 출력하려는 문자열에 "message: "를 앞에서 붙여 출력해준다. void g_print (gchar *format, ...); printf를 대체한다. 그리고 우리의 마지막 함수는 이것이다. gchar* g_strsignal (gint signum); 인자로 준 시그널 번호에 해당하는 유닉스 시스템의 시그널 이름을 출력해준다. 대다수의 시그널 다루는 함수들에게 유용하다. 위에 소개된 모든 것들은 glib.h에서 마구잡이로 인용한 것이다. 여러분 중 누구라도 어떤 함수에 대한 문서화를 하겠다면, 나에게 email을 보내주길! ********************* *** 18. GTK의 rc 파일 ********************* GTK는 rc 파일을 이용해서 어플의 디폴트 환경을 다룬다. 이들은 앞서 설명한 어떤 widget의 색깔은 물론 배경에 넣을 pixmap을 설정할 수도 있다. *** *** 18-1. rc 파일을 위한 함수 *** 어플을 시작하는 부분에서 이 함수를 포함시키자. void gtk_rc_parse (char *filename); 인자는 우리 rc 파일의 이름이다. 이것은 GTK가 이 파일을 읽어서 widget들의 스타일을 그곳에 정의된 대로 세팅하도록 한다. 만약 widget들 중에 다른 것들과 구별되어야 할 특별한 스타일을 가져야 할 것이 있다면, 또는 다른 목적으로 widget들을 논리적으로 분류하려면, 이 함수를 이용한다. void gtk_widget_set_name (GtkWidget *widget, gchar *name); 첫번째 인자로 새로 만든 widget을 주고, 두번째 인자는 그것에 부여하고자 하는 이름이다. 이것은 이 widget의 속성을 rc 파일에 있는 이름을 통하여 바꿀 수 있게 한다. 이런 식으로 함수를 호출했다고 생각해 보자. button = gtk_button_new_with_label ("Special Button"); gtk_widget_set_name (button, "special button"); 그럼 이 버튼은 "special button"으로 이름붙고 rc 파일에서 "special button. GtkButton"이라는 이름으로 될 것이다. (확인해 보자!) 아래의 rc 파일 예제는 main 윈도의 속성을 세팅하고, 그 main 윈도의 child 들은 "main button"의 스타일을 상속받게 된다. 이 어플에서 쓰인 코드는 이렇게 된다. window = gtk_window_new (GTK_WINDOW_TOPLEVEL); gtk_widget_set_name (window, "main window"); 그리고 rc 파일에서 정의되는 스타일은 이렇게 된다. widget "main window.*GtkButton*" style "main_button" "main window"에 있는 모든 GtkButton widget을 rc 파일에서 정의한 "main_ buttons"의 스타일대로 세팅한다. 보다시피, 이것은 상당히 강력하고 유연한 시스템이다. 이것으로 최고의 효과를 얻기 위해 각자 상상력을 동원해 보기 바란다. *** *** 18-2. GTK rc 파일의 포맷 *** GTK rc 파일의 포맷은 뒤따르는 예제에서 보여지고 있다. 이것은 GTK 배포본에 함께 있는 testgtkrc 파일이고, 내가 약간의 주석 같은 것을 더했다. 누구든지 이것을 어플에 포함시켜서 사용자들이 이용하게 할 수 있을 것이다. Widget의 속성을 변화시킬 때 몇가지 직관적인 것들이 있다. o fg - Widget의 foreground 색깔 o bg - Widget의 background 색깔 o bg_pixmap - Widget의 background에 쓰일 픽스맵 o font - 주어진 widget에 쓰일 폰트 이것들에 덧붙여, widget들에 가해질 수 있는 몇가지 state가 있고, 우리는 다른 색깔, 픽스맵, 그리고 폰트를 각 상태에 세팅해 줄 수 있다. 이 state들은 다음과 같다. o NORMAL - Widget의 평상시 상태. 마우스가 그 widget의 위에 오지 않았고, 또 눌러지지도 않은 등의 상태다. o PRELIGHT - 마우스 포인터가 어떤 widget의 위로 오게 되면, 이 state에서 정의한 색깔들이 효력을 가지게 된다. o ACTIVE - Widget이 눌러지거나 클릭되면 active이고, 이 tag에 의해서 정의된 속성들이 효력을 가진다. o INSENSITIVE - 어떤 widget이 insensitive로, 그리고 active될 수 없도록 세팅되면 여기서의 속성을 따르게 된다. o SELECTED - Object가 selected되면 여기서의 속성을 따르게 된다. Widget의 색깔을 변화시키는 키워드인 "fg"와 "bg"를 사용할 때의 포맷은 이렇다. fg[<STATE>] = { Red, Green, Blue } 여기서 STATE는 위의 표현들(PRELIGHT, ACTIVE 등) 중 하나고, Red, Green, Blue는 0부터 1까지의 부동소수점 수다. 이들은 반드시 부동소수로 표현되어야 하며, 그렇지 않으면 0으로 인식될 것이다. "1"은 동작하지 않는다, 꼭 "1.0" 으로 해야 한다. 단순히 "0"이라고 하는 것은 인식되지 않는 값이 0이므로 무방할 것이다. bg_pixmap은 위의 경우와 매우 비슷하다, color가 filename으로 대치될 뿐. pixmap_path는 ":"으로 구분된 경로의 리스트다. 이 경로는 우리가 설정한 대로 어떤 픽스맵이라도 찾을 것이다. font도 직관적으로 이렇게만 하면 된다. font = "<font name>" 딱 하나 어려운 게 있다면 폰트 이름의 문자열을 다루는 것이다. xfontsel 이나 유사한 유틸리티들이 도움이 될 것이다. "widget_class"는 widget들의 클래스 스타일을 세팅한다. 이 클래스들은 widget의 개요 부분에서 보인 클래스 계층구조에 나와 있다. "widget"은 직관적으로, 이름 붙여진 widget의 집합을 주어진 스타일대로 설정하며, 주어진 widget 클래스에 대해 어떤 스타일이라도 오버로드한다. 이런 widget들은 gtk_widget_set_name() 함수에 의해 어플 내부에 등록되어 있다. 이것은 widget 클래스 전체적으로가 아니라 어떤 widget을 basis로 하고 있는 어느 한 widget의 특성을 설정해 줄 수 있도록 한다. 사용자들이 나름대로 설정 해서 이용할 있도록, 이런 특별한 widget이라면 뭐든지 문서화해 둘 것을 적극 권하는 바이다. 키워드 "parent"가 속성 설정에 쓰이면, 그 widget은 parent의 속성을 따르게 된다. 스타일을 정의하면서, 이전에 정의된 스타일을 새로운 것에 대입해 주는 것도 가능하다. style "main_button" = "button" { font = "-adobe-helvetica-medium-r-normal--*-100-*-*-*-*-*-*" bg[PRELIGHT] = { 0.75, 0, 0 } } 이 예제는 "button"의 스타일을 취해서, 단지 이것에서 font와 prelight background color를 바꾸는 것으로 새로운 "main_button" 스타일을 만들어낸다. 물론, 이런 속성 중 많은 것들은 모든 widget에 대해 적용가능한 것이 아니다. 이것은 상식적이고 간단한 것이다. 적용가능한 것이 있다면 적용하면 된다. *** *** 18-3. rc 파일의 예제 *** # pixmap_path "<dir 1>:<dir 2>:<dir 3>:..." # pixmap_path "/usr/include/X11R6/pixmaps:/home/imain/pixmaps" # # style <name> [= <name>] # { # <option> # } # # widget <widget_set> style <style_name> # widget_class <widget_class_set> style <style_name> # 이것은 가능한 state들의 리스트다. 이들 중 일부는 특정한 widget들에 # 대해서는 적용되지 않음을 주의하라. # # NORMAL - The normal state of a widget, without the mouse over top of # it, and not being pressed etc. # # PRELIGHT - When the mouse is over top of the widget, colors defined # using this state will be in effect. # # ACTIVE - When the widget is pressed or clicked it will be active, and # the attributes assigned by this tag will be in effect. # # INSENSITIVE - When a widget is set insensitive, and cannot be # activated, it will take these attributes. # # SELECTED - When an object is selected, it takes these attributes. # # Given these states, we can set the attributes of the widgets in each of # these states using the following directives. # # fg - Sets the foreground color of a widget. # fg - Sets the background color of a widget. # bg_pixmap - Sets the background of a widget to a tiled pixmap. # font - Sets the font to be used with the given widget. # # 여기서 "button"이라 불리우는 스타일을 세팅한다. 파일의 마지막 부분에서 # 실제의 widget에 지정되고 있으므로 여기서의 이름은 중요하지 않다. style "window" { # 이것은 주어진 픽스맵으로 윈도의 패딩을 세팅한다. #bg_pixmap[<STATE>] = "<pixmap filename>" bg_pixmap[NORMAL] = "warning.xpm" } style "scale" { # "NORMAL" state에서 foreground(font) 색깔을 red로 세팅한다. fg[NORMAL] = { 1.0, 0, 0 } # 이 widget의 background pixmap을 parent의 그것으로 세팅한다. bg_pixmap[NORMAL] = "<parent>" } style "button" { # 여기서 어떤 버튼에 대하여 가능한 모든 state를 보여준다. 딱 하나 # 적용되지 않는 것은 SELECTED state다. fg[PRELIGHT] = { 0, 1.0, 1.0 } bg[PRELIGHT] = { 0, 0, 1.0 } bg[ACTIVE] = { 1.0, 0, 0 } fg[ACTIVE] = { 0, 1.0, 0 } bg[NORMAL] = { 1.0, 1.0, 0 } fg[NORMAL] = { .99, 0, .99 } bg[INSENSITIVE] = { 1.0, 1.0, 1.0 } fg[INSENSITIVE] = { 1.0, 0, 1.0 } } # 이 예제에서, 우리는 "button" 스타일의 속성을 상속받는다. 그리고 # 새로 "main_button" 스타일을 만들게 될때면 font와 background 색깔은 # 따로 지정해서 쓴다. style "main_button" = "button" { font = "-adobe-helvetica-medium-r-normal--*-100-*-*-*-*-*-*" bg[PRELIGHT] = { 0.75, 0, 0 } } style "toggle_button" = "button" { fg[NORMAL] = { 1.0, 0, 0 } fg[ACTIVE] = { 1.0, 0, 0 } # toggle_button의 background pixmap을 그것의 parent widget(어플에서 # 정의된대로)의 속성으로 세팅한다. bg_pixmap[NORMAL] = "<parent>" } style "text" { bg_pixmap[NORMAL] = "marble.xpm" fg[NORMAL] = { 1.0, 1.0, 1.0 } } style "ruler" { font = "-adobe-helvetica-medium-r-normal--*-80-*-*-*-*-*-*" } # pixmap_path "~/.pixmaps" # 이들은 widget의 타입들을 위에서 정의된 스타일에 따르게 한다. # Widget 타입들은 클래스 계층구조에 리스트되어 있지만, 이 문서에 리스트된 # 것들도 사용자들에게 좋은 참고가 될 수 있다. widget_class "GtkWindow" style "window" widget_class "GtkDialog" style "window" widget_class "GtkFileSelection" style "window" widget_class "*Gtk*Scale" style "scale" widget_class "*GtkCheckButton*" style "toggle_button" widget_class "*GtkRadioButton*" style "toggle_button" widget_class "*GtkButton*" style "button" widget_class "*Ruler" style "ruler" widget_class "*GtkText" style "text" # 이것은 모든 버튼들("main window"의 children들)을 main_button의 스타일 # 대로 세팅한다. widget "main window.*GtkButton*" style "main_button" |
|
|
|