Искра-226/Графический буфер BASIC 02 - История изменений

Panther: Новая страница: «{{emuverse}} '''Графический буфер BASIC 02''' — формат хранения рисунка в памяти Искра-226. Буфер представляет собой '''обычный символьный массив Бейсика''': оператор `¤OPEN` объявляет массив буфером, графические операторы дописывают в него записи, оператор
2026-08-26T15:37:23Z

Новая страница: «{{emuverse}} '''Графический буфер BASIC 02''' — формат хранения рисунка в памяти Искра-226. Буфер представляет собой '''обычный символьный массив Бейсика''': оператор <code>¤OPEN</code> объявляет массив буфером, графические операторы дописывают в него записи, оператор <code...»

Новая страница
{{emuverse}}

'''Графический буфер BASIC 02''' — формат хранения рисунка в памяти [[Искра-226]]. Буфер представляет собой '''обычный символьный массив Бейсика''': оператор <code>¤OPEN</code> объявляет массив буфером, графические операторы дописывают в него записи, оператор <code>¤COPY /<адрес></code> выкладывает всё разом на устройство. Собственной памяти под графику у машины нет.

Буфер можно записать на диск и прочитать обратно как обычное символьное значение: см. [[Искра-226/Файловая система|Файловая система]] и [[Искра-226/Файлы данных BASIC 02|Файлы данных BASIC 02]]. Токены графических операторов описаны в статье [[Искра-226/Кодирование BASIC-файлов|Кодирование BASIC-файлов]].

Документация<ref name="balasanyan" /> графических операторов не описывает.

== Растр ==

Графическое поле — '''560 × 256''' дискрет, начало координат в левом нижнем углу, точка квадратная.

Устройства вывода (адреса по таблице ФАУ<ref name="balasanyan" />):

{| class="wikitable"
! Адрес !! Устройство
|-
| <code>10</code> || блок отображения графической информации (экран)
|-
| <code>14</code> || графопостроитель
|-
| <code>34</code> || телекоммуникационный интерфейс
|}

Группа <code>PLOT</code> таблицы устройств по умолчанию указывает на адрес <code>10</code>.

Символьное и графическое поля — два разных устройства на одной трубке. Знаки рисует аппаратный знакогенератор, знакоместо 7 × 10 точек; 80 × 24 знакоместа занимают 560 × 240 и оставляют поля по 8 точек сверху и снизу.

== Заголовок ==

Первые 43 байта буфера. Нумерация байт с единицы, как в операторе <code>STR(</code>.

{| class="wikitable"
! Байт !! Значение
|-
| 1–2 || длина занятого, считая сам заголовок
|-
| 3–4 || текущая точка, X
|-
| 5–6 || текущая точка, Y
|-
| 7–39 || не установлены
|-
| 40–43 || не установлены; прикладные программы используют как своё место
|}

Числа заголовка лежат '''младшим байтом вперёд''' — в обратном порядке относительно координат в самих записях.

Пустой буфер: <code>2B 00 00 00 00 00</code> и дальше нули, то есть длина 43, текущая точка <code>0,0</code>. Первая запись потока ложится в байт 44.

== Записи потока ==

Записи идут подряд начиная с байта 44, разделителей нет: длину каждой задаёт её код.

{| class="wikitable"
! Код !! Оператор !! Запись
|-
| <code>80</code> || NPLOT || 5 байт: код и точка
|-
| <code>81</code> || NDRAW || то же
|-
| <code>82</code> || NLAB. || как <code>86</code>
|-
| <code>83</code> || ''не установлен'' ||
|-
| <code>84</code> || DOT || 5 байт: код и точка
|-
| <code>85</code> || DRAW || то же
|-
| <code>86</code> || LABEL || код, длина, приращение, признаки, текст
|}

Координаты — '''двухбайтовые двоичные, старший байт первым'''. Знака не имеют: отрицательных координат у растра нет.

'''Бит <code>04</code> кода записи — признак «рисовать».''' Коды <code>80</code>, <code>81</code> и <code>82</code> — это стёртые <code>84</code>, <code>85</code> и <code>86</code>: запись остаётся в потоке и двигает текущую точку, но следа не оставляет. Стирание элемента выполняется как <code>AND(<код>,FB)</code>, восстановление — как <code>XOR(<код>,04)</code>. Буква <code>N</code> в именах означает «не рисуя».

{| class="wikitable"
! Видимая !! Стёртая !! Действие стёртой
|-
| <code>84</code> DOT || <code>80</code> NPLOT || перевести точку, не рисуя
|-
| <code>85</code> DRAW || <code>81</code> NDRAW || то же
|-
| <code>86</code> LABEL || <code>82</code> NLAB. || сдвинуть точку на приращение
|}

Оператор <code>¤COPY</code> чистит растр перед выводом: иначе стёртый элемент остался бы на экране.

=== Точка и приращение ===

Четвёрка байт после кода читается по-разному:

* у рисующих записей (<code>80</code>, <code>81</code>, <code>84</code>, <code>85</code>) это '''новая текущая точка''', абсолютная;
* у надписей (<code>82</code>, <code>86</code>) это '''приращение''' к текущей точке, число '''со знаком'''.

=== Запись надписи ===

86 <длина> <приращение X: 2 байта> <приращение Y: 2 байта> <3 байта признаков> <текст в КОИ-8>

Байт длины считает сам себя. Приращение равно '''семи дискретам на знак''' — ширине знакоместа.

86 09 | 00 07 00 00 | 01 02 00 | 59 "Y"
86 0A | 00 0E 00 00 | 01 02 00 | 2D 31 "-1"

Первый байт признаков — множитель размера знака; в тексте он пишется вплотную к имени буфера (<code>LABEL B¤()3,,,"Q"</code>) и по умолчанию равен единице. Смысл двух остальных не установлен; на дисковых образах они всегда <code>02 00</code>.

== Операторы ==

Все графические операторы — двухбайтовые, с префиксом <code>06</code>.

{| class="wikitable"
! Подкод !! Оператор !! Действие
|-
| <code>00</code> || PLOT || вывод прямо на устройство, минуя буфер
|-
| <code>0F</code> || <code>¤OPEN</code> || объявить символьный массив буфером
|-
| <code>13</code> || DOT || поставить точку по координате
|-
| <code>14</code> || DDRAW || отрезок по приращению от текущей точки
|-
| <code>15</code> || DRAW || отрезок до координаты
|-
| <code>19</code> || NPLOT || перевести текущую точку по координате, не рисуя
|-
| <code>1A</code> || <code>¤MOVE</code> || сдвинуть картинку
|-
| <code>1B</code> || TURN || повернуть картинку вокруг точки
|-
| <code>1C</code> || STRETCH || растянуть картинку относительно точки
|-
| <code>1D</code> || FRAME || задать окно буфера в пользовательских единицах
|-
| <code>1E</code> || LABEL || надпись
|-
| <code>1F</code> || <code>¤COPY</code> || вывести буфер на устройство
|-
| <code>22</code> || <code>¤LET</code> || присваивание буфера
|-
| <code>23</code> || WINDOW || задать окно устройства в дискретах
|}

Три способа задать точку: <code>NPLOT</code>, <code>DRAW</code>, <code>DOT</code> и <code>LABEL</code> берут координату; <code>DDRAW</code> — приращение от текущей точки; <code>PLOT</code> — тоже приращение, но кладёт результат не в буфер, а на устройство.

Имена <code>ORIGIN</code>, <code>DNPLOT</code> и <code>NDRAW</code> встречаются в текстовых листингах, но подкодов не имеют: все подкоды, встречающиеся в оттранслированных файлах, уже опознаны. <code>DNPLOT</code> по смыслу — приращение без следа.

=== Преобразования ===

Операторы <code>¤MOVE</code>, <code>TURN</code> и <code>STRETCH</code> '''переписывают уже лежащие в буфере записи''', новых не добавляя.

{| class="wikitable"
! Оператор !! Операнды
|-
| <code>¤MOVE</code> || буфер, сдвиг по X, сдвиг по Y
|-
| <code>TURN</code> || буфер, X и Y точки, угол поворота
|-
| <code>STRETCH</code> || буфер, X и Y точки, масштаб по X, масштаб по Y
|}

Названная точка у <code>TURN</code> и <code>STRETCH</code> неподвижна. Единица измерения угла — общая с тригонометрическими функциями, задаётся операторами <code>SELECT D</code>, <code>SELECT R</code> и <code>SELECT G</code>.

Три оператора обратимы: последовательность из растяжения, поворота и обратного растяжения возвращает картинку на место.

Выход за пределы растра — ошибка машины, перехватываемая оператором <code>ON ERROR</code>.

=== Присваивание буфера ===

¤LET <буфер> = <буфер> копирование картинки
¤LET <буфер> = 0 опустошение буфера

В известных программах первая форма встречается только присваиванием буфера самому себе, что записей не меняет; побочное действие такого оператора не установлено.

== Система координат ==

{| class="wikitable"
! Оператор !! Операнды !! Что задаёт
|-
| WINDOW || <code><x0>,<x1>,<y0>,<y1></code> || область на устройстве, в дискретах; имени буфера в операндах нет — область общая
|-
| FRAME || <code><буфер>,<x0>,<x1>,<y0>,<y1></code> || ту же область в пользовательских единицах, своя у каждого буфера
|-
| ORIGIN || <code><буфер>,<dx>,<dy></code> || смещение начала координат
|}

Границы <code>WINDOW</code> — целые дискреты, границы <code>FRAME</code> бывают дробными и отрицательными: это диапазон самих данных.

'''В записях буфера лежат дискреты устройства, а не пользовательские единицы.''' Перевод выполняется при добавлении записи, а <code>FRAME</code> с <code>ORIGIN</code> его и задают. Ни <code>FRAME</code>, ни <code>ORIGIN</code> ничего не рисуют.

По умолчанию отображение тождественное: программы, работающие прямо в дискретах экрана, <code>WINDOW</code> и <code>FRAME</code> не вызывают вовсе.

Где машина хранит это отображение, не установлено. В заголовке буфера на него остаются непрочитанные байты 7–39.

== Оператор PLOT ==

Единственный графический оператор, который рисует прямо на устройстве группы <code>PLOT</code>, минуя буфер. Буфера в операндах нет.

PLOT <x,y,перо>,<x,y,перо>,…

Группа ограничена токенами <code>D7</code> и <code>D4</code> (<code><</code> и <code>></code>), группы и элементы внутри группы разделяются <code>DE</code>. Элементов ровно три, любой может быть пуст.

Координаты — '''приращения''', а не точки. Первая группа серии отсчитывается от начала координат.

Третий элемент — перо, отдельные однобайтовые метки:

{| class="wikitable"
! Байт !! Буква !! Смысл
|-
| <code>E5</code> || <code>U</code> || перо поднято: сдвиг без следа
|-
| <code>E6</code> || <code>D</code> || перо опущено: отрезок
|-
| <code>E7</code> || <code>R</code> || сброс: перо в начало координат, размеры по умолчанию
|-
| <code>E8</code> || <code>S</code> || шаг знака по X и Y
|-
| <code>E9</code> || <code>C</code> || размер знака
|}

Те же байты в позиции операнда означают константы и унарный минус; метка узнаётся '''по месту''' — третий элемент группы, за которым сразу стоит <code>DE</code> или <code>D4</code>. Третьим элементом бывают также выражение, строковый литерал и вырезка <code>STR(…)</code>.

Буквы <code>S</code> и <code>C</code> — законные имена переменных, и различает их тоже только место в группе.

== Управляющие коды устройства 10 ==

Графическое устройство принимает короткие управляющие последовательности оператором <code>PRINT /10,HEX(…)</code>. Коды соответствуют документации на Wang 2282 Graphic CRT<ref name="wang2282" />:

{| class="wikitable"
! Код !! Действие
|-
| <code>03</code> || гасит поле, точка встаёт в начало координат, перо поднимается
|-
| <code>04</code> || выбрать принтер
|-
| <code>06</code> || выбрать графическую трубку
|-
| <code>0A</code> || шаг между знаками, из предшествующего вектора
|-
| <code>0D</code> || размер знака 1…15, из ΔX предшествующего вектора
|-
| <code>0E</code> || перо поднято
|-
| <code>0F</code> || перо опущено
|-
| <code>E0</code> || длинный двоичный вектор: ΔX и ΔY по два байта, дополнительный код
|-
| <code>E1</code>–<code>E3</code> || перо 1…3; перо 2 гасит точки
|-
| <code>E4</code> || задать начало координат
|-
| <code>E5</code> || сброс: начало координат в левый нижний угол
|-
| <code>E6</code> || короткий двоичный вектор: ΔX и ΔY по байту
|-
| <code>E7</code> || скопировать поле на принтер
|-
| <code>FA</code> || вернуть точку в начало координат
|}

Рисуют из них только векторы <code>E0</code> и <code>E6</code>; остальное задаёт состояние.

Три кода, встречающиеся в программах Искры, в таблицу 2282 не попадают: <code>01</code>, пара <code>01 02</code> и последовательность <code>08 0B 09 06</code>. Значит блок отображения Искры повторяет Wang не полностью.

Перевод строки, который оператор <code>PRINT</code> дописывает сам, на графическое устройство не уходит: у графического поля строк нет.

== Не установлено ==

# Байты заголовка 7–39 — где хранится отображение <code>WINDOW</code>/<code>FRAME</code>/<code>ORIGIN</code>.
# Байты заголовка 40–43. Прикладные программы держат там пару чисел, к которым прибавляется сдвиг <code>¤MOVE</code>, и требуют неотрицательного итога; читаются они старшим байтом вперёд, в отличие от остального заголовка.
# Код записи <code>83</code>.
# Смысл второго и третьего байта признаков надписи.
# Подкоды операторов <code>ORIGIN</code>, <code>DNPLOT</code>, <code>NDRAW</code>.
# Побочное действие оператора <code>¤LET</code>.
# Управляющие коды устройства <code>10</code>: <code>01</code>, <code>01 02</code>, <code>08 0B 09 06</code>.
# Код ошибки, который получает <code>ON ERROR</code> при выходе преобразования за пределы растра.

== Примечания ==

<references>
<ref name="balasanyan">Баласанян В. Э., Богдюкевич С. В., Шахвердов В. А. Программирование на микроЭВМ «Искра 226». — М.: Финансы и статистика, 1987. — 264 с.: ил.</ref>
<ref name="wang2282">2282 Graphic CRT Plotter User Manual. — Wang Laboratories, 700-4627A, 10-81. — разд. 3.2 «Control Codes».</ref>
</references>

== Источники ==

* Баласанян В. Э., Богдюкевич С. В., Шахвердов В. А. Программирование на микроЭВМ «Искра 226». — М.: Финансы и статистика, 1987.
* [http://www.wang2200.org/docs.html 2282 Graphic CRT Plotter User Manual] — управляющие коды графического устройства.
* Реконструкция по программам <code>SLIDE</code> (редактор графических объектов), <code>SIG</code>, <code>EDITOR</code>, <code>VICT</code>, <code>STAT01</code>, <code>FAN01</code> и по готовой картинке с дискового образа — 196 записей потока.

[[Категория:Искра-226]]