VOCalendar - Creating Custom Skins
Summary
This tutorial explains how to create custom skins for use in VOCalendar.

Requirements
VOCalendar v1.02 or higher

Links
VOS Homepage
VOCalendar Product Page

1. The skins are defined in a text file with the extension ".VOCalendarSkin".  You can find examples of these files in the skins at http://www.voscorp.com/asp/ppc/vocalendar/skins.  

2. The following values are required in the [Skin] section:

2.1. Name (the name used to represent the skin to the user)

2.2. Author (name of the author)

2.3. Homepage (location of the author's gallery or download location for this skin)

2.4. Version (format of this skin file. Current needs to be "1.0" without the quotes)

3. The [Backgrounds] contains the names of the graphics and their initial translucency strength, from 0 (totally transparent) to 100 (totally opaque). Each month has a single graphic file, which should be 240x240. The graphics are not currently scaled (our translucent drawing routines don't scale images to make them as fast as possible). Larger graphics will be cropped and smaller images will simply have a "black edge" but it's recommended that you just stick to 240x240. BMP, GIF, JPG, PNG and TIF formats are supported.

4. The [DayBar] section defines the "Su M T W Th Fr Sa" graphic. These graphics should be 240x12. You can specify one daybar graphic to be used for all months (by setting a "default=graphic.jpg" entry) or you can specify a different daybar for one or more of the months ("01=graphic01.jpg", "02=graphic02.jpg", one entry per line).

5. Finally, you have the [Month Titles] section. This section contains graphics that are 240x28. You need to specify a month title graphic for each month. There is no translucency on month titles so they will need to be "pre-faded" in your graphics application, unlike the background graphics which are faded on the fly by the program. Each entry is on a different line, in a format like the daybar graphics ("01=titleJan.gif", "02=titleFeb.jpg", etc.)

6. To select the skin, it needs to be placed in a "first level" folder under "My Documents" or "\Storage Card\My Documents" for the user to be able to select it as a skin from VOCalendar. A future version will allow them to use other directories but in version 1.x this is a requirement. In other words, a skin in the folder "My Documents\Horses" would appear but "My Documents\Skins\Horses" would not.