░ ░▓▄▄▄▄▄
▄ ▓ ▓▀ ▀▀▀▓▄▄▄▄▄ ▀▓█▄ ▀▀▀████▓▄▄▄▄ ▓
██▓██▄▄▄ ▓░ ░ ▀▀▀▀▒▀█▓▄ ▀▀▀▀██▓██▄▄▄ ▓░
░▀▀▀▓███▓▄█▒ ░ ▒ ▀░ ░▀▀▀▓███▓▄█▒
░ ▀▀█ ░ ░ ░ ▀▀█ ░
Quick Commander v3.20
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.
:: Starting the commander
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. To load QC into the Shadow RAM, hold
I (Install) while QC starts: QC answers with a green flash of
the border. After that the Magic button starts QC.
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_20.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.
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. The setup can
also keep QC off the page where QC's resident is, when there is
more than 128K (#D7: page 7 on Scorpion, Profi, ATM and
ZX-Evolution, 31 on Pentagon 512/1024/4096, 23 on KAY 1024).
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.
:: 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.
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 (A, C, F, H, I, K, N, O, P, Q, R, S, T): 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 Q, A, O, P and 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).
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 the keys of the current menu (left) and the
keys both menus share (right) and what they do. Any other key
closes the help and does its command; ? and H only close it. The
menu line can be clicked as usual.
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.
K (autoKeep) - turn the autoKeep mode on or off: the special
mark "Quick Commander" is written to (or erased from) track 0 of
the disk. With autoKeep on (the disk has the mark), the
operations that change the disk's catalogue save it to track 161
automatically: rename file, rename by mask, rename disk, delete
files, move disk, merge files, copy files (the catalogue of the
disk copied to, if it has the mark), save boot, unpack file.
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.
C (Care_menu) - 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 (Tr-dos) - a quick exit from the commander to TR-DOS.
S (Saveboot) - save the resident copy of QC in the memory to
the disk as "boot.B", with the settings chosen in the commander.
The file is added at the catalogue's end; an earlier boot.B is
not replaced. Saving may be impossible if the resident copy was
overwritten while copying files or by a program run (QC checks
the start and the end of its page), if the disk has no room or
if the catalogue has 128 files already: then the commander
flashes the border red and cancels.
:: 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, save boot, and also
the disk's renaming and autoKeep) 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. The
line is in lower case: it has no hot keys.
"res" - QC's resident is in the memory (page #D7). A program
run may overwrite it, and on 128K (or if the setup doesn't keep
its page out) Copy and Move too.
"Fullcat" - 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.
"aKeep" - the autoKeep mode is on.
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). 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.
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.
D (Delete) or E (Erase) - delete files. With no marked files
the file under the cursor is deleted.
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; the border is shown in one colour,
the most frequent in its picture), the picture viewer starts.
There Space, A or the left mouse button change the picture's
colours, 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 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).
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). 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 in
words: Fast, Loop, and Pause while paused. 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 word Loop is
not lit, 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.
Enter - the next file (see below).
Any other key - back to the commander.
The player is Sergey Bulba's PTxPlay. 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. Modules longer than
16K are not played, nor, in files longer than 16K, modules that
cross a boundary of the file's 16K parts (but for those starting
in a part's last 6912 bytes).
Music packed with Hrust 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 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 (the file not packed, no room on the disk or in the
catalogue, the file too long) QC flashes the border red.
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.
:: Care menu
The main menu's C (Care) enters this mode, Space leaves it.
After an operation QC goes back to the main menu.
The hot keys:
K (Keep catalog) - save the catalogue to track 161 (usually
unused).
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.
E (rEstore catalog) - write the catalogue saved before from
track 161 to track 0. If there is no TR-DOS catalogue there, QC
flashes the border red 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 failure found
is tried to be repaired. The usual "squares" in the corner of
the screen show how far it has got.
R (Restore disk) - restore the disk: 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.
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 the Care menu and start the operation.
The key A stops Check disk, Restore disk and Format disk after
the current track.
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. 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).
The colours of the info line and of the text by default can
be changed in the commander's setup.
The viewer does not work on 48K! A text can also have 5460
lines at most (an average text of 65535 bytes has 1000-2000
lines).
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.
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.
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, the resident, the colours) are kept in the file
"QC 3.20" 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.20: it is on
the kit's disk (the file "QS 3.20") and runs from QC or with RUN
"QS 3.20" in TR-DOS. Quick Setup finds the files of QC 3.05-3.20
on a drive and shows their settings: the mode at the start, the
drives and their speed, the full catalogue, the tunes, the mouse
(Kempston's buttons or swapped; 3.20's only), the load
(3.05-3.11's only), the resident, the CMOS, the catalogue's
copy, the colours of the file types and of QC itself. The
cursor: Q A O P (6 7 8 9, the cursor keys); Enter and Space
change a value (a colour's ink and paper), B and F a colour's
bright and flash; 1-4 choose the drive, N the disk's next QC
file. S saves the settings in the file, D puts the release's
values (not saved yet), R reads them from the file again, ? and
H the help, Edit goes back to QC (through its resident) or to
TR-DOS. The mouse works too.
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).
░ ░▓▄▄▄▄▄
▄ ▓ ▓▀ ▀▀▀▓▄▄▄▄▄ ▀▓█▄ ▀▀▀████▓▄▄▄▄ ▓
██▓██▄▄▄ ▓░ ░ ▀▀▀▀▒▀█▓▄ ▀▀▀▀██▓██▄▄▄ ▓░
░▀▀▀▓███▓▄█▒ ░ ▒ ▀░ ░▀▀▀▓███▓▄█▒
░ ▀▀█ ░ ░ ░ ▀▀█ ░