Stacker4x compression driver

Stacker4x is also hosted on HPCalc.org

Stacker4x allows HP48/49/50 owners to use compressed data as if they were normal. It is a compression driver, that will automatically compress / decompress all data transparently.

Stacker4x is inspired by Stacker for DOS, a 1990 PC software from Stac Electronics,
which compressed data on Hard Disk and allowed users to access them as if they were normal. Nowadays, the same can be achieved on Windows by checking the "compress" checkbox.

Stacker4x compress and decompress very fast to ensure smooth operation.
It is based on FastLZD v0.4c, which is about 10 times faster than other compressors.
Typical compression ratio is about 1.5, which means you can store approximately 50% more data in the same memory space.


Features available :
- Compress & store any object
- Transparently trap STO, RCL and Shift-menu keys
- Display memory savings
- Save & extract from/to extension ports (SD Card port :3: intentionnally filtered out)
- Can stop compression anytime by pressing a key
- Mass compression/decompression utilities provided
- Automatic recursive compression on directories
- Recover object in original format
- Programs are automatically decompressed & run
- Default to normal STO when not enough memory to compress


Current Version : Stacker4x v1.2

What's new : update FastLZD to v0.4c : Faster and better compression ratio


How to use it ?

Install the library on any port and reset the calculator (ON+C).
Note : the library can be installed into any extension port (for example : 1 STO).

After initialisation, Stacker4x will automatically install and activate itself.
You can de-activate it by using zMODE, or disabling the User Keyboard (LeftShift+Alpha).
Compressed data will still work properly even when Stacker4x is deactivated.

Quickest way to start Stacker4x is to run 'zDIR' from HOME directory.
All your data will be converted into compressed format, and you will be informed of how much memory is saved in the process.
You can also start 'zDIR' from any sub-directory if you want to test first.

Conversely, if you want to uninstall Stacker4x,
you first run 'uDIR' from HOME directory.
All your data is then converted back into original format.

When stacker4x is activated, data is stored in compressed format.
When it is deactivated, data is stored in original format.
Compressed data behave like normal data even when stacker4x is deactivated.

Version History :

Stacker4x v1.1
compressor update to FastLZD v0.4b

Stacker4x v1.0
initial release

zSTO : Proof of concept version (HP48)
Note : zSTO PoC is a program, not a library, and remap only STO/RCL keys.

Candidate features for future Stacker4x version :

- Detect when an object is already compressed to avoid another useless attempt at compressing it again (for example when using zDIR)
- Use less memory to create objects (currently uses Compressed-Size x 2, which is a problem for large objects)
- Faster auto-evaluation routine in assembler

Potential :
- Filter-out "Large" objects in main memory, to avoid running out of memory (no problem for expansion ports however)