Chapter 5. Theme engines

Table of Contents

1. Exported functions
1.1. metatheme_init
1.2. metatheme_exit
1.3. metatheme_realize
1.4. metatheme_draw_widget
1.5. metatheme_draw_string

This chapters describes elements of a theme engine.

A theme engine is a simple shared library. It is located in the $PREFIX/lib/metatheme/themes/<theme_name>/ directory. Themes are loaded by examining the themerc file in this directory. This file is a simple configuration file with this format:

name        = Redmond 2000
engine      = redmond/libmt_redmond.so
description = Redmond 2000 style
author      = Martin Dvorak <jezek2@advel.cz>

The meaning of the variables is:

name

The full name of theme. This name is showed in the configuration tool.

engine

Theme engine to be used. It is relative to the $PREFIX/lib/metatheme/themes/ directory. There can be more than one theme using the same theme engine.

description

The short description of the theme.

author

The author of theme.

config

The configuration application (optional). It's relative to $PREFIX/lib/metatheme/themes/ directory.