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:

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:

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"