Tutorial: Theming Files

Theme Configuration File

A configuration file in <qt-extended-root-dir>/etc/themes/ is required to define a theme as follows:

    [Theme]
    Name = <name of theme (translatable)>
    Style = <name of the Style plug-in that handles widget drawing>
    ColorScheme = <list of color schemes associated with the theme>
    Backgrounds = <list of background images associated with the theme>
    TitleConfig = <path to the title configuration file>
    HomeConfig = <path to the home screen configuration file>
    ContextConfig = <path to the context bar configuration file>
    DialerConfig = <path to the touch screen dialer configuration file>
    CallScreenConfig = <path to the call screen configuration file>
    DecorationConfig = <path to the window decoration configuration file>
    SecondaryTitleConfig = <optional - path to the secondary title configuration file>
    SecondaryHomeConfig = <optional - path to the secondary home screen configuration file>
    BootChargerConfig = <path to the boot charger configuration file>
    IconPath = <list of semi-colon separated paths to substitute icons>

All paths are relative to the etc/themes directory except IconPath which is relative to <qt-extended-root-dir>.

For example, the Qtopia theme is defined by: <qt-extended-root-dir>/etc/themes/qtopia.conf:

    [Theme]
    Name[] = Qtopia
    Style = Qtopia
    HeaderSize = 0.145
    ContextSize = 0.09
    ColorScheme = Qtopia.scheme|Carmine.scheme|Crisp.scheme|Fern.scheme|Lavender.scheme|Saffron.scheme|SteelBlue.scheme
    Backgrounds = background|ladybug
    ExtendedFocusHighlight = 1
    FormStyle = QtopiaDefaultStyle
    PopupShadows = 0
    HideMenuIcons = 1
    FullWidthMenu = 1
    TitleConfig = qtopia/title.xml
    HomeConfig = qtopia/home.xml
    ContextConfig = qtopia/context.xml
    DialerConfig = qtopia/dialer.xml
    CallScreenConfig = qtopia/callscreen.xml
    DecorationConfig = qtopia/decorationrc
    SecondaryTitleConfig = qtopia/secondarytitle.xml
    SecondaryHomeConfig = qtopia/secondaryhome.xml
    BootChargerConfig = qtopia/bootcharger.xml
    [Translation]
    File=QtopiaThemes
    Context=Themes

The title, home screen, call screen, dialer and context bar share the same theming format while the window decoration and widget themes have their own formats.