SDL interface

Documentation

Almost everything in SDL interface is configured by one or more configuration files.
I will try to explain the options in the current version of SDL interface (0.5 pre-rc)
Hopefully this documentation helps the pre-rc testers making themes and/or configuring menu's
If you find anything missing or incorrect , please mail me

All reference to filenames can be an absolute or relative. ( themes/default.theme or /home/user/interface/themes/default.theme )

main.conf

This file must be placed in the workdir of SDL interface.

x = 640
y = 480
bits = 32
theme = themes/default.theme
menu = menu.conf
associations = associations.conf

- x = 640
- y = 480

The resolution in which SDL interface will try to run.
Smaller resolutions , like 640x200 , will be placed on the most fitting screen resolution possible.

- bits = 32

The bits per pixel that SDL interface will attempt to get.
You could also just leave this to 32 bits when your Xserver just supports 16bits , but it might be a bit slower.

- theme = themes/default.theme

The themefile that SDL interface will use.

- menu = menu.conf

The menufile that SDL interface will use.

- associations = associations.conf

The associationsfile that SDL interface will use.

theme file

This file can be anywhere really , referred to by main.conf.

wallpaper = themes/ice.png
stretch = 1
font = themes/VeraBd.ttf
fontsize = 30
fontnormal = 32 64 92
fontselected = 16 92 128
center = 0 0
max_items = 6
spacing = 20

- wallpaper = themes/ice.png

The background for this theme.

- stretch = 1

If the background should be stretched to fit the screen or not.

- font = themes/VeraBd.ttf
- fontsize = 30

The truetype font for this theme and its size.

- fontnormal = 32 64 92
- fontselected = 16 92 128

The colors for the font, in R G B decimal format. ( 255 255 255 is white , 0 0 0 is black )

- center = 0 0

The center coordinate for the menu , or 0 0 for the center of screen.

- max_items = 6

Maximum nummer of items displayed at once.

- spacing = 20

The 'line spacing' between the menu items , in pixels.

menu file

This file can be anywhere really , referred to by main.conf.
Every line is [type] (title) "parameter". Title will be displayed on screen to the user.

[dir] (videos!) "/mnt/videos/"
[exec] (xlogo) "xlogo"
[quit] (quit) ""

- [dir] (videos!) "/mnt/videos/"

This will open a new menu with the files in /mnt/videos/.

- [exec] (xlogo) "xlogo"

This will execute xlogo and return to the menu when it is closed.

- [quit] (quit) ""

This will exit SDL interface.

associations file

This file can be anywhere really , referred to by main.conf.
Every line is [type] "command prefix".

[mpeg] "mplayer "
[jpg] "fbi "

Example :

/dir/file.mpeg gets chosen.
it gets associated with "mplayer "
SDL interface will call 'mplayer "/dir/file.mpeg"'