Annotation of Gnu-Mach/i386/i386at/kdsoft.h, revision 1.1.1.3

1.1       root        1: /* 
                      2:  * Mach Operating System
                      3:  * Copyright (c) 1991,1990,1989 Carnegie Mellon University
                      4:  * All Rights Reserved.
                      5:  * 
                      6:  * Permission to use, copy, modify and distribute this software and its
                      7:  * documentation is hereby granted, provided that both the copyright
                      8:  * notice and this permission notice appear in all copies of the
                      9:  * software, derivative works or modified versions, and any portions
                     10:  * thereof, and that both notices appear in supporting documentation.
                     11:  * 
                     12:  * CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS"
                     13:  * CONDITION.  CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND FOR
                     14:  * ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
                     15:  * 
                     16:  * Carnegie Mellon requests users of this software to return to
                     17:  * 
                     18:  *  Software Distribution Coordinator  or  [email protected]
                     19:  *  School of Computer Science
                     20:  *  Carnegie Mellon University
                     21:  *  Pittsburgh PA 15213-3890
                     22:  * 
                     23:  * any improvements or extensions that they make and grant Carnegie Mellon
                     24:  * the rights to redistribute these changes.
                     25:  */
                     26: /* **********************************************************************
                     27:  File:         kdsoft.h
                     28:  Description:  Software structures for keyboard/display driver, shared with
                     29:        drivers for specific graphics cards.
                     30: 
                     31:  $ Header: $
                     32: 
                     33:  Copyright Ing. C. Olivetti & C. S.p.A. 1988, 1989.
                     34:  All rights reserved.
                     35: ********************************************************************** */
                     36: 
                     37: /*
                     38:   Copyright 1988, 1989 by Olivetti Advanced Technology Center, Inc.,
                     39: Cupertino, California.
                     40: 
                     41:                All Rights Reserved
                     42: 
                     43:   Permission to use, copy, modify, and distribute this software and
                     44: its documentation for any purpose and without fee is hereby
                     45: granted, provided that the above copyright notice appears in all
                     46: copies and that both the copyright notice and this permission notice
                     47: appear in supporting documentation, and that the name of Olivetti
                     48: not be used in advertising or publicity pertaining to distribution
                     49: of the software without specific, written prior permission.
                     50: 
                     51:   OLIVETTI DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE
                     52: INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS,
                     53: IN NO EVENT SHALL OLIVETTI BE LIABLE FOR ANY SPECIAL, INDIRECT, OR
                     54: CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
                     55: LOSS OF USE, DATA OR PROFITS, WHETHER IN ACTION OF CONTRACT,
                     56: NEGLIGENCE, OR OTHER TORTIOUS ACTION, ARISING OUR OF OR IN CONNECTION
                     57: WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
                     58: */
                     59: 
1.1.1.3 ! root       60: #ifndef _KDSOFT_H_
        !            61: #define _KDSOFT_H_
        !            62: 
1.1       root       63: /*
1.1.1.2   root       64:  * Globals used for both character-based controllers and bitmap-based
                     65:  * controllers.
                     66:  */
                     67: typedef        short   csrpos_t;       /* cursor position, ONE_SPACE bytes per char */
                     68: 
                     69: extern u_char  *vid_start;     /* VM start of video RAM or frame buffer */
                     70: extern csrpos_t kd_curpos;             /* should be set only by kd_setpos */
                     71: extern short   kd_lines;               /* num lines in tty display */
                     72: extern short   kd_cols;
                     73: extern char    kd_attr;                /* current character attribute */
                     74: 
                     75: 
                     76: /*
                     77:  * Globals used only for bitmap-based controllers.
                     78:  * XXX - probably needs reworking for color.
                     79:  */
                     80: 
                     81: /*
1.1       root       82:  * This driver handles two types of graphics cards.  The first type
                     83:  * (e.g., EGA, CGA), treats the screen as a page of characters and
                     84:  * has a hardware cursor.  The second type (e.g., the Blit) treats the
                     85:  * screen as a bitmap.  A hardware cursor may be present, but it is
                     86:  * ignored in favor of a software cursor.
                     87:  *
                     88:  *
                     89:  * Most of the driver uses the following abstraction for the display:
                     90:  *
                     91:  * The cursor position is simply an index into a (logical) linear char
                     92:  * array that wraps around at the end of each line.  Each character
                     93:  * takes up ONE_SPACE bytes.  Values in [0..ONE_PAGE) are positions in
                     94:  * the displayed page.  Values < 0 and >= ONE_PAGE are off the page
                     95:  * and require some scrolling to put the cursor back on the page.
                     96:  *
                     97:  * The kd_dxxx routines handle the conversion from this abstraction to
                     98:  * what the hardware requires.
                     99:  *
                    100:  * (*kd_dput)(pos, ch, chattr)
                    101:  *     csrpos_t pos;
                    102:  *     char ch, chattr;
                    103:  *  Displays a character at "pos", where "ch" = the character to
                    104:  *  be displayed and "chattr" is its attribute byte.
                    105:  *
                    106:  * (*kd_dmvup)(from, to, count)
                    107:  *     csrpos_t from, to;
                    108:  *     int count;
                    109:  *  Does a (relatively) fast block transfer of characters upward.
                    110:  *  "count" is the number of character positions (not bytes) to move.
                    111:  *  "from" is the character position to start moving from (at the start
                    112:  *  of the block to be moved).  "to" is the character position to start
                    113:  *  moving to.
                    114:  *
                    115:  * (*kd_dmvdown)(from, to, count)
                    116:  *     csrpos_t from, to;
                    117:  *     int count;
                    118:  *  "count" is the number of character positions (not bytes) to move.
                    119:  *  "from" is the character position to start moving from (at the end
                    120:  *  of the block to be moved).  "to" is the character position to
                    121:  *  start moving to.
                    122:  *
                    123:  * (*kd_dclear)(to, count, chattr)
                    124:  *     csrpos_t, to;
                    125:  *     int count;
                    126:  *     char chattr;
                    127:  *  Erases "count" character positions, starting with "to".
                    128:  *
                    129:  * (*kd_dsetcursor)(pos)
                    130:  *  Sets kd_curpos and moves the displayed cursor to track it.  "pos"
                    131:  *  should be in the range [0..ONE_PAGE).
                    132:  *  
                    133:  * (*kd_dreset)()
                    134:  *  In some cases, the boot program expects the display to be in a
                    135:  *  particular state, and doing a soft reset (i.e.,
                    136:  *  software-controlled reboot) doesn't put it into that state.  For
                    137:  *  these cases, the machine-specific driver should provide a "reset"
                    138:  *  procedure, which will be called just before the kd code causes the
                    139:  *  system to reboot.
                    140:  */
                    141: 
1.1.1.2   root      142: extern void bmpput(csrpos_t, char, char);
                    143: extern void bmpmvup(csrpos_t, csrpos_t, int);
                    144: extern void bmpmvdown(csrpos_t, csrpos_t, int);
                    145: extern void bmpclear(csrpos_t, int, char);
                    146: extern void bmpsetcursor(csrpos_t);
1.1       root      147: 
                    148: extern void    (*kd_dput)();           /* put attributed char */
                    149: extern void    (*kd_dmvup)();          /* block move up */
                    150: extern void    (*kd_dmvdown)();        /* block move down */
                    151: extern void    (*kd_dclear)();         /* block clear */
                    152: extern void    (*kd_dsetcursor)();
                    153:                                /* set cursor position on displayed page */
                    154: extern void    (*kd_dreset)();         /* prepare for reboot */
                    155: 
                    156: 
                    157: /*
                    158:  * The following font layout is assumed:
                    159:  *
                    160:  *  The top scan line of all the characters comes first.  Then the
                    161:  *  second scan line, then the third, etc.
                    162:  *
                    163:  *     ------ ... ---------|-----N--------|-------------- ... -----------
                    164:  *     ------ ... ---------|-----N--------|-------------- ... -----------
                    165:  *             .
                    166:  *             .
                    167:  *             .
                    168:  *     ------ ... ---------|-----N--------|-------------- ... -----------
                    169:  *
                    170:  * In the picture, each line is a scan line from the font.  Each scan
                    171:  * line is stored in memory immediately after the previous one.  The
                    172:  * bits between the vertical lines are the bits for a single character
                    173:  * (e.g., the letter "N").
                    174:  * There are "char_height" scan lines.  Each character is "char_width"
                    175:  * bits wide.  We make the simplifying assumption that characters are
                    176:  * on byte boundaries.  (We also assume that a byte is 8 bits.)
                    177:  */
                    178: 
                    179: extern u_char  *font_start;            /* starting addr of font */
                    180: 
                    181: extern short   fb_width;               /* bits in frame buffer scan line */
                    182: extern short   fb_height;              /* scan lines in frame buffer*/
                    183: extern short   char_width;             /* bit width of 1 char */
                    184: extern short   char_height;            /* bit height of 1 char */
                    185: extern short   chars_in_font;
                    186: extern short   cursor_height;          /* bit height of cursor */
                    187:                        /* char_height + cursor_height = line_height */
                    188: 
                    189: extern u_char  char_black;             /* 8 black (off) bits */
                    190: extern u_char  char_white;             /* 8 white (on) bits */
                    191: 
                    192: 
                    193: /*
                    194:  * The tty emulation does not usually require the entire frame buffer.
                    195:  * (xstart, ystart) is the bit address for the upper left corner of the 
                    196:  * tty "screen".
                    197:  */
                    198: 
                    199: extern short   xstart, ystart;
                    200: 
                    201: 
                    202: /*
                    203:  * Accelerators for bitmap displays.
                    204:  */
                    205: 
                    206: extern short   char_byte_width;        /* char_width/8 */
                    207: extern short   fb_byte_width;          /* fb_width/8 */
                    208: extern short   font_byte_width;        /* num bytes in 1 scan line of font */
1.1.1.3 ! root      209: 
        !           210: #endif /* _KDSOFT_H_ */

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.