Просмотр файла

* Автоопределение формата - в связи с тем что файлы Агат\Apple это просто поток данных без специальных сигнатур, автоопределение формата в некоторых случаях невозможно. Однозначно будут распознаны только файлы типа Т, А и картинки стандартного размера, с остальными могут быть варианты. Поэтому надежней принудительно задать формат.

* Как есть HEX - будет показано содержимое ВСЕХ секторов составляющих файл. Ведь файл только в ОЗУ может читаться с точностью до байта, а на диске хранится кратно сектору. Будут видны лишние (неиспользуемые) байты в конце последнего сектора и смещение будет неправильное (нулевое).
Используется в том случае, если не получилось просмотреть файл другими средствами, либо он повреждён, или указан неверный тип. Например, нашелся какой-то брошенный файл на диске без имени, чтобы узнать что там на самом деле внутри, вот и смотрим его "как есть hex", если угадали что там, и это не мусор, переименовываем (меняя тип) и тогда, может быть, он станет нормально смотрется по F3 (автомат определения формата dos33c2 сперва смотрит тип файла, только после этого проверяет всё остальное. Поэтому если тип файла неправильно задан, то F3 не будет правильно работать).

* B-формат как HEX - покажет содержимое файла так, как оно будет размещено в реальной памяти Агата. В т.ч. можно увидеть файл с видеоозу в формате HEX. При просомтре можно нажать enter для дизассемблирования и сохранить это в текстовый файл по F2.

* K-формат как HEX - у файлов типа К размер и длина сидят в TSList (4 байт в начале у таких нет), а смысл действий тот же что и с В файлом.

* Integer Basic - формат I раннего бейсика у семейства Apple][.

* Basic - формат A всех бейсиков: AppleSoft Basic, Агат-Бейсик, Сириус-Бейсик, Мастер-Бейсик, Bio-Бейсик. Дополнительно показывает таблицы длинных переменных, служебные комментарии. Делает переводы строк после ":", форматированные отступы (чтобы номер строки был отдельной колонкой, в весь текст справа), рядом с номером строки выводится смещение строки в файле (это удобно, когда нужно отличия или испорченные участки искать). При сохранении по F2 все это окажется в текстовом файле, поэтому для получения чистого текста программы лучше пользоваться функцией ЭКСПОРТ.

* Обычный текст - просмотр файлов типа Т, это большинство текстов, программы на Рапире и прочее.

* Текст Apple][ - формат текстовых файлов (тип Т) семейства Apple][ (кодировка отличается от подобной у Агат).

Сравнение объектов

* Сравнение двух файлов (автотип) - в зависимости от типа файла (В или Т) под курсором, автоматически переходит в режим побайтно или построчно соответственно. Это просто чтобы одной кнопкой вызывать разные действия.

* Сравнение двух файлов (побайтно) - программа может сравнивать только два явно указанных файла. Ставим курсор на два файла - справа и слева, потом Shift-F7 (когда курсор уходит с активной панели, чтобы было видно, что выделено, перед именем файла остаётся '+'). В результате сравнения, показываются смещения от 0 в которых есть различия. Адреса для конкретного случая найти не сложно, для B-программы, например, это: адрес = базовый оффсет + смещение - 4 Базовый офсет можно узнать из информации по файлу, в графе "Точка загрузки".

* Сравнение двух файлов (построчно) - используется для сравнения текстовых файлов (тип Т). Выводит только те строки, которые отличаются в файлах т.е. пытается найти отдельные строки и сравнивать их между собой + синхронизация, когда , например, в одном файле одна строка добавлена или удалена - он тоже сможет найти это и показать, что нет именно одной строки а не то, что всё внутри файла съехало.

* Посекторное сравнение двух образов - как это работает на примере игры DROL (диск без файловой системы). В одном окне открываем диск с оригинальной версией игры, в другом cheat-версию игры. При сравнении выдается результат где можно видеть в чем различия обессмерченной и стандартной игры. Например первая строка на изображении: дорожка 6, сектор 0 и смещения в нём, в которых есть различия (0E и 0F).

Таким способом удобно выяснять например в какое место софт делает отгрузки, если это происходит по абсолютным адресам диска.

* Пофайловое сравнение двух сред - ищет лишние или отличающийся по имени/содержимому файлы между панелями. Сравнивать можно и образы и любые папки компьютера, в любых комбинациях. Программа берет первый файл с левой панели и ищет такой же файл в правой панели. Если находит - то смотрит следующий файл в левой панели. Если не находит, то сперва отмечает, что ему нет пары. Потом так же проходится по файлам правой панели.
На скриншоте результат сравнения двух дисков. "Вампир" отличаются по содержимому, "Star Patrol" и "Звездный патруль" отличаются только именем, Pusher существует только на одном диске, а "Игра-35" только на другом.

* * *

Редактирование файла (HEX)

* Как HEX без оценки формата - аналогично функции "Просмотр/Как есть HEX" но с возможностью редактирования. Т.е. будет доступно содержимое всех секторов составляющих файл с нулевым смещением.

* Как B - аналогично функции "Просмотр/B-формат как HEX" но с возможностью редактирования. Т.е. будут фигурировать только пользовательские данные файла с правильным смещением (как в памяти Агата).

* Как K - у файлов типа К размер и длина сидят в TSList (4 байт в начале у таких нет), а смысл действий тот же что и с В файлом.

Режим редактирования это простой HEX-редактор.

Белым цветом - смещение первого байта строки;
Зеленым - hex поле: байты в шестнадцатеричной системе счисления;
Желтым - text поле: те же данные в текстовой кодировке.

Используется очень усреднённый знакогенератор Агата, только буквы, спец знаки (запятые, точки...) и цифры. Без псевдографики, стрелок всяких... Только то, что описано в ASCII + русские буквы. Это просто подсказки, бывают полезны, например, имя автозагрузчика надо в ДОСе поправить. Кстати это касается не только редактора HEX, такой же усредненный знакогенератор используется для визуализации бейсик программ и для вывода каталога. Скажем если в имени файла зачем-то поместили символы управления (например при выводе каталога из строчек рисовалась какая-то картинка из псевдографики, в СЧМ семёрочной такое было и в ALV Super DOS), то dos33c2 покажет только вопросики.

Переключение между полями клавиша Tab, дизассемблирование клавиша Enter. Эти и другие клавиши как всегда описаны в подсказке по F1.

Скопировать - поставить курсор на начало фрагмента, нажать Insert, передвинуть курсор к концу фрагмента, еще раз нажать Insert (фон фрагмента будет синего цвета). Затем курсор туда, куда надо вставить копию, F5.

* * *

Экспорт файла ( АГАТ -> PC)

* Автоопределение формата (Basic как AGAT; Bin без перекодировки) - универсальный экспорт с попыткой определения формата. В скобках указано как будет происходить конвертирование, в т.ч. если одновременно выделить несколько текстовых и несколько бейсиковских файлов. Но как и в случае с просмотром файла, лучше алгоритм конвертации задавать принудительно (функции начиная с третьей строчки данного меню).

* Автоопределение формата (Basic как GW; Bin с перекодировкой) - альтернативное автоопределение. В отличии от предыдущего пункта будет работать немного нестандартно (для бейсика подставит GW-таблицу, для BIN сделает перекодировку.. Были бы другие неоднозначные форматы - там бы тоже что-то отличалось). Это действие вряд ли понадобится в обычных ситуациях.

* Обычный текст - конвертирование текста из любого Агатовских файла типа Т, в обычный текстовик на PC. В результате получиться файл name.txt. Никакой обработки не выполняется, т.е. если это будет документ редактора ТОР, то все спецкоманды (например по выбору шрифтов) так и останутся в тексте. Такой же результат будет если при просмотре текстового документа нажать F2, хоть и будут использованы другие процедуры.

* Текст Apple ][ - то же самое, но для конвертирования текста из файла типа Т семейства Apple][ (кодировка отличается от подобной у Агат).

* Конвертирование текста из различных форматов текстовых редакторов Агата - подобны режиму "обычный текст" но учитывается исходный формат. Например, агат-автор семёрки в B-файлах использует совсем другую кодировку, чем обычный T, Д-формат ТОР - распаковывается, некоторые форматы (автограф, документ) - удаляются спецсимолвы выбора шрифта. В результате работы получаются файлы формата .txt.
Конвертирование в формат RTF пока не поддерживается, там можно было бы обрабатывать спецсимволы, например сохранять атрибуты шрифтов.

* Apple Integer Basic программа - для экспорта программ типа I раннего бейсика у семейства Apple][ в текстовый файл.

Импорт файла ( PC -> АГАТ)

* Обычный текст - используется для переноса текстовых файлов (например созданных в блокноте) в Агатовский формат. Исходный текстовик должен лежать в папке с программой. Выбираем из меню данную функцию и указываем полное имя ms-dos-файла с текстом (прямо с клавиатуры набираем). Создается Fil-файл с таким же именем в месте где находится курсор (образ диска или любая папка). Файл будет иметь тип T.

Не забываем что АГАТы не имеют буквы Ё (даже на клавиатуре). В девятке она была добавлена только в знакогенератор, но не по стандарту, поэтому желательно избегать этой буквы в текстах.

Основное - разное

* Информация об объекте - о любом, где курсор стоит, про то и будет рассказывать (файл, образ диска, каталог BTK или папка вашего ХДД). Самое полезное - информация о файле:

* HostOS имя: - это имя образа-диска или fil-контейнера на вашем ХДД. А если Агатовский файл находится внутри образа - будет показывать "not_set".

* Тип объекта: - "HostOS директория" или "Образ Агат-диска" или "Агатовский файл" или "Директория Best Tool Kit".

* Агат-имя: - полное Агатовское имя файла из каталога диска.

* Read Only: - звёздочку выводит на защищённом файле (lock\unlock из каталога диска).

Образ

* Очистить неиспользуемые области образа - убираем информацию о удаленных файлах. Если перед этим были удалены ВСЕ файлы, то на диске остается только ДОС на первых секторах.
Следует учитывать что сам по себе чистый образ не означает, что файлы в него будут записываться именно с 1 или 17-го или какого- то ещё трека. За это отвечает трек выделения (с какого места начинать записывать и в каком направлении). Трек выделения хранится в секторе 17/0 по смещению $30, направление - по смещению $31. При дальнейшем наполнении диска, ДОС сама будет корректировать это значение.

Если потребовалось удалить файл где-то в середине каталога, а потом произвести очистку, то на месте этого файла будет запись типа Т с кучей знаков вопроса. А если такое действие производится в конце каталога - ничего не останется.

Так и должно быть, ведь программа показывает больше подробностей о каталоге файлов чем обычные команды на реальном Агате. Раз уж образ вычищаем, значит восстановить файлы уже нельзя. Таким образом нет смысла сохранять имена прочие заметки в каталоге, связанные с удалёнными файлами. Запись забивается байтами FF,00,00...00. Первая FF - признак свободной записи (может быть использована при создании нового файла), остальное нули. Они и видны как Т-тип, нулевая длина и группа вопросиков. А последняя запись забивается всеми нулями, поэтому её нет даже среди удалённых. в середине каталога так нельзя сделать, так как иначе каталог вообще дальше читаться не будет.

* Расширить каталог - Расширить каталог - появляющееся меню предлагает несколько значений: 7 имен файлов (1 сектор); 14(2); 21(3); 28(4); 56(8); 112(16); 224(32); 448(64). Если нужны другие значения, например 35(5), можно сделать это в два прихода: 28+7, т.е. каталог может расширяться кратно сектору.

Зачем?
1) Не все Агатовские ОС умеют расширять каталог при записи файлов. И если место на диске для файлов есть, но каталог забит именами полностью - Агат откажется записывать новые файлы.
2) Если создавался аккуратный образ с помощью функции "Создать образ диска", и требуется выделить точное кол-во секторов под каталог имён.
3) Если использовать авторасширение*, то оно чередуется с созданием файлов, т.е. например: один сектор каталога есть, записываем 7й файл, он и предыдущие файлы занял в т.ч. дорожку каталога целиком. В этом случае перед записью 8-го файла будет создан новый сектор каталога. Но создан на свободном месте, возможно где-то далеко от 17й дорожки. Потом записали ешё 7 - следующий сектор будет опять где-то вдали. В этом случае при выводе каталога головка флопика будет ёрзать по всему диску, собирая части каталога. Но если заранее известно, что на диске будет много файлов, то можно расширить каталог до записи файлов, в этом случае его части по любому соберутся где-то в одном месте. Ну хотя бы бОльшая часть секторов каталога будет рядом, причем на одной дорожке. Потом уже наполняем диск файлами. В результате команда catalog будет выполняться быстрее. Ну и поиск файла, который указан где-то в конце каталога, тоже будет находится/читаться быстрее.

* Изменить имя тома - назначить/сменить имя диску. Кстати, можно задавать цвет в именах томов так же как и в именах файлов, но выводить это будут только ДОС основанные на Школьнице и на BTK (в бейсике это не заработает) - у них есть символы управления цветом. Код цифры боковой клавиатуры = номер цвета, и возможность переключения инверсии/мерцания/нормального конечно.

* Создать образ диска - 840 или 140 кб, dsk или nib. Создание чистого диска без всего, с целью максимума свободного места. Даже каталог создается только в 1 сектор (т.е. для 7 файлов), который конечно потом может быть расширен при копировании файлов (автоматически), или принудительно функцией "Расширить каталог".

* Карта образа - Визуализатор структуры файловой системы. При входе может появиться надпись "не найден ограничитель имени тома", можно не обращать на это внимание. Виталий Цикоза писал, что метка тома, заканчивающаяся на 8d 00, обязательна. Но реально её часто не бывает, в т.ч. init её не пишет.

По клавише пробел переключаются режимы просмотра карты образа. Они, в целом, реализовывались просто потому что не хватило фантазии - как в одной карте отобразить все особенности секторов одновременно. Пришлось сделать переключалку. Вообще тут нет явно заложенного сюжета использования. Иногда можно по этой инфе восстановить что-то на диске или создать. Иногда просто интересно посмотреть общий "износ" файловой системы или какие нибудь заморочки. Основная задача была - вывести всю инфу, которую можно вытянуть из файловой системы и , заодно, сделать некую экспертную оценку, которая бы строилась на сопоставлении вытянутой информации. Это что-то вроде chkdsk , но как бы без исправления, но наглядно.
Для каждого режима есть своя ЛЕГЕНДА КАРТЫ, доступная по клавише "l".

* Режим просмотра ссылок из других секторов на заданный - вся информация об указателях с одних структур на другие. VTOC указывает на начало каталога, элементы каталога - на ТСЛ и на своё продолжение, ТСЛ - на продолжение себя и на сектора данных. В это режиме видны ошибки, например, двойная ссылка на сектор. Это опасно тем, что , например, если удалить файл , то его сектора становятся свободными и если на какой-то сектор была двойная ссылка , то получится что оставшаяся ссылка теперь указывает на свободный сектор. Ну и вообще - не должно быть двойных ссылок. Если есть - это сразу говорит об ошибке в ФС.

* Режим просмотра расширений и содержания заданного сектора - это вся информация о том, что содержит в себе сектор и попытка вычислить возможные ошибки. Например, ТСЛ ссылается на сектор за пределами диска (например, на 250ю дорожку). Обычно так бывает, если как раз какой-то сектор имел двойную ссылку, одну ссылку удалили, сектор свободен, при следующей записи туда заливается что-то другое , но с точки зрения оставшейся ссылки - полный мусор.

* Режим восстановления диска поиском T/S списков - тут самое ценное - dos33c2 оценивает содержимое сектора с точки зрения ссылок и с точки зрения логики: если одно с другим не совпадает - то она отмечает такой сектор. Также здесь указываются свободные сектора, но которые могли быть ТСЛ-списками. Так можно искать удалённые / брошенные файлы.