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