Lucian Muresan

# The glcdlib Driver

This section talks about using LCDproc with LCD displays supported by graphlcd-base.

## Connections

The so-called "meta-driver" glcdlib extends LCDproc's supported drivers by all the drivers supported by graphlcd-base, which you can get from .

In order to be able to use it, you have to get and install the glcdprocdriver from before configuring the LCDproc build process --enable-drivers=glcdlib.

## Configuration in LCDd.conf

### [glcdlib]

### Mandatory settings

`Driver` = ``GRAPHLCD-DRIVER``

- Specify which graphical display supported by graphlcd-base to use. Legal values for `GRAPHLCD-DRIVER` are specified in graphlcd's configuration file `/etc/graphlcd.conf`. For graphlcd 0.13 they comprise `avrctl`, `framebuffer`, `gu140x32f`, `gu256x64-372`, `gu256x64C-3xx0`, `hd61830`, `image`, `ks0108`, `noritake800`, `sed1330`, `sed1520`, `serdisp`, `simlcd`, and `t6963c`. If not specified it defaults to `image`.

`UseFT2` = ¶meters.yesdefno;

- Tell whether to use FreeType2 or not. If set to `no` use graphlcd's bitmap fonts, which is only one size/font file. If set to to the default value `yes` use the fonts that FreeType2 provides.

  Setting it to `yes` requires Freetype2 support in libglcdprocdriver and its dependants.

`TextResolution` = ¶meters.size;

- Give text resolution in fixed width characters. If it won't fit according to the available physical pixel resolution and the minimum available font face size in pixels, 'DebugBorder' will automatically be turned on. If not specified, it defaults to `16x4`.

`FontFile` = ``FILENAME``

- Set path to font file to use, e.g. `/usr/share/fonts/corefonts/courbd.ttf`.

### Availalble parameters if `UseFT2` = `yes`

`CharEncoding` = ``CHARSET``

- Specify character encoding to use, e.g. `iso8859-2`. If not given, use the default `ISO8859-1`.

`MinFontFaceSize` = ``COLUMNS` `x` `ROWS``

- minimum size in pixels in which fonts should be rendered

### Optional settings

`Brightness` = ``BRIGHTNESS``

- Brightness (in %) if applicable Legal values are `0` - `100`. If not specified, the default is `50`.

`Contrast` = ``CONTRAST``

- Set the contrast (in %) if applicable. Legal values are `0` - `100`, with `50` being the default when not specified.

`Backlight` = ¶meters.yesnodef;

- Backlight if applicable

`UpsideDown` = ¶meters.yesnodef;

- flip image upside down

`Invert` = ¶meters.yesnodef;

- invert light/dark pixels

`ShowDebugFrame` = ¶meters.yesnodef;

- turns on/off 1 pixel thick debugging border within the usable text area, for setting up TextResolution and MinFontFaceSize (if using FT2);

`ShowBigBorder` = ¶meters.yesnodef;

- border around the unused area

`ShowThinBorder` = ¶meters.yesnodef;

- border around the unused area

`PixelShiftX` = ``SHIFTX``

`PixelShiftY` = ``SHIFTY``

- Shifts the content of the display by `SHIFTX` (default: `0`) and `SHIFTY` (default: `0`) pixels.