Расширения файлов TR-DOS

A

Описание формата TASM 3.

Строка — байт с длиной строки, содержимое строки (возможно, пустое), байт с длиной строки. Под длиной строки имеется в виду именно длина того содержимого строки, которое хранится в файле, а не количество символов в текстовом представлении строки. Конец текста — два байта #FF.

В содержимом строки пара байтов #0A, x соответствует x пробелам, байты #20—#7F — коды соответствующих ASCII-символов, байты #80—#E6 — коды токенов.

Список токенов (символом «_» для удобства обозначен пробел): A, ADC_, ADD_, AF', AF, AND_, B, BC, BIT_, C, CALL_, CCF, CP_, CPD, CPDR, CPI, CPIR, CPL, D, DAA, DE, DEC_, DEFB_, DEFM_, DEFS_, DEFW_, DI, PHASE_, DJNZ_, E, EI, UNPHASE, EQU_, EX_, EXX, H, HALT, HL, I, IM_, IN_, INC_, IND, INDR, INI, INIR, IX, IY, JP_, JR_, L, LD_, LDD, LDDR, LDI, LDIR, M, NC, NEG, NOP, NV, NZ, OR_, ORG_, OTDR, OTIR, OUT_, OUTD, OUTI, P, PE, PO, POP_, PUSH_, R, RES_, RET, RETI, RETN, RL_, RLA, RLC_, RLCA, RLD, RR_, RRA, RRC_, RRCA, RRD, RST_, SBC_, SCF, SET_, SLA_, SP, SRA_, SRL_, SUB_, V, XOR_, Z, INCLUDE_, INCBIN_.

Описание формата TASM 4 (by XLD).

Формат отличается от формата TASM 3 (см. выше) лишь тем, что добавлено 10 новых токенов, кодируемых байтами #E7—#F0: SLI_, INF, LX, HX, LY, HY, DB_, DM_, DS_, DW_.

Описание формата TASM 4 (by RST7).

Формат похож на формат TASM 3 (см. выше). Отличия следующие: в содержимом строки пара байтов 1, x соответствует x пробелам, а байты 2—31 обозначают соответственно от 2 до 31 пробелов. В списке токенов вместо DEFM_ — DEFMAC_, вместо PHASE_ — DISPLAY_, вместо UNPHASE — ENDMAC.

Описание формата GENS.

Формат похож на текстовый, только в первых двух байтах каждой строки хранится её номер (младший байт хранится первым). Номера упорядочены по возрастанию и не могут быть больше 32767. Каждая строка заканчивается байтом 13.

Пустая строка — байт 0. Непустая строка — байт с длиной строки, содержимое строки, байт с длиной строки. Под длиной строки имеется в виду именно длина того содержимого строки, которое хранится в файле, а не количество символов в текстовом представлении строки. Конец текста — байт #FF.

В содержимом строки пара байтов #0A, x соответствует x пробелам, байты #20—#7F — коды соответствующих ASCII-символов, байты #80—#F6 — коды токенов.

Байты #60—#7F могут также интерпретироваться как коды русских букв: Ю, А, Б, Ц, Д, Е, Ф, Г, Х, И, Й, К, Л, М, Н, О, П, Я, Р, С, Т, У, Ж, В, Ь, Ы, З, Ш, Э, Щ, Ч, Ъ.

Список токенов (символом «_» для удобства обозначен пробел): A, B, C, D, E, H, L, I, R, XH, XL, YH, YL, IX, IY, AF', AF, HL, DE, BC, M, NC, NV, NZ, P, PE, PO, V, Z, SP, {_, ORG_, PHASE_, UNPHASE, AND_, ADC_, SBC_, ADD_, SUB_, XOR_, OR_, CP_, LD_, IM_, RST_, EI, DI, EXX, EXA, INF, LDIR, LDDR, OTIR, OTDR, OUTI, OUTD, RETI, RETN, INIR, INDR, CPIR, CPDR, NEG, CPD, CPI, IND, INI, LDD, LDI, CCF, CPL, DAA, HALT, NOP, RLA, RLCA, RRA, RRCA, SCF, RLD, RRD, EX_, RET, CALL_, JP_, PUSH_, POP_, INC_, DEC_, OUT_, IN_, DJNZ_, JR_, BIT_, RLC_, RRC_, RL_, RR_, SLA_, SRA_, SLI_, SRL_, RES_, SET_, EQU_, BEGIN_, END, INCBIN_, INCLUDE_, DB_, DEFB_, DEFS_, DEFW_, DS_, DW_, DOWN_, UP_, SYSTEM, STOPKEY.

B

C

D

E

F

G

H

См. документацию к архиватору HRIP (там описана структура архива и приведены исходные тексты процедур упаковки и распаковки). Эту документацию можно найти, например, на сайте http://zxdocs.fatal.ru, в разделе «Formats» (архив «HRIP.zip»).

Замечу, что в документации (файл «HRIP_DOC.WRD» из комплекта поставки HRIP 1.05) приводится следующая формула для вычисления длины архива в байтах без учёта каталога:

END_ARCH=[LAST]*256–(256–[SMESH]).

В действительности же она должна выглядеть так:

END_ARCH=[LAST]*256–(256–[SMESH]), если [SMESH]>0;

END_ARCH=[LAST]*256, если [SMESH]=0.

Или так:

END_ARCH=[LAST–1]*256+[SMESH], если [SMESH]>0;

END_ARCH=[LAST]*256, если [SMESH]=0.

Без ветвления эта формула может быть записана так:

END_ARCH=[LAST]*256–((256–[SMESH]) mod 256).

О формате собственно упакованных данных — см. расширение «p», пункт 1 (в HRIP используется такой же метод сжатия, как в HRUST 2.1, отличие только в формате заголовка упакованного блока).

I

J

K

L

M

N

O

P

Q

R

Также с официального сайта (www.rarlab.com) можно скачать исходные тексты распаковщика на C++. А в комплект поставки спектрумовского UNRAR’а входят исходные тексты распаковщика на ассемблере Z80.

S

T

U

V

W

X

Y

Z

Формат похож на текстовый. Отличие в том, что байт 6, за которым следует байт x, обозначает x–#80 пробелов, а один из байтов 2, 3, 4, 5, за которым следует байт x, обозначает токен с номером x–#20 (если нумеровать токены с 0), причём от значения байта перед x зависит способ вывода этого токена: если байт равен 2 или 4 (т.е. 0-й бит сброшен), токен выводится строчными буквами, а если 3 или 5 (т.е. 0-й бит установлен) — прописными; если байт равен 4 или 5 (т.е. 1-й бит сброшен), токен выводится с пробелом после него, а если 2 или 3 (т.е. 1-й бит установлен) — без пробела.

Список токенов: LD, EX, IM, RST, RET, ADD, ADC, SUB, SBC, AND, XOR, OR, CP, PUSH, POP, INC, DEC, IN, OUT, JP, CALL, JR, DJNZ, RLC, RRC, RL, RR, SLA, SRA, SLI, SRL, BIT, RES, SET, NOP, HALT, DI, EI, RLCA, RLA, RRCA, RRA, EXX, DAA, CPL, CCF, SCF, LDI, LDIR, LDD, LDDR, CPI, CPIR, CPD, CPDR, NEG, INF, INI, INIR, IND, INDR, OUTI, OTIR, OUTD, OTDR, RETI, RETN, RLD, RRD, ORG, EQU, DB, DW, DS, DEFB, DEFW, DEFS, INSERT, INCLUDE, IF, IFDEF, IFNDEF, IFUSED, IFNUSED, ELSE, ENDIF, MAKE, B, C, D, E, H, L, (HL), A, XH, XL, YH, YL, (IX, (IY, (BC), (DE), I, R, AF, BC, DE, HL, IX, IY, SP, (SP), AF', (C), NZ, Z, NC, C, PO, PE, P, M, PHASE, UNPHASE, DC, ENT, REPEAT, ENDR, LOADTAB, MACRO, ENDM, CREATE, MAKELAB, SAVEOBJ, EXITM, IFP, EXA, RETZ, RETNZ, RETC, RETNC, RETM, RETP, RETPO, RETPE, JPZ, JPNZ, JPC, JPNC, JPM, JPP, JPPO, JPPE, CALLZ, CALLC, CALLM, CALLPE, CALLNZ, CALLNC, CALLP, CALLPO, JRZ, JRNZ, JRC, JRNC.