5. Commands

5.1 JAVA

Usage: ( -> )

Toggles the 5 level stack. Note that Java does not work in a GX covered port. Putting it there will result in an error on execution.

Although previous versions worked in covered ports, it was not recommended as it slowed down the HP48's display updates. This is because the HP48 will copy everything from "covered" memory to "temporary" memory as it cannot execute it otherwise. This resulted in a large performance loss.

5.2 STK

Usage: ( -> )

STK allows you to configure your user flags 57-64 for use with Java:

• 57 : Force small font for algebraics, units, and arrays
• 58 : Use built in presets for ED/TED editors (Jazz or TED)
• 59 : Use EDIT (either StringWriter or user-defined 'EDIT')
• 60 : Try to use SSTK type display if Jazz exists
• 61 : When set, turns off on-stack equation view
• 62 : Turn oval menus OFF when CST menu shows
• 63 : Oval menus on
• 64 : Java running

Keys while in STK are:

• Up and Down Arrow keys to scroll up and down
• +/- toggles the flag highlighted by the scroll bar
• ENTER exits and saves changes
• ON exits without saving changes

Note there is no OFF key capability or 10 minute timeout while in STK.

In order to use an alternate editor, you first need to install the editor itself. Otherwise you will only be able to use the HP's built in editor.

If you select both editors, ED will be used. To use the built-in editor just make sure neither ED or EDIT are selected. Selecting an editor will automatically alter your EDIT and DownArrow keys (and VISIT on SX) even out of user mode, unless you are in user mode and have your own assignment. It also changes the interactive stack editor.

To use StringWriter or an alternate editor, simply select EDIT in STK. Since StringWriter has an xlib called EDIT, this is all you have to do. There is no need to run StringWriter's SWINIT. Otherwise, just store a reference to your editor in 'EDIT'.

For example, to use HP-Writer:

HOME << HPW >> 'EDIT' STO

The EDIT variable can be anything suitable for a standard User RPL EVAL. The program should take a string on level 1 as its argument.

5.3 AGROB

Usage: ( ob maxsize -> grob )

AGROB is the user interface to the algebraic to grob conversion utility. It takes an object from stack, along with the desired maximum font size, and converts the object into a grob. If the object is an algebraic expression or of some other suitable type, equation writer form output is produced.

The size argument should be a real number in the range 1 to 3, where 3 specifies the maximum possible starting font size.

AGROB with generate an error and leave the arguments on the stack if there is insufficient memory to create the grob.

5.4 FHOOK

Usage: ( -> )

FHOOK is a hidden command that does not appear in the Java menu, but can still be typed in or put in programs. It forces another check for Jazz Hook (used in SysRPL mode). This is only useful for GX users who use the JAZZ command to "uncover" their ports. After you JAZZ your port, just run FHOOK to update Java's local variables.

Note that STK also checks for Jazz Hook on exit, so if you always use STK to enable SysRPL mode, you do not need to use FHOOK.

5.5 CLRCACHE

Usage: ( -> )

CLRCACHE is another hidden command that does not appear in the Java menu. If Java is running, CLRCACHE clears the contents of the current AGROB cache. This is useful if you are changing the algebraic size flag manually or from within a program instead of using STK. If you always use STK to change Java's settings, you do not need to use CLRCACHE.

CLRCACHE is only available in the Java flavours that support AGROB.