Monday, April 28, 2008

CMSettings v1.0 (Comm Manager Settings)


Description:
CMSettings was created to make the Comm Manager customization easier.
It allows the user to change between available stiles (skins), and select the desired Comm functions to use.

=== HOW IT WORKS: ===

When the application starts, it will search the Windows folder for available skins. With this we can prevent applying a skin that doesn't exist.
It also makes a backup of your present Comm manager settings (see ROM default settings), in case you want to go back.
After this is very simple. Just select one of the available skin, change the functions to your likings and apply changes.
There's no need to terminate the Comm Manager process, as the application will do it for you.

=== ABOUT THE SKINS: ===

Default Skin - This skin will always be available since it belongs inside the CommManagerRes.dll(this file is necessary for Comm Manager to work, so...)
It supports from 4 up to 12 functions.

Touch Skin/Large Buttons Skin - This skin will be available, as long as the skin files are located in windows folder, and it has skin files for a minimum of 8 functions.
It supports 8 or 10 functions. When the user selects this style (skin), a popup window will appear to let him/her choose between 8 or 10 buttons.
(its up to the user to know which option to use, according to the files he/she has put into windows folder)
If the user wrongly selects the number of buttons to use, just select the skin once again and the popup will appear again.
If the skin files are the ones provided by HTC the user can quickly get the HTC settings by selecting the menu option "Default Settings".
If the option is not selected, when applying the skin, a popup will appear asking if the user wants to apply the default settings(if you have customized the skin for different settings, just press NO and the user's settings will be applied).

Touch Dual Skin/ON/OFF Buttons Skin - This skin will be available, as long as the skin files are located in windows folder, and it has skin files for a minimum of 6 functions.
It supports 6 functions only.

=== ABOUT THE COMM FUNCTIONS: ===

To select a function, just tap once.
To enable/disable a function, tap twice. If the function is already selected, the user just have to tap once and it will be enabled/disabled.
when the function is enabled, the user can see a green icon on the left side of the function text and the text will be black.
when the function is disabled, the user can see a gray icon with a red cross on the left side of the function text and the text will be gray.
When there are not files for a funtion in the selected skin, no icon will appear on the left side of the funcion text, the text will be gray, and the user will not be able to enable/disable the function.

=== ABOUT THE MENU: ===

About - A popup will appear showing info about the program. To close it just tap the popup.
Language - Here the user can choose the application language. If the desired language cannot be found in the list, the application can still support it. The user needs only to edit the CMSettings.ini (for more info on how to do this see "How to edit the .ini file").
Default settings - It can be used in all styles, but the best use of this function is when "Touch Skin/Large Buttons Skin" is selected, to apply HTC Settings (since when using the HTC skin, the functions must be in a specific order, so the background doesn't get messed up)
ROM Default settings - On first run, the device backs up the existing Comm Manager settings. This option is used to get those settings back.
Apply settings - Use this option to apply the changes made to the Comm Manager settings.

=== HOW TO EDIT THE .ini FILE ===

The application is provided with a few .ini files containing the following languages:
- English
- Portuguese
- French
- Dutch
- German
- Italian
- Spanish
- Slovenian
- Vietnamese - (This language will only fully work in ROMs that support the language)
- Russian - (This language will only fully work in ROMs that support the language)
- Czech - (This language will only fully work in ROMs that support the language)
- Arabic - (This language will only fully work in ROMs that support the language)
- Simplified Chinese - (This language will only fully work in ROMs that support the language)
- Norwegian

If the user's language is not yet supported, it can easily be added by translating one of the existing languages.
To do this, open CMSettings.ini with a text editor, copy all lines from one language, and translate all the strings.
If the user's language needs special text encoding, make sure to save into a separate file.
Finnaly copy the new .ini to the same place where CMSettings.exe is, and restart the application.
Now the language will be available to be selected.

=== NOTES ===

- Not all CommManager.exe versions support all skins.
So, if the user has the necessary skin files, applies changes but cannot see the skin or the skin doesn't display correctly maybe a different CommManager.exe version is required.


Requirements:
- .Net Compact Framework 2.0 or higher
- Comm Manager

More information:
http://forum.xda-developers.com/showthread.php?t=388855

Download


No comments: