============================== F E A T U R E S ==============================

  This program will let you convert any Z80 Snapshot to a TZX Tape file. This
means that you will be able to play that file into a real ZX Spectrum (or an
emulator) without any special hardware. Both 128k and 48k snapshots (all
versions) are supported. .SNA and other support will come later. You can use
any other snapshot convertor to convert different formats to .Z80 format.
  There have been a few utilities like this, but I felt this needed doing. The
reasons are because most of the previous utilities lack the support for
customizing the resulting TZX file or had too many bugs. TAPER has a really
nice support for the conversion from Z80 to TZX format, unfortunetly it has
so many bugs that it is practically unusable. I could bug-fix it, but it would
take way too much time and it needs DOS to run (Doesn't run on XP !).
  With this utility you are able to customize your TZX file in several ways.
You can change the speed of loading (from standard speed to 400%), all
messages that you see while loading can also be changed and added. Also you
can supply a custom external loading screen. I have gone through a great deal
of testing (around 300 Z80 snapshots which didn't work with TAPER all work
with this).

  There are still some snapshots which rely on the last line on screen to be
original - this line is corrupted because it is used to store all registers,
etc. These include games like Back To Skool and Skool Daze. You will have to
snapshot these at a later time (in-game for instance). Unfortunetly nothing
can be done here...

  There are several ways you can customize your TZX file. You can change the
Loading: Name to anything you want ( 8 Characters only ). You can also change
the Game Name that is shown before the SCREEN$ is loaded. Also you can add
two extra lines of info on the bottom of the screen if you want.

  The converter takes care of several issues when loading the snapshot :
  
- Loader for 48k and 128k Snapshots is the same. Only part that is different
  is the AY and 128k Paging registers setup.
- Each page is checked if it is empty - if so then it is not loaded at all.
- Each page is compressed and if its length is smaller than original size
  it is kept compressed. Also an additional check is done to see if the
  decompression procedure doesn't overwrite the compressed source !
- The first page or the custom loading SCREEN$ is always loaded compressed
  and is displayed instantly.
- If custom loading screen is present then the last page is always loaded
  decompressed so the loading of the screen looks nice (backward loading).
- In the end the 768 bytes long block is loaded with Normal ROM routines,
  and only if it is needed. This overwrites the are where the loader and
  register info is kept before it is moved into the last line of the
  screen area.

============================ R E Q U I R E M E N T ==========================

z802tzx tested and worked fine on the following configurations:

- IcarOS i386               (Kickstart 51.51, Workbench 40.0, AROS ABIv0)
- AROS One i386             (Kickstart 51.51, Workbench 40.0, AROS ABIv0)

================================= U S A G E =================================

This utility req big stack size:

1.AROS> stack 100000

Example of conversion with its own screen-file:

1.AROS> z802tzx Example/bb.z80 -$ Example/bb.scr

================================ S O U R C E ================================

Based on aminet version 1.0 by Tomaz Kac.

version 1.1 added:

  - version and stack support
  - stack size control
  - default loading speed set in 0
  - makefile rewritten
  - source included

        ______ ______              ______ ______ 
 ______|:: .__|:: .__|_____ ______|:: ___|:: ___|______ _____ 
|: ,   |:  |  |:  |  |:  ,_|:  ,__|:___  |:___  |:  -  |:  ,_|
|__|___|______|______|___|   _____|______|______|______|___|

                home cross-compilation factory

PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
[unknown]                 9538   11420  83.5% -lh5- 84d5 Oct 27 01:21 z802tzx.info
[unknown]                93296  249277  37.4% -lh5- 48ef Oct 27 00:56 z802tzx/C/Z802TZX
[unknown]                16295   20920  77.9% -lh5- bda3 Oct  1  2020 z802tzx/Docs.info
[unknown]                 2276    5061  45.0% -lh5- a363 Oct 27 00:59 z802tzx/Docs/README
[unknown]                 3156    5120  61.6% -lh5- ff2f Oct  1  2020 z802tzx/Docs/README.info
[unknown]                 9569   11420  83.8% -lh5- 9bbf Sep  6  2019 z802tzx/Example.info
[unknown]                 5161    6912  74.7% -lh5- 5e7f Oct 27 00:57 z802tzx/Example/bb.scr
[unknown]                11733   17434  67.3% -lh5- 7efb Oct 27 01:11 z802tzx/Example/bb.z80
[unknown]                  321     997  32.2% -lh5- 8ba6 Oct 26 01:43 z802tzx/Install
[unknown]                 1481    1824  81.2% -lh5- 0329 Oct 19  2020 z802tzx/Install.info
[unknown]                16178   17408  92.9% -lh5- 2850 Oct 26  2020 z802tzx/Source.info
[unknown]                  727    4052  17.9% -lh5- f1bd Nov 21  2003 z802tzx/Source/loader.h
[unknown]                  212     413  51.3% -lh5- eda7 Oct 26 01:41 z802tzx/Source/Makefile
[unknown]                  196     294  66.7% -lh5- 3d1c Nov 17  2003 z802tzx/Source/StdAfx.cpp
[unknown]                  463     873  53.0% -lh5- 6288 Nov 21  2003 z802tzx/Source/stdafx.h
[unknown]                15233   57164  26.6% -lh5- e9c3 Oct 27 00:55 z802tzx/Source/Z802TZX.cpp
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total        16 files  185835  410589  45.3%            Oct 27 01:02