README
1lcdtest: LCD monitor test pattern generator
2README
3Copyright 2005, 2007, 2010 Eric Smith <eric@brouhaha.com>
4$Id: README 44 2010-01-26 06:28:14Z eric $
5
6
7lcdtest is a utility to display LCD monitor test patterns. It may be
8useful for adjusting the pixel clock frequency and phase on LCD
9monitors when using analog inputs, and for finding pixels that are
10stuck on or off. lctest uses the SDL library.
11
12
13Usage:
14
15 lcdtest [options]
16
17
18Options:
19
20 --help get list of command keys
21 --list-modes list available video resolutions
22 --window display in a window rather than full screen
23 -x <count> use a video mode with the specified horizontal resolution
24 -y <count> use a video mode with the specified vertical resolution
25
26
27Operation:
28
29 Upon startup, lcdtest will fill the screen solid red. Pressing keys on
30 the keyboard will change the pattern:
31
32 Change foreground color:
33 r: red
34 g: green
35 b: blue
36 w: white
37 k: black
38
39 Change pattern:
40 s: solid fill
41 h: horizontal lines
42 v: vertical lines
43 c: crosshatch
44 x: diagonal crosshatch
45 a: white vertical lines with two pixel pitch
46
47 arrow keys: move lines in arrow direction
48
49 plus: increase spacing between lines
50 minus: decrease spacing between lines
51 0..9: select predefined line spacings
52
53 ? or /: toggle display of help message
54
55 q or Escape: exit program
56
57
58 The "a" command is specifically intended for use with LCD monitors
59 connected via an analog VGA (vs. DVI). This pattern should work
60 well for the monitor auto-setup feature. Auto-setup may not get the
61 frequency and phase adjusted optimally, in which case this pattern is
62 also useful for manual adjustment.
63
64
65Dependencies:
66
67 libSDL:
68 http://www.libsdl.org/
69
70 SFont and the 14P_Arial_Plain_Red.png font (included):
71 http://www.linux-games.com/sfont/
72
73
74Incompatible library versions:
75
76 Slava Semushin discovered that some versions of libSDL_image 1.2.5 have
77 a bug that can cause lcdtest to crash with a segmentation fault. The
78 bug is fixed in the libsdl Subversion repository:
79 http://bugzilla.libsdl.org/show_bug.cgi?id=284
80
81
82Binary distribution:
83
84 The author only uses lcdtest on Linux, and does not provide
85 binaries. Steven Wills has compiled lcdtest for Windows:
86 http://steve.mouf.net/blog/?p=631
87
88
89Acknowledgements:
90
91 Ian Morgan provided a patch to enable key repeat.
92 Valerio Felici provided the manual page.
93
94
95License:
96
97 This program is free software; you can redistribute it and/or modify
98 it under the terms of the GNU General Public License version 3 as
99 published by the Free Software Foundation. Note that permission is
100 not granted to redistribute this program under the terms of any other
101 version of the General Public License.
102
103 This program is distributed in the hope that it will be useful, but
104 WITHOUT ANY WARRANTY; without even the implied warranty of
105 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
106 General Public License for more details.
107
108 You should have received a copy of the GNU General Public License
109 along with this program. If not, see <http://www.gnu.org/licenses/>.
110