Режим модерирования
Документы
НОВОСТИ
OPTICAL BROTHERS
ФАЙЛЫ
АРХИВ САЙТОВ
ССЫЛКИ
О САЙТЕ
ФОРУМЫ
ГОСТЕВАЯ КНИГА
Беларуская моваРусский языкEnglish language

Copyright © 2001-2006 Optical Brothers
qc_4_01.zip · QC_4_01.TRD/tech_ru.tЗакрыть ×
                 ░            ░▓▄▄▄▄▄ 
▄             ▓  ▓▀ ▀▀▀▓▄▄▄▄▄  ▀▓█▄ ▀▀▀████▓▄▄▄▄              ▓ 
██▓██▄▄▄     ▓░        ░    ▀▀▀▀▒▀█▓▄       ▀▀▀▀██▓██▄▄▄     ▓░ 
  ░▀▀▀▓███▓▄█▒                  ░  ▒   ▀░         ░▀▀▀▓███▓▄█▒ 
      ░  ▀▀█ ░                     ░                  ░  ▀▀█ ░ 


                     Quick Commander v4.01 
                   Описание для разработчиков 


    Здесь  -  то, что нужно тем, кто пишет программы, работающие
вместе  с  QC, правит его файлы или проверяет QC на своей машине
или  в  эмуляторе: что QC требует от компьютера и как работает с
его  портами,  раскладка  памяти  и  файлов  QC,  его настройки,
резидент  и  возврат  в  QC, форматы файлов. Как пользоваться QC
(кнопки,   меню,  установка,  Quick  Setup)  -  в  guide_ru.txt,
изменения версий - в hist_ru.txt. Числа - для релизной сборки QC
4.00.


    :: Что нужно QC 

    Процессор Z80 и прерывания IM 1 (QC ставит I = #3F) 50 раз в
секунду:  по  ним  работают  плэйер  и  ожидание кнопок. Пока QC
работает, включено ПЗУ BASIC 48 (бит 4 порта #7FFD всегда 1): QC
вызывает  его процедуры PO_MSG (#0C0A), MAIN_4 (#1303), STMT_RET
(#1B76),  BREAK_KEY (#1F54), CLEAR_1 (#1EB7), OUT_NUM_1 (#1A1B),
а  также  #22B0  и  #30A9.  Кнопки  QC  берет из LAST_K (#5C08),
которую  заполняет  обработчик  прерываний  ПЗУ; нажатия мыши QC
кладет туда же.

    ПЗУ  TR-DOS  -  5.03 и новее: адреса, которые использует QC,
одинаковы  в 5.03, 5.04, 5.04T, 5.04S, 5.5H, 6.07+, 6.10E, 6.11E
и  в  ПЗУ SMUC; в 5.01 они другие. Дисководы - 80 цилиндров, две
стороны:  QC  считает  дорожку  как  цилиндр*2+сторона и пишет в
каталог тип диска #16.


    :: Память 

        #5B00-#5B7F  таблица страниц (по 2 байта на страницу)
        #5B80, #5B90 набираемое имя, маска
        #5B98        код запуска программы
        #5C00-#5D3A  системные переменные
        #5D3B-#5E51  BASIC-загрузчик с настройками
        #5E5A-#5F37  строки зажатых CS и SS панели SD-карты
        #5FE8        стек (растет вниз)
        #6000-#9F63  код QC
        #9F64-#A2FF  окно панелей: заголовки дисков, показанные
                     файлы (по 20 байт) и их отметки
        #A300-#BFFF  оверлей QC и его буферы (при старте - код
                     настройки QC и проверки памяти, один раз)
        #C000-#FFFF  окно страниц: буфер, файл во вьюверах

    Кодовая  страница  -  #D7  (значение порта #7FFD): с #C000 -
загрузчик  и упакованный ZX0 код QC (QC.C), с #FD42 - то, что QC
помнит  для  возврата  из  программы,  с  #FD45 по #FF97 - копия
системных  переменных и BASIC-загрузчика, снятая при загрузке, с
#FFF0  -  метка  "Residentpresent!". Файл .qco лежит в страницах
оверлеев:  первые  16Кб  -  в  #D6,  следующие  16Кб  -  в  #D4,
остальное - в #D3. Номера страниц:

        машина                           #D3  #D4  #D6  #D7
        128Кб, Scorpion, Profi, ATM,
        ZX-Evolution                       3    4    6    7
        Pentagon 512, 1024, 4096          27   28   30   31
        KAY 1024                          19   20   22   23

    Страницы  2  и 5 QC не переключает; остальные, кроме страниц
оверлеев и кодовой, идут под буфер Copy и Move, по 64 сектора на
страницу.   На  128Кб  (и  при  запуске  с  кнопкой  W)  кодовая
страница  -  последняя  страница  буфера  (буфер - 0, 1 и 7, 192
сектора), и резидента нет.
    За  .qco  в  #D3:  с #DE00 - каталог диска, вставленного при
Copy  на  одном дисководе (и новый каталог M), с #E700 - сектор,
куда  QC читает первый и служебный секторы каталога, чтобы перед
записью  проверить  диск;  с  #E800  (активная панель) и с #F400
(другая) - места панелей по 3Кб: каталог (9 секторов), с +#900 -
отметки,  с +#A00 - 9-е и 10-е знаки имен ленты, с +#B00 - папка
SD-карты.
    Сброс,  который  не  трогает  память (Pentagon 512 и больше,
KAY,  Scorpion), страниц оверлеев не стирает; ПЗУ Spectrum 128 и
Pentagon  128  при  сбросе стирают страницы 0-7. На 48Кб страниц
нет:  в  #C000-#E6FF  основной  памяти  - начало .qco, с #E700 -
сектор проверки и место одной панели.


    :: Файл оверлеев .qco 

    Большая  часть  QC - потоки ZX0 в файле .qco: на диске - под
именем  файла  QC,  тип  q,  "co"  в  поле старта, на SD-карте -
/SYS/TRDBOOT.OVR. Заголовок:

        +0      "QCO"
        +3      версия QC, 4 знака: "4.00", у бет "400a"
                (b1), "400b" (b2)...
        +7      штамп сборки (слово)
        +9      число потоков N
        +10     на поток 4 байта: смещение потока в файле
                и сумма Флетчера-16 потока
        +10+4N  смещение конца последнего потока
        +12+4N  на поток байт: номер его библиотеки (#FF -
                нет)
        +12+5N  данные сборки: строки строки 23 панели
                SD-карты, 212 байт

    Дальше  -  потоки  подряд  и  нули до конца сектора. Штамп -
сумма  Флетчера-16  файла  с +9 до конца последнего сектора (обе
суммы  по  модулю  255); QC только сравнивает его со своим. Файл
можно  обрезать  где  угодно,  ничего не пересчитывая: потоки до
обреза целы, остальные QC выключает по суммам (так сделаны набор
ПЗУ  и копия в теневом ОЗУ). Поэтому потоки идут от более важных
к менее важным:

        поток             что                  библиотека
         0 MediaLibrary   общее у носителей         -
         1 TrdosLibrary   общее у 2 и 3             0
         2 TrdosReader    TR-DOS: чтение, P, U      1
         3 TrdosWriter    TR-DOS: команды           1
         4 StreamLibrary  потоки P и U              -
         5 PagesLibrary   файл по страницам         4
         6 Prepare        распаковка, U, музыка     5
         7 Help           подсказка                 -
         8 ViewerLibrary  общее у вьюверов          5
         9 TextLibrary    вьювер текстов            8
        10 Text           UTF-8                     9
        11 Dump           дамп                      9
        12 Picture        картинки                  -
        13 Player         плэйер                    -
        14 Convert        исходники ALASM           5
        15 Packer         упаковка (P)              4
        16 DiskUtils      disk_Utils                0
        17 CardLibrary    общее у 18 и 20           0
        18 CardReader     панель SD-карты          17
        19 Image          образы и лента            0
        20 CardWriter     команды карты            17
        21 Sprite         спрайты                   8

    Оверлей  распаковывается  в  #A300-#BFFF,  перед  ним  - его
библиотеки,  от  корня;  поток  через границу страниц QC сначала
копирует  в  конец этой области. Без потоков 0-2 QC не работает:
сообщение  и  выход в TR-DOS. При запуске QC берет .qco из своих
страниц,  если там целы все потоки его сборки, иначе читает файл
с  диска,  с  которого  запущен,  под esxDOS - с SD-карты, иначе
берет  набор  ПЗУ,  иначе  работает  с тем, что цело. На 48Кб QC
читает  в  #C000  заголовок  и потоки 0-2, под esxDOS еще 17-19;
других оверлеев там нет.


    :: Дисковод: ВГ93 напрямую 

    Порты  Beta  Disk отвечают, только пока включено ПЗУ TR-DOS:
оно  включается,  когда  команда  выбирается  из  #3D00-#3DFF, и
выключается  при выборке из ОЗУ. Поэтому QC пишет и читает порты
контроллера  кусками  кода  самого  ПЗУ:  кладет  на стек адреса
нужных  кусков  и входит в ПЗУ через #3D2F (там NOP; RET), часто
цепочкой из нескольких кусков. Порты: #1F - команда и состояние,
#3F  -  дорожка,  #5F  -  сектор,  #7F - данные, #FF - системный
регистр (при чтении бит 7 - INTRQ, бит 6 - DRQ).

    В  системный регистр QC пишет #2C плюс номер дисковода (биты
0-1): бит 2 = 1 - без сброса, бит 3 = 1 - HLT, бит 5 = 1 - как у
TR-DOS,  бит  6  =  0  -  MFM;  бит  4 = 1 (#3C) выбирает первую
сторону,  четные  дорожки  TR-DOS.  Команды:  #08  -  на нулевой
цилиндр,  #18 - позиционирование (шаг 6 мс, без проверки), #80 и
#A0 - чтение и запись сектора, #C0 - чтение адреса, #F0 - запись
дорожки, #D0 - прерывание команды.

    Адреса ПЗУ TR-DOS, которыми пользуется QC:

        #3D2F - вход в ПЗУ (NOP; RET);
        #3D13 - функция 5, чтение секторов: загрузка QC и
                файла кода перед запуском; #13 при запуске
                (на нее отвечает эмуляция TR-DOS в esxDOS;
                без esxDOS - еще имя и версия DOS с #0358),
                под esxDOS еще 1 (есть ли диск в дисководе)
                и #0D (ничего: по пути из QC, X и SS+R
                панели SD-карты);
        #2A53 - OUT (C),A; RET: регистры ВГ93, порт ATM2;
        #3EF5 - ожидание конца команды;
        #3FE5, #3FCA - чтение (INI) и запись (OUTI) данных;
        #2740 - состояние и позиционирование;
        #2090, #2093, #2099 - чтение и запись сектора;
        #294A, #2920, #2970 - загрузка BASIC-программы;
        #0048 - выход в TR-DOS (кнопка X);
        #3FF0, #3FF3 - OUT и IN для часов SMUC.

    Скорость  (CONFDRV, см. "Настройки в файле QC"): для каждого
дисковода  -  биты  быстрого чтения и записи; в медленном режиме
после  каждого  позиционирования  QC  ждет  еще кадр (EI; HALT).
Первая  запись  после  сброса или выхода на нулевую дорожку ждет
около  0,3  с,  если  QC  не  видел, что диск вращается. После 4
неудачных  попыток  QC  спрашивает Retry / Abort / Ignore; между
попытками   он  читает  адрес  (#C0),  чтобы  поправить  регистр
дорожки, или выходит на нулевой цилиндр.

    Свой  код  QC  загружает  функцией  #3D13,  поэтому грузится
везде,  где  работает  TR-DOS, и с ее RAM-диска; RAM-диск TR-DOS
6.1xE панель QC не видит: он доступен только через #3D13.


    :: esxDOS 

    esxDOS  0.8.5 и новее (проверена 0.8.9) на DivMMC или DivIDE
(ниже  оба  зовутся  DivMMC:  порт #E3 у них общий; у DivIDE ОЗУ
32К,  банки  0-3)  эмулирует  TR-DOS  на образах TRD с SD-карты:
#3D13  и  куски ПЗУ, которые QC зовет через #3D2F, она выполняет
сама (по таблице из 85 адресов; адрес не из таблицы дает красный
бордер и BASIC 48). QC работает с ней, как с Beta Disk.

    QC  (и  Quick  Setup)  узнает  esxDOS так: функция #13 #3D13
копирует  16 байт с #0370 в #5CDD; эмуляция отдает копии четырех
мест  ПЗУ  (#0370, #1803, #0013, #2A09; чтение другого - зеленый
бордер  и  DI:  HALT),  и  за копией "5.04T*" у нее идет ее код:
седьмой  байт  - #CD (CALL), а во всех ПЗУ TR-DOS, известных QC,
там  #0D  или  текст.  Порты  DivMMC  при этом не пишутся; #3D13
esxDOS  сама  выбирает банк 3, и #3D2F после нее работает. Имя и
версию  DOS  для  окошка режимов QC берет из ПЗУ с #0358 (той же
функцией),  под  esxDOS  -  из  M_DOSVERSION (RST 8, #88; есть в
0.8.7 и новее: HL = #0890 у 0.8.9).

    Под  esxDOS  QC  выходит в TR-DOS вызовом M_AUTOLOAD (RST 8,
#90)  с  A = #FC после очистки памяти, как при запуске программы
(#0048  нет в таблице); перед командой дисководу без образа (она
там не кончается) зовет функцию 1 #3D13 и смотрит бит 7 статуса;
выключает  часы  SMUC  (#3FF0  и  #3FF3  нет в таблице); не ищет
память   Scorpion   и   KAY  (на  +2A/+3  #1FFD  выбирает  ПЗУ).
Особенности  esxDOS  0.8.9:  сектор  за  концом TRD, обрезанного
после  последнего  файла,  она  не  пишет,  а статус - без битов
ошибки;  без  карты  ее вызовы дают ошибку, а эмуляция TR-DOS на
образе  с  карты сбрасывает машину; RST 8 из программы оставляет
выбранным  банк 0 DivMMC, а #3D2F эмуляции переходит в выбранный
банк  (после  вызова  -  OUT  (#E3),3); вопроса TR-DOS об ошибке
(#3F7E)  нет  в  таблице; перехват ошибки TR-DOS "нет диска" при
выборе  дисковода оставляет эмуляцию такой, что ее #0000 и #3D00
сбрасывают  машину  (QC  и  Quick  Setup  выбирают  дисковод без
процедур Бейсика: POP AF, RET в #5CC2).

    TRDBOOT.BIN:  если у образа, запущенного из браузера esxDOS,
нет boot, а в /SYS/CONFIG/TRDOS.CFG стоит AlwaysBoot=1, эмуляция
читает /SYS/TRDBOOT.BIN в #6000 (до #4000 байт) и запускает его.
TRDBOOT.BIN  QC  (16 304 байта) - 24 байта загрузки, затем QC.C,
системные  переменные  (с  +#3D5D) и BASIC-загрузчик (с +#3E98),
как  в  кодовой  странице:  загрузка включает #D7, копирует их в
#C000  и переходит в загрузчик QC. Оверлеи - в /SYS/TRDBOOT.OVR.
Оба  файла  и /BIN/QC пишет Quick Setup (F_OPEN, F_SEEK, F_READ,
F_WRITE;  другой  загрузчик  он  переименовывает  в  TRDBOOT.NAV
функцией  F_RENAME) - из файлов QC на своем диске, с настройками
стоявшего там QC.

    Dot-команда  .qc (/BIN/QC) читает /SYS/TRDBOOT.BIN в #6000 и
запускает  его,  если его первые 11 байт - как у TRDBOOT.BIN QC.
.qc  ИМЯ  сначала вставляет файл из текущей папки: TRD и SCL - в
дисковод  A (EJECT, MOUNT), TAP - в магнитофон (M_TAPEIN, полный
путь),  и  в копии TRDBOOT.BIN той же сборки (по описателю файла
QC)  ставит  KeptSettings  (первый  файл,  носитель  0  или 5) и
LaunchedFrom = 2: QC открывается на этом носителе.

    Лента  -  магнитофон  esxDOS:  свой  TAP  QC вставляет в оба
гнезда  (M_TAPEIN  и  M_TAPEOUT,  in_open  и  out_open),  и SAVE
запущенной  программы  дописывает блоки в его конец; на карту их
esxDOS  пишет  при  out_close,  поэтому каждый старт QC вынимает
свою  ленту  и  вставляет снова. TZX QC переписывает (блоки #10,
#11)  в TAP рядом с ним, с тем же именем, и вставляет его. Файлы
карты и ленты QC запускает вызовами esxDOS после очистки памяти:
ленту  -  M_AUTOLOAD с A = 0 (LOAD ""), TRD в A - M_AUTOLOAD #FD
(его boot), программу +3DOS - M_AUTOLOAD "*", снимок - M_EXECCMD
"snapload  ИМЯ";  Бейсик  они получают от esxDOS, без переменных
TR-DOS.


    :: Расширенная память 

    QC  определяет  память  при  каждом  запуске, с выключенными
прерываниями.  Сначала  он  проверяет,  есть  ли 128Кб: включает
страницу  1  (#7FFD  =  #11) и смотрит, изменилась ли страница 0
(#10).  Если  нет  -  это  48Кб  (или #7FFD заперт: QC запущен в
режиме  48Кб),  и  QC пробует только порт ZX-Evolution #F7F7: на
ней  часы  должны оставить ее #EFF7 как есть (см. о часах Gluk).
Иначе   он   пробует  порты  по  порядку,  и  первый  ответивший
определяет машину:

        порт   машина                 биты страницы
        #F7F7  ZX-Evolution           3-7, инверсные
        #FFF7  ATM Turbo 2+           3-5, инверсные
        #AFF7  Pentagon 4096          0, 1
        #1FFD  Scorpion, KAY          4, 6, 7
        #DFFD  Profi                  0-2
        #FDFD  ATM1                   0-2
        #7FFD  Pentagon 1024          5 (с Caps shift)
        #7FFD  128Кб, Pentagon 512    0-2, 6, 7

    Порты  ATM пробуются первыми, с битами 0-2 #7FFD (биты 6 и 7
там  страниц  не выбирают). ZX-Evolution отвечает на оба, но все
4Мб  переключает  только  ее #F7F7 (8 бит номера страницы); если
#F7F7 нашел не больше 1024Кб, это ATM. Pentagon 4096 (#AFF7; его
драйвер есть и в ALASM 4.46) пробуется после них: ZX-Evolution с
BaseConf принимает #AFF7 за свой #EFF7 (любой порт с A12 = 0, A8
=  1  и младшим байтом #F7 вне TR-DOS), а 0 в нем включает режим
Pentagon  1024  и  турбо,  где порты ATM страниц не переключают.
Scorpion GMX (#DFFD с битом 4 #1FFD) и Pentagon-4096 с GitHub не
поддерживаются.

    Страницы QC считает так: в каждой комбинации значений портов
он  обнуляет  байт  в  #C000 и отмечает страницы, где он остался
нулем;  потом  все байты возвращаются на место, так что RAM-диск
запуск  переживает  (но  не  Copy и Move). Под буфер QC берет не
больше  64  страниц  (1024Кб),  но считает все (на Pentagon 4096
проба находит 128: "Pentagon 2M"); +2A и +3 он узнает по ПЗУ 48:
бит 0 байта #0B53 равен 0 только у них.

    Таблица  страниц (#5B00): по 2 байта - значение расширенного
порта  и  #7FFD;  первыми  -  страницы  буфера, за ними страницы
оверлеев  и  кодовая.  На  Pentagon  биты страницы добавляются к
значению   #7FFD,   на   остальных   машинах  QC  пишет  сначала
расширенный  порт,  потом  #7FFD; в ATM2 и ZX-Evolution значение
инвертируется  и  пишется  в  #FFF7  или  #F7F7 через ПЗУ TR-DOS
(#2A53): порты ATM отвечают только при включенном ПЗУ TR-DOS.

    С  кнопкой  W  при  запуске QC работает с одним портом #7FFD
(128Кб);  Pentagon  1024  по  биту 5 #7FFD он ищет только с Caps
shift:  на других машинах эта проба запирает порт до сброса. 8-я
страница  используется,  только если в CONFIG2 бит 5 = 1 и в ПЗУ
BASIC  48  по  адресу #0008 нет команды JP (#C3): она есть в ПЗУ
Scorpion,  у  которого  в  8-й  странице теневой монитор. Память
+2A/+3  через  #1FFD  QC  не переключает: там он работает как на
128Кб  (под  esxDOS).  Паузы  в  QC - счетные циклы, с турбо они
короче.


    :: Shadow RAM и кнопка Magic 

    QC  в  теневое  ОЗУ  (кэш)  пишет  Quick Setup: включает его
чтением  порта  #FB,  пишет  обе  16Кб половины кэша на 32Кб (их
выбирает  бит  4  #7FFD)  и выключает чтением порта #7B; есть ли
кэш, он проверяет записью байта. В кэш на 16Кб (одна половина на
оба ПЗУ) пишется только половина QC.

    Половина  QC  (бит  4 = 1): #0000-#0007 - переход в половину
оверлеев  (DI, #7FFD = #C6), до #003E - нули (NOP: Reset Service
у  Gluk входит в теневое ОЗУ с адреса 0), #003F-#0067 - резидент
(41  байт; его JR по адресу #0066, вход по NMI, ведет на #0000),
с #0068 - копия кодовой страницы с #C000 по #FF97.
    Половина  оверлеев  (бит  4 = 0): с #0000 - тот же переход и
код,  который  копирует  #0068-#3FFF  в  страницу #D6 и включает
половину  QC  (#7FFD = #D7); дальше - нули, по адресу #0066 - JR
#0000,  с  #0068  - первые 16 280 байт файла .qco как есть (целы
потоки 0-11).

    Magic должна давать NMI при включенном теневом ОЗУ. Резидент
ставит  стек  #5FE8, включает страницу #D7, копирует #0068-#3FFF
обратно  в  #C000,  очищает экран и бордер и переходит на #C000.
Загрузчик восстанавливает системные переменные и BASIC-загрузчик
(#5C00-#5E52),  распаковывает  QC  в  #6000  и запускает его; QC
выключает  теневое ОЗУ, берет настройки из CMOS, как при запуске
из  ПЗУ, а оверлеи - как при любом запуске (первые 16Кб .qco уже
в #D6, остальное - в #D4 и #D3, если там тот же .qco).


    :: QC в ПЗУ, снимок и лента 

    QC_4_01.rom  (16Кб) прошивается вместо ПЗУ Basic 128 (ПЗУ 0,
бит 4 #7FFD = 0); ПЗУ 1 должно быть BASIC 48, нужен Beta Disk. С
#0000  -  DI  и  NOP  до  #0037,  так  что и вход по адресу 0, и
прерывание  IM  1  запускают  QC. С #0038: стек #5FE8, бордер 0,
очистка  атрибутов,  #7FFD  = #C7 (страница #D7 с включенным ПЗУ
QC),  копирование образа с #005B в #C000 и переход на загрузчик.
С  #005B  лежат загрузчик и упакованный код, с #3DA0 - системные
переменные   #5C00-#5D3A   с   дескриптором  файла  "QC 4.01"  и
BASIC-загрузчик  (попадают в #FD45). Входа по NMI при включенном
ПЗУ  QC  нет:  по #0066 там код загрузчика. Настройки - из CMOS,
без нее - сборки.

    Набор  ПЗУ  QC_4_01_ovr.rom  (16Кб) - первые 16Кб файла .qco
как  есть  (целы  потоки  0-11), дальше #FF. На Pentagon 1024 он
встает  вместо  Basic 128, а QC_4_01.rom - вместо сервисного ПЗУ
(Reset   Service   Mr   Gluk),  с  которого  стартует  сброс;  в
64Кб-образе ПЗУ эмулятора (порядок Unreal Speccy) 0 - набор, 1 -
BASIC  48,  2  -  QC,  3  - TR-DOS. Если в страницах целы не все
оверлеи, а .qco на входном диске (под esxDOS - на карте) нет, QC
включает  ПЗУ  0 (бит 4 #7FFD = 0, вне TR-DOS) и, если там набор
его сборки, копирует 16Кб в страницу #D6.

    Снимок  QC_4_01.sna - SNA на 128Кб: в #6000 - TRDBOOT.BIN, в
страницах 6, 4, 3 - весь .qco, PC - #A000, прерывания выключены,
#7FFD = #10. Его старт гасит бордер, выбирает банк 0 DivMMC (OUT
(#E3),0:  после snapload esxDOS выбран банк загрузчика снимков),
копирует  страницы .qco в те, что включают #D6, #D4, #D3 на этой
машине,   и  переходит  в  загрузку  TRDBOOT.BIN.  После  сброса
работает ПЗУ машины.

    Лента  QC_4_01.tap:  программа  с  автозапуском: в строке 10
(REM)  -  проба  TR-DOS  (вход 15619, как в z88dk), без TR-DOS и
esxDOS  -  сообщение  и  STOP,  дальше CLEAR 24575: LOAD ""CODE:
RANDOMIZE  USR  24576;  код в #6000 (TRDBOOT.BIN, в его launcher
loader.LaunchedFrom  -  FromTape),  затем  блоки  без заголовка:
копия  .qco  для 48Кб (overlay.Room48 байт), потом .qco по 16Кб.
Блоки  читает  сам  QC  в начале старта (overlay.Tape; LD_BYTES,
#0556),  до первого обращения к диску: на 48Кб - только копию, в
#C000;  иначе  копию  пропускает,  а  части  .qco кладет в #C000
страниц  #D6,  #D4,  #D3;  если  .qco  этой  сборки  уже  цел  в
страницах,   не   читает  ничего.  Под  esxDOS  на  время  блока
выбирается  банк  0  DivMMC. В обоих случаях QC стартует, как из
ПЗУ.


    :: Часы CMOS 

    Работа с часами задается в CONFIG2: бит 2 - работать с CMOS,
бит  3  -  Gluk  (1)  или SMUC (0), бит 4 - чтение и запись (0 -
только часы).

    Gluk:  OUT  (#EFF7),#80  (бит  7  открывает  доступ),  номер
регистра  -  в #DFF7, данные - IN или OUT через #BFF7, затем OUT
(#EFF7),0.  Прочитать  порт  нельзя,  и  QC  пишет весь регистр,
каждый кадр, пока ждет кнопку: другие биты порта обнуляются. Где
страницы  переключает  порт  ATM  (#F7F7  ZX-Evolution или #FFF7
ATM2;  на  ZX-Evolution  -  и при запертом #7FFD и с кнопкой W),
пишутся  #94  и #14: бит 2 = 1 держит выключенным режим Pentagon
1024  (в  нем  биты  3-5 страницы берутся из #7FFD), бит 4 = 1 -
частоту 3,5 МГц.

    SMUC:  порты отвечают только при включенном ПЗУ TR-DOS, и QC
обращается  к ним через куски ПЗУ SMUC: OUT (C),A; RET по адресу
#3FF0  и IN A,(C); RET по #3FF3. Чтение: номер регистра в #DFBA,
затем  IN из #DFBA. Запись: номер регистра в #DFBA, #F7 в #FFBA,
данные  в #DFBA, #77 в #FFBA. Эти куски есть в ПЗУ TR-DOS SMUC и
в 6.10E/6.11E, но не в 5.04T.

    Часы: регистр #0B = #FF - часов нет. Если запись разрешена и
#0B  еще  не 24 часа и BCD (биты 1-2 = 1, 0), QC на время чтения
ставит  #0B  =  %00000010  и потом возвращает прежнее: ячейку он
пишет,  только если в ней другое значение, как и все свои записи
в   CMOS   (у   ZXMC-2  ячейки,  кроме  времени,  -  EEPROM  его
контроллера:  запись  идет  около  8,5 мс, и следующее обращение
ждет  ее,  держа  Z80 в WAIT и не читая клавиатуру PS/2); пока в
регистре  #0A  бит  7  (UIP)  =  1,  кадр  пропускается; время -
регистры  4,  2,  0  (BCD).  При запуске QC читает #0B в течение
кадра:  если он хоть раз меняется или равен #FF, бит 2 CONFIG2 в
памяти  сбрасывается  (на 128 и +2 без часов их порты дают байты
экрана).

    Ячейки  QC:  #10 - входной носитель (0-3 - дисковод A-D, 4 -
SD-карта,  5  -  лента);  #15  -  CONFIG  (биты  0-2  - выходной
носитель); #16 - номер файла под курсором + 1 (младший байт; 0 -
нет; у дисковода больше #80 не берется ни одна ячейка). QC пишет
изменившиеся  (курсор  последним) через секунду после последнего
движения курсора и перед запуском программы, если в CONFIG2 биты
2  и 4 = 1, а читает при тех же битах только при запуске из ПЗУ,
TRDBOOT.BIN, с ленты или по Magic; CONFIG из #15 берется, только
если в нем бит 5 = 1. Ячейка #10 - общая с Real Commander 1.96 и
TR-DOS 6.05E+ (дисковод для автозапуска); Gluk 6.2-6.61 и QC 3.x
берут  ее  биты  0-1.  Бит  7 в #10 у Mr Gluk Reset Service 6.3+
запрещает  запоминать дисковод: тогда QC, как и Gluk, эту ячейку
не пишет.


    :: Мышь Kempston и AY 

    Мышь:  #FBDF  - X, #FFDF - Y (инверсный: QC инвертирует его,
чтобы  Y рос вниз), #FADF - кнопки в битах 0-2 (0 - нажата): бит
0  -  правая, бит 1 - левая, бит 2 - третья. У ZX-Evolution (и в
MAME,  pentevo)  левая  -  бит  0:  при  бите  7  CONFIG2 = 0 QC
переставляет  биты  0  и 1. Колесо не читается; кнопка считается
нажатой  после  3 кадров без изменений. Если при запуске за кадр
(1202  чтения  #FADF)  кнопка  хоть  раз  читается нажатой, мышь
выключается  (так и на сером 128 и +2: плавающая шина). В Unreal
Speccy для порядка кнопок Kempston нужно SwapMouse=1.

    AY:  плэйер  (PTSPlay  Сергея Булбы) работает с одним AY или
двумя  (TurboSound, стандарт NedoPC: #FF в #FFFD выбирает первый
AY,  #FE  -  второй):  #FFFD  -  номер регистра, #BFFD - данные.
Регистры  0-12  пишутся каждый кадр, 13 - только когда меняется;
индикаторы  читают регистры 0-5 и 8-10. При старте QC глушит оба
AY:  микшер #FF, громкости 0. Порядок каналов - ABC, ACB или BAC
(TXTMODE, биты 4-5).


    :: Настройки в файле QC 

    Файл   "QC 4.01"   (тип   B,   старт   и   длина  -  279)  -
BASIC-загрузчик:  строка  1  CLEAR  24575:  RANDOMIZE  USR 23925
(числа  спрятаны  за  точками),  за  ней  настройки, загрузчик и
распаковщик;  с 3-го сектора - упакованный код (QC.C), число его
секторов - по смещению 74 (#4A). Настройки - 35 байт со смещения
23  (#17),  в  памяти  - #5D52-#5D74; смещения те же у QC 3.11 и
новее. Файл QC узнается по BASIC-строке (байты 4-21: FD 2E 0E 00
00 FF 5F 00 3A F9 C0 2E 0E 00 00 75 5D 00) и по LD SP,#5FFF (#31
#FF #5F) в начале 3-го сектора.

    Тот  же  загрузчик,  с настройками на том же смещении от его
строки,  лежит в образе ПЗУ QC и в TRDBOOT.BIN (через #3E80 байт
после  их  кода  загрузки;  в образе ПЗУ настройки - с #3EF2), в
кодовой  странице  (#FE80)  и  в Shadow RAM (#3EE8 половины QC).
Quick  Setup  находит  его  по  строке  загрузчика (на диске - в
первом секторе boot.B) и берет настройки QC 3.20 и новее для QC,
который туда пишет. Байты, их значения по умолчанию и смещения в
файле:

        ;0-2: output: 0-3 drive, 4 SD, 5 tape, 7 same.
        ;3: not used.
        ;4: 1 - fullcat off, 0 - fullcat on.
        ;5: 1 - QC config ID, 0 - RC config ID.
        ;6: 1 - play without loop, 0 - loop on.
        ;7: 1 - boot mode, 0 - commander mode.
CONFIG  DB %10111111                        ;#17

        ;0: not used.
        ;1: not used.
        ;2: 1 - use CMOS, 0 - don't use.
        ;3: 1 - Gluk CMOS, 0 - SMUC CMOS.
        ;4: 1 - read & write CMOS, 0 - clock only.
        ;5: 1 - use page 8 (not on Scorpion), 0 - never.
        ;6: 1 - key click on, 0 - off (S).
        ;7: 1 - Kempston mouse buttons, 0 - swapped.
CONFIG2 DB %11111111                        ;#18

        ;0: 1 - fast load, 0 - slow load: Drive A.
        ;1: 1 - fast save, 0 - slow save: Drive A.
        ;2: 1 - fast load, 0 - slow load: Drive B.
        ;3: 1 - fast save, 0 - slow save: Drive B.
        ;4: 1 - fast load, 0 - slow load: Drive C.
        ;5: 1 - fast save, 0 - slow save: Drive C.
        ;6: 1 - fast load, 0 - slow load: Drive D.
        ;7: 1 - fast save, 0 - slow save: Drive D.
            ;D C B A
CONFDRV DB %11111111                        ;#19

        ;0-1: text viewer W: 0 - cut, 1 - wrap, 2 - words.
        ;2-3: text viewer M: 1 - colours, 2 - codes as
        ;     signs, 0 - codes hidden.
        ;4-5: music view C: 0 - ABC, 1 - ACB,
        ;     2 - BAC.
        ;6-7: not used.
TXTMODE DB %00000100                        ;#1A
SET_VER DB 2                                ;#1B

COLORSF DB #47,#07,#43             ;B C s   ;#1C
        DB #45,#45,#FF,#45,#45,#45 ;m M st - S w
        DB #44,#44,#44,#44         ;W t T d
        DB #02,#42,#42,#42,#42     ;p z Z r h
        DB #05,#05,#05,#05,#05     ;H R a A X
COLORSO DB #04,#01,#06             ;scr del oth ;#33
COLORS  DB #5F,#78,#05,#30                  ;#36

    CONFIG:  биты  0-2  - выходной носитель (коды - как в ячейке
CMOS  #10,  7  - дисковод входного носителя), 4 - полный каталог
выключен,  5  =  1  -  это  настройки  QC (CONFIG с битом 5 = 0,
вернувшийся  из  резидента  или  CMOS,  QC  не берет, носители и
курсор  -  берет),  6 - мелодии без повтора, 7 - режим бута. При
запуске  с  диска  входной  носитель  -  байт  st, выходной - из
CONFIG; при возврате из программы и из CMOS - сохраненные.
    CONFIG2:  биты  2-4  - часы (см. "Часы CMOS"; при бите 4 = 0
настройки  в  CMOS  не  пишутся  и  не  читаются),  бит  5 - 8-я
страница,  бит  6  - щелчок кнопок, бит 7 - порядок кнопок мыши;
биты  0  и  1  не  используются  (в  настройках  - 1). CONFDRV -
скорость  дисководов.  TXTMODE  -  режимы  вьюверов при запуске.
CONFIG, CONFIG2 (бит 6) и TXTMODE меняются во время работы.
    SET_VER  -  версия  настроек,  2  (у  QC  3.30..3.32  - 1, у
3.20..3.23  здесь  номер  дорожки  159..162).  Настройки  другой
версии Quick Setup берет с выходом "как вход" (биты 0-2 CONFIG =
7), а у 3.20..3.23 - и с TXTMODE по умолчанию.
    COLORSF  - цвета 21 типа файлов, в порядке, обратном таблице
типов  панели  ("XAaRHhrZzpdTtWwSXXMmsCB"); байт 5 (st, считая с
0)   -  носитель  при  запуске  с  диска  (0-5,  иначе  дисковод
загрузки),  байт  6  не  используется.  COLORSO - цвета экранных
файлов  и  шрифтов, удаленных файлов и остальных типов; COLORS -
курсор на отмеченном файле, отмеченные файлы, текст во вьювере и
его информационная строка.


    :: Резидент и возврат в QC 

    Резидент  есть  только  при памяти больше 128Кб: это кодовая
страница  #D7  (см. "Память"). Метку "Residentpresent!" QC пишет
при  запуске:  по  ней TR-DOS 6.10E и новее при сбросе запускает
QC.  Цел  ли  резидент,  QC проверяет по слову #FF31 в #C000 (LD
SP,#5FFF  загрузчика) и по последним байтам метки ("t!" в #FFFE:
стек  программы  портит  их первыми). Перед запуском программы и
выходом в TR-DOS QC сверяет еще сумму Флетчера-16 QC.C (ее пишет
в  BASIC-загрузчик  сборка)  и  сумму  #FD45-#FFFF,  взятую  при
запуске;  если что-то не сходится (на 128Кб и 48Кб - всегда), QC
стирает первый и последний байты метки и первый байт загрузчика:
#FF31 в #C000 тогда нет.

    Страница  #D7  -  это #C7 стандарта Pentagon (бит 4 выбирает
только  ПЗУ):  ее  находят  TR-DOS  6.05E+ и 6.10E. Где #7FFD не
смотрит  на  биты  6 и 7 (Scorpion, Profi, ATM), #D7 = #17 - 7-я
страница;  на  Pentagon 512/1024 это 31-я, на KAY 1024 - 23-я, и
программа,  которая  включает  #17  (там  держат  резидент  Real
Commander и QC до 3.10), QC там не найдет. Возврат в QC из своей
программы:

        LD BC,#7FFD
        LD A,#D7 ;(не #17!!!)
        OUT (C),A
        LD HL,(#C000)
        LD DE,#FF31
        XOR A
        SBC HL,DE
        JP Z,#C000
        LD H,A
        LD L,A
        PUSH HL
        LD A,#10
        OUT (C),A
        JP #3D2F

    Если  резидент  цел, JP #C000 запускает загрузчик: он ставит
стек,  восстанавливает  системные  переменные  и BASIC-загрузчик
(#5C00-#5E52),  распаковывает  QC в #6000 и запускает его. Иначе
включаются  страница  0 и ПЗУ BASIC 48, на стек кладется 0, и JP
#3D2F  (NOP;  RET  в  ПЗУ  TR-DOS) уходит на адрес 0 ПЗУ TR-DOS:
TR-DOS  6.10E  и  новее  найдут  метку  и запустят QC, остальные
просто  стартуют.  Стек  программы  должен быть ниже #C000 (PUSH
выполняется  при  включенной  странице  #D7),  прерывания  лучше
запретить   заранее   (загрузчик   запрещает  их  только  второй
командой),  а расширенный порт (#1FFD, #DFFD, #FDFD) - вернуть в
0: QC пишет только #7FFD.

    Чтобы  вернуться, программа не должна трогать страницу #D7 с
#C000  по  #FF97  и  метку  с  #FFF0.  На Scorpion, Profi, ATM и
ZX-Evolution   эта   страница   -  второй  экран  (#C000-#DAFF).
Программа,  запущенная  в режиме 48Кб, вернуться не может: #7FFD
заперт.

    Перед  запуском  QC  пишет  в  страницу  #D7 номер файла под
курсором  + 1 (#FD42), CONFIG (#FD43) и входной носитель (#FD44,
коды - как в ячейке CMOS #10) и ставит LaunchedFrom (#C01E) = 2.
При  возврате  QC  берет  их  оттуда: курсор - если он 1..#80 (у
карты и ленты - 1..#FF), CONFIG - если в нем бит 5 = 1 (выходной
носитель  -  из битов 0-2 в любом случае), входной носитель - из
третьего  байта.  LaunchedFrom:  0 - запуск с диска, 1 - из ПЗУ,
TRDBOOT.BIN  или по Magic, 2 - возврат из программы (и .qc ИМЯ),
3 - с ленты.


    :: Запуск программ 

    Перед  любым  запуском QC включает страницу 0 и ПЗУ BASIC 48
(#7FFD  =  #10),  ставит  CURCHL = #5D26 и HL' = #2758, кладет в
дескриптор  TR-DOS  (#5CDD-#5CEC)  запись  файла  из каталога, в
#5CF5  - его дорожку (головка выводится на нее), DosHook (#5CC2)
=  RET, текущий дисковод - в #5CF6, #5D19, #5CF8, #5CF9 и в биты
0-1  #5D16  и  разрешает прерывания (IY = #5C3A, IM 1, I = #3F);
LAST_K  =  0,  REPDEL = 16, REPPER = 1, FLAGS = #CD, FLAGS2 = 0,
P_POSN = 0.

    Файл  кода:  экран  очищается  (бордер и атрибуты 0), память
#5D3B-#FFFF   страницы  0  обнуляется,  сектора  файла  читаются
функцией  #3D13 с адреса его старта (не дальше #FFFF), программа
запускается  через  PUSH  IX;  JP #3D13, стек - #5FE8, на нем 0.
Старт  ниже #4000 попадает в ПЗУ TR-DOS. BASIC-программа: бордер
белый,   CLEAR   (#1EB7)  с  RAMTOP  #FF00,  память  #5D3B-#FE4B
обнуляется,  файл  загружается  ПЗУ  TR-DOS  по дескриптору, без
поиска  в  каталоге,  строка  автозапуска - из байтов #80, #AA и
номера  строки  после  программы,  выполнение  -  через STMT_RET
(#1B76). Режим 48Кб (R в главном меню): #7FFD = #30 (страница 0,
ПЗУ BASIC 48, бит 5 - блокировка; на Pentagon 1024 бит 5 - номер
страницы),  расширенный  порт  -  значение  страницы  0. Выход в
TR-DOS: бордер 7, P_RAMT = #FFFF, переход на #0048 ПЗУ TR-DOS.


    :: Диски TR-DOS 

    Каталожными и файловыми процедурами TR-DOS QC не пользуется:
9  секторов  каталога он читает и пишет сам. Дорожка D - цилиндр
D/2,  четные  -  на  первой  стороне (#3C в системном регистре),
нечетные  -  на второй (#2C). Сектор E - 0..15, как у TR-DOS, на
диске  -  номер E+1, по 256 байт; сторона в заголовке сектора не
проверяется.  Номер  дорожки  -  любой  до  255, чтение и запись
переходят с дорожки на дорожку.

    Размер  диска  QC  берет  из  служебного  сектора  (сектор 8
нулевой  дорожки  при  счете с 0): первый свободный сектор (#E1,
#E2)  плюс  свободные  (#E5-#E6),  так  что диски любого размера
сохраняют  свой,  и  TRD на 1 Мб (256 дорожек), какой подключает
esxDOS. Первый свободный сектор на дорожке 0 - за 255-й дорожкой
(диск  из  256  дорожек  полон).  Тип диска (#E3) QC не читает и
всегда пишет #16: двойного шага и одной стороны у QC нет.

    Служебный  сектор  QC  пересчитывает  в памяти после каждого
чтения  каталога  и  перед  записью:  #00  =  0;  #E1,  #E2 - за
последним  файлом  с  секторами,  считая  удаленные  (записи без
секторов  на  0/0  после  файлов  -  картинки  из имен, места не
берут),  но  не  раньше  записанного на диске (раньше его ставят
только  Delete в конце каталога и M); #E3 = #16; #E4 - записи до
конца  каталога;  #E5-#E6 - размер минус первый свободный; #E7 =
#10  (при  чтении  не  проверяется);  #F4 - удаленные. Остальные
байты  пишутся,  как  прочитаны.  Имя  диска  у  QC - 11 знаков,
#F5-#FF;  у  TR-DOS - 8 (#F5-#FC). Format TR-DOS пишет в #FD-#FF
нули,  QC  показывает  их  пробелами;  N  пишет только набранные
байты.  CAT и LIST TR-DOS печатают имя до байта 0 или с битом 7:
без нуля в #F5-#FF - и дальше имени.

    Каталог  -  128  записей  по  16 байт; первый байт имени 0 -
конец  каталога,  1  -  удаленный файл. Delete ставит 1, а серия
удаленных  прямо  перед концом каталога становится концом (0), и
их место - свободным, как после ERASE последнего файла в TR-DOS.
Copy  дописывает файлы после последней записи, считая удаленные,
с   первого  свободного  сектора;  удаленные  записи  заново  не
используются,  одинаковые  имена не проверяются. Порядок отметки
(129  байт)  QC  держит  в  #40-#C0 служебного сектора в памяти;
после  Copy  на  другой  дисковод  или  прерванного  там нули, и
следующая   запись   каталога  заносит  их  на  диск.  Move  (M)
переписывает  живые  файлы  подряд, удаленные записи после этого
места пропадают; прерванный после записи части, M пишет каталог,
каким  оставил  диск  (перед  первым  не  перенесенным  файлом -
удаленная запись на оставшееся место).

    Файл  длиннее 255 секторов - группа частей (так пишут Hrip и
RAR  с ПК): первая часть, за ней в каталоге и на диске - части с
тем  же именем и стартом и типами 0, 1... по порядку, все, кроме
последней,  -  по  255  секторов,  длина 65280. Merge (G) растит
только число секторов первой записи (длина перестает сходиться с
секторами), а больше 255 секторов делает такую группу.

    Длина  файла:  число  секторов  -  байт 13 записи (файл из 0
секторов  не читается). Поле длины принимается, если его старший
байт  равен  числу  секторов  минус  1  (младший не 0) или числу
секторов  (младший  0); иначе длина - секторы*256. Copy и запуск
кода берут байт 13 как есть.

    Имена:  8 знаков и тип (байт 8); TR-DOS знает только тип. QC
показывает трехзнаковое расширение - тип и два байта поля старта
(младший, старший), если оба - #20..#7F, иначе тип и два пробела
(у B в старте - длина программы: CODE 30000, #7530, выглядит как
.C0u). Русские буквы в именах - cp866 (#80-#AF, #E0-#EF); TR-DOS
печатает  их  через  PRINT  BASIC  (#80-#8F  -  блочная графика,
#90-#A4  -  UDG,  #A5-#FF  -  ключевые слова) и сравнивает имена
побайтно.  Соглашения  QC:  p_X и z_X - файл типа X, упакованный
Hrust (p) или ZX0 (z), "_" и X - в поле старта: U дает файлу тип
X  (иначе  C),  два  пробела в старте (у кода, если их оставить,
старт #8000) и длину данных; .zx0 - тип z и "x0"; TAP, TZX и SCL
на  диске  -  типы  t  и  s со стартом "ap", "zx" и "cl" (так их
называет Copy с SD-карты), их QC открывает как образ.

    Цвет  файла  в панели, по порядку проверки: удаленный - цвет
удаленных;  поле длины ровно 6912, 6144, 13824, 2048 или 768 (не
у B) - цвет картинок; тип i, p_i и z_i - тоже; тип p или z с "_"
в младшем байте старта - цвет типа из старшего; иначе тип ищется
(с  учетом  регистра)  в таблице "XAaRHhrZzpdTtWwSXXMmsCB", а не
найденный  получает  цвет  остальных  (так и D и # TR-DOS). Типы
таблицы:

        B  BASIC               p  Hrust
        C  код                 z  .zip, .zx0
        s  .scr, .scl          Z  ZXZip
        m  ProTracker 3        r  .rar, .rzx, .rom
        M  ProTracker 2        h  Hrip
        S  Sound Tracker       H  ALASM
        w  .wav                R  Storm
        W  ZXWord              a  Masm, ZASM
        t  .txt                A  TASM, GENS
        T  .TXT                X  Xas
        d  .diz, .doc

    Переменные  TR-DOS:  QC  читает  #5CF6 (дисковод загрузки) и
#5CF4,  #5CF5  -  место  кода на диске, которое TR-DOS оставляет
после  загрузки BASIC-части (программа, которая сама грузит файл
QC,  должна  оставить их так же). DosHook (#5CC2) = POP AF; RET:
вызовы  TR-DOS  в  процедуры BASIC (через #2F72) пропускаются, и
проверка   BREAK   в  кусках  ПЗУ  не  срабатывает.  Время  шага
дисководов  (#5CFA-#5CFD)  =  8:  бит 7 = 0 (TR-DOS не проверяет
дисковод при выборе), шаг 6 мс; позиционирование кусками #2740 -
с шагом 30 мс (#1B).

    Копию  каталога  на  дорожке  161  (сектора  7-15)  хранит и
восстанавливает disk_Utils; дорожка форматируется только с этими
секторами.  Метку  "Quick Commander " со смещения #C8 служебного
сектора  QC  не пишет и не читает; таблицы "DIRS" стандарта 8-го
сектора нет.

    Quick  Setup (пункт B) кладет boot.B и .qco на место первого
файла с тем же именем и типом: если он последний - поверх него и
свободного  места  за  ним;  если  не короче - поверх, остаток -
удаленным  файлом  за ним (при полном каталоге в записи остается
старая  длина);  если  короче - он помечается удаленным, а новый
дописывается  в  конец  (так  и  без такого файла). Другие живые
файлы с этим именем удаляются.


    :: Форматы файлов 

    Тексты:  cp866  или  UTF-8.  Без байтов #80 и больше текст -
cp866.  Иначе  QC  проверяет  его  с первого такого байта: до 16
многобайтовых  последовательностей  в  пределах  1024  символов.
Начало   последовательности   -   #C2..#DF   (за   ним   1  байт
продолжения),   #E0..#EF   (2),   #F0..#F4  (3);  продолжение  -
#80..#BF.  Не  UTF-8  - если раньше встретится байт #80..#C1 или
#F5..#FF  в  начале  символа  или  оборванная последовательность
(длинные формы, суррогаты и коды выше U+10FFFF не проверяются).

    Знаки  UTF-8  QC  печатает  шрифтом  cp866:  А..я, Ё, ё - их
кодами;  псевдографику  U+25xx  (░▒▓,  рамки, █▄▌▐▀) - #B0..#DF;
кавычки  U+00AB,  U+00BB,  U+201C,  U+201D,  U+201E  - знаком ",
U+2018,  U+2019  -  знаком  ';  тире  U+2013, U+2014 - знаком -;
многоточие  -  тремя точками; Є, є - как Е, е; Ї, ї и украинские
I,  i (U+0406, U+0456) - как латинские I, i; Ў, ў - как У, у; Г,
г  с  крючком (U+0490, U+0491) - как Г, г; BOM, мягкий перенос и
знак  ударения  не  печатаются;  знаки  шрифта  (U+2265, U+2264,
U+2320,  U+2321, U+00F7, U+2248, °, U+2022 и ∙, ·, √, №, U+00B2,
■ и неразрывный пробел) - кодами #F2..#FF, ¤ - #FD; остальные, и
все   четырехбайтовые,   -   знаком   ?.   Байт   не   в  начале
последовательности  печатается  как  есть, но cp866 внутри UTF-8
виден   только   случайно  ("ра",  #E0  #A0,  похоже  на  начало
трехбайтовой последовательности и станет ?).

    Шрифт  вьювера  - 256 знаков шириной 4 точки: 64 колонки, 23
строки. #00 - пусто, #01-#1F и #7F - знаки cp437 (рожицы, масти,
стрелки,  домик),  #80-#AF  -  А..п,  #B0-#DF  -  псевдографика,
#E0-#EF  -  р..я,  #F0  -  Ё,  #F1  - ё, #F2-#FF - знаки U+2265,
U+2264, U+2320, U+2321, U+00F7, U+2248, °, ∙, ·, √, №, U+00B2, ■
и пусто. В #F2-#F7 и #FD шрифт расходится с cp866 (там Є є Ї ї Ў
ў и ¤).

    Конец  строки  - CR (#0D), LF (#0A), CR LF или байт 0; LF CR
дает лишнюю пустую строку. Табуляция (9) - до следующей колонки,
кратной  8;  коды 11, 12, 21-31 и #7F печатаются знаками шрифта.
Цвета по стандарту ACEdit: коды 1-7 - чернила 1-7 на черном, 8 -
цвет  текста  из  настроек, 14-20 - яркие чернила 1-7 (код минус
13).  Код  печатается  пробелом  и  действует  с того места, где
стоит;  атрибут  -  один  на  два  знака,  так что код во второй
половине  клетки  действует со следующей. Код прямо перед концом
строки  (CR, LF или 0) задает цвет всей строки (при CR LF - нет:
перед  LF  стоит  CR);  у  строки,  перенесенной  по ширине, его
получает только последняя часть. Код 0 заканчивает строку.

    Исходник  ALASM  4.x - файл до 16Кб: заголовок в 64 байта (в
+8  -  H,  в  +#28  - 8 байт с суммой #80), за ним строки - байт
длины  (он  тоже  считается)  и сами байты, в конце 0. В строке:
1..#F  -  столько пробелов, #10 - остаток строки как есть, байты
от  #80  -  токены  (первый  - мнемоника, следующие - операнды),
";" - комментарий до конца строки, кавычка - строка до следующей
кавычки,  #FF - ничего. QC переводит его в текст с кодами цветов
ACEdit:  метка  -  6,  команда  - 8, переход - 3, директива - 2,
операнды  -  7,  комментарий  -  4 (код - на месте пробела перед
частью строки); текст кончается у верха буфера (64Кб, на 128Кб -
48Кб) или там, где догнал бы непрочитанную часть исходника.

    Картинки  QC  узнает  по  длине (какие - в guide_ru.txt, V):
длина  точная,  младший  байт  -  0  (кроме .bsc, 11136, #2B80),
сходится  с  числом  секторов.  У  @-файла  (49152, 192 сектора)
показывается   начало   (6912   байт),  у  6144  (только  точки)
атрибуты  -  #07; упакованная картинка узнается по длине данных.
.mlt  не  поддерживается.  .bsc:  6912  байт экрана и 4224 байта
бордюра, картинка 384x304 (по 64 точки слева и справа, 64 строки
сверху  и  48  снизу),  цвет  на каждые 8 точек строки, по два в
байте  (биты 0-2 и 3-5). Бордюр рисуется по ходу луча только при
известном тайминге (кадр Pentagon и ZX-Evolution - 71680 тактов,
48K и Scorpion - 69888, 128K и +2A/+3 - 70908; +2A/+3 - по байту
#0B53  ПЗУ 48); мазки короче 3 клеток (24 точки) и слишком много
цветов  подряд пропускаются, и тогда в правом нижнем углу - знак
из  двух волнистых черт. Иначе (и в турбо) бордюр - самый частый
его  цвет.  .img  -  два  экрана по 6912 байт: второй кладется в
страницу  7,  и  экраны  сменяет  каждый кадр бит 3 #7FFD (байты
страницы 7 под ним QC на это время уносит в страницу буфера).

    Шрифты:  768 байт - 96 знаков по 8 байт, сверху вниз (обычно
коды  #20-#7F);  2048 байт - 256 знаков. Спрайты: любой файл как
черно-белая  картинка,  строка  точек  -  ширина  спрайта (1..32
байта)  байт подряд, старший бит - левая точка, строки - одна за
другой, без знакомест и атрибутов.

    Музыка: модули Pro Tracker 3 и Vortex Tracker II (PT3) и Pro
Tracker  2  (PT2),  плэйер  PTSPlay  Сергея  Булбы  (release 0).
Текстовый  заголовок  PT3  QC  ищет  в  любом  месте  файла (так
находятся и модули с плэйером): T, за ней r, за 4 байта до r - P
("ProTracker")  или  за 8 байт - V ("Vortex Tracker"), и b через
#3F  байт  от  P  или  V  (" by "),  по 16-килобайтным частям, с
переходом  из  части  в  часть;  в файлах короче 256 байт - нет.
Заголовок:

        +#00  "ProTracker 3.x compilation of " (версия
              в +#0D) или "Vortex Tracker II 1.0 module: "
        +#1E  название, 32 байта (строка 22, "PT3.5 : ")
        +#3E  " by "
        +#42  автор, 32 байта (строка 23, "Author: ")
        +#63  таблица нот (биты 0-1)
        +#64  темп
        +#65  число позиций (для полосы позиции)
        +#66  позиция цикла
        +#67  указатель паттернов
        +#69  32 указателя сэмплов
        +#A9  16 указателей орнаментов
        +#C9  список позиций, в конце #FF

    Версия  -  цифра  в  +#0D; не цифра (у Vortex Tracker там r)
считается  6.  Ниже  4  -  старые  таблицы  нот, ниже 5 - старая
таблица громкости, ниже 6 - старое портаменто, с 7 - правило Pro
Tracker 3.7 для команд 1xx и 2xx с задержкой 0.

    Без   текстового   заголовка  модуль  ищется  по  устройству
заголовка  в  первых  3Кб файла (UniSearch автора): темп 1..#3F,
число позиций от 1 и позиция цикла в их пределах, список позиций
с  #FF  прямо перед паттернами, пустой орнамент 0 (у PT3 - 0, 1,
0;  у  PT2 - 1, 0, 0). Так находятся модули PT2 (без плэйера или
после плэйера Pro Tracker 2) и модули PT3 без текста.

    Модуль  играется,  если  самый  дальний из его 48 указателей
сэмплов  и  орнаментов меньше #4000; модуль, который переходит в
следующую  16Кб  часть  файла,  QC  собирает в начале его части.
TurboSound  на  двух  AY: пары Vortex Tracker II (два модуля PT3
подряд  в конце файла, за ними "PT3!" size1 "PT3!" size2 "02TS";
пара  не  помещается  в  16Кб  -  играет первый) и TS-модули Pro
Tracker 3.7 Alone Coder'а (версия 7 и выше, байт 98 не пробел).

    Hrust 2 (hr2): блок должен начинаться с первого байта файла:

        +0  "hr2"
        +3  флаги: бит 7 = 1 - данные не сжаты
        +4  длина распакованных данных (слово)
        +6  длина упакованного блока, считая с +8
        +8  упакованный блок

    Блок  один,  что  после  него  -  не читается. Распакованные
данные L должны поместиться с запасом: L + L/8 + 272 - не больше
верха  буфера  (64Кб,  на  128Кб  - 48Кб), то есть до 58012 байт
(43448).   Файл,  который  начинается  с  "hr2",  но  не  прошел
проверку, как ZX0 уже не пробуется.

    Hrust  1  (формат  DEHRUST  Hrumer'а)  - тоже блок с первого
байта файла:

        +0  "HR"
        +2  длина распакованных данных (слово)
        +4  длина всего блока (слово)
        +6  последние 6 байт распакованных данных
        +12 упакованный поток

    Блок  берется,  если  его длина равна длине файла или меньше
нее  не  больше  чем  на  255  байт; пределы данных те же, что у
Hrust 2.  Иначе  файл  пробуется  как ZX0. Архивы Hrip (в начале
"HRi",  а в +8 - "Hrst2" их первого блока) не распаковываются, а
только раскрашиваются.

    ZX0:  формат  ZX0  v2,  прямой (поток для dzx0_standard; для
dzx0_turbo  и dzx0_mega - тот же формат); обратный (-b) и старый
формат  v1  (-c)  не  подходят.  Заголовка у ZX0 нет, и поток QC
узнает сам: распаковывает его на пробу, без записи, и проверяет,
что  каждая  ссылка  - в уже распакованные данные и маркер конца
стоит  точно  на последнем байте файла (у файла длиннее буфера -
только  маркер).  Поэтому  длина  файла  в  каталоге должна быть
точной  длиной  потока,  не  округленной до сектора. Данные - до
16Мб:  не  помещаются  в  буфер  -  U и вьюверы распаковывают их
порциями с носителя.


    :: Соглашения с Real Commander 

    QC  соблюдает  соглашения  Real  Commander  (Pawel Kislyak):
ячейка  CMOS  #10  -  текущий дисковод (у QC - входной носитель,
дисковод  -  0-3);  бит  5 байта настроек (в ячейке CMOS #15 и в
резиденте) = 1 - это настройки QC, 0 - RC; возврат в коммандер -
по  сигнатуре  LD  SP,#??FF  (слово  #FF31)  в #C000 резидентной
страницы.  Real  Commander  держит  резидент  в  странице  #17 и
выходит  в  TR-DOS  через  JP 15649 (#3D21), QC - в странице #D7
(см. "Резидент и возврат в QC").


    :: Лицензия ZX0 

    Распаковщик  ZX0  в QC (загрузчик распаковывает им код QC) -
"standard"  из  ZX0  v2  Einar  Saukas  и  Urusergi; U и вьюверы
распаковывают  файлы  ZX0  его  копией  с  24-битными длинами, а
проверка  потока  ZX0  читает  гамму  Элиаса,  как "turbo" Einar
Saukas и introspec. Его лицензия:

    BSD 3-Clause License

    Copyright (c) 2021, Einar Saukas
    All rights reserved.

    Redistribution and use in source and binary forms, with or
without modification, are permitted provided that the following
conditions are met:

    1. Redistributions of source code must retain the above
       copyright notice, this list of conditions and the
       following disclaimer.

    2. Redistributions in binary form must reproduce the above
       copyright notice, this list of conditions and the
       following disclaimer in the documentation and/or other
       materials provided with the distribution.

    3. Neither the name of the copyright holder nor the names of
       its contributors may be used to endorse or promote
       products derived from this software without specific
       prior written permission.

    THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
THE POSSIBILITY OF SUCH DAMAGE.


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