WELCOME TO THE ICONS README FILE

If you have ANY questions, comments or bugs to report, write to fryedsoft@calc.org

If you want to check for upgrades for icons as well as other programs/games: go to The Fryed Software Homepage! http://fryedsoft.calc.org

There is an all new way to learn how to use Icons, Check out the Interactive Help System at http://fryedsoft.calc.org/iconinfo

the File iconhelp.89t is a help file that will answer most questions about icons, the icon-add system and the insert files, icon set switching using an icon, and much more. if you use Icons in a teaching environment or pass it around via Calc2Calc, t is recommended that you include this file to help the new user get used to the icons interface. if you are reading this, the same file is below the installation procedure section of this readme

the File Lines.89p is a screen saver for icons

the file folder.89i is an icon for icons. use it as a model for other icons.

the file iconedit.89g is the Icon editor for Icons. if you want to install it, send the program to your Ti-89 and run the Icon-add system to install the program into the Graphical user interface

The File kbdprgm.89g is a keyboard enhancement for Icons. If you want to install it, send it to your Ti-89.

the file iconlite.89p is the lite version of Icons. read the Icons lite readme for more information

Icons Readme

Icon Editor for Icons Readme

Keyboard Program Add-on Readme

Icons Lite Readme

Icons Program Management System. 89 Edition Version 2.3

INSTALLATION PROCEDURE:

WARNING Icons must be installed in the Main directory for the program to work correctly. This had to be done in order to keep other programs from corrupting icons when they change folders. Previous Icons programs could run programs in other folders, but if execution stopped and the folder was not changed back to main, system corruption would occur. Icons corrects this error by forcibly changing to the main folder. If you try to move Icons to another folder, Corruption May occur and the system files would appear in the main folder anyway. I know some users might not like this feature, but it was unavoidable and was the only way of fixing the problem without adding a lot more code to the system. Also, I have not tested Icons in an Archived state. I'm guessing that it will work, but I'm not sure.

If you are upgrading from Previous Versions of Icons:

1. Ungroup the file icons.89g
2. send the file icons.89p to your calculator
3. run the GUI to make sure that it is working properly

To install on a Ti-89

1. send the file icons.89g to your calculator
2. run the GUI to make sure it is working properly.

Ti-92 TO Ti-89 CONVERSION NOTES:

This program is a direct port of Icons 5.5. everything that can be done in the Ti-92 version of Icons can be done in the Ti-89 version of icons, But there are a Few differences in the way the two programs handle. If you have used the Ti-92 version of Icons, You should read this section.

• ROM Discrepancies: Basically, the Ti-89 handles errors a lot differently that the Ti-92, So I had to restructure the system to handle this. I have not had the chance to fully test and debug the new codebase, but I feel that it is just as stable as the Ti-92 version
• Icons Home Screen Dialog Box: this part gets really screwy. When I ported it over to the ti-89, the Icons Home screen would not display the answer if you tried to solve a variable (Ex: Solve(4x=3,x)), instead it would give an error 140 "argument must be a variable name". If you ran the Home screen separate from the Icons codebase though, it would work fine. Now it is a local program to icons. If you want to run the home screen from an icon, just insert the program name homediag() in the exact program name box and it should run. I tried this with the Ti-92 but it wouldn't recognize the local program so this doesn't work on the Ti-92 version yet, but I'm going to try and do it
• screen size: The Ti-89 version of icons only has 9 Icons instead of the 16 icons on the Ti-92 version. but the calling of Icon sets through an Icon still works, so 9 sets x 9 icons in set = 81 programs that can be launched. not near the 256 program launches the Ti-92 version can do, but I think that's enough :)
• readme file. I have not updated the Readme file, It is on my webpage, but due to the fact that Icons 89 is not much different from the 92 version it also will not be changed. if you are a teacher using icons, you may want to direct your students to http://fryedsoft.calc.org/iconinfo. the readme is on this page as well as information about the current Icons release
• Note: Icons have been directly ported from the Ti-92 to the Ti-89, I have tested it for errors and have found none, but the Ti-89 is different from the Ti-92 and may crash where the Ti-92 would not. If it does crash, please E-mail me exactly what you did to crash it, the error, and if possible, exactly where in the program it crashed. Ill try to figure it out as soon as I can. The Icon Editor Also Falls into the Above Category

• Fixed long display bug in Home Screen Dialog box. If a long answer occurs, It shouldn't crash
• Fixed Main Folder assignment problem. This should fix Icons from accessing other folder's Icons settings
• Fixed a typo in the System Info feature.
• Fixed Graph Setting mode Error. This fixes some problems associated with the graph setting on 3d
• Added Icon Redunancy in Icon Display Routine, if an Icon picture is Invalid, it will display the Folder icon on the desktop instead of causing an error.

2.2

• Fixed the Alpha key problem so that the mouse works when the alpha key is locked. Special Thanks goes to Mark Karasek for the Program Sample.
• Fixed bugs in the Error routine. This fixes a problem if the Iconinfo file was erased and you pressed Esc during the repair sequence.
• Apperantely, My calculator's Icondata and Iconset file got mixed up into the 2.1 release, So if you tried a clean install of Icons, It would crash looking for my FF7 backround and Icon. I cleaned it out in this release. Of course, If you installed FF7 you had no problems :P

2.1

• Removed the "Use Interface Picture" Setting in the "Edit Interface" Section of Icons. It now automatically detects if the image file actually exists and if it doesn't, will not attempt to show a picture. deleting the filename removes the backround now. This is also been changed in the Lite Version of Icons.

2.0

• Added the about screen. this tell you all about the Ti-89 and the memory left on it in a percentage scale
• Added the Iconlite program to the zip file. This is a working copy of icons but is much smaller than the full version of Icons (9000 vs. 6000) at the cost of the Icon add system, the Icons Home screen, the toolbar support, and the helpful dialog.

1.1

• Added support for keyboard program shortcuts, Now you can access the programs without running icons Via the numeric keyboard. read the enclosed kbdprgm.txt for more details

1.0

• Initial Version.
• First true Graphical User interface for the Ti-89:

Icon Editor for The Icons Program Management system (89 Edition).

INSTALLATION PROCEDURE:

1. Send the File iconedit.92g to your calculator
2. find an open slot on the desktop to insert the icon
3. click on APPS select ICON MANAGEMENT and ICON ADD SYSTEM
4. Follow the instructions to install the Icons to the desktop

HOW TO USE THE ICON EDITOR

click on the icon to start the program, once you do that, select either MAKE A NEW ICON or EDIT AN EXISTING ICON. Enter the name of the icon in the Name box that appears after you make a selection. Wait until it scans the Icon and start drawing when the Crosshairs appears on the screen. Notice that there are two views, a regular view in the upper left hand corner of the screen, and a full blown view where you draw. Press enter the draw or erase. Press Esc to either Quit without saving or save the picture in the desired format and Exit the Icon Editor. You must draw something or the save function will not work. also if the name was invalid, a box will come up asking you to change it. Also remember that the icon editor will overwrite anything that has the same name as the name you typed in the name box. the icon editor automatically sizes the picture for best memory savings. The largest icon that can be made in the editor is 16x16.

Keyboard shortcut add-on for The Icons Program Management system (89 Edition).

WHAT DOES THIS DO?

Basically, it allow you to access the current Icon set without having to run the Icons interface, The keyboard shortcuts correspond to the exact position of the Icon on the Icons Interface. For example, Lets say you have the Icon Editor Defined as an icon in the upper left corner of the screen. If you wanted to, you could access the program without running icons buy pressing DIAMOND 7. If you moved the Icon to the Lower right corner of the screen, You would use DIAMOND 3 to access it.

INSTALLATION

1. Send the File kbdprgm.89g to your ti-89.
2. If you Have icons currently installed, and Icons Are Defined to it, It should work Immediately.

Note: This add-on Will Not Work If Icons Is Not Installed Also, this will overwrite any other Programs that uses shortcuts or any shortcuts/Programs you may have defined

SCREEN TO KEYBOARD MAP

If you have an Icon set which calls other Icon Sets, You will have to run through the Hierchary that you would have to go through Icons. For example lets say that you have an Iconset "main", with a call to iconset "games" Set up in the Top Middle of the screen, and in the games Iconset, you have "Lightning" in the upper right corner. and "return to main iconset" in the lower left corner. In order to access lightning, you would have to press DIAMOND 8 then DIAMOND 9, just like you would have to do if you were running the interface. If you run icons right after running this sequence you'll find yourself in the games Iconset, unless you press DIAMOND 1 before running Icons to return you to the main Iconset.

ERROR MESSAGES

since this add-on is not an integrated part of Icons, It does not have the built in error handling Capabilities of Icons. This section deals with errors you may receive when trying to use this system.

Argument Must Be a String: This usually means that the Icon Is not Defined. If you define an icon in that slot, it should work.

Program Not Found: You might have typed the Program name wrong In icons.

it runs the program for awhile, then an error occurs: The program caused an error

Basically, If it runs in icons without Errors, It should run fine on the keyboard

Icons Lite Quick Information

Icons Lite is a smaller version of Icons. On an 89 it really doesn't matter because you have 512K of program space to use, So it's recommended that you use the full version of icons. But If you want to save 3K of your memory, you can install this version of icons.

To Install

1. Install the Icons Interface First
2. send the file iconlite.89p to your calculator
3. Delete icons from your calculator and if you wish, rename the file from iconlite to Icons.

The lite Version will

1. access your files
2. show your backround image
3. run your screensaver
4. have the error handling that makes Icons one of the most stable shells on the Ti-89

However it will not have

1. the Icon add system
2. the Icons Home Screen
3. the Toolbar support
4. the Descriptive text that tells you what to do if something bad happens
5. the System Info support
6. the cool looking splash screen :)