Anatomy of a skin, Mac os x, Windows – Expert Sleepers Augustus Loop v2.4.1 User Manual

Page 43: Bundle structure, Image requirements, The skin script, Getwindowsize()

Advertising
background image

Anatomy of a Skin

Skins use the standard Mac OS X bundle system. Since this is essentially just a folder hier-
archy with a special structure, this works just fine on Windows as well.

Augustus Loop looks for skins in standard locations:

Mac OS X

Augustus Loop looks for skins in

Library/Application Support/Expert Sleepers/Augustus Loop/Skins

Windows

Augustus Loop looks for skins in

C:\Documents and Settings\<username>\Application Data\Expert
Sleepers\Augustus Loop\Skins

Bundle structure

Inside the bundle’s folder, there is a Contents
folder, and inside that, a Resources folder. The Re-
sources folder must contain the script file, which
must be called gui.lua, and may contain image
files.

The Contents folder may also contain an
‘Info.plist’ file. This is a convention for Mac OS X
bundles but is not required by the skin system.

Image requirements

Images used in skins should be in PNG format, and must be power-of-two sized in both
width and height (e.g. 32x32, 128x16, 64x256).

The Skin Script

The script file

gui.lua

must define five functions which are called by the system at the

appropriate times. (The script may also define any other functions it requires for its own
purposes.)

getWindowSize()

This function should simply return two numbers, which are the width and height of the
GUI. E.g.

function getWindowSize()

Advertising