lcdtest: LCD monitor test pattern generator
README
Copyright 2005 Eric Smith <eric()brouhaha.com>
(OS4 Port by Curtis Holborn, curtyh()talktalk.net)
$Id: README 22 2005-05-20 08:01:53Z eric $


lcdtest is a utility to display LCD monitor test patterns.  It may be
useful for adjusting the pixel clock frequency and phase on LCD
monitors when using analog inputs, and for finding pixels that are
stuck on or off.  lctest uses the SDL library, and has only been
tested on Linux with X, but may work on other platforms.


Usage:

  lcdtest [options]


Options:

  --help         get list of command keys
  --list-modes   list available video resolutions
  --window       display in a window rather than full screen
  -x <count>     use a video mode with the specified horizontal resolution
  -y <count>     use a video mode with the specified vertical resolution


Operation:

  Upon startup, lcdtest will fill the screen solid red.  Pressing keys on
  the keyboard will change the pattern:

    Change foreground color:
        r:  red
        g:  green
        b:  blue
        w:  white
        k:  black
    
    Change pattern:
        s:  solid fill
        h:  horizontal lines
        v:  vertical lines
        c:  crosshatch
 a:  white vertical lines with two pixel pitch

    arrow keys: move lines in arrow direction

    plus:   increase spacing between lines
    minus:  decrease spacing between lines
    0..9:   select predefined line spacings

    ? or /:  toggle display of help message //OS4 Disabled

    q or Escape: exit program


  The "a" command is specifically intended for use with LCD monitors
  connected via an analog VGA (vs. DVI).  This pattern should work
  well for the monitor auto-setup feature.  Auto-setup may not get the
  frequency and phase adjusted optimally, in which case this pattern is
  also useful for manual adjustment.


Dependencies:

  libSDL:
    http://www.libsdl.org/

  SFont and the 14P_Arial_Plain_Red.png font (included):
    http://www.linux-games.com/sfont/


Acknowledgements:

  Ian Morgan provided a patch to enable key repeat.


License:

  This program is free software; you can redistribute it and/or modify
  it under the terms of the GNU General Public License version 2 as
  published by the Free Software Foundation.  Note that permission is
  not granted to redistribute this program under the terms of any other
  version of the General Public License.

  This program is distributed in the hope that it will be useful, but
  WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  General Public License for more details.

  You should have received a copy of the GNU General Public License
  along with this program; if not, write to the Free Software
  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                31836   32830  97.0% -lh5- 1277 Aug  5 20:11 lcdtest-1.01.info
[generic]                10833   10918  99.2% -lh5- 3693 May 20  2005 lcdtest-1.01/14P_Arial_Plain_Red.png
[generic]                 6993   17982  38.9% -lh5- dc3e May 20  2005 lcdtest-1.01/COPYING
[generic]               762794 1733183  44.0% -lh5- bf5c Jul 23 19:38 lcdtest-1.01/LCDTest
[generic]                 3909   14460  27.0% -lh5- 7d62 Jul 15 23:51 lcdtest-1.01/lcdtest.c
[generic]                 3818    3818 100.0% -lh0- 7e44 Aug  5 20:05 lcdtest-1.01/LCDTest.info
[generic]                 1019    2009  50.7% -lh5- 07b7 May 20  2005 lcdtest-1.01/Makefile
[generic]                 1431    2849  50.2% -lh5- d9dd Aug  5 20:10 lcdtest-1.01/README
[generic]                 2378    2411  98.6% -lh5- f2d5 Aug  5 20:05 lcdtest-1.01/README.info
[generic]                 1829    5398  33.9% -lh5- ad13 Jul 15 23:52 lcdtest-1.01/SFont.c
[generic]                 1335    3529  37.8% -lh5- 2396 May 20  2005 lcdtest-1.01/SFont.h
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        11 files  828175 1829387  45.3%            Aug  7 15:25