Автор: А.Б. Родионов
© МЭВЦ 1986–1988

Программное средство (ПС) «Маэстро» предназначено для создания высокоэффективных и кратких программ на языке С для компьютеров MSX и MSX2 и включает в себя такие средства программирования, как параллельные процессы, окна, работа с манипулятором «мышь», специализированные методы доступа и обработки графических данных и многое другое. ПС «Маэстро» может быть использовано для разработки учебных программ, компьютерных игр, системных и прикладных программ и для других приложений.

С помощью ПС «Маэстро» автор создал Pattern Composer и эти игры.

Основные главы:

• Графическая библиотека MSX для BDS C
• Музыкальная библиотека
• Утилиты

Документация находится в процессе работы, описание изменений здесь.

Графическая Библиотека MSX для BDS C версия 3.05
MSX Graphic Library for BDS C v3.05

Образ диска с версией 3.05

(C) МЭВЦ 1988

Аннотация
В данном документе содержится описание применения библиотеки функций «MSX Graphic Library for BDS C» версии 3.02. Документ предназначен для разработчиков программного обеспечения на компьютерах MSX2 и MSX и содержит следующие разделы:

• Назначение
• Условия применения
• Описание функций
  • GRPLIB1
  • GRPLIB2
  • GRPLIB3
  • GRPLIB4
  • GRPLIB5
• Рекомендации по использованию и форматы данных

«MSX Graphic Library for BDS C» является авторской разработкой А. Б. Родионова (Москва, 1986–1988). Оригинальная документация ведётся на английском языке для совместимости с оборудованием, не имеющим кириллических знакогенераторов и может быть поставлена по специальному заказу. По этой же причине англоязычными являются все комментарии в текстах программ и диалог, ведущийся утилитами ПС «МАЭСТРО».

Данный документ не следует рассматривать как учебное пособие по компьютерам MSX и MSX2 — напротив он рассчитан на подготовленный программистов, знающих архитектуру этих компьютеров, но испытывающих затруднения в выборе инструментальных средств для разработки своих программ.

«MSX Graphic Library for BDS C» (в дальнейшем именуемая просто «Библиотека») предназначена для программистов, использующих компилятор BDS C. Библиотека разработана специально для MSX-машин. Она обеспечивает полный доступ ко всей аппаратуре MSX2 и MSX (в дальнейшем именуемой MSX1) из программ, написанных на языке С. Кроме обращений к стандартным функциям BIOS и SubROM MSX, библиотека включает в себя ряд новых специальных функций и методов доступа, облегчающих программирование сложных и ресурсоёмких задач.

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

Библиотека включает в себя следующие подразделы:

• параллельные процессы с циркулярной и линейной очередями, почтой и др.;
• базовые методы работы с манипулятором «мышь»;
• спрайтовое зеркало;
• специальные методы доступа;
• работа с прерываниями;
• работа с мэппером;
• отладочные функции:
  • showpage()
  • prtscrnt()
  • PAUSE()
• вспомогательные функции.

• дисковый ввод/вывод для VRAM MSX2;
• блочные пересылки RAM → VRAM, VRAM → RAM, VRAM → VRAM.

• функции для рисования точек, линий, блоков и пр.;
• вывод символов на графический экран;
• текстовые меню в графическом режиме;
• прямой доступ к текстовому экрану;
• опрос специальных клавиш клавиатуры;
• работа с мышью;

• спрайты (логический уровень);
• доступ к оглавлению диска и его сортировка;
• методы организации и выделения оперативной памяти;
• копирование текстового и графического экранов на принтер;
• ввод/вывод для магнитной ленты;
• работа со звуковым генератором MSX;
• сжатие/расширение информации в памяти;
• доступ к диску по секторам.

• загрузка знакоместного полиэкрана;
• управление знакоместным полиэкраном;
• графические и текстовые окна для полиэкрана;
• спрайты MSX1;
• прямой ввод/вывод для полиэкрана.

Для пользования Библиотекой необходим MSX-компьютер с оперативной памятью минимум 64 кбайт и минимум одним дисковым приводом. Программы, написанные с использованием Библиотеки и компилятора BDS C, могут быть рассчитаны и на «бездисковую» или «сетевую» конфигурацию объектной машины (при соответствующем их программировании) или на компьютер с дисками и другим объёмом как оперативной, так и видеопамяти.

Большая часть функций Библиотеки может быть использована как для компьютеров MSX1, так и MSX2, но некоторые функции (указаны особо в описании) применимы ТОЛЬКО к MSX1 или ТОЛЬКО к MSX2.

В частности, раздел библиотеки GRPLIB2 содержит функции ТОЛЬКО для MSX2 и НЕ ДОЛЖЕН использоваться при написании программ для MSX1, а раздел GRPLIB5 и заголовок GRPMSX1.H ДОЛЖНЫ быть подключены к программе, если она рассчитана на компьютер MSX с 16 кбайт видеопамяти и без SubROM (дополнительного 16-кбайтного расширения ПЗУ, обеспечивающего большинство функций MSX2 со 128 кбайт видеопамяти и энергонезависимой памятью для календаря, часов, пароля и т.п.).

Абсолютно необходимым условием успешного применения функций библиотеки является знание программистом архитектуры и особенностей компьютеров MSX1 и MSX2, операционной системы MSX-DOS и основных принципов работы со знакоместной и битмэп-графикой. Кроме этого, совершенно необходимо знание языка Си и особенностей его конкретной реализации в системе BDS C (смотри C Compiler v1.5 Users Guide, Copyright (c) 1982 by Leor Zolman BD Software).

Для нормальной работы большинства функций Библиотеки требуется выделение и инициализация специальной системной рабочей области памяти. Эта рабочая область выделяется автоматически при ОБЯЗАТЕЛЬНОМ включении в создаваемую программу одного из двух системных заголовков:

#include GRPLIB0.H

#include GRPMSX1.H

ВНИМАНИЕ! Любой из этих заголовков резервирует рабочую область в External и для правильной работы библиотеки должен быть записан в качестве САМОГО ПЕРВОГО оператора Вашего файла с исходным текстом программы на Си. Иными словами, Ваши собственные глобальные переменные должны располагаться только ПОСЛЕ системной рабочей области (иметь бОльшие адреса памяти). Внутрь этих заголовков всегда автоматически включается заголовок BDSCIO.H GRPMSX1.H включает в себя автоматический вызов GRPLIB0.H и его собственные функции могут замещать некоторые другие функции разделов библиотеки GRPLIB1…GRPLIB5.

Переменные условной компиляции для заголовков

Есть несколько специальных операторов для условной компиляции заголовков .Н, которые можно указывать перед их вызовом:

• #define NO_FUNC		/* используется в GRPMSX1.H */

  Используйте этот оператор, если вы компилируете и линкуете более, чем 1 исходный файл на Си. Этот оператор условной компиляции должен присутствовать во всех ваших файлах с исходными текстами кроме ОДНОГО во избежание повторных генераций функций с одинаковыми именами т.к. заголовок GRPMSX1.H содержит в себе определения и переопределения функций GRPLIB0.H, специфических для MSX1 и не использующих SUBROM и VDP9938.

• #define NO_TICKS	/* используется в GRPMSX1.H */

  Создаётся пустая функция totick() { } если не предполагается использование параллельных процессов. Это экономит память.

• #define NO_PUTSXY	/* используется в GRPMSX1.H */

  Не создаётся переопределение функции putsxy() для вывода символов на текстовой экран MSX1 с использованием BIOS вместо обращения к VDP9938

• #define NO_RTOVLW	/* используется в GRPMSX1.H */

  Не создаются переопределения функций _rtovlw() и _vtorlw() для работы через BIOIS вместо прямого обращения к VDP9938

• #define NO_MOUSE	/* используется в GRPMSX1.H */

  Не используется вызов SUBROM в totick() для работы с мышью даже если используется MSX2

• #define NO_PBUF		/* используется в GRPMSX1.H и GRPLIB0.H */

  Не создаётся массив _pbuf[32] в GRPLIB0.H для работы с функцией fmt(). Сама функция fmt() также будет недоступна. Это экономит память.

• #define JOY2ONLY	/* используется в GRPSTICK.H и GRPLIB0.H */

  Используется опрос джойстика только в порте 2. Функция chkmouse() недоступна. Это экономит память.

Предупреждения

ВНИМАНИЕ! Для правильной работы библиотечных функций системная рабочая область ДОЛЖНА находиться в диапазоне адресов 4000~C000 (страницы 1 и 2) - поэтому, если Ваша программа меньше, чем 0х4000, компилируйте и линкуйте её с параметрами -е4000 как минимум.
Таким образом, компилятору cc.com и ликовщику clink.com задается явный адрес начала области External, где находятся служебные вызовы некоторых встроенных бибилиотечных функций, в частности, обращения к функциям BIOS, SUBROM и MEMORY MAPPER. Использование для External областей памяти выше 0xBFFF также является недопустимым.

ВНИМАНИЕ! Кроме выделения рабочей области при помощи включения в Вашу программу стандартных заголовков GRPLIB0.H или GRPMSX1.H, для нормальной работы библиотечных функций требуется последующая ИНИЦИАЛИЗАЦИЯ этой рабочей области с помощью функции grpini() или gameini()/gameini2(). Если вы забудете вызвать одну из этих функций в начале Вашей программы — вы можете получить НЕПРЕДСКАЗУЕМЫЕ РЕЗУЛЬТАТЫ!

Пример 1.

/*+-----------------------------------------------------------+*/
/*| -- Образец правильного выполнения требований для MSX2: -- |*/
/*+-----------------------------------------------------------+*/
#include grplib0.h	/* выделение системной рабочей области */
 
char     foo, foo2;	/* глобальные переменные пользователя  */
unsigned bar, bar2;	/* глобальные переменные пользователя  */
 
main()	/* точка входа */
{
  int zot, zot2;	/* локальные переменные пользователя */
  grpini(); /* инициализация системной рабочей области */
  /* ниже используются библиотечные функции - см. описание */
  screen(5);
  palette(0, 0, 0, 0); color(15, 0, 0); cls();
  .
  .
  .
  zot=frotz(0);
  .
  .
  .
  EXIT	/* выход в MSXDOS */
}
 
int frotz(zap)
int zap;
{
  ...
}
/* ------------------- Конец образца -------------------- */

Пример 2.

.+---------------------------------------------------------+
.| ----- Образец задания на компиляцию и компоновку ------ |
.+---------------------------------------------------------+
cc gro
clink gro -f grplib4 grplib3 grplib2 grplib1 grpliba -e6000
. -------------------- Конец образца ----------------------

Примечания:

• точка «.» может быть использована в MSX-DOS вместо REM;
• если в файле GRO.CRL (результат работы компилятора BDS C) появляются функции с именами, такими же как и в файлах Библиотеки GRPLIB4.CRL … GRPLIB1.CRL — они заменяют соответствующие функции Библиотеки, так как находятся в командной строке clink ДО переключателя -f (см. BDS C clink) (этот приём используется для подключения функций пользователя вместо стандартных системных заглушек, находящихся в библиотеке (process1() … process9(), tickexit() — ), а также для исключения нежелательных библиотечных функций, которые подключаются автоматически (путём написания заглушек пользователем));
• порядок следования библиотечных файлов по убыванию их номеров

  … -f grplib5 grplib4 grplib3 grplib2 grplib1 grpliba …

  является существенным для clink, так как в противном случае clink не найдёт функции, на которые появятся отсылки «назад» (см. BDS C clink).

Раздел Библиотеки GRPLIB1

beep(n)
char n;

Подача звукового сигнала 'n' раз.

char *errmsg(errnum)
char errnum;

Расширенная версия стандартной функции errmsg() из библиотеки BDS C
!ПЕРЕОПРЕДЕЛЕНИЕ!

_fataler(mode, msg1, msg2)
char mode, *msg1, *msg2;

Аварийный выход из программы в MSX-DOS с установкой (без установки) Screen 0 и выдачей сообщения (сообщений).

Значения mode

grpini()

Инициализация рабочей области Библиотеки.

Внимание! ПОЧТИ НИЧЕГО НЕ БУДЕТ РАБОТАТЬ, ЕСЛИ ВЫ ЗАБУДЕТЕ НАПИСАТЬ grpini() или gameini() / gameini2() В НАЧАЛЕ ВАШЕЙ ПРОГРАММЫ!!!

screen(mode)
char mode;

Установить тип графического экрана:

• 0…8 для MSX2,
• 0…3 для MSX1.

Палитра не инициализируется. Используйте paletini(), если предполагается в дальнейшем использовать функции paletv() или paletrst().

cls()

только для MSX2 (см. gameini() для MSX1)

Очистка экрана. Применима к любому типу экрана 0…8.

sprctl(size, magn, disp, mode)
char size, magn, disp, mode;

Инициализация и настройка механизма работы со спрайтами. Используйте специальные имена из файла GRPLIB0.H в качестве параметров этой функции:

Если вы хотите оставить без изменения значения каких-либо параметров — пишите имя NONE

mode специфицирует механизм, используемый для управления спрайтами:

• SINGLE — каждое выполнение функции sprite() приводит к немедленной модификации участков VRAM, определяющих координаты и другие параметры, относящиеся к данному плану спрайта (Sprite Attribute Table модифицируется в специальной рабочей области библиотеки, называемой «спрайтовое зеркало» в RAM, после чего БЛОК этой области пересылается (отражается) в VRAM для одновременного изменения параметров ВСЕХ спрайтов, определённых одной функцией sprite()).
• SIMULTANEOUS — функция sprite() модифицирует спрайтовое зеркало, но не пересылает блок данных в VRAM — эта операция выполняется специальным скрытым от пользователя процессом каждый «тик» таймера в функции totick() — диспетчере параллельных процессов.

Этот скрытый процесс активируется только в случае задания mode = SIMULTANEOUS и пересылает каждый «тик» ВСЁ спрайтовое зеркало целиком из RAM в VRAM. Такой режим является более «мягким» и часто более эффективным для работы со спрайтами одновременно из нескольких параллельно выполняющихся процессов, но он постоянно занимает время процессора и делает лишние пересылки в Screen 0. Поэтому по умолчанию mode = SINGLE.

Вы можете «мягко» переходить из SINGLE в SIMULTANEOUS и наоборот во время выполнения программы без потери данных в спрайтовом зеркале. Работа этого механизма не зависит от TICKON / TICKOFF.

clrspr()

только для MSX2

Стирание всех спрайтов в VRAM и в спрайтовом зеркале.

clrspr() будет корректно работать только в том случае, если предварительно была вызвана функция screen() с параметром, отличным от нуля, а также sprctl() с определением размера спрайтов.

paletini()

только для MSX2

Инициализация палитры и VRAM для палитры. Не забудьте вызвать эту функцию, если будете использовать paletv() или paletrst().

Область сохранения для палитры может быть организована в разных областях VRAM в зависимости от того, какая страница VRAM была активна в момент использования paletini() — пожалуйста, будьте осторожны! (это одно из неудачных решений в SubROM).

только для MSX2

paletrst()

Восстановить палитру, запомненную в VRAM.

paletv(paletnum, r, g, b)
int paletnum, r, g, b;

только для MSX2

Установить цветовой код для палитры paletnum. В случае отрицательного значения какого-либо параметра старое значение остаётся без изменения. Это стандартная SubROM-версия, работающая с областью сохранения палитр в VRAM.

palette(paletnum, r, g, b)
int paletnum, r, g, b;

только для MSX2

То же самое, что и paletv(), но VRAM не используется для сохранения палитры. Область сохранения палитры организуется в рабочей области RAM Библиотеки. paletini() и paletrst() не работают с этой областью, поэтому Вам не надо их использовать, если вы работаете с palette(). Область сохранения палитр в рабочей области Библиотеки обнуляется во время выполнения grpini()

!!!Для работы с областью сохранения палитр в RAM!!!

GETPLT(paletnum, r, g, b)
/* macro */

только для MSX2

Запись в ваши переменные r, g, и b текущих значений Красного, Зелёного и Синего для палитры paletnum.

!!!Для работы с областью сохранения палитр в RAM!!!

paletrot(<список палитр>, 255)
char <список палитр>;

только для MSX2

«Вращение» влево палитр в списке палитр. Более мощный эквивалент «Colour Rotation» Yamaha Painter.

255 — признак конца списка палитр.

Примеры использования:

• paletrot(1,5,3,255);

  переписывает палитры: 3 → 5, 5 → 1, 1 → 3;

• paletrot(4,2,7,6,1,255);

  переписывает палитры: 1 → 6, 6 → 7, 7 → 2, 2 → 4, 4 → 1.

!!!Для работы с областью сохранения палитр в RAM!!!

paletblk()

только для MSX2

Установить палитры 0…15 в (0, 0, 0) — чёрный цвет.

!!!Для работы с областью сохранения палитр в RAM!!!

color(fg, bg, bd)
int fg, bg, bd;

Установить цвета экрана (номера палитр):

• fg — для переднего плана,
• bg — заднего плана,
• bd — бордюра.

page(display, active)
int display, active;

только для MSX2

Управление страницами VRAM для Screen 5…8.

char swpage()

только для MSX2

Обмен (swap) страниц active и display.

Возвращает номер страницы active

char swpaged()

только для MSX2

Обмен (swap) страниц active и display

Возвращает номер страницы display

showpage(mode)
char mode;

Отладочная функция, которая обычно стандартно подключается к каждой программе и вызывается диспетчером параллельных процессов с параметром 0 (showpage(0)). В этом режиме функция проверяет нажатие клавиш STOP и SELECT и, если они нажаты, захватывает управление. После этого, нажатие функциональных клавиш F1…F4 даёт возможность визуально проверить состояние всех страниц VRAM с плавным просмотром каждой страницы при помощи клавиш курсора, F5 возвращает управление в прерванную программу, STOP и F5 — возвращает управление MSX-DOS с выдачей статистики использования процессов и состояний почтовых ящиков.

ВНИМАНИЕ! Для сокращения объёма уже отлаженной программы можно исключить эту функцию на этапе компоновки, написав в тексте вашей программы заглушку с тем же именем:

showpage() { }

В этом случае она будет подключена к вашей программе вместо библиотечной функции showpage() (см. BDS C clink). Этот же метод можно использовать для исключения других нежелательных библиотечных функций, которые подключаются автоматически. Например, если вы не планируете использовать параллельные процессы — напишите заглушку:

totick() { }

и диспетчер параллельных процессов не будет подключён к вашей программе.

Функция showpage() может быть вызвана в вашей программе и в явном виде:

• showpage(1) захватит управление без проверки STOP и SELECT,
• showpage(2) завершит выполнение программы с выдачей статистики по параллельным процессам.

clrbuf()

Очистка буфера клавиатуры.

backup()

Восстановление параметров экрана из энерго-независимой памяти для MSX2 или стандартных значений из файла GRPMSX1.H для MSX1.

totick()

Диспетчер параллельных процессов.

Алгоритм работы:
Независимо от того, был или нет «тик» таймера, вызывается функция пользователя с именем process0(). В случае, если с момента предыдущего вызова totick() таймер не изменил своего значения (анализируется jiffy) — управление возвращается к вызвавшей totick() функции. Если же значение таймера изменилось (прошёл квант времени, равный как минимум одному «тику»):

• вызывается функция с именем showpage(),
• механизм работы со спрайтовым зеркалом (если активирован),
• механизм отслеживания абсолютных координат манипулятора «мышь» для MSX2 (если активирован,
• процесс пользователя с именем tickexit(),
• диспетчер циркулярной очереди процессов с именем _calproc(), который вызывает один из процессов пользователя с именами process1() … process9() (по одному на каждый «тик»).

После завершения выполнения всех вызванных функций, управление возвращается к вызвавшей totick() функции.

Процессы пользователя process0(), tickexit() и process1() … process9() могут сами обращаться к totick() во время их выполнения, так как в это время они блокируются диспетчером от нежелательной вложенности вызовов.

Обращения к totick() встроены в большинство стандартных функций Библиотеки и, поэтому, в программах, интенсивно использующих библиотечные функции, обращение к диспетчеру происходит с достаточной частотой для нормирования вызова процессов пользователя по каждому кванту таймера. Если же программа пользователя не обращается к диспетчеру достаточно часто (например, используется много арифметических вычислений) — для нормальной работы диспетчера рекомендуется вставлять обращения к нему в тексте программы в явном виде:

totick();

Функции process0(), tickexit() и process1() … process9() содержатся в Библиотеке в виде заглушек и автоматически заменяются на функции пользователя с такими же именами, если пользователь описал их в своей программе. Эта замена происходит на этапе компоновки программы при помощи clink.

TICKON
/* macro */

Активация механизма псевдо–прерываний — разрешение вызова функций process0(), tickexit() и process1() … process9() диспетчером параллельных процессов totick()

TICKOFF
/* macro */

Деактивация механизма псевдо–прерываний — запрет вызова функций process0(), tickexit() и process1() … process9()

Установлен по умолчанию после выполнения grpini()

TICKSTOP
/* macro */

Временная приостановка механизма псевдо-прерываний без изменения состояния TICKON / TICKOFF

Используется обычно в совокупности с TICKSTART

TICKSTART
/* macro */

Отмена TICKSTOP без изменения состояния TICKON / TICKOFF

Установлен по умолчанию после выполнения grpini()

MAXPROCS(n)
/* macro */

Определение максимального количества процессов в циркулярной очереди process1() … process9() (длины очереди). 0 ≤ n ≤ 9 . По умолчанию — 0 (ни одного). Вы можете изменять длину циркулярной очереди во время выполнения вашей программы. Следует заметить, что частота вызова каждой отдельной функции process1() … process9() обратно пропорциональна числу процессов в циркулярной очереди, определённому при помощи MAXPROCS().

ACTIVATE(pnum)
/* macro */

Активировать процесс pnum (0…9).

Внимание! Процесс может быть активирован, но, тем не менее, никогда не вызван, если его номер больше, чем число процессов, определённых при помощи MAXPROCS().

По умолчанию, после выполнения grpini() все процессы находятся в «активном» состоянии, но не выполняются, так как MAXPROCS(0).

DEACTIVATE(pnum)
/* macro */

Деактивировать процесс pnum (0…9). Процесс переводится в «пассивное» состояние — следующий процесс в циркулярной очереди анализируется на «активность».

PUTMAIL(boxnum,message,who)
/* macro */

Имеется 16 «простых» почтовых ящиков (0…15) без очередей. Вы можете положить в почтовый ящик boxnum (char) сообщение message (integer) и сообщить, кто его послал who (integer) другому (другим) процессам, которые могут проверять этот почтовый ящик. PUTMAIL() является макросом, возвращающим значение OK (0), если сообщение успешно положено в почтовый ящик, или ERROR (-1) в случае, если там уже что–то лежит и ещё никем не получено при помощи GETMAIL() (message ≠ 0).

Таким образом,

if (PUTMAIL(…) == ERROR) <ждите и пробуйте снова>

Конечно, в рамках Z80 и BDS C, message может быть, в том числе, и указателем на какие-либо данные или структуры.

В простых случаях, вы можете использовать почтовые ящики непосредственно, так как они имеют стандартные имена MAILBOX(0) … MAILBOX(15) (номер почтового ящика может быть переменной). Примеры:

• MAILBOX(5)=TRUE;

• if (MAILBOX(i) == 61) { ... }

GETMAIL(boxnum,messvar,sendvar)
/* macro */

Забрать сообщение из почтового ящика boxnum в переменную messvar, а идентификатор пославшего — в переменную sendvar.
messvar будет равна 0, если в ящике ничего нет. GETMAIL() устанавливает в 0 значение почтового ящика после того, как заберёт оттуда сообщение.

ABANDONWINDOW
/* macro */

Специальный тип почты, заставляющий последнее меню, открытое при помощи windsel() прекратить ожидание выбора альтернативы.

tickexit()

Системная заглушка для процесса пользователя. Напишите функцию с таким же именем — и она будет подставлена clink на этапе компоновки вместо заглушки.

Эта функция будет выполняться каждый «тик» таймера (при достаточном количестве обращений к totick()).

К tickexit() неприменимы операции ACTIVATE / DEACTIVATE — её выполнение зависит только от TICKON / TICKOFF и TICKSTART / TICKSTOP.

Выполняется только в состоянии TICKON и TICKSTART !!!

process1() ... process9()

Имена системных заглушек для процессов пользователя, находящихся в циркулярной очереди и получающих управление по одному на каждый «тик». К этим процессам применимы операции ACTIVATE / DEACTIVATE.

Выполняются только в состоянии TICKON и TICKSTART !!!

process0()

Имя системной заглушки для самого приоритетного процесса пользователя не квантизируемого по «тикам» таймера — он получает управление каждый раз, когда вызывается totick() вне зависимости от того был «тик» таймера или нет.

К этому процессу применимы операции ACTIVATE / DEACTIVATE.

Выполняются только в состоянии TICKON и TICKSTART !!!

P_COUNT0 ... P_COUNT9

Системные переменные.

10 внутренних счётчиков вызовов для процессов 0…9 (unsigned).

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

main()
{
  ...
  MAXPROCS(2)
  TICKON
  ...
}
 
process1()
{
  if (P_COUNT1 % 4) return;
  ...
}

В этом примере process1() будет фактически выполняться 1 раз за каждые 8 «тиков» таймера вместо обычного выполнения каждый второй «тик».

T_COUNT

Системная переменная.

То же самое, что и P_COUNT, но для tickexit().

waitvdp()

Ожидание обнуления бита 0 (Command Execution) статусного регистра 2 V9938 для MSX2. Количество «тиков» ожидания записывается в переменную _waitvdp (unsigned) в рабочей области библиотеки.

drowse(t)
unsigned t;

«Дремать» — пропустить t «тиков» таймера вызывая totick().

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

vpoke(addr, byte)
unsigned addr;
char byte;

Записать байт в VRAM.

char vpeek(addr)
unsigned addr;

Прочитать байт из VRAM.

writevdp(reg, byte)
char reg, byte;

Записать байт в регистр VDP и в соответствующий теневой регистр в RAM.

char readvdp(reg)
char reg;

Прочитать регистр VDP (из теневого регистра RAM).

char vdpstat(statreg)
char statreg;

Прочитать регистр статуса VDP (0…9 для V9938).

char stick(stick_no)
char stick_no;

Получить направление (0…8) с джойстика (0…2).

char trig(trig_no)
char trig_no;

Получить статус (TRUE/FALSE) кнопки триггера (0…4).

char pad(pad_no)
char pad_no;

Читать Paddle, Light Pen, Mouse, Track Ball.

int getjiffy()

Получить значение JIFFY MSX (2-байтовый счётчик, увеличивающийся каждый «тик» (1/60 или 1/50 секунды в зависимости от системы кодирования цвета NTSC/PAL).

char *deblank(to_str,from_str)
char *to_str,*from_str;

Перепись строки from_str в строку to_str с исключением всех пробелов и знаков табуляции. Возвращается указатель на строку to_str.

char *upshift(str)
char *str;

Приведение строки str к заглавным буквам ASCII. Используется функция toupper(). Возвращается указатель на строку str.

_rtovlw(radr,vadr,len)
unsigned radr,vadr,len;

Пересылка данных RAM → VRAM для нижних 64 кбайт VRAM.

В отличие от rtovlow() внутри функции не вызывается totick().

_vtorlw(vadr,radr,len)
unsigned radr,vadr,len;

Пересылка данных VRAM → RAM для нижних 64 кбайт VRAM.

В отличие от vtorlow() внутри функции не вызывается totick().

char movmap0(source,dest,count,mapper_page)
unsigned source,dest,count;
char mapper_page;

Обмен данными с RAM в Memory Mapper. Во время работы функции вместо текущей страницы 0 мэппированного слота RAM временно подставляется страница mapper_page из Memory Mapper.

Пересылка осуществляется с адреса source в адрес dest длиной count (1…0x4000) байтов. Во время пересылки, адреса 0…0x3FFF принадлежат подставленной странице Memory Mapper, а 0x4000…0xFFFF — текущей конфигурации RAM. После пересылки для нулевой страницы мэппированного слота восстанавливается текущая конфигурация RAM и управление возвращается в вызывающую программу. Таким образом, вы можете записывать/читать данные из любой страницы Memory Mapper блоками не более 16 Кбайт за одно выполнение movmap0(), a также осуществлять пересылки внутри подставленной страницы, если и source и dest находятся в пределах 0…0x3FFF.

Во время выполнения grpini() системной переменной MEMORY_MAPPER присваивается значение TRUE/FALSE в зависимости от того, оснащён ли данный компьютер аппаратурой Memory Mapper. Вы можете анализировать эту переменную в своей программе и, в зависимости от этого, так или иначе строить алгоритм работы программы:

if (MEMORY_MAPPER) { ... }
else { ... }

Кроме того, grpini() создаёт специальный байт _mapmask, для указания, какие страницы Memory Mapper активны в данном компьютере. Например: значение 0xF8 (1111 1000) для _mapmask означает, что в Memory Mapper активны только 3 бита (нули) и, следовательно, Вам доступны 8 страниц RAM по 16 кбайт каждая.

Дополнительно, функция movmap0() возвращает следующие коды:

• 0 — OK
• 1 — Memory Mapper не найден
• 2 — не найден RAM по адресу dest

В случае выполнения функции с кодом возврата, отличным от 0 — системная переменная MEMORY_MAPPER автоматически устанавливается в FALSE.

unsigned geteda(dataname)
char *dataname;

Получение адреса данных, прикомпонованых к программе при помощи утилиты Extra Data Linker (EDL.COM).

Любые данные (экраны, библитеки знакомест, таблицы и пр.), могут быть пркомпонованы к вашему COM-файлу при помощи EDL с тем, чтобы быть использованными во время работы программы без дополнительных обращений к диску. Функция geteda() возвращает адрес таких данных, прикомпонованых после области External, или 0, если данные не найдены. Каждый прикомпонованый набор данных имеет 15-байтовый заголовок, который, в свою очередь, содержит 2-байтовое слово с длиной набора данных + 15 (длина заголовка) и 13-байтовую строку с именем набора данных, оканчивающуюся двоичным нулём. Так как за одно выполнение [#EDL.COM|EDL]] к COM-файлу может быть прикомпонован более чем один набор данных, эти 13-байтовые строки служат идентификаторами каждого набора данных.

geteda() ищет набор данных с именем dataname (имя предварительно подвергается операциям upshift и deblank) и возвращает точный адрес данных (адрес первого байта после заголовка) или 0.

Длину прикомпонованых данных можно узнать, прочитав слово (2 байта) по адресу geteda()-15.

Примечание. В качестве имён данных Extra Data Linker использует имена файлов, сообщаемых ему в командной строке. При этом, префикс дисковода (если присутствует) не попадает в имя набора данных, а суффикс (.<расширение>) является неотъемлемой его частью. Таким образом, dataname, как параметр функции, должен включать в себя суффикс имени файла, указанного в командной строке EDL (если файл имеет суффикс).

unsigned geteda2(dataname,base)
unsigned dataname,base;

То же самое, что и geteda(), но набор данных может быть прикомпонован начиная с адреса base.

EDL версии 1.01 и выше может прикомпоновывать данные не только к концу области External (-f), но и к концу кодовой части программы (-c) или к началу области External (-e).

Поэтому вы можете вызывать geteda2() следующим образом:

• geteda2(<file>,codend()) для -c (конец кода),
• geteda2(<file>,extrns()) для -e (начало External),
• geteda2(<file>,endext()) для -f (конец External «free RAM»).

Образец использования geteda2():

char *p,*c_end;
if (!(p=geteda2("data",c_end=codend()))) swapin("data",p=c_end);

В этом примере при помощи geteda2() проверяется наличие файла data (без суффикса), прикомпонованого к концу кодовой области программы (был использован переключатель -c EDL), и, в случае его наличия, указателю p присваивается адрес начала данных файла data. В противном случае (если p = 0) — файл загружается в память с диска (в обоих случаях предполагается, что между концом кодовой части программы и началом области External существует достаточно места для размещения файла data). Этот приём удобно использовать при написании программы в том случае, когда данные, используемые программой, могут претерпевать частые изменения в процессе отладки и подготавливаются каким-либо специальным редактором (например, графика, разрабатываемая при помощи Pattern Composer). Таким образом, во время отладки данные могут просто загружаться с диска без использования EDL, а в готовой программе — составлять единое целое с COM-файлом, прикомпонованые к ней без перекомпиляции программы следующим образом (см. описание утилиты Extra Data Linker):

A>edl prog progdat -c data

Функции geteda() и geteda2() удобно использовать вместе с функцией expand().

setdi()

При помощи setdi() вы можете подавить все команды EI (Еnable Interrupt) в кодовой части Библиотеки, которая выполняет обращениe к BIOS / SubROM и, поэтому, чаще всего будете получать управление обратно в режиме DI (Disable Interrupt) — это зависит от работы конкретных точек входа BIOS / SubROM.

setei()

Функция, обратная setdi() — включает все команды EI (Enable Interrupt) в кодовой части Библиотеки, которые могли быть выключены setdi().

Гарантируется возврат управления в вашу программу в режиме EI (Enable Interrupt). Этот режим установлен по умолчанию, так как в противном случае многие системные механизмы MSX не будут работать в отсутствие прерываний.

char *inith(addr,str)
char *addr,*str;

Инициализация памяти при помощи шестнадцатеричных цифр, записанных в виде литеральной строки. Все не-шестнадцатеричные символы игнорируются.

Например:

inith(buf,"FF A|B.01 v 2");

инициализирует buf как FFAB0120. Обратите внимание на то, что последний нуль появляется из-за нечётного количества шестнадцатеричных символов в исходной строке. Возвращает указатель на <последний записанный байт> + 1, то есть адрес следующего «свободного» байта.

unsigned expand(from, to)
unsigned from, to;

Экспандировать (расширить, развернуть) данные, компрессированные (сжатые) при помощи утилиты FCX.COM и находящиеся по адресу from.

Экспандированные данные разместить в памяти по адресу to.

Возвращает длину экспандированных данных.

unsigned getparm(n_arg, arg0_adr)
unsigned n, *arg0_adr;

Возвратить параметр n_arg (0…n) из списка параметров функции с переменным (неопределённым) числом аргументов.

Пример:

main()
{
  foo(0, 1, 2, "text");
}
 
  foo(args)
  unsigned args;
{
  printf("%d %s",getparm(2, &args), getparm(3, &args));
}

В результате выполнения этой программы будет выведено на экран:

2 text

Примечание: альтернативным (и более быстрым) способом извлечения аргументов по номеру является использование макросов VARPARMS() и PARM().

Раздел Библиотеки GRPLIB2 (ТОЛЬКО ДЛЯ MSX2)

dtov(fname, dx, dy, dir, lop)
char *fname, dir, lop;
unsigned dx, dy;

Загрузка в VRAM файла fname. Файл загружается начиная с координат dx,dy VRAM с направлением передачи данных dir и применением логической операции lop. Размер файла (ширина и высота в точках) записывается в первых двух словах этого файла — это формат оператора COPY MSX BASIC 2.0 и «Data» Yamaha Painter. Используйте специальные ключевые слова из стандартного заголовка GRPLIB0.H:

• для dir
  • R_D — вправо вниз,
  • L_D — влево вниз,
  • R_U — вправо вверх,
  • L_U — влево вверх;
• для lop без прозрачного цвета:
  • PSET или IMP,
  • AND,
  • OR,
  • XOR или EOR,
  • NOT или PRESET;
• для lop с прозрачным цветом:
  • TPSET или TIMP,
  • TAND,
  • TOR,
  • TXOR или TEOR,
  • TNOT или TPRESET.

ВНИМАНИЕ! Эта функция использует точку входа в SubROM, которая работает некорректно — а именно, затирает вторую страницу RAM (0x8000…0xBFFF). Будьте осторожны!

vtod(fname, sx, sy, width, height, dir, lop)
char *fname, dir, lop;
unsigned dx, dy, width, height;

Запись на диск в файл fname информации из VRAM. Файл записывается начиная с sx,sy VRAM с направлением передачи данных dir и применением логической операции lop. Ширина прямоугольного блока данных из VRAM задаётся width, высота — height (в точках). Используйте специальные ключевые слова из стандартного заголовка GRPLIB0.H для dir и lop (см. dtov()).

ВНИМАНИЕ! Эта функция использует точку входа в SubROM, которая работает некорректно — а именно, затирает вторую страницу RAM (0x8000…0xBFFF). Будьте осторожны!

dtor(fname,start_adr, end_adr)
char *fname;
unsigned start_adr, end_adr;

Загрузка файла fname в RAM.

rtod(fname, start_adr, end_adr)
char *fname;
unsigned start_adr, end_adr;

Сохранение блока данных из RAM в файле fname.

Специальный набор дисковых функций: дисковый ввод/вывод для VRAM MSX2.

char dtova2(fname, dx, dy)
char *fname;
unsigned dx, dy;

Загрузка файла в активную страницу VRAM с диска. Эта функция «понимает» компрессированный формат данных (ширина < 0, то есть -width). Вы можете дополнительно специфицировать тип данных, которые вы загружаете установкой системной переменной _picture в состояние TRUE (по умолчанию) или FALSE. Для этой функции dir = R_D, lop = PSET в любом случае её использования.

Если вы установили _picture = FALSE, данные не анализируются на наличие заголовка width/heght и загружаются в VRAM последовательно до обнаружения ситуации EOF. dtova2() возвращает ОК (0) или номер ошибки для errmsg(), если ошибка имела место при чтении информации с диска.

SubROM не используется, поэтому эта функция работает корректно.

Внимание! Иногда вы можете получать неожиданные результаты, если адреса загрузки VRAM пересекают границу 0xFFFF…0x10000. Это связано с некоторыми особенностями V9938 — рекомендуем в этих случаях использовать раздельную загрузку нижних и верхних 64 кбайт VRAM.

rtova2(radr, dx, dy)
unsigned radr, dx, dy;

Пересылка данных из RAM в активную страницу VRAM с координатами dx,dy. Эта функция также «понимает» компрессированный формат данных (ширина < 0, то есть -width). Вы так же можете дополнительно специфицировать тип данных, которые вы пересылаете установкой системной переменной _picture в состояние TRUE (по умолчанию) или FALSE. Для этой функции dir=R_D, lop=PSET в любом случае её использования. SubROM не используется.

char vtoda2(fname, sx, sy, width, height)
char *fname;
unsigned sx, sy, width, height;

Сохранение данных из активной страницы VRAM (координаты sx,sy, размеры width и height) в файле fname. Функция является обратной по отношению к dtova2(). Компрессор данных не имплементирован из-за сравнительно большого объёма занимаемой им оперативной памяти. vtoda2() возвращает ОК (0) или номер ошибки для errmsg(), если ошибка имела место при записи информации на диск.

SubROM не используется.

Примечание. Для компрессии файлов в подобных форматах автором разработана программа Picture Compressor, которая не входит в состав ПС «МАЭСТРО» и может быть в дальнейшем поставлена по специальному заказу. Эта утилита разработана специально для визуальной компрессии/экспандирования графических данных в формате COPY (Data) Screen 5.

vtodpage(fname, page_no, len)
char *fname, page_no;
unsigned len;

Прямой dump страницы page_no VRAM в файл fname объемом len байт.

Dump всегда начинается с начала страницы (0…3 для Screen 5 или 6 и 0…1 для Screen 7 или 8) с координатами (0; 0) и включает данные в VRAM длиной len байт.

vtodpage() возвращает ОК (0) или номер ошибки для errmsg(), если ошибка имела место при записи информации на диск.

SubROM не используется.

char xtova2(fname, dx, dy)
char *fname;
unsigned dx, dy;

Эта функция сначала проверяет Extra Data для конца области External (переключатель '-f', см. geteda() и Extra Data Linker) и, в случае, если данные с именем fname (upshifted & deblanked) найдены, пересылает их в dx,dy VRAM. В противном случае xtova2() пытается загрузить файл с именем fname с диска. Эта функция «понимает» компрессированый формат данных.

xtova2() возвращает ОК (0) или номер ошибки для errmsg(), если ошибка имела место при чтении информации с диска.

SubROM не используется.

vtov(sx, sy, dx, dy, width, height, dir, lop)
unsigned sx, sy, dx, dy, width, height;
char dir, lop;

Пересылка из sx,sy VRAM в dx,dy VRAM прямоугольного блока размером width,height. Направление пересылки — dir, логическая операция — lop (см. dtov()). Используется SubROM.

vtovb(sx, sy, dx, dy, width, height, dir)
unsigned sx, sy, dx, dy, width, height;
char dir;

Высокоскоростная пересылка без логических операций из sx,sy VRAM в dx,dy VRAM прямоугольного блока размером width,height. Направление пересылки — dir (см. dtov()). Горизонтальный размер и начало блока автоматически выравниваются на границу БАЙТА (не точки!).

SubROM не используется.

rtov(sadr, dx, dy, dir, lop)
unsigned sadr, dx, dy;
char dir, lop;

Пересылка блока, имеющего заголовок ширины и высоты из RAM в dx,dy VRAM. Направление пересылки — dir, логическая операция — lop (см. dtov()).

Используется SubROM.

vtor(sx, sy, width, height, radr, dir)
unsigned sx, sy, dx, dy, width, heigth, radr;
char dir;

Пересылка блока из sx,sy VRAM в RAM по адресу radr размерами width,height. Направление пересылки — dir.

Используется SubROM.

vtova(sx, sy, dx, dy, width, height, dir, lop)
unsigned sx, sy, dx, dy, width, height;
char dir,lop;

Пересылка из sx,sy VRAM в dx,dy VRAM прямоугольного блока размером width,height.

Направление пересылки — dir, логическая операция — lop (см. dtov()).

Используется SubROM.

rtova(sadr, dx, dy, dir, lop)
unsigned sadr, dx, dy;
char dir, lop;

Пересылка блока, имеющего заголовок ширины и высоты из RAM в dx,dy VRAM.

Направление пересылки — dir, логическая операция — lop (см. dtov()).

Используется SubROM.

rtovlow(radr, vadr, len)
unsigned radr, vadr, len;

Пересылка len байт из RAM в нижние 64 кбайт VRAM.

SubROM не используется.

rtovhi(radr, vadr, len)
unsigned radr, vadr, len;

Пересылка len байт из RAM в верхние 64 кбайт VRAM.

SubROM не используется.

vtorlow(vadr, radr, len)
unsigned vadr, radr, len;

Пересылка len байт из нижних 64 кбайт VRAM в RAM.

SubROM не используется.

vtorhi(vadr, radr, len)
unsigned vadr, radr, len;

Пересылка len байт из верхних 64 кбайт VRAM в RAM.

SubROM не используется.

Раздел Библиотеки GRPLIB3

Функции рисования для MSX2 (Screen 5…8)

pset(x, y, cl)
int x, y;
char cl;

Рисовать точку с координатами x,y на активной странице цветом cl.

char point(x, y)
int x, y;

Получить цвет точки с координатами x,y на активной странице.

line(x1, y1, x2, y2, cl, lop)
int x1, y1, x2, y2;
char cl, lop;

Рисовать линию с координатами x1,y1 — x2,y2 на активной странице цветом cl с логической операцией lop.

box(x1, y1, x2, y2, cl, lop)
int x1, y1, x2, y2;
char cl,lop;

Рисовать прямоугольник с координатами x1,y1 — x2,y2 на активной странице цветом cl с логической операцией lop.

boxf(x1, y1, x2, y2, cl, lop)
int x1,y1, x2, y2;
char cl,lop;

Рисовать закрашенный прямоугольник с координатами x1,y1 — x2,y2 на активной странице цветом cl с логической операцией lop.

Вывод символов на графический экран MSX2 (Screen 5…8)

pstep(px, py)
int px, py;

Задать горизонтальный/вертикальный шаг (расстояние в точках) для вывода символов на графический экран (по умолчанию 8 по обеим осям).

gputch(x, y,fcl, bcl, c)
int x, y, fcl, bcl;
char c;

Вывести символ c цветом fcl на графический экран с координатами x,y, предварительно нарисовав под ним закрашенный прямоугольник цветом bcl.

Прямоугольник может быть невидимым, если для него используется цвет (палитра) 0 — это применимо также для всех остальных функций вывода строк на графический экран.

Функция gputch() не распознает символ перевода строки \n

gputs(x, y, fcl, bcl, str)
int x, y, fcl, bcl;
char *str;

Вывести строку str цветом fcl на графический экран с координатами x,y предварительно рисуя под каждым символом закрашенный прямоугольник цветом bcl.

Прямоугольник может быть невидимым,если для него используется цвет (палитра) 0.

Функция gputs() не распознает символ перевода строки \n

gputs6(x, y,fcl, bcl, str)
int x, y, fcl, bcl;
char *str;

Вывести строку str цветом fcl на графический экран с координатами x,y предварительно рисуя под каждым символом закрашенный прямоугольник цветом bcl.

Прямоугольник может быть невидимым, если для него используется цвет (палитра) 0. Все символы выводятся с шагом 6 точек по горизонтали независимо от того, какие значения были заданы при помощи pstep() и не изменяя этих значений. Это удобно при многозадачном использовании, так как ресурсы px,py pstep() являются общими для всех задач.

Функция gputs6() не распознает символ перевода строки \n

gprintf(x, y, fcl, bcl, format, arg1, ..., argN)
int x, y, fcl, bcl;
char *format;

Форматированный вывод на графический экран (см. printf() BDS C для детального описания всех форматов вывода данных).

По символу перевода строки \n выполняется стандартная операция CR LF при которой x устанавливается в 0, а y+=py (см. pstep()).

gdump(x, y, fcl, bcl, start_adr, end_adr)
int x, y, fcl, bcl;
unsigned start_adr,end_adr;

Шестнадцатеричный dump памяти на графический экран, начиная со start_adr и кончая end_adr.

char *sprintf(buf, format, arg1, ..., argN)
char *buf, *format;

То же самое, что и обычный sprintf() BDS C, но возвращает указатель на buf для вложенного использования в других функциях.
!!!ПЕРЕОПРЕДЕЛЕНИЕ!!!

char *fmt(format,arg1,...,argN)
char *format;

Функция аналогичная *sprintf(), но использующая системный буфер _pbuf[32] для форматирования строк. Удобна для компактной записи таких операторов как

putstrt(y,x,fmt("%d",n));

Если вы ограничены по объёму памяти External и не планируете использовать эту функцию, то можете написать

#define NO_PBUF

перед

#include grpmsx1.h

или

#include grplib0.h

char *trt(str)
char *str;

Перекодировка строки с использованием таблицы _trtab1 длиной 256 байт. (эта же таблица используется в функции putstrt())

Функция возвращает указатель на переданную ей строку str.

Пример использования:

trt(fmt("<format string>",vars));

Текстовые функции для Screen 0 (X: 1…80, Y: 1…24)

char posx()

Возвратить текущую X-координату текстового курсора.

char posy()

Возвратить текущую Y-координату текстового курсора.

locate(tx, ty)
char tx, ty;

Поместить текстовой курсор в позицию tx (1…80), ty (1…24).

putsxy(tx, ty, str)
char tx, ty, *str;

Вывести строку str непосредственно в VRAM с координатами tx (1…80), ty (1…24).

Внимание! Позиция текстового курсора не изменяется!

char getchrv(tx, ty)
char tx, ty;

Возвратить код символа, находящегося на экране в позиции tx (1…80), ty (1…24).

Внимание! Позиция текстового курсора не изменяется!

putchrv(tx, ty, c)
char tx, ty, c;

Поместить символ непосредственно в VRAM в позицию экрана tx (1…80), ty (1…24).

Внимание! Позиция текстового курсора не изменяется!

char inline(tx, ty, len, buf)
char tx, ty, len, *buf;

Вводить не более len символов с клавиатуры компьютера с отображением их на экране начиная с позиции tx (1…80), ty (1…24) и записью в buf. Завершающие ввод пробелы (если присутствуют) усекаются в buf, размер которого должен быть как минимум len+1 для записи завершающего строку двоичного нуля. Нажатие Ввод ⏎ (CR — признак конца ввода.)

Возвращает длину строки в buf. Нажатие клавиш ESC или STOP приводит к прекращению ожидания ввода с клавиатуры с возвратом длины 0.

Внимание! Позиция текстового курсора не изменяется!

clrtxt()

Очистить текстовой экран.

dline(lnum)
char lnum;

Удалить на экране строку lnum (1…24).

iline(lnum)
char lnum;	

Вставить на экране строку lnum (1…24).

Функции для работы с оконными меню в Screen 5…8

paletwin(fg, bg)
char fg, bg;

Установить цвета (палитры) переднего и заднего плана для оконных меню. По умолчанию 7, 8.

char swpaletw()

Обменять (swap) текущие палитры переднего и заднего плана для оконных меню. Вернуть палитру переднего плана.

char windsel(x, y, head, alt1, ..., alt23)
unsigned x, y;
char *head, *alt1, ..., *alt23;

Открыть оконное меню на активной странице VRAM (временно назначив активную страницу на страницу, показываемую на экране) и возвратить номер выбранной оператором альтернативы alt1, …, alt23. Возвратить RESUME (1) без ожидания выбора альтернативы в случае, если присутствует только один заголовок меню (header) или заголовок и только одна альтернатива (alt1).

Меню управляется мышью из порта 1 или 2 или клавишами курсора, если мышь не подключена к компьютеру (распознаётся автоматически).

В случае использования клавиш курсора, клавиша ПРОБЕЛ выполняет функцию левой кнопки мыши (DO), а ESC — правой (UNDO). Если нажата клавиша UNDO, windsel() возвращает значение UNDO (255).

Во время ожидания ответа оператора эта функция вызывает totick() для нормального выполнения параллельных процессов и может быть абортирована при помощи ABANDONWINDOW — в этом случае windsel() возвращает значение ABORT (0).

Внимание! Для нормального выполнения параллельных процессов рекомендуется вызывать windsel() из главной программы или из process0().

rewindow(mother_page)
char mother_page;

Восстановить область на активной странице, затёртую группой последовательно выведенных оконных меню, используя материнскую страницу mother_page (0…3) с эталоном изображения. Это возможно, так как все последовательно выводимые оконные меню накапливают граничные координаты используемых ими областей экрана до тех пор, пока rewindow() не сбросит их в ноль.

Раздел Библиотеки GRPLIB4

lsphex(patnum, hexstr)
char patnum, *hexstr;

Записать в VRAM Sprite Generator Table начиная со спрайта patnum конфигурацию спрайта (спрайтов), заданную литеральной строкой с шестнадцатеричными цифрами (аналогично inith()). Несколько подряд идущих спрайтов могут быть инициализированы за одно выполнение lsphex()

lsphex8(patnum, hexstr1, ..., hexstr8)
char patnum, *hexstr1, ..., *hexstr8;

То же самое, что lsphex(), но, для удобства, слишком длинная литеральная строка может быть разбита на максимум 8 более коротких строк. Если общее количество таких строк меньше 8 — последняя строка должна быть пустой: ""

lspmem(patnum, sadr, eadr)
char patnum;
unsigned sadr, eadr;

Записать в VRAM Sprite Generator Table начиная со спрайта patnum конфигурацию спрайта (спрайтов), заданную в RAM начиная с адреса sadr и кончая адресом eadr.

Ограничения на длину записываемых данных отсутствуют.

char getpat(patnum, buf)
char patnum, *buf;

Переписать конфигурацию спрайта patnum из VRAM Sprite Generator Table в buf (8 или 32 байта в зависимости от размеров спрайтов).

lschex(planenum, hexstr)
char planenum, *hexstr;

Только для SCREEN 4…8 MSX2

Загрузить цвет спрайта (построчную окраску, 16 байт), ассоциированный с планом спрайта = planenum из литеральной строки с шестнадцатеричными цифрами (аналогично inith()). Несколько подряд идущих планов спрайтов могут быть инициализированы за одно выполнение lschex(). Каждый из 16 байт имеет следующую структуру:

{ EC  CC  IC  0  <colour code 0…15> }

lschex8(planenum, hexstr1, ..., hexstr8)
char planenum, *hexstr1, ..., *hexstr8;

Только для SCREEN 4…8 MSX2

Используется аналогично lsphex8()

lscmem(planenum, sadr, eadr)
char planenum;
unsigned sadr, eadr;

Только для SCREEN 4…8 MSX2

Загрузить цвета планов спрайтов начиная с planenum из RAM с адресов sadr по eadr

Ограничения на длину записываемых данных отсутствуют.

char getcol(planenum, buf)
char planenum, *buf;

Только для SCREEN 4…8 MSX2 Переписать цвет плана спрайта planenum в buf (16 байт) и вернуть количество значащих байт (8 или 16) в зависимости от размера спрайтов.

sprite(planenum, patnum1, x1, y1, patnum2, x2, y2, ..., patnumN, xN, yN)
char planenum, patnum1, x1, y1, patnum2, x2, y2, ..., patnumN, xN, yN;

Ассоциировать группу последовательно идущих планов спрайтов начиная с planenum со спрайт-паттернами patnum1…patnumN и вывести их на экран соответственно в позициях (x1; y1)…(xN; yN) одновременно. Если очередной patnum (исключая первый) равен нулю — считается что список параметров функции исчерпан (это функция с переменным числом параметров). При выводе спрайтов на экран автоматически производится коррекция координаты Y каждого плана спрайта на -1 (компенсация неудачного решения в VDP). Функция sprite() применима как к MSX1, так и к MSX2.

Координаты спрайтов всегда находятся в диапазоне 0…255 (в том числе и для Screen 6, 7 — см. V9938).

char diskdir(dirmask, buf1700)
char *dirmask, *buf1700;

Поместить оглавление диска в buf1700 (длиной 1700 байт).

Каждая точка входа, полученная при помощи diskdir(), имеет длину 15 байт и следующую структуру:

d:ffffffff.sss\0

diskdir() возвращает количество точек входа, помещённых в buf1700, и релевантных dirmask

dirmask является символической строкой (оканчивающейся двоичным нулём) в стандартной нотации MSX-DOS:

[drive:]filename[.suffix]\0

которая может включать в себя символы * и ?, а также дополнительный символ ! ([AND] NOT). Примеры:

*.com!ab*.com!cde.com

означает все COM-файлы кроме начинающихся с ab и cde.

!*.c

означает все файлы, кроме имеющих суффикс .c

Пустая строка:

dirmask ("")

эквивалентна *.*

sortdir(buf1700,n_entry)
char *buf1700,n_entry;

Сортировать n_entry точек входа в оглавление buf1700, полученных после выполнения diskdir(). Сортировка производится в полуинверсной форме:

d:sss.ffffffff

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

d:ffffffff.sss

Вы можете использовать функцию qsort() BDS C для сортировки точек входа обычным образом.

Работа со звуковым генератором (PSG).

wpsg(reg, byte)
char reg, byte;

Записать byte в регистр reg PSG

char rpsg(reg)
char reg;

Читать байт из регистра reg PSG

sndreset()

Сброс PSG в начальное состояние.

sound(r0, ..., r13, ctrl, waveform, modstep, modwidth, chanconfig, duration)
int r0, ..., r13, ctrl;
char waveform, modstep, modwidth, chanconfig;
unsigned duration;

Генерировать звук при помощи PSG и программного Extra LFO для частотной модуляции звука. Значения r0…r13 загружаются в соответствующие регистры PSG (отрицательные значения игнорируются). Если ctrl не равен нулю, то используется Extra LFO для каналов PSG, определяемых байтом chancofig:

0000 ABCN
     ││││
     │││└── 1: модулировать шум
     ││└─── 1: модулировать канал C
     │└──── 1: модулировать канал B
     └───── 1: модулировать канал А

При этом:

Функцией sound() автоматически вызывается totick() для обеспечения возможности параллельного выполнения других процессов во время генерации звуков, имеющих большу́ю длительность (duration).

Примечание. Для упрощения разработки и создания новых звуковых эффектов автором разработана утилита PSG Extra Editor, которая позволяет создавать звуки в режиме полноэкранного редактирования всех параметров функции sound() и сохранять/загружать банки звуков в виде ASCII-файлов, содержащих готовые к вставке в программу операторы sound(). Эта утилита не входит в состав ПС «МАЭСТРО» и может поставляться в дальнейшем по отдельному заказу.

sound1(str)
char *str;

Альтернативная версия функции sound() для управления только каналом #1 (А) PSG. Эту функцию удобно использовать для создания отдельных звуковых эффектов в канале #1 во время исполнения какой–либо музыки, разработанной с использованием ПС «МЕДИА» для системной музыкальной очереди MSX. Кроме этого, sound1() является более компактным вариантом функции sound() (как по объёму генерируемого кода, так и по данным).

Строка str представляет собой последовательность байтов следующего вида:

где:

Примечание 1. Формат записи строки для sound1() также поддерживается утилитой PSG Extra Editor (см. примечание выше).

Примечание 2. ПС «МЕДИА» не является компонентой ПС «МАЭСТРО» и разработано другим автором для использования совместно с ПС «МАЭСТРО». ПС «МЕДИА» может быть поставлено по дополнительному заказу и включает в себя интерактивный музыкальный редактор с расширенными средствами музыкального макроязыка MML+, а также специальный раздел Библиотеки функций для работы с данными, порождёнными при помощи этого музыкального редактора и музыкальными очередями из программ, написанных на BDS C в рамках ПС «МАЭСТРО». Кроме того, этот раздел библиотеки включает некоторые дополнительные общесистемные функции, не входящие в Библиотеку функций ПС «МАЭСТРО».

unsigned ltape(mode, adr, count)
char mode;
unsigned adr, count;

Загрузить не более count байтов данных с магнитной ленты размещая их в RAM, начиная с адреса adr.

Загрузка может быть прервана по нажатию CTRL+STOP или из-за ошибки считывания с магнитной ленты. Мотор включается и выключается автоматически. Возвращается остаточный счётчик.

Работает в режиме DI(Disable Interrupt).

Значения для mode:

unsigned dtape(mode, adr, count)
char mode;
unsigned adr, count;

Записать на магнитную ленту count байтов данных начиная с адреса adr. Загрузка может быть прервана по нажатию CTRL+STOP. Мотор включается и выключается автоматически. Возвращается остаточный счётчик (не 0, если запись была прервана при помощи CTRL+STOP).

Работает в режиме DI (Disable Interrupt).

Значения для mode:

hcopy0(firstlin, lastlin)
char firstlin, lastlin;

Копировать на принтер экран начиная со строки firstlin (1…24) и кончая строкой lastlin (1…24) для Screen 0.

hcopy2()

Копировать на MSX-принтер весь экран для Screen 2.

lprint(adr, count)
unsigned adr;
char count;

Вывести на принтер count байт начиная с адреса adr непосредственно через MSX-DOS (не используя lprintf() BDS C). Эту функцию, в том числе, удобно использовать для посылки кодов управления принтером.

lprint2(adr, count)
unsigned adr;
char count;

То же самое, что и lprint(), но все знаки табуляции заменяются на соответствующее (вычисляемое) число пробелов не более 8.

lprintf2(format, args...)

То же самое, что и lprintf() BDS C, но все знаки табуляции заменяются на соответствующее (вычисляемое) число пробелов не более 8.

ldump(sadr, eadr)
unsigned sadr, eadr;

Дамп ОЗУ с адреса sadr по адрес eadr на принтер.

unsigned blockmem(blksize)
unsigned blksize;

Получить количество блоков памяти размером blksize (без выделения этой памяти), которое в текущий момент можно разместить в RAM при помощи alloc() или sbrk()

Внимание!

Функция alloc() BDS C (в отличие от sbrk()) не может выделять память блоками более 32 кбайт — это связано с тем, что одна из переменных в alloc() описана как int вместо unsigned.

Это ЕДИНСТВЕННАЯ ошибка(?), которую автор Библиотеки обнаружил в BDS C v1.50a за более чем три года интенсивной эксплуатации этой системы. Здесь же отметим, что ошибочная ситуация со стеком при автоматическом вызове cc2.com из cc.com порождена отличием MSX-DOS 1.03 от MSX CP/M, а не ошибкой BDS C. Это отличие компенсировано автором Библиотеки небольшим изменением кода cc.com (вместе с добавлением обнуления счётчиков времени для утилиты DURATION.COM). Изменённую версию cc.com можно идентифицировать по номеру версии, выводимому на экран во время выполнения cc.com (v1.50aR вместо v1.50a).

dump(sadr, eadr)
unsigned sadr, eadr;

Дамп ОЗУ с адреса sadr по адрес eadr на экран для Screen 0.

char rwsector(operation, drive, from_sec, count,buf)
char operaiton, drive, count, *buf;
unsigned from_sec;

Запись и чтение информации с диска по секторам с возвратом системного кода ошибки (если ошибка имела место при выполнении операции).

Возвращает:

Примечание.
Некоторые ROM, обеспечивающие работу MSX с диском,могут выдавать коды ошибок, несколько отличающиеся от приведённых выше.

speech(data_adr, data_len)
unsigned data_adr, data_len;

Произнести данные, подготовленные при помощи программы «Master Voice» Ван дер Путтена.

int swapin2(fname, adr, maxlen)
char *fname;
unsigned adr, maxlen;

Альтернативная версия swapin() BDS C. Проверяет размер файла на диске перед загрузкой его в память и сравнивает его с maxlen. Возвращает отрицательный размер файла в байтах в случае, если его длина превышает maxlen или ERROR (-1) в случае любой ошибки ввода/вывода. Если файл успешно загружен в память по адресу adr — возвращает длину файла в байтах.

int swapout(fname, adr, len)
char *fname;
unsigned adr, len;

Запись данных, находящихся по адресу adr длиной len байт в дисковый файл fname. Возвращает ERROR (-1) в случае любой ошибки создания/записи/закрытия файла (включая переполнение диска).

Раздел Библиотеки GRPLIB5 (ТОЛЬКО ДЛЯ MSX1)

ВНИМАНИЕ! Данный раздел библиотеки опирается на терминологию, используемую в программе Pattern Composer. Для ознакомления с ней рекомендуется изучить её.

Кроме этого, рекомендуется ознакомиться с описанием утилиты Extra Data Linker и библиотечной функцией geteda2().

sprite1(baseplan, PAT1, x1, y1, col1, ..., PAT4, x4, y4, col4)
char baseplan, PAT1, PAT2, PAT3, PAT4, x1, y1, x2, y2, x3, y3, x4, y4, col1, col2, col3, col4;

Функция, аналогичная sprite(), но имеющая прямое управление цветом спрайта (MSX1) и выводящая не более 4 спрайтов одновременно. В случае, если используется менее 4 спрайтов — записывается 0 вместо PAT2…PAT4 после цвета последнего использованного спрайта.

sprcol1(plane, colr)
char plane, colr;

Изменить цвет плана спрайта.

prtscrnt()

Вывести на принтер шестнадцатеричный дамп всей текущей Name Table для отладки.

gameini(MNTfile, screensX, screensY, LIBfile, SPRfile, sprsize, magn, mode)
char *MNTfile, *LIBfile, *SPRfile, screensX, screensY, sprsize, magn, mode;

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

Распределение RAM для MNT (Multi-screen Name Table) при помощи sbrk(), установка Screen 2, заполнение Name Table экрана нулями, установка параметров gwindow (графического окна) по максимальному размеру экрана 30×22, загрузка таблицы перекодировки для стандартного расположения алфавитно-цифровых паттернов в библиотеке и загрузка файлов MNT, LIB и SPR в абсолютном некомпрессированом формате с диска, если не найдены соответствующие компрессированые файлы с ТЕМИ ЖЕ ИМЕНАМИ. Файлы LIB и SPR могут быть прикомпонованы к концу области External (-f), а MNT - к концу кода (-c). Файлы LIB и SPR переписываются непосредственно в VRAM и могут более не перезагружаться, а MNT загружается с диска или расширяется из компрессированого формата в область, предварительно зарезервированную при помощи sbrk() после того, как файлы LIB и SPR уже переписаны в VRAM. Если вместо SPR-файла написан 0 — соответствующая область VRAM для спрайтов заполняется из файла LIB с рекомпозицией формата LIB в SPR (16×16).

Параметры:

Последние три параметра аналогичны параметрам функции sprctl().

Внутри функции gameini() производится автоматический вызов grpini(), lodlib(), lodmnt() и др.

gameini2(screensX, screensY, sprsize, magn, mode)
char screensX, screensY, sprsize, magn, mode;

Назначение: то же самое, что и gameini(), но данная функция НЕ ЗАГРУЖАЕТ файлы LIB, SPR и MNT. Вы должны сами вызывать функции lodlib() и lodmnt() в явном виде. Это даёт возможность компрессировать/не компрессировать (по вашему усмотрению) данные в файлах, присваивать компрессированым файлам имена, отличные от некомпрессированых файлов, перезагружать эти файлы перед началом каждого повторяющегося исполнения вашей программы и пр. Кроме того, это даёт Вам возможность по-разному прикомпоновывать файлы LIB, SPR и MNT в зависимости от организации вашей программы.

Примечание. Автором обычно используется следующее правило для размещения и прикомпоновки различных данных:

• данные, которые перемещаются в VRAM и в дальнейшем не подвергаются там модификации, прикомпоновываются к концу области External (-f EDL) с тем, чтобы после загрузки их в VRAM, эта область памяти освобождалась для размещения рабочих областей, переменных и пр.
• данные, которые могут подвергаться модификации, прикомпоновываются к концу кода (до начала области External) в компрессированом или некомпрессированом формате и экспандируются/переписываются в рабочую область RAM (в том числе в те адреса, которые освободились после загрузки данных, прикомпонованых с -f, в VRAM) перед началом каждого повторяющегося выполнения программы.

clrscr(SCRline, SCRcolumn, width, height)
char SCRline, SCRcolumn, width, height;

Очистить прямоугольный участок экрана в Scrеen 2 с координатой левого верхнего угла SCRline (0…23 по Y) и SCRcolumn (0…31 по X), шириной width (1…32) и высотой height (1…24), заполнив соответствующие байты Name Table экрана нулями.

gopen(libbase, framtop, framleft, framwidth, framheight)
char libbase, framtop, framleft, framwidth, framheight;

Открыть Graphic Window (Графическое Окно): нарисовать рамку, очистить содержимое и запомнить координаты окна в системной рабочей области для использования их в дальнейшем функцией gwind()

libbase является номером паттерна в библиотеке знакомест (0…249), начиная с которого располагаются 6 паттернов рамки: 4 паттерна для углов, горизонтальная линия и вертикальная линия. Если вы используете стандартную библиотеку знакомест, то можете указывать в качестве libbase ключевые слова STD_RED и STD_BLUE.

Параметры framtop и framleft задают координаты верхнего левого угла рамки, а framwidth и framheight — её ширину и высоту.

topen(libbase, framtop, framleft, framwidth, framheight)
char libbase, framtop, framleft, framwidth, framheight;

Открыть Text Window (Текстовое Окно со скроллингом текста) для использования функции tprintf().

Параметры аналогичны параметрам gopen().

gdef(windline, windcolumn, windwidth, windheight)
char windline, windcolumn, windwidth, windheight;

Определить параметры Graphic Window, но не рисовать рамку и не очищать содержимое окна.

Используется внутри gopen().

tdef(windline, windcolumn, windwidth, windheight)
char windline, windcolumn, windwidth, windheight;

Определить параметры Text Window, но не рисовать рамку и не очищать содержимое окна. Используется внутри topen().

gframe(libbase)
char libbase;

Нарисовать/перерисовать рамку с очисткой окна для уже открытого или определённого графического окна.

unsigned absntab(y, x)
unsigned y, x;

Получить абсолютный адрес внутри VRAM Name Table по двум координатам экрана y (0…23) и x (0…31).

unsigned absptab(y, x)
unsigned y, x;

Получить абсолютный адрес внутри первого из трёх VRAM Pattern Generator Table по двум координатам паттерна y (0…7) и x (0…32)

unsigned absctab(y, x)
unsigned y, x;

Получить абсолютный адрес внутри первого из трёх VRAM Colour Table по двум координатам паттерна y (0…7) и x (0…32)

char *absmntab(y, x)
unsigned y, x;

Получить абсолютный адрес внутри MNT по координатам y и x. Максимальные значения этих координат зависят от конфигурации и размеров MNT.

lodlib(LIB_link, SPR_link, base, LIB_file, SPR_file)
char *LIB_file, *SPR_file, *LIB_link, *SPR_link;
unsigned base;

Экспандировать и загрузить прикомпонованые и компрессированые файлы LIB и SPR в VRAM:

• LIB_link и SPR_link — имена этих файлов,
• base
  • codend() для -c,
  • endext() для -f
  • 0, если Extra Data не используется (в этом случае не производится попытки найти LIB_link и SPR_link)

Если LIB_link или SPR_link не найдены в Extra Data, производится попытка загрузки с диска НЕКОМПРЕССИРОВАНЫХ файлов LIB_file и SPR_file (с диагностикой соответствующих ошибок ввода/вывода).

Если вместо SPR_link или SPR_file написан 0 — в качестве данных для Sprite Generator Table используется LIB_link или LIB_file с соответсвующей рекомпозицией паттернов к размеру спрайтов 16×16.

lodmnt(MNT_link, base, MNT_file)
char *MNT_link, *MNT_file;
unsigned base;

Экспандировать и загрузить прикомпонованый и компрессированый файл MNT в абсолютном формате — F7 (подробнее о форматах здесь) в RAM (предварительно выделенный при помощи gameini() или gameini2()). base используется аналогично lodlib(). Если base равно нулю или файл MNT_link не найден в Extra Data — производится загрузка НЕКОМПРЕССИРОВАНОГО файла MNT_file с диска. После этого загружается стандартная таблица перекодировки.

lodlib2(LIB_link,SPR_link,base)
char *LIB_file,*SPR_file;
unsigned base;

Сокращённая версия lodlib() без загрузки файлов с диска. Экспандировать прикомпонованые и компрессированые LIB и SPR файлы в VRAM:

• LIB_link и SPR_link — имена этих файлов,
• base — codend() для -c
• endext() для -f

Если вместо SPR_link написан 0 — в качестве данных для Sprite Generator Table используются данные из LIB_link с соответствующей рекомпозицией паттернов к размеру спрайтов 16×16.

bwind(MNTline, MNTcolumn, framtop, frambottom)
unsigned MNTline, MNTcolumn;
char framtop, frambottom;

Block Winlow: вывести блок из MNT с координатами верхнего левого угла MNTline (Y), MNTcolumn (X) на экран начиная со строки экрана framtop (верхняя строка) и кончая строкой экрана frambottom (нижняя строка).

Ширина блока: всегда 32 знакоместа.

Для данного типа окна не предусмотрены операции OPEN/DEFINE и рамка.

Этот тип окна имеет максимальную скорость отображения данных из MNT на физический экран.

gwind(MNTline, MNTcolumn)
unsigned MNTline, MNTcolumn;

Graphic Window: вывести блок из MNT с координатами верхнего левого угла MNTline (Y), MNTcolumn (X) на экран в область, предварительно определённую при помощи gopen() или gdef().

swind(MNTline, MNTcolumn, SCRline, SCRcolumn, width, height)
unsigned MNTline, MNTcolumn;
char SCRline, SCRcolumn, height, width;

Sub-Window: вывести блок из MNT с координатами верхнего левого угла MNTline (Y), MNTcolumn (X) на экран в область с координатами верхнего левого угла SCRline (0…23 по Y), SCRcolumn (0…31 по X).

Ширина и высота выводимого блока: width (1…32) и height (1…24).

Для данного типа окна не предусмотрены операции OPEN/DEFINE. Рамка может быть специально нарисована при помощи sframe().

sframe(libbase, SCRline, SCRcolumn, width, height)
char libbase, SCRline, SCRcolumn, width, height;

Нарисовать рамку и очистить область внутри неё нулями.

Параметры аналогичны параметрам gopen().

putchr(SCRline, SCRcolumn, c)
char SCRline, SCRcolumn, c;

Вывести символ c на экран (непосредственно в VRAM Name Table) без перекодировки в позиции SCRline (0…23) и SCRcolumn (0…31).

char getchr(SCRline, SCRcolumn)
char SCRline, SCRcolumn;

Взять символ (байт) с экрана (непосредственно из VRAM Name Table) находящийся в позиции SCRline (0…23) и SCRcolumn (0…31).

putstr(SCRline, SCRcolumn, str, len)
char SCRline, SCRcolumn, *str, len;

Вывести строку str длиной len на экран без перекодировки в позиции SCRline (0…23) и SCRcolumn (0…31).

putstrt(SCRline, SCRcolumn, str)
unsigned SCRline, SCRcolumn;
char *str;

То же самое, что putstr(), но строка автоматически перекодируется перед выводом на экран с использованием стандартной таблицы перекодировки и должна оканчиваться двоичным нулём.

Внимание! Компилятор BDS C гасит старший бит во всех литеральных строках и, поэтому буквы кириллического алфавита не будут сохраняться в генерируемом коде (они будут транслитерированы в латинские). Для решения этой проблемы без модификации компилятора рекомендуются следующие приёмы:

1. Хранить все русскоязычные сообщения в MNT и выводить их на экран при помощи putstr() или swind().
2. Хранить все русскоязычные сообщения в отдельном файле ASCII, подготовленном при помощи текстового редактора, и, перед выполнением программы, загружать его в память.
   После этого может быть использована функция putstrt().
3. Записывать все кириллические символы внутри литеральных строк программы при помощи восьмеричных констант. Для этой цели можно воспользоваться утилитой DUMP.COM, входящей в состав ПС «МАЭСТРО».

Следует заметить, что первые два приёма являются наиболее предпочтительными и при использовании любых других компиляторов, в том числе, не подавляющих кириллические символы. Это связанно с тем, что таким образом обеспечивается дополнительная независимость программы от данных и свобода в изменении диалога, ведущегося программой (в том числе, перевод его на другой язык) без изменения и перекомпиляции самой программы.

tframe(libbase)
char libbase;

Нарисовать/перерисовать рамку с очисткой окна для уже открытого или определённого при помощи topen() / tdef() текстового окна.

tprintf(format)
char *format;

Форматированный вывод в предварительно открытое или определённое текстовое окно с перекодировкой. Параметры такие же, как у функции printf() BDS C. Внутри окна производится локальный скроллинг текста.

stornt(SCRline, SCRcolumn, width, height, buf)
char   SCRline, SCRcolumn, width, height, *buf;

Сохранить блок с экрана (из VRAM Name Table) в RAM для последующего восстановления при помощи restnt() или restnt2(). Размер буфера buf для сохранения блока должен быть не меньше произведения размеров блока width × height.

restnt(SCRline, SCRcolumn, width, height, buf)
char   SCRline, SCRcolumn, width, height, *buf;

Восстановить блок, сохранённый при помощи stornt(), на экране (в VRAM Name Table). Первой восстанавливается верхняя строка блока.

Параметры аналогичны параметрам stornt().

restnt2(SCRline, SCRcolumn, width, height, buf)
char SCRline, SCRcolumn, width, height, *buf;

Восстановить блок, сохранённый при помощи stornt(), на экране (в VRAM Name Table). Первой восстанавливается нижняя строка блока.

Параметры аналогичны параметрам stornt().

char getchrm(SCRlin, SCRcol, gwbaseY, gwbaseX)
char SCRlin ,SCRcol;
unsigned gwbaseY, gwbaseX;

Взять символ из MNT, отражённый на экран при помощи gwind() с координатами левого верхнего угла (gwbaseY,gwbaseX), пользуясь для этого координатами экрана, а не координатами MNT.

putchrm(SCRlin, SCRcol, gwbaseY, gwbaseX, c)
char SCRlin, SCRcol, c;
unsigned gwbaseY, gwbaseX;

Поместить символ c в MNT, пользуясь для этого координатами экрана аналогично getchrm().

st_swind(MNTline, MNTcolumn, SCRline, SCRcolumn, width, height, buf)
unsigned MNTline, MNTcolumn;
char SCRline,SCRcolumn,width,height,*buf;

Функция swind() с предварительным сохранением изменяемой части экрана в буфере buf. Комбинация stornt() и swind().

Дополнительные макро-функции и некоторые системные переменные общего пользования из заголовка GRPLIB0.H

MSX2

Системная переменная (устанавливается grpini() при инициализации) TRUE, если ваш компьютер — MSX2

VRAM_128

Системная переменная (устанавливается grpini() при инициализации) TRUE, если у вашего компьютера 128 кбайт VRAM.

MEMORY_MAPPER

Системная переменная (устанавливается grpini() при инициализации) TRUE, если у вашего компьютера есть аппаратура Memory Mapper.

TEXTWIDTH(width)
/* macro */

Установить максимальную ширину текстовой строки width для Screen 0.

MOUSE1(x, y)
/* macro */

Записать в переменные x,y относительные приращения координат мыши, подключённой к порту 1.

MOUSE2(x, y)
/* macro */

Записать в переменные x,y относительные приращения координат мыши, подключённой к порту 2.

USE_MOUSE(mouse_num)
/* macro */

Альтернативный метод опроса мыши: активация специального процесса, вызываемого из totick(). Этот процесс вычисляет абсолютные координаты мыши (0…511 или 0…256 для экранов с низким разрешением) каждый «тик» и помещает их в системные переменные MOUSE_X, MOUSE_Y (абсолютные координаты) и RMOUSE_X, RMOUSE_Y (относительные координаты).

Только одна мышь (mouse_num 1 или 2) может опрашиваться этим процессом.

UNUSE_MOUSE деактивирует этот процесс (установлен по умолчанию). Этот процесс не зависит от TICKON / TICKOFF и TICKSTART / TICKSTOP

UNUSE_MOUSE
/* macro */

Деактивация механизма USE_MOUSE()

MOUSE_X

Системная переменная

Вы можете написать, например:

x=MOUSE_X;

для получения абсолютной Х–координаты мыши, если активирован USE_MOUSE, а также присвоить этой переменной значение координаты Х для программного позиционирования курсора

MOUSE_X=x;

MOUSE_Y

Системная переменная

Вы можете написать, например:

 y=MOUSE_Y;

для получения абсолютной Y–координаты мыши, если активирован USE_MOUSE, а также присвоить этой переменной значение координаты Y для программного позиционирования курсора

MOUSE_Y=y;

RMOUSE_X

Системная переменная

То же самое для относительной координаты X.

RMOUSE_Y

Системная переменная

То же самое для относительной координаты Y.

_picture

Системная переменная

Значение по умолчанию: TRUE

GETTIME(h, m, s)
/* macro */

Записать текущее значение часов, минут и секунд в переменные h, m и s соответственно.

GETDATE(y, m, d)
/* macro */

Записать текущее значение года, месяца и дня в переменные y, m и d соответственно.

DIS_INTERRUPT
/* macro */

Выполнить команду Z80 DI (Disable Interrupt)

ENA_INTERRUPT
/* macro */

Выполнить команду Z80 EI (Enable Interrupt)

DIS_SCREEN
/* macro */

Запретить вывод на экран (Disable Screen)

ENA_SCREEN
/* macro */

Разрешить вывод на экран (Enable Screen)

EXIT
/* macro */

Выход в MSX-DOS с восстановлением Screen 0 и параметров цвета экрана из энергонезависимой памяти MSX2 или GRPMSX1.H MSX1

PAUSE(beep_num)
/* macro */

Подача beep_num звуковых сигналов и ожидание нажатия клавиши SHIFT с периодическим обращением к totick(). Используется для отладки программ, работающих с графическими экранами.

DUMP(msg, sadr, eadr)
/* macro */
char *msg;
unsigned sadr, eadr;

Вывести на текстовой экран (Screen 0) идентификационное сообщение msg и шестнадцатеричный дамп памяти начиная с sadr и кончая eadr

GDUMP(fg, bg, msg, sadr, eadr)
/* macro */
char fg, bg, *msg;
unsigned sadr, eadr;

Вывести на графический экран (Screen 5…8) идентификационное сообщение msg и шестнадцатеричный dump памяти начиная с sadr и кончая eadr

fg и bg — палитры для переднего и заднего плана соответственно.

Начальная позиция: левый верхний угол экрана.

DIR_GET_CHAR
/* macro */

DIR_PUT_CHAR

DIR_PUT_CHAR
/* macro */

Напишите эти два макровызова вне тела главной программы и других функций (это компилируемые переопределения функций getchar() и putchar()) и ВЕСЬ консольный ввод/вывод будет направлен непосредственно через ROM BIOS вместо BDOS — это гарантирует отсутствие проверки на ^C и другие специальные коды (^S, ^P, …) и, кроме того, несколько быстрее.

INKEY
/* macro */

Функция, аналогичная inkey$ языка Бейсик.

Напишите:

c = INKEY;

и вы получите код символа, введённого с консоли или 0, если ни одна клавиша не была нажата. Эта функция работает через BDOS 6 — нет ожидания, нет проверки на ^C и другие специальные коды, нет отображения символа на экран.

VARPARMS(first_arg_in_list)
/* macro */

Напишите VARPARMS внутри любой функции сразу после описаний внутренних переменных функции, если таковые имеются, (VARPARMS является выполняемым макросом) и используйте после этого PARM(n) для извлечения параметра функции по его номеру n (первый параметр имеет номер 0).

Пример:

main()
{
  foo(1, "txt");
}
 
foo(arglist)
unsigned arglist; /* 'arglist' used for argaddr extraction */
{
  char zot;
  VARPARMS(arglist)
  printf("%d %s", PARM(0), PARM(1));
}

В результате выполнения данной программы будет напечатано:

1 txt

PARM(n)
/* macro */

Используется для извлечения параметра функции по номеру n вместе с макросом VARPARMS

Первый параметр в списке имеет номер 0

Номер n может быть переменной.

KBDOFF
/* macro */

отключить опрос клавиатуры и обработку прерываний в BIOS

KBDON
/* macro */

включить опрос клавиатуры и обработку прерываний в BIOS

KBDRESTORE
/* macro */

восстановить опрос клавиатуры и обработку прерываний в BIOS

1. Внимание!

   #include grplib0.h

   или

   #include grpmsx1.h

   обязательно должны присутствовать в качестве самой первой строки (не считая комментариев) в вашей программе, использующей Библиотеку! (bdscio.h вызывается автоматически из grplib0.h). Эти заголовки содержат рабочие области и макроопределения, абсолютно необходимые для нормальной работы функций Библиотеки.

2. Одна из функций grpini(), gameini() или gameini2() обязательно должна быть выполнена до обращения к другим функциям Библиотеки.
   Эти функции инициализируют рабочую область Библиотеки и устанавливают стандартные значения «по умолчанию».
3. Имена, начинающиеся с подчеркивания «_» зарезервированы для системного использования.
4. Так как некоторые процессы могут пользоваться одними и теми же системными ресурсами (Графический аккумулятор, аккумулятор позиций текстового курсора, шаг печати для графических экранов и др.) — обращайте особое внимание на то, чтобы не использовать значения, которые остаются и сохраняются в таких ресурсах — они могут быть оставлены другим процессом при мультизадачной работе!
5. Область External НИКОГДА НЕ ДОЛЖНА НАХОДИТЬСЯ НА СТРАНИЦАХ 0 и 3 (адреса памяти 0…0x3FFF и 0xC000…0xFFFF) RAM. Используйте -e4000 для cc и clink как минимум! Это связано с тем, что механизм работы со слотами и мэппером, реализованый в Библиотеке, находится в External и может работать только в страницах 1 или 2 (в отличие от оригинального механизма MSX ROM BIOS, который работает некорректно и при некоторых межслотовых вызовах сам себя выбрасывает из памяти).
6. Если вы хотите вызывать BIOS или SubROM сами (механизм вызова описан в GRPLIB0.H) — никогда не передавайте в них указатели на данные, которые могут оказаться в странице 0 (например на литеральные строки из текста программы, находящейся в RAM).
   Это связано с тем, что во время работы BIOS или SubROM страницу 0 занимает сам ROM (библиотечные функции в подобных случаях предварительно буферизируют данные в стеке).
7. Ниже приводится описание «компрессированного» формата данных, который используется в некоторых библиотечных функциях.
   Компрессия достигается за счёт сжатия «однородностей» — одинаковых слов, идущих последовательно друг за другом.
   Алгоритм неадаптивный, т.е. ориентированный на фиксированную длину слова — в данном случае 1 байт.
   Компрессированые данные состоят из элементов данных, каждый из которых в свою очередь, состоит из «признака», «счётчика» и «данных». «Признак» занимает один бит и означает компрессию (1) или обычную последовательность данных (0). «Счётчик» занимает 7 бит. «Данные» представляют собой один байт (в случае компрессии) или от 1 до 127 байт в случае «некомпрессируемой» последовательности байтов. Таким образом, «элементы» могут выглядеть следующим образом:

      0-й байт   1-й байт
   ┌───────────┬──────────┐
   │ 1xxx xxxx │zzzz zzzz │ повторение байта 'zzzz zzzz' 'xxx xxxx' (0…127) раз
   └───────────┴──────────┘
   
      0-й байт   1-й байт          N-й байт
   ┌───────────┬──────────┬─────┬───────────┐
   │ 0xxx xxxx │yyyy yyyy │ ... │ zzzz zzzz │ N (xxx xxxx) байт для «прямого» копирования
   └───────────┴──────────┴─────┴───────────┘
      0-й байт
   ┌───────────┐
   │ 0000 0000 │ «больше нет данных»
   └───────────┘

   Изображения в формате COPY (Data) для Screen 5…8 имеют заголовки из двух слов (по 2 байта каждое слово) с указанием ширины и высоты изображения в точках. Для компрессированых изображений ширина (1-е слово) записывается в отрицательном виде, т.е. -ширина.
   Этот признак используется функциями Библиотеки для автоматического распознавания компрессированого формата изображения. Отрицательная ширина может быть установлена при помощи утилиты Picture Compressor — PICO.COM.
   Другие данные, не имеющие таких заголовков, могут быть компрессированы или расширены при помощи утилиты Files Compressor/Expander — FCX.COM и библиотечной функции expand().

8. Внимательно ознакомьтесь с файлами GRPLIB0.H и GRPMSX1.H — они содержат много полезной информации и дополнительных ключевых слов для использования в текстах ваших программ. Будьте осторожны — не переназначайте имена системных переменных!

Если вы хотите опрашивать порты джойстика для того чтобы с ними можно было работать одновременно с опросом клавиш курсора, пробела (триггер 1) и клавишей GRAPH (триггер 2), добавьте дополнительный #include в вашу программу:

#include grpstick.h

В этом случае порты джойстика будут опрашиваться автоматически и добавляться по ИЛИ к нажатиям клавиш на клавиатуре. Вы сможете пользоваться такими функциями, как isspbar(), isleft() и др. без изменения текста вашей программы.

При этом, надо учитывать то, что мышь, опрашиваемая как джойстик, может давать постоянные срабатывания кнопок → и ↓. Для того, чтобы этого избежать можно использовать специальную функцию chkmouse() из grpstick.h которая сама определит по этим признакам подключена ли мышь к порту джойстика и, если она подключена, исключит этот порт из опроса как порт джойстика.

Кроме этого, вы можете сами использовать системные переменные _NoMous1 и _NoMous2 для 1–го и 2–го портов соответственно, задавая им значения TRUE или FALSE в явном виде. В этом случае использование функции chkmouse() будет необязательным.

По умолчанию grpini() устанавливает _NoMous1=FALSE и _NoMous2=TRUE т.е. считает, что к порту 1 подключена мышь, а к порту 2 джойстик.

Если вы хотите чтобы работало автоопределение мыши для обоих портов с помощью функции сhkmouse(), то предварительно установите _NoMous1=TRUE.

Если вы хотите использовать только джойстик в порте 2 без автоопределения мыши и сократить размер кода, вы можете также написать #define JOY2ONLY перед #include grpstick.h

Функции из библиотеки GRPLIBM.CRL предназначены для использования в программах, написанных для компилятора BDS C. Они подключаются к программе на шаге редактирования clink. При этом в параметре -f командной строки clink имя библиотеки GRPLIBM должно быть указано раньше имён библиотек GRPLIBx ПС «МАЭСТРО».

Музыкальные отрывки на MML+ подготавливаются, транслируются и проверяются с помощью редактора MED, а затем записываются на диск в виде готовых к исполнению музыкальных фрагментов в формате системной музыкальной очереди (СМО) MSX.

Структура музыкального фрагмента:

┌──────┬──────┬───────┬──────┬──────┬──────┬── ... ─┬──...────┬──...───┐
│VAlen │VAptr │ VBlen │VBptr │VClen │VCptr │ VAq    │  VBq    │ VCq    │
└──────┴──────┴───────┴──────┴──────┴──────┴── ... ─┴──... ───┴──...───┘

где:

• VAq, VBq, VCq — очереди пакетов для голосов A, B и С, подготовленные функцией mmq;
• VAlen, VBlen, VClen — их длины (включая завершающие 0хFF);
• VAptr, VBptr, VCptr — указатели начала цикла для каждого голоса.

Эти фрагменты могут быть присоединены к программе заранее с помощью EDL (Extra Data Linker), входящего в ПС «МАЭСТРО», либо загружаться динамически в процессе выполнения программы, например, функцией swapin().

Программа должна быть составлена с учётом следующих требований:

• должны быть указаны #include для grplib0.h и grpmus.h
• в начале выполнения вызываются функции grpini(), musini() и, если используется LFO, lforeset() (в указанном порядке!)
• функция tickexit() должна содержать вызов функции mutick(), а если используется LFO — также и lfotick()
• должен быть включён механизм прерываний (TICKON)

Когда эти условия выполнены, можно вызывать функцию play(). Она сбрасывает предыдущее состояние PSG и СМО и «запускает» исполнение указанного музыкального фрагмента однократно или в цикле. Все дальнейшие операции с музыкальной очередью производятся асинхронно.

Функция mutick(), вызываемая в подпрограмме tickexit(), переносит максимально возможное число музыкальных пакетов из входной очереди в системную; если входная очередь исчерпана и нет признака цикла, заносит признак окончания очереди в СМО данного голоса. Интерпретация пакетов и непосредственное управление PSG осуществляется подпрограммой обработки СМО, входящей в состав обработчика прерываний BIOS MSX. Исключением являются пакеты управления LFO и шумом, которые интерпретируются функцией mutick() и в системную очередь не переписываются; поэтому, например, включения и выключения шума, заданные операторами (и), не синхронизированы с теми местами нотной записи, где стоят (и), а наступают раньше. В случае, если (и) стоят близко к началу записи, они оба могут быть обработаны mutick() при начальном заполнении системной очереди, до начала исполнения, и шум вообще не включится; однако при циклическом исполнении фрагмента при втором и последующих проходах включение и выключение шума будет происходить.

С помощью функции ismus() можно определить состояние СМО для каждого из голосов; функция musoff() «выключает» музыку и сбрасывает все очереди.

Для случаев, когда музыкальные фрагменты не могут быть оттранслированы заранее, например, для разработки диалоговых музыкальных программ, в пакет MEDIA включён транслятор с MML+, оформленный в виде функции mmq(), который транслирует исходную строку на MML+ во внутренний формат СМО — последовательность музыкальных пакетов

play(cycle,qad)
char *qad;
int cycle;

Ставит музыкальный фрагмент с адресом qad в музыкальную очередь.

Eсли cycle=0, элемент играется один раз; в противном случае mutick(), встретив байт 0xFF, не переписывает его в системную очередь, а начинает с места данной входной очереди, указанного в Vptr.

Если в нотной строке не было операторов ':', указатель содержит 0; если встретилось несколько операторов ':', указатель соответствует последнему из них.

Вызывает lf4init(), включает шум.

mutick()

Вызывается в tickexit() для периодической перезаписи музыкальных пакетов в системную музыкальную очередь и интерпретации пакетов управления LFO и шумом.

musoff()

«Выключает» музыку, сбрасывает системные очереди.

musini(p)
char *p; 

Инициализирует глобальные переменные; сбрасывает системные очереди.

Если p=0, в качестве области параметров LFO берётся 80 байтов в рабочей области MSX BASIC, начиная с адреса 0xF418, иначе эта область помещается по указанному адресу p.

char ismus() 

Возвращает байт, разряды 0-2 которого соответствуют состоянию системных очередей голосов 1-3.

Например, если ismus()=0, все три голоса молчат; если ismus()=4, играет только голос 3.

xmus()

Приостанавливает музыку, «замораживает» очереди. При повторном вызове продолжает исполнение с места остановки.

autoplay(va,vb,vc) 
char *va,*vb,*vc;

«Шарманка»; обеспечивает автоматическое (без подкачки по mutick()) проигрывание музыкальных очередей va,vb,vc. Каждая из очередей при этом должна иметь длину 129 байтов или 1 байт (включая замыкающие 0xFF). Для подгонки длины можно вставлять фиктивные операторы m, разбивать ноты по длительности и т.п.

int mmq(pa,pq,yy,tm)
char *pa,*p; 
unsigned *tm,*yy;

Транслятор MML+; транслирует символическую строку MML+, находящуюся по адресу pa, в последовательность музыкальных пакетов, оканчивающуюся 0хFF, и помещает её по адресу pq; возвращает длину полученной очереди пакетов, а при ошибках трансляции — номер позиции в исходной строке, содержащей ошибку, со знаком минус; в слово по адресу yy заносит указатель цикла Vptr; в слово по адресу tm заносит суммарную продолжительность звучания в тиках.

(Теоретически возможный случай продолжительности > 65536 тиков, т.е. > 18 мин. в расчёт не принимается ввиду его практической невероятности и бесполезности.)

int lftq(qn)   
char qn;

Сообщает число свободных байтов в системной музыкальной очереди канала qn.

putq(qn,byte)
char qn,byte;

Помещает byte в системную музыкальную очередь канала qn.

int setlfo(v,typ,t,a)
int t,a;
char v,typ;

Заносит параметры LFO: тип (0-2), период и амплитуду (0-32767) для голосов 1-3 (v=0-2) или для шума (v=3) в блок управления LFO и инициализирует этот блок. ( Структура блока управления задана в GRPMUS.H. Включение и выключение LFO для голоса или шума производится установкой в 1 или 0 глобальных переменных _FMFL[i]).

Если входные значения ошибочны, возвращает -1.

lfinit(p)
struct _LF *p;

Инициализирует рабочие переменные LFO в указанном в p блоке управления LFO в соответствии с заданными ранее параметрами.

lf4init()

Выполняет lfinit() для всех четырёх блоков управления LFO.

lfreset()

Сбрасывает все параметры LFO, выключает LFO для всех голосов и шума.

lfotick()

Вызывается в tickexit(); управляет LFO, меняя частоту PSG.

noisep()

Загружает период шума в PSG из глобальной переменной _NP. (пять младших битов _NP).

noise()

Включает шум в голосах, которым соответствуют '0' в маске.

Маска находится в трёх старших (левых) битах _NP.

noisev(v,on)
char v,on;

Включает (если on=1) или выключает (on=0) шум в голосе v.

xnoise(v)
char v;

Поочерёдно включает/выключает шум в указанном голосе v.

notick()

Вызывается в tickexit(); осуществляет модуляцию шума (linear noise oscillation, LNO): если установлен глобальный флаг _NMFL, «базовый» период шума, заданный в noisep(), модулируется через каждые NТ тиков случайным приращением в диапазоне (-NA,NA).

Значения NT, NA и периода шума NP хранятся в глобальных переменных, определённых в GRPMUS.H. Первоначально они устанавливаются в 0 функцией musini().

xlno()

Включает/выключает модуляцию шума.

setblnk(txt,bg,on,off)
int txt,bg,on,off;

Задаёт параметры мерцания (все четыре параметра должны быть в диапазоне 0-15).

txt и bg задают альтернативную пару цветов текст/фон. Мерцающие символы поочерёдно высвечиваются то основными, то альтернативными цветами.

(Позиции экрана, в которых должно происходить мерцание, задаются установкой соответствующих битов в Color Table).

Период мерцания задаётся величинами on - время высвечивания альтернативным цветом и off - основным (*1/6 сек.).

Если оn и off равны 0, мерцания нет, все выводится в основных цветах. Если on=15, а off=0, мерцания также нет, но позиции, помеченные в Color Table, выводятся альтернативными цветами, т.е. появляется возможность работать в режиме TEXT2 с четырьмя цветами.

rstblnk()

Устанавливает период мерцаний равным 0, т.е. выключает мерцание на всем экране, не изменяя Color Table.

clrblnk()

Обнуляет Color Table, т.е выключает мерцание для каждой позиции экрана.

blink(x,y,len)
int x,y,len;

Включает мерцание для len позиций экрана, начиная с позиции с координатами (x,y).

xblink(x,y,len)
int x,y,len;

Переключает мерцание для len позиций экрана, начиная с позиции с координатами (x,y) (т.е. включает для выключенных, выключает для включённых).

dblink(x,y,len)
int x,y,len;

Выключает мерцание для len позиций экрана, начиная с позиции с координатами (x,y).

Ограничения, накладываемые звукогенератором и механизмом прерываний:

1. Длительность звучания ноты измеряется в тиках — 1/60 сек. (на некоторых машинах — 1/50). Она определяется по формуле:
   d=14400/(t*l) (на 50–гц машинах — 12000), минимальная длительность равна двум тикам, максимальная - 4095.
   Систематическая погрешность округления при нецелом частном может приводить к рассинхронизации голосов, которую приходится устранять вручную, вставляя дополнительные ноты и контролируя длительности голосов в поле «Ticks» на экране музыкального редактора.
2. В моменты обращения к диску системный обработчик прерываний получает управление с задержкой, что приводит к искажению длительностей нот, загруженных в это время в звукогенератор.
3. Если tickexit() в программе пользователя слишком долго не получает управления (например, при неправильно организованном ожидании ввода с клавиатуры; при использовании отладочной функции dump() с большим объёмом выдачи и т.п.), и успевают доиграть все

пакеты, поставленные mutick() в системную очередь, может произойти отключение или рассинхронизация голосов. Поэтому надо внимательно отслеживать возможные источники задержек, обязательно вставлять totick() в продолжительные или зависящие от внешних событий циклы и функции, осторожно пользоваться DIS_INTERRUPT, TICKOFF и TICKSTOP. Если специфика программы такова, что гарантировать регулярное выполнение tickexit() невозможно, остаётся воспользоваться функцией autoplay().

Примечание:

• grpini(), tickexit(), totick(), dump(), DIS_INTERRUPT, TICKOFF, TICKSTOP — функции, входящие в ПС «МАЭСТРО».
• swapin() — функция BDS C.

В данном документе содержится описание применения утилит, входящих в ПС «МАЭСТРО». Документ предназначен для разработчиков программного обеспечения на компьютерах MSX2 и MSX и содержит следующие разделы:

• Назначение утилит
• Условия применения
• Порядок работы с утилитами, форматы данных и особенности использования

Все утилиты написаны на языке С (компилятор BDS C) и ассемблер (GEN80) с использованием «Графической Библиотеки MSX для BDS C».

Для работы утилит требуется MSX компьютер с 64 кбайт оперативной памяти и как минимум одним дисководом. Большинство утилит может выполняться как на MSX так и на MSX2. Случаи использования MSX2 оговариваются особо. Операционная система: MSX-DOS версии 1.03 (COMMAND.COM 1.11).

Внимание! Для нестандартных модификаций операционной системы и консольного процессора нормальная работа утилит не гарантируется.

Порядок работы с утилитами, форматы данных и особенности использования. Ниже приводятся описания параметров командных строк и функций утилит ПС «МАЭСТРО».

Примечание.
Большинство утилит, не ведущих диалог, выводит краткое описание своих командных строк при вызове их без параметров.

Формат записи параметров:

• В квадратных скобках «[» и «]» записываются необязательные параметры,
• в фигурных «{» и «}» — альтернативные значения параметров,
• в угловых «<» и «>» — смысловые значения параметров.

• Вертикальная черта «|» служит для разделения альтернатив («или»),
• многоточие «…» — для указания на группу однотипных параметров.

только для MSX2

Set Palette v1.02

setpalet [#fbB] [pRGB ... pRGB] [M]

#F45 F777 4004 5007

A> setpalet #F45 F777 4004 5007

A> setpalet M

maestro_glall.txt

maestro_glall-305.txt

Самодельная мышь стандарта MSX. Тёплая ламповая история. | MSX Resource Center (Page 2/2)

Танцроид