home *** CD-ROM | disk | FTP | other *** search
/ Dr. CD ROM (Annual Premium Edition) / premium.zip / premium / IBMOS2_1 / SC621.ZIP / sc621 / curses.h < prev    next >
C/C++ Source or Header  |  1992-07-10  |  14KB  |  292 lines
  1. /****************************************************************/
  2. /*                CURSES.H                */
  3. /* Header file for definitions and declarations for the        */
  4. /* PCcurses package. This should be #include'd in all user    */
  5. /* programs.                            */
  6. /****************************************************************/
  7. /* This version of curses is based on ncurses, a curses version    */
  8. /* originally written by Pavel Curtis at Cornell University.    */
  9. /* I have made substantial changes to make it run on IBM PC's,    */
  10. /* and therefore consider myself free to make it public domain.    */
  11. /*        Bjorn Larsson (...mcvax!enea!infovax!bl)    */
  12. /****************************************************************/
  13. /* 1.0:    Release:                    870515    */
  14. /* 1.1:    'Raw' output routines, revision info in            */
  15. /*    curses.h:                    880306    */
  16. /* 1.2:    Rcsid[] string in all modules, for maintenance:    881002    */
  17. /* 1.3:    All modules lint-checked with MSC '-W3' and        */
  18. /*    turbo'C' '-w -w-pro' switches. Support for        */
  19. /*    border(), wborder() functions:            881005    */
  20. /****************************************************************/
  21.  
  22. /* general definitions */
  23.  
  24. #define     TRUE        1        /* booleans */
  25. #define     FALSE        0
  26. #define     ERR        1        /* general error flag */
  27. #define     OK        0        /* general OK flag */
  28.  
  29. #define    CURSES_RCS_ID    "@(#)PCcurses v.1.3, 881005"
  30.  
  31. /* functions defined as macros */
  32.  
  33. #define getch()       wgetch(stdscr)    /* using macroes allows you to use */
  34. #define    ungetch(c) wungetch(c)        /* #undef getch/ungetch in your */
  35.                     /* programs to use MSC getch() and */
  36.                     /* ungetch() routines */
  37.  
  38. #define getyx(win,y,x)       (y = (win)->_cury, x = (win)->_curx)
  39.  
  40. #ifndef max
  41. #define max(a,b) (((a) > (b)) ? (a) : (b))
  42. #endif
  43. #ifndef min
  44. #define min(a,b) (((a) < (b)) ? (a) : (b))
  45. #endif
  46.  
  47. /* video attribute definitions. Colour definitions for */
  48. /* CGA/EGA should also go here... */
  49.  
  50. #define    A_ALTCHARSET   0
  51. #define    A_BLINK        0x100
  52. #define    A_BLANK        0x200
  53. #define    A_BOLD         0x400
  54. #define    A_DIM          0
  55. #define    A_PROTECT      0
  56. #define    A_REVERSE      0x800
  57. #define    A_STANDOUT     0x1000
  58. #define    A_UNDERLINE    0x2000
  59.  
  60. /* function and keypad key definitions. Many are just for compatibility */
  61.  
  62. #define KEY_BREAK      0x101        /* Not on PC */
  63. #define KEY_DOWN       0x102        /* The four arrow keys */
  64. #define KEY_UP         0x103
  65. #define KEY_LEFT       0x104
  66. #define KEY_RIGHT      0x105
  67. #define KEY_HOME       0x106        /* Home key */
  68. #define KEY_BACKSPACE  0x107        /* Not on PC */
  69. #define KEY_F0         0x108        /* Function keys. Space for */
  70. #define KEY_F(n)       (KEY_F0+(n)) /*  64 keys is reserved. */
  71. #define KEY_DL         0x148        /* Not on PC */
  72. #define KEY_IL         0x149        /* Insert line */
  73. #define KEY_DC         0x14a        /* Delete character */
  74. #define KEY_IC         0x14b        /* Insert char or enter insert mode */
  75. #define KEY_EIC        0x14c        /* Exit insert char mode */
  76. #define KEY_CLEAR      0x14d        /* Clear screen */
  77. #define KEY_EOS        0x14e        /* Clear to end of screen */
  78. #define KEY_EOL        0x14f        /* Clear to end of line */
  79. #define KEY_SF         0x150        /* Scroll 1 line forward */
  80. #define KEY_SR         0x151        /* Scroll 1 line backwards (reverse) */
  81. #define KEY_NPAGE      0x152        /* Next page */
  82. #define KEY_PPAGE      0x153        /* Previous page */
  83. #define KEY_STAB       0x154        /* Set tab */
  84. #define KEY_CTAB       0x155        /* Clear tab */
  85. #define KEY_CATAB      0x156        /* Clear all tabs */
  86. #define KEY_ENTER      0x157        /* Enter or send (unreliable) */
  87. #define KEY_SRESET     0x158        /* soft (partial) reset (unreliable) */
  88. #define KEY_RESET      0x159        /* reset or hard reset (unreliable) */
  89. #define KEY_PRINT      0x15a        /* print or copy */
  90. #define KEY_LL         0x15b        /* home down or bottom (lower left) */
  91. #define KEY_ABORT      0x15c        /*  Abort/Terminate key (any) */
  92. #define KEY_SHELP      0x15d        /* Short help */
  93. #define KEY_LHELP      0x15e        /* Long help */
  94.  
  95. /* type declarations */
  96.  
  97. typedef    char    bool;            /* boolean type */
  98.  
  99. typedef struct
  100.   {
  101.   int       _cury;            /* Current pseudo-cursor */
  102.   int       _curx;
  103.   int      _maxy;            /* Max coordinates */
  104.   int      _maxx;
  105.   int      _begy;            /* Origin on screen */
  106.   int      _begx;
  107.   int       _flags;            /* Window properties */
  108.   int       _attrs;            /* Attributes of written characters */
  109.   int      _tabsize;            /* Tab character size */
  110.   bool       _clear;            /* Causes clear at next refresh */
  111.   bool       _leave;            /* Leaves cursor as it happens */
  112.   bool       _scroll;            /* Allows window scrolling */
  113.   bool       _nodelay;            /* Input character wait flag */
  114.   bool       _keypad;            /* Flags keypad key mode active */
  115.   int    **_line;            /* Pointer to line pointer array */
  116.   int      *_minchng;            /* First changed character in line */
  117.   int      *_maxchng;            /* Last changed character in line */
  118.   int       _regtop;            /* Top of scrolling region */
  119.   int       _regbottom;            /* Bottom of scrolling region */
  120.   char       _borderchars[8];        /* Non-std border chars */
  121.   }    WINDOW;
  122.  
  123. /* External variables */
  124.  
  125. extern    int    LINES;            /* terminal height */
  126. extern    int    COLS;            /* terminal width */
  127. extern    WINDOW *curscr;            /* the current screen image */
  128. extern    WINDOW *stdscr;            /* the default screen window */
  129.  
  130. /* PCcurses function declarations */
  131.  
  132. extern    int     addch();        /* put char in stdscr */
  133. extern    int     addrawch();        /* put char in stdscr, raw */
  134. extern    int     addstr();        /* put string in stdscr */
  135. extern    void     attrset();        /* set stdscr char attributes */
  136. extern    void     attroff();        /* clear attribute(a) stdscr */
  137. extern    void     attron();        /* add attribute(s) stdscr */
  138. extern    int     baudrate();        /* compatibility dummy */
  139. extern    void     beep();        /* sound bell */
  140. extern    void     border();        /* Set non-std box characters */
  141. extern    void     box();            /* draw a box around a window */
  142. extern    void     cbreak();        /* set terminal cbreak mode */
  143. extern    void     clear();        /* clear stdscr */
  144. extern    void     clearok();        /* marks a window for screen clear */
  145. extern    int     clrtobot();        /* clear end of stdscr */
  146. extern    int     clrtoeol();        /* clear end of line in stdscr */
  147. extern    void     crmode();        /* set terminal cbreak mode */
  148. extern    void     cursoff();        /* turns off hardware cursor */
  149. extern    void     curson();        /* turns on hardware cursor */
  150. extern    void     def_prog_mode();    /* save TTY modes */
  151. extern    void     def_shell_mode();    /* compatibility dummy */
  152. extern    int     delch();        /* delete a char in stdscr */
  153. extern    int     deleteln();        /* delete a line in stdscr */
  154. extern    void     delwin();        /* delete a window or a subwindow */
  155. extern  void     doupdate();        /* update physical screen */
  156. extern    void     echo();        /* set terminal echo mode */
  157. extern    int     endwin();        /* cleanup and finitialization */
  158. extern    void     erase();        /* erase stdscr */
  159. extern    int     erasechar();        /* return char kill character */
  160. extern    int     fixterm();        /* compatibility dummy */
  161. extern    void     flash();        /* flash terminal screen */
  162. extern    void     flushinp();        /* kill pending keyboard input */
  163. extern  int     getstr();        /* get string to stdscr and buffer */
  164. extern    int     gettmode();        /* compatibility dummy */
  165. extern    void     idlok();        /* use ins/del line (dummy) */
  166. extern    int     initscr();        /* curses initialization */
  167. extern  int     inch();        /* get char at stdscr cursor */
  168. extern    int     insch();        /* insert character in stdscr */
  169. extern    int     insrawch();        /* insert character in stdscr, raw */
  170. extern    int     insertln();        /* insert new line in stdscr */
  171. extern    void     keypad();        /* marks a window for keypad usage */
  172. extern    int     killchar();        /* return line kill character */
  173. extern    char    *longname();        /* terminal description */
  174. extern    void     leaveok();        /* marks window for cursor 'leave' */
  175. extern    void     meta();        /* marks window for meta (dummy) */
  176. extern    int     move();        /* move cursor in stdscr */
  177. extern    int     mvaddch();        /* move & put char in stdscr */
  178. extern    int     mvaddrawch();        /* move & put char in stdscr, raw */
  179. extern    int     mvaddstr();        /* move & put string in stdscr */
  180. extern    int     mvclrtobot();        /* move & clear end of stdscr */
  181. extern    int     mvclrtoeol();        /* move & clear lineend in stdscr */
  182. extern    int     mvcur();        /* move terminal cursor */
  183. extern    int     mvdelch();        /* move & delete a char in stdscr */
  184. extern    int     mvdeleteln();        /* move & delete a line in stdscr */
  185. extern    int     mvgetch();        /* move & get char to stdscr */
  186. extern    int     mvgetstr();        /* move & get string to stdscr */
  187. extern    int     mvinch();        /* move & get char at stdscr cursor */
  188. extern    int     mvinsch();        /* move & insert char in stdscr */
  189. extern    int     mvinsrawch();        /* move & insert raw char in stdscr */
  190. extern    int     mvinsertln();        /* move & insert new line in stdscr */
  191. extern    int     mvprintw(int y,    /* move & print string in stdscr */
  192.               int x,
  193.               char *fmt,
  194.               ...);
  195. extern    int     mvscanw(int y,        /* move & get values via stdscr */
  196.              int x,
  197.              char *fmt,
  198.              ...);
  199. extern    int     mvwaddch();        /* move & put char in a window */
  200. extern    int     mvwaddrawch();        /* move & put char in a window, raw */
  201. extern    int     mvwaddstr();        /* move & put string in a window */
  202. extern    int     mvwclrtobot();        /* move & clear end of a window */
  203. extern    int     mvwclrtoeol();        /* move & clear lineend in a window */
  204. extern    int     mvwdelch();        /* move & delete a char in a window */
  205. extern    int     mvwdeleteln();        /* move & delete a line in a window */
  206. extern    int     mvwgetch();        /* move & get char to a window */
  207. extern    int     mvwgetstr();        /* move & get string to a window */
  208. extern    int     mvwinch();        /* move & get char at window cursor */
  209. extern    int     mvwinsch();        /* move & insert char in a window */
  210. extern    int     mvwinsrawch();        /* move & insert raw char in window */
  211. extern    int     mvwinsertln();        /* move & insert new line in window */
  212. extern    int     mvwin();        /* move window */
  213. extern    int     mvwprintw(WINDOW *win,    /* move & print string in a window */
  214.                int y,
  215.                int x,
  216.                char *fmt,
  217.                ...);
  218. extern    int     mvwscanw(WINDOW *win,    /* move & get values via a window */
  219.               int y,
  220.               int x,
  221.               char *fmt,
  222.               ...);
  223. extern    WINDOW    *newwin();        /* create a window */
  224. extern    void     nl();            /* set terminal cr-crlf map mode */
  225. extern    void     nocbreak();        /* unset terminal cbreak mode */
  226. extern    void     nocrmode();        /* unset terminal cbreak mode */
  227. extern    void     nodelay();        /* marks window for no input wait */
  228. extern    void     noecho();        /* unset terminal echo mode */
  229. extern    void     nonl();        /* unset terminal cr-crlf map mode */
  230. extern    void     noraw();        /* unset raw terminal mode */
  231. extern    void     overlay();        /* overlay one window on another */
  232. extern    void     overwrite();        /* overwrite one window on another */
  233. extern    int     printw(char *fmt,    /* print string in stdscr */
  234.             ...);
  235. extern    void     raw();            /* set raw terminal mode */
  236. extern    void     refrbrk();        /* set screen refresh break mode */
  237. extern    void     refresh();        /* refresh stdscr */
  238. extern    int     resetterm();        /* compatibility dummy */
  239. extern    int     resetty();        /* restore terminal I/O modes */
  240. extern    void     reset_prog_mode();    /* restore terminal I/O modes */
  241. extern    void     reset_shell_mode();    /* set terminal to default modes */
  242. extern    int     saveoldterm();        /* compatibility dummy */
  243. extern    int     saveterm();        /* compatibility dummy */
  244. extern    int     savetty();        /* save terminal I/O modes */
  245. extern    int     scanw(char *fmt,    /* get values via stdscr */
  246.               ...);
  247. extern    void     scroll();        /* scroll region in a window */
  248. extern    void     scrollok();        /* marks a window to allow scroll */
  249. extern    int     setsrcreg();        /* define stdscr's scroll region */
  250. extern    int     setterm();        /* compatibility dummy */
  251. extern    int     setupterm();        /* set up terminal (no-op) */
  252. extern    void     standend();        /* start normal chars in stdscr */
  253. extern    void     standout();        /* start standout chars in stdscr */
  254. extern    WINDOW    *subwin();        /* create a sub-window */
  255. extern    int     tabsize();        /* set/get tabsize of stdscr */
  256. extern    void     touchwin();        /* mark a window as modified */
  257. extern    char    *unctrl();        /* char-to-string converter */
  258. extern    int     waddch();        /* put char in a window */
  259. extern    int     waddrawch();        /* put char in a window, raw */
  260. extern    int     waddstr();        /* put string in a window */
  261. extern    void     wattroff();        /* clear attribute(a) in window */
  262. extern    void     wattron();        /* add attribute(s) in window */
  263. extern    void     wattrset();        /* set window char attributes */
  264. extern    void     wborder();        /* Set non-std box characters */
  265. extern    int     wbox();        /* draw a box inside a window */
  266. extern    void     wclear();        /* clear a window */
  267. extern    int     wclrtobot();        /* clear end of a window */
  268. extern    int     wclrtoeol();        /* clear end of line in a window */
  269. extern    int     wdelch();        /* delete a char in a window */
  270. extern    int     wdeleteln();        /* delete a line in a window */
  271. extern    void     werase();        /* erase a window */
  272. extern    int     wgetch();        /* get char to a window */
  273. extern  int     wgetstr();        /* get string to window and buffer */
  274. extern    int     winch();        /* get char at window cursor */
  275. extern    int     winsch();        /* insert character in a window */
  276. extern    int     winsrawch();        /* insert raw character in a window */
  277. extern    int     winsertln();        /* insert new line in a window */
  278. extern    int     wmove();        /* move cursor in a window */
  279. extern    void     wnoutrefresh();    /* create screen image, w/o display */
  280. extern    int     wprintw(WINDOW *win,    /* print string in a window */
  281.              char *fmt,
  282.              ...);
  283. extern    void     wrefresh();        /* refresh screen */
  284. extern    int     wscanw(WINDOW *win,    /* get values via a window */
  285.             char *fmt,
  286.             ...);
  287. extern    int     wsetsrcreg();        /* define a window's scroll region */
  288. extern    void     wstandend();        /* start normal chars in window */
  289. extern    void     wstandout();        /* start standout chars in window */
  290. extern    int     wtabsize();        /* set/get tabsize of a window */
  291. extern    int     wungetch();        /* character push-back */
  292.