aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/VGA-softcursor.txt
diff options
context:
space:
mode:
authorLinus Torvalds <torvalds@ppc970.osdl.org>2005-04-16 18:20:36 -0400
committerLinus Torvalds <torvalds@ppc970.osdl.org>2005-04-16 18:20:36 -0400
commit1da177e4c3f41524e886b7f1b8a0c1fc7321cac2 (patch)
tree0bba044c4ce775e45a88a51686b5d9f90697ea9d /Documentation/VGA-softcursor.txt
Linux-2.6.12-rc2v2.6.12-rc2
Initial git repository build. I'm not bothering with the full history, even though we have it. We can create a separate "historical" git archive of that later if we want to, and in the meantime it's about 3.2GB when imported into git - space that would just make the early git days unnecessarily complicated, when we don't have a lot of good infrastructure for it. Let it rip!
Diffstat (limited to 'Documentation/VGA-softcursor.txt')
-rw-r--r--Documentation/VGA-softcursor.txt39
1 files changed, 39 insertions, 0 deletions
diff --git a/Documentation/VGA-softcursor.txt b/Documentation/VGA-softcursor.txt
new file mode 100644
index 000000000000..70acfbf399eb
--- /dev/null
+++ b/Documentation/VGA-softcursor.txt
@@ -0,0 +1,39 @@
1Software cursor for VGA by Pavel Machek <pavel@atrey.karlin.mff.cuni.cz>
2======================= and Martin Mares <mj@atrey.karlin.mff.cuni.cz>
3
4 Linux now has some ability to manipulate cursor appearance. Normally, you
5can set the size of hardware cursor (and also work around some ugly bugs in
6those miserable Trident cards--see #define TRIDENT_GLITCH in drivers/video/
7vgacon.c). You can now play a few new tricks: you can make your cursor look
8like a non-blinking red block, make it inverse background of the character it's
9over or to highlight that character and still choose whether the original
10hardware cursor should remain visible or not. There may be other things I have
11never thought of.
12
13 The cursor appearance is controlled by a "<ESC>[?1;2;3c" escape sequence
14where 1, 2 and 3 are parameters described below. If you omit any of them,
15they will default to zeroes.
16
17 Parameter 1 specifies cursor size (0=default, 1=invisible, 2=underline, ...,
188=full block) + 16 if you want the software cursor to be applied + 32 if you
19want to always change the background color + 64 if you dislike having the
20background the same as the foreground. Highlights are ignored for the last two
21flags.
22
23 The second parameter selects character attribute bits you want to change
24(by simply XORing them with the value of this parameter). On standard VGA,
25the high four bits specify background and the low four the foreground. In both
26groups, low three bits set color (as in normal color codes used by the console)
27and the most significant one turns on highlight (or sometimes blinking--it
28depends on the configuration of your VGA).
29
30 The third parameter consists of character attribute bits you want to set.
31Bit setting takes place before bit toggling, so you can simply clear a bit by
32including it in both the set mask and the toggle mask.
33
34Examples:
35=========
36
37To get normal blinking underline, use: echo -e '\033[?2c'
38To get blinking block, use: echo -e '\033[?6c'
39To get red non-blinking block, use: echo -e '\033[?17;0;64c'