******************************************************************************* * * * A M S E x t e n d e r * * * * by Stefan Heule * * member of boolsoft (www.boolsoft.org) * * * * ReadMe * * * ******************************************************************************* ------------------------------------------------------------------------------- Contents ------------------------------------------------------------------------------- I. Installation II. Uninstallation III. Features IV. Usage/Keys V. Limitations VI. How it works VII. License VIII. Credits ------------------------------------------------------------------------------- I. Installation ------------------------------------------------------------------------------- Choose the correct file(s) from the binary directory. You can choose the language, calculator model and the version, either compressed or uncompressed. It doesn't matter which version you'll take, with the compressed one you will have two files (the data and its launcher), but the total size is smaller. Also note, that the files are on-calc compatible, so you can send the files for the TI-89 Titanium to a Voyage 200, for example. This becomes handy if you want to send the program to a friend with a different calculator. The program installes among other things a TSR event hook. Therefore, it mostly follows Kevin Kofler's event hook conventions and uses his AMS 2 HW2 TSR support (h220xtsr) v1.12. As a result, you should install AMS Extender after any incompatible event hook. For more info 'How it works'. ------------------------------------------------------------------------------- II. Uninstallation ------------------------------------------------------------------------------- To uninstall the AMS Extender, simply execute it a second time. Do NOT use UnInEvHk! It won't crash your calculator, but some parts of AMS Extender will stay installed (the trap 4 hook, to be precise). ------------------------------------------------------------------------------- III. Features ------------------------------------------------------------------------------- Standard features: - It allows you to set the keydelay and scrolldelay to make scrolling everywhere faster. - You can now run kbdprgm's from everywhere on the calc, not just from within the homescreen. For example, if you are in the Y-editor, and you press [diamond]+[1], kbdprgm1 will start! Now, you can also use kbdprgm7 - kbdprgm9 - This hook will automatically add the brackets after the name of an executable program. Example: Type "tiex" into the command line, and press [ENTER]. The TiExplorer will be executed :) This even works, if you use a foldername together with the filename! - You can set the cursor blink rate (not very useful, but funny though) - It is possible to set a autostart application, which will be started every startup, even after the APD-feature turned the calc off. You can set the program to start in the options dialog. It will be searched in every folder, so don't care about this. - You also can change the APD (auto power down) timer. - I was too lazy to press [2nd]+[ON] to turn off the calc, so it is now possible to do this job just with [ON]. How relaxing :) - Start the three editors (program, text and data/matrix) with a key combo. There are hot key's for nearly all built-in Apps, but not for the (in my opinion) most used: the program and text editor. I think this is very stupid by TI... - Start a user defined program by pressing [2nd]+[MEM]. This is useful in combination with my utility CalcInfo to replace the old memory dialog with a better one. Some features are only available on the Voyage 200: - You can run kbdfuncX with [diamond]+[F1-F8] - It displays a digital clock in the right corner of the status line, with two diffrent formats (12h/24h or off). - [diamond] + [CLEAR] clears the whole home screen history (like ClrHome) - Adds a well-known feature (from every computer): "Select all". If you are in the home screen command line and press [diamond]+[A], the whole text will be selected. - It shows a small 7 level battery icon (also in the right corner of the status line, next to the clock). - You can choose between two diffrent keyboard layouts, the german and the english one (QWERTZ/QWERTY) - It is possible to change the angle-mode (between RAD/DEG) with a shortcut: [diamond]+[*] ------------------------------------------------------------------------------- IV. Usage/Keys ------------------------------------------------------------------------------- Voyage 200/TI-92+: - [diamond]+[MODE] to access the configuration dialog IMPORTANT: For this dialog to work, you cannot rename "amsext". Also, if you are using the compressed version, "amsext" has to be in the current folder. - [diamond]+[CLEAR] to clear the whole home screen history (like ClrHome) - [diamond]+[U] to start the program editor - [diamond]+[I] to start the text editor - [diamond]+[M] to start the data/matirx editor - [diamond]+[A] to select the whole text in the command line - [diamond]+[*] to change between RAD and DEG - [diamond]+[1-9] to start kbdprgmX - [diamond]+[F1-F8] to start kbdfuncX - [2nd]+[MEM] to start a user defined program - [ON] to turn off the calc TI-89/TI-89 Titanium: - [diamond]+[HOME] to access the options dialog - [diamond]+[CLEAR] to clear the whole home screen history (like ClrHome) - [diamond]+[1-9] to start kbdprgmX - [2nd]+[F4] to start the program editor - [2nd]+[F5] to start the text editor - [2nd]+[MEM] to start a user defined program - [ON] to turn off the calc ------------------------------------------------------------------------------- V. How it works ------------------------------------------------------------------------------- It is a TSR (terminate but stay resident) program, which installs itself in the RAM. This allows the program to stay active after the installation, so it can capture all events, but without disabling TI's event handling routines. This program uses Kevin Koflers HW2 AMS 2.0x TSR support v1.12. It is installed only in the installation routine on HW2 with AMS 2.0x and without HW2/3Patch. ------------------------------------------------------------------------------- VI. License ------------------------------------------------------------------------------- Copyright (C) 2006-2010 Stefan Heule This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . ------------------------------------------------------------------------------- VII. Credits ------------------------------------------------------------------------------- > AMS Extender > released: see history.txt > written by Stefan Heule > released under boolsoft > compiled with GCC4TI > Thanks to: - The TIGCC Team (http://tigcc.ticalc.org/) - Zeljko Juric for the great TIGCC documentation. - TI-Chess team for the TIGCC Tools Suite, especially ttbin2hex.exe. - Kevin Kofler for h220xTSR and UnInEvHk (http://www.tigen.org/kevin.kofler/) And I also want to thank him for the Vista-update of TIGCC. Additionally, he helped me solving many problems with the hook. - Greg Dietsche (gforce@calc.org) and Thomas Naeff (porter) (th.n@gmx.ch) for their sample TSR, which was really helpful! - Samuel Stearley and Greg Dietsche (porter) for the routine to get the pointer to the command line. - Olivier Armand (ExtendeD) for the routine to start programs and the code to uninstall a TSR. He used these things in his Integrated Desktop. - Again Olivier Armand (ExtendeD) for the documentation "ams_2.08_doc", with useful inforamtions about clock-relating routines. - Thorsten Kempas for the idea with the clock and the battery state (ISL) - Phip for testing the program on the Titanium and helping me to find some better shortcuts. - The guy who had the idea to shut down the calc by pressing just [ON]. I don't remember his name (there was a program at ticalc.org), so if you are this person or know him please let me know so I can give appropriate credits. - Boscop for bug reports and suggestions. - TI-Chess team for their tutorials, especially S1P3 for a TSR example. - Simon Hutter for bug reports and testing. > Contact: -mail to: calc@stefanheule.com -website: http://calc.stefanheule.com -msn: stefanheule@gmx.ch