In the master branch, the theme/Default directory contains the basic files needed for a theme. The two font directories need to be bundled into font files and all the files need to be bundled into one theme file (using makebundle). This can be automatized with the DIY kit (see below.)

DIY kit

Use this theme kit to easily create new themes based on the Default theme. It's as easy as editing a few image files, and then double-clicking on a batch file that does the bundling for you.

Theme file contents

RGB 255 0 255 is the magic color for transparency (because it's a horrible color and should never be used.)

You can include either BMP or PNG version of any image file in the theme. E.g. if bevel.bmp doesn't exist in the theme, bevel.png will be used instead.

Files and colors that do not exist in a theme will be taken from the default theme.

colors.txt

This file contains the text color definitions. The while should contain definitions in the following format, each on its own line:

color_name = 0xffffff
another_color_name = 0x808080

The hexadecimal number is a RGB value.

You can also define color like this:

color_name = another_color_name

You can do this only after another_color_name has been defined.

bevel.bmp

This is the main graphics file. The first row has different bevel (patterned rectangle) styles, the bottom row has button decals. The bevels generally have a 4 pixel wide border and a 8x8 center that is repeated. Everything has to be 16x16.

Here are the horizontal indices (leftmost tile index is zero) for the graphics:

• bevdefs.h
• mybevdefs.h

vu.bmp

This file contains the VU meter graphics. The dimensions can be anything as long as they fit inside the pattern area.

analyzor.bmp

This is the spectrum analyzer bar. The left side of the image is used as the "enabled" graphic and the right side is the "disabled" graphic. I.e. the right side is what is drawn in any case and the left side is the actual bar that's drawn over the disabled gfx.

The actual width of the bar will be the image width divided by two (since half of the image is the disabled graphic).

logo.bmp

8x8.fnt, 7x6.fnt, tiny

The fonts can be changed but it is recommended that they have the same dimensions as the originals and that at least the 8x8 font is fixed width. Refer to the klystron manual for more information on the font file format.