home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / misc / volume1 / 8710 / pc-curses-doc / 2 / curses.h < prev    next >
Encoding:
C/C++ Source or Header  |  1993-09-02  |  11.6 KB  |  248 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. /****************************************************************/
  15.  
  16. /* general definitions */
  17.  
  18. #define     TRUE        1        /* booleans */
  19. #define     FALSE        0
  20. #define     ERR        1        /* general error flag */
  21. #define     OK        0        /* general OK flag */
  22.  
  23. /* functions defined as macros */
  24.  
  25. #define getch()       wgetch(stdscr)    /* using macroes allows you to use */
  26. #define    ungetch(c) wungetch(c)        /* #undef getch/ungetch in your */
  27.                     /* programs to use MSC getch() and */
  28.                     /* ungetch() routines */
  29.  
  30. #define getyx(win,y,x)       (y = (win)->_cury, x = (win)->_curx)
  31.  
  32. #ifndef max
  33. #define max(a,b) (((a) > (b)) ? (a) : (b))
  34. #endif
  35. #ifndef min
  36. #define min(a,b) (((a) < (b)) ? (a) : (b))
  37. #endif
  38.  
  39. /* video attribute definitions */
  40.  
  41. #define    A_ALTCHARSET   0
  42. #define    A_BLINK        0x100
  43. #define    A_BLANK        0x200
  44. #define    A_BOLD         0x400
  45. #define    A_DIM          0
  46. #define    A_PROTECT      0
  47. #define    A_REVERSE      0x800
  48. #define    A_STANDOUT     0x1000
  49. #define    A_UNDERLINE    0x2000
  50.  
  51. /* function and keypad key definitions */
  52.  
  53. #define KEY_BREAK      0x101        /* Not on PC */
  54. #define KEY_DOWN       0x102        /* The four arrow keys */
  55. #define KEY_UP         0x103
  56. #define KEY_LEFT       0x104
  57. #define KEY_RIGHT      0x105
  58. #define KEY_HOME       0x106        /* Home key (upward+left arrow) */
  59. #define KEY_BACKSPACE  0x107        /* Not on PC */
  60. #define KEY_F0         0x108        /* Function keys. Space for */
  61. #define KEY_F(n)       (KEY_F0+(n)) /*  64 keys is reserved. */
  62. #define KEY_DL         0x148        /* Not on PC */
  63. #define KEY_IL         0x149        /* Insert line */
  64. #define KEY_DC         0x14a        /* Delete character */
  65. #define KEY_IC         0x14b        /* Insert char or enter insert mode */
  66. #define KEY_EIC        0x14c        /* Exit insert char mode */
  67. #define KEY_CLEAR      0x14d        /* Clear screen */
  68. #define KEY_EOS        0x14e        /* Clear to end of screen */
  69. #define KEY_EOL        0x14f        /* Clear to end of line */
  70. #define KEY_SF         0x150        /* Scroll 1 line forward */
  71. #define KEY_SR         0x151        /* Scroll 1 line backwards (reverse) */
  72. #define KEY_NPAGE      0x152        /* Next page */
  73. #define KEY_PPAGE      0x153        /* Previous page */
  74. #define KEY_STAB       0x154        /* Set tab */
  75. #define KEY_CTAB       0x155        /* Clear tab */
  76. #define KEY_CATAB      0x156        /* Clear all tabs */
  77. #define KEY_ENTER      0x157        /* Enter or send (unreliable) */
  78. #define KEY_SRESET     0x158        /* soft (partial) reset (unreliable) */
  79. #define KEY_RESET      0x159        /* reset or hard reset (unreliable) */
  80. #define KEY_PRINT      0x15a        /* print or copy */
  81. #define KEY_LL         0x15b        /* home down or bottom (lower left) */
  82. #define KEY_ABORT      0x15c        /*  Abort/Terminate key (any) */
  83. #define KEY_SHELP      0x15d        /* Short help */
  84. #define KEY_LHELP      0x15e        /* Long help */
  85.  
  86. /* type declarations */
  87.  
  88. typedef    char    bool;            /* boolean type */
  89.  
  90. typedef struct
  91.   {
  92.   int       _cury;            /* current pseudo-cursor */
  93.   int       _curx;
  94.   int      _maxy;            /* max coordinates */
  95.   int      _maxx;
  96.   int      _begy;            /* origin on screen */
  97.   int      _begx;
  98.   int       _flags;            /* window properties */
  99.   int       _attrs;            /* attributes of written characters */
  100.   int      _tabsize;            /* tab character size */
  101.   bool       _clear;            /* causes clear at next refresh */
  102.   bool       _leave;            /* leaves cursor as it happens */
  103.   bool       _scroll;            /* allows window scrolling */
  104.   bool       _nodelay;            /* input character wait flag */
  105.   bool       _keypad;            /* flags keypad key mode active */
  106.   int    **_line;            /* pointer to line pointer array */
  107.   int      *_minchng;            /* First changed character in line */
  108.   int      *_maxchng;            /* Last changed character in line */
  109.   int       _regtop;            /* Top/bottom of scrolling region */
  110.   int       _regbottom;
  111.   }    WINDOW;
  112.  
  113. /* External variables */
  114.  
  115. extern    int    LINES;            /* terminal height */
  116. extern    int    COLS;            /* terminal width */
  117. extern    WINDOW *curscr;            /* the current screen image */
  118. extern    WINDOW *stdscr;            /* the default screen window */
  119.  
  120. /* PCcurses function declarations */
  121.  
  122. extern    int     addch();        /* put char in stdscr */
  123. extern    int     addstr();        /* put string in stdscr */
  124. extern    void     attrset();        /* set stdscr char attributes */
  125. extern    void     attroff();        /* clear attribute(a) stdscr */
  126. extern    void     attron();        /* add attribute(s) stdscr */
  127. extern    int     baudrate();        /* compatibility dummy */
  128. extern    void     beep();        /* sound bell */
  129. extern    void     box();            /* draw a box around a window */
  130. extern    void     cbreak();        /* set terminal cbreak mode */
  131. extern    void     clear();        /* clear stdscr */
  132. extern    void     clearok();        /* marks a window for screen clear */
  133. extern    int     clrtobot();        /* clear end of stdscr */
  134. extern    int     clrtoeol();        /* clear end of line in stdscr */
  135. extern    void     crmode();        /* set terminal cbreak mode */
  136. extern    void     cursoff();        /* turns off hardware cursor */
  137. extern    void     curson();        /* turns on hardware cursor */
  138. extern    int     delch();        /* delete a char in stdscr */
  139. extern    int     deleteln();        /* delete a line in stdscr */
  140. extern    void     delwin();        /* delete a window or a subwindow */
  141. extern  void     doupdate();        /* update physical screen */
  142. extern    void     echo();        /* set terminal echo mode */
  143. extern    int     endwin();        /* cleanup and finitialization */
  144. extern    void     erase();        /* erase stdscr */
  145. extern    int     erasechar();        /* return char kill character */
  146. extern    int     fixterm();        /* compatibility dummy */
  147. extern    void     flash();        /* flash terminal screen */
  148. extern    void     flushinp();        /* kill pending keyboard input */
  149. extern  int     getstr();        /* get string to stdscr and buffer */
  150. extern    int     gettmode();        /* compatibility dummy */
  151. extern    void     idlok();        /* use ins/del line (dummy) */
  152. extern    int     initscr();        /* curses initialization */
  153. extern  int     inch();        /* get char at stdscr cursor */
  154. extern    int     insch();        /* insert character in stdscr */
  155. extern    int     insertln();        /* insert new line in stdscr */
  156. extern    void     keypad();        /* marks a window for keypad usage */
  157. extern    int     killchar();        /* return line kill character */
  158. extern    char    *longname();        /* terminal description */
  159. extern    void     leaveok();        /* marks window for cursor 'leave' */
  160. extern    void     meta();        /* marks window for meta (dummy) */
  161. extern    int     move();        /* move cursor in stdscr */
  162. extern    int     mvaddch();        /* move & put char in stdscr */
  163. extern    int     mvaddstr();        /* move & put string in stdscr */
  164. extern    int     mvclrtobot();        /* move & clear end of stdscr */
  165. extern    int     mvclrtoeol();        /* move & clear lineend in stdscr */
  166. extern    int     mvcur();        /* move terminal cursor */
  167. extern    int     mvdelch();        /* move & delete a char in stdscr */
  168. extern    int     mvdeleteln();        /* move & delete a line in stdscr */
  169. extern    int     mvgetch();        /* move & get char to stdscr */
  170. extern    int     mvgetstr();        /* move & get string to stdscr */
  171. extern    int     mvinch();        /* move & get char at stdscr cursor */
  172. extern    int     mvinsch();        /* move & insert char in stdscr */
  173. extern    int     mvinsertln();        /* move & insert new line in stdscr */
  174. extern    int     mvprintw();        /* move & print string in stdscr */
  175. extern    int     mvscanw();        /* move & get values via stdscr */
  176. extern    int     mvwaddch();        /* move & put char in a window */
  177. extern    int     mvwaddstr();        /* move & put string in a window */
  178. extern    int     mvwclrtobot();        /* move & clear end of a window */
  179. extern    int     mvwclrtoeol();        /* move & clear lineend in a window */
  180. extern    int     mvwdelch();        /* move & delete a char in a window */
  181. extern    int     mvwdeleteln();        /* move & delete a line in a window */
  182. extern    int     mvwgetch();        /* move & get char to a window */
  183. extern    int     mvwgetstr();        /* move & get string to a window */
  184. extern    int     mvwinch();        /* move & get char at window cursor */
  185. extern    int     mvwinsch();        /* move & insert char in a window */
  186. extern    int     mvwinsertln();        /* move & insert new line in window */
  187. extern    int     mvwin();        /* move window */
  188. extern    int     mvwprintw();        /* move & print string in a window */
  189. extern    int     mvwscanw();        /* move & get values via a window */
  190. extern    WINDOW    *newwin();        /* create a window */
  191. extern    void     nl();            /* set terminal cr-crlf map mode */
  192. extern    void     nocbreak();        /* unset terminal cbreak mode */
  193. extern    void     nocrmode();        /* unset terminal cbreak mode */
  194. extern    void     nodelay();        /* marks window for no input wait */
  195. extern    void     noecho();        /* unset terminal echo mode */
  196. extern    void     nonl();        /* unset terminal cr-crlf map mode */
  197. extern    void     noraw();        /* unset raw terminal mode */
  198. extern    void     overlay();        /* overlay one window on another */
  199. extern    void     overwrite();        /* overwrite one window on another */
  200. extern    int     printw();        /* print string in stdscr */
  201. extern    void     raw();            /* set raw terminal mode */
  202. extern    void     refrbrk();        /* set screen refresh break mode */
  203. extern    void     refresh();        /* refresh stdscr */
  204. extern    int     resetterm();        /* compatibility dummy */
  205. extern    int     resetty();        /* restore terminal I/O modes */
  206. extern    int     saveoldterm();        /* compatibility dummy */
  207. extern    int     saveterm();        /* compatibility dummy */
  208. extern    int     savetty();        /* save terminal I/O modes */
  209. extern    int     scanw();        /* get values via stdscr */
  210. extern    void     scroll();        /* scroll region in a window */
  211. extern    void     scrollok();        /* marks a window to allow scroll */
  212. extern    int     setsrcreg();        /* define stdscr's scroll region */
  213. extern    int     setterm();        /* compatibility dummy */
  214. extern    int     setupterm();        /* set up terminal (no-op) */
  215. extern    void     standend();        /* start normal chars in stdscr */
  216. extern    void     standout();        /* start standout chars in stdscr */
  217. extern    WINDOW    *subwin();        /* create a sub-window */
  218. extern    int     tabsize();        /* set/get tabsize of stdscr */
  219. extern    void     touchwin();        /* mark a window as modified */
  220. extern    char    *unctrl();        /* char-to-string converter */
  221. extern    int     waddch();        /* put char in a window */
  222. extern    int     waddstr();        /* put string in a window */
  223. extern    void     wattroff();        /* clear attribute(a) in window */
  224. extern    void     wattron();        /* add attribute(s) in window */
  225. extern    void     wattrset();        /* set window char attributes */
  226. extern    int     wbox();        /* draw a box inside a window */
  227. extern    void     wclear();        /* clear a window */
  228. extern    int     wclrtobot();        /* clear end of a window */
  229. extern    int     wclrtoeol();        /* clear end of line in a window */
  230. extern    int     wdelch();        /* delete a char in a window */
  231. extern    int     wdeleteln();        /* delete a line in a window */
  232. extern    void     werase();        /* erase a window */
  233. extern    int     wgetch();        /* get char to a window */
  234. extern  int     wgetstr();        /* get string to window and buffer */
  235. extern    int     winch();        /* get char at window cursor */
  236. extern    int     winsch();        /* insert character in a window */
  237. extern    int     winsertln();        /* insert new line in a window */
  238. extern    int     wmove();        /* move cursor in a window */
  239. extern    void     wnoutrefresh();    /* create screen image, w/o display */
  240. extern    int     wprintw();        /* print string in a window */
  241. extern    void     wrefresh();        /* refresh screen */
  242. extern    int     wscanw();        /* get values via a window */
  243. extern    int     wsetsrcreg();        /* define a window's scroll region */
  244. extern    void     wstandend();        /* start normal chars in window */
  245. extern    void     wstandout();        /* start standout chars in window */
  246. extern    int     wtabsize();        /* set/get tabsize of a window */
  247. extern    int     wungetch();        /* character push-back */
  248.