◄ Back to index

# On-calc usage

# On-calc IDE

## Installation

You must first install FlashAppy on your calculator. Note that like all ROM patches, you will not be able to send your modified calculator ROM image to other calculators. Neither the authors of GTC nor the author of FlashAppy can be held responsible for any damage that could occur during or after this process. However, we are not aware of any case where a calculator was damaged by FlashAppy.

You only need to install FlashAppy once: you won't need to reinstall it after a reset or after upgrading to a newer version of GTC. On the other hand if you install an AMS update you will need to reinstall FlashAppy afterwards.

Legal notice: the `.89t/.9xt/.v2t` and `.89y/.9xy/.v2y` files in the `bin-89/92p/v200` directories are subject to the GNU General Public License, which grants you a number of rights. You may choose not to install them, but this will prevent you from using the TIGCC Library.

Once FlashAppy is installed, send all the files in the `bin-89`, `bin-92p` or `bin-v200` directory (depending on the model) to your calculator, and archive them all.

Check that the GTC flashapp was properly transferred by entering the Var-Link screen and pressing F7: you should see GTC appear in the list. Otherwise, the transfer failed: make sure that FlashAppy is installed and that you have enough Archive memory.

To create a test source file, create a directory named `source`, create an empty text file inside that directory named `hello` with the TI text editor, and archive it with the Var-Link screen.

Now you can run the IDE by typing `gtc\gtc_ide()` and open the file named `hello`.

Type in the following code:

    #include <tigcclib.h>

    void _main() {
      ST_helpMsg("Hello world!");
    }

Now press the F5 key. This should bring up a compilation dialog, which should close after a few seconds (if not, you may not have installed GTC properly: make sure FlashAppy is correctly installed, that everything is archived, and that you have enough RAM).

Once the compilation is over you can exit the IDE and run your program by typing

    outbin()

It should display the text `Hello world!` in the status line. If it worked, congratulations! You now have a working C compiler on your calculator.

## Key commands

Here is a small subset of the key commands supported by GTC IDE:

- CLEAR: indent the cursor by two columns (equivalent to the TAB key on a PC)
- Catalog: lists all functions available in the standard library
- F5: compile the current file
- 2nd-F3: search for a string in the current file
- Diamond-F3: replace a string in the current file
- F3: search for the next occurrence of the string

Also, GTC IDE supports keyboard shortcuts that the standard text editor doesn't: for example, you can press Shift-2nd-Right (press Shift and 2nd, then press Right while still holding Shift and 2nd) to highlight the text from the cursor to the end of the line. Likewise you can press Shift-2nd-Down to highlight a whole screen of text, or Shift-Diamond-Down to select until the end of the file. These shortcuts come in particularly handy when selecting large amounts of text.

## Tips and tricks

- You should map `main\outbin()` to a `kbdprgm` like `kbdprgm9` so that you can quickly run a freshly compiled program by typing Diamond-9 in the Home screen.
- You can save memory by deleting header files you don't use in the folder `zheader`. You should not delete `stdhead` or `keywords` if you want to compile programs designed for the TIGCC library.