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


                     Quick Commander v3.23
                   Описание для пользователя


    Quick  Commander  (далее  QC)  использует  прямой  доступ  к
контроллеру  дисковода  КР1818ВГ93,  поэтому не будет работать с
винчестером.  Нужна  TR-DOS  5.03 или новее: с TR-DOS 5.01 QC не
работает.  Исключение  -  esxDOS  на  DivMMC:  там QC работает с
образами  TRD  на  SD-карте  через  ее эмуляцию TR-DOS (смотрите
раздел "QC под esxDOS").


    :: Запуск коммандера

    QC  поставляется  на образе диска QC_3_23.TRD. Первым на нем
лежит  файл  boot,  копия  файла  QC, поэтому QC запускается как
любой  диск  TR-DOS:  командой  RUN  в  TR-DOS,  из  меню ПЗУ, в
эмуляторе  - автозагрузкой образа, а под esxDOS - клавишей Enter
на  образе  в  браузере  (смотрите "QC под esxDOS"). Образ можно
записать  и  на  обычную  дискету. Quick Setup (на том же диске)
записывает QC как boot.B на любой диск с выбранными настройками.
    Под  esxDOS  QC  можно  сделать  и  загрузчиком по умолчанию
вместо  TR-DOS Navigator, файлом TRDBOOT.BIN из комплекта: тогда
QC  запускается  на  любом  образе  без  своего  boot.  Как  это
настроить, рассказано в разделе "QC под esxDOS".
    QC поддерживает расширенную память Pentagon 512, 1024 и 4096
(порт  #AFF7),  Scorpion 256 и 1024, KAY 1024, Profi 1024, АТМ1,
АТМ  Turbo  2+  и  ZX-Evolution  (Scorpion GMX и Pentagon-4096 с
GitHub  -  нет). Под буфер QC берет до 1024Кб, как и раньше (для
копирования  целого  диска  хватает  640Кб),  а в окошке режимов
показывает  машину  и  всю  найденную  память  (у ZX-Evolution -
4096Кб,  у  Pentagon  4096  -  2048Кб).  На  Scorpion  QC сам не
использует  8-ю  страницу  (с теневым монитором), а в сетапе 8-ю
страницу  можно  запретить  и  на остальных машинах. Также можно
настроить,  чтобы  при  памяти  больше  128Кб  QC не использовал
страницу, в которой находится резидент QC (#D7: 7-я на Scorpion,
Profi,  АТМ и ZX-Evolution, 31-я на Pentagon 512/1024/4096, 23-я
на KAY 1024).
    Если  у вас больше 128Кб памяти и вы по каким-то причинам не
хотите  чтобы  QC  использовал  ее, удерживайте во время запуска
кнопку W (Without). QC запустится в режиме 128Кб.
    Если  у вас имеется 1Мб памяти по стандарту Pentagon, то для
того,  чтобы  QC  ее  определял, удерживайте Caps shift во время
запуска  коммандера,  иначе  будет  проверяться только 512Кб. На
других  машинах  Caps  shift  во  время  запуска  не держите: на
обычном  128Кб  компьютере и на ZX-Evolution с прошивкой TS-Conf
память заблокируется до сброса.
    Если  у  вас  установлено  теневое ОЗУ (Shadow RAM) размером
16Кб  или  32Кб, то вы можете загрузить в него QC и после этого,
простым   нажатием   кнопки   Magic,   мгновенно  запускать  его
практически  из  любой программы. Для загрузки QC в теневое ОЗУ,
держите  кнопку  I  (Install)  во  время  запуска QC. В ответ QC
моргнет   border'ом  зеленого  цвета.  После  этого,  вы  можете
запускать QC кнопкой Magic.
    Также  существует  возможность прошить QC вместо Basic 128 в
ПЗУ,  тогда  при нажатии на кнопку Reset будет сразу запускаться
QC. Для этого в комплекте прилагается файл QC_3_23.rom.
    QC  сохраняет  некоторые  свои настройки в память CMOS часов
(Gluk  или  SMUC).  Используются  байты  #10,  #15,  #16.  В них
сохраняется:  исходящий  и  входящий  дисководы,  текущее  меню,
позиция  курсора,  режим  вывода  всего  каталога,  зацикливание
мелодий.  При  запуске  QC  из  ПЗУ или Shadow RAM эти настройки
восстанавливаются. В сетапе работу с часами CMOS можно отключить
или  оставить только показ часов (тогда настройки не сохраняются
и  не  восстанавливаются),  там же выбирается тип часов. Есть ли
часы,  QC проверяет при запуске: целый кадр читает их регистр и,
если тот меняется или равен #FF, работает без CMOS. Так на сером
128  или  +2,  где  порты часов дают мусор (байты экрана), QC не
показывает время ??:??:?? и не берет из мусора настройки.


    :: QC под esxDOS

    esxDOS  на  DivMMC  подключает  образы  TRD  с  SD-карты как
дисководы   A-D   и   сама  выполняет  вызовы  TR-DOS,  которыми
пользуется  QC.  QC запускается с такого образа как обычно и сам
узнает  esxDOS:  в окошке режимов под машиной написано "esxDOS".
Копирование,  перемещение,  удаление,  переименование,  склейка,
распаковка, просмотр, имя диска и запуск программ работают как с
дискетой.  Проверено в эмуляторах с esxDOS 0.8.9 на Spectrum 48,
128,  +2A,  +3  и  Pentagon 128 (QC узнает esxDOS 0.8.5 и новее;
ZX-Uno   и   Next  в  режиме  esxDOS,  где  она  тоже  есть,  не
проверялись).
    T  выходит  из  QC  в  TR-DOS  самой esxDOS, как при запуске
программы: заставка и A>, как после сброса, а RETURN там ведет в
Бейсик  48. Дисковод без образа сразу дает "No Disk.". Часы SMUC
под  esxDOS  не  работают  (их  порты  отвечают  только  при ПЗУ
TR-DOS), и QC их выключает. Память Scorpion и KAY сверх 128Кб QC
там тоже не ищет (их порт #1FFD на +2A и +3 выбирает ПЗУ).
    esxDOS  0.8.9  открывает  и  образы  SCL,  но  писать на них
нельзя,   а   более  старые  версии  их  не  знают.  Поэтому  QC
поставляется  в  образе  TRD. Защиты от записи у образов TRD под
esxDOS нет. За конец образа, обрезанного после последнего файла,
esxDOS  не  пишет,  и  QC  тогда  выдает "Error." (Retry, Abort,
Ignore).
    QC  как  загрузчик  по  умолчанию (TRDBOOT). Если на образе,
который  запускается клавишей Enter в браузере esxDOS, нет файла
boot, эмуляция TR-DOS запускает файл /SYS/TRDBOOT.BIN с SD-карты
(в  комплекте  esxDOS это TR-DOS Navigator). В комплекте QC есть
свой TRDBOOT.BIN: с ним Enter на любом таком образе запускает QC
с  этим  образом в дисководе A, как boot на обычном диске. Образ
со  своим  boot  по-прежнему  запускает  свой  boot. Проверено с
esxDOS 0.8.9.
    Ставит его Quick Setup: запустите его с образа комплекта (из
QC  или командой RUN), выберите 4 (Save QC as TRDBOOT.BIN on the
SD card), настройте и нажмите S. Quick Setup запишет свой QC как
/SYS/TRDBOOT.BIN,   а   другой   загрузчик,   который   там  был
(Navigator),   сохранит  как  TRDBOOT.NAV  (чтобы  вернуть  его,
верните  ему  прежнее  имя; если TRDBOOT.NAV там уже есть, Quick
Setup  ничего  не ставит и сообщает об этом). Потом тот же пункт
показывает  настройки  стоящего там QC, а S записывает с ними QC
из  Quick  Setup  (его  версию).  В /SYS/CONFIG/TRDOS.CFG должно
стоять   AlwaysBoot=1  (так  по  умолчанию).  Можно  и  вручную:
переименовать   /SYS/TRDBOOT.BIN   и  скопировать  в  /SYS  файл
TRDBOOT.BIN из комплекта.


    :: Запуск файлов

    В  главном  меню  на экране отображаются только basic-файлы.
Чтобы  их запустить достаточно нажать Enter (или 0) или кликнуть
левой  кнопкой  мыши.  В файловом меню файлы запускаются кнопкой
Enter.  Если QC стартует в главном меню или там выбран дисковод,
а  basic-файлов на диске нет, он сразу переходит в файловое меню
(пробел, как обычно, возвращает в главное).
    Для   быстрого   запуска   файлов   в   главном  меню  можно
использовать  горячие  кнопки  A..V  (напечатаны  слева  от имен
файлов  первой  колонки),  а  Caps  shift + A..V запускают файлы
второй колонки. Некоторые горячие кнопки совпадают с кнопками QC
(A, C, F, H, I, K, N, O, P, Q, R, S, T): такие файлы запускаются
с Caps shift, если в той же строке второй колонки нет файла (так
всегда, когда файлов не больше 22), иначе - кнопкой Enter.
    Если курсор стоит на basic-файле (расширение ".B"), он будет
немедленно запущен. Файл кода (".C") загружается с адреса старта
из каталога и с него же запускается (так готовилось для QC 4.00;
до 3.20 адреса загрузки и старта спрашивались). Но сначала Enter
выбирает  для  него  вьювер,  как  Enter в режиме View (смотрите
ПРИМЕЧАНИЕ  к  View  и  muZ  ниже):  картинка или шрифт по длине
показываются, найденная в нем музыка играет, текст показывается;
иначе  появляется  вопрос "Run имя.C? Y: yes": Y запускает файл,
другая  кнопка  возвращает  к  панелям. Файлы других типов Enter
показывает  или  играет,  как  Enter в режиме View. При запуске:
экран  и  память  очищаются,  стек  устанавливается равным #5FE8
(если  код  при загрузке доходит до стека - под кодом, как после
CLEAR), включается нулевая страница памяти.
    При  запуске  файлов,  в  резиденте запоминается исходящий и
входящий  дисководы, текущее меню, позиция курсора, режим вывода
всего  каталога, зацикливание мелодий, а при возврате в QC (если
программа это поддерживает), они восстанавливаются.
    Запуск  производится  без  помощи  basic-процедур, благодаря
чему  можно  запускать  удаленные  файлы  и  файлы с одинаковыми
именами.


    :: Управление

    Перемещение  курсора осуществляется кнопками Q, A, O, P и 6,
7,  8,  9,  а  также  курсорными клавишами. Нажатие Enter (и 0 в
главном  меню)  приведет к запуску файла на котором стоит курсор
(или  к  его просмотру, смотрите выше). Пробел переключает между
файловым и главным меню, как и клик левой кнопкой мыши по строке
"Quick Commander" над меню или по надписи space в главном меню.

    Снизу  экрана  находится  строка  меню с операциями текущего
режима.   "Горячие   кнопки"  вызова  этих  операций  напечатаны
прописными  (большими)  буквами.  Например,  для вызова операции
копирования  (Copy) нужно нажать кнопку С. По пунктам меню можно
"кликать"  мышкой.  Остальные кнопки режима показывает подсказка
(Help, смотрите ниже).

    В главном и файловом меню работают следующие горячие кнопки:

    ?  (Symbol  shift  +  C)  или  H  (Help) - подсказка: вместо
панелей  в  рамке  показываются  кнопки  текущего меню (слева) и
общие  кнопки обоих меню (справа) и что они делают. Любая другая
кнопка  закрывает  подсказку  и  выполняет свою команду, а ? и H
просто закрывают подсказку. По строке меню можно кликать мышкой,
как обычно.

    1,  2,  3,  4  -  выбор  рабочего  дисковода  (A,  B,  C,  D
соответственно)  и  чтение  его  каталога. В правом верхнем углу
экрана  находятся  кнопки  дисководов:  в  верхнем  ряду рабочий
дисковод,  в  нижнем  - дисковод, на который копируют; выбранный
дисковод   нарисован   ярко.  Цвет  кнопки  показывает  скорость
дисковода  (смотрите  ниже,  "Файловое  меню"). По кнопкам можно
кликать мышкой.

    Symbol  shift  +  1, 2, 3, 4 - выбор A, B, C, D дисковода на
который будет производиться копирование.

    5 (5-reread) - перечитать каталог диска.

    Home (SS+Q) - переместить курсор в начало каталога.

    End (SS+E) - переместить курсор в конец каталога.

    I  (Info)  -  переключение единиц: свободное место на диске,
объем  буфера и размер отмеченных файлов показываются в секторах
или   в   килобайтах   (память  в  окошке  режимов  -  всегда  в
килобайтах).

    Если  у  вас  есть  3-я  кнопка  на  мышке,  тогда  можно ее
использовать для перечитывания каталога диска.

    Кнопки  мыши  QC  читает как у Kempston-мыши: правая - бит 0
порта   #FADF.   У  ZX-Evolution  там  левая  кнопка,  и  кнопки
получаются  переставленными:  верните  их на место в Quick Setup
(Mouse:  swapped). Есть ли мышь, QC проверяет при запуске: целый
кадр  читает  её  кнопки  и,  если какая-то нажата, работает без
мыши. Так QC сам видит, что мыши нет, и на сером 128 или +2, где
её порты дают мусор (байты экрана).


    :: Главное меню

    Горячие кнопки используемые в главном меню:

    N  (diskName)  -  переименование диска. Задаются 11 символов
имени  диска.  В этом режиме: кнопки "влево", "вправо" - двигать
курсор,  Delete  -  стирание  символа,  Edit mode - переключение
русские/английские    буквы,    Caps    Lock    -   переключение
большие/маленькие  буквы,  Home  (SS+Q)  -  курсор в начало, End
(SS+E)  - курсор в конец. Русский режим ввода букв реализован по
раскладке  ЯВЕРТЫ: буквы ч, э, ш, щ, ъ, ю вызываются кнопками a,
s,  f,  g,  d,  x  с  нажатым Symbol shift. Extend mode и правая
кнопка  мыши  -  выйти  из  режима переименования, Enter и левая
кнопка мыши - сохранить новое имя диска.

    R  (Run_in_48k)  -  запустить файл на котором стоит курсор в
режиме  48Кб. При запуске устанавливается 5-ый бит #7FFD, в порт
расширения памяти (если он есть) записывается 0.

    T  (Tr-dos)  -  быстрый  выход  в  TR-DOS из коммандера (под
esxDOS - в TR-DOS самой esxDOS, смотрите "QC под esxDOS").


    :: Файловое меню

    Надпись  "Buffer:nnnn"  (в  обоих  меню)  -  объем  памяти в
секторах  (после  I  - в килобайтах), которая будет использована
при операциях Copy и Move.

    В  отличии  от  предыдущего режима где все файлы были одного
цвета,  при входе в режим работы с файлами, все файлы выделяются
различными цветами, в зависимости от своего типа. Различаются 24
группы файлов. Все цвета можно самостоятельно настроить в сетапе
коммандера.

    В  сетапе  можно  настроить  скорость  чтения  и  записи для
каждого  дисковода.  Выбранная  скорость  видна  по цвету кнопок
дисководов  (в  правом  верхнем  углу; в верхнем ряду - скорость
чтения,  в нижнем - записи): для медленной скорости они зеленые,
для быстрой желтые.

    Перед  выполнением  операций связанных с изменением каталога
диска  (copy,  move,  delete,  rename,  merge,  unpack,  а также
переименование   диска)   происходит  сравнение  каталога  диска
вставленного   в  дисковод  и  каталога  находящегося  в  памяти
коммандера.  Если  они отличаются, операция будет отменена, а вы
увидите  на  экране надпись Bad disk. После нажатия любой кнопки
каталог диска будет автоматически перечитан.

    В   окошке   с  индикацией  режимов  отображается  следующая
информация:

    "pen 1024k" - машина и вся ее память: zx - 48Кб или 128Кб (и
при запуске с W), pen - Pentagon, evo - ZX-Evolution, atm - АТМ,
k/s  -  KAY  или Scorpion, pro - Profi. Строка набрана строчными
буквами: горячих кнопок в ней нет.
    "res"  -  в памяти (странице #D7) находится резидент QC. Его
может  затереть  запущенная  программа,  а  на 128Кб (или если в
сетапе не задано беречь его страницу) - и операции Copy и Move.
    "Full"  -  показывает,  что  включен  режим  просмотра  ВСЕХ
128-и  файлов  каталога.  Это  может  быть  полезно для работы с
удаленными  файлами.  Режим  Full включается/выключается горячей
кнопкой F.
    "esxDOS"  -  QC  работает  под  эмуляцией  TR-DOS  в  esxDOS
(DivMMC), смотрите "QC под esxDOS".

    Остальные горячие кнопки:

    Graph  (CS+9)  и  0 - отметить файл под курсором или снять с
него  отметку,  после  чего  курсор переходит на следующий файл.
Удаленные файлы не отмечаются.

    True video (CS+3) - перейти к предыдущей странице с файлами.

    Inv video (CS+4) - перейти к следующей странице с файлами.

    C   (Copy)  -  копирование  файлов  на  дисковод,  выбранный
кнопками  Symbol shift + 1..4. Если нет отмеченных файлов, будет
скопирован файл, на котором стоит курсор. Копирование происходит
с  учетом  последовательности,  в которой файлы были отмечены. В
процессе    копирования,   в   правом   нижнем   углу   рисуются
"квадратики", отображая степень выполнения операции. Верхний ряд
"квадратиков"  показывает процесс чтения, нижний процесс записи.
Если  дисковод  для копирования совпадает с рабочим, QC попросит
менять  диски  (Insert  OUTPUT,  Insert INPUT). Если на диске не
хватает места (No Space) или места в каталоге (Cat Over), кнопка
A  отменяет копирование, а любая другая перечитывает диск. После
копирования  на  другой  дисковод QC показывает диск, на который
копировали.

    M  (Move)  -  уплотнить  диск. Работает только если на диске
есть удаленные файлы. В процессе уплотнения в правом нижнем углу
рисуются  "квадратики",  отображая  степень  выполнения. Если на
диске   есть   отмаркированные  файлы,  тогда  уплотнение  будет
производится  ТОЛЬКО  среди  тех файлов, которые находятся после
первого отмаркированного файла в каталоге. Удаленные файлы после
уплотнения   не  восстановить,  поэтому  QC  сначала  спрашивает
"Move: deleted files lost for good? Y: yes",  и  уплотняет  диск
только кнопка Y.

    D  (Delete)  или  E  (Erase)  -  удаление  файлов.  Если нет
отмеченных  файлов,  будет удален файл, на котором стоит курсор.
Сначала  QC  спрашивает: "Delete <имя>? Y: yes" для одного файла
или "Delete N files? Y: yes"; удаляет только Y.

    R  (Rename)  - переименование файла на котором стоит курсор.
Работает  аналогично  переименованию  диска  из главного меню, а
Graph  переводит курсор между именем и расширением. Стрелки вниз
и   вверх   записывают   имя,   как   Enter,  и  сразу  начинают
переименование   следующего   или   предыдущего  файла.  Если  в
удаленном  файле  вместо  первого  символа (клетчатого значка ▒)
ввести какой-нибудь символ, то этот файл восстановится. Обратите
внимание,  что имена файлов можно написать русскими буквами. При
этом QC будет с ними работать так же как и с остальными файлами,
но TR-DOS с такими файлами работать не сможет.

    G  (merGe)  -  "склеить"  отмеченные файлы в один, в порядке
каталога:  имя,  тип, старт и длина в байтах остаются от первого
файла.  Между  файлами не должно быть удаленных или неотмеченных
файлов,  иначе  ничего  не  произойдет. Если отмечено больше 255
секторов,  то  получится  несколько  файлов  (по  255 секторов и
остаток)  в  записях  первых  отмеченных  файлов, с их именами и
расширениями.

    V  (View) - если курсор стоит на @-файле (длина 192 сектора)
или  на  экранном файле (длина 6144 или 6912 байт, а также 11136
байт - экран с бордюром, .bsc: бордюр показывается одним цветом,
самым  частым  в  его рисунке), то вы попадете в режим просмотра
картинок.  В  этом  режиме  Space,  A  или  левая  кнопка мыши -
изменение  цветов  картинки,  Enter - переход к следующему файлу
(см.ниже),  остальные кнопки и Break - возврат в коммандер. Если
файл  относится  к  шрифтам  (длина 768 или 2048 байт), то будет
запущен   режим  просмотра  шрифтов  (Enter  -  следующий  файл,
остальные  кнопки - возврат). Если же файл, на котором находится
курсор   не  подходит  под  признаки  картинки  или  шрифта,  то
запустится текстовый вьювер. Его описание смотрите ниже. Если же
вы  хотите  принудительно запустить текстовый вьювер, независимо
от    принадлежности   файла,   используйте   комбинацию   CS+V.
Поддерживается просмотр картинок, шрифтов и текстов, упакованных
Hrust   v2.x  и  ZX0:  данные  до  64Кб  (у  Hrust  -  до  56Кб)
распаковываются прямо в страницы памяти, в 48Кб режиме - до 16Кб
(у Hrust - до 14Кб).

    Z  (muZ)  -  поиск  в  указанном файле музыки в форматах Pro
Tracker  v3.x (по сигнатурам "ProTracker" и "Vortex Tracker", во
всём  файле)  и Pro Tracker v2.x (у таких модулей сигнатуры нет,
они находятся по устройству заголовка в первых 3Кб файла: модуль
без плэйера или после плэйера Pro Tracker 2). Мелодия может быть
компилированной или нет, с плэйером или без него. При нахождении
в  указанном файле музыки, она сразу начнет проигрываться. Поиск
возможен в файлах длиной до 255 секторов (в 48Кб режиме - только
в  первых  16Кб  файла). При проигрывании мелодии, в нижних двух
строках  пишется  информация  о формате модуля (PT3.x, VT II или
PT2),  названии мелодии и ее авторе (у Pro Tracker v2.x - только
название),  в правом нижнем углу отображаются индикаторы музыки,
а под часами - надписи Fast (ускорение) и Loop (зацикливание), в
паузе  -  Pause. Во время проигрывания музыки можно использовать
следующие кнопки:

    B (Begin) - начать проигрывание мелодии сначала.
    F (Fastplay) - трехкратное ускорение проигрывания мелодии.
    L  (Loop)  - включение/отключение зацикливания мелодий. Если
      надпись  Loop  не  горит,  то при завершении мелодии будет
      осуществлен  автоматический  переход  к следующему файлу в
      каталоге  (или к следующему маркированному, если они есть,
      смотрите ниже про Enter).
    P (Pause) - включить/выключить паузу.
    Enter - переход к следующему файлу (см.ниже).
    Все остальные кнопки - возврат в коммандер.

    Плэйер  -  PTxPlay  Сергея  Булбы. Во время инициализации он
определяет  номер версии модуля и генерирует необходимые таблицы
громкости  и  нот.  Также во время проигрывания работает один из
двух  алгоритмов  портаменто  (старый  для  версии 3.5 и ниже, и
новый для 3.6+ и Vortex Tracker II), а команды 1 и 2 с задержкой
0  в  модулях  версии  3.7 и новее - по правилу Pro Tracker 3.7.
Звук  в  точности  соответствует  звучанию  в  редакторе. Модули
длиннее  16Кб  не  проигрываются,  а  в  файлах длиннее 16Кб - и
модули,  пересекающие границу 16-килобайтных частей файла (кроме
начинающихся в последних 6912 байтах части).

    Поддерживается проигрывание музыки, упакованной Hrust v2.x и
ZX0:  файл  распаковывается  так  же, как при просмотре в режиме
View.

    ПРИМЕЧАНИЕ:  при нажатии на Enter в режимах View и muZ, если
на  диске  есть отмаркированные файлы, то курсор переместится на
следующий из них (в порядке маркировки, после последнего - снова
на   первый),   если   маркированных   файлов   нет,  то  курсор
переместится  на  следующий  в каталоге файл (после последнего -
возврат  в  коммандер). Затем файл показывается как картинка или
шрифт  (по  длине),  иначе  в  нем  ищется  музыка.  Если ничего
подобного    не    найдено,    запускается    текстовый   вьювер
(просмоторщик) для просмотра этого файла.

    U  (Unpack)  - распаковка файлов, упакованных Hrust v2.x или
ZX0  (Einar Saukas). На запрос "Unpack file:" необходимо указать
имя   выходного  файла  (предлагается  имя  упакованного).  Если
процесс  ввода  имени  прервать,  распаковка  файла  отменяется.
Упакованный  файл может быть любой длины, распакованные данные -
до 65280 байт (255 секторов: длиннее файла у TR-DOS не бывает; у
Hrust  -  до  56Кб); в 48Кб режиме и файл, и данные - до 16Кб (у
Hrust  данные - до 14Кб). Поток ZX0 узнается сам, у любого файла
(у  ZX0  нет заголовка). Стандарт QC для таких файлов: .zx0 (тип
z,  "x0"  в поле старта) и .z_<тип> (тип z, "_" и исходный тип),
как .p_<тип> у Hrust: U возвращает распакованному файлу исходный
тип  (остальные получают тип C), а в панели такой файл раскрашен
цветом исходного типа. В случае ошибок QC до любой кнопки пишет,
в  чем дело: "Not packed." (файл не упакован), "Too long." (файл
или   распакованное   не   помещается),   "No Space. Free: N"  и
"Cat Over. Free: 0"  (нет места на диске или в каталоге, как при
копировании).

    Если  дважды кликнуть левой кнопкой мышки по названию файла,
в  файле будет произведен поиск музыки, картинок и шрифтов. Если
ничего   подобного  не  найдено,  запускается  текстовый  вьювер
(просмоторщик) для просмотра этого файла.

    Правая  кнопка  мышки,  нажатая  и  проведенная  по  файлам,
отмечает их (или снимает отметку, если первый файл был отмечен).
Клик  по  верхней  или  нижней  половине  правой  панели листает
страницы  файлов  назад  или  вперед,  клик  по полосе прокрутки
переводит курсор к соответствующему файлу.

    +  или  L  -  отметить  все файлы (с уже отмеченных снимется
маркировка).

    CS+L  -  маркировать  файлы  по  маске.  В  ответ на запрос,
необходимо  задать  маску  для файлов. В этой маске пустые места
показаны  клетчатым  значком  ▒, который обозначает любой символ
(Delete возвращает его на место). После нажатия Enter, все файлы
подходящие под маску, будут отмечены (с отмеченных маркировка не
снимается).

    - или X - снять маркировку со всех отмеченных файлов.

    CS+X  -  снять  маркировку  с  файлов  по  маске. В ответ на
запрос,  необходимо задать маску для файлов, как для CS+L. После
нажатия  Enter, со всех файлов подходящих под маску, будет снята
маркировка (если она была).

    CS+R  -  переименование  файлов  по маске. Если на диске нет
маркированных  файлов,  предлагается сначала отмаркировать файлы
по  маске.  После  чего  надо  ввести  маску  по  которой  будет
происходить  переименование  файлов:  введенные символы заменяют
символы  имен,  а  места  с  клетчатым  значком оставляют их без
изменений.


    :: Текстовый вьювер

    Текстовый  вьювер  обеспечивает просмотр любых файлов длиной
до  255  секторов,  в кодировке DOS (cp866) или UTF-8 и с любыми
разделителями  строк  (#0D,  #0D0A,  #0A). Файл, занимающий ноль
секторов, не загружается.
    Кодировка  текста определяется автоматически: UTF-8 узнается
по    правильным    многобайтовым    последовательностям.   Если
определение  ошиблось,  кодировку  можно  переключить  кнопкой C
(Convert, подробнее смотрите ниже).
    Поддерживается  раскраска текста по стандарту ACEdit. Кнопка
M  (Mode) переключает по кругу: раскраска, коды цветов видны как
знаки  (текст  одним  цветом),  коды  цветов скрыты (текст одним
цветом).
    Цвет  информационной  панели  и цвет по умолчанию для текста
можно изменить в сетапе коммандера.
    На  48Кб  вьювер  показывает  первые 12Кб текста и не больше
1365  строк.  На  128Кб  и  больше строк в тексте не больше 5460
(среднестатистический текст длиной 65535 байт содержит 1000-2000
строк).

    Управление во вьювере:

Вверх по строкам текста:              9, Q, up
Вниз по строкам текста:               8, A, down
Вверх по страницам текста:            True video, left
Вниз по страницам текста:             Inv. video, Space, right
Перейти в начало текста:              Home (SS+Q)
Перейти в конец текста:               End (SS+E)
Переход к следующему файлу (см.выше): Enter
Режим переноса строк (по кругу):      W (Wrap)
Конвертировать текст:                 C (Convert)
Режим цветов (по кругу):              M (Mode)
Включить/выключить звук кнопок:       S (Sound)
Вернуться в QC:                       Edit mode, Break или
                                      правая кнопка мыши

    Кнопка S (Sound) включает и выключает звук нажатия кнопок не
только во вьювере, а во всем коммандере.

    При   перемещении   по   тексту,   в  информационной  строке
печатается текущая позиция в процентах от всего текста.

    Конвертер  текста  (Convert,  горячая клавиша C) переключает
кодировку: DOS (cp866) или UTF-8. При нажатии C файл загружается
заново  и  показывается в другой кодировке. Текст в UTF-8 вьювер
переводит  в  cp866: русские буквы, псевдографика и знаки шрифта
вьювера  показываются  как есть, кавычки и тире - знаками " ' -,
многоточие  -  тремя  точками,  украинские и белорусские буквы -
похожими  русскими  и  латинскими, остальные символы - знаком ?.
Используемая  в  данный  момент  кодировка текста отображается в
информационной строке (DOS или UTF).

    Доступны  2 разных режима переноса строк выступающих за края
экрана:  простой  и  "умный", когда находится символ-разделитель
(" ",  "!",  "?",  "-",  ":",  ";", ".", ",", "/", "\") и строка
переносится  после  него.  Переключение  режимов  осуществляется
кнопкой  W (Wrap). При этом в информационной строке можно видеть
текущий  режим:  <=>  означает  отсутствие  переноса  строк, >=<
означает что часть строки выступающая за край экрана переносится
на   следующую   строку,   >W<   означает   что   перенос  строк
осуществляется по символу разделителю.

    При управлении мышкой во вьювере можно нажимать по элементам
информационной  строки:  имя файла - переход к следующему файлу,
DOS  (UTF)  -  переключение  кодировки  текста, <=> (>=<, >W<) -
переключение режимов переноса строк.

    Экран с текстом условно разделен на 4 части:

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

    Нажатие  курсором  на  1-ом  поле  приведет к перемещению по
страницам вверх. На 2-ом поле - к перемещению по страницам вниз.
На  3-ем  поле - к перемещению вверх построчно. На 4-ом поле - к
перемещению вниз построчно.


    :: Спрайтовый вьювер

    Вызывается  нажатием  сочетания  кнопок  symbol  shift  + V.
Внешний вид в целом совпадает с текстовым вьювером.

    Управление в спрайтовом вьювере:

Вверх на 8 линий:                     Q, up
Вниз на 8 линий:                      A, down
Вверх на 1 линию:                     9
Вниз на 1 линию:                      8
Вверх на 1 байт:                      6
Вниз на 1 байт:                       7
Уменьшение ширины спрайта:            O, left
Увеличение ширины спрайта:            P, right
Перейти в начало спрайта:             Home (SS+Q)
Перейти в конец спрайта:              End (SS+E)
Переход к следующему файлу:           Enter
Включить/выключить звук кнопок:       S (Sound)
Вернуться в QC:                       Edit mode, Break или
                                      правая кнопка мыши

    По   Enter   следующий  файл  показывается  по  своему  типу
(картинкой,   музыкой   или   текстом),   а   не   спрайтом.   В
информационной строке вместо процентов печатается адрес в файле.
Мышкой: поле 1 (смотрите текстовый вьювер) - сделать спрайт уже,
поле  2  -  шире, поле 3 - на 8 линий вверх, поле 4 - на 8 линий
вниз, имя файла - следующий файл.


    :: Настройка коммандера

    Настройки  QC по умолчанию (дисководы и их скорость, режимы,
часы  CMOS,  резидент, цвета) хранятся в самом файле "QC 3.23" и
меняются  любым  дисковым доктором. Где они лежат и что означает
каждый бит, а также как программе вернуться в QC через резидент,
описано в тексте для разработчиков (tech_ru.txt).

    Удобнее  менять их программой Quick Setup 3.23: она лежит на
диске  комплекта  (файл  "QS 3.23")  и  запускается  из  QC  или
командой  RUN  "QS 3.23" из TR-DOS. QC лежит в самом файле Quick
Setup  (поэтому  он  длиннее):  Quick  Setup  настраивает  QC  и
записывает  его,  куда выберете, или запускает, а еще в нем есть
инструменты  для дисков. Его меню: Q и A (9, 8, стрелки) двигают
курсор,  Enter  или цифра пункта выбирают пункт, строка под меню
говорит,  что делает пункт под курсором; ? и H - подсказка, Edit
- выход в QC через его резидент, иначе в TR-DOS. Пункт, которого
нет  (нет  esxDOS, нет Shadow RAM...), - серый, и строка говорит
почему.
    1   -   Start   QC:   QC  с  показанными  настройками  сразу
запускается, как с диска.
    2  -  Save  QC  as  boot.B  on a disk: спрашивается дисковод
(A-D).  Файл  QC  встает на место первого boot.B диска, если тот
такой  же  длины  или последний файл на диске; от более длинного
остаток  секторов  остается  удаленным файлом после нового (M их
возвращает); более короткий удаляется, а новый пишется в конец.
    3  - Save QC as a ROM image (16K для прошивки в ПЗУ): файлом
qc_rom.C на диск в дисководе, который спрашивается, под esxDOS -
файлом QC.ROM в текущую папку SD-карты.
    4  -  Save  QC  as  TRDBOOT.BIN  on the SD card (под esxDOS,
смотрите "QC под esxDOS").
    5  -  Save  QC  in the Shadow RAM (кэш Pentagon), как кладет
туда  QC его загрузчик с нажатой I: потом QC запускается кнопкой
Magic.
    6  -  Format,  check  or restore a disk: Disk Doctor (с Beta
Disk; под esxDOS его нет), смотрите ниже.
    7  -  Mount  a  disk  image  from  the SD card (под esxDOS),
смотрите ниже.

    Пункты  1-5  сначала  показывают настройки QC: того, что уже
стоит  там,  куда пишем (QC 3.20 и новее: резидент для 1, boot.B
для  2,  TRDBOOT.BIN  для  4,  из  Shadow  RAM  для  5), иначе -
последние  использованные;  верхняя  строка говорит, откуда они.
Настройки:  режим  при  старте,  дисководы и их скорость, полный
каталог, мелодии, мышь (кнопки как у Kempston или переставлены),
резидент, CMOS, цвета типов файлов и самого QC. Курсор - Q A O P
(6  7  8  9, стрелки), Enter и пробел меняют значение (у цвета -
ink  и  paper),  B и F - bright и flash цвета. S (зеленая кнопка
внизу) выполняет пункт: запускает QC или записывает его туда (на
диске  -  с проверкой: "Not saved", если не записалось), и Quick
Setup  возвращается в меню с результатом; ошибка показывается на
месте.  K  хранит  настройки  в  самом  файле  Quick  Setup: при
следующем  запуске  он их покажет. D ставит значения релиза, R -
те,  с  которыми  экран открылся, ? и H - подсказка, Edit (серая
кнопка)  -  назад  в  меню.  Работает мышь: щелчок по пункту, по
слову клавиши, по кнопке.

    Disk Doctor (6): F форматирует диск в дисководе (80 дорожек,
2   стороны,   каждая   дорожка   читается  обратно;  имя  диска
спрашивается), C проверяет его (каждая дорожка читается; та, что
не  читается,  форматируется  заново,  и ее сектора записываются
обратно,   как   прочитались),  R  восстанавливает  (так  каждую
дорожку: для диска, который читается с трудом). Карта показывает
160  дорожек:  +  -  хорошая,  R  - записана заново, X - плохая.
Пробел  останавливает  работу. И копия каталога, как в меню Care
QC   3.21:  K  сохраняет  каталог  на  дорожку  161  (обычно  не
используется;  дорожка  для  этого  форматируется), S сравнивает
копию с каталогом (одинаковы или какие записи различаются: копии
и  диска  рядом),  E  восстанавливает  каталог  из копии после Y
(копия   пишется   на   дорожку  0,  остальные  сектора  дорожки
сохраняются).  Перед  E  проверьте (S), что копия - этого диска.
1-4 выбирают дисковод, Edit - назад.

    Образы на SD-карте (7, под esxDOS): образы TRD и SCL и папки
текущей папки. A-D вставляют образ под курсором в этот дисковод,
Enter  открывает  папку  или  вставляет  образ  в  дисковод A, E
вынимает  образ  из  дисковода, N создает новый пустой образ TRD
(имя  спрашивается),  R  перечитывает папку. Под списком - что в
каждом дисководе (имя образа, если он вставлен отсюда).

    На 48K Quick Setup держит свой QC в верхних 16K памяти. Disk
Doctor  и образам нужна эта память, поэтому после них пункты 1-5
серые, пока Quick Setup не запустить снова.

    Резидент   нужен   для  быстрого  возврата  в  коммандер  из
программ, поддерживающих выход с запуском QC.

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


                         Благодарности:

      Max Petrov - бут, ставший источником вдохновения QC
          Hrumer, Alone Coder - код распаковщика Hrust
          Sergey Bulba - код плэйера ProTracker 2 и 3
           Ivan Roshin - таблицы нот и громкости PT3
             DarkMax - код scrollbar и анализаторов
             Urusergi, introspec - распаковщик ZX0
                Znahar - код спрайтового вьювера
                 Pawel Kislyak - обмен кодом ;)
                  Einar Saukas - упаковщик ZX0
                   Looker - идея Quick Setup
                     Mentat - дизайн, шрифт
                         Wizard - шрифт


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


                   Дополнительная информация:

    Автор  программы  Андрей  Богданович  aka  Spectre. QC будет
продолжать  развиваться  до  тех  пор  пока  я  получаю про него
отзывы.   Пожелания   по  работе  QC  всегда  приветствуются  по
электронному адресу: spectre@zxby.org.

    Распаковщик  ZX0  в  QC  -  (c)  2021 Einar Saukas (вместе с
Urusergi  и  introspec),  лицензия  BSD  3-Clause;  ее текст - в
описании для разработчиков (tech_ru.txt).


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