Skinning Quick Start
Loading new skins
Skinning flexibility
Image files
Directory and File Layout for Skins on the Pocket PC
Button.ini

Skinning Quick Start

• Install 1-Calc
• Make sure your Pocket PC is synced to your desktop PC
• Navigate to \Program Files\OmegaOne\1-Calc\Skins on your Pocket PC
• Copy the subfolder “default” from your Pocket PC to your desktop PC
• Copy the file “default.ini” from your Pocket PC to your desktop PC (the file extension will not be visible from Pocket PC file explorer, it will just be labeled default)
• Rename the copied folder and ini file to the name of your new skin. For example, if your new skin was going to be named “Shiny”, rename the folder you just copied from "default" to "shiny", and rename the file default.ini to Shiny.ini
• Open the folder you just renamed, you should see a selection of image files. Most are BMP (bitmaps).
• Now open your favorite image editor and change the look of the images files.
  When you're ready to try out your new skin, copy the new folder and the new ini file into \Program Files\OmegaOne\1-Calc\Skins

Loading New Skins
Skins can be selected from the options screen under the "Skins" tab. All installed skins will be visible from this screen.

Skinning Flexibility
You may change the general appearance of the calculator with a new skin. You may move the locations of buttons within a given area, but you may not make significant changes to the layout of the calculator.

Buttons
You may change the number of buttons, size and position of buttons on the calculator. The main buttons will always appear in the bottom area of the calculator and the additional buttons will always appear above the main buttons and below the display area.

Display
You cannot move the display of the calculator or of the unit converter/currency converter screens.

Image Files
1-Calc supports the use of Bitmap, JPEG, GIF, and PNG image file formats. You may use more than one image format in the same skin.

A minimum of 9 image files are required for a skin, and it is recommended to use more.

You may name your images files to any title you like, as long as they are correctly referenced in the skin ini files as mentioned below. For simplicity, image files will be referred to by the names used in the default 1-Calc skin.

Background Images
Background (display_background.bmp)
Dimensions (294 x 240 pixels)
Purpose: Displayed under the buttons of the calculator.

CurrencyBackground (display_currency)
Dimensions (134 x 240 pixels)
Purpose: Replaces the display and additional buttons when using the currency converter. With the currency converter displayed, the lower 160 pixels of the background image will also be displayed.

UnitConverterBackground (display_conversion)
Dimensions (134 x 240 pixels)
Purpose: Replaces the display and additional buttons when using the unit converter. With the unit converter displayed, the lower 160 pixels of the background image will also be displayed.

Button Images
Large Buttons (button_large)
Dimensions: User specified, the default skin image size is (135 x 185 pixels)
Purpose: This image is used to load the large buttons on the calculator. The default button image is shown below:

Small Buttons (button_small)
Dimensions: User specified, the default skin image size is (66 x 99 pixels)
The small button images use the same layout as the large button images, for more information, please read the above section on Large Buttons.

Button Masks
You'll notice in the example image that each button has a mostly black area to the right of the "pressed" image. This is called the button Mask. The mask must be the same size as the button and only use black and white colors. By using the mask, you may have transparent sections of button, which will allow the user to view the background.

The black area of the mask will dictate which parts of your button will be drawn, the white areas will not be drawn. In the example, the corners of the default buttons are not drawn giving a slightly rounded look to the buttons when displayed in the calculator.

Font Images
Large Fonts
The large font images are named with a preceding "font_". These images contain the labels for the 1-Calc buttons. It is not necessary to use more than one file for the fonts but it is recommended for simplicity and organization.

Above you can see the image used for the memory button labels. The labels are indexed starting from 0. In this example, the index will start at 0 with the "copy" label, and end at 9 with the "Memory5Recall" label. These indexes are used in the button.ini file.

Small Fonts
The small font images are organized in the same way as the large font images.

Font Masks
Each font label has a corresponding mask, the exact same size as the font label, and placed below the actual label. The mask must be only black and white. The black will dictate which parts of the label will be drawn, the white will dictate which parts are not drawn. In the above example, only the letters will be drawn onto the buttons, and not the white background.

Menu Background
Background (display_menu)
Dimensions (150 x 21 pixels)
This image is used as the background on the main menu.

Directory and File Layout for Skins on the Pocket PC
Please note - It is assumed that 1-Calc is installed to the default folder \Program Files\OmegaOne\1-Calc on your Pocket PC

All of the Skin files will be stored in \Program Files\OmegaOne\1-Calc\Skins and corresponding sub folders.

To create a new skin for 1-Calc. You will need to create an ini file with the same name as your skin. For example, it might be called myblueskin.ini. This file will be placed in \Program Files\OmegaOne\1-Calc\Skins.

The rest of your skin files will be placed in a sub folder of the same name. In this example the folder will be \Program Files\OmegaOne\1-Calc\Skins\myblueskin

The files you will place in the subfolder will be all of the images for your skin, as well as a file named button.ini

1-Calc supports the following image formats: BMP, PNG, GIF, & JPG. It is possible that some image formats at certain color depths may not work correctly. It is recommended to use either 24 bit or 8 bit images.

Button.ini
This file allows you to customize the look and feel of each and every button of your new 1-Calc skin. This file will be placed in your new skin directory. It is recommended that you do not change the name of this file but you may do so as long as you specify the same file name in the [Init] section of your “skin.ini” (“default.ini”). More information on skin.ini below.

The button.ini has several key sections listed at the top of the file. It then has a section for every button currently used in 1-Calc.

Sections can be identified by square brackets around the title, for example, the first section is "Init" and can be seen on the first line of button.ini as [Init]. Any information below a section title is important information for that section. You must only change the values in each section, i.e. the information after the equals “=” sign. You must also not remove any keys from any sections or your skin may not work correctly.

There are several common values in the various sections of the button.ini which are covered here. Section specific values are covered below.

BtnType (button type) & BtnId (ButtonId): These values are used by 1-Calc and should NEVER be changed when skinning.

BtnStyle (button style): Is the number used to specify which button image to use within a button image file. See Images for more information.

BtnImageLarge (Button Image Large): Specifies the file to load the large button image for this button.

BtnImageSmall (Button Image Small): Specifies the file to load the small button image for this button

FontImageLarge: Specifies the file to load for the large font labels for this button

FontImageSmall: Specifies the file to load for the small font labels for this button

FontStyle: Is the number used to specify which font label to use within a font image file. Indexed starting at 0. See Images for more information.

[Init]
The init section has 3 initial values labeled Rect1, Rect2, and Rect3. Do not change these, they will be used in a later version of 1-Calc.

BtnDimensionLarge - defines the size of the main or large buttons
BtnDimensionSmall - defines the size of the small buttons
FntDimensionLarge - defines the size of the font labels in your large font images
FntDimensionSmall - defines the size of the font labels in your small font images
FntOffSetLarge & FntOffSetSmall - defines the relative offset of the font labels when placed onto the buttons for the large and small buttons respectively. Please note, the offset is measured from the upper left corner of the button, NOT the lower left.

[MenuButton]
This section defines the properties for the menu button and the display of 1-Calc.
Background - specifies the background image for the menu
The text values are not currently used in this section.

[ConvertFromButton]
This section sets the properties of the "convert from" button used in the Unit Converter and Currency converter sections.

[ConvertToButton]
This section sets the properties of the "convert to" button used in the Unit Converter and Currency converter.

[ConversionButton]
This section sets the properties for the conversion button used in the Unit Converter.

[All Other Groups]
The other sections in button.ini specify the properties for each button used in 1-Calc. Here you can change the button and font label styles for each button. Remember NOT to change BtnType and BtnId.

Skin.ini ("default.ini")
This file is the control file for your new skin. It should be named according to the name of the skin. All of the files used by the skin need to be placed in a sub folder of the same name. For example, the default skin for 1-Calc is named “default”. It uses a file called default.ini and all other skin files are placed in the default sub folder.

The file should be created using basic ANSI text and should not be encoded in Unicode. If using a Microsoft Windows® based computer to create your skin, it is recommended that the skin.ini file is created using Notepad.

Each individual section in the skin.ini file can be recognized by the presence of square brackets[] around the section name. The following sections are present in the skin.ini file
This program allows you to change some of the system settings on your Pocket PC:

[Init]
Buttons = button.ini

The buttons value in the [Init] section specifies the name of the ini file used to describe specific information about the buttons used in 1-Calc and there settings for your new skin. It is recommended but not required that you leave this file named “button.ini”. For more information, please read the section on Button.ini later in this document.

Background = display_background.bmp
CurrencyBackground = display_currency.bmp
ConvBackground = display_conversion.bmp

The three other values in this section give the names of the images used for the background of your 1-Calc skin. Please note that image files can in BMP, JPG, GIF, or PNG formats and you may use multiple formats in the same skin.

Background specifies the image for the main background of 1-Calc. This includes the display, the custom button area and the main button areas.

CurrencyBackground specifies the file used for the upper area of 1-Calc when displaying the currency group. This includes everything except the main buttons.

ConvBackground specifies the file used for the upper area of 1-Calc when displaying the unit converter group. This includes everything except the main buttons.

[MainButtonLocations]
This section sets the relative position of the main buttons in 1-Calc. You may place these buttons anywhere in the lower 160 pixels of 1-Calc. The co-ordinates are referenced from the upper left corner of the main button section. For example, (0,0) will be on the left side of the calculator, and 160 pixels from the bottom. (240, 40) will be on the far right of the screen and 120 pixels from the bottom.

Button positions specify the top-left corner of the button. So in the earlier example of (0,0), and assuming your button was 30 pixels by 30 pixels, the top left corner of the button would be on the left side, 160 pixels from the bottom, and the bottom right corner of your button would be 30 pixels in from the left side, and 130 pixels from the bottom.

You may specify anywhere from 1 to 30 buttons in the Main Button area.

[LargeButtonLocations]
This section sets the relative position of the additional buttons specified in the button groups. They occupy an area of 240 by 81 pixels.

You may have anywhere from 1 to 20 buttons. If you specify more than 20 buttons, the Calculator will default to the small button images.

[SmallButtonLocations]
These specify the locations of the small buttons in the same 240 x 81 pixel area above the main buttons used by the large buttons.

You may use anywhere from 21 to 60 buttons.

[Display]
You may set the properties of the display area of 1-Calc. It is not recommended changing the Text Height beyond 28.

BtnMenuLocation specifies the position of the menu button relative to the top left corner of 1-Calc.

[Currency] & [UnitConverter]
These groups allow you to set further properties of the currency and unit converter screens. The button locations are relative to the top left corner of 1-Calc. Please remember that the second number counts down from the top.

[Main]
You can set which buttons you'd like to appear in the main area of your 1-Calc Skin. These buttons occupy the lower 240 x 160 pixels of 1-Calc. There positions are defined in [MainButtonLocations]. Please note, if you add or remove additional buttons, you'll need to specify the number of buttons in [MainButtonLocations] and add or remove the values to [Main].

[Default], [Algebra] etc.
These sections specify which buttons are in each button group. If your skin uses more or less than 10 large buttons, you must set the number of buttons is [LargeButtonLocations] and add or remove additional values as necessary.

[Custom1], [Custom2], [Custom3]
These sections specify the buttons used for the 3 custom button groups in 1-Calc. You MUST set values for all buttons in the custom groups. Meaning there must be button values set equal to the number of buttons specified in [SmallButtonLocations]. Even if you intend on only using the large button settings in your custom groups.