═══ 1. Introduction ═══ Unit Converter is PM utility which enables "on-the-fly" unit conversions. You can add your own groups, change basic units for groups, delete groups you don't need, add units, change unit's conversion factor, offset and prefixes and delete units you don't need. Note: when you add new group/unit or correct errors in existing group/unit, send me file CONVERT.DAT, so I can include changes in next release. Thanks in advance. Unit Converter has Language support for English, Croatian, German, Swedish and French. If you want to add your Language support visit my site and download Translation tool (translat.zip). Files in this archive: Install.cmd install/uninstall script - required! Convert.exe program - required! Convert.ico Icon for program CONVERT.DAT database - required! Conbmp32.dll bitmaps - required! ENGLISH.INI English Language support - required! English.inf English manual CROATIAN.INI Croatian Language support GERMAN.INI German Language support SWEDISH.INI Swedish Language support Swedish.inf Swedish manual FRENCH.INI French Language support French.inf French manual helpfile.zip Manual (source files) FastIni.dll if you already have library FastIni.dll in LIBPATH directory, you can delete this file. Copy all files to separate directory, run script Install.cmd with parameter I (Install.cmd I) and follow instructions. Note: DO NOT MOVE Conbmp32.dll to LIBPATH directory, or English.inf to BOOKSHELF directory - they must be in Unit Converter directory. To uninstall Unit Converter, run script Install.cmd again with parameter U (Install.cmd U). Program object for Unit Converter will be destroyed. Then you can delete files in Unit Converter directory. See also: Using Unit Converter Editing groups and units Settings SI units Prefixes ═══ 2. Using Unit Converter ═══ In Unit Converter main window are three lists: Groups Available groups of units (Area, Length, Mass,...). When you select group, in 2nd and 3rd list are displayed units in this group. Source units Source units (convert from ...). Select source unit and type value (default is 1). Target units Target units (convert to ...). Select target unit to convert units and display conversion result. When you select source or target unit, conversion result is automatically updated. If you change value of source unit, press button to convert source to target unit. You can type only numeric value. If you type (or paste from Clipboard) wrong value, it will be replaced with default value: number 1. Note: Exception is group 'Character'. You can type following values for source unit: ASCII You can convert representation of one character to other format. If you type more than 1 character, only last character will be converted. Binary Valid entry are: 01. Value must be whole positive number. If you select 'ASCII' as target unit and type more than 8 characters, only last 8 characters will be converted Decimal Valid entry are: 0123456789. Value must be whole positive number. If you select 'ASCII' as target unit, source value can't be greater than 255. Hexadecimal Valid entry are: 0123456789AaBbCcDdEeFf. Value must be positive. If you select 'ASCII' as target unit and type more than 2 characters, only last 2 characters will be converted Octal Valid entry are: 01234567. Value must be whole positive number. If you select 'ASCII' as target unit, source value can't be greater than 377. Copy conversion result to Clipboard. You can also copy whole text. Paste conversion result from Clipboard and use it as value of other source unit. Toolbar Groups Add new group or change selected. Delete selected group. Units Add new unit or change selected. Delete selected unit. Other Change settings for Unit Converter Help for Unit Converter Leave Unit Converter See also: Introduction Editing groups and units Settings SI units Prefixes ═══ 3. Editing groups and units ═══ Note: You can not change or delete groups 'Character' and 'Temperature'. In Groups dialog you can change:  group's name (if you change name, group will be saved as new)  group's basic unit. In Units dialog you can change:  unit's name (if you change name, unit will be saved as new).  unit's symbol (type * if symbol is unknown)  prefixes to use with unit. If some of prefixes can be used with this unit, check selected prefix.  unit's conversion factor (multiply group's basic unit by this number): number (also valid in form of exponential notation) or formula - see warning below!.  offset for conversion factor (add this number to conversion factor): number (also valid in form of exponential notation) or formula - see warning below! Always use period as decimal separator and DO NOT use thousand separators in unit's conversion factor and/or offset. One of following operators can be used in formula: + (add) 10+10 (equal to 20) - (substract) 100-60 (equal to 40) * (multiply) 10*10 (equal to 100) / (divide) 1/4 (equal to 0.25) ** (power) 2**10 (equal to 1024) Warning: YOU CAN USE ONLY ONE OPERATOR IN FORMULA IF THE CONVERSION FACTOR OR OFFSET IS IN FORM OF EXPONENTIAL NOTATION, ONLY NUMBER (NO FORMULA!) IS ALLOWED. Press button to save changes, or button to return to program without saving changes. Note: when you add new group/unit or correct errors in existing group/unit, send me file CONVERT.DAT, so I can include changes in next release. Thanks in advance. See also: Introduction Using Unit Converter Settings SI units Prefixes ═══ 4. Settings ═══ You can change: 1. Font to use with Unit Converter. Default is 9.WarpSans. 2. Language to use with Unit Converter. Default is English. 3. Precision to which arithmetic operations are evaluated - from 9 to 50. Default is 15. 4. Decimal part of the result - from 0 (whole number) to 32. Default is 3. 5. Display result in form of exponential notation - the power of 10 is always a multiple of 3. 6. Use symbols to display conversion result. Default is NO. 7. Group numbers - divide numbers into groups of 3. a. No separator - use period as decimal separator and don't separate numbers. This is default. b. SI recommended - use period as decimal separator and use space to separate numbers (as thousand separator). c. Country specific - use Country specific decimal and thousand separator 8. Size of Unit Converter window - between 480*360 to 800*600. Default is 480*360. 9. Save position of Unit Converter on exit. Default is YES. Press to save changes, to load default settings, or to return to program without saving changes. ═══ 5. SI units ═══ The modern metric system (SI) is the system of units and measures, with following principles: 1. the system should consist of measuring units based on unvariable quantities in nature, 2. all units other than the base units should be derived from these base units, 3. multiples and submultiples of the units should be decimal (see Prefixes.) The units are classified into Base units, Supplementary units and Derived units. The Base units of the SI Physical quantity Unit [symbol] length metre [m] time second [s] mass kilogram [kg] electric current ampere [A] thermodynamic temperature kelvin [K] luminous intensity candela [cd] amount of substance mole [mol] The Supplementary units of the SI Physical quantity Unit [symbol] plane angle radian [rad] solid angle steradian [sr] The Derived units of the SI Physical quantity Unit [symbol] frequency hertz [Hz] force, weight newton [N] work, energy, quantity of heat joule [J] pressure, stress pascal [Pa] power watt [W] electric charge coulomb [C] electric potential difference volt [V] electric capacitance farad [F] electric resistance, reactance ohm [Omega] electric conductance siemens [S] magnetic flux weber [Wb] magnetic induction tesla [T] inductance henry [H] luminous flux lumen [lm] illuminance lux [lx] absorbed dose gray [Gy] activity becquerel [Bq] dose equivalent sievert [Sv] area square metre [m¤] volume cubic metre [m3] speed, velocity metre per second [m/s] acceleration metre per second squared [m/s¤] angular velocity radian per second [rad/s] angular acceleration radian per second squared [rad/s¤] density kilogram per cubic metre [kg/m3] moment of force newton metre [N.m] electric field strength volt per metre [V/m] permeability henry per metre [H/m] permittivity farad per metre [F/m] specific heat capacity joule per kilogram kelvin [J/(kg.K)] luminance candela per square metre [cd/m¤] Units that may be used with the SI Physical quantity Unit [symbol] time minute [min] hour [h] day [d] plane angle degree [°] mass metric tonne [t] volume litre [l or L] energy electron volt [eV] speed kilometre per hour [km/h] area hectare [ha] rotational frequency revolution per minute [r/min] ═══ 6. Prefixes ═══ 20 SI prefixes are used to form decimal multiples and submultiples of SI units. Nearly all of the SI prefixes are multiples or sub-multiples of 1000. However, these are inconvenient for many purposes and so hecto, deca, deci and centi are also used. ┌─────────────────────────┬─────────────────────────┐ │Symbol Prefix Factor │Symbol Prefix Factor │ ├─────────────────────────┼─────────────────────────┤ │da deca 10^1 │d deci 10^-1 │ │h hecto 10^2 │c centi 10^-2 │ │k kilo 10^3 │m mili 10^-3 │ │M mega 10^6 │ц micro 10^-6 │ │G giga 10^9 │n nano 10^-9 │ │T tera 10^12 │p pico 10^-12 │ │P peta 10^15 │f femto 10^-15 │ │E exa 10^18 │a atto 10^-18 │ │Z zetta 10^21 │z zepto 10^-21 │ │Y yotta 10^24 │y yocto 10^-24 │ └─────────────────────────┴─────────────────────────┘ In computing, using the metric prefixes specify powers of 2. For example, a kilobit is usually 2^10 = 1024 bits instead of 1000 bits. This leads to considerable confusion, and in 1998 the International Electrotechnical Commission approved new prefixes for the powers of 2: ┌───────────────────────────────────────────────────┐ │Symbol Prefix Factor Value │ ├───────────────────────────────────────────────────┤ │Ki kibi 2^10 1 024 │ │Mi mebi 2^20 1 048 576 │ │Gi gibi 2^30 1 073 741 824 │ │Ti tebi 2^40 1 099 511 627 776 │ │Pi pebi 2^50 1 125 899 906 842 624 │ │Ei exbi 2^60 1 152 921 504 606 846 976 │ └───────────────────────────────────────────────────┘ The metric prefixes should be used in computing just as they are used in other fields: 1 gigabyte (GB) should mean exactly 1 000 000 000 bytes, and 1 gibibyte (GiB) should mean exactly 1 073 741 824 bytes. ═══ 7. Translation tool ═══ Language support for Unit Converter (buttons text, messages, frames text ...) is stored in Language INI files (ENGLISH.INI, CROATIAN.INI,etc.) and source of help file (this file - English.inf) is file English.ipf. If you want to add your Language support visit my site and download Translation tool (translat.zip). To create new Language INI file: 1. Select source language (one of languages in the list). 2. Press New language! button, to create new language file. SOURCE LANGUAGE will be copied to new language file. 3. Enter language name, comment, your name and email adress (REQUIRED!). Then press OK - start translation button. 4. Sections (pages in Notebook) are: Menu, Hint, Message, Button, Frame and Help. Overwrite text with your text. 5. When finished, select your language in program and try it. To change existing Language INI file: 1. Select your language (as source language and your language). 2. Change comment, your name and email adress if you want, then press OK - start translation button. 3. Sections (pages in Notebook) are: Menu, Hint, Message, Button, Frame and Help. Overwrite existing text with your text - press Write changes button after EVERY CHANGE. 4. When finished, select your language in Unit Converter and check changes. Important! Press Write changes button after EVERY CHANGE to save changes. If you don't press this button and go to next item, changes WILL BE LOST! When you create new Language INI file, program will write new Key to file CONVERT.INI, Application Language, where: - Key name is name of new language - Key value is "English.inf" - it is default help file for Unit Converter. In section (Page) Help are stored titles of topics in English.inf and they are used as parameter when you press Help button in Unit Converter. You should translate this section only if you want to translate source help file (English.ipf). Then items in Help section should be identical as translated titles in new IPF/INF file. Note: After you added new Language support to Unit Converter, I would appreciate if you send me new INI file, so I can include this file in next version of Unit Converter. ═══ 8. Translate help file ═══ To translate help file you need IPF compiler. If you want to translate English.ipf to your language, after you finished translation, make changes in Application "Language" in file CONVERT.INI. For example: when you translated ENGLISH to MYLANG (where MYLANG is your Language), MYLANG.INI file is created. When you translated English.ipf to Mylang.ipf and compile Mylang.ipf, Mylang.inf file is created. Edit in CONVERT.INI: change in Application Language, Key MYLANG, Value English.inf to Mylang.inf. Be sure you also translated Help section in MYLANG.INI. In section (Page) Help are stored titles of topics help and they are used as parameter when you press Help button in Unit Converter. Translate this section only when you translated source help file (English.ipf). Note: After you translated help file, I would appreciate if you send me new IPF/INF file, so I can include this file in next version of Unit Converter. ═══ 9. Copyright and contact ═══ Author Goran Ivankovic Address Ulica Josipa Poduje 8 HR-52100 Pula Croatia email duga1@pu.tel.hr Home page http://redrival.com/os2util/ Unit Converter is free software but it is not public domain. The author retains all copyright to the application and all files within it. You may use Unit Converter yourself and you may distribute it to others so long as all files are left unchanged. You may not distribute Unit Converter in any way which leads to your making a profit from it. This means that you can only charge enough to cover the costs of media, postage etc. involved in distribution. Also you may not use it as an incentive to buy something else. If you are in any doubt you should contact the author. The author's permission must be obtained before Unit Converter is included on a magazine disc and P.D. libraries. You should, as a matter of courtesy, inform the author when you are planning to distribute the application and send one copy of magazine disc to the author. The author makes no representations about the accuracy or suitability of this material for any purpose. It is provided "as is", without any express or implied warranties. The author will assume no liability for damages either from the direct use of this product or as a consequence of the use of this product. Thanks to all users for ideas, comments, corrections, suggestions and bug reports. Special thanks to: Klaus Staedtler translated Unit Converter to German, created bitmaps, idea, support and nice icons BjФrn SФderstrФm translated Unit Converter to Swedish Guillaume Gay translated Unit Converter to French Brian Crook tested Unit Converter Steven Levine tested Unit Converter PrzemysИaw PaweИczyk tested Unit Converter  OS/2 is Trademark of International Bussines Machines Corporation  DrDialog is Copyright of International Bussines Machines Corporation  FastIni.dll is Copyright of Dennis Bareis - OS/2 Developer in Australia ═══ ═══ Author Goran Ivankovic Address Ulica Josipa Poduje 8 HR-52100 Pula Croatia email duga1@pu.tel.hr Home page http://redrival.com/os2util/