graphlcd-base/README
author root@rika
Wed, 06 Feb 2008 17:32:55 +0000
changeset 4 df6a40031aa5
permissions -rw-r--r--
added graphlcd-base
     1 This is the base package of the GraphLCD project. It contains
     2  - GraphLCD driver library - libglcddrivers
     3  - GraphLCD graphics library - libglcdgraphics
     4  - GraphLCD tools (crtfont, convpic, showpic, showtext)
     5  - GraphLCD media files (pictures and splash screens in GLCD format, fonts)
     6 
     7 written by Andreas Regel (andreas.regel AT powarman.de)
     8 
     9 based on the graphlcd plugin for the Video Disc Recorder
    10   written by                   Carsten Siebholz (c.siebholz AT t-online.de)
    11   from 0.0.8 on maintained by  Andreas Regel (andreas.regel AT powarman.de)
    12     gu140x32f driver by        Andreas Brachold (vdr04 AT deltab.de)
    13     gu256x64-372 driver by     Andreas Weinberger (vdr AT smue.org)
    14     gu256x64-3xx0 driver by    Ralf Mueller (ralf AT bj-ig.de)
    15     gu126x64D-K610A4 driver by Alexander Rieger (Alexander.Rieger AT inka.de)
    16     image driver by            Andreas Regel (andreas.regel AT powarman.de)
    17     ks0108 driver by           Andreas Weinberger (vdr AT smue.org)
    18     sed1330 driver by          Roland Praml (praml.roland AT t-online.de)
    19                                Heinz Gressenberger (heinz.gressenberger AT stmk.gv.at)
    20     sed1520 driver by          Andreas Weinberger (vdr AT smue.org)
    21     framebuffer driver by      Stephan Skrodzki (skrodzki AT stevekist.de)
    22     serdisplib driver by       Wolfgang Astleitner (mrwastl AT users.sourceforge.net)
    23     t6963c driver by           Andreas Regel (andreas.regel AT powarman.de)
    24     noritake800 drider by      Lucian Muresan (lucianm AT users.sourceforge.net)
    25 
    26 
    27 Project's homepage: http://graphlcd.berlios.de/
    28 
    29 
    30 See the file COPYING for license information.
    31 
    32 
    33 Description
    34 -----------
    35 The GraphLCD base is a project to support graphical LC displays. It is
    36 mainly used by the graphlcd plugin for the Video Disc Recorder to
    37 display its information.
    38 
    39 The GraphLCD driver library supports the following LCD
    40 controllers/modules:
    41  - Hitachi HD61830
    42  - Toshiba T6963
    43  - Samsung KS0108
    44  - Epson SED1520 (only tested with DIP122 lcd module)
    45  - Epson SED1330
    46  - Noritake GU140X32F-7806
    47  - Noritake GU256X64-372
    48  - Noritake GU256X64-3XX0 (serial or parallel)
    49  - Noritake GU126x64D-K610A4 displays (parallel)
    50  - Noritake 800 series displays
    51  - all controllers supported by serdisplib (http://serdisplib.sourceforge.net)
    52 
    53 Other controllers might be supported in the future.
    54 
    55 Additionally the GraphLCD driver library includes some special drivers:
    56  - framebuffer, for devices that are connected to the VGA connector
    57  - image, for writing image sequences in PBM (Portable Bit Map) format that
    58    show the plugin's output.
    59 
    60 
    61 Installation and Configuration:
    62 -------------------------------
    63 1. Unpack the tarball to an arbitrary directory.
    64 
    65   tar xzf graphlcd-base-0.1.2.tgz
    66 
    67 2. Configure if you want FreeType2 support by commenting/uncommenting
    68    HAVE_FREETYPE2 in Make.config.
    69 
    70 3. Compile the libraries and tools.
    71 
    72   make all (from the package's directory)
    73 
    74 4. Install the libraries and tools.
    75 
    76   make install (from the package's directory)
    77 
    78 5. Edit the configuration file graphlcd.conf to fit your needs.
    79 
    80 6. Copy it to the GraphLCD's default configuration search path (/etc).
    81 
    82   cp graphlcd.conf /etc
    83 
    84 
    85 Notes about FreeType2:
    86 ----------------------
    87 If the HAVE_FREETYPE2 variable is defined, then the new method
    88 cFont::LoadFT2(..) from the graphics library will load a FreeType2-supported
    89 font (only TTFs tested so far) and render it into the raster font structure
    90 that cFont uses normally. The method is also defined if no FT2 support is
    91 compiled in, only then it will return false afer logging an error message in
    92 the system log, telling that graphlcd-base has been compiled without FT2
    93 support. This way, applications using this library (vdrplugin-graphlcd, or the
    94 wrapper LCDproc "meta-driver" glcdprocdriver for example, can treat this case
    95 and have a fallback to the glcdraphics-native raster font if FT2 is not
    96 supported, or the TTF font could not be loaded for some reason.
    97