SpeedUI is the software turbo for your HP-48 G/G+/GX


SpeedUI is very modular.
It consists of various libraries,
of which you can use one, more, or all, at your choice.
You can activate or de-activate SpeedUI at run time,
no need for a warmstart.


The only library you'll always need, and which must be stored in port 0,
is CF.LIB (see CF.txt)



Features overview of the various libraries:
--------------------------------------------
A1,A2,A3 These libraries are no longer supported!
	Please see below how to uninstall these libraries.

B0	fast replacement for the built-in form engine.
	Not as fast as the SpeedMaster package,
	but you can see and feel the difference compared
	to the built-in version.
	Enabled via WARP toggle switch in config.
	As a nice feature hot key searches in long lists can now be interrupted,
	which wasn't possible in the orig. version.
	BE SURE TO STORE B0.LIB IN EITHER PORT 0 OR 1.

B1	fast replacement for the built-in MsgBox drawing mechanics.
	The somewhat faster User input form preprocessor is included, too.
	In one of the next versions, it may be expanded to include
	extended features like check fields and choose fields,
	if there's enough positive feedback.

B2	Very fast replacement for the built-in charset browser,
	with char echo capability, of course.
	Also shows keyboard shortcuts for direct char entry.
	Enabled via WARP toggle switch in config.
	Also has the keyword CC to be called from the CMD line
	or in programs.
	This library catches the Last Command key combination,
	and simply adds a title bar to the Choose box.

B3	fast replacement for the built-in Choose box engine.
	With switchable font size and Sliders.
	Now with Master-Detail capability.

B6	Master-Detail CHOOSE user interface.

CF	configures all replacement libs. WARP toggle switch to
	enable or disable replacement libs.
	Toggle switches to enable/disable alpha lock of repl. A1 and A3.
	Font size setup.
	Also contains the ML decompiler and other utilities
	commonly used in SpeedUI.
	The SpeedUI config menu can be accessed
	when holding the backspace key during warmstart.


EA	Very fast MatrixWriter replacement.
	Fully compatible to the built-in MatrixWriter,
	but much faster display and key response.
	New features so far:
	Up to six visible columns (the orig. MW offered only 5)
	Up to seven visible rows (the orig. MW offered only 5)

	Font switching. You can switch between the normal (medium) font,
	and the small 3x5 Font, even while you're in the MW.

	The MW starts with the font (medium or small) which has been
	selected in the SETUP of the Config library (CF.LIB) .

	Border wrapping.
	This means if you're at the very top, left, bottom, right border
	of a matrix, you can go one step beyond the border,
	and you're at the opposite border. Also works with repeating keys.

MB	MessageBrowser. Sample application for the SpeedBrowser.
	Shows all HP-48G built-in messages in categories.
	Works with the built-in browser, too.

SB.LIB	The SpeedBrowser. See separate doc for details.

UI.LIB	The very fast 6-level stack replacement.
	Shows amount of free memory and port status.
	If a multi-bank card is placed in port 2 it will show
	the amount of banks in that card.
	Includes 6-level interactive stack.
	Now the input line has up to six visible rows.
	Now includes all of the features of my previous
	keyboard replacement libraries (A1,A2,A3) .
	This replacement has the fastest possible status display,
	and the fastest command line and multiline editor.
	The editor has now features a second menu page,
	with COPY/PASTE, clipboard browser,
	and online command catalog with parameter help.

	See separate doc for details.

FC.LIB	The very fast FlagBrowser
	Shows descriptions for system or user flags.
	If FC.LIB and B0.LIB are installed,
	the MODES input form will call FC when pressing the
	[FLAGS] menu key. FC.LIB also has the keyword FC
	to be called from the cmd line or in programs.

	The FC is included in B0.LIB now.
	The separate FC library is included for users who don't
	want to install B0.LIB .


IB.LIB	The fast interactive Input Form Builder for the HP-48
	See separate doc for details.

LB.LIB	The list browser
	Like James Donnelly's list browser, but faster and more compact.

RP.LIB	The configurable Key Repeater
	This Repeater offers three configurable delays.
	You can set a delay before the first key action,
	another delay before the first repeat, but after delay1,
	and another delay between repeats.
	See separate doc for details.

UF.LIB	User frontend for various SpeddUI settings.
	Contains user keyword SETUPB for the SpeedUI config menu



Important notes and restrictions:
----------------------------------
The only library of the set you'll always need is CF.LIB .
Many of the other libraries are optional,
which means you can install one, or more of the libraries in any combination,
depending on your needs and taste, and available memory.
There are a few exceptions (besides CF.LIB):

Notes on the key libraries (A1,A2,A3):
---------------------------------------
The replacement keyboard libraries are OBSOLETE now,
and are no longer supported!

If you have one or more of the keyboard libraries installed,
you'll need to uninstall them to avoid any interferences
with the new UI library.

A method to safely uninstall them will follow.


To uninstall A1, A2, A3 do the following:

You'll ned to have the latest version of CF.LIB and
a config suppressor installed, like CFGSUPPR.LIB .
Then create a list in the HOME directory:
{ 161 162 163 } 'NoCfg' STO .
Do a warmstart.

If you have A1.LIB installed:

161 SWAPLIB
161 # 18CD7h SYSEVAL
DUP # 076AEh SYSEVAL
:&: 161 PURGE 

If you have A2.LIB installed:

162 SWAPLIB
162 # 18CD7h SYSEVAL
DUP # 076AEh SYSEVAL
:&: 162 PURGE 

If you have A3.LIB installed:

163 SWAPLIB
163 # 18CD7h SYSEVAL
DUP # 076AEh SYSEVAL
:&: 163 PURGE 


After having removed all replacement keyboard libraries,
please perform a warmstart.



Notes on the new Library Cat:
------------------------------
There are two minor 'restriction' when using the new library cat.
The current version won't work if the current directory
is not the HOME directory. Wll be fixed soon.


Unlike the built-in version, the replacement doesn't check
whether a library has been removed while displaying it's top level menu.
So if you remove a library while displaying it's library cat menu entry,
and then press the appriorate soft key,
you'll simply get an empty menu.
If you're in a specific libraries main menu, and then remove that library
without changing the displayed menu, the menu will not disappear,
but pressing one of the menu keys for that lirary will simply
generate a 'Library closed' message.
However the things mentioned above are just display limitations,
there are no functional restrictions here.
And you'll get the fastest library menu ever seen on on an HP-48
The library cat can be updated by simply pressing rs+[LIBRARY] again.

Notes on the MSGBOX & CHOOSE libraries:
----------------------------------------
B1.LIB and B3.LIB should both be installed,
or more exactly, B1.LIB could be installed without B3.LIB ,
but if you want to install B3.LIB (which is highly recommended),
you should also install B1.LIB .

This is because the MSGBOX command relies on the predefined
frame grobs in B3.LIB, most of which I omitted.

However, it'll work with B3.LIB replaced only,
but MSGBOX applications with more than three lines of text
will write some text over the frame border,
which doesn't look too good.



Notes on the six-level stack:
------------------------------
There are some library functions, like the six-level stack UI from UI.LIB,
which will be invoked by CF.LIB , but don't need CF.LIB to be present.



And here's a small survey:
---------------------------
If anybody is using the built-in INFORM user level command,
please drop me a note.
If I get a reasonable amount of replies,
I'll make some effort to speed up the
user user INFORM mechanics in B1.LIB even more.



That's sufficient for today.
If you have suggestions or problems with the program,
contact the author:	Magic48ges@gmx.de
