Вложений: 2
Текстовый редактор ПОБЕДИТ
Как известно, для РЛК существовало, как минимум, два редактора:Однако, у этих редакторов имеются три небольших недостатка:- Жёсткая посадка на адрес 0000
- Ограничение на количество символов в строке
- Занимаемое в ОЗУ место
Одно время среди коллег витала в воздухе мысль, что неплохо бы иметь для РЛК простой экранный редактор, доступный сразу по включению из дополнительного ПЗУ.
Оригинальный Монитор РЛК имеет в странную директиву U с переходом на адрес F000, что предоставило бы очень простой запуск любого дополнительного кода.
Ещё со времён DOS всегда интересовал механизм кода, отвечающий за вывод/редактирования текста оболочками Norton/Volcov Commander в режиме UnWrap.
Этим месяцем (апрелем) решению вопроса разработки подобного редактора было посвящено всё свободное время.
Вниманию любителей РЛК представляется ещё один текстовый редактор:- Поддержка строк длинною до 255 символов
- Стандартное отображение отступов табуляции
- Горизонтальная и вертикальная прокрутки
- Поддержка пользовательского кода (транслятора/компилятора/информатора)
- Поддержка светового пера (экспериментальная)
Весь цикл разработки и отладки кода ведётся в известном онлайн-эмуляторе, поддерживающим световое перо мышью ПК и загрузку внешних файлов.
Именно в конкретном эмуляторе:- Работают по назначению клавиши DELETE/END/HOME
- Курсор в тексте быстро позиционируется мышью
- Клавиша F1 или двойной клик мышью вызывает "контекстное меню" (транслятора/компилятора/информатора)
- Клавиши F2/F3 прокручивает окно текста
- Нажатие мышью за пределами региона редактирования совершает вертикальную или горизонтальную прокрутку
P.S.: Не зная, как Администрация отнесётся ко внешним ссылкам, предоставляю лишь скриншот. А все желающие проверить, могут получить ссылку через ЛС.
Вложение 78748
Вложение 78749
Вложений: 1
Онлайн эмуляция и rkr-образ
Цитата:
Сообщение от
CityAceE
По этому поводу на форуме нет никаких ограничений.
Спасибо!
Запустить UnWrap редактор.
Кто желает проверить в других эмуляторах или на "железе", может скачать файл Вложение 78761
(Внимание! Файл содержит модифицированный вариант чисто для ознакомления.)
После загрузки rkr-файла и запуском по G0, выйдет уведомление с приглашением откорректировать регистры PC и DE. Для оценки следует выставить PC=0800 и DE=2100.
Вложений: 1
Текстовый редактор ПОБЕДИТ
Для РАДИО-86РК существует, как минимум, два текстовых редактора:
Однако, на практике хотелось бы что-нибудь компактнее и с другой адресной посадкой. Ещё лучше, если код редактора уместился бы в другое ПЗУ, так как официальный Монитор по директиве U уходит на адрес F000.
Чтобы успеть к первомаю, пришлось здорово потрудиться восьмибитным мозгом и решить множество мелких проблем, буквально одолев их и победив.
Потому, Вашему вниманию представляется версия текстового редактора с официальным названием:
ПОБЕДИТ
Представляемый текстовый редактор разработан специально на работу в дополнительном ПЗУ F000-F7FF, с аккуратным использованием области служебных ячеек Монитора, чтобы дать пользователю максимальный объём ОЗУ.
Редактор имеет самый минимальный функционал, достаточный для элементарного редактирования текстов. Однако, с помощью пользовательского кода функционал интерфейса редактора можно расширить с помощью CallBack-вызовов. Для этого предоставляется небольшой API.
Список точек вызова основных API:
- F000 - Обычный запуск редактора (директива U Монитора)
- F003 - Запуск редактора с указанием пользовательского кода (в HL)
- F006 - Переключение (с предустановкой) буфера листинга (адрес в HL)
- F009 - Переключение (без предустановки) буфера листинга (адрес в HL)
- F00C - Панорамная прокрутка листинга (CF=0 - вперёд / CF=1 - назад)
- F00F - Вертикальная прокрутка листинга (CF=0 - вперёд / CF=1 - назад)
- F012 - Помещение в стек адреса знакоместа из непосредственных констант
- F018 - Помещение в стек адреса знакоместа по позиции X=E и Y=D
- F01B - Помещение в стек адреса знакоместа (без растровой коррекции)
Как видно, никаких средств текстовой обработки не предоставляется.
Однако, рассмотрим основной набор подпрограмм.
CALL F003 - Передача управления редактору с указанием ассистента
Явно передать CallBack-адрес на пользовательский код нужно регистром HL.
При этом, если буфер текста листинга не был предустановлен, директивой X Монитора пользователю предложится это сделать самостоятельно модификацией регистра HL.
CALL F006 - Предустановка буфера листинга
Данную подпрограмму следует вызывать перед передачей управления самому редактору, чтобы через регистр HL установить указатель на основной буфер листинга.
CALL F009 - Переключение буфера листинга
Пользовательский код может переключать текстовый буфер на лету, передавая адрес регистром HL. Необходимости указания на самое начало буфера нет, так как вычисление номера верхней отображаемой строки происходит автоматически.
CALL F00C - Динамическая прокрутка листинга на экране
Для прокрутки текста листинга на 1 символ влево или вправо, через флаг CF указывается направление. При этом подпрограмма возвращает флаг ZF в случае, если прокрутка не возможна по причине достижения начала строки или предела панорамы.
CALL F00F - Динамическая прокрутка листинга на экране
Для прокрутки текста листинга на 1 строку вверх или вниз, через флаг CF указывается направление. При этом подпрограмма возвращает флаг ZF в случае, если прокрутка не возможна по причине достижения начала или конца текста листинга.
CALL F012 - Помещение в стек адреса экранного знакоместа по константным координатам
Подпрограмма достаточно быстро (без цикла) математически вычисляет адрес и возвращает его в стеке. После обращения к подпрограмме, адрес следует извлекать любой командой POP.
Координаты знакоместа следует указать двумя байтами непосредственно за командой CALL.
При этом производится незначительная коррекция по знакоместу, чтобы адаптировать вывод под специфику дисплея.
CALL F018 - Помещение в стек адреса экранного знакоместа по координатам в DE с коррекцией
Подпрограмма достаточно быстро (без цикла) математически вычисляет адрес и возвращает его в стеке. После обращения к подпрограмме, адрес следует извлекать любой командой POP.
Координаты знакоместа следует указать регистрами D (позиция по Y) и E (позиция по X).
При этом производится незначительная коррекция по знакоместу, чтобы адаптировать вывод под специфику дисплея.
CALL F01B - Помещение в стек адреса экранного знакоместа по координатам в DE без коррекции
Подпрограмма достаточно быстро (без цикла) математически вычисляет адрес и возвращает его в стеке. После обращения к подпрограмме, адрес следует извлекать любой командой POP.
Координаты знакоместа следует указать регистрами D (позиция по Y) и E (позиция по X).
Никакой коррекции по знакоместу не производится.
Список критически важных ячеек программы:
- F018-F01A - Три команды для растровой коррекции на ±3 знакоместа (настроить перед прошивкой ПЗУ)
- F040/F041 - Начальные координаты (обычно 8 и 3) курсора (настроить перед прошивкой ПЗУ)
- F4DA-F4DC - Установка флажка подпрограммы опроса клавиатуры (F812), чтобы код пользователя мог прочитать код функциональной клавиши обычным вызовом CALL F803 (читать про флаг ZF ниже)
- F7FE/F7FF - Адрес входа в редактор (просто указывает на расположение основного кода)
Калибровка смещения знакомест является комплексной операцией с необходимостью взаимосвязанной правки ячеек. Вот пример:
- Обычное позиционирование: F018 [00 00 00]; F040 [08 03]
- Смещение на 1 знакоместо: F018 [13 00 00]; F040 [09 03]
- Смещение на 2 знакоместа: F018 [13 13 00]; F040 [0A 03]
- Смещение на 3 знакоместа: F018 [13 13 13]; F040 [0B 03]
Служебные ячейки для стилизация интерфейса редактора:
- 7629 - Код символа заполнения пространства табуляции
- 762A - Код символа обрамления левого края текстовой области
- 762B - Код символа обрамления правого края текстовой области
- 762D - Маскирование столбца счётчика строк (слева от текста)
- 762E - Корректировочное смещение знакоместа светового пера
- 7633 - Код символа переполнения панорамы
Служебные ячейки функционального механизма редактора:
- 7614 (PC директивы X) - CallBack-адрес на пользовательский код
- 7616 (HL директивы X) - Адрес в текстовую область листинга
- 7618 (BC директивы X) - Счётчик строк
- 761A (DE директивы X) - Позиция курсора относительно области текста
- 761C (SP директивы X) - Указатель на начало текущей строки с курсором
- 761E (AF директивы X) - Значение панорамной прокрутки и флаги
- 7634 - Указатель на 25 строк выше (используется для PageUp-операции)
- 7636 - Указатель на 1 строку выше (используется курсорной клавишей)
- 7638-7668 - Массив 25 указателей на каждую из 25 отображённых строк
- 766A - Указатель на 26 скрытую строку (используется PageDown-операцией)
- 766C/766D - Двоично-десятичный номер верхней скрытой строки (используется прокруткой)
- 766E/766E - Двоично-десятичный номер нижней скрытой строки (используется прокруткой)
Клавиши работают следующим образом:
- HOME с прокрученным экраном возвращает его на 64 позиций назад
- HOME из любой позиции в строке устанавливает курсор в начало строки
- HOME в начале любой строки устанавливает курсор в начало экрана
- HOME в начале экрана прокручивает его на 25 строк вверх (аналогично Page Up)
- END/СТР устанавливает курсор в конец строки
- END/СТР в конце строки устанавливает курсор в конец экрана
- END/СТР в конце экрана прокручивает его на 25 строк вниз (аналогично Page Down)
- DEL/ПС в любой позиции строки удаляет символ под курсором
- DEL/ПС в конце строки производит слияние со следующей строкой
- BS/ЗАБОЙ в любой позиции строки затирает символ перед курсором
- BS/ЗАБОЙ в начале строки производит слияние с предыдущей строкой
Если указан адрес вызова пользовательской вспомогательной подпрограммы, обращение к ней происходит при нажатиях любой клавиши или клике "световым пером".
При этом через регистры общего назначения передаётся следующая информация:
- BC - Шестнадцатеричный индекс (редактируемой) текущей строки
- DE - Адрес на начало самой верхней отображаемой строки
- HL - Адрес на начало текущей (редактируемой) строки
- A - Номер столбца по позиции курсора (начало - 01) с учётом панорамы
- CF флаг - Экран готовится к полной перерисовке (при клике "световым пером" или перемещением стрелками)
- PF флаг - Двойной (повторный) клик "светового пера" по знакоместу с курсором
- ZF флаг - Клавиши F1-F4, АР2 или УС+A-Z (код читается через вызов F803 обязательно, иначе возникнет зацикливание редактора/!\)
- SF флаг - Буферная строка (редактирование в активном состоянии)
Всего этого вполне достаточно, чтобы реализовать все необходимые операции работы с текстом. В качестве примера, УС+D удаляет текущую строку, а УС+У/К/Е/В прокручивают экран в одном из четырёх направлений.
Как всегда, вот ссылка на онлайн демонстрацию с кодом для ПЗУ (F000-F7FF) и rkr-файл.
P.S.: За месяц был проделан практически титанический труд по разработке кода с чистого листа.
Потому, основной код перенесён именно в область F000-F7FF, чтобы всегда под рукой иметь инструмент для личных нужд. В частности, для разработок собственных интерпретаторов языков высокого уровня.
P.P.S.: Вопрос к модераторам: Можно ли переименовать тему (на обновлённый заголовок) или проще открыть новую?
Исходный код текстового редактора ПОБЕДИТ
Так как версия достаточно стабильная, выложил исходный текст в свой репозиторий.
Буква «U» в данном контексте означает именно версию для ПЗУ F000-F7FF с вызовом директивой «U» Монитора…
Листинг расчитан исключительно для вставки в онлайн-эмулятор и достаточно комментирован.
Вложений: 2
Победит 1v01 - мелкая доработка
Оказывается, в случаях с расширенным знакогенератором, где символы 0A и 0D - не просто пустые и имеют какое-то особое графическое представление, весь экран покрывается ими, что практически не допустимо!
Потому, представляю здесь обновлённую версию с подавлением вывода этих символов.
Конкретно в Emu80 конфигурация легко настраивается на проекцию образа ПЗУ редактора в область F000…F7FF.
Запуск редактора - любопытный момент, так как Монитор в редакции эмулятора Emu80 директивой U передаёт управление не на адрес F000, а на адрес E000 с DOS.
Запуск же просто директивой «GF000» - не очень эстетичен и имеет некоторый неприятный побочный эффект…
Однако, сам Монитор (оригинальный/журнальный) его может запустить сам в 90% случаях.
Дело в том, что Монитор принимает директивы лишь из набора букв «CDFGILMORSTUX», а в остальных случаях - переходит на F000 (ячейки F8D9…F8DB содержат код команды «JMP F000»)…
Тем самым, любой непредусмотренный символ («Пробел», цифры, клавиши F1-F5, Esc/АР2, Курсорные стрелки, Home, «Стр» и «ПС» и т.д.) запустит код редактора.
При этом, даже можно указать некоторые параметры, задав стиль:- «P,3C09,3E» (левый край 3C; табуляция 09; правый край 3E)
- «P,5B5F,5D» (левый край 5B; табуляция 5F; правый край 5D)
Ниже - образ ПЗУ под Emu80 (конфигурацию легко подправить), а так же скриншот с примером запуска директивой «P» (или «E» / любой другой).
