BestView: bv2.0doc.W

Является частью релиза: BestView
Размер файла: 11177
md5: 8818206dc4319f61cbed3459b9141413
┌───────────────────────────────────────────────-------- - - -
│
│  ██████▄                 ██    ██    ██                      |
│  ██   ██ ▄█████▄ ▄█████  ██    ▐█▌  ▐█▌ ██ ▄█████▄ ██    ██  |
│  ██▄▄▄█▀ ██   ██ ██     ████    ██  ██  ▄▄ ██   ██ ██ ██ ██  |
│  ██▀▀▀█▄ ██████▀ ▀█████▄ ██     ▐█▌▐█▌  ██ ██████▀ ██ ██ ██  │
│  ██   ██ ██           ██ ██      ████   ██ ██      ██ ██ ██  │
|  ██████▀ ▀█████▌ ██████▀ ▀████   ▐██▌   ██ ▀█████▌ ▀██▀▀██▀  │
|                          ──┐   ┌──┐                          │
|                         ┌──┘   │  │                          │
                          └─── - └──┘                          │
  - - - ---------──────────────────────────────────────────────┘

               (c) Иван Рощин, Москва, 26.07.1998


 1. Что это такое?
 ─────────────────  

    BestView - свободно распространяемая  программа, с  помощью 
 которой Вы можете просматривать текстовые, графические и шриф-
 товые файлы, тексты в  формате  ассемблеров  GENS, PASM, TASM,
 MASM, ZX ASM, ALASM и XAS, а также просматривать дампы  файлов
 и прослушивать откомпилированные музыкальные модули  в формате
 редакторов SOUND TRACKER, S.T.PRO, SUPER SONIC, ASC SOUND MAS-
 TER и PRO TRACKER.  Для работы BestView необходимо наличие  не 
 менее 128 килобайт ОЗУ и TR-DOS версии 5.03 или выше.
    Ваши пожелания и предложения по улучшению BestView Вы може-
 те сообщить по следующим адресам:
               
                     Fido: 2:5020/689.53
                   E-mail: asder@softhome.net


 2. Отличия версии 2.0 от версии 1.0
 ─────────────────────────────────── 

 - улучшен используемый шрифт;
 - добавлено управление от SINCLAIR II;
 - повышена скорость работы с диском и улучшено автоопределение
   смены диска;
 - в любой момент можно вызвать screen saver с помощью 'CS+S';
 - при просмотре текста или списка файлов можно быстро перейти 
   в начало или конец с помощью 'SS+O' и 'SS+P';
 - для просмотра доступны все файлы, а не только 'C' и 'W';
 - можно посмотреть дамп файла с помощью 'CS+ENTER';
 - увеличен размер буфера для просмотра файлов;
 - кроме файлов ZX ASM 3.0, распознаются файлы в форматах GENS,
   TASM, MASM, ZX ASM 3.10, ALASM и XAS;
 - добавлена возможность прослушивания откомпилированных музы-
   кальных модулей;
 - можно просматривать текстовые файлы с кодом перевода строки
   #0A;    	
 - при просмотре текстовых файлов не показывается последний
   символ (#03 - конец файла), если он есть;
 - можно просматривать экраны, содержащиеся в @-файлах;
 - можно просматривать ч/б экранные файлы и спрайты (длиной
   #1800 байт).


 3. Управляющие клавиши
 ──────────────────────

 а) при выборе файла:

    R - перечитать каталог диска. Вообще-то, BestView следит за
 сменой диска автоматически, так что, возможно, Вам  никогда  и
 не придется воспользоваться этой клавишей.
    QAOP,SXOP,SINCLAIR II,CURSOR,TR.V,INV.V - перемещение  кур-
 сора. 
    SS+O,SS+P - быстро перейти в начало или конец  списка  фай-
 лов.
    0,ENTER - просмотр файла.
    CS+ENTER - просмотр дампа файла.

 б) при просмотре текста или дампа:

    QAOP,SXOP,SINCLAIR II,CURSOR,TR.V,INV.V  -  перемещение  по
 тексту. Естественно, скроллинг "укладывается в прерывание".
    SS+O,SS+P - быстро перейти в начало или конец текста.
    0,ENTER,SPACE,EDIT,E,BREAK - окончание просмотра.
    
    Если в течение минуты не нажимать на клавиши, автоматически
 запускается screen saver.  Его можно запустить и вручную, если
 нажать 'CS+S'.

 
 4. Особенности работы с диском
 ──────────────────────────────

    BestView работает с тем дисководом, с которого был запущен,
 и автоматически отслеживает смену диска.  Так как используется 
 прямой доступ к ВГ93, программа не будет работать с  винчесте-
 ром. Впрочем, если это кому-нибудь нужно, в следующей версии я 
 могу сделать возможность выбора: с каким устройством (A-D) как
 работать (с помощью ВГ93 или через #3D13).
    BestView игнорирует ошибки чтения с диска, при этом  сигна-
 лизирует об ошибке, устанавливая желтый border.


 5. Как распознаются и просматриваются файлы различных типов
 ───────────────────────────────────────────────────────────

 5.1. Просмотр дампа файла
 ─────────────────────────

    Просмотреть дамп выбранного файла можно с помощью  комбина-
 ции клавиш 'CS+ENTER'.  Если файл длиннее 7856 байт, показыва-
 ются только первые 7856 байт.

 5.2. Текстовые файлы
 ────────────────────

    Текстовым файлом считается любой файл, не относящийся к ка-
 кому-либо другому формату. Строки могут заканчиваться символа-
 ми '#0D','#0A' или '#0D,#0A'. Если файл заканчивается символом
 #03, на экране этот символ не отображается.
    Если файл  длиннее  31486  байт, загружаются  первые  31486 
 байт.  Строки длиннее 64 символов будут обрезаны.  Общее число 
 строк не должно превышать #4000 - остальные  просто  не  будут 
 показаны.

 5.3. Графические файлы
 ──────────────────────

    BestView позволяет просматривать два типа графических  фай-
 лов: экран длиной 6912 байт и ч/б спрайт  (или экран без атри-
 бутов) длиной 6144 байта  (при его просмотре можно выбрать ре-
 жим  экран/спрайт  с помощью 'S' и инвертировать изображение с 
 помощью 'X').

 5.4. Шрифты
 ───────────

    Шрифтом считается файл длиной 768 байт. Его содержимое про-
 сто выводится в правом окне.

 5.5. Откомпилированные музыкальные модули
 ─────────────────────────────────────────

    С помощью BestView Вы можете прослушивать откомпилированные
 музыкальные модули  в формате  редакторов  SOUND TRACKER, S.T.
 PRO, SUPER SONIC, ASC SOUND MASTER и PRO TRACKER (см.таблицу). 
 При этом, если модуль со встроенным player'om, на экран  выво-
 дятся адреса подпрограмм инициализации (INIT)  и  проигрывания 
 (PLAY) в шестнадцатеричном и десятичном виде.

 ┌──────────┬──────────────────┬─────────────┬────────────────┐
 │          │ версия редактора │             │                │
 │ редактор │ или название     │ with player │ without player │
 │          │ компилятора      │             │                │
 ├──────────┼──────────────────┼─────────────┼────────────────┤
 │SOUND     │v1.3              │      +      │        +       │
 │TRACKER   ├──────────────────┼─────────────┼────────────────┤
 │          │v3.0              │      +      │                │
 │          ├──────────────────┼─────────────┼────────────────┤
 │          │S.T.SONG COMPILER │      +      │        +       │
 │          │v1.2              │             │                │
 │          ├──────────────────┼─────────────┼────────────────┤
 │          │S.T.MUSIC'S       │      +      │                │
 │          │RECOMPILER v2.1   │             │                │
 │          ├──────────────────┼─────────────┼────────────────┤
 │          │PROCOMPILER v2.02 │      +      │                │
 ├──────────┼──────────────────┼─────────────┼────────────────┤
 │ASC SOUND │v0.12-1.12        │      +      │                │
 │MASTER    │                  │             │                │
 ├──────────┼──────────────────┼─────────────┼────────────────┤
 │SUPER     │v1.20             │      +      │                │
 │SONIC     │                  │             │                │
 ├──────────┼──────────────────┼─────────────┼────────────────┤
 │PRO       │v2.1,2.4,2.9      │      +      │        +       │
 │TRACKER   │                  │             │                │
 ├──────────┴──────────────────┼─────────────┼────────────────┤
 │SOUND                        │             │                │
 │TRACKER                      │      +      │                │
 │PRO                          │             │                │
 └─────────────────────────────┴─────────────┴────────────────┘

    Стартовый адрес откомпилированных модулей с player'ом (кро-
 ме модулей, созданных с помощью S.T.SONG COMPILER) должен быть
 не меньше 34049. Длина модулей без player'а должна быть не бо-
 лее 16 килобайт. 
    BestView может проигрывать файлы PRO TRACKER'а с расширени-
 ем 'M'. Дело в том, что PRO TRACKER при записи на диск автома-
 тически компилирует мелодию, а при  чтении - декомпилирует.  И 
 такие файлы распознаются, как откомпилированные без player'а.
    Кстати, есть две версии PRO TRACKER'а  с одинаковым номером
 2.4, но различающиеся player'ами, которые добавляются к отком-
 пилированному модулю. У одного player'а точка входа для вызова
 раз в прерывание находится  по смещению  5, а  у  другого - по 
 смещению 6. BestView поддерживает и тот, и другой формат.


 5.6. Тексты программ в формате различных ассемблеров
 ────────────────────────────────────────────────────

 5.6.1. GENS
 ─────────── 
    
    Файл в формате GENS отличается от обычного текстового файла
 тем, что первые два байта каждой строки содержат ее номер. Но-
 мера упорядочены по возрастанию и не могут быть больше  32767.
 При выводе текстового файла  BestView проверяет его на принад-
 лежность GENS'у и, если это так, преобразует его. 
 
 5.6.2. PASM
 ───────────

    Формат PASM (Power Assembler) версий 2.3 и 3.0 не отличает-
 ся от обычного текста, а потому никакой перекодировки не  про-
 исходит.

 5.6.3. TASM
 ───────────

    Все версии  TASM'а  не рассчитаны на использование в тексте
 русских букв. Поэтому обычно вместе с TASM'ом используют изме-
 ненный шрифт, в котором на месте малых латинских букв находят-
 ся русские.  При просмотре TASM'овских файлов BestView ищет на
 диске шрифтовой файл 'TASM.FNT' или 'RUS.FNT', и если он есть, 
 использует его при выводе текста.
    Файлы TASM 2 распознаются по типу 'C' и  стартовому  адресу
 38750.  Файлы TASM 3: тип 'A', start=39221.  Файлы TASM 4  (by
 XLD): тип 'A', start=40872. Файлы TASM 4 (by RST7): тип 'A', а 
 стартовый адрес - это на самом деле  номер строки, на  которой
 находится курсор при редактировании текста (считается, что но-
 мер строки не может быть больше 4096). 

 5.6.4. MASM
 ───────────

    Файлы MASM 1.1 распознаются по типу 'a' и стартовому адресу
 38667. При их просмотре можно клавишей 'F' переключать отобра-
 жение символов с кодами  #60-#7F  (латинские прописные/русские 
 заглавные буквы).

 5.6.5. ZX ASM
 ─────────────

    Файлы ZX ASM 3.0 распознаются по типу 'C' и стартовому  ад-
 ресу 35151.  Файлы ZX ASM 3.10 распознаются по трехсимвольному
 расширению 'C  ', 'asm' или 'txt'  (трехсимвольное  расширение
 состоит из байта 'тип файла' и двух байтов, в  которых  обычно
 указывается стартовый адрес). 
    Из-за очень удобного  редактора  ZX ASM  часто  применяется 
 просто для набора текстов. Поэтому перед тем, как начать пере-
 кодирование ZX ASM'овского файла, производится проверка на не-
 обходимость этого перекодирования.

 5.6.6. ALASM
 ────────────

    Файлы  ALASM 2.8-4.1  распознаются  по  типу  'H', нулевому
 стартовому адресу и наличию в файле символа 'H' по смещению 8.
    
 5.6.7. XAS
 ──────────

    Файлы XAS распознаются по трехсимвольному расширению  'XAS'
 (регистр букв неважен).

                           *   *   *