FlCalc

--------------------------------------------------------- FlCalc 5 - A programmer's calculator. (C) 1997, 2000 David Rushall Freeware. All rights reserved. --------------------------------------------------------- INTRODUCTION FlCalc5 is a programmer's calculator with a difference. Originally written to compliment the Calc application on my Series 3a as I couldn't find anything I liked that did what I needed and ported to the Series 5 for the same reason. Features include o 32-bit integer expression evaluation. o Multiple simultaneous output formats including decimal, hex and binary. o ASCII and EBCDIC character tables. o Multiple memories. o Repeatable statements. o Pen-enabled on-screen keypad. o Copy and paste. CONDITIONS OF USE 1) FlCalc5 is Freeware and copyright; it is not public domain. The rights to this package remain the property of the author. 2) You may use this software, free of charge, for an indefinite period and at no obligation to the author. 3) Permission is given to publically distribute this software provided the distribution contains all, and only, the unaltered files of the original distribution, the ownership of the rights to this software is clearly stated and any fee charged is extremely nominal. 4) Use of this software is entirely at the user's own risk. The user must accept responsibility for any direct or indirect loss or damage arising from the use (or misuse) of the package. This software is supplied "as-is". 5) Note: The OPX file employed by this software (and included in this distribution) is the copyright of EMCC. Please see their WWW site, http://www.compulink.co.uk/~emcc/ for more details. INSTALLATION 1) Close all applications on your Psion. Note: If you do not close all applications before installing the OPX *.sis package in the next step, you may have problems with OPX versions, later. 2) Using PsiWin2 or the "Add/Remove" icon on the EPOC control panel (if you have it), install the third-party OPX *.sis file: Cliptext.sis NOTE: You will be asked whether you wish to install the documentation for the Cliptext.opx. After the OPX is installed, a directory called "cliptext" will have been created in the root directory of your machine. If you do not wish to develope you own applications using the OPX you can delete this directory and its contents without affecting the operation of FlCalc. IMPORTANT: The supplied OPX is for ARM-based machines, such as the Series 5, Series 5mx, Series 7, Revo, etc. If you wish to run this application on the EPOC emulator then please contact the OPX author, EMCC (web address above) for the appropriate versions. If you get a message saying that a later version than the one supplied has already been installed on your machine then don't allow the older version to overwrite the newer. 3) Using PsiWin2 or the "Add/Remove" icon on the EPOC control panel (if you have it), install the main application *.sis file: FlCalc.sis If you get a message that the OPX SIS file has not been installed at the correct level then return to the previous step. 4) Finally, look in the "Extras" draw on the machine for the new "FlCalc5" icon. (See following section if FlCalc reports an error and fails to start) Please consult your Psion manuals for more details of these operations, but let me know if you're having problems. IF YOU HAVE PROBLEMS WITH OPX VERSION In order to provide copy and paste support, FlCalc requires the supplied version (or later) of the Cliptext.opx. Installing the supplied *.sis files should ensure you have the required levels installed. Unfortunately, there may be some older and misbehaved applications out there which do not supply the OPX correctly and these may cause problems with FlCalc and other applications that require a newer version. In addition, you may have problems if another application is running and has locked the OPX file when you install FlCalc. If you experience messages about incompatible OPX versions, or missing OPX files when starting FlCalc, please consider the following tips. 1) Close all applications and reinstall the supplied OPX *.sis file on to your Internal (C:) drive. Attempt to restart FlCalc. 2) If you still have problems, backup your machine (if possible). If you have installed the "Add/Remove" icon on your Series 5 Control Panel, use it to remove the package with a name similar to "Cliptext OPX EMCC", if present. Next, remove manually \System\OPX\Cliptext.opx from both C: and D: drives, if present. Now, reinstall the supplied OPX *.sis file on to your Internal (C:) drive and attempt to start FlCalc again. NOTE: I recommend keeping a copy of Cliptext.sis handy in case installing another misbehaved application in the future should regress the level of the OPX and cause problems with FlCalc and other applications. UNINSTALLING If you have finished with this software you can remove the application as follows: 1) Make sure the FlCalc application is not running. 2) Using the "Add/Remove" icon on the EPOC control panel, remove the "FlCalc" application. After you have completed these steps, FlCalc will have been removed from your machine's memory and "Extras" bar. NOTE: I DO NOT recommend removing the small OPX file, installed by the additional supplied *.sis package, as this may also be used by other applications. BASIC USE In its basic form, FlCalc is simple to use. Simply choose the application from the Extras bar, enter your calculation and press Enter. For example, try... 5+(7-2) By default, you can enter numbers in decimal or hexadecimal (other formats are available using special notation), as indicated by the second button in the status area (under the input line). To switch between them, simply tap the button, or choose the appropriate item from the main menu. The results of you calculations are displayed in the large window, with each value being displayed in multiple formats, e.g. both hexadecimal and binary. The selection of output format is made using the third button in the status area, or appropriate menu items. See the online help file (accessable from the "Tools" menu within the application) for detailed instructions for use, including details of operators and advanced expression syntax. A summary of operators follows... BINARY OPERATORS + :ADD - add - :SUB - subtract * :MUL - multiply / :DIV - integer divide % :MOD - modulus (remainder) & :AND - logical and | :OR - logical or ? :OR - logical or ^ :XOR - logical xor << :LEFT - shift bits left >> :RIGHT - shift bits right UNARY OPERATORS - :NEG - negative (2's compliment) ~ :NOT - logical not (1's compliment) # :MIRROR - mirror image of bits CHANGES The following changes have been introduced in version 1.5: * Revo support; * Copy/paste support; * Full input buffer editing; * Improved history buffer operation; * Minor bug fixes and enhancements. CONTACT If you have any problems, comments or suggestions about this software, you can contact me at the addresses below. I hope you find this software useful, Dave Rushall, 2000 --------------------------------------------------------- dave@piecafe.demon.co.uk http://www.piecafe.demon.co.uk/ ---------------------------------------------------------