The glcdlib Driver

Lucian Muresan

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 http://graphlcd.berlios.de.

In order to be able to use it, you have to get and install the glcdprocdriver from http://www.muresan.de/graphlcd/lcdproc/ 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 = { yes | no }

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.

Note

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

TextResolution = WIDTH x HEIGHT

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 = { yes | no }

Backlight if applicable

UpsideDown = { yes | no }

flip image upside down

Invert = { yes | no }

invert light/dark pixels

ShowDebugFrame = { yes | no }

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

ShowBigBorder = { yes | no }

border around the unused area

ShowThinBorder = { yes | no }

border around the unused area

PixelShiftX = SHIFTX , PixelShiftY = SHIFTY

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