                 ░            ░▓▄▄▄▄▄
▄             ▓  ▓▀ ▀▀▀▓▄▄▄▄▄  ▀▓█▄ ▀▀▀████▓▄▄▄▄              ▓
██▓██▄▄▄     ▓░        ░    ▀▀▀▀▒▀█▓▄       ▀▀▀▀██▓██▄▄▄     ▓░
  ░▀▀▀▓███▓▄█▒                  ░  ▒   ▀░         ░▀▀▀▓███▓▄█▒
      ░  ▀▀█ ░                     ░                  ░  ▀▀█ ░


                     Quick Commander v3.30
                           For users


    Quick   Commander  (QC  from  here  on)  programs  the  disk
controller  WD1793  (KR1818VG93)  directly,  so it does not work
with  a  hard  disk.  It needs TR-DOS 5.03 or later: it does not
work  with  TR-DOS  5.01.  The  exception is esxDOS on a DivMMC:
there QC works with TRD images on the SD card through its TR-DOS
emulation (see "QC under esxDOS").


    :: Starting the commander

    QC  comes  on  the disk image QC_3_30.TRD. Its first file is
boot, a copy of QC's file, so QC starts as any TR-DOS disk does:
with  RUN  in  TR-DOS,  from  the  ROM's  menu, by an emulator's
autoboot  of the image, and under esxDOS with Enter on the image
in the browser (see "QC under esxDOS"). The image can be written
to a real floppy too. Quick Setup (on the same disk) saves QC as
boot.B on any disk with the settings you choose.
    Under  esxDOS  QC  can  also be the default boot in place of
TR-DOS   Navigator,   with   the  kit's  files  TRDBOOT.BIN  and
TRDBOOT.OVR: then QC starts on any image that has no boot of its
own. How to set it up, "QC under esxDOS" tells.
    Some  parts  of QC - the viewers, disk_Utils, Save boot, the
help,  the  player, the packer (P) and the unpacker (U) - lie in
its  overlays: the .qco file beside QC on its disk (under esxDOS
/SYS/TRDBOOT.OVR).  On  128K  and more QC reads that file at the
start  into pages of memory of its own (#D6 and #D4: pages 6 and
4 on 128K, 30 and 28 on Pentagon 512/1024/4096, 22 and 20 on KAY
1024,  where a reset doesn't clear them either, while the 128K's
reset  of  BASIC  128  does;  Copy and Move leave them alone, so
their  buffer  is  32K  smaller  than before 3.30), and when the
overlays  of  this  version  are  already there (QC checks their
checksum),  it  doesn't  read  them  from  the disk. QC's kernel
itself is more compact since version 3.30, so while the overlays
stay  in  memory  (after  an exit to TR-DOS, a program that left
their  pages alone, or a reset that doesn't clear the memory) QC
loads  and  unpacks faster than before. On the first start after
power-on  QC  reads  the  overlays  too, and on 48K it reads the
overlay  needed  from  the  disk  at  each call. If the overlays
aren't  in  memory  and  a  catalogue  read  (the key 5, a drive
chosen)  finds  their  file  on  the disk, QC offers to load it:
"Load QC 3.30.qco? Y: yes"  (on  48K  QC just remembers where it
lies,  and  when  a  call  finds  another disk there or the file
spoilt,    it   asks   for   the   disk   with   the   overlays:
"Insert the disk with QC 3.30.qco in A? Y: yes",  and  when that
drive  is  the  input one, after reading the overlay it asks for
your disk back: "Insert INPUT." and a key).
    QC  supports  the  extended memory of Pentagon 512, 1024 and
4096  (the  port  #AFF7), Scorpion 256 and 1024, KAY 1024, Profi
1024,  ATM1, ATM Turbo 2+ and ZX-Evolution (not Scorpion GMX nor
the  Pentagon-4096  on  GitHub).  QC  takes  up to 1024K for the
buffer,  as  before  (a  whole  disk  copies with 640K), and the
window  of  the modes shows the machine and all the memory found
(4096K  on ZX-Evolution, 2048K on Pentagon 4096). On Scorpion QC
keeps off page 8 (the shadow monitor's) by itself, and the setup
can keep QC off page 8 on the other machines too. With more than
128K  QC  also  keeps  off the page where QC's resident is (#D7:
page  7 on Scorpion, Profi, ATM and ZX-Evolution, 31 on Pentagon
512/1024/4096,  23  on  KAY  1024);  on 128K that is page 7, the
buffer's last (0, 1, 3 and 7: 256 sectors).
    If  you  have  more  than 128K of memory but for some reason
don't  want  QC  to use it, hold W (Without) while QC starts: QC
starts in the 128K mode.
    If you have 1M of memory of the Pentagon standard, hold Caps
shift  while  the  commander starts for QC to find it; otherwise
only  512K are checked. Don't hold Caps shift while QC starts on
other  machines: a plain 128K computer and ZX-Evolution with the
TS-Conf firmware would have their memory locked till a reset.
    If you have a Shadow RAM of 16K or 32K, you can load QC into
it  and  then  start  it  at once from almost any program with a
press  of  the Magic button. Quick Setup puts QC there (its item
5,  see  "Setting up the commander");  QC's  overlays  (the .qco
file)  don't go there: QC started by Magic takes them from their
pages, and when those don't hold them (a program has used them),
from  the  disk:  at once from the disk in the input drive if it
has  them,  else offering to load them at a catalogue read. Till
version 3.30 I was held while QC started for that.
    QC  can also be put into the ROM in place of Basic 128: then
Reset  starts  QC  at once. The kit has the file QC_3_30.rom for
that.
    QC  keeps  some  of  its  settings in the memory of the CMOS
clock (Gluk or SMUC), in the bytes #10, #15, #16: the output and
the  input  drive,  the current menu, the cursor's position, the
full  catalogue  mode,  the looping of the tunes. When QC starts
from  the  ROM  or the Shadow RAM, these settings come back. The
setup  can  turn  the work with the CMOS clock off or leave only
the  clock  shown  (then  the  settings  are  neither  kept  nor
restored), and it chooses the clock's type. Whether the clock is
there  QC  checks at the start: it reads a register of the clock
for  a  whole  frame and, if it changes or is #FF, works without
the  CMOS.  So on a grey 128 or +2, where the clock's ports give
rubbish  (the  screen's  bytes),  QC  shows no ??:??:?? time and
takes no settings from the rubbish.


    :: QC under esxDOS

    esxDOS on a DivMMC mounts TRD images from the SD card as the
drives  A-D and itself carries out the TR-DOS calls QC makes. QC
starts  from  such an image as ever and finds esxDOS itself: the
window  of  the  modes shows "esx" on the right of the machine's
line. Copy, Move, Erase, Rename, Merge, Unpack, the viewers, the
disk's name and running programs work as with a floppy. Tried in
emulators with esxDOS 0.8.9 on the Spectrum 48, 128, +2A, +3 and
Pentagon  128  (QC  finds esxDOS 0.8.5 and later; the ZX-Uno and
the Next in its esxDOS mode, which have it too, weren't tried).
    disk_Utils (U), the menu of work with the disk, is not there
under esxDOS: an image has no track 161 for the catalogue's copy
(it  has  160  tracks), and its tracks are neither formatted nor
ever   bad.   Its   menu  item  is  dim,  and  the  key  U  says
"Not available under esxDOS." till a key is pressed. T leaves QC
for  esxDOS's own TR-DOS, as for a program: its title and A>, as
after  a  reset, and RETURN there goes to BASIC 48. A drive with
no  image  says  "No Disk."  at  once. SMUC's clock doesn't work
under esxDOS (its ports answer only while the TR-DOS ROM is in),
and  QC  turns  it off. Nor does QC look there for the memory of
Scorpion  and KAY past 128K (their port #1FFD picks the ROM on a
+2A and +3).
    esxDOS  0.8.9 opens SCL images too, but can't write to them,
and  older versions don't know them. So QC comes as a TRD image.
TRD images have no write protection under esxDOS. esxDOS doesn't
write  past  the end of an image cut after its last file, and QC
then says "Error." (Retry, Abort, Ignore).
    QC  as  the  default  boot (TRDBOOT). When the image started
with  Enter  in  esxDOS's  browser  has no file boot, the TR-DOS
emulation  runs  the  file /SYS/TRDBOOT.BIN from the SD card (in
esxDOS's kit it is TR-DOS Navigator). QC's kit has a TRDBOOT.BIN
of  its own: with it Enter on any such image starts QC with that
image  in  drive  A,  as  a boot on an ordinary disk would. QC's
overlays  (the  viewers,  Save  boot,  the help, the player, the
packer,  the  unpacker)  lie  beside  it,  in  /SYS/TRDBOOT.OVR:
without  them QC works, but without these parts. An image with a
boot of its own still runs its boot. Tried with esxDOS 0.8.9.
    Quick Setup puts it there: run it from the kit's image (from
QC  or  with  RUN),  choose  4 (Save QC as TRDBOOT.BIN on the SD
card),  set  it  up  and  press  S. Quick Setup writes its QC as
/SYS/TRDBOOT.BIN,  its  overlays  as /SYS/TRDBOOT.OVR, and keeps
another  boot that was there (Navigator) as TRDBOOT.NAV (to have
it  back,  give  it  its old name again; if TRDBOOT.NAV is there
already,  Quick  Setup  installs nothing and says so). Later the
same item shows the settings of the QC there, and S writes Quick
Setup's  QC  (its version) with them. /SYS/CONFIG/TRDOS.CFG must
have    AlwaysBoot=1    (the    default).    By   hand:   rename
/SYS/TRDBOOT.BIN  and copy TRDBOOT.BIN and TRDBOOT.OVR from QC's
kit to /SYS.


    :: Running files

    The main menu shows the basic files alone. To run one, press
Enter (or 0) or click it with the left mouse button. In the file
menu  files  are run by Enter. If QC starts in the main menu and
the  disk  has  no basic files, it goes to the file menu at once
(Space takes it back to the main menu, as ever).
    For  a quick start of the files in the main menu use the hot
keys  A..V (printed left of the names of the first column); Caps
shift  +  A..V run the files of the second column. Some hot keys
are  QC's  keys too (F, H, I, N, R, S, T, U): such files are run
with Caps shift when the second column has no file on their line
(always so with 22 files or fewer), otherwise by Enter.
    If  the  cursor is on a basic file (type ".B"), it is run at
once.  A  code file (".C") is loaded at the start address of its
entry and started there (as made for QC 4.00; till 3.20 the load
and  the  start address were asked for). A code file loaded into
the screen (its start #4000..#5AFF: a picture or memory from the
screen  on)  Enter shows as V does. Enter runs no files of other
types.  On  the start the screen and the memory are cleared, the
stack is set to #5FE8, page 0 of the memory is switched on.
    When  a  file  is run, the resident remembers the output and
the  input  drive,  the current menu, the cursor's position, the
full catalogue mode, the looping of the tunes, and when you come
back to QC (if the program supports that), they are restored.
    Files are run without the BASIC procedures, so deleted files
and files with the same names can be run too.


    :: Controls

    The  cursor  is  moved by 6, 7, 8, 9 and by the cursor keys.
Enter  (and  0 in the main menu) runs the file under the cursor.
Space  switches between the file menu and the main menu, as does
a  click  of the left mouse button on the line "Quick Commander"
above the menu.

    At  the  bottom  of  the  screen  is  the menu line with the
operations  of  the  current mode. Their hot keys are printed in
capital letters: for example, to copy (Copy) press C. The menu's
items  can be clicked with the mouse. The other keys of the mode
are  shown  by  the  help (Help, see below). While the overlays'
file (.qco) isn't there, the items that need it are dim: such an
item  only  tells where to get the file; under esxDOS disk_Utils
is dim too, it doesn't work there, and on 48K Pack and Saveboot,
which need more memory.

    These hot keys work in both the main and the file menu:

    ? (Symbol shift + C) or H (Help) - the help: in place of the
panels a frame shows in two columns the keys of the current menu
and the keys both menus share, and under them what the key under
the cursor does. 6, 7, 8, 9 and the cursor keys move the cursor,
Home (SS+Q) and End (SS+E) put it on the first and the last key.
Space switches QC to the other menu (the main or the file menu),
as  in  the panels, and shows its help. Any other key closes the
help  and  does  its command in the current menu. Enter, ? and H
only  close the help. The menu line can be clicked as usual. The
help lies in QC's overlays (.qco), as the viewers do.

    1,  2, 3, 4 - choose the working drive (A, B, C, D) and read
its  catalogue. The drive buttons are in the upper right corner:
the upper row the working drive, the lower row the drive to copy
to; the chosen drive is bright. A button's colour is the drive's
speed  (see  "File menu" below). The buttons can be clicked with
the mouse.

    Symbol  shift  + 1, 2, 3, 4 - choose the drive A, B, C, D to
copy to.

    5 (5-reread) - read the disk's catalogue again.

    Home (SS+Q) - the cursor to the catalogue's start.

    End (SS+E) - the cursor to the catalogue's end.

    I  (Info)  -  switch  the  units: the disk's free space, the
buffer  and the size of the marked files are shown in sectors or
in kilobytes (the memory in the window of the modes is always in
kilobytes).

    If  your  mouse  has  a  3rd  button,  it  reads  the disk's
catalogue again.

    QC  reads  the mouse's buttons as a Kempston mouse has them:
the right one is bit 0 of the port #FADF. ZX-Evolution gives the
left  one  there,  so its buttons come swapped: put them back in
Quick  Setup  (Mouse:  swapped).  QC  looks for the mouse at its
start:  it reads the buttons for a whole frame and works without
the  mouse  if  one of them reads pressed. So QC sees for itself
that  there  is  no  mouse  on a grey 128 or +2 too, whose mouse
ports give garbage (the screen's bytes).


    :: Main menu

    The hot keys of the main menu:

    N  (diskName)  -  rename  the  disk:  the  disk's name is 11
characters. Here left and right move the cursor, Delete erases a
character,  Edit  mode switches Russian or English letters, Caps
Lock  capital  or  small letters, Home (SS+Q) puts the cursor at
the  start,  End (SS+E) at the end. Russian letters are typed in
the YAWERTY layout: the letters ч, э, ш, щ, ъ, ю are a, s, f, g,
d,  x  with Symbol shift. Extend mode and the right mouse button
leave the renaming, Enter and the left mouse button save the new
name.

    U (disk_Utils) - the menu of work with the disk, see below.

    R  (Run_in_48k)  -  run the file under the cursor in the 48K
mode:  bit  5  of  #7FFD is set, 0 is written to the port of the
extended memory (if there is one).

    T (Trdos) - a quick exit from the commander to TR-DOS (under
esxDOS to esxDOS's own TR-DOS, see "QC under esxDOS").

    S (Saveboot) - save the resident copy of QC in the memory to
the  disk  as "boot.B", and beside it QC's overlays' file (.qco:
without it QC from this disk has no viewers, help, player, P, U,
disk_Utils  or  Save boot). The settings chosen in the commander
are  saved in this copy. Each file takes the place of the disk's
first  file of its name (boot.B: any, not only QC's; TR-DOS runs
the  first)  if  that  one is as long or the disk's last file; a
longer  one  leaves  the  rest  of its sectors as a deleted file
after  the new one (M gives them back); a shorter one is deleted
and  the  new one goes at the catalogue's end, as on a disk with
no  such  file. On 48K, and if the resident copy was overwritten
while copying files or by a program run (QC checks the start and
the  end  of  its  page  and the code's checksum), the commander
cancels  and  says  why till any key: "Not available on 48K." or
"No resident.". If the disk has no room or the catalogue has 128
files  already,  No  Space  flashes  at the bottom of the screen
(boot.B, if it had room, is saved already).


    :: File menu

    The  line  "Buffer:nnnn"  (in  both menus) is the memory, in
sectors (in kilobytes after I), that Copy and Move will use.

    Unlike the main menu, where all the files are of one colour,
the  file  menu  colours  the files by their types: 24 groups of
files. All the colours can be set in the commander's setup.

    The  setup can also set the speed of reading and writing for
each  drive.  The  speed  chosen  is  seen  by the colour of the
drives'  buttons  (in  the upper right corner; the upper row the
reading speed, the lower row the writing speed): green for slow,
yellow for fast.

    Before  the  operations  that  change  the  disk's catalogue
(copy, move, delete, rename, merge, unpack, pack, save boot, and
also the disk's renaming) the catalogue of the disk in the drive
is  compared  with  the  one  in the commander's memory. If they
differ,  the  operation  is  cancelled  with  "Bad disk"  on the
screen, and after any key the disk's catalogue is read again.

    The window of the modes shows:

    "pen 1024k"  -  the  machine and all its memory: zx - 48K or
128K  (and  with  W  at  the  start),  pen  -  Pentagon,  evo  -
ZX-Evolution,  atm  -  ATM,  k/s - KAY or Scorpion, pro - Profi,
+2/3  -  a Spectrum +2A or +3 (by its ROM). The line is in lower
case:  it has no hot keys. On the right of this line "esx" tells
that  QC runs under the TR-DOS emulation of esxDOS (on a DivMMC,
see  "QC under esxDOS"), and on a ZX-Evolution its configuration
is there in esx's place: "bs" (Baseconf) or "ts" (TS-Conf).
    "res" - QC's resident is in the memory (page #D7). A program
run  may  overwrite  it,  and  on  128K,  where  its page is the
buffer's  last,  Copy, Move, P, U of a big file, a file over 48K
viewed  (a  text,  music, sprites) or an ALASM source too, and a
gigascreen also on Scorpion, Profi, ATM and ZX-Evolution (#D7 is
page  7  there). Before running a program or going to TR-DOS (t)
QC   checks   the  resident  by  its  checksum  and,  if  it  is
overwritten,  wipes  its  mark: a program that can go back to QC
doesn't  jump  into  spoilt code. Till the panels are drawn anew
"res" may stay on after a viewer.
    "ovr"  -  QC's  overlays  are there: on 128K and more in the
memory  (pages  #D6  and #D4), on 48K their file is found on the
disk or the SD card.
    "Full"   -  the  mode  of  showing  ALL  128  files  of  the
catalogue  is  on: it can help with deleted files. The hot key F
turns it on and off.

    The other hot keys:

    Graph  (CS+9)  and  0  -  mark  or unmark the file under the
cursor;  the  cursor  then  goes to the next file. Deleted files
can't be marked.

    True video (CS+3) - the previous page of files.

    Inv video (CS+4) - the next page of files.

    C  (Copy)  -  copy  files  to  the  drive chosen with Symbol
shift + 1..4.  With no marked files the file under the cursor is
copied.  The  files are copied in the order they were marked in.
While  copying, "squares" in the lower right corner show how far
it  has  got:  the  upper  row  the  reading,  the lower row the
writing. If the drive to copy to is the working one, QC asks you
to  change  the  disks  (Insert OUTPUT, Insert INPUT) and checks
that  the  disk  put  in  is  the one asked for: for another one
"Bad disk."  (none:  "No Disk."),  then  the  key  A cancels the
copying  and  any  other  key asks again. If the disk lacks room
(No Space)  or  room  in  the  catalogue  (Cat Over),  the key A
cancels  the  copying  and  any  other key reads the disk again.
After  copying to another drive QC shows the disk copied to, and
cancelled with another disk than the input one in the drive, the
disk in the drive.

    M  (Move)  - compact the disk. It works only if the disk has
deleted  files.  While  compacting, "squares" in the lower right
corner  show  how  far it has got. If the disk has marked files,
ONLY  the  files after the first marked one in the catalogue are
compacted.  The  deleted files can't be restored after it, so QC
asks  first, "Move: deleted files lost for good? Y: yes": only Y
compacts.

    E (Erase) or D - delete files. With no marked files the file
under  the  cursor  is deleted. QC asks first: "Erase <name>? Y:
yes" for one file or "Erase N files? Y: yes"; only Y deletes.

    R  (Rename)  - rename the file under the cursor, as the disk
is  renamed in the main menu; Graph moves the cursor between the
name  and  the  type. Down and up write the name, as Enter does,
and  go  on to rename the next or the previous file. A character
typed  in  place  of  the chequered sign ▒ that starts a deleted
file's  name  restores it. File names may be in Russian letters:
QC works with them as with the other files, but TR-DOS can't.

    G  (merGe)  -  join  the  marked  files  into  one,  in  the
catalogue's  order: the name, the type, the start and the length
in  bytes  stay  the  first  file's. There must be no deleted or
unmarked  files between them, otherwise nothing happens. If more
than  255  sectors  are  marked,  several files are made (of 255
sectors  and  the rest) in the first marked files' entries, with
their names and types.

    V  (View) - if the cursor is on an @-file (192 sectors long)
or  on  a  screen  file  (6144  or 6912 bytes, or 11136 bytes: a
screen   with   its   border,   .bsc;   on  a  Pentagon  (and  a
ZX-Evolution), a 48K, a 128K, a +2A/+3 and a Scorpion the border
is drawn too, on other machines in one colour, the most frequent
in its picture; when the border is drawn approximately - strokes
shorter than 3 cells or more than 6 colours in a row - or in one
colour,  a  sign  of  two  wavy lines is in the picture's bottom
right  corner; 13824 bytes on 128K and more: a gigascreen, .img,
its  two  screens  shown  in turn each frame; on 48K such a file
goes  to  the  text  viewer),  the  picture viewer starts. There
Space,  A  or the left mouse button change the picture's colours
(but  for  a  .bsc  and  a gigascreen: their own colours alone),
Enter  goes  to  the  next  file (see below), the other keys and
Break  go  back  to the commander. If the file is a font (768 or
2048  bytes long), the font viewer starts (Enter: the next file,
the other keys: back). If the file under the cursor is neither a
picture  nor a font, the text viewer starts: see below. To start
the  text viewer whatever the file is, use CS+V. Pictures, fonts
and  texts  packed  with Hrust v1.x, v2.x and ZX0 are shown too:
data of up to 64K (Hrust's up to 56K) are unpacked straight into
the memory pages, in the 48K mode up to 16K (Hrust's up to 14K).

    A  gigascreen may flicker badly with stripes in an emulator:
it  makes  about  50  frames a second (a Pentagon 48.8), while a
computer's  monitor  mostly  shows  60, so the screens alternate
unevenly.   It  isn't  QC's  fault:  in  MAME  running  it  with
-speed 1.2288 -waitvsync  helps  (60 frames a second, each shown
once; the machine and its music faster then). A real Spectrum on
a TV has no such flicker.

    Z  (muZ)  -  find  music in the file in the Pro Tracker v3.x
format  (by the signatures "ProTracker" and "Vortex Tracker", in
the whole file) and in the Pro Tracker v2.x format (such modules
have  no  signature:  they  are  found by the structure of their
header  in  the  file's  first  3K, a module without a player or
after  Pro  Tracker  2's  player; a PT3 without its signature is
found so too). The tune may be compiled or not, with a player or
without.  Music found starts playing at once. Files of up to 255
sectors  are  searched  (in  the  48K mode only the file's first
16K).  While a tune plays, the two lower lines show the module's
format  (PT3.x,  VT  II  or  PT2),  its name and its author (Pro
Tracker  v2.x:  the  name  alone),  the  lower  right corner the
music's  indicators,  and under the clock the modes as signs: >>
playing  fast, || the pause, a circle with an arrow the looping,
TS2  or  TS1  for  TurboSound  (see  below) and the order of the
channels (ABC, ACB, BAC). While the music plays these keys work:

    B (Begin) - play the tune from the start.
    F (Fastplay) - play the tune three times faster.
    L  (Loop)  - loop the tunes on or off. When the looping's
      sign  isn't  shown,  at  the  end  of the tune the next
      file in the catalogue is taken (or the next marked one,
      if there are any: see Enter below).
    P (Pause) - pause on or off.
    C (Channels) - the order of the AY's channels in turn: ABC,
      ACB, BAC (for the stereo of the AY's outputs); QC's
      setting: Save boot saves it, Quick Setup sets it (Tunes).
    Enter - the next file (see below).
    Any other key - back to the commander.

    The  player  is  Sergey  Bulba's  PTSPlay  (the  Turbo Sound
player).  On  its  start it finds the module's version and makes
the  tables of volumes and notes it needs. While playing, one of
two portamento algorithms works (the old one for version 3.5 and
lower,  the  new  one  for  3.6+ and Vortex Tracker II), and the
commands  1  and  2  with  delay 0 in modules of version 3.7 and
newer  follow  the rule of Pro Tracker 3.7. The sound is exactly
as  in  the editor. Two AYs (TurboSound, NedoPC's standard) play
Vortex  Tracker  II's  pairs  of modules (two PT3 modules in one
file with the mark 02TS at its end) and Alone Coder's TurboSound
modules of Pro Tracker 3.7: TS2 under the clock; with one AY, or
a  pair  longer  than  16K, the first module alone plays: TS1 on
red.  The  indicators  show  the  channels  of both AYs. Modules
longer than 16K are not played; a module that crosses a boundary
of  the file's 16K parts QC gathers into one part before playing
it.  The player lies in QC's overlays (.qco), as the viewers do;
F stays for the session.

    Music  packed  with  Hrust v1.x, v2.x and ZX0 is played too:
the file is unpacked as in View.

    NOTE:  on  Enter  in  View  and  muZ, if the disk has marked
files,  the  cursor  goes to the next of them (in the order they
were  marked  in;  after  the  last  one,  to  the first again),
otherwise to the next file in the catalogue (after the last one,
back  to the commander). That file is then shown as a picture or
a  font  (by  its  length),  else searched for music; if none is
found, the text viewer shows the file.

    U  (Unpack)  -  unpack files packed with Hrust v1.x, v2.x or
ZX0  (Einar  Saukas). At the prompt "Unpack file:" type the name
of the file to write (the packed file's name is offered). If the
name's  input  is  broken  off,  the unpacking is cancelled. The
packed  file may be of any length, the unpacked data up to 65280
bytes  (255  sectors:  TR-DOS has no longer files; Hrust's up to
56K);  in  the  48K  mode  both  the file and the data up to 16K
(Hrust's  data up to 14K). A ZX0 stream is recognised by itself,
in  any  file (ZX0 has no header). QC's standard for such files:
.zx0  (type  z,  "x0" in the start field) and .z_<type> (type z,
"_"  and  the original type), as .p_<type> is for Hrust: U gives
the  unpacked  file  back its original type (the others get type
C),  and  the panel colours such a file as its original type. On
errors  QC  says  what is wrong till any key: "Not packed." (the
file  isn't),  "Too long."  (the file or the unpacked data don't
fit),   "No Space. Free: N" and "Cat Over. Free: 0" (no room on
the disk or in the catalogue, as for Copy).

    P  (Pack)  - pack the file under the cursor with ZX0 by QC's
own  packer,  on the Spectrum itself. At the prompt "Pack file:"
type  the  name of the new file (the file's name is offered with
the  extension  .z_<type>,  QC's standard for ZX0 files: U gives
the  original type back). If the name's input is broken off, the
packing  is  cancelled. The file may be of any length (up to 255
sectors):  it  is  read from the disk and the packed one written
into  the  disk's free space as it packs, so the memory does for
any  file;  the catalogue entry is added at the end. A stops the
packing (the disk left as it was), the progress squares show how
far  it  is.  It  works  on 128K and more (not in the 48K mode).
Packing  is  not  fast: 32K of text takes about a minute. If the
file  can't be packed, QC says why and waits for any key: on 48K
"Not available on 48K.",  with  no  room  on  the disk or in the
catalogue  "No Space. Free: N"  or  "Cat Over. Free: 0" (as Copy
does), for a packed file over 255 sectors "Too long.", on an old
entry past the catalogue's end (Full shows it) "Error.".

    A  double  click  of  the left mouse button on a file's name
searches  the  file  for  music,  pictures and fonts; if none is
found, the text viewer shows the file.

    The  right mouse button held down and drawn over files marks
them (or unmarks them, if the first file was marked). A click on
the  upper  or the lower half of the right panel turns the pages
of  files back or on, a click on the scroll bar moves the cursor
to the file there.

    + or L - mark all files (the marked ones are unmarked).

    CS+L  -  mark  files by a mask. At the prompt type the mask:
its empty places are shown as the chequered sign ▒, which stands
for  any character (Delete puts it back). On Enter all the files
that fit the mask are marked (the marked ones stay marked).

    - or X - unmark all the marked files.

    CS+X  - unmark files by a mask. At the prompt type the mask,
as  for  CS+L.  On  Enter  all  the  files that fit the mask are
unmarked (if they were marked).

    CS+R  -  rename  files  by a mask. If the disk has no marked
files,  you  are  asked to mark files by a mask first. Then type
the  mask the files are renamed by: the characters typed replace
the names' ones, the places with the chequered sign keep them.


    :: disk_Utils

    The  main  menu's  U  (disk_Utils;  till  3.22 C, Care_menu)
enters  this  mode,  Space leaves it. After an operation QC goes
back  to  the main menu. The menu is for real floppies; it isn't
there  under  esxDOS  (see  "QC under esxDOS").  It lies in QC's
overlays (.qco), as the viewers do.

    The hot keys:

    K  (Keep catalog) - save the catalogue to track 161 (usually
unused;  the  track  is formatted for it). The copy is read back
and compared with the catalogue; if it didn't get there, QC says
so.

    S  (Show  differents) - compare the catalogue with the saved
one.    The    result    is    "Directories are different"    or
"Directories are matching",  and till a key is pressed the panel
shows the saved catalogue. With no copy on track 161 QC says so.

    E  (rEstore catalog) - write the catalogue saved before from
track  161  to  track  0,  after  a question (Y: yes); the other
sectors  of  track  0  are kept. If there is no TR-DOS catalogue
there,  QC  says  so  and  writes nothing. Before that make sure
(with  Show)  that track 161 has a saved catalogue of this disk,
or you risk losing the disk's catalogue for good.

    C  (Check  disk) - a quick check of the disk. A track with a
sector  read  not  at the first try, or not at all, is formatted
again  and its sectors written back as they were read. The usual
"squares"  in  the corner of the screen show how far it has got.
At  the  end QC tells how many tracks were written again and how
many are bad (still not read after that).

    R  (Restore disk) - restore the disk: every track is written
again so. Useful for badly read floppies. A floppy formatted not
by  QC  can  be  restored too: the disk is turned into a special
format  that  programs  work  with notably faster. At the end QC
tells the bad tracks.

    NOTE:  Check  disk  and  Restore  disk  can start not at the
disk's  start  but  at  a file: mark the file to start at in the
file  menu, come back to disk_Utils and start the operation. The
key  A  stops Check disk, Restore disk and Format disk after the
current  track,  Space  after  the current sector. A sector that
isn't read is tried 4 times, and QC goes on asking nothing.

    F  (Format  disk)  -  format the disk. First type the disk's
name  (11  characters).  If  you refuse (with Extend mode or the
right  mouse  button), the formatting is cancelled; otherwise it
starts AT ONCE. The analyser "squares" in the lower right corner
show how far it has got. QC formats the disk FROM ITS END TO ITS
START:  80  tracks,  two sides, 2560 sectors, 2544 of them free.
Each  track  is read back and, if it isn't read, formatted again
(up  to  three  times);  QC  counts the bad tracks at the end. A
formatting stopped with the key A writes no catalogue.


    :: Text viewer

    The  text viewer shows any file of up to 255 sectors, in DOS
(cp866)  or  UTF-8, with any line ends (#0D, #0D0A, #0A). A file
of zero sectors isn't read.
    The  text's  coding  is  found  automatically:  UTF-8 by its
correct  multibyte  sequences. If it was found wrong, C switches
the coding (Convert, see below).
    The  text is coloured by the ACEdit standard. M (Mode) steps
round  the  modes:  the colours, the colour codes shown as signs
(the  text  in one colour), the colour codes hidden (the text in
one colour).
    An  ALASM  4.x  source  (a  file  of  up to 16K with ALASM's
header,  type  H)  the  viewer shows as a text coloured as in an
IDE:  labels,  instructions,  jumps,  directives,  operands  and
comments each in a colour of its own.
    The  colours of the info line and of the text by default can
be changed in the commander's setup.
    On  48K the viewer shows the first 16K of a text. A text may
have  any number of lines: the viewer finds them as it goes, not
all at once.

    Controls in the viewer:

Up a line:                            9, Q, up
Down a line:                          8, A, down
Up a page:                            True video, left
Down a page:                          Inv. video, Space, right
To the text's start:                  Home (SS+Q)
To the text's end:                    End (SS+E)
The next file (see above):            Enter
The wrap mode (round):                W (Wrap)
Convert the text:                     C (Convert)
The colour mode (round):              M (Mode)
The key click on/off:                 S (Sound)
Back to QC:                           Edit mode, Break or the
                                      right mouse button

    S  (Sound)  turns  the  key click on and off not only in the
viewer  but  in  the  whole commander. It is QC's setting (since
3.30):  Save boot saves it with QC, and Quick Setup sets it (Key
click).

    While  you  move  through  the text, the info line shows the
position in per cent of the whole text.

    The  converter (Convert, the hot key C) switches the coding:
DOS (cp866) or UTF-8. On C the file is loaded again and shown in
the  other  coding.  The  viewer turns UTF-8 into cp866: Russian
letters,  pseudographics  and the signs of the viewer's font are
shown  as  they are, quotes and dashes as " ' -, the ellipsis as
three  dots, Ukrainian and Belarusian letters as similar Russian
and  Latin ones, the other characters as ?. The coding in use is
shown in the info line (DOS or UTF).

    There  are  2  modes  of wrapping the lines that go past the
screen's  edge:  a  simple  one and a "smart" one, which finds a
separator (" ", "!", "?", "-", ":", ";", ".", ",", "/", "\") and
wraps  the  line  after it. W (Wrap) switches the modes, and the
info  line  shows the current one: <=> no wrapping, >=< the part
of  the  line  past the screen's edge goes to the next line, >W<
the lines are wrapped at a separator.

    The  modes  W  and M set are QC's settings (since 3.30): the
viewer  starts  in them next time, Save boot saves them with QC,
and Quick Setup sets them (Text wrap, Text codes).

    With  the  mouse, the items of the info line can be clicked:
the  file's name - the next file, DOS (UTF) - switch the coding,
<=> (>=<, >W<) - switch the wrapping mode.

    The screen with the text is divided into 4 parts:

                   ┌───┬───────────────┬───┐
                   │   │               │   │
                   │   │       3       │   │
                   │ 1 ├───────────────┤ 2 │
                   │   │       4       │   │
                   │   │               │   │
                   └───┴───────────────┴───┘

    A click on part 1 moves a page up, on part 2 a page down, on
part 3 a line up, on part 4 a line down.


    :: Sprite viewer

    Symbol  shift  +  V starts it. It looks mostly like the text
viewer.

    Controls in the sprite viewer:

Up 8 lines:                           Q, up
Down 8 lines:                         A, down
Up a line:                            9
Down a line:                          8
Up a byte:                            6
Down a byte:                          7
A narrower sprite:                    O, left
A wider sprite:                       P, right
To the sprite's start:                Home (SS+Q)
To the sprite's end:                  End (SS+E)
The next file:                        Enter
The key click on/off:                 S (Sound)
Back to QC:                           Edit mode, Break or the
                                      right mouse button

    On  Enter  the next file is shown by its kind (as a picture,
music  or  a  text),  not  as  a sprite. The info line shows the
address  in  the  file in place of the per cent. With the mouse:
part  1  (see the text viewer) makes the sprite narrower, part 2
wider,  part 3 moves 8 lines up, part 4 8 lines down, the file's
name gives the next file.


    :: Setting up the commander

    QC's  defaults  (the  drives and their speed, the modes, the
CMOS  clock, page 8, the colours) are kept in the file "QC 3.30"
itself  and  can be changed with any disk doctor. Where they are
and  what  each  bit  means,  and  how a program goes back to QC
through  the  resident,  the  text  for developers (tech_en.txt)
tells.

    It's  handier to change them with Quick Setup 3.30: it is on
the kit's disk (the file "QS 3.30") and runs from QC or with RUN
"QS 3.30"  in TR-DOS. Quick Setup carries QC in its file (so the
file is longer): it sets QC up and saves it where you choose, or
starts it, and under esxDOS it puts the SD card's disk images in
the  drives  too.  Its  menu:  9, 8 and the cursor keys move the
cursor,  Enter  or  the  item's digit chooses the item, the line
under  the  menu tells what the item at the cursor does; ? and H
show  the  help, Edit goes back to QC through its resident, else
to  TR-DOS.  An  item  that  isn't  there  (no esxDOS, no Shadow
RAM...) is grey, and the line tells why.
    1  - Start QC: QC with the settings shown starts at once, as
from its disk.
    2  -  Save QC as boot.B on a disk: the drive is asked (A-D).
QC's file takes the place of the disk's first boot.B if that one
is as long or the disk's last file; a longer one leaves the rest
of its sectors as a deleted file after the new one (M gives them
back); a shorter one is deleted and the new one goes at the end.
QC's  overlays (.qco) go beside it by the same rules, from Quick
Setup's  own  file (its disk in its drive): no room for them, or
another disk there, and the line says so.
    3  -  Save  QC as a ROM image (16K, to be written to a ROM):
qc_rom.C  on the disk in the drive asked, under esxDOS QC.ROM in
the SD card's current folder.
    4 - Save QC as TRDBOOT.BIN on the SD card (under esxDOS, see
"QC under esxDOS").
    5 - Save QC in the Shadow RAM (Pentagon's cache): Magic then
starts  QC.  QC's  overlays  (.qco)  don't go into the cache: QC
takes  them from their pages, and when a program has used those,
from the disk (see "Starting the commander").
    6  - Mount a disk image from the SD card (under esxDOS), see
below.

    Items  1-5 show QC's settings first: those of the QC already
where  it goes (QC 3.20 or later: the resident for 1, boot.B for
2,  TRDBOOT.BIN  for  4,  the Shadow RAM's for 5), else the ones
used  last;  the  top  line  tells  where  they  came  from. The
settings: the mode at the start, the drives and their speed, the
full  catalogue,  the  tunes  (the  looping and the order of the
channels),  the  mouse  (Kempston's  buttons or swapped), page 8
(used  or  never),  the  key  click, the CMOS, the text viewer's
modes,  the  colours  of  the  file  types and of QC itself. The
cursor:  6  7  8 9 and the cursor keys; Enter and Space change a
value  (a colour's ink and paper), B and F a colour's bright and
flash.  S (the green button at the bottom) does the item: starts
QC,  or  saves  it there (on a disk read back: "Not saved" if it
didn't  get  there),  and Quick Setup goes back to the menu with
the  result;  an error is told on the spot. K keeps the settings
in Quick Setup's own file: its next start shows them. D puts the
release's values, R the ones the screen began with, ? and H show
the  help,  Edit  (the  grey  button) goes back to the menu. The
mouse  works  too:  a  click on an item, on a key's word or on a
button.

    The  SD  card's  images  (6,  under esxDOS): the TRD and SCL
images  and the folders of the current folder. A-D put the image
under the cursor in that drive, Enter opens a folder or puts the
image  in  drive  A,  E takes a drive's image out, N makes a new
empty  TRD  image (its name is asked), R reads the folder again.
Under  the  list:  what each drive holds (the image's name if it
was put there from here).

    On 48K Quick Setup keeps its QC in the memory's top 16K. The
images  need  that memory, so after them items 1-5 are grey till
Quick Setup is run again.

    The  resident is needed for Save boot and for a quick return
to the commander from programs that can leave with QC's start.

                 ░            ░▓▄▄▄▄▄
▄             ▓  ▓▀ ▀▀▀▓▄▄▄▄▄  ▀▓█▄ ▀▀▀████▓▄▄▄▄              ▓
██▓██▄▄▄     ▓░        ░    ▀▀▀▀▒▀█▓▄       ▀▀▀▀██▓██▄▄▄     ▓░
  ░▀▀▀▓███▓▄█▒                  ░  ▒   ▀░         ░▀▀▀▓███▓▄█▒
      ░  ▀▀█ ░                     ░                  ░  ▀▀█ ░


                           Thanks to:

         Max Petrov - the boot that QC was inspired by
          Sergey Bulba - the ProTracker 2 and 3 player
             Ivan Roshin - the PT3 player's tables
            Hrumer, Alone Coder - the Hrust depacker
            DarkMax - the scroll bar, the analysers
             Urusergi, introspec - the ZX0 depacker
                Pawel Kislyak - code exchange ;)
                Looker - the idea of Quick Setup
                 Einar Saukas - the ZX0 packer
                   Znahar - the sprite viewer
                     Mentat - design, font
                         Wizard - font


                 ░            ░▓▄▄▄▄▄
▄             ▓  ▓▀ ▀▀▀▓▄▄▄▄▄  ▀▓█▄ ▀▀▀████▓▄▄▄▄              ▓
██▓██▄▄▄     ▓░        ░    ▀▀▀▀▒▀█▓▄       ▀▀▀▀██▓██▄▄▄     ▓░
  ░▀▀▀▓███▓▄█▒                  ░  ▒   ▀░         ░▀▀▀▓███▓▄█▒
      ░  ▀▀█ ░                     ░                  ░  ▀▀█ ░


                        More information:

    The author of the program is Andrey Bogdanovich aka Spectre.
QC will go on developing as long as I get feedback on it. Wishes
about QC are always welcome by e-mail: spectre@zxby.org.

    The  ZX0  depacker  in  QC  is  (c)  2021 Einar Saukas (with
Urusergi  and  introspec),  under  the BSD 3-Clause licence; its
text is in the text for developers (tech_en.txt).


                 ░            ░▓▄▄▄▄▄
▄             ▓  ▓▀ ▀▀▀▓▄▄▄▄▄  ▀▓█▄ ▀▀▀████▓▄▄▄▄              ▓
██▓██▄▄▄     ▓░        ░    ▀▀▀▀▒▀█▓▄       ▀▀▀▀██▓██▄▄▄     ▓░
  ░▀▀▀▓███▓▄█▒                  ░  ▒   ▀░         ░▀▀▀▓███▓▄█▒
      ░  ▀▀█ ░                     ░                  ░  ▀▀█ ░