|
Skin Creation Guide - WinCDG Classic 2
Modified: July 28/2002
Introduction
Skins let you totally change the appearance of the program to almost
anything you want. Skins are replacement images for the main window, playlist,
and preferenced windows. The location and size of the buttons and text cannot change,
however their look and the look around the buttons can be anything you want.
This guide covers skins for WinCDG Classic 2 only.
WinCDG Classic 2 skins are composed of one main skin control file (SFC)
and several graphical bitmap files. The names of the bitmap files can be anything
and are specified in the SFC file.
The SFC File
The SFC file is a text file with a specific format. The file contains exactly 14 lines as
described below:
| Line 1 | Skin header string "WINCDG CLASSIC 2 SKIN" |
| Line 2 | Color 1: Playlist Foreground Colour |
| Line 3 | Color 2: Playlist Background Colour |
| Line 4 | Color 3: Main window Labels (ie: "Title:", "Artist:", "Time:" text) |
| Line 5 | Color 4: Main window Data (ie: the actual song title, artise and elapsed time) |
| Line 6 | Color 5: Playlist Highlighted Colour |
| Line 7 | Color 6: Transparent Bitmap Colour |
| Line 8 | Bitmap 1: Main window BACKGROUND picture filename |
| Line 9 | Bitmap 2: Main window DOWN picture filename |
| Line 10 | Bitmap 3: Main window SELECTED picture filename |
| Line 11 | Bitmap 4: Playlist window BACKGROUND Picture filename |
| Line 12 | Bitmap 5: Playlist window UP Picture filename |
| Line 13 | Bitmap 6: Playlist window UP Picture filename |
| Line 14 | Bitmap 7: Preferences BACKGROUND picture filename |
Colour Values
Colours are defined using values for the three primary colour components
RED, GREEN, and BLUE. Each of these components has a range of 0 to 255. Specify
the three values in the skin with a comma between each like this:
R,G,B
255,255,255
Some common colours:
| Colour | RED | GREEN | BLUE |
| Black | 0 | 0 | 0 |
| Red | 255 | 0 | 0 |
| Green | 0 | 255 | 0 |
| Blue | 0 | 0 | 255 |
| Cyan | 255 | 255 | 0 |
| Yellow | 0 | 255 | 255 |
| Purple | 255 | 0 | 255 |
| Grey | 128 | 128 | 128 |
Bitmap Files
The Bitmap picture files can be either BMP, GIF, or JPG files. Specify the name
of the file with the extension, but do not specify the path to the file.
There are three types of bitmaps representing the three states that a button
can be:
- UP - This is the normal button state. This is also known as the BACKGROUND picture
- DOWN - The button when pressed (or the mouse moves over it)
- SELECTED - The button when selected (ie: when the feature is turned on).
Making a Non-Rectangular Skin
Although the three window that normally rectangular, it is possible to create a skin
that has non-rectangular windows or windows with "holes". To do this you must
draw the UP Bitmap using a UNIQUE colour to define the part of the window that
is to be transparent. Make sure you use a colour that does not occur anywhere else on the
bitmap. The RGB values that make up that colour are specified for COLOUR 6 in the SFC file.
When the skin loads, any pixel that is drawn in that colour ON ANY of the THREE forms will
appear transparent.
Example Skin Control File
The following is an example of a skin control file:
WINCDG CLASSIC 2 SKIN
000,000,000
255,255,255
255,128,255
255,255,000
000,255,255
057,109,165
"cl2-main-up.gif"
"cl2-main-down.gif"
"cl2-main-sel.gif"
"cl2-pl-up.gif"
"cl2-pl-down.gif"
"cl2-pl-sel.gif"
"cl2-prefs.gif"
|
