Ncurses - Wstęp

Następujące terminy będą używane w tym rozdziale:

• okno - jest wewnętrzną reprezentacją zawierającą obraz części ekranu. WINDOW jest zdefiniowane w ncurses.h.
• ekran - jest oknem o rozmiarze całego ekranu ( od górnego lewego rogu po prawy dolny ). Stdscr i curscr są ekranami.
• terminal - jest specjalnym oknem zawierającym informacje o tym jak aktualnie wygląda ekran.
• zmienne - następujące zmienne i stałe zdefiniowano w ncurses.h
  • WINDOW *curscr - aktualny ekran
  • WINDOW *stdscr - standardowy ekran
  • int LINES - linie terminala
  • int COLS - kolumny terminala
  • bool TRUE - flaga prawdy, 1
  • bool FALSE - flaga fałszu, 0
  • int ERR - flaga błędu, -1
  • int OK - flaga ok, 0
• funkcje - w opisach funkcji argumenty są następujących typów:
  • win - WINDOW*
  • bf - bool
  • ch - chtype
  • str - char*
  • chstr - chtype*
  • fmt - char*
  • inne int

Zazwyczaj program używający bibliotekę ncurses wygląda następująco:

Dołączenie ncurses.h zdefiniuje zmienne i typy dla ncurses, np. WINDOW i prototypy funkcji. Plik automatycznie dołącza stdio.h, stdarg.h, termios.h i unctrl.h.

initscr() używana jest do zainicjowania danych oraz odczytania odpowiedniego pliku terminfo. Pamięć dla stdscr i curscr zostanie zaallokowana. Jeżeli wystąpią jakieś błędy initscr zwróci ERR, w innym wypadku zwrócony zostanie wskaźnik do stdscr. Dodatkowo ekran zostanie wymazany, zmienne LINES i COLS zostaną zainicjowane. Musisz wywołać tę funkcję przed jakąkolwiek inną funkcją ncurses.

endwin() usunie wszystkie utworzone przez ncurses zasoby, przywróci tty tryb, w którym był przed initscr(). Musisz wywołać tę funkcję po zakończeniu korzystania z ncurses.

Jeżeli chcesz korzystać z kilku terminali możesz użyć newterm(...) zamiast initscr().

Skompiluj program następująco:

Flagi mogą zawierać to co chcesz (zobacz gcc(1)). Ponieważ ścieżka do ncurses.h zmieniła się musisz podać również:

W innym przypadku ncurses.h, nterm.h, termcap.h i unctrl.h nie zostaną znalezione. Inne możliwe opcje dla Linuxa to:

O2 mówi gcc aby dokonał pewnej optymalizacji, -ansi używane jest dla kodu zgodnego z kodem ansi-c, -Wall wypisze wszyskie ostrzeżenia, -m486 stworzy kod zoptymalizowany dla 486 ( będzie on również wykonywalny na 386 ).

Biblioteka ncurses znajduje się w /usr/lib/. Istnieją trzy wersje tej biblioteki:

• libncurses.a normalna biblioteka ncurses.
• libdcurses.a biblioteka do odpluskwiania.
• libpcurses.a biblioteka do profilowania ( począwszy od 1.8.6 libpcurses.a nie istnieje ? ).
• libcurses.a Brak czwartej wersji, oprócz oryginalnej wersji BSD curses ( mój slackware 2.1.0 ma pakiet bsd ).

Stuktury danych dla ekranu nazywane są oknami, są one zdefiniowane w ncurses.h. Okno jest jakby tablicą znaków w pamięci, którą programista może zmieniać bez wypisywania na ekran. Domyślnym oknem jest stdscr, ma ono wymiary teminala. Możesz tworzyć nowe okna za pomocą newwin(...).

Aby optymalnie zaktualizować fizyczny terminal ncurses posiadają dodatkowe okno - curscr. Jest to aktualny obraz terminala, podczas gdy stdscr zawiera informacje o tym jak terminal powinien wyglądać. Zapisanie informacji na terminalu zostanie dokonane gdy wywołasz funkcję refresh(). Ncurses zaktualizują curscr informacją zawartą w stdscr. Funkcje biblioteki użyją wewnętrznej optymalizacji procesu odświeżania, więc możesz zmienić wiele okien, po czym zaktualizować ekran w najbardziej optymalny sposób.

Za pomocą funkcji ncurses możesz manipulować różnymi oknami. Funkcje rozpoczynające się od w pozwalają wybrać okno, podczas gdy inne zazwyczaj działają na stdscr. Funcje zaczynające się na mv przesuną najpierw kursor do pozycji y,x.

Każdy znak jest typu chtype, który zdefiniowany jest jako long unsigned int w celu przechowywania dodatkowych informacji ( atrybuty, itp. ).

Ncurses używają bazy danych terminfo. Zazwyczaj znajduje się ona w usr/lib/terminfo/, tam ncurses zajrzą w poszukiwaniu jej. Jeżeli chcesz przetestować jakiś inny opis terminala bez zmiany terminfo ustaw zmienną systemową TERMINFO. Ncurses skorzysta z definicji zachowanych tam gdzie podałeś, zamiast /usr/lib/terminfo/.

Aktualną wersją ncurses jest 1.8.6(. ( ja mam 5.0, ale ta też już jest pewnie stara ).

Na końcu tego rozdziału znajdziesz tabelę zawierającą przegląd BSD-Curses, ncurses i curses z Sun-OS 5.4. Zajrzyj do niej w poszukiwaniu odpowiedniej funkcji i informacji o systemie, w którym ją zaimplementowano.