suplmnt.doc

用C++写的RS232串口异步通讯功能模块

         ---------------------------------------------------------------
         d_ch -- Display Char at Current Location
         ---------------------------------------------------------------
            void d_ch(char ch);

         Display one character at the present cursor position using
         v_color for the attribute.


         ---------------------------------------------------------------
         d_msgat -- Display Message At Location
         ---------------------------------------------------------------
            void d_msgat(int row, int col, int atrib, char *str);

         Displays string at the specified location using the specified
         attribute.  This routine is not limited to writing within the
         current window.  It is limited by the variable set by the
         SETsWND macro (s stands for screen).  The routine does not move
         the cursor and does not break up in process ANSI sequences.
         Used to display strings outside the current window.


         ---------------------------------------------------------------
         d_msgatd -- Display Message At Location Direct Write
         ---------------------------------------------------------------
            void d_msgatd(int row, int col, int atrib, char *str);

         This routine writes 'str' at the specified location using the
         given attribute.  Unlike the previous function, this function
         does not support ANSI or control characters.  It is for
         displaying strings on the screen in the fastest possible
         manner.  The 'v_bios' variable described in the list of global
         variables does not apply to this function.  It always uses
         direct screen writes.


         ---------------------------------------------------------------
         d_atrbat -- Display Attribute At Location With Count
         ---------------------------------------------------------------
            void d_atrbat(int row, int col, int atrb, int count);

         Resets the displayed attribute at the specified location to the
         given attribute for the given number of locations.  This rout-
         ine performs like d_msgat() in regard to window limitations,
         cursor movement, and ANSI sequences.






         ---------------------------------------------------------------
         d_nchat -- Display Char At Location With Count
         ---------------------------------------------------------------
            void d_nchat(char row, char col, char ch, char atrb,
             int nbr, char dir);

         Displays 'ch', 'nbr' times, using 'atrb' for the attribute, at
         'row, col'.  If 'dir' is 0 the chars are displayed vertically
         otherwise they are displayed horizontally.  This routine
         performs like d_msgat in regard to window limitations, cursor
         movement, and ANSI sequences.


         ---------------------------------------------------------------
         pu_scrnd -- Move Specified Screen Region To A Buffer
         ---------------------------------------------------------------
            void pu_scrnd(int row, int col, int nrows, int ncols,
             char *buf);

         This function saves a section of the video display beginning at
         'row', 'col', that is 'nrows' high and 'ncols' wide.  It also
         saves the current cursor position and shape.  The buffer to
         hold the screen information must be (2 * nrows * ncols) + 16
         bytes in size.  The 'v_bios' variable does not apply to this
         function.  It operates in direct write mode only.


         ---------------------------------------------------------------
         po_scrnd -- Restore a Screen Saved by 'pu_scrnd' Function
         ---------------------------------------------------------------
            void po_scrnd(char *buf);

         Restores the screen and cursor information that was placed in
         'buf' by a previous pu_scrnd call.  The 'v_bios' function does
         not apply to this function.


         ---------------------------------------------------------------
         fpu_scrnd -- Move Specified Screen Region To A FAR Buffer
         ---------------------------------------------------------------
            void fpu_scrnd(int row, int col, int nrows, int ncols,
             char _far *buf);

         Same as pu_scrnd except moves screen information to a FAR
         buffer.

         ---------------------------------------------------------------
         fpo_scrnd -- Restore a Screen Saved by 'fpu_scrnd' Function
         ---------------------------------------------------------------
            void fpo_scrnd(char _far *buf);

         Same as po_scrnd except restores data pushed by 'fpo_scrnd'.






         ---------------------------------------------------------------
         pushscrn -- Move Specified Screen Region To A Buffer      ( C )
         ---------------------------------------------------------------
            int pushscrn(int row, int col, int nrows, int ncols);

         C function that utilizes pu_scrnd and malloc to build a last in
         first out stack of up to 10 screens.  Performs the same as
         pu_scrnd except automatically allocates the buffer space.
         C source code is included for this function.  Returns 0 if
         successful, non-zero if an attempt is made to push too many
         screens or the call to malloc space for the screen data fails.


         ---------------------------------------------------------------
         popscrn -- Restore Last Screen Saved by 'pushscrn'        ( C )
         ---------------------------------------------------------------
            int popscrn(void);

         Restores last screen pushed by pushscrn function.  Returns 0 if
         successful or non-zero if an attempt is made to pop a screen
         when no more screens remain in the screen stack.


         ---------------------------------------------------------------
         fpushscrn -- Move Specified Screen Region To FAR Buffer   ( C )
         ---------------------------------------------------------------
            int fpushscrn(int row, int col, int nrows, int ncols);

         Same as pushscrn except the screen buffers are allocated from
         far memory using your compiler's version of a far malloc
         function.  (MSC _fmalloc, Turbo C = farmalloc).  Source code is
         included if you are using a compiler that has a different name
         for the function to do this.


         ---------------------------------------------------------------
         fpopscrn -- Restore Last Screen Saved by 'fpushscrn'      ( C )
         ---------------------------------------------------------------
            int fpopscrn(void);

         Same as popscrn except restores last screen pushed by
         fpushscrn.






         ---------------------------------------------------------------
         moveblk -- Move Screen To Buffer / Buffer To Screen
         ---------------------------------------------------------------
            void moveblk(int row, int col, int nrows, int ncols,
             char *buf, int dirflag);

         This function does the same thing as pu_scrnd and po_scrnd
         combined except it does not save data on the cursor position or
         shape and all args are needed when both saving and restoring.
         The 'dirflag' determines which direction the data is to be
         moved.  If it is NZ, data is transferred from the screen to the
         buffer.  If it is zero, then buffer data is transferred to the
         screen.  The additional 16 bytes of buffer space required by
         pu_scrnd are not required for this function since it does not
         build the header for the screen region and cursor data.


         ---------------------------------------------------------------
         rd_scrn -- Read Attrib/Char At Cursor Position
         ---------------------------------------------------------------
            int rd_scrn(void);

         Reads the attribute and character at the current cursor pos-
         ition.  The attribute is returned in the upper 8 bits of the
         return value and the character in the lower 8 bits.


         ---------------------------------------------------------------
         rd_scrnd -- Read Screen String From Specified Location
         ---------------------------------------------------------------
            char *rd_scrnd(int row, int col, int nbytes, char *buf);

         Reads a string that is a maximum of 'nbytes' long beginning at
         the specified location.  The string is stored in 'buf' and
         trailing spaces are trimmed.  The 'v_bios' variable does not
         apply to this function.  The return value is a pointer to
         'buf'.

         ---------------------------------------------------------------
         cls -- Clear Currently Defined Window
         ---------------------------------------------------------------
            void  cls(void);

         Clears the current window using v_color for the attribute.  Re-
         turns nothing.


         ---------------------------------------------------------------
         scrlup -- Scroll Window Up
         ---------------------------------------------------------------
            void scrlup(int nbrlines);

         Scrolls the current window up the specified number of lines.
         The attribute used for blank lines is 'v_color'.






         ---------------------------------------------------------------
         scrldn -- Scroll Window Down
         ---------------------------------------------------------------
            void scrldn(int nbrlines);
         Same as previous function except scrolls down.


         ---------------------------------------------------------------
         scrlupat -- Scroll Specified Area Up
         ---------------------------------------------------------------
            void scrlup(int top, int lft, int btm, int rgt, int nlines);

         Same as previous scrlup function except instead of using the
         current window, it scrolls the specified area.


         ---------------------------------------------------------------
         scrldnat -- Scroll Specified Area Down
         ---------------------------------------------------------------
            void scrldn(int nbrlines);
         Same as previous scrldn function except instead of using the
         current window, it scrolls the specified area.


         ---------------------------------------------------------------
         setcurloc -- Set Cursor Location
         ---------------------------------------------------------------
            void setcurloc(int location);

         Similar to loc(), but this function passes the row and column
         one variable with the upper 8 bits being the row and the lower
         8 bits the column.  This function is used in conjunction with
         getcurloc() to save and restore the cursor position.


         ---------------------------------------------------------------
         getcurloc -- Get Cursor Location
         ---------------------------------------------------------------
            int getcurloc(void);

         Returns the cursor location as an integer.  The upper 8 bits is
         the row, and the lower 8 bits is the column.


         ---------------------------------------------------------------
         setcursiz -- Set Cursor Size
         ---------------------------------------------------------------
            void setcursiz(int);

         Sets the starting and ending scan lines for the cursor. The
         upper 8 bits are the starting scan line and the lower 8 bits
         are the ending scan line.






         ---------------------------------------------------------------
         getcursiz -- Get Cursor Size
         ---------------------------------------------------------------
            int getcursiz(void);

         Returns the current starting and ending scan lines of the cur-
         sor.  The high bits are the starting scan line and the lower 8
         bits are the ending scan line.


         ---------------------------------------------------------------
         setvmode -- Set Video Mode
         ---------------------------------------------------------------
            void setvmode(int mode);

         Sets the video mode to 'mode'.  The only modes that these func-
         tions will work in, however, are the 80 x 25 text modes.