1-Calc 3.0 Pocket PC Skinning Guide
It is recommended that users start working from the default skin provided with 1-Calc when starting to create a skin. For the purpose of this document it is assumed you have the default skin in its original unmodified format.

Skin Installation
1-Calc skins contain four (4) files and should be placed in a subfolder from the installed 1-Calc folder called Skins. The default location is \Program Files\OmegaOne\1-Calc\Skins. From here you should see a file called default.ini and a subfolder called Default containing three (3) files. These are the files the make up the default skin. New skins must be placed in the Skins subfolder as well.

Skin Components
Each skin is made up from four (4) files. To create a new skin, you will likely want to modify all four of these files:

skinname.ini (default.ini):
Located in the Skins folder of 1-Calc (i.e. - \Program Files\1-Calc\Skins).

The main skin file, this plain text ini file goes into the skins folder for 1-Calc. The name of the file dictates the name of the skin as it’s displayed in 1-Calc. For example, the default skin has the file default.ini. User created skins should use a different file name.

button.ini
Located in a subfolder of Skins by the same name as the skin’s ini file (i.e. - \Program Files\1-Calc\Skins\Default).

This file contains the information so 1-Calc knows how to handle each button press. It also allows the skinner to control the color of the individual buttons as specified in the skinname.ini file. (more on this later). This file can be renamed as long as the reference in skinname.ini is changed although this is not recommended.

display_menu.bmp
Located in a subfolder of Skins by the same name as the skin’s ini file (i.e. - \Program Files\1-Calc\Skins\Default).

This is the background texture for the main menu in 1-Calc. (the green button on the default skin). This image is tiled for both low-res (QVGA) and hi-res (VGA) devices. If the image is absent the background of the menu appears pure white RGB(255,255,255).

The dimensions of the image can be changed. However, please do not use very large or very small images for performance reasons.

The file can be renamed but must remain in bmp format. To change the name, the Background entry under [MenuButton] in the button.ini file must be changed.

texture2.bmp (as it’s named in most skins)
Located in a subfolder of Skins by the same name as the skin’s ini file (i.e. - \Program Files\1-Calc\Skins\Default).

This is the background texture for 1-Calc. Again it’s tiled as is for both QVGA & VGA screens with no rescaling. If the image is absent a default grey color is shown. RGB(128,128,128).

The dimensions of the image can be changed. However, please do not use very large or very small images for performance reasons.

The file can be renamed but must remain in bmp format. To change the name, the BackgroundWide entry under [Init] in the skinname.ini file must be changed.

Skinname.ini (default.ini) Explained
skinname.ini is a plain text file and can be edited using any basic editor, Notepad or Notepad2 are recommended. If you use a program such as Word, please ensure you save the file as a plain text file and preserve the file extension “ini”.

Please note, all colors are in RGB format with values ranging from 0 to 255. For example, pure bright green is represented as 0,255,0.

Button labels are specified by Btn followed by a number – i.e. Btn1. These are drawn in order starting at the top left and going to the right until the row is complete.

Sections:
[Init]
Buttons: Gives the name of the other ini file for the skin, this should be left as button.ini
ButtonTextWeight: This can be set to 400 (Normal) or 700 (Bold) to bold or unbold the text that appears on the buttons of 1-Calc.
BackgroundWide: The name of a Bitmap file used as a background tile for 1-Calc. If the image is absent the background will be grey.
NumberOfGroups: Leave this value set to 9.

[Display]
Type: Leave this value set to 0, this will be used in future versions of 1-Calc.
Color1: The background Color of the displays in 1-Calc.
Color2: Unused.
HiLite1=Primary outline color of the display.
HiLIte2=Secondary outline color of the display.
DarkColor1=The background Color of the darkened displays for the Unit & Currency Converter screens.
DarkColor2=Unused.
DarkHiLite1= Primary outline color of the dark display.
DarkHiLite2= Secondary outline color of the dark display.
LineColor1= Primary Color of the detail line seen below the main display.
LineColor2= Secondary Color of the detail line seen below the main display.
TextColor= Text color for all 1-Calc Displays.
TextFont= Text font for all 1-Calc displays (this may be changed but most devices will default to Tahoma as other fonts generally are not installed).
TextHeight = Height of the main text on the 1-Calc displays (default is 28).
TextWeight = Set to 400 for normal display text, set to 700 for bold display text.
BtnMenu= Do not change (MenuButton).
BtnMenuLocation= Co-ordinates of the Main Button, untested, default is 1,5.

[Currency]
[UnitConverter]
[TipCalculator]
These values should not be changed. The display Text Height, Weight, and Color from the [Display] section overrides these values.

[Main]
NumberOfButtons: Number of buttons for the main section of buttons at the bottom of 1-Calc. Default is 20 (untested).
Btn1 – Btn20: Specifies which buttons will be shown in the main section of 1-Calc. The names must match those in the button.ini file.

[1] through [9]
These are the button groups that are available in 1-Calc. The number of buttons and the values for Btn1-Btn40 can be changed.
The name must be set. If creating a custom button group you may choose any name, otherwise use the names in the ini file as they are recognized in 1-Calc and will be automatically translated if non English languages are selected.

[Custom1], [Custom2], [Custom3]
The settings for the three (3) custom screens. These can be changed but it is not recommended as these values will be modified from within 1-Calc via the Customize Tab.

button.ini Explained
button.ini is a plain text file and can be edited using any basic editor, Notepad or Notepad2 are recommended. If you use a program such as Word, please ensure you save the file as a plain text file and preserve the file extension “ini”.

Please note, all colors are in RGB format with values ranging from 0 to 255. For example, pure bright green is represented as 0,255,0.

[Init]
BtnDimensionLarge: The dimension of the menu button, this will be removed in a future version.
BtnType: Specifies the button type for the skin – see appendix.
BtnXColor1=Primary Button Color.
BtnXColor2=Secondary Button Color.
BtnXHiLite1=Primary Button highlight.
BtnXHiLIte2=Secondary Button highlight, only used on one (1) skin.
BtnXText1=Button Text Color.
BtnXText2=Unused.

There are six (6) buttons for each 1-Calc skin. Not all buttons must be used in all skins.

For the default skin:
Btn1 is the light grey button used for the numbers.
Btn2 is the dark grey button.
Btn3 is the blue button (Memory).
Btn4 is the orange button (Clear, Backspace, etc).
Btn5 is the green menu button.
Btn6 is the yellow button to open worksheets (i.e. TVM, Graphing, etc).

[MenuButton]
BtnType: do not change.
BtnId: do not change.
BtnStyle: button style as defined above. Please note, you must subtract 1 from the button definition above. Ie, the button defines for the menu are Btn5, this default value is 4.
Background: the bitmap image used to tile the main menu background.
TextColor: text color of the main menu.
TextFont: font for the main menu, recommended to be left as Tahoma.
TextHeight: Height of the main menu text, default is 15.
TextWeight: Weight of the main menu text, 400 is normal, 700 is bold.
MenuItemHeight: Main menu item spacing, default is 20.
MenuItemWidth: Width of the main menu, this should be left at 140 unless the text height has been changed.

The rest of the file contains all the names of the buttons used in 1-Calc.
BtnType and BtnId should not be changed as they tell 1-Calc how to handle the button press.

BtnStyle can be changed to effectively change the color of the buttons in 1-Calc. Please note this value should be 1 lower than the defines above. Ie, the numbers are defined using Btn1, this setting then would be 0.

Button Types:
BtnType=0 “Keyboard”

This is currently unused in 1-Calc skins but the button is fully functional.
BtnXColor1: Top top left highlight, also used for the gradient.
BtnXColor2: Bottom right highlight, also used for the gradient.
BtnXHiLite1: Unused.
BtnXHiLite2: Unused.
BtnXText1: Button Text Color.
BtnXText2: Unused.

BtnType=1 “Flat”

This is currently used in the FutureBlue skin.
BtnXColor1: Button Color.
BtnXColor2: Button Color of down state (i.e. pressed).
BtnXHiLite1: Outline Color.
BtnXHiLite2: Unused.
BtnXText1: Button Text Color.
BtnXText2: Unused.

BtnType=2 “Gradient”

This is currently used in the 30x skin.
BtnXColor1: Top Gradient Color.
BtnXColor2: Bottom Gradient Color.
BtnXHiLite1: Outline Color.
BtnXHiLite2: Unused.
BtnXText1: Button Text Color.
BtnXText2: Unused.

BtnType=3 “Bevel”

This is currently used in the default skin.
BtnXColor1: Top Gradient Color.
BtnXColor2: Bottom Gradient Color.
BtnXHiLite1: Outline Color.
BtnXHiLite2: Unused.
BtnXText1: Button Text Color.
BtnXText2: Unused.

BtnType=4 “Ellipse”

This is currently used in the Texas skin.
It also provides a drop shadow below and to the left of the button.
BtnXColor1: Top Gradient Color.
BtnXColor2: Bottom Gradient Color.
BtnXHiLite1: Outline Color.
BtnXHiLite2: Unused.
BtnXText1: Button Text Color.
BtnXText2: Unused.

Button Layouts:
Main
5 x 4 layout, example below:

For Specific Button groups the following values are valid:
10 5x2
12 6x2
15 5x3
18 6x3
20 5x4
24 6x4
32 8x4
40 10x4