Адаптация игровых программ системы TR-DOS к профессиональной системе iS-DOS

© Михаил Головин тел. (095) 148-50-04, ноябрь 1993 года.

Летом 1993 года на рынке программных средств машин класса ZX появилась качественно новая профессиональная дисковая операционная система iS-DOS. Удобный интерфейс, многокаталоговая файловая система, наличие контекстно-зависимой подсказки и многооконный интерфейс делают эту систему приятной и удобной в повседневной работе.

Несмотря на наличие программ, разработанных и поставляемых с iS-DOS, многие интересующие нас программные средства пока работают только под управлением TR-DOS. Примером таких программ могут служить наборы игрушек, которые есть почти у каждого пользователя. В связи с тем, что диски, работающие в TR-DOS, имеют другую логическую и физическую структуру, чем в iS-DOS, может возникнуть ряд проблем при переносе игр из TR-DOS в iS-DOS. Решить их Вам поможет программа-загрузчик игровых программ TR-DOS, описанная в данной статье (Листинг приведен ниже).

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

Зададимся вопросом: "Как можно адаптировать игры или другие полезные программы к iS-DOS?" Существуют два решения этой проблемы. Первое: Адаптация с помощью средств iS-DOS. Второе: Написать свой собственный загрузчик. В данной статье будут рассмотрены оба варианта.

Многие могут спросить: "А зачем нужна вся эта кутерьма?! Мы и в TR-DOS неплохо играем и работаем." На этот вопрос можно ответить так. iS-DOS многокаталоговая файловая система и каждая игрушка может иметь свой каталог и хранить там свои служебные файлы. Они никогда не перепутаются, как это частенько бывает в TR-DOS. И надо выбрать для себя что лучше: куча дисков одни в TR-DOS, другие в iS-DOS или все диски под одной системой. Надо наводить порядок.

Итак, первый способ адаптации - это адаптация с помощью средств iS-DOS, называемых CDPACKER.COM, NMIPACK.COM, SPACKER.COM. Первый позволяет паковать и делать запускаемыми файлы типа CODE, второй нужен для упаковки MAGIC файлов, а третий для упаковки картинок. Созданные с помощью упаковщиков файлы можно запустить из iS-DOS применив программу EXEPACK.COM и EXESCR.COM соответственно. Как пользоваться всеми перечисленными файлами можно прочесть в системном руководстве к ним (в help файлах).

У этого способа на первый взгляд нет никаких недостатков. Но как только вы начнете его применять на практике к хорошим игрушкам, которые почти не пакуются, вы получите сообщение системы о том, что ей не хватает памяти для работы (распаковки), и Вы ничего с этим сделать не сможете. И напоследок, когда я пробовал использовать CDPACKER.COM, мной была замечена некорректная работа со стеком, в итоге игрушки просто отказывались работать, повисали или просто сбрасывались. Эти и другие причины привели к тому, что в итоге пришлось написать свой собственный загрузчик лишенный многих этих недостатков.

Итак, способ второй.

Используем специально написанный загрузчик (смотри листинг). Чтобы понять работу Game Loader^) нужно разобраться с физической и логической структурой диска, работающего под iS-DOS. С физической точки зрения диски под iS-DOS бывают двух видов: отформатированные под TR-DOS (не загружаемые) и отформатированные под iS-DOS (загружаемые). Первые имеют на каждой дорожке 16 секторов по 256 байт на сектор, а вторые 5 секторов по 1024 байта соответственно (это позволяет сделать их автозагружаемыми). С логической точки зрения все диски это устройства с одинаковой структурой: блоками данных по 256 байт, количество которых записано в заголовке устройства (на диске). Система сама производит при своей работе необходимые пересчеты и поэтому для пользователя этот процесс является прозрачным (не видимым). Многие игрушки для запуска требуют порой почти всю доступную основную память, поэтому все необходимые расчеты должен производить сам загрузчик, так как во

время его работы система iS-DOS из памяти полностью выгружается.

Теперь рассмотрим листинг программы. В качестве средства программирования избран Zeus Assembler (версия входящая в PHT 3.6), позволяющий переустанавливать несколько раз адрес начала ассемблирования директивой ORG и компилирующий прямо на диск с помощью директивы OPEN. Это дало возможность совместить две части загрузчика: Интерфейсную (0110 - 1520) и Основную (1530 - 2670) в одной программе, не требующей настройки адресов последней. Первая часть программы производит настройку второй (системные параметры диска), вторая часть и является собственно загрузчиком.

Строка 0140 содержит имя файла данных (картинка + блок кодов), который будет загружен (о создании этого файла смотри далее).

Строки 0160-0240 и 0260-0310 содержат текст, который появляется при загрузке или ошибке.

Строки 0360-0550 выводят окно с поясняющей надписью на экран, перемещают Основную Часть в буфер принтера (#5B00), вызывают подпрограмму инициализации системных переменных, устанавливает Первый Режим Прерываний и стандартный обработчик сообщений об ошибках (для корректной работы TR-DOS), устанавливает верхнюю границу стека (из расчета Адрес Загрузки Кодов минус 256*3) и передает управление Основной Части (перемещенной уже в буфер принтера: #5B00).

Строки 0590-1120: подпрограмма инициализации системных переменных. Читается заголовок текущего устройства, по соответствующим смещениям определяются и инициализируются Размер Сектора, Количество Секторов на треке, Данные о Секторах на треке Основной Части. Затем производится поиск файла, имя которого записано по адресу FNAME, определяется Номер Блока Описателя Сегмента, Атрибут Состояния Файла и если файл не сегментирован, то Номер Блока Описателя Сегмента будет номером первого блока данных файла (он записывается в переменную FDISP). Если файл сегментирован то читается Блок Описателя Сегмента и проверяется количество сегментов у файла. Если их больше одного, то совершается переход на подпрограмму обработки ошибок (ERROR), иначе номер первого сегмента (блока данных файла) заносится в переменную FDISP. Сбрасывается флаг ошибок (C=0) в регистре флагов, и происходит возврат в основную программу.

Строки 1160-1350: подпрограмма обработки ошибок. Выводит окно с сообщением об ошибке, "бибикает" и выходит в систему.

Строки 1390-1520: подпрограмма звукового сигнала. Формирует звуковой сигнал, с миганием рамки. Затем происходит возврат в вызывающую программу.

Строки 1509-1680 загружают картинку, вызывают распаковщик, загружают блок кодов и передают ему управление.

Строки 1740-2330: подпрограмма чтения секторов. Вызывается подпрограмма преобразования Номера Первого Сегмента в Трек, Сектор, Смещение в секторе (нужно для секторов размером 1024 байта). Изменяется переменная FDISP, чтобы она указывала на следующий блок данных (для этого файл данных должен быть непрерывным). Если Смещение не нулевое, то адрес загрузки файла корректируется соответствующим образом. Это накладывает небольшое ограничение: перед файлом и после него в памяти должно быть пустое (не используемое) место, в котором НЕЛЬЗЯ ни чего располагать, так как оно может использоваться при загрузке. Затем производятся необходимые расчеты для переменных Трек, Сектор. Происходит вызов TR-DOS и загрузка кода данных. Далее берется следующий сектор, если он выходит за пределы трека, то берется следующий трек. И так до тех пор, пока не загрузится нужное количество секторов.

Строки 2350-2650: подпрограмма дешифрации номера блока в номера Трека, Сектора, Смещения.

Строка 2670 содержит Данные о Секторах на Треке (номера секторов).

Что мы должны сделать, чтобы наша программа заработала?

Пусть у нас есть заархивированый файл-картинка SCREEN.CODE 32768,4800 разархивирующийся по команде RANDOMIZE USR 32768 и файл игрушка GAME.CODE 26000,30000 запускаемый командой RANDOMIZE USR 26000. Теперь из этих двух файлов нужно создать один файл данных, назовем его gamefile.dat. Создается он посредством склейки SCREEN и GAME, длина каждого из них должна быть кратной 256 байт. Файлы склеиваются в памяти или прямо на TR-DOS диске. Они записываются друг за другом и у первого файла в директории изменяется количество занимаемое им секторов на суммарное для обоих файлов, также изменяется слово длины файла (оно должно быть кратно 256 байт) , затем первый файл копируется на другой диск или сразу же в iS-DOS.

ВНИМАНИЕ!!!

На том диске, где вы изменяли параметры файла, вы должны восстановить исходное значение количества секторов и слово длины первого файла. Для этих целей можно использовать функции PHT 3.6: записи и восстановления каталога на 80 треке.

Некоторые дисковые мониторы позволяют проделывать операцию склейки автоматически.

Итак файл данных создан. Далее вносим изменения в листинг (строки 0140: вместо <ИМЯ ФАЙЛА ДАННЫ1Х> пишем gamefiledat (без точки !), 0540: <ВЕРШИНА СТЕКА>=26000-256*3 (рассчитать самим), 1610: < ДЛИНА КАРТИНКИ>=19 (блоков по 256 байт), 1620: <АДРЕС ЗАГРУЗКИ>=32768, 1640: <АДРЕС РАЗ АРХИВ АТОР А>=32768, 1650: < ДЛИНА ИГРУШКИ>=118 (блоков по 256 байт), 1660:<АДРЕС ЗАГРУЗКИ>=26000, 1680: <СТАРТОВЫЙ АДРЕС>=26000.

Ассемблируем получившийся листинг в .com файл, переносим в iS-DOS не забыв исправить с помощью команды rename (iS-DOS) или аналогичной команды PHT 3.6 стартовый адрес на тот, который указан в строке 0080, перенося в этот же каталог файл данных, получим экземпляр игрушки загружающейся в iS-DOS.

Примечания.

1. Обращение к системным функциям iS-DOS происходит через RST #10. Код вызываемой функции помещается в регистр C, остальные регистры инициализируются по мере необходимости. При возврате обычно используется альтернативный набор регистров. Если возникает ошибка, то флаг C в регистре флагов устанавливается, иначе сбрасывается.

2. Длинные файлы (более 127 блоков) при копировании получаются всегда сегментированными. Если они копируются из TR-DOS посредством from_trd.com или при помощи модифицированной мной программы filecopy.com с ключом /l, то этого можно избежать.

3. Следует помнить, что при копировании файлов в iS-DOS учитывается не сколько он занимает блоков, а его реальная длина. Так если файл занимает 10 блоков и имеет длину 1 байт, то в iS-DOS скопируется только этот байт.

Листинг программы-загрузчика игровых программ TR-DOS. iS-DOS Utility: Game Loader v1.00 25-Nov-1993 (C) by M.Helloween

Zeus Assembler ( PHT v3.6 )

Адрес загрузки .com файла: #5DC0 (24000)

#5DC0 START

Данные о .dat файле и тело "Интерфейсной Части"

"Имя .dat Файла"

"Текст Заставки"

&

Game Adaptation"

M.Helloween"

"Текст Ошибки"

# 0D, # 0D,

"Файл Данных должен быть'

# 0D,

" НЕПРЕРЫВНЫМ"

#03

"Вектор Окна"

; Адрес " Вектора Окна "

;Код: "Вывод Окна"

;Адрес "Текста Заставки" ;Код: "Печать Текста (HL)

Окне"

'Основную Часть"

буфер принтера Инициализировать системные переменные

Режим Прерываний стандартный обра

ботчик сообщений об ошибках

LD SP,<ВЕРШИНА CTEKA>

JP _GAM_

;

;Инициализация системных переменных ^;

INITS LD C,#06

DE,#0000 #10

C

BC,00024 HL,BC A,(HL) (SSIZE),A HL

A,(HL) (QSECT),A

BC,00039 HL, BC DE,STBUF

bc,#0010

HL,FNAME

C, #34 #10

C

HL

BC,#0011 HL, BC E,(HL) HL

D,(HL) HL

BC,00011 HL, BC A,(HL) #40

NZ, NEXT9 C, #06

0970 0980 0990

1000 RST #10

1010 EXX

1020 LD A, (HL)

1030 DEC A

104 0 JP NZ,ERROR

1050 INC HL

1060 LD E, (HL)

1070 INC HL

1080 LD D, (HL)

1090

1100 NEXT 9 LD (FDISP) ,DE

1110 XOR A

1120 RET

1130 ;

114 0 ;Ошибка: Файл сегментирован

1150 ;

1160 ERROR LD IX,V_WND

;Переход на "Основную Часть"

;Код: "Загружает Блок (DE) ;текущего устройства и возвращает ;его адрес в регистровой паре HL"

;Инициализация "Размера Сектора'

;Инициализация "Колличества ;Секторов на Треке"

;Инициализация "Данных ;о Секторах на Треке" ;Адрес "Имени .dat Файла" ;Код:"Поиск и Открытие Файла"

;DE= Номер Блока Описателя Сегмента

; Атрибут Состояния Файла

; Переход, если Файл не ; Сегментирован ; Код: "Загружает Блок (DE) ; текущего устройства и возвращает ;его адрес в регистровой паре HL"

; Переход, если Файл Сегментирован

;DE = Номер Блока первого сегмента, ; если Файл Данных ОдноСегментен

; Сбросить Флаг Ошибок

; Адрес " Вектора Окна "

;сегмента

;Адрес Переменой "Смещение"

;Адрес Переменной "Трека"

;Адрес Переменной "Сектора'

;HL = Адрес "Данных ;о Секторах на Треке"

Код: "Считать Один Сектор

в TR-DOS" Системный вызов TR-DOS

;A = Размер Сектора

;A = Номер Сектора

;Адрес "Переменной Количество ; Секторов"

;A = Номер Трека

;A = Размер Сектора

;Начальная установка переменных: "Сектора и Трека"

;A = Номер Сектора

;HL = Адрес Переменной ;"Количество Секторов"

;A = Номер Трека

;A = Смещение в секторе

1. От редакции. - С "Новым Годом", с новым счастьем и с новым журналом Вас поздравляет "ИНФОРКОМ".
2. Дискуссия по просьбе читателей - ZX vs PC.
3. Страничка iS-DOS - Краткий курс истории iS-DOS.
4. Страничка iS-DOS - Адаптация игровых программ системы TR-DOS к профессиональной системе iS-DOS.
5. "WHAM" The Music Box - Версия для музыкального сопроцессора AY-3-8910/12.
6. Читатель - читателю - Бегущая строка является важным элементом оформления программ.
7. Читатель - читателю - Предлагаю Вашему вниманию мою программу Memory Editor.
8. Секреты TR-DOS - Некоторые вопросы адаптации ассемблера GENS4.
9. Форум - У меня вопрос к экспертам: кто-нибудь пытался разобраться с программой "MAGNETRON" ("QUAZATRON II")? Непонятно, что делать с реакторами и как уничтожить роботов неправильной формы, стреляющих черными шарами.
10. К вопросу о дистрибуции программного обеспечения. - Пишем к Вам с последней надеждой что-то изменить. Честно говоря, уже не верится, что кто-то нас поймет.
11. Возвращаясь к напечатанному - Несколько замечаний по статье "Компьютеры, которые мы выбираем" (ZX-РЕВЮ-93 № 5-6, стр.119).
12. Ролевые игры - эволюция жанра.
13. Adventure games - Многочисленные опросы общественного мнения показывают, что если впервые два года работы пользователи редко отдают предпочтение этому жанру, то уже после третьего года эти игры вместе со стратегическими становятся основными.
14. Советы эксперта - описание игры NARCOPOL.
15. Авторская программа - системные программы, игровые программы, утилиты, заявки.
16. Итоги "ТЕНДЕРА" - Закрытый аукцион (ТЕНДЕР) на право дистрибуции PC-REVIEW, о котором мы так много писали в ZX РЕВЮ № 7-8 за 1993 г. завершился 15 декабря 1993 года!
17. Презентация - Независимая компания MAD & SHISOFT представляет новый электронный журнал для обладателей компьютера ZX-Spectram с дисководом - Spectrofon.