MemeCode - Lgi Configuration

About

This page describes the Lgi configuration file. It allows the user to customize the options that the library supplies whether or not the application using the library gives you access to those options. Basically their are 3 things you can configure at the moment, the fonts, the language and the the colours. Eventually you'll be able to specify skinning options in this config file as well, but at the moment thats not implemented.

The syntax of the file is based around XML (pretty much the same concept as HTML), and as such it's a simple text file that you can create with any text editor. Just save a text file into the same directory as the application you want to configure calling the file 'lgi.conf' and the library will find and use it.

The options:

Fonts:
```
<font-[type] face='[face]' point=[pointsize]>
<font-system glyph_sub=[sub]>
```
Where:
- [type] is one of: 'system', 'menu' or 'small'
- [face] is the fonts name and
- [pointsize] is the point size of the font.
- [sub] is a boolean (0 or 1) indicating whether LGI should attempt to substitute missing glyphs from other fonts in the system.
Language:
```
<language id=[language code]>
```
Where:
- [language code] is one of (at least for Scribe)
  - English (Code: 13)
  - French (Code: 18)
  - Chinese (Code: 8)
  - Italian (Code: 47)
  - Czech (Code: 10)
  - Spanish (Code: 61)
  - German (Code: 38)
  - Dutch (Code: 12, available in v1.51)
Colours:
```
<colour-[type] hex='[colour]'>
```
Where:
- [type] is one of
  - LC_SHADOW - 3d edging colour
  - LC_LOW - 3d edging colour
  - LC_MED - main dialog colour
  - LC_HIGH - 3d edging colour
  - LC_LIGHT - 3d edging colour
  - LC_WORKSPACE - main window background
  - LC_TEXT - default text colour
  - LC_SELECTION - selection colour
  - LC_SEL_TEXT - selected text colour
  - LC_ACTIVE_TITLE - not implemented yet
  - LC_ACTIVE_TITLE_TEXT - not implemented yet
  - LC_INACTIVE_TITLE - not implemented yet
  - LC_INACTIVE_TITLE_TEXT - not implemented yet
- [colour] is a hex colour (same as HTML) in the format 'rrggbb'.

An example lgi.conf file (for a Win32 system):

	<options>
		<font-system	face="georgia"
				point=9>
		<font-menu	face="georgia"
				point=8>
		<font-small	face="helvetica"
				point=7>

		<language	id=18>

		<colour-LC_SHADOW hex="422763">
		<colour-LC_LOW hex="7a54a9">
		<colour-LC_MED hex="bca9d4">
		<colour-LC_HIGH hex="ddd4e9">
		<colour-LC_LIGHT hex="ffffff">
		<colour-LC_WORKSPACE hex="ebe6f2">
		<colour-LC_TEXT hex="351f4f">
		<colour-LC_SELECTION hex="bf6793">
		<colour-LC_SEL_TEXT hex="ffffff">
		<colour-LC_ACTIVE_TITLE hex="703aec">
		<colour-LC_ACTIVE_TITLE_TEXT hex="ffffff">
		<colour-LC_INACTIVE_TITLE hex="808080">
		<colour-LC_INACTIVE_TITLE_TEXT hex="404040">
	</options>

Sitemap