ZX TOUCH PC TOOL  -  version 0.5
================================

A Windows program for the ZX Touch console. It does two jobs:

  * building and editing .ztg game packages, with FX, using a built-in
    ZX Spectrum emulator so you can see the result as you work;

  * arranging finished packages into the dashboards the console shows,
    and exporting them ready to copy onto the SD card.

Full instructions are in  ZXT_PC_Tool_Guide_v0.5.pdf , in this zip.
It is worth reading, but the few things you need to get started are below.


1. INSTALLING
-------------
There is nothing to install and nothing is written to your system.

  * Unpack this zip into a folder of your own - anywhere you like.
  * Keep ZXT_PC_TOOL.exe and the ROMs folder together in that folder.
  * Run ZXT_PC_TOOL.exe.

The tool creates a SETTINGS folder beside itself for its saved settings
blocks, and a small .ini file for the console connection details. Nothing
else is written outside its own folder, and nothing is added to the
registry unless you ask for it in step 3.


2. ROM FILES
------------
The ROMs folder in this zip is empty. ROM images are not included; put
your own into it, named exactly like this:

    ROMs\48.rom        the 48K ROM
    ROMs\128-0.rom     the 128K ROM, bank 0
    ROMs\128-1.rom     the 128K ROM, bank 1
    ROMs\trdos.rom     TR-DOS, needed to boot .trd and .scl disks

Having the files there is not enough on its own. The tool starts with its
own built-in SE ROM and never looks at the folder until you tell it to:

    Settings > Misc > ROM  ->  "Custom ROMs from ROMS"

Without trdos.rom, TRD and SCL disk images will not boot. Everything else
works with the built-in ROM.


3. OPENING FILES BY DOUBLE-CLICKING  (optional)
-----------------------------------------------
Nothing on your PC is associated with this tool until you ask for it. If
you want .ztg, .zxtproj and .zxtdash files to open in it when you
double-click them, run this once from inside the program:

    Tools > Associate .ztg, .zxtproj and .zxtdash with this tool...

It registers those three file types for your own Windows account only. It
needs no administrator rights, installs nothing, and you can undo it at
any time by associating the files with something else.

The registration points at the exact copy of the exe you ran it from. If
you later move the folder, or rename the exe, run the command again.


4. WINDOWS SMARTSCREEN AND ANTIVIRUS
------------------------------------
This program is not code-signed, so the first time you run it Windows may
show "Windows protected your PC". Choose "More info", then "Run anyway".

For the same reason an antivirus product may occasionally flag a freshly
built, unsigned program it has not seen before. If that happens, check the
SHA-256 checksum published on the download page against the file you have
before doing anything else - that tells you whether you have the real
thing, which no warning message can.


5. WHAT IS IN THIS ZIP
----------------------
    ZXT_PC_TOOL.exe               the program - a single, self-contained
                                  executable, nothing else is needed
    ZXT_PC_Tool_Guide_v0.5.pdf    the full guide
    README.txt                    this file
    ROMs\                         empty - see section 2


6. WHAT THE TOOL IS AND IS NOT
------------------------------
It is a design tool. The emulator is there to show you what your package
will look like on the console, not to play on: it is not synchronised to
the display refresh, so scrolling is less smooth and fine motion less
exact than on the real device. That does not affect judging a palette, a
shader, a background or a marker, which is what it is for.

If you do not own a ZX Touch, please do not judge the console by what you
see here.
