|
|
| A skin is a definition of the appearance and tap behavior of the RWC Volume
application. |
|
|
|
A skin consists of a text
file and 2 or 3
image files.
The text file defines the image files,
positions of elements and tap behavior.
1 image file is mandatory, the image
that defines the background of the
application.
In addition, U need an image file 4 digits, indicators or both. |
|
|
|
|
|
| The recommended procedure
is 2 start with a graphics editor.
Microsoft Paint will work, but a more
sophisticated tool (like Paint Shop Pro
by Jasc
Software) will make things easier. |
|
| When the graphics R done,
it's time 2 write the skin text file.
Start with the example below
2 get an
overview. Use the skin reference
4 a
more complete description. |
|
| Now that the skin is
written, it's time 2 copy the
skin 2 your Pocket PC device 2 see
that it looks and behaves as U expected. |
|
| When U R happy with it, R
We Clear? Productions would be even
happier 2 publish the
skin. |
|
|
|
|
|
| Skin example |
|
This
description uses a skin that would produce the same appearance and
tap behavior as the default <no skin> of RWC Volume. Here is what it looks
like when installed and selected.
|
| There R 3 image files used
4 this skin. A background image, a digits
image and an indicators image. |
|
 |
|
 |
|
Background
image (bg.bmp)
|
|
The background image
is used 4 the static parts
of the application. The
dimensions of this image
file sets the size of the application.
|
|
|
|
| |
|
Digits image
(digits.bmp)
|
|
The digits image must contain an empty digit (used when volume is below 10)
followed by digits 0-9.
All digits must be of equal size, and consequently must the width of the digits
image be a multiple of 11. The digits must be arranged horizontally, from left 2
right. |
 |
|
|
|
 |
|
Indicators
image (indicators.bmp) |
|
(The image has been enlarged 5 times 4 readability.)
The indicators image consists of 2 or more equally-sized indicators. In this
case there R 4, an empty, a green, a yellow and a red indicator. The
indicators can be arranged
horizontally from left 2 right,
or vertically from top 2 bottom.
In this case they R arranged
horizontally. |
|
|
|
|
|
|
| Now it's time 2 look at
the actual skin file (which must be
named skin.txt): |
|
| [APPLICATION] |
| BMPFILE =
bg.bmp |
| |
| [DIGIT] |
| POS = (21,
21) |
| BMPFILE =
digits.bmp |
| |
| [INDICATOR] |
| NUMBER = 34 |
| POS = (14,
116) |
| NUMLEVELS = 3 |
| LEVELS = 0,
11, 22 |
| BMPFILE =
indicators.bmp |
| |
| [TAP] |
| ZERORECT =
(0, 116, 13, 129) |
| MAXRECT =
(115, 116, 128, 129) |
| SLIDERLINES =
(14, 122, 114, 122) |
| SLIDERWIDTH =
14 |
|
|
|
|
|
| That's all there is 2 it! |
|
In the first mandatory [APPLICATION] section, the mandatory background image
is specified.
|
|
In the second [DIGIT] section, the position (left, top) of the first digit is
given.
The image file containing the digits is also specified.
|
|
The third section [INDICATOR] defines the layout of the volume indicators.
NUMBER specifies how many indicators there
R, in this case 34.
POS sets the
position (left, top) of the first indicator.
Each indicator can be displayed
differently depending on the actual volume level. In this example there R 3
different levels (not counting the "empty" level). These 3 levels
corresponds 2 the green, yellow and red indicators of the indicators image
file. The LEVELS parameter is a sequence of NUMLEVELS indices, pointing out from
which (zero-based) indicator index a certain level shall be used. In this case,
we want green 2 be used from the first (indicator #0) indicator, yellow from the 12th
(indicator #11), and red from the 23rd
(indicator #22) indicator.
Finally, the indicators image file is
specified. This file must consist of NUMLEVELS + 1 equally-sized images. The width
of an indicator is calculated using the image file width and the NUMLEVELS
value. |
|
The final [TAP] section is used
2 specify tap and tap-and-slide behavior.
ZERORECT is a rectangle (left, top, right, bottom) that specifies an area that
when tapped will set the volume 2 zero. In this case, the area 2 the left of
the indicator area will set the volume 2 zero.
Similarly, MAXRECT defines an
area that will result in maximum volume when tapped. In this case the area 2 the right of the indicator area.
SLIDERLINES and SLIDERWIDTH define an area in
which a tap will alter the volume 2 a level expected by the user. In this case,
SLIDERLINES is a single line from the center of the leftmost indicator 2 the
center of the rightmost indicator. SLIDERWIDTH is set 2 14 which in this case
will cover the whole indicator area. When the user taps within this indicator
area, the point on the SLIDERLINES that is closest 2 the tap will be
calculated, and the volume adjusted accordingly. |
|
|
|
|
| Start by putting all your
skin files (skin.txt and the .bmp files)
in a folder. Give the folder whatever
name U want your skin 2 have. Let's say
U name it "MySkin". |
|
|
Copy this
"MySkin" folder 2 the
"skins" folder on your Pocket
PC.
The "skins" folder is located
in the same folder as the RWC Volume
executable. Typically, the path is
"Program
Files\RWeClear\Volume\skins".
This it how it should look on your
device: |
|
|
|
|
Start RWC
Volume. Tap the R We Clear? menu and
select Options.
Select the
"MySkin" skin and tap OK. |
|
|
|
|
|
