drivers/video/console/fbcon.h

   1 /*
   2  *  linux/drivers/video/console/fbcon.h -- Low level frame buffer based console driver
   3  *
   4  *      Copyright (C) 1997 Geert Uytterhoeven
   5  *
   6  *  This file is subject to the terms and conditions of the GNU General Public
   7  *  License.  See the file COPYING in the main directory of this archive
   8  *  for more details.
   9  */
  10
  11 #ifndef _VIDEO_FBCON_H
  12 #define _VIDEO_FBCON_H
  13
  14 #include <linux/config.h>
  15 #include <linux/types.h>
  16 #include <linux/vt_buffer.h>
  17 #include <linux/vt_kern.h>
  18
  19 #include <asm/io.h>
  20
  21 #define FBCON_FLAGS_INIT         1
  22 #define FBCON_FLAGS_CURSOR_TIMER 2
  23
  24    /*
  25     *    This is the interface between the low-level console driver and the
  26     *    low-level frame buffer device
  27     */
  28
  29 struct display {
  30     /* Filled in by the low-level console driver */
  31     const u_char *fontdata;
  32     int userfont;                   /* != 0 if fontdata kmalloc()ed */
  33     u_short scrollmode;             /* Scroll Method */
  34     u_short inverse;                /* != 0 text black on white as default */
  35     short yscroll;                  /* Hardware scrolling */
  36     int vrows;                      /* number of virtual rows */
  37     int cursor_shape;
  38     int con_rotate;
  39     u32 xres_virtual;
  40     u32 yres_virtual;
  41     u32 height;
  42     u32 width;
  43     u32 bits_per_pixel;
  44     u32 grayscale;
  45     u32 nonstd;
  46     u32 accel_flags;
  47     u32 rotate;
  48     struct fb_bitfield red;
  49     struct fb_bitfield green;
  50     struct fb_bitfield blue;
  51     struct fb_bitfield transp;
  52     struct fb_videomode *mode;
  53 };
  54
  55 extern struct display fb_display[];
  56
  57 struct fbcon_ops {
  58         void (*bmove)(struct vc_data *vc, struct fb_info *info, int sy,
  59                       int sx, int dy, int dx, int height, int width);
  60         void (*clear)(struct vc_data *vc, struct fb_info *info, int sy,
  61                       int sx, int height, int width);
  62         void (*putcs)(struct vc_data *vc, struct fb_info *info,
  63                       const unsigned short *s, int count, int yy, int xx,
  64                       int fg, int bg);
  65         void (*clear_margins)(struct vc_data *vc, struct fb_info *info,
  66                               int bottom_only);
  67         void (*cursor)(struct vc_data *vc, struct fb_info *info,
  68                        struct display *p, int mode, int softback_lines,
  69                        int fg, int bg);
  70         int  (*update_start)(struct fb_info *info);
  71         int  (*rotate_font)(struct fb_info *info, struct vc_data *vc,
  72                             struct display *p);
  73         struct fb_var_screeninfo var;  /* copy of the current fb_var_screeninfo */
  74         struct timer_list cursor_timer; /* Cursor timer */
  75         struct fb_cursor cursor_state;
  76         int    currcon;                 /* Current VC. */
  77         int    cursor_flash;
  78         int    cursor_reset;
  79         int    blank_state;
  80         int    graphics;
  81         int    flags;
  82         int    rotate;
  83         int    cur_rotate;
  84         char  *cursor_data;
  85         u8    *fontbuffer;
  86         u8    *fontdata;
  87         u32    fd_size;
  88 };
  89     /*
  90      *  Attribute Decoding
  91      */
  92
  93 /* Color */
  94 #define attr_fgcol(fgshift,s)    \
  95         (((s) >> (fgshift)) & 0x0f)
  96 #define attr_bgcol(bgshift,s)    \
  97         (((s) >> (bgshift)) & 0x0f)
  98 #define attr_bgcol_ec(bgshift,vc) \
  99         ((vc) ? (((vc)->vc_video_erase_char >> (bgshift)) & 0x0f) : 0)
 100 #define attr_fgcol_ec(fgshift,vc) \
 101         ((vc) ? (((vc)->vc_video_erase_char >> (fgshift)) & 0x0f) : 0)
 102
 103 /* Monochrome */
 104 #define attr_bold(s) \
 105         ((s) & 0x200)
 106 #define attr_reverse(s) \
 107         ((s) & 0x800)
 108 #define attr_underline(s) \
 109         ((s) & 0x400)
 110 #define attr_blink(s) \
 111         ((s) & 0x8000)
 112
 113 /* Font */
 114 #define REFCOUNT(fd)    (((int *)(fd))[-1])
 115 #define FNTSIZE(fd)     (((int *)(fd))[-2])
 116 #define FNTCHARCNT(fd)  (((int *)(fd))[-3])
 117 #define FNTSUM(fd)      (((int *)(fd))[-4])
 118 #define FONT_EXTRA_WORDS 4
 119
 120     /*
 121      *  Scroll Method
 122      */
 123
 124 /* There are several methods fbcon can use to move text around the screen:
 125  *
 126  *                     Operation   Pan    Wrap
 127  *---------------------------------------------
 128  * SCROLL_MOVE         copyarea    No     No
 129  * SCROLL_PAN_MOVE     copyarea    Yes    No
 130  * SCROLL_WRAP_MOVE    copyarea    No     Yes
 131  * SCROLL_REDRAW       imageblit   No     No
 132  * SCROLL_PAN_REDRAW   imageblit   Yes    No
 133  * SCROLL_WRAP_REDRAW  imageblit   No     Yes
 134  *
 135  * (SCROLL_WRAP_REDRAW is not implemented yet)
 136  *
 137  * In general, fbcon will choose the best scrolling
 138  * method based on the rule below:
 139  *
 140  * Pan/Wrap > accel imageblit > accel copyarea >
 141  * soft imageblit > (soft copyarea)
 142  *
 143  * Exception to the rule: Pan + accel copyarea is
 144  * preferred over Pan + accel imageblit.
 145  *
 146  * The above is typical for PCI/AGP cards. Unless
 147  * overridden, fbcon will never use soft copyarea.
 148  *
 149  * If you need to override the above rule, set the
 150  * appropriate flags in fb_info->flags.  For example,
 151  * to prefer copyarea over imageblit, set
 152  * FBINFO_READS_FAST.
 153  *
 154  * Other notes:
 155  * + use the hardware engine to move the text
 156  *    (hw-accelerated copyarea() and fillrect())
 157  * + use hardware-supported panning on a large virtual screen
 158  * + amifb can not only pan, but also wrap the display by N lines
 159  *    (i.e. visible line i = physical line (i+N) % yres).
 160  * + read what's already rendered on the screen and
 161  *     write it in a different place (this is cfb_copyarea())
 162  * + re-render the text to the screen
 163  *
 164  * Whether to use wrapping or panning can only be figured out at
 165  * runtime (when we know whether our font height is a multiple
 166  * of the pan/wrap step)
 167  *
 168  */
 169
 170 #define SCROLL_MOVE        0x001
 171 #define SCROLL_PAN_MOVE    0x002
 172 #define SCROLL_WRAP_MOVE   0x003
 173 #define SCROLL_REDRAW      0x004
 174 #define SCROLL_PAN_REDRAW  0x005
 175
 176 #ifdef CONFIG_FB_TILEBLITTING
 177 extern void fbcon_set_tileops(struct vc_data *vc, struct fb_info *info,
 178                               struct display *p, struct fbcon_ops *ops);
 179 #endif
 180 extern void fbcon_set_bitops(struct fbcon_ops *ops);
 181 extern int  soft_cursor(struct fb_info *info, struct fb_cursor *cursor);
 182
 183 #define FBCON_ATTRIBUTE_UNDERLINE 1
 184 #define FBCON_ATTRIBUTE_REVERSE   2
 185 #define FBCON_ATTRIBUTE_BOLD      4
 186
 187 static inline int real_y(struct display *p, int ypos)
 188 {
 189         int rows = p->vrows;
 190
 191         ypos += p->yscroll;
 192         return ypos < rows ? ypos : ypos - rows;
 193 }
 194
 195
 196 static inline int get_attribute(struct fb_info *info, u16 c)
 197 {
 198         int attribute = 0;
 199
 200         if (fb_get_color_depth(&info->var, &info->fix) == 1) {
 201                 if (attr_underline(c))
 202                         attribute |= FBCON_ATTRIBUTE_UNDERLINE;
 203                 if (attr_reverse(c))
 204                         attribute |= FBCON_ATTRIBUTE_REVERSE;
 205                 if (attr_bold(c))
 206                         attribute |= FBCON_ATTRIBUTE_BOLD;
 207         }
 208
 209         return attribute;
 210 }
 211
 212 #define FBCON_SWAP(i,r,v) ({ \
 213         typeof(r) _r = (r);  \
 214         typeof(v) _v = (v);  \
 215         (void) (&_r == &_v); \
 216         (i == FB_ROTATE_UR || i == FB_ROTATE_UD) ? _r : _v; })
 217
 218 #ifdef CONFIG_FRAMEBUFFER_CONSOLE_ROTATION
 219 extern void fbcon_set_rotate(struct fbcon_ops *ops);
 220 #else
 221 #define fbcon_set_rotate(x) do {} while(0)
 222 #endif /* CONFIG_FRAMEBUFFER_CONSOLE_ROTATION */
 223
 224 #endif /* _VIDEO_FBCON_H */
 225