VKACL — туториал и справочник

О проекте

VKACL — язык программирования, который Виктор Германович Кон (доктор физико-математических наук, Курчатовский институт) придумал в 1991 году, ещё работая на Фортране, и развивает до сих пор. Главной целью с самого начала была быстрая работа с графикой; вычисления, файлы, окна, PDF и всё остальное выросли вокруг неё. Долгое время язык назывался просто ACL, но это сокращение занято многим другим, и теперь автор называет его по имени сайта — vkacl. (Название «МЛЯП» — «мой личный язык программирования» — относится к сообществу во ВКонтакте, а не к языку.)

Это не учебный проект: на VKACL написана рабочая среда, которой автор пользуется каждый день, и восемь десятков готовых программ — для картинок, PDF, числовых массивов, графиков, сайтов, слайдов.

С чего начинать

Автор советует новичкам не начинать с программирования. Сначала скачать интерпретатор и пользоваться готовыми программами — многим этого достаточно. Если что-то в готовой программе не устраивает, её текст открыт, и её можно поправить. Так постепенно и приходит язык.

Поэтому у этой книги три входа:

Откуда взяты сведения

• описание языка на сайте автора: справочник, суперкоманды, готовые программы, примеры с разбором;
• сам интерпретатор — aclp.jar из дистрибутива vkacl.zip (23.05.2026, интерпретатор от 05.09.2025). Там, где описание допускает два прочтения, поведение проверялось запуском настоящего интерпретатора.

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

Что нужно знать сразу

Где взять интерпретатор

Дистрибутив — на странице vkacl: архив vkacl.zip и переносная Java 8 (JRE), которую не нужно устанавливать — достаточно распаковать папку. Подробно — в главе Начало работы.

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

Правовая заметка

Язык VKACL, его интерпретатор, описания и готовые программы принадлежат Виктору Кону. Эта книга — независимое изложение, написанное заново.

Начало работы

Название VKACL составлено из первых букв слов Victor Kohn Advanced Command Language. Устроена система как Линукс: небольшое ядро — интерпретатор языка, написанный на Java, — и неограниченная периферия — программы на самом VKACL. Автор называет их а-программами.

Эта глава — о том, как поставить настоящий интерпретатор и запустить первую готовую программу. Писать код для этого не нужно.

Что скачать

Всё лежит на странице vkacl:

Java нужна любая 64-битная, но удобнее всего переносная версия со страницы автора: её не нужно устанавливать.

Как поставить

1. Распакуйте JRE так, чтобы получилась папка C:\jre1.8.0_91.
2. Распакуйте vkacl.zip в любое место — например, C:\vkacl.
3. Всё. Ничего не регистрируется в системе.

Папку с JRE и папку с программой можно целиком записать на флешку и запускать на любом компьютере. Тогда в bat-файлах нужно поменять букву диска C: на букву флешки.

В папке программы:

Если Java стоит в другом месте, поправьте первую строку bat-файла:

set path=C:/jre1.8.0_91/bin;%path%
java -jar aclp.jar 2

Число после aclp.jar выбирает режим: 2 — проигрыватель, 0 — среда разработки.

Два режима

Проигрыватель (_runp.bat). Окна среды нет — сразу появляется меню из кнопок:

Готовая программа сначала открывает в редакторе файл своих входных данных с примерами вариантов. Вы правите первые строки под свою задачу, сохраняете — и программа выполняется. Как именно заполнять входные данные каждой из восьмидесяти программ, описано в разделе Готовые программы.

Среда разработки (_rund.bat). Окно с меню и редактором: здесь пишут и запускают свои программы. Проигрыватель из неё вызывается клавишами Alt+B.

При запуске открывается чёрное окно

Это окно терминала Java, в которое она пишет свои сообщения. Закрывать его не нужно — но если программа зациклилась и не отвечает, закрытие этого окна надёжно её останавливает.

Что дальше

• Пользоваться готовыми программами — каталог и руководства.
• Писать свои — со следующей главы, Что такое VKACL. Примеры туториала можно запускать прямо на странице в песочнице или в среде разработки автора.

Готовые программы

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

Чтобы пользоваться ими, программировать не нужно. Программа открывает текстовый файл с примером входных данных — одной-двумя строками чисел и имён файлов. Вы исправляете пример под свою задачу, закрываете редактор — и программа выполняется.

Автор советует новичкам именно такой порядок: сначала скачать интерпретатор и поработать с готовыми программами, и только потом, когда станет понятно, что они умеют, заглядывать в их код и менять его. Этот раздел — для первого шага.

Описания составлены по сайту автора (aclp-info), по текстам внутри файлов входных данных и по самому коду программ из архива vkacl.zip от 23.05.2026. Там, где источники расходятся, указано, как ведёт себя код.

Установка

Всё скачивается со страницы ACLnews.

По шагам:

1. Распакуйте vkacl.zip в любое место, например в C:\vkacl. Установки нет — это и есть вся программа.
2. Распакуйте архив JRE в корень диска C:, чтобы получилась папка C:\jre1.8.0_91. Именно этот путь записан в bat-файлах. Если Java у вас уже установлена (любая 64-битная), этот шаг можно пропустить.
3. Из vkacld.zip возьмите две папки: папку 0 положите внутрь папки pro (получится C:\vkacl\pro\0), папку zip — в главную папку программы (получится C:\vkacl\zip). Почти все примеры входных данных ссылаются на файлы из pro/0/, поэтому без этого архива примеры не сработают. (Автор пишет, что можно просто положить сам архив в главную папку — кнопка Demo распакует его сама; надёжнее разложить папки вручную.)

Папку программы вместе с папкой JRE можно записать на флешку и запускать на чужом компьютере. Тогда в первой строке bat-файлов поменяйте букву диска:

set path=C:/jre1.8.0_91/bin;%path%
java -jar aclp.jar 2

Два режима запуска

Из среды разработки проигрыватель тоже вызывается — клавишами Alt+B.

При запуске через bat-файл открывается чёрное окно терминала: туда Java пишет свои сообщения. Не закрывайте его. Но если программа «зависла» и не реагирует, закрытие этого окна надёжно её останавливает.

Меню проигрывателя

Как запустить программу по номеру

1. Запустите _runp.bat. Появится меню.
2. Нажмите Index. Откроется таблица из 99 кнопок. Сейчас работают номера 1–79 и 99; на остальные программа ответит, что они ещё не готовы.
3. Выберите номер. Откроется редактор с файлом входных данных этой программы. В верхних строках — готовые варианты входных данных, ниже — инструкция автора (она местами устарела; актуальное описание — на сайте и на страницах этого раздела).
4. Исправьте нужную строку или допишите свою. Поставьте курсор в самое начало той строки, которую хотите выполнить.
5. Нажмите Esc (или выйдите через меню редактора). Файл сохранится, и программа выполнится с данными из выбранной строки. Если передумали — закройте окно редактора крестиком: программа не запустится, изменения не сохранятся.
6. Посмотрите результат. Программы пишут файлы в папки, указанные во входных данных, а многие ещё и показывают результат: картинку в окне, PDF или сайт — в программе, которая открывает такие файлы в системе.
7. Ответьте на вопросы проигрывателя:
   • Wait / Go — «файл готов». Wait — открыть его сейчас, Go — не открывать и идти дальше;
   • Job is done! Continue? — Yes запускает ту же программу ещё раз (удобно подбирать параметры), No — выход из неё;
   • Would you like to run other program? — Yes снова показывает таблицу номеров, No возвращает в главное меню.

Исправленные входные данные запоминаются: в следующий раз программа откроет их в том же виде. Хранятся они в файле idc00.txt в главной папке — строка с номером N относится к программе N.

Как записывать входные данные

У программ разные данные, но правила записи почти везде одинаковые.

Одна строка — один вариант. Строк с вариантами может быть сколько угодно; выполняется та, в начале которой стоит курсор. В самой первой строке курсор может стоять и во второй позиции — так он оказывается сразу после открытия файла. Если курсор стоит в другом месте, программа сообщит об ошибке и предложит исправить.

Поля разделяются пробелами. Внутри поля пробелов быть не должно. Там, где нужен текст с пробелами (подпись над графиком, заголовок), пишут символ _ вместо пробела — программа сама превратит его в пробел.

Пути к файлам и папкам. Можно писать путь относительно главной папки программы (pro/1/) или полный путь с буквой диска (C:/photo/, букву — заглавной). Годятся оба разделителя, / и \. Надёжнее относительные пути: в некоторых программах длина пути ограничена (около 40 символов), да и в строке данных короткий путь удобнее. Пробелов в путях быть не должно. Нужен ли разделитель в конце имени папки — зависит от программы, это указано в таблицах.

Пробел в конце строки. После последнего поля должен стоять пробел. Поскольку его не видно, автор в примерах часто пишет после пробела лишнюю букву E: программа её не читает, но видно, что пробел есть. Осторожно: там, где важно число полей, лишняя буква меняет смысл строки. Не ставьте её в программах №2 (обычный режим), 6, 12, 17, 27, 46, 53, 56, 62, 75, 76, а также в многострочных данных №1, 8, 39, 66, где строка целиком — это текст, имя файла или адрес. Подробности — в описании каждой программы.

Многострочные данные. Некоторые программы берут не строку под курсором, а первые строки файла: №1, 8, 10, 11, 12, 13, 14, 28, 39, 49, 50, 57, 66, 78. У них позиция курсора не важна, выполняется только верхний вариант. Запасные варианты держите ниже и при необходимости переносите наверх.

Числовые файлы .dat

Многие программы работают с матрицами чисел в двоичном виде. Такой файл — это просто подряд записанные числа по 4 байта (формат float языка Java, старшие байты впереди), без заголовка. Размер матрицы в файле не хранится: его надо знать и указывать во входных данных. Проверка простая — размер файла в байтах равен 4 × ширина × высота.

Матрица записывается по строкам. Для программ, которые рисуют карты, первая строка файла — нижняя строка картинки.

Перевести текстовую таблицу чисел в такой файл умеет программа №16, обратно — №43. Подробный пример — в разборе №21.

Папки и файлы

Внимание. Кнопка Demo перед некоторыми демонстрациями очищает папки pro/1/ и pro/2/, чтобы подготовить исходные файлы. Не храните там ничего ценного — для своих файлов заведите отдельные папки.

Если что-то пошло не так

• Программа ничего не сделала. Проверьте, что курсор стоит в начале нужной строки и что после последнего поля есть пробел.
• Сообщение об ошибке и выход из программы. Чаще всего это неверные входные данные: не тот размер матрицы, опечатка в имени файла, лишнее поле. Запустите проигрыватель заново и сверьтесь с описанием.
• PDF или сайт готов, но не открылся. Кликните runsys.bat в главной папке или найдите файл менеджером файлов.
• Программа зависла. Закройте чёрное окно терминала.

Каталог

Программы сгруппированы по назначению. Номер — ссылка на подробное описание.

Картинки — pictures.md

PDF — pdf.md

Числовые массивы и матрицы — arrays.md

Графики — graphs.md

Тексты и файлы — text.md

Сайты — sites.md

Звук, анимация, игры — media.md

Автоматизация и система — system.md

Разное — other.md

Подробные разборы

Три программы разобраны по шагам, от пустой папки до готового результата:

• №08 SLIDE MAKER — слайд из картинки и надписей;
• №62 CALCUL — калькулятор;
• №21 2D MAP — карта матрицы чисел, заодно и перевод текстовой таблицы в двоичный файл программой №16.

Где ещё почитать

• Описания готовых программ на сайте автора — первоисточник; автор обновляет его чаще, чем тексты внутри программ.
• Страница загрузки и новостей.
• Как писать свои программы — с главы Начало работы.

Картинки

Программы этой группы собирают, режут, пересчитывают и переименовывают файлы картинок (JPG, PNG, иногда GIF). Общие правила записи входных данных — в разделе Как записывать входные данные; примеры используют файлы из архива vkacld.zip (папка pro/0/).

№06. PICs on MAT — картинка из таблицы картинок

Что делает. Раскладывает несколько картинок одинакового размера таблицей (столько-то в строке, столько-то строк) с промежутками заданного цвета и сохраняет результат как одну картинку. Удобно для отчётов и каталогов. Готовая картинка сразу показывается в левом верхнем углу экрана; закрыть её — кликом по картинке или крестиком.

Что нужно заранее. Все картинки лежат в одной папке, имеют формат PNG или JPG и один и тот же размер (размер берётся по первой).

Входные данные — одна строка:

Результат. Файл <папка>/<имя>.jpg или .png — того же типа, что исходные картинки. Размер: ширина = столбцы × ширина картинки + промежутки.

Пример. Четыре копии портрета jad.jpg (220×250) таблицей 2×2:

pro/0/ jad jad jad jad all 2 2 3 3 250 

Получится pro/0/all.jpg размером 443×503.

Тонкости.

• Картинок должно быть ровно «столбцы × строки». Если их больше или меньше, программа ничего не создаст и ничего не скажет.
• Расширение программа ищет сама: сначала .png, потом .jpg. Если файла нет, появится сообщение с его именем.
• Картинки раскладываются по строкам слева направо, начиная с верхней.
• Не ставьте в конце лишнюю букву E: программа считает поля, и последние пять обязаны быть числами.
• Цвета с номерами 244–256 заданы заранее, прочие по умолчанию чёрные. Нужный цвет проще всего подобрать пробой. Смешивать PNG и JPG в одной таблице не стоит.

№07. PICs to ICONs — уменьшенные копии картинок

Что делает. Для каждой картинки исходной папки делает копию заданной ширины (высота — пропорционально) и кладёт её в другую папку под тем же именем. Обычно так делают иконки для каталогов и сайтов.

Что нужно заранее. В исходной папке — только картинки JPG или PNG (размеры могут быть разными). Папка для копий должна существовать.

Входные данные — одна строка:

Результат. В папке копий — файлы с теми же именами, но всегда в формате JPG (m91.png → m91.jpg). В конце программа сообщает, куда записаны копии.

Пример. Скопируйте m91.jpg … m95.jpg из pro/0/ в pro/1/, затем:

pro/1/ pro/2/ 200 

Тонкости.

• Программа считает картинкой каждый файл исходной папки, поэтому посторонний файл приведёт к ошибке.
• Папки должны быть разными: иначе JPG-оригиналы будут перезаписаны копиями.
• Если папка пуста, программа попросит поменять её.

№08. SLIDE MAKER — слайд из картинок и надписей

Пошаговый разбор с примером — на странице Разбор: №08 SLIDE MAKER.

Что делает. Собирает картинку заданного размера — слайд презентации, объявление, заставку для видео — методом «вырезать и наклеить»: на основу кладёт картинки (со сдвигом, поворотом, наклоном и масштабом), а поверх пишет строки текста любым шрифтом, установленным на компьютере.

Что нужно заранее. Все используемые картинки лежат в папке pro/1/. Туда же программа запишет результат.

Входные данные — несколько первых строк файла:

Смысл чисел:

Привязка M: по горизонтали 1, 4, 7 — левым краем, 2, 5, 8 — серединой, 3, 6, 9 — правым краем; по вертикали 1–3 — низом, 4–6 — серединой высоты, 7–9 — верхом. Самая удобная — 5: текст центрируется в точке.

Результат. Два файла: pro/1/<имя>.png и pro/1/<имя>.jpg. Слайд показывается на экране, затем программа спрашивает, не поменять ли параметры. Yes снова открывает входные данные — можно подправить и посмотреть ещё раз.

Пример (автора). Для него скопируйте 000000.png из pro/0/ в pro/1/.

512 512 1 3|slide
 256 256 0 0 0 9 9|000000.png
 256 100 5 1 30  0 255 0 |Arial|на полотно любого размера
 256 200 5 1 30 255 0 0  |Arial|можно ставить картинки
 256 300 5 1 30 255 255 255 |Arial|и тексты любых фасонов

Чёрная картинка 256×192, увеличенная в 9 раз, закрывает всю основу 512×512, а поверх идут три строки: зелёная, красная и белая.

Тонкости.

• Выполняется только верхний вариант. Запасные храните ниже и переносите наверх, когда понадобятся.
• После вертикальной черты до конца строки идёт имя файла или текст — не ставьте в конце лишнюю букву E, она станет частью имени или надписи.
• Если картинки нет в pro/1/, программа сообщит об этом и поставит вместо неё маленький светлый квадрат pro/0/emsp.png.
• Имя шрифта пишется как есть, пробелы в нём допустимы (Arial narrow). Какие шрифты есть и какие символы в них — покажет программа №30. Надписи могут быть русскими.
• Если N1 = 0, картинок нет — это не ошибка; основа остаётся одноцветной. Нужный фон проще всего получить первой картинкой-подложкой, как в примере.

№34. INDEX — копии картинок с номерами

Что делает. Копирует все файлы .jpg и .png из одной папки в другую, давая им новые имена: «шапка» + трёхзначный номер + прежнее расширение (abc001.jpg, abc002.png, …). Номера идут подряд в порядке файлов в каталоге. Исходные файлы остаются на месте.

Что нужно заранее. Обе папки существуют.

Входные данные — одна строка:

Результат. В папке копий: abc001.jpg, abc002.jpg, …

Пример.

pro/0/  pro/2/  abc E

Тонкости.

• Учитываются только расширения jpg и png, написанные строчными буквами; .JPG и .jpeg пропускаются.
• Разделители \ программа сама превращает в /.
• Если какой-то папки нет, программа сообщит, какой именно.

№35. PNG to JPG — перевод PNG в JPG

Что делает. Переводит все файлы .png исходной папки в формат JPG и записывает их в другую папку с тем же именем. Остальные файлы не трогает.

Что нужно заранее. Обе папки существуют.

Входные данные — одна строка:

Результат. pro/2/<имя>.jpg для каждого <имя>.png.

Пример.

pro/0/  pro/2/ E

Тонкости. Расширение png должно быть написано строчными буквами. Если папка пуста, программа так и скажет.

№40. PIC to FRAG — вырезать фрагмент картинки

Что делает. Вырезает прямоугольный фрагмент из картинки JPG или PNG и сохраняет его в новый файл. Два режима: с одной картинкой (фрагмент можно выделить мышью) и пакетный — одинаковый фрагмент из серии пронумерованных файлов.

Входные данные — одна строка:

Режим N = 1. Картинка показывается на экране (слишком большая — уменьшенной), подсказка — в строке над панелью задач. Дальше одно из двух:

• нажать левую кнопку мыши в левом нижнем углу будущего фрагмента и, не отпуская, довести до правого верхнего — программа рисует рамку;
• нажать C и ввести четыре числа X Y W H (окно уже заполнено числами из входных данных) — так фрагмент получается точно нужного размера.

Фрагмент показывается и сразу записывается в файл.

Режим N > 1. Имена обеих картинок должны кончаться трёхзначным номером перед точкой, а перед номером — хотя бы одна буква: vk001.jpg, f001.jpg. Программа молча вырезает фрагмент X Y W H из первого файла, увеличивает номера в обоих именах на 1 и повторяет, всего N раз.

Результат. <папка>/<файл фрагмента> (в пакетном режиме — серия файлов).

Пример.

pro/0/  m91.jpg  frag.jpg  0 0 500 500 1 

Тонкости.

• Числа, введённые после C, программа не запоминает — если они удачные, перепишите их во входные данные.
• В пакетном режиме давайте фрагментам другую букву, чем исходникам, иначе исходные файлы будут перезаписаны.
• Если расширение файла фрагмента не jpg и не png, фрагмент не сохранится.

№45. PICs to CUT2 — разрезать картинки пополам

Что делает. Каждую картинку исходной папки разрезает по вертикали на две половинки, как развороты книги на две страницы. Нужно для слайд-шоу в виде книги, но годится и для других целей.

Что нужно заранее. В исходной папке — только картинки JPG, PNG или GIF. Папка для результатов существует (может быть не пустой).

Входные данные — одна строка:

Результат. Для m91.jpg — файлы pro/2/m91-1.jpg и pro/2/m91-2.jpg, всегда в формате JPG.

Пример.

pro/1/  pro/2/ 

Тонкости. По коду программы -1 — правая половина, -2 — левая; проверьте на своей картинке, прежде чем готовить книгу.

№47. PIC to RSFrag — фрагмент после поворота и масштаба

Что делает. Поворачивает картинку на заданный угол, умножает её размеры на коэффициент и вырезает из середины прямоугольник заданного размера.

Что нужно заранее. Рабочая папка находится внутри папки программы (пока это обязательно).

Входные данные — одна строка:

Результат. <папка>/<новая картинка>; она же показывается на экране.

Пример.

pro/0  jad.jpg  frag.jpg  100 100 90 1.3 

Тонкости.

• Центр вырезаемого прямоугольника совпадает с центром повёрнутой картинки. Если прямоугольник больше картинки, края заполняются цветом фона.
• Направление поворота проверьте на пробе: в программах №47 и №08 знак угла трактуется по-разному.

№51. SCR to PIC — снимки экрана по клавише

Что делает. Сохраняет снимки всего экрана в JPG по нажатию клавиши — не показывая себя и не мешая видео или видеоконференции, с которых снимают кадры. О том, что программа работает, говорит только маленький красный прямоугольник в правом верхнем углу экрана.

Входные данные — одна строка, лучше первая:

Как работать.

1. Запустите программу, затем откройте видео. Окно видео не должно закрывать красный прямоугольник.
2. Кликните по красному прямоугольнику — программа получит фокус.
3. Enter — снимок; прямоугольник на миг мигнёт.
4. Если переключались на другие окна, перед следующим снимком снова кликните по прямоугольнику.
5. Пробел — выход.

Результат. Файлы <папка>/vk001.jpg, vk002.jpg, … Номер увеличивается перед каждым снимком. При выходе программа сама записывает в первую строку входных данных папку и последний номер — следующий сеанс продолжит нумерацию, не затирая старые снимки.

Пример.

pro/2/ 0 

Тонкости. Работает в режиме проигрывателя. Папку лучше брать внутри папки программы — путь короче; не пишите в имя папки пробелы и длинные русские фразы.

№54. IMG VIEW — просмотр картинок

Что делает. Показывает картинки PNG, JPG и GIF, в том числе несколько сразу, и позволяет увеличивать и уменьшать их.

Входные данные. Нет. Поставьте курсор в начало текста и нажмите Esc.

Как работать. Откроется окно выбора файла (начиная с папки программы). Один клик по файлу показывает эскиз, кнопка Select или двойной клик — картинку в натуральную величину (большая — с полосами прокрутки). Дальше:

Тонкости. В режиме проигрывателя оставленные на экране картинки исчезают после выхода из программы.

№58. PIC MOD — яркость, контраст, гамма

Что делает. Пересчитывает цвета всех пикселей картинки по одной из восьми формул: делает светлее или темнее, контрастнее или мягче. Размер не меняется.

Входные данные — одна строка:

Операции (x — значение цвета от 0 до 255):

Результат. <папка>/<новое имя>.jpg, всегда JPG; показывается на экране.

Пример. Сделать картинку светлее на 50 единиц:

pro/0 s9.jpg s9n 1 50 0 

Тонкости. Если нет папки или файла, программа скажет об этом по-русски. Эффект операций проще всего понять пробой.

№59. PICs SUP — сумма картинок с весами

Что делает. Складывает несколько картинок, каждую со своим весом (веса могут быть отрицательными — это вычитание), и нормирует результат в диапазон 0–255. Полезно, например, для суммирования серии снимков одного объекта.

Входные данные — одна строка из пяти полей:

Результат. <папка>/<имя>.jpg размером с первую картинку.

Пример.

pro/0 m91.jpg,m92.jpg cnew 50,50 2 

Тонкости.

• Если имя результата начинается не с c и не с b, программа откажется работать.
• Разумно складывать картинки одинаковой ширины. Картинка поменьше «размазывается» по большой; в таком случае сначала вырежьте из большой фрагмент нужного размера (№40).

№60. PICs PRO — произведение или частное картинок

Что делает. Перемножает картинки (например, чтобы вырезать область по маске) или делит одну на другую; результат линейно приводится к диапазону 0–255.

Входные данные — одна строка из четырёх полей:

Результат. <папка>/<имя>.jpg размером с первую картинку.

Пример.

pro/0 m91.jpg,m92.jpg cnew 1 

Тонкости. При делении используются только две первые картинки; нули делителя заменяются единицами. Про размеры — то же, что у №59.

№68. PNG to EPS — перевод PNG в EPS

Что делает. Переводит все PNG-файлы папки в формат EPS — для вставки в статьи и в рисунки на PostScript.

Входные данные — одна строка:

Результат. pro/2/<имя>.eps (вариант 1) или pro/2/<имя>EPS.txt (вариант 2) для каждого файла.

Пример.

1 pro/1/ pro/2/ 

Тонкости. В исходной папке не должно быть ничего, кроме PNG. Символ _ в путях к папкам программа заменяет на пробел, поэтому папки с _ в имени не подойдут.

№73. IMG MOD 2 — высота и рамка для всех картинок папки

Что делает. Меняет сами файлы всех картинок папки. Вариант 1 — задаёт всем одну высоту, сохраняя пропорции. Вариант 2 — помещает каждую картинку в центр пустого кадра заданного размера (удобно после варианта 1, чтобы все кадры стали одинаковыми).

Входные данные — одна строка:

Результат. Вариант 1: файлы перезаписываются (JPG остаётся JPG, PNG — PNG). Вариант 2: результат пишется в JPG с тем же именем (для PNG рядом появляется .jpg).

Пример.

1 pro/1/ 720 E
2 pro/1/ 720 1280 720 E

Тонкости.

• Преобразование необратимо — сначала сделайте копию папки.
• Обрабатываются все файлы папки без разбора, посторонних быть не должно.
• В варианте 2 картинка не масштабируется: если она больше кадра, края обрежутся.

PDF

Программы этой группы собирают PDF из картинок, склеивают и перекраивают готовые PDF, кладут поверх страницы картинки и надписи. Размеры в PDF задаются в пунктах (pt): лист A4 — это 596 × 843 pt (у автора встречается и 596 × 842).

Общие правила записи входных данных — в разделе Как записывать входные данные. Программы №10–14 и 39 читают несколько первых строк файла и выполняют только верхний вариант.

Запускайте эти программы через _runp.bat. Если источник — повреждённый или вообще не PDF, Java не сможет его прочитать, выведет ошибку в чёрное окно терминала и остановит интерпретатор. Проверить это из программы на VKACL нельзя, поэтому перед работой просто откройте исходный PDF обычной программой просмотра.

Готовый PDF программы пытаются открыть сами (кнопка Wait). Если он не открылся — найдите файл в папке или кликните runsys.bat.

№09. PDF PRESENT — PDF-презентация из картинок

Что делает. Собирает PDF-файл, в котором каждая страница — одна картинка из папки. Так готовят файл доклада из слайдов-картинок. Есть режим для постерных докладов: слайды поворачиваются на 90° и вписываются в лист A4, чтобы их можно было распечатать и приколоть на стенд.

Что нужно заранее. В папке — только картинки JPG или PNG. Порядок страниц — алфавитный порядок имён файлов.

Входные данные — одна строка:

Результат. Файл pro/<имя>.pdf — всегда в папке pro.

Пример. Скопируйте m91.jpg … m95.jpg из pro/0/ в pro/1/, затем:

pro/1/  present  0  E

Получится пятистраничный pro/present.pdf. Не удаляйте его — он понадобится как источник в примерах программ №10–12.

Тонкости. В режиме 0 размер страницы берётся по первой картинке, и все картинки ставятся в натуральную величину. Поэтому слайды должны быть одного размера.

№10. PDF to PART — новый PDF из выбранных страниц

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

Входные данные — первые строки файла:

Смысл чисел:

Результат. Файл по первому пути (pro/1/new.pdf).

Пример (источник — pro/present.pdf из примера №9):

640 480 2 pro/1/new pro/present  E
 1 0 0 0.5 0.5 0 E
 2 0 0 0.5 0.5 0 E

Тонкости.

• Программа читает ровно |N| строк после первой; ниже можно хранить другие варианты и заметки.
• Номер несуществующей страницы просто пропускается, ошибки не будет. Сколько страниц в источнике, узнайте любой программой просмотра PDF.
• Пути — без пробелов.

№11. PDFs to PDF — объединение нескольких PDF

Что делает. Склеивает несколько PDF в один. Страницы можно сдвинуть, растянуть и повернуть. Удобно, например, чтобы собрать одностраничные PDF с картинками в один многостраничный.

Входные данные — первые строки файла:

W, H — размер страницы результата в pt; N — сколько файлов объединить (N < 0 — по две старые страницы на новую); X, Y, Sx, Sy, A — как у №10.

Результат. pro/1/new2.pdf.

Пример — дважды вставить файл из примера №10:

 640 480 2 pro/1/new2 E
 0 0 1 1 0 pro/1/new E
 0 0 1 1 0 pro/1/new E

Тонкости.

• Каждый файл вставляется целиком, со всеми своими страницами.
• Если какого-то файла нет, программа сообщит об этом, и результат не будет записан.
• Лучше объединять файлы с одинаковым размером страниц; если размеры разные, подберите сдвиг и масштаб пробой.

№12. PDF PAGEs — размеры страниц

Что делает. Показывает размеры всех страниц выбранного PDF. Нужно, чтобы правильно задать сдвиги и масштабы в программах №10, 11, 13 и 14.

Входные данные — первая строка файла:

Как работать. Откроется окно выбора файла, показывающее только PDF. Выберите файл.

Результат. Файл pro/page-sizes.txt: по строке на страницу — номер, ширина и высота в pt. Он сразу открывается в редакторе. Папку выбранного файла программа записывает в первую строку входных данных — в следующий раз выбор начнётся с неё.

Пример.

pro/

Тонкости. Используется только первая строка; лишних символов после пути не ставьте.

№13. PIC on PDF — картинки поверх страницы PDF

Что делает. Делает новый одностраничный PDF: копию первой страницы старого PDF, поверх которой положены картинки — в любом месте, с масштабом и поворотом. Удобно, чтобы добавить в документ подпись, печать или пометку.

Входные данные — первые строки файла:

Результат. pro/1/1.pdf.

Пример.

 1  pro/0/QR-vgkohn  pro/1/1  E
 0 0 0 220 0 pro/0/jad.jpg 

Тонкости.

• Каждая строка должна кончаться пробелом.
• Следующая картинка закрывает предыдущие — это можно использовать.
• Форматы картинок: jpg, gif, png, bmp, tif, wmf, eps (автор проверял jpg и png).
• Автор заметил, что на PDF, сделанный из картинки, новые картинки не ложатся. Обходной путь: превратить PDF в картинку онлайн-сервисом, наложить картинки программой №08 и снова собрать PDF программой №09.

№14. TXT on PDF — текст поверх страницы PDF

Что делает. Как №13, но вместо картинок кладёт на страницу строки текста встроенными шрифтами PDF.

Входные данные — первые строки файла:

Шрифты: 1 Courier, 2 Courier-Bold, 3 Courier-Oblique, 4 Courier-BoldOblique, 5 Helvetica, 6 Helvetica-Bold, 7 Helvetica-Oblique, 8 Helvetica-BoldOblique, 9 Times, 10 Times-Bold, 11 Times-Italic, 12 Times-BoldItalic, 13 Times-Roman, 14 Symbol, 15 ZapfDingbats.

Результат. pro/1/1.pdf.

Пример.

 1 pro/0/QR-vgkohn pro/1/1  E
 16 60 160 0 10 0 0 0 0 Privet_Mir_! E

Тонкости.

• Внутри текста пробелов быть не должно — пишите _, программа заменит его на пробел. После текста обязателен пробел.
• Русские буквы встроенные шрифты PDF не поддерживают — только латиница.
• В текст можно вставлять текстовые коды VKACL: например, \u32 32 32*3; даёт пять пробелов (числа — номера символов Юникода).

№39. PDF to PRINT — лист с картинками для печати

Что делает. Делает одностраничный PDF, на который можно положить сколько угодно картинок. Главное применение — разложить картинки на лист A4 и напечатать.

Входные данные — первые строки файла. Все пути считаются от папки pro:

Результат. pro/pri.pdf.

Пример — два портрета шириной 220 pt на листе A4:

 596 842 2|pri
 11 100 150 0 220 0|0/jad.jpg
 11 150 500 0 220 0|0/jad.jpg

Тонкости.

• После имени файла в строке ничего быть не должно — никакой буквы E.
• Следующая картинка закрывает предыдущие; картинки «по координатам» лучше ставить после «потоковых». Режим «потоком» автор советует не использовать или проверять пробой.
• При L = 0 и масштабе 100 % один пиксель картинки равен 1 pt.

№61. SWP4rus — PDF из TeX-файла редактора SWP

Что делает. Помогает сделать PDF из TeX-файла, записанного редактором Scientific WorkPlace 4 и новее, если в нём есть русский текст. SWP кодирует русские буквы так, что ни сам SWP, ни MiKTeX не могут сделать PDF. Программа перекодирует их в windows-1251 и готовит запуск MiKTeX.

Что нужно заранее.

• Установленный MiKTeX, настроенный на русский язык.
• В первой строке файла pro/pdf/swp4rus.dat — путь к папке bin MiKTeX на вашем компьютере, с разделителем в конце (сейчас там путь автора). Программа проверяет, что в этой папке есть pdflatex.exe.
• TeX-файл с нужными пакетами для русского языка. Проще всего начинать с шаблонов pro/pdf/sample1.tex … sample4.tex; для пробы — sample4.tex.

Входные данные. Нет. Поставьте курсор в начало первой строки и нажмите Esc.

Как работать.

1. В окне выбора (оно открывается в pro/pdf/) выберите TeX-файл.
2. Программа создаст pro/pdf/runsys.bat и попросит запустить его. Сначала кликните этот файл в менеджере файлов, дождитесь конца его работы и только потом нажмите OK.
3. PDF появится рядом с TeX-файлом, с тем же именем.

Тонкости. Только Windows. Файл runsys.bat создаёт сама программа — его не правят; править нужно swp4rus.dat, один раз. Подробности у автора: latex-info.

Числовые массивы и матрицы

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

Нарисовать массив помогут программы группы Графики.

№16. TXT to DAT — текстовая таблица в двоичный файл

Пошаговый пример — в разборе №21.

Что делает. Читает матрицу (или вектор) чисел из текстового файла и записывает те же числа в двоичный файл .dat, с которым работают другие программы.

Что нужно заранее. Текстовый файл с расширением .txt. В режиме матрицы каждая строка матрицы записана на отдельной строке файла.

Входные данные — одна строка:

Результат. Файл с тем же именем и расширением .dat в той же папке.

Пример. Файл pro/0/matrix.txt — 21 строка по 21 числу. Его можно прочитать как вектор из 441 числа или как матрицу 21×21 — результат одинаков:

441  1 0 pro/0/matrix  E
21 21 0 pro/0/matrix  E

Тонкости.

• В режиме «вектор» (второе число 1) разбиение по строкам не важно: читается столько чисел, сколько указано первым. В режиме матрицы строка матрицы номер i берётся со строки файла номер i (после пропущенных).
• Программа заменяет символы табуляции на пробелы прямо в исходном .txt-файле.
• Путь не должен содержать пробелов.

№17. MAT to FRAG — фрагмент матрицы

Что делает. Вырезает из матрицы прямоугольный фрагмент и записывает его в новый файл — как вырезают кусок картинки. Есть и обратный режим: вставить фрагмент из второго файла на место в первом.

Входные данные — одна строка:

Результат. Второй файл — ширина × высота фрагмента чисел.

Пример.

400 100 0 0 100 50 pro/0/m001.dat pro/1/m001f.dat 

Тонкости.

• Никаких лишних символов в конце строки. Если после двух путей стоит ещё хоть одно поле (например, привычная буква E), включается обратный режим: программа читает фрагмент из второго файла и вписывает его в первый, перезаписывая исходный файл. Второй файл при этом должен существовать и быть меньше первого.
• Фрагмент должен целиком помещаться в матрицу.

№18. MAT to Smooth — сглаживание гауссианом

Что делает. Сглаживает матрицу (свёртка с функцией Гаусса) сразу для серии ширин гауссиана и записывает все результаты в один файл. Умеет и обратную операцию — развёртку.

Входные данные — одна строка:

Результат. Файл из nd матриц подряд (nx × ny × nd чисел), по одной на каждую ширину dr, dr+dd, dr+2·dd, …

Пример.

64 1 0 1 1 5 5 3 pro/0/in999.dat  pro/1/in999.dat  E

Тонкости.

• Размер вдоль сглаживаемого индекса должен быть степенью двойки (256, 512, 1024, …): при mo = 1 — nx, при mo = 2 — ny, при mo = 3 — оба. Если это не так, сначала интерполируйте матрицу программой №19.
• d, dr и dd задаются в одних единицах.

№19. MAT RESIZE — новый размер матрицы

Что делает. Пересчитывает матрицу на другое число точек линейной интерполяцией. Область значений аргументов при этом сохраняется.

Входные данные — одна строка:

Результат. Файл с матрицей нового размера.

Пример.

400 100 512 512 pro/0/m001.dat pro/1/m001n.dat  E

№32. TIFF to TAGs — параметры TIFF-файла

Что делает. Читает служебные записи (теги) TIFF-файла и показывает главное: ширину и высоту картинки, число бит на пиксель, сжатие, порядок байтов, где лежат данные. Нужна, чтобы убедиться, что файл — 16-битная чёрно-белая картинка (значения 0–65535), пригодная для научных данных.

Входные данные — одна строка:

Как работать. В окне выбора укажите TIFF-файл.

Результат. Файл tif-inf.txt в папке TIFF-файла; он сразу открывается в редакторе.

Пример (в pro/0/ есть s001.tif):

pro/0 E

Тонкости. Если выбранный файл — не TIFF, программа сообщит об этом и прервёт работу проигрывателя (в её коде на этот случай стоит команда #stop); просто запустите _runp.bat снова.

№33. TIFFs to DATs — матрицы из TIFF-файлов

Что делает. Просматривает все файлы папки, находит среди них подходящие TIFF (8 или 16 бит на пиксель) и записывает их пиксели как числа в файлы .dat в другую папку.

Входные данные — одна строка:

Результат. pro/2/<имя>.dat для каждого подходящего <имя>.tif.

Пример.

pro/0/  pro/2/  1  E

Тонкости. Расширение исходных файлов — .tif из трёх букв: программа отрезает три последних символа имени и дописывает dat. Разделители \ превращаются в / автоматически.

№37. ADGF — подгонка функцией Гаусса

Что делает. Ищет функцию Гаусса, которая лучше всего описывает кривую из файла: подбирает положение центра и ширину, минимизируя сумму квадратов отклонений. Поиск идёт с графическим сопровождением, в конце рисуется график кривой и найденного гауссиана.

Что нужно заранее. Кривая — двоичный файл .dat из N чисел, записанных с постоянным шагом d = X/N. Координата точки j (от 0 до N−1) — x(j) = d·(j + (1−N)/2), то есть кривая центрирована на нуле.

Входные данные — одна строка:

Результат. В папке pro: график adgf.png (над ним — найденные x, w и высота M) и, если m = 1, файл adgf.txt со строкой «x w M сумма квадратов» на каждое вычисление.

Пример.

200  301 0.12 0.002 0.032 0.0002 0.0002 1   pro/0/ep01.dat 

№43. DAT to TXT — двоичный файл в текст

Что делает. Переписывает числа из .dat в текстовый файл — для программ, которые понимают только текст.

Входные данные — одна строка:

Результат. pro/1/in999.txt.

Пример.

pro/0/in999 pro/1/in999  1  1  11  0 

Тонкости. При M = 2 каждое число умножается на N, из него вычитается C, и результат пишется целым числом шириной 5 позиций — значит, не больше четырёх цифр. Вычитание убирает неизменный «фон», умножение делает числа целыми; подходящие N и C подберите по графику исходных данных.

№46. PIC to DAT — пиксели картинок в числа

Что делает. Для каждой картинки папки (JPG, PNG, GIF) записывает значения её пикселей как вещественные числа в файл .dat — для дальнейшей математической обработки.

Входные данные — одна строка:

Результат. pro/2/<имя>.dat для каждой картинки. Без весов каждый пиксель даёт три числа (красный, зелёный, синий) — всего 3·W·H чисел. С весами — одно число g = (R·r + G·g + B·b)/255 на пиксель, файл втрое меньше.

Пример.

pro/1/  pro/2/ 

Тонкости.

• Не ставьте в конце букву E: третье поле программа считает началом весов R G B.
• Ширина картинки в файл не записывается — запомните её сами. Проверка по размеру файла: 12·W·H байт в цветном режиме, 4·W·H — в сером.
• В исходной папке — только картинки.

№48. PIC to XYProf — профили картинки

Что делает. Складывает цвета каждого пикселя картинки (JPG или PNG), усредняет полученную матрицу по столбцам и по строкам и получает две кривые — профиль по X и профиль по Y. Записывает их и рисует графики.

Входные данные — одна строка:

Результат. Рядом с картинкой: m91X.dat и m91Y.dat — столбцы чисел, m91X.png и m91Y.png — графики.

Пример.

pro/0/m91.jpg  0 1 0 1 

Тонкости. Несмотря на расширение, файлы X.dat и Y.dat — текстовые (число в строке), а не двоичные.

№53. MAT to LINE — значения вдоль отрезка

Что делает. Берёт из матрицы значения вдоль прямого отрезка между двумя точками (с интерполяцией), записывает их и рисует график.

Входные данные — одна строка, ровно девять полей:

Координаты — номера точек, считая с нуля: x от 0 до nx−1, y от 0 до ny−1. Они могут быть дробными.

Результат. pro/1/new.dat (n чисел) и график pro/1/new.png: кривая нормирована на интервал 0–1, над графиком — координаты концов, минимум и максимум.

Пример.

pro/0/m001  pro/1/new  400 100 0 0 399 99 100 

Тонкости. Полей должно быть ровно девять. Лишняя буква E в конце вызовет сообщение Input data are incomplete!.

№55. DAT MOD 2 — операции над всеми файлами папки

Что делает. Выполняет одну математическую операцию над каждым числовым файлом папки.

Входные данные — одна строка:

Результат. Файлы 0001.dat, 0002.dat, … — в первой папке.

Пример.

3 100 pro/1/ pro/2/ 

Тонкости.

• Обрабатываются все файлы первой папки. Результаты ложатся туда же, поэтому при повторном запуске программа обработает и их — уберите их заранее.
• Для операций 1 и 2 во второй папке должно быть столько же файлов того же размера, либо ровно один файл — тогда он используется для всех.

№65. DAT MOD 1 — операции над одним массивом

Что делает. Выполняет операцию над массивом из файла или вычисляет его характеристики.

Входные данные — одна строка:

Операции 1–10 — те же, что у №55. Дополнительно:

Результат. Третий файл.

Пример.

3 100 pro/0/in999.dat pro/1/in999.dat pro/1/in998.dat   E

Тонкости. Для операций 1 и 2 массивы должны быть одного размера. Матрица в файле хранится по строкам: сначала первая строка, потом вторая.

№71. DAT to TIFF 1 — матрица в 16-битный TIFF

Что делает. Записывает матрицу из .dat в TIFF-файл: 16 бит на пиксель, без сжатия.

Входные данные — одна строка:

Результат. TIFF с тем же именем: pro/0/001.tif.

Пример. Буква E в конце не читается — она только показывает, что после последнего поля есть пробел:

100 165 1 0/001 E

Тонкости.

• Путь отсчитывается от pro; папку выше можно указать через ../, но выходить за пределы папки программы нельзя.
• Значения должны помещаться в диапазон целых 0–65535.
• В текущем коде третье число не используется: файл всегда пишется с порядком байтов Intel (Windows).

№77. DAT MOD 1 — преобразования матрицы в файле

Что делает. Пять операций над одним файлом: транспонирование, ограничение значений, удаление выбросов и сглаживание шума, отражение, график минимумов и максимумов строк.

Входные данные — одна строка; первые четыре поля общие:

Результат. Файл результата в той же папке (для операции 5 — .png).

Пример — транспонировать матрицу 400×100 из демонстрационных файлов:

1 pro/0/ m001.dat m001t.dat 400 100 E

Тонкости. Программа проверяет, что размер файла соответствует W×H, и при несоответствии сообщает об ошибке. В операции 5 длиной строки можно считать сумму нескольких строк: вместо 2304×1500 указать 11520×300.

№79. MAT PROP — анализ 16-битных матриц

Что делает. Специальная программа для квадратных матриц из целых чисел 0–65535 — таких, какие записывают 16-битные TIFF-файлы координатных детекторов синхротронного излучения (матрицы получают программой №33). Три операции; номер операции — первое число строки.

Операция 1 — сводка по серии файлов. Поля: 1, рабочая папка (от главной папки), имя отчёта без расширения, общее начало имён файлов, число файлов nA (1–10), число максимумов nB, размер матрицы nC. Файлы должны называться «начало + цифра 0…9» с расширением .dat. В отчёт .txt по строке на файл: минимум, максимум, среднее и координаты nB наибольших значений (координаты считаются сверху вниз).

Операция 2 — увеличенный фрагмент. Поля: 2, папка, начало имени, номер файла nA (0–9), размер матрицы nB, размер фрагмента nC, координаты x и y центра фрагмента. Рисует логарифм фрагмента в оттенках серого с обращённым контрастом (максимум — чёрный) и записывает картинку в файл.

Операция 3 — деление двух матриц и сглаживание. Поля: 3, папка, первый файл, второй файл, имя результата (все без .dat), размер матрицы nB и управляющее число Q. Цифры Q считаются справа налево: p1 — делить заново (1) или взять готовое частное (0); p2 — рисовать картинки исходных файлов; p3 — палитра 0–3; p4 и p5 — размер окна сглаживания N = p4 + 10·p5 (нечётный); p6 — 1 убирает оси; p7 — вариант палитры 3; p8 — 1 рисует логарифм. Результаты: <имя>a.dat / <имя>a.png (частное) и <имя>b.dat / <имя>b.png (сглаженное частное).

Пример (автора; папки task/… есть только на его компьютере):

  1  task/o46/5/d  info  d  1 10 2304 E
  2  task/o46/7/o4g1nc  d  4  2304 100 366 738 E
  3  task/o46/4/d  56  bg19  56b19  2304 0009311 E

Тонкости. Демонстрационных данных у программы нет. Матрицы рисуются перевёрнутыми по вертикали, чтобы выглядеть так же, как в других программах просмотра TIFF.

№80. Векторные вычисления «как в Excel»

В архиве vkacl.zip от 23.05.2026 этой программы ещё нет: строка 80 файла pro00.txt пуста, и меню Index номер 80 не принимает. Описание ниже составлено по сайту автора.

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

Вариант 1 — аргумент на равномерной сетке. Строка начинается с 0:

Результат: pro/test.png (график; над ним — минимум и максимум первых трёх функций) и pro/test.txt (столбцы чисел).

Вариант 2 — аргументы из файла. Строка начинается с числа аргументов na (1–4): na nf nA файл_аргументов файл_результата f1 f2 …. Файл аргументов (.txt, без расширения во входных данных) содержит na столбцов по nA строк; аргументы называются A, B, C, D. Результат — только функции в <файл_результата>.txt и график .png.

Пример (с сайта автора):

0  2  0  9  10  pro/test  A   A*A  E

Тонкости. Формулы пишутся без пробелов, по правилам выражений VKACL (см. Выражения и функции).

Графики

Программы этой группы рисуют числовые данные: кривые, карты матриц, квазитрёхмерные и аксонометрические графики, анимацию сечений. Данные берутся из текстовых файлов или из двоичных .dat (см. Числовые файлы .dat); картинки сохраняются в PNG, а №49 и 50 — в EPS и PDF.

Общие правила записи входных данных — в разделе Как записывать входные данные. Подписи над графиками пишутся без пробелов: вместо пробела ставьте _.

Текстовые файлы с числами. Программы №20, 21 и 22 перед чтением заменяют в копии файла табуляции на пробелы, а запятые — на точки. Значит, десятичная запятая допустима, но разделять числа запятыми нельзя — только пробелами, табуляциями или переводами строк.

№03. DAT to PNG 2 — картинки из матриц всех файлов папки

Что делает. Для каждого числового файла папки рисует картинку прямоугольного фрагмента матрицы (или всей матрицы) — без осей и подписей — и записывает её в PNG. Удобно для серий однотипных файлов.

Что нужно заранее. В исходной папке — только двоичные файлы .dat одинакового размера. Папка для картинок существует.

Входные данные — одна строка:

Результат. pro/2/<имя>.png для каждого <имя>.dat. Сама программа картинки не показывает — в конце она сообщает папку, а смотреть их удобно программой №54.

Пример. Скопируйте m003.dat из pro/0/ в pro/1/, затем:

pro/1/ pro/2/ 640 169 0 0 640 169 0 0 E

Тонкости. Имена файлов упорядочиваются по алфавиту; у картинки то же имя, что у файла, с расширением .png. Для одного файла удобнее программа №70.

№20. 1D PIC 1 — график кривых

Что делает. Рисует в рамке с осями график одной или нескольких функций из файла. Большинство оформления задано заранее, во входных данных — только главное.

Входные данные — одна строка: девять чисел, подпись, файл.

Форматы: t = 1 — текст столбцами, первый столбец — аргумент, остальные — функции; t = 2 — текст столбцами, только функции; t = 3 — двоичный .dat, сначала все точки первой функции, потом второй и так далее.

Результат. PNG с тем же именем рядом с файлом данных: pro/0/in999.png. График показывается на экране (если s > 0).

Пример.

1 77 1 77 0 76 1 3 0  рис._1 pro/0/in999.dat  E

Тонкости. Отрицательный масштаб удобен в цепочках программ (№57), когда окна с графиками не нужны. Для серии файлов с одинаковой структурой есть №67.

№21. 2D MAP — карта матрицы

Подробный разбор с примером — Разбор: №21 2D MAP.

Что делает. Рисует матрицу как карту: каждая точка — прямоугольник, окрашенный по значению (оттенки серого или цвет). Оси размечаются по заданным пределам аргументов, сбоку — шкала цветов, над картой — подпись, минимум и максимум.

Входные данные — одна строка: nx ny x1 x2 y1 y2 p1 p2 tf sf td Подпись Файл.

tf: 1 — полный график, серый; 2 и 3 — полный, цветной (две разные палитры); 4, 5, 6 — то же, но только сама картинка без осей и шкалы (размер ровно nx·p1 × ny·p2).

td: последняя цифра — формат (1 — текст, 2 — двоичный .dat); вторая с конца, если 1, — не показывать график на экране; третья с конца, если 1, — обратить палитру (максимум и минимум меняются местами). Например, 1, 11, 111, 2, 12.

Результат. PNG рядом с файлом данных: pro/0/matrix.png.

Пример.

21 21 -5 5 -4 4 9 9  2 1 1  Матрица_чисел  pro/0/matrix.txt 

Тонкости. Числа идут так: сначала нижняя строка карты слева направо, потом строка над ней и так далее. В текстовом файле разбиение по строкам не важно.

№22. 2D as SET 1D — семейство сдвинутых кривых

Что делает. Рисует функцию двух переменных как серию кривых-сечений, сдвинутых друг относительно друга, с удалением невидимых линий — получается квазитрёхмерный график без искажений в сечениях.

Входные данные — одна строка: двенадцать чисел и файл.

Данные идут подряд: все nx значений первой кривой, потом второй и так далее.

Результат. Два графика рядом с файлом: fxy2a.png и fxy2b.png.

Пример.

141 41  -1 1   1 100   1  1   15  2   20 20  pro/0/fxy2.dat 

Тонкости. Лучше всего выходит, когда кривых хотя бы вдвое меньше, чем точек в каждой (ny < nx/2): иначе график сильно вытягивается вправо. Это поправляют параметрами sa и wa.

№23. 2D as AXON — аксонометрия поверхности

Что делает. Рисует поверхность z(x, y), заданную матрицей, в аксонометрической проекции — с осями, подписями и сечениями.

Входные данные — одна строка: двадцать чисел, подпись, файл.

Результат. PNG рядом с файлом данных: pro/0/m001.png.

Пример.

400 100 -6 6 197 256 0 55.6 1100 30 12 18 10 200 5. 1 9 9 100 100 Axon_pro pro/0/m001.dat 

Тонкости.

• Произведение kx·ky не должно превышать 65536, иначе программа откажется работать. Разумно kx = ky = 100, предельно — 180. При артефактах уменьшите число точек.
• На осях стоят настоящие значения аргументов, но для рисунка фигура должна быть примерно одинаковой по трём осям. Ось z берётся за основу, а размеры по x и y подгоняются множителями sx и sy.
• Значение dv в примере — 200; подбирайте его, отталкиваясь от примера.
• В текущем коде вместо vz передаётся vx, так что третья координата точки зрения на рисунок не влияет.

№24. 2D as ANIM — анимация сечений

Что делает. Показывает строки матрицы по очереди как плоский график — получается анимация, в которой кривая меняется со временем.

Входные данные — одна строка: пять чисел, подпись, файл.

Управление.

Пример.

400 100 -20.48 20.48 4 Intensity pro/0/m001.dat  E

Тонкости. nx·ny не может быть больше, чем размер файла в байтах, делённый на 4.

№49. EPS 1D — график кривых в EPS и PDF

Что делает. Строит график кривых в векторном формате EPS и переводит его в PDF — для статей. Входные данные — смесь чисел и команд PostScript из книги автора (учебник по PostScript); если вы не знаете PostScript, меняйте в примере только числа.

Что нужно заранее.

• Установленный MiKTeX (для перевода EPS в PDF нужна его программа epstopdf.exe).
• Данные — двоичные файлы pro/in<номер>.dat, по файлу на кривую (например, pro/in999.dat; для примера скопируйте его из pro/0/).

Входные данные — первые строки файла (рабочая папка — pro):

Результат. pro/f003.eps; после ответа Yes на вопрос программы — ещё и pro/f003.pdf, который сразу открывается.

Пример (автора; путь к MiKTeX замените своим):

700 450 1  3
 /FS 26 def  13 412 m (I)I( / )L(I)I()L(0)ib   500 20 m (\()L(D)G(E)I( / )L(E)I(\))L( x 10)L(4)it  gs 77 92 tr
  600 300 6 12 26 -2.4 2.4 0 90 par -2 1 0 parx axx  0 20 0 parf axf
 999  1  1.5 slw  0 0 0  srgb  -2.28  2.28  77  0.1 figl
C:\_vk\Miktex\miktex\bin

Тонкости. Число точек в строке кривой может быть меньше числа значений в файле, но не больше. Перевод в PDF идёт через runsys.bat и работает только в Windows.

№50. EPS 2D — карта матрицы в EPS и PDF

Что делает. Вторая часть «EPS-набора»: рисует матрицу картой контраста в EPS и переводит в PDF.

Что нужно заранее. MiKTeX (как у №49); матрица — двоичный файл pro/m<np>.dat (для примера скопируйте m998.dat из pro/0/ в pro/).

Входные данные — две первые строки. Первая — это кусок кода VKACL, в котором достаточно менять числа:

После #pr в той же строке — подписи осей на PostScript (xti, yti). Вторая строка — путь к папке bin MiKTeX.

Результат. В папке pro: p998.png (голая картинка), p998.eps, p998EPS.txt (картинка в коде EPS, для продвинутых) и, после ответа Yes, p998.pdf.

Пример (автора):

# np=998; nx=400; Sc=100; Sx=-35; x1=-3; x2=4; y1=105; y2=125; f1=0; f2=61.7; m=1; pp=11; #pr /xti{(x)I(, )H ds2 (MKM)H is2}bd  /yti{(z)I(, )H ds2(CM)H is2 40 0 rm (I)I( / I)I()H(0)ib}bd\E
C:\_vk\Miktex\miktex\bin

Тонкости. На сайте автора сказано, что файл берётся из папки data, а результаты пишутся в папку eps; в коде программы и то и другое — папка pro. Русские буквы в подписях PostScript не используются.

№67. 1D PIC 2 — графики для всех файлов папки

Что делает. Для каждого двоичного файла папки рисует график (как №20 с форматом t = 3) и записывает его в PNG, не показывая. Удобно, когда файлов много и они одинаково устроены — например, одна зависимость при разных внешних параметрах.

Входные данные — одна строка из одиннадцати полей:

Результат. <папка графиков>/<имя>.png для каждого файла.

Пример. Скопируйте in999.dat из pro/0/ в pro/1/ (можно ещё одну копию под другим именем), затем:

1 77 1 77  -1 1  1 0  рис._1 pro/1/  pro/1/ 

Тонкости. Лучше брать папки внутри папки программы и писать относительный путь. Символ _ программа заменяет на пробел не только в подписи, но и в путях к папкам — папки с _ в имени не подойдут.

№70. DAT to PNG 1 — картинка из фрагмента матрицы

Что делает. Как №03, но для одного файла: рисует прямоугольный фрагмент матрицы (или всю матрицу) без осей и записывает в PNG с заданным именем.

Входные данные — одна строка:

Результат. pro/2/m003.png; показывается на экране, если S = 0.

Пример.

pro/0/m003 pro/2/m003 640 169 0 0 640 169 0 4 

Тонкости. Если полей меньше десяти, программа сообщит, что чего-то не хватает.

Тексты и файлы

Программы для работы с текстовыми файлами и с файлами вообще: поиск, подсчёт, замена, шифрование, склейка, редактирование, электронные книги.

Общие правила записи входных данных — в разделе Как записывать входные данные.

№02. SYMBOL — сколько раз символ встречается в файле

Что делает. Считает, сколько раз заданный символ встречается в файле, и показывает число в окне. Например, по символу перевода строки можно узнать число строк.

Входные данные — одна строка, в одном из двух видов:

Результат. Окно с текстом File has this symbol N times.

Пример — сколько строк (символов с кодом 10) в файле:

^pro/0/figure.pro 10 E

Тонкости.

• Второй вид нужен для символов, которые не набрать на клавиатуре: перевод строки (10), табуляция (9), пробел (32) и т. п.
• В обычном виде путём считается всё, что стоит после символа, до конца строки, поэтому не ставьте в конце ничего лишнего. Если сомневаетесь, пользуйтесь видом с ^.
• В файле входных данных можно держать строки для многих файлов и выбирать нужную курсором.

№05. FIND WORD — поиск слова во всех файлах папки

Что делает. Ищет слово во всех файлах с заданным расширением в одной папке, показывает список найденных мест и предлагает посмотреть или отредактировать эти файлы.

Входные данные — одна строка:

Результат. Файл pro/word_in_files.txt: по строке на файл — имя и номера байтов, где найдено слово. Он показывается в редакторе, затем программа предлагает выбор:

При просмотре Esc переходит к следующему месту, а крестик окна прекращает работу.

Пример — найти символ @ во всех файлах .acl папки pro:

@  acl  pro E

Тонкости.

• Вложенные папки не просматриваются.
• Расширение сравнивается по первым трём буквам: htm найдёт и .html.
• Если ничего не найдено, программа так и скажет.

№15. CIPHER — редактор зашифрованных текстов

Что делает. Позволяет хранить текстовый файл на диске только в зашифрованном виде и при этом редактировать его как обычный текст. Ключ — число от 1 до 255.

Что нужно заранее. Текстовый файл с латиницей (коды 0–127) и русскими буквами в кодировке windows-1251.

Входные данные — одна строка:

Результат. Тот же файл, перезаписанный (зашифрованным или расшифрованным — по режиму).

Пример.

2 123 pro/0/Эти-глаза-напротив.txt  E

Тонкости.

• Обычный порядок: первый раз режим 1, дальше — 2, а чтобы вернуть файлу обычный вид — 3.
• Все операции с одним файлом делайте с одним и тем же ключом. Забытый ключ не восстановить.

№25. EDITOR — большой редактор текстов

Что делает. Открывает указанный файл в большом редакторе — с множеством функций обработки текста и использования его для других операций. Описание редактора — на сайте автора: vkNotepad.

Входные данные — одна строка:

Пример.

pro/note.txt 

Тонкости.

• Чтобы редактор мог открывать сайты, укажите в 17-й строке файла vkNP/par.txt полный путь к своему браузеру (сейчас там путь автора).
• Для проверки опечаток нужен словарь из архива vktot.zip.
• Файл pro/note.txt — «дежурная записная книжка» автора, в неё можно писать что угодно.

№26. LINE EDIT — правка одной строки файла

Что делает. Показывает в редакторе одну строку файла с заданным номером, предварительно заменив в ней символы ~ на переводы строк; после правки делает обратную замену и записывает строку на место. Удобно для файлов-«баз», где каждая строка — отдельная запись: код программы, подпись к фотографии и т. п. Так, например, устроены pro00.txt и idc00.txt.

Входные данные — одна строка:

Результат. Исправленная строка в том же файле. Если нужно только посмотреть, закройте редактор крестиком — ничего не изменится.

Пример (автора — строка 63 файла с кодом программ):

63  pro00.txt 

Тонкости. pro00.txt — это код готовых программ, а idc00.txt — ваши входные данные. Правьте их, только понимая, что делаете; для пробы возьмите копию файла.

№36. COPY FILEs — склеить файлы в один

Что делает. Складывает несколько файлов побайтно, один за другим, и записывает результат в новый файл. Годится и для текстов, и для музыки.

Входные данные — одна строка:

Результат. pro/0/new.txt.

Пример.

pro/0  matrix.txt+matrix.txt+matrix.txt  new.txt E

№64. TXT to FB2 — электронная книга

Что делает. Делает электронную книгу формата FB2 из текстового файла с простой специальной разметкой.

Что нужно заранее.

• Текст книги в файле .txt (кодировка windows-1251), размеченный по правилам автора. В начале файла — строки с параметрами книги, например `название == Моя книга, `фамилия == Иванов; главы и абзацы отмечаются особыми символами. Правила — в файле pro/0/book.htm (из vkacld.zip) или на сайте: book.htm. Образец — pro/0/mylife.txt.
• Картинка обложки: файл JPG с тем же именем рядом с текстом (mylife.jpg для mylife.txt).

Входные данные — одна строка:

Результат. pro/0/mylife.fb2. Программа предлагает сразу открыть его.

Пример.

pro/0/mylife.txt 

№72. DAT MOD 2 — замены текста во всех файлах папки

В списке автора эта программа носит то же имя, что и №55, но работает с текстом.

Что делает. Меняет текст во всех файлах папки сразу — любого типа. Файлы переписываются на месте, исходного вида не останется.

Входные данные — одна строка: номер операции, папка, тексты.

Результат. Изменённые файлы в той же папке. Программа ничего не показывает — смотрите результат сами.

Пример.

1 pro/1/  E
2 pro/1/ старое новое E
3 pro/1/ ( [ ) ] E
4 pro/1/ ( ) . E

Тонкости.

• Преобразование необратимо — сделайте копию папки. В папке не должно быть посторонних файлов.
• Тексты — только из печатных символов, без пробелов. Чтобы что-то удалить или заменить на пробел, замените это на редкий символ, а его потом уберите в редакторе.
• Лишняя буква E в конце не мешает — автор даже советует её ставить.

№75. Exe FILE — открыть файл по расширению

Что делает. Менеджер файлов особого вида: вы выбираете файл, а программа «исполняет» его в зависимости от расширения.

После этого программа спрашивает, повторить ли.

Входные данные — одна строка: путь к любому файлу в той папке, с которой начать выбор.

Пример.

pro/note.txt

Тонкости. Вся строка считается именем файла: пишите его с первой позиции, без пробелов (замените их на - или _) и без лишних символов в конце.

Сайты

Эти программы готовят веб-страницы: сайт с фотографиями, слайд-шоу, статью из текста, сложный сайт по разметке, копию чужой статьи, страницу для перевода. Результат — файл .htm, который можно открыть в браузере на своём компьютере или выложить в интернет.

Готовую страницу программа обычно предлагает открыть (кнопки Wait / Go). Если браузер не открылся, найдите файл в папке или кликните runsys.bat в главной папке программы. Общие правила записи входных данных — в разделе Как записывать входные данные.

№01. FOTO SITE — сайт фотографий с комментариями

Что делает. Делает заготовку сайта: таблицу иконок фотографий по пять в ряд. Клик по иконке показывает большую фотографию, клик по фотографии возвращает к таблице. Иконки шириной 240 px программа делает сама. Комментарии к фотографиям вы потом дописываете в готовый файл вручную (можно и не дописывать — сайт готов сразу).

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

Входные данные — семь первых строк файла:

Результат. В папке из строки 6: иконки s<имя>.jpg (к имени фотографии спереди добавлена буква s) и страница m9s.htm. Иконки и страница должны лежать в одной папке; m9s.htm можно переименовать.

Пример (автора). Скопируйте m91.jpg … m95.jpg из pro/0/ в pro/1/ и icons.htm из pro/0/ в pro/2/:

Круиз 25. 12-я часть. Фотографии с круиза на теплоходе Александр Пушкин. Виктор Кон. Victor Kohn.
Фотографии с круиза на теплоходе Александр Пушкин в 2025-м году. 12-я часть.
Кон В. Г. . . . 26-06-2025 . . . http://kohnvict.narod.ru
http://kohnvict.narod.ru/s/2506/C/
pro/1/
pro/2/
<iframe frameborder=0 width=860 height=80 src="icons.htm"></iframe>

Тонкости.

• Строки 4 и 5 программа вставляет в код страницы как есть; адрес из строки 4 стоит в коде закомментированным, работает адрес из строки 5. Чтобы выложить сайт в интернет, в готовом файле переставьте комментарий с одного адреса на другой; так же можно поправить букву диска для флешки.
• Надёжнее всего держать обе папки внутри папки программы и писать относительные пути, как в примере: программа сама посчитает путь от страницы к фотографиям.
• Если число фотографий не кратно пяти, лишние не попадут в таблицу иконок.
• Места для комментариев в m9s.htm отмечены пустыми строками; удобно писать текст после каждого ряда из пяти иконок.
• Страница подгружает фон, скрипт и кнопку перевода с сайтов автора — без интернета они не появятся.

№04. SLIDE SHOW — слайд-шоу по картинкам папки

Что делает. Делает страницу слайд-шоу по всем картинкам папки: каталог иконок, удобная навигация, смена кадров. Интернет не нужен — картинки показываются прямо с компьютера.

Что нужно заранее. Папка с картинками в формате, который понимает браузер (PNG, JPG, GIF). Лучше одного размера — иначе они будут приведены к одному.

Входные данные — одна строка:

Результат. Страница pro/show.htm; программа предлагает её открыть.

Пример — картинки 1280×960 (отношение 3 : 4) в pro/1/:

pro/1/ 3 4 E

Тонкости.

• Подсказок на странице нет: кликните в любом месте, чтобы пойти дальше, а кнопка H покажет, что можно делать. Кнопки дублируются клавишами.
• Картинки упорядочены по алфавиту имён.
• Если задать отношение, не совпадающее с картинками, они растянутся. При слишком большом отношении кнопки могут уйти за правый край окна — чуть уменьшите его.
• Остальные параметры показа — во второй строке файла pro/b/showA.txt (кроме первых двух, которые берутся из входных данных); их смысл описан на сайте программы слайд-шоу.
• Музыка заиграет, только если в show.htm вручную указать реальный файл.
• Чтобы выложить сайт в интернет, в show.htm замените адрес папки на адрес на сервере и переименуйте файл. На смартфоне страница не работает.

№38. SIMP SITE — простой сайт из текста

Что делает. Превращает обычный текстовый файл в веб-страницу по шаблону автора. Разметка почти не нужна.

Что нужно заранее. Текстовый файл .txt: в первой строке — заголовок статьи, во второй — автор и что-нибудь о нём (всё в одну строку), с третьей — сам текст; абзацы разделяются пустой строкой.

Входные данные — одна строка:

Как работает. Сначала текст открывается в редакторе — его можно подправить. После выхода по Esc рядом создаётся страница.

Результат. pro/0/exam0.htm.

Пример.

pro/0/exam0  E

Тонкости. Файл exam0.txt — одновременно образец и инструкция по подготовке текста. Не правьте его, а скопируйте под другим именем. Если нужна страница посложнее — №44, если для перевода — №74.

№44. COMP SITE — сложный сайт по разметке

Что делает. Делает сайт на HTML, CSS и JavaScript, но писать на этих языках не нужно: текст размечается простыми трёхсимвольными командами. Описание разметки — на сайтах автора txthtmh и txt-htm-ex.

Как устроены проекты. Рабочая папка — pro/sites/. Каждый сайт — проект с номером от 01 до 99: текст проекта 2 лежит в pro/sites/pro02.txt, готовый сайт — pro/sites/pro02.htm, дополнительные файлы (объекты txthtmo.txt, внешние тексты txthtmt.txt, картинки, музыка) — в папке pro/sites/02/. Проект 01 уже есть: он показывает все возможности разметки. Новый проект создаётся сам — копированием проекта 01, когда вы впервые укажете его номер.

Входные данные — одна строка из двух чисел: номер проекта и номер операции.

Результат. pro/sites/proNN.htm.

Пример — удобно сразу записать пять строк и выбирать операцию курсором:

2 1
2 2
2 3
2 4
2 5

Тонкости.

• После каждой операции программа спрашивает, продолжать ли; сайт удобно делать по частям, объект за объектом.
• Картинки и другие файлы нового проекта скопируйте в его папку вручную (или ссылайтесь на другие папки и адреса в интернете).
• Во внешних текстах вместо перевода строки пишут символ `. Редактор не показывает номера строк, но Ctrl+W переключает режим длинных строк, а Alt+I сообщает номер строки под курсором.
• Для пробы автор советует проект 01: выполните операцию 2 и согласитесь открыть готовый файл. Если сайт не открылся, кликните runsys.bat.

№52. FOTO SHOW — фото-шоу под музыку

Что делает. Делает страницу фото-шоу: фотографии сменяются автоматически под музыку, есть панель управления и правила (скрыты, открываются кнопкой).

Что нужно заранее. Файл данных .txt (путь считается от папки pro):

Последняя строка тоже должна кончаться переводом строки.

Входные данные — одна строка:

Как работает. Файл данных сначала открывается в редакторе; после выхода по Esc программа собирает страницу.

Результат. pro/out.htm.

Пример (файл данных pro/0/in.txt есть в vkacld.zip):

0/in out 

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

№66. WEB SITE — копия статьи из интернета

Что делает. Помогает переложить интересную статью из интернета в свой аккуратный формат: текст отдельно, картинки отдельно — таблицей иконок, которые открываются по клику. Работа полуавтоматическая: часть шагов вы делаете вручную, строго по порядку.

Входные данные — восемь первых строк файла:

Параметры восьмой строки: n — число картинок (0 — без картинок, остальное тогда не важно); w, h — их ширина и высота; af — общее начало адресов картинок; ef — окончание (расширение). Картинки нумеруются двумя цифрами: af + 01 + ef, af + 02 + ef, …

Как работать.

1. Выйдите из редактора по Esc. Программа запишет страницу и откроет её в большом редакторе.
2. Выделите текст статьи на сайте-источнике, скопируйте (Ctrl+C) и вставьте в место с подсказкой (Ctrl+V).
3. Проверьте, что абзацы разделены ровно одной пустой строкой. Строку-заголовок можно выделить знаком $ в начале и в конце.
4. В меню редактора выберите кодировку UB (Unicode Big Endian) и концы строк как в Windows. Выйдите по Esc.
5. Программа сделает замены и снова откроет текст. Ничего не меняйте, только выберите кодировку UTF-8 General marker и выйдите по Esc.

Результат. Файл из строки 1. Сам он не открывается — найдите и откройте его в браузере.

Пример (адреса условные):

pro/1/article.htm
Название для вкладки браузера
https://example.ru/source-article
readme.htm
Заголовок статьи
../0/bgim2.gif
 
n=0; w=900; h=675; af="http://example.ru/pics/"; ef=".jpg";

Тонкости. Пример автора во входных данных ссылается на его папки и работает только на его компьютере — подготовьте свои данные. Ссылку на источник и автора статьи оставляйте обязательно.

№74. CH LANG — страница с кнопкой перевода

Что делает. Превращает текстовый файл в веб-страницу с кнопкой выбора языка: Google переводит её с русского на любой из 54 языков. Переведённый текст можно скопировать.

Что нужно заранее. Текстовый файл .txt:

• первые символы файла — &1, последние (без пробелов и перевода строки перед ними) — &2; без них страница не покажется;
• абзацы начинаются после пустой строки, заголовки разделов — после двух пустых строк;
• можно использовать простые HTML-теги (<b>…</b>, <i>…</i>, картинки). Общий заголовок — так: &1<h1>Заголовок</h1>.

Входные данные — одна строка:

Результат. Текст копируется в pro/b/textforsite.js, а в браузере открывается страница pro/b/ini-fr01.htm.

Пример.

pro/0/MFL1s E

Как перевести. Нужен интернет. Выберите язык кнопкой на странице и пролистайте весь текст — Google переводит то, что появилось на экране. Затем Ctrl+A, Ctrl+C и вставьте текст в любой редактор.

Тонкости.

• Страница состоит из нескольких файлов, и при следующем запуске textforsite.js перезаписывается. Чтобы сохранить результат, скопируйте ini-fr01.htm под другим именем и вставьте в него содержимое textforsite.js вместо ссылки на этот файл.
• Сохранить из браузера переведённый текст можно только в mhtml или PDF; при сохранении в HTML сохранится русский оригинал.
• Если нужна страница одним файлом, берите №38 или №44.

Звук, анимация, игры

Презентации, слайд-шоу под музыку, проигрыватель mp3, игры и демонстрационные анимации. Общие правила записи входных данных — в разделе Как записывать входные данные.

№27. LECTURE — показ презентации и картинок

Что делает. Три связанных применения:

1. Показ доклада из zip-архива со слайдами-картинками — во весь экран, с быстрым переходом к любому слайду через таблицу иконок.
2. Просмотр всех JPG и PNG в любой папке — и заодно подготовка архива для первого режима.
3. Запуск программ на VKACL прямо из презентации: анимаций, расчётов, дополнительных материалов к слайдам.

Входные данные — одна строка:

Управление.

Как устроен архив презентации.

• Папка lect: слайды s001.jpg, s002.png, … — буква s и трёхзначный номер слайда; картинка-таблица иконок s999.jpg; других картинок быть не должно (числовые файлы можно).
• Папка anim: картинки для программ-анимаций; в ней должен лежать хотя бы один файл, даже неиспользуемый, иначе при выходе будет ошибка.
• Программы для слайдов: либо общая lect/s999.pro, в которой варианты для разных слайдов выбираются по переменной ku (номер слайда), либо отдельные lect/s005.pro для слайда 5 и т. д.

Как подготовить архив. Откройте в режиме 2 папку со слайдами (имена любые), нажмите Z — в главной папке программы появится lect.zip с папкой lect. Папку anim и программы добавьте в архив вручную, затем переименуйте архив как угодно (расширение .zip).

Результат. Показ на экране. В режиме 2, если таблицы иконок s999 ещё нет, программа строит её (это небыстро) и сохраняет в папку, чтобы в следующий раз не строить заново.

Пример — демонстрационная презентация из vkacld.zip:

zip/240725.zip 0

Тонкости.

• Лишнюю букву E в конце не ставьте: второе поле программа читает как число.
• Слайды меньшей ширины ставятся по центру, остальное поле чёрное.
• Папки lect и anim на время показа извлекаются из архива и удаляются после выхода.
• Программы на VKACL для слайдов должны быть полностью отлажены: при первой же ошибке показ прекратится. Набор готовых анимаций автора описан на его странице animations.

№41. GAME PIC — игра-мозаика

Что делает. Тренажёр зрительной памяти. Вы рассматриваете картинку, затем она режется на 48 квадратов 100×100, которые перемешиваются. Нужно собрать картинку обратно, меняя квадраты местами попарно.

Входные данные. Нет — программа сразу открывает окно выбора картинки в папке pro/0/.

Как играть.

1. Выберите картинку размером 800×600 — например, game.jpg из vkacld.zip.
2. Рассмотрите и запомните её, затем нажмите Enter.
3. Наведите мышь на квадрат и нажмите Пробел (или кликните) — он отметится крестиком. Наведите на квадрат, с которым надо поменяться, и снова Пробел или клик.
4. Повторяйте, пока картинка не соберётся. Надоело — закройте окно крестиком.
5. Программа спросит, сыграть ли ещё.

Тонкости. Если выбранная картинка не 800×600, программа уменьшит или увеличит её, запишет как pro/0/tmp.jpg и попросит запустить игру снова и выбрать этот файл.

№42. GAME MOV — движение упругих шаров

Что делает. Демонстрация законов механики: пронумерованные твёрдые шары летают в замкнутой области, отскакивая от стенок, препятствий и друг от друга без потери энергии. Четыре сюжета; параметры можно менять и наблюдать.

Входные данные — одна строка: номер сюжета и его параметры.

Управление. Enter — движение, Пробел — остановка, Esc — выход.

Пример — значения автора, оптимальные для каждого сюжета:

1  500 500 13 13 900 1 10
2  400 40 20 6 12 90 60 20 10
3  600 400 6 8 200 12 10 22
4  6

Тонкости.

• Ошибки во входных данных не проверяются: при неудачных значениях программа может просто перестать работать — запустите её заново.
• Не давайте одному шару слишком большую скорость: за один шаг он может «проскочить» стенку. Большую энергию лучше раздать нескольким шарам.

№63. FM-PLAYER — проигрыватель mp3 в браузере

Что делает. Делает страницу-проигрыватель для всех mp3-файлов папки с удобной навигацией и открывает её в браузере. Интернет не нужен.

Входные данные — одна строка:

Результат. Страница pro/b/mp.htm; программа предлагает открыть её.

Пример.

pro/1/1/  2  E

Тонкости.

• Без папки с mp3-файлами программу запускать бессмысленно — сначала положите несколько файлов в какую-нибудь папку.
• Файлы других типов в папке не мешают; mp3 упорядочиваются по алфавиту.
• На странице есть кнопка Info с подсказками. Вид 1 подстраивается под ширину окна браузера; если не помещается по высоте — сузьте окно.
• Страница перезаписывается при каждом запуске. Чтобы выложить её в интернет, замените в mp.htm адреса файлов на адреса на сервере и переименуйте её.

№69. vkSS — слайд-шоу под музыку

Что делает. Показывает слайд-шоу по заранее написанному протоколу: картинки сменяются под фоновую музыку с эффектными переходами, могут увеличиваться и плыть по экрану, на них появляются надписи.

Входные данные — одна строка:

Протокол — текстовый файл:

• Первая строка: адрес музыки, |, пять чисел: номер картинки, к которой вернуться после последней; ширина и высота окна показа, px; смещение левого верхнего угла окна от угла экрана (отрицательное — окно по центру).
• Строки картинок: #, адрес картинки, |, время показа в сотых долях секунды; дальше необязательно — номер перехода (0–12), смещение центра картинки по x и y, и тройка чисел для «движения»: интервал между кадрами (сотые секунды; 0 — без движения), шаг в пикселях (может быть отрицательным) и вид — 0 изменение размера, 1 движение по горизонтали, 2 по вертикали.
• Строки надписей (после строки картинки, сколько угодно): text=Текст| T S X Y R G B K — время показа (сотые секунды), размер шрифта, левый нижний угол текста, цвет, начертание (0–3). Шрифт — Sans Serif; русский текст допустим.

Адреса — в виде URL: http://… или для своего компьютера File:C:/папка/файл. Музыка — только MIDI (.mid).

Переходы: 0 — мгновенно; 1 — старая картинка схлопывается к центру; 2, 3, 4 — новая вырастает из центра, из левого верхнего, из левого нижнего угла; 5 — падает сверху; 6 — наползает слева; 7 — плавное смешивание; 8 — затухание и проявление; 9–12 — новая выталкивает старую слева, справа, сверху, снизу.

Управление.

Пример — протокол pro/0/sky0.vks; первые его строки:

File:C:/0/sky/Julio-Iglesias-Je-Nai-Pas-Change.mid|1 840 640 -1 -1
#File:C:/0/sky/sky.png|400 0 0 0
#File:C:/0/sky/s000.jpg|400 1 0 0
#File:C:/0/sky/s001.jpg|400 2 0 0

Картинки и музыки к нему в архивах нет: их нужно скачать с Яндекс-диска автора (ссылка — во входных данных программы) и положить в C:\0\sky\.

Тонкости.

• Не закрывайте окно крестиком — выходите по Esc.
• Картинки показываются без масштабирования: большие обрезаются окном, а меньшие ложатся поверх предыдущих, и те видны по краям.
• Надпись появляется только после того, как закончится движение картинки; на движущиеся картинки надписи не ставьте. Координаты надписи отсчитываются по картинке, а не по окну.
• Правила протокола описаны и на сайте автора: vkss.

№99. DEMO — рекламная анимация VKACL

Что делает. Показывает анимации, рекламирующие язык VKACL: картинку, которая растёт, и текст, который появляется строка за строкой, под музыку.

Входные данные. Нет. Поставьте курсор в начало файла и нажмите Esc.

Как работать. В меню выберите Picture size, Text size или All together; Exit — выход. Остановить анимацию — крестиком в правом верхнем углу окна.

Автоматизация и система

Программы, которые запускают другие программы, файлы и команды: панель кнопок, «проигрыватель в проигрывателе» для своего кода, цепочки готовых программ, команды операционной системы. Общие правила записи входных данных — в разделе Как записывать входные данные.

№28. RUNNER — панель кнопок

Что делает. Показывает таблицу из 176 кнопок (11 × 16). Каждую кнопку вы настраиваете сами: открыть файл в редакторе, запустить его средствами системы, выполнить как программу VKACL, открыть папку. Так под рукой оказываются самые нужные файлы, документы и программы.

Входные данные. При запуске файл входных данных не показывается — сразу появляется таблица. Первая строка файла — пояснение (не читается), со второй строки идут кнопки: строка 2 — кнопка 1, строка 3 — кнопка 2 и так далее. Формат строки:

Название кнопки| действие путь

Путь — полный или от папки программы.

Как работать. Кликните кнопку — действие выполнится, и таблица появится снова (после действия 5 программа, судя по коду, заканчивает работу). Выход — крестик окна таблицы. В заготовке автора первая кнопка Edit ID открывает сам файл кнопок (pro/0.par) — так их и настраивают; изменения сохранятся.

Пример — начало файла кнопок:

Пояснения: первая строка программой не читается
Edit ID| 1 pro/0.par
Справка| 4 help.txt
Заметки| 1 pro/note.txt
О программе| 2 pro/hdata/about.htm
Папка pro| 5 pro

Тонкости.

• Если файла или папки нет, программа сообщит об этом и закончит работу — так же удобно сделать кнопку «Выход» на несуществующий файл (в заготовке это последняя, 176-я кнопка Exit).
• Действия 2 и 5 в Линуксе не работают.
• Для действия 3 годятся только программы, которые не портят переменные проигрывателя.

№29. PLAYER — свой код на VKACL

Что делает. Проигрыватель программ на VKACL, написанный на самом VKACL. Позволяет быстро написать и выполнить небольшую программу — расчёт, график, обработку файла — не выходя из режима проигрывателя. Для серьёзной работы автор советует среду разработки (_rund.bat).

Что нужно заранее. Файл с расширением .pro с кодом. Проигрыватель сам файлы не создаёт — сделайте файл средствами системы, лучше в папке pro/0/. Образец — pro/0/figure.pro из vkacld.zip (рисует функции Бесселя).

Входные данные. Нет — роль инструкции играет сам файл входных данных.

Как работать.

1. Появится окно с кнопками Help, Start, Exit. Help открывает инструкцию — прочитайте её.
2. Start открывает выбор файла .pro в папке pro/0/.
3. Код появляется в редакторе. Поправьте его и выйдите по Esc: файл сохранится и выполнится. Если закрыть редактор крестиком, ничего не сохранится и не выполнится.
4. При ошибке в коде появится сообщение, и код откроется снова для правки.
5. После выполнения выберите: Current — снова этот файл, New — другой, Nothing — выход.

Пример — файл pro/0/test.pro из двух строк:

# a=2^10; b=sqr(2); c=4*art(1);
#m [op=win;] 2^10 = \G a;\n корень из 2 = \G b;\n пи = \G c;\E

Тонкости. В коде нельзя использовать команды #stop и #exit, переменные на букву U и последние элементы текстового массива t() (с индексами больше KY−10000): их занимает сам проигрыватель. Как писать на VKACL — начиная с главы Начало работы.

№56. CHAIN 1 — несколько программ подряд

Что делает. Сама ничего не делает — запускает другие готовые программы одну за другой, каждую со своими заранее подготовленными входными данными.

Что нужно заранее. Входные данные запускаемых программ должны быть уже записаны без ошибок — исправить их по ходу не получится. Проще всего один раз запустить каждую программу из меню Index и довести её данные до ума (или отредактировать нужную строку idc00.txt программой №26).

Входные данные — одна строка из пар чисел:

Пример — запустить №31 и №54, каждую с первой строкой её данных:

31 1 54 1 

Тонкости.

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

№57. CHAIN 2 — цепочка с данными в протоколе

Что делает. Тоже запускает программы по цепочке, но входные данные каждой пишутся прямо здесь, в протоколе, — заранее ничего готовить не надо.

Входные данные — первые строки файла (позиция курсора не важна, выполняется верхний протокол):

• Каждая строка: в первых двух позициях — номер программы (20, 03 или 3), затем пробел, а с четвёртой позиции — ровно та строка входных данных, которую эта программа взяла бы из своего файла.
• Строка короче шести символов заканчивает протокол; обычно пишут @.
• Номер 00 — особый: остаток строки выполняется как код VKACL. Так можно, например, включить таймер перед программой и узнать время её работы после.

Пример (автора) — нарисовать график №20 и карту №21:

20  1 77 1 77 0 76 1 3 0  рис._1 pro/0/in999.dat  E
21  21 21 -5 5 -4 4 9 9  2 1 1 Матрица_чисел  pro/0/matrix.txt E
@

Тонкости.

• Подходят только программы, которые берут данные из одной строки, выбранной курсором. Программы с многострочными данными (№8, 10, 11 и т. п.) в цепочке работать не будут.
• Диалоги программ по ходу цепочки появляются как обычно. Чтобы графики не всплывали, у №20 задайте отрицательный масштаб, у №21 — вторую цифру td равной 1.
• Программе без входных данных нужна строка не короче шести символов: номер и любые символы после пробела.

№76. SYSTEM — команды операционной системы

Что делает. Заменяет командные файлы: выполняет команды операционной системы, записанные по одной на строку в jsc1.txt (Windows) или jsc2.txt (Линукс) в главной папке. Систему программа определяет сама.

Что нужно заранее. Свои команды в jsc1.txt. Сейчас там команды автора (пути к его программам) — замените их. Команда — имя программы с аргументами; папки в путях Windows разделяйте знаком /; лишних пробелов не ставьте. Например:

notepad.exe C:/vkacl/pro/note.txt
explorer.exe C:/vkacl/pro

Входные данные — одна строка: номера строк файла команд через пробел.

Пример.

1 2 

Тонкости.

• Не ставьте в конце лишнюю букву E: все поля программа читает как номера.
• Не все программы запускаются так же, как из системы, — проверяйте на своём компьютере; иногда запуск блокирует защита системы. Лучше всего так открываются браузер с нужным файлом и обычные программы. Команда java -jar … срабатывает, только пока фокус не ушёл в другие окна.

№78. CHAIN 3 — цепочка для каждого файла папки

Что делает. Как №57, но в пакетном режиме: выполняет протокол по очереди для каждого файла указанной папки. Годится для программ, которые обрабатывают один файл.

Входные данные — первые строки файла:

В данных вместо имени файла пишут \T$1 $2\u32; — это полный путь к очередному файлу и пробел после него. Номер файла (1, 2, …) доступен как \I1 $0; и годится для составления новых имён: например, 2\I1 $0;f превратится в 21f, 22f, …

Пример (автора) — дважды убрать выбросы и транспонировать каждую матрицу 2304×2304 из pro/5/ программой №77:

pro/5/ E
77 3 *  \T$1 $2\u32;  \T$1 $2\u32;   2304  2304  25  0 E
77 1 *  \T$1 $2\u32;  \T$1 $2\u32;   2304  2304  E
77 3 *  \T$1 $2\u32;  \T$1 $2\u32;   2304  2304  25  0 E
77 1 *  \T$1 $2\u32;  \T$1 $2\u32;   2304  2304  E
@

Тонкости. В этом примере результат каждой операции записывается поверх исходного файла — работайте с копиями. Демонстрационных данных у программы нет.

Разное

Справочники и калькулятор. Общие правила записи входных данных — в разделе Как записывать входные данные.

№30. UNICODES — символы шрифтов

Что делает. Показывает таблицами все символы выбранного шрифта с их номерами в Юникоде. Нужна, чтобы узнать, какие символы (буквы, греческие, математические знаки) можно использовать в надписях программ, например №08.

Входные данные. Нет — программа сразу показывает список шрифтов.

Как работать.

1. Выберите шрифт из списка (Arial, Times New Roman, Verdana и др.) или нажмите New и введите имя своего шрифта. Exit — выход.
2. На странице — 340 символов: 17 строк по 20. Слева — номер первого символа строки, сверху — номера столбцов 0–19; номер символа = номер строки + номер столбца.
3. Любая клавиша или клик — следующая страница; PgUp или ↑ — предыдущая; Esc — назад к списку шрифтов.

Тонкости. Если шрифта на компьютере нет, Java подставит свой шрифт по умолчанию — таблица будет, но не того шрифта.

№31. PTOE — таблица Менделеева

Что делает. Интерактивная таблица Менделеева и одновременно записная книжка: клик по элементу открывает текст о нём, который можно дополнять и исправлять — программа всё запомнит. В текстах есть ссылки на ресурсы интернета, в том числе на статьи из книги автора.

Входные данные. Нет. Поставьте курсор в начало первой строки и нажмите Esc.

Как работать.

1. Кликните по клетке элемента — его текст откроется в большом редакторе.
2. Правьте и выходите по Esc: изменения сохранятся в pro/b/ptoe.dbn.
3. Чтобы открыть ссылку из текста, поставьте на неё курсор и нажмите F4.
4. Чтобы закончить, кликните по картинке вне клеток элементов — например, по портрету Менделеева.

Тонкости. Первая ссылка ведёт на статью автора и точно работает; другие со временем могут исчезнуть — заменяйте их новыми.

№62. CALCUL — калькулятор

Подробный разбор с примерами — Разбор: №62 CALCUL.

Что делает. Вычисляет выражения и показывает в окне значения восьми переменных a b c d e f g h. В одной строке можно записать целую цепочку вычислений — использовать уже посчитанные переменные в следующих формулах.

Входные данные — одна строка присваиваний вида переменная=выражение;:

Результат. Окно со значениями a…h в формате вида 1.9635+01 (то есть 1,9635·10¹).

Пример (автора):

x=-4.4e1; h=abs(x); a=sqr(h); b=log(h); c=exp(x); d=sin(x); e=ars(d); f=cos(x); g=arc(d); 

Тонкости. Строк можно держать сколько угодно, выполняется та, в начале которой курсор. Лишнюю букву E в конце не ставьте — она будет понята как часть выражения. Подробности и ловушки — в разборе.

Разбор: №08 SLIDE MAKER

Программа №08 собирает картинку-слайд: на основу заданного размера кладёт другие картинки и пишет поверх них текст. Так делают титульный слайд доклада, объявление, заставку к видео, кнопку для сайта. Краткое описание — в каталоге: №08 SLIDE MAKER.

В этом разборе мы сначала запустим пример автора, а потом соберём свой титульный слайд 1280×720 из трёх картинок и двух надписей.

Что понадобится

• Установленная программа и архив vkacld.zip, разложенный по папкам (см. Установка).
• Три файла из pro/0/, которые нужно скопировать в pro/1/ — рабочую папку программы №08:

Шаг 1. Открываем программу

1. Запустите _runp.bat.
2. Нажмите Index, затем кнопку 8.
3. Откроется редактор. Наверху — пример входных данных, ниже — варианты автора и его инструкция.

Программа №08 читает первые строки файла и выполняет только верхний вариант. Позиция курсора ей не важна.

Шаг 2. Пример автора

Наверху файла стоит (или впишите сами) такой вариант:

512 512 1 3|slide
 256 256 0 0 0 9 9|000000.png
 256 100 5 1 30  0 255 0 |Arial|на полотно любого размера
 256 200 5 1 30 255 0 0  |Arial|можно ставить картинки
 256 300 5 1 30 255 255 255 |Arial|и тексты любых фасонов

Разберём его построчно.

Строка 1 — 512 512 1 3|slide:

Строка 2 — картинка: 256 256 0 0 0 9 9|000000.png:

Чёрный прямоугольник 256×192, увеличенный в 9 раз, становится 2304×1728 и закрывает всю основу — получается чёрный фон.

Строки 3–5 — надписи, например 256 100 5 1 30 0 255 0 |Arial|на полотно любого размера:

Нажмите Esc. Слайд появится в окне в левом верхнем углу экрана: на чёрном фоне три строки — зелёная, красная и белая, одна под другой. В папке pro/1/ появятся slide.png и slide.jpg.

Затем программа спросит Do you like to change parameters? Ответ Yes снова откроет входные данные — так удобно подгонять слайд понемногу. No закончит работу.

Шаг 3. Как устроены координаты

• Начало отсчёта — левый верхний угол основы; x растёт вправо, y — вниз.
• Для картинки X, Y — положение её центра. Картинка поворачивается и масштабируется вокруг центра.
• Картинки кладутся в том порядке, в каком записаны: следующая закрывает предыдущую. Надписи всегда поверх картинок.

Для надписи X, Y — точка привязки, а число M (от 1 до 9) говорит, какой частью текст к ней прикладывается:

Например, M = 1 — левый нижний угол текста в точке X, Y; M = 5 — центр текста в точке; M = 9 — правый верхний угол в точке.

Шаг 4. Свой слайд

Сделаем титульный слайд 1280×720: фотография во весь слайд, тёмные полосы сверху и снизу для текста, повёрнутый портрет слева, заголовок и подпись. Вставьте в самое начало файла, над примером автора, семь строк:

1280 720 4 2|title
 640 360 0 0 0 1 1|m91.jpg
 640 70 0 0 0 5 0.7|000000.png
 640 650 0 0 0 5 0.7|000000.png
 200 360 5 0 0 1.2 1.2|jad.jpg
 640 70 5 1 64 255 255 255 |Arial|Готовые программы VKACL
 640 650 5 2 40 255 220 0 |Arial|слайд собран программой №08

Что здесь происходит:

Нажмите Esc и посмотрите на результат. Если наклон портрета получился не в ту сторону, поменяйте знак угла (-5). Ответьте Yes, поправьте числа, снова Esc — и так, пока слайд не понравится.

Шаг 5. Результат

В папке pro/1/ лежат title.png и title.jpg размером 1280×720. Входные данные сохранились — в следующий раз программа откроет их в том же виде.

Что дальше:

• соберите несколько слайдов в PDF — программа №09;
• покажите их как презентацию — программа №27;
• узнайте, какие символы есть в шрифте, — программа №30.

Если что-то не так

Разбор: №21 2D MAP

Программа №21 рисует матрицу чисел как карту: каждая точка — цветной или серый прямоугольник, по краям — оси с подписями, сбоку — шкала цветов. Так смотрят результаты расчётов, распределения интенсивности, рельеф — любую функцию двух переменных, заданную таблицей. Краткое описание — в каталоге: №21 2D MAP.

В разборе мы нарисуем карту по текстовой таблице, попробуем разные виды графика, затем переведём таблицу в двоичный файл программой №16 TXT to DAT и нарисуем карту уже по нему.

Что понадобится

Установленная программа и архив vkacld.zip, разложенный по папкам (см. Установка). Нужен файл pro/0/matrix.txt из этого архива.

Шаг 1. Смотрим на данные

pro/0/matrix.txt — 21 строка по 21 целому числу от 0 до 99, всего 441 число. Это «холм»: по краям нули, к центру значения растут до 99. Первые строки файла:

  0  0  0  0  0  0  0  0  0  0  0  0  0  0  0  0  0  0  0  0  0
  0  0  0  0  0  0 17 31 38 42 43 42 38 31 17  0  0  0  0  0  0
  0  0  0  0  0 32 44 51 56 58 59 58 56 51 44 32  0  0  0  0  0

Как программа №21 читает такие данные:

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

Шаг 2. Первая карта

1. Запустите _runp.bat, нажмите Index, затем 21.

2. В редакторе первая строка — как раз наш случай:

   21 21 -5 5 -4 4 9 9  2 1 1  Матрица_чисел  pro/0/matrix.txt 

3. Курсор уже стоит в начале первой строки (подойдёт и вторая позиция). Нажмите Esc.

Разберём строку поле за полем:

Результат. На экране — цветная карта холма с осями и шкалой цветов. Над ней подпись и пара чисел — настоящие минимум и максимум матрицы (0 и 99); шкала цветов показывает значения, нормированные на интервал 0–1. Картинка записана в pro/0/matrix.png — рядом с файлом данных, с тем же именем.

Программа спросит Job is done! Continue? Ответьте Yes, чтобы вернуться к входным данным и попробовать варианты.

Шаг 3. Варианты

Не правьте удачную строку — скопируйте её ниже и меняйте копию; нужный вариант выбирается курсором. Попробуйте по одной правке:

Все варианты пишут в один и тот же файл pro/0/matrix.png — каждый следующий заменяет предыдущий.

Как читать td: это число до трёх цифр. Последняя цифра — формат данных (1 текст, 2 двоичный файл). Средняя — 1, если график не показывать. Первая — 1, если обратить палитру. Нули впереди не пишут: 1, 11, 101, 111, 2, 12…

Шаг 4. Переводим таблицу в двоичный файл (№16)

Текст удобен человеку, но большие матрицы программы VKACL хранят в двоичных файлах .dat: по 4 байта на число, без заголовка (см. Числовые файлы .dat). Перевести таблицу умеет программа №16.

1. В проигрывателе: Index → 16.

2. Выберите или впишите строку:

   441 1 0 pro/0/matrix E

   Это значит: прочитать 441 число, как вектор (1 во втором поле), ничего не пропуская в начале файла (0), из pro/0/matrix.txt — расширение .txt не пишется. Буква E в конце не читается, она лишь показывает, что после пути есть пробел.

   То же самое можно записать как матрицу — 21 число в строке, 21 строка: 21 21 0 pro/0/matrix E. В режиме матрицы каждая строка матрицы должна стоять на отдельной строке файла.

3. Нажмите Esc. Появится файл pro/0/matrix.dat.

Проверка: размер файла должен быть 441 × 4 = 1764 байта.

Заметьте: программа №16 заменяет табуляции на пробелы прямо в исходном текстовом файле.

Шаг 5. Карта по двоичному файлу

Вернитесь к программе №21 и добавьте строку, где последняя цифра td — 2, а файл — .dat:

21 21 -5 5 -4 4 9 9 2 1 2 Из_двоичного_файла pro/0/matrix.dat 

Получится та же карта с новой подписью. Картинка снова запишется в pro/0/matrix.png: имя берётся из имени файла данных без расширения. Если хотите сохранить обе картинки, скопируйте matrix.dat под другим именем (например, matrix2.dat) и рисуйте по копии.

Шаг 6. Свои данные

1. Подготовьте текстовый файл: nx чисел в строке, ny строк; первой записывайте нижнюю строку карты. Таблица из Excel, сохранённая как «текст с разделителями табуляции», подойдёт, но в Excel верхняя строка идёт первой — карта выйдет перевёрнутой по вертикали. Тогда просто переставьте строки в обратном порядке.
2. Положите файл в папку внутри папки программы, например pro/1/data.txt.
3. Впишите в №21 строку со своими nx, ny, пределами осей и путём.
4. Если данных много, сначала переведите их в .dat программой №16 — чтение двоичного файла быстрее.

Если что-то не так

Разбор: №62 CALCUL

Программа №62 — калькулятор выражений. В строке пишут цепочку присваиваний вроде r=2.5; a=r*r;, а программа показывает в окне значения восьми переменных a, b, c, d, e, f, g, h. Строк можно накопить сколько угодно — получается записная книжка формул, которая сохраняется между запусками. Краткое описание — в каталоге: №62 CALCUL.

На самом деле строка калькулятора — это команда присваивания языка VKACL. Поэтому всё, что здесь сказано о выражениях, верно и для программ на VKACL.

Шаг 1. Открываем калькулятор

1. Запустите _runp.bat, нажмите Index, затем 62.

2. В редакторе — три строки-примера автора и под ними инструкция:

   X=121; M=0.15/(366-X); a=0.85+(323-X)*M; b=0.85+(97-X)*M;
   x=-4.4e1; h=abs(x); a=sqr(h); b=log(h); c=exp(x); d=sin(x); e=ars(d); f=cos(x); g=arc(d);
   x=4.4e1; a=int(x); b=sgn(x); c=sfi(x); d=cfi(x); e=bj0(x); f=bj1(x); g=x^2; h=2*(x+4)/5;

Шаг 2. Первый расчёт

Поставьте курсор в самое начало второй строки и нажмите Esc. Программа выполнит строку:

В окне значения показаны так (точное число пробелов может отличаться):

a=  6.6332+00,  b=  3.7842+00,  c=  7.7811-20,  d= -1.7702-02
e= -1.7703-02,  f=  9.9984-01,  g=  1.5885+00,  h=  4.4000+01

Это экспоненциальная запись без буквы E: четыре знака после точки, затем знак и двузначный порядок. 6.6332+00 — это 6,6332·10⁰ = 6,6332; -1.7702-02 — это −1,7702·10⁻² = −0,017702; 4.4000+01 — это 44.

Закройте окно. Программа спросит Job is done! Continue? — ответ Yes вернёт в редактор, No закончит работу.

Шаг 3. Свой расчёт

Допишите в начало файла новую строку — площадь и длину окружности радиуса 2,5, гипотенузу треугольника 3–4–5 и ещё несколько величин:

r=2.5; p=4*art(1); a=p*r^2; b=2*p*r; c=sqr(3^2+4^2); d=art(1)*180/p; e=exp(1); f=log(10); g=10<3; h=10>3;

Поставьте курсор в начало этой строки и нажмите Esc. Вспомогательные переменные r и p в окне не видны — показываются только a–h. Поэтому всё, что хотите увидеть, присваивайте им.

Правила записи

Присваивание: имя=выражение;. Точка с запятой нужна после каждого присваивания, включая последнее. Пробелы вокруг = и между элементами допустимы.

Числа: 42, 3.14, 3,14 (запятая тоже годится), 1.5e3, 2.5E-4.

Операции — от более сильной к более слабой:

Скобки ( ) — как обычно.

Функции — имя из трёх букв и аргумент в скобках:

Имена переменных: одна буква (x, R; большие и маленькие буквы — разные переменные), буква с цифрой (a1), две буквы (dx). Надёжнее всего брать маленькие буквы. Не используйте имена, которые занимает сам проигрыватель: начинающиеся с U, двухбуквенные с последней буквой X, Y или Z (в том числе AY … KY).

Комментарий. После восклицательного знака ! строку можно продолжить любым текстом — он не выполняется. Только знака # в таком тексте быть не должно.

r=2.5; a=4*art(1)*r^2; ! площадь круга радиуса 2,5

Ловушки

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

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

Что дальше

• Полное описание выражений языка — в справочнике: Выражения и функции.
• Если нужны циклы, графики, таблицы — это уже маленькая программа на VKACL: её можно написать и выполнить программой №29 или в среде разработки (см. Начало работы).

Что такое VKACL

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

Идея первая: программа — это поток команд в тексте

В большинстве языков файл состоит из инструкций, а комментарии помечаются особым знаком. В VKACL наоборот: файл состоит из текста, а команды помечаются знаком #.

Это обычный текст. Его можно писать свободно:
пояснения, заметки, черновики формул.

#pr Привет!\E

И снова текст, который никто не исполняет.

Интерпретатор ищет ближайший #, выполняет то, что за ним, снова ищет # — и так до конца файла. Всё между командами он просто пропускает.

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

Здесь мы используем команду #d для заполнения массива.

не комментарий: интерпретатор найдёт #d и попытается его выполнить.

Идея вторая: вся память общая

В VKACL нет объявлений переменных, нет областей видимости, нет локальных переменных у процедур. Есть фиксированный набор ячеек, существующий всегда:

• 55 однобуквенных переменных: a…z, A…Z, $, %, &;
• двухсимвольные: a0…z9 и aa…ZZ;
• три больших массива — целый i(), вещественный r(), текстовый t();
• служебный массив s(), через который команды получают параметры и отдают результаты.

Процедура — это просто именованный кусок кода; данные она получает и возвращает через те же общие ячейки.

У такого устройства есть причина. Автор начинал на Фортране, где массив объявлялся в каждой процедуре с фиксированным размером, «на всякий случай» по максимуму. Он с самого начала сделал иначе, как в ассемблере: одна большая область памяти, а «массив» — это просто номер первого элемента и длина. Тогда массивы укладываются плотно, а вектор можно на ходу считать матрицей, матрицу одной формы — матрицей другой формы, и наоборот, ничего не копируя. Индексы считать несложно, и этому быстро учишься.

Идея третья: команда — это имя, параметры и аргументы

Любая команда выглядит одинаково:

#имя [параметр=значение; параметр=значение;] аргументы

Поле в квадратных скобках необязательно. Важная особенность: параметры запоминаются. Если вы один раз написали [mo=1;], этот mo останется равным единице для всех последующих команд, пока его не переопределят. Это удобно и это же — источник самых неприятных ошибок.

Чего в языке нет

Стоит сказать прямо, чтобы не искать:

• нет операторов сравнения — < и > заняты под минимум и максимум; условия строят через арифметику и функцию sgn;
• нет типов — все скалярные переменные вещественные, преобразование происходит при записи в целый массив;
• нет функций с аргументами — только процедуры без параметров;
• нет рекурсии — вызов процедуры из себя же считается ошибкой;
• нет строк как значений — текст живёт в массиве t(), и работа с ним ведётся по индексам и длинам.

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

Идея четвёртая: язык — диспетчер, а не вычислитель

VKACL задуман в первую очередь как язык управления: графика, окна ввода и выбора, работа с файлами и PDF, запуск готовых программ и подпрограмм на Java. Для этого он очень удобен.

Для больших расчётов — тройных циклов по тысяче повторов — интерпретируемый язык не годится, и VKACL здесь не исключение. Способ, которым такие задачи решаются в Matlab и в numpy, есть и здесь: операции над массивом целиком. Их выполняет команда #ma — сложить, умножить, транспонировать, отсортировать, взять преобразование Фурье, построить сплайн — одной командой, без цикла. А то, что и так не получается, автор пишет на Java и вызывает из VKACL как процедуру.

Две реализации

Для реальной работы нужен интерпретатор автора. Реализация из этого проекта существует, чтобы примеры туториала запускались прямо на странице и чтобы поведение языка было проверено тестами.

Дальше — первая программа.

Первая программа

Начнём с программы, которая что-то печатает. В VKACL это делается в два приёма, и это первое, что нужно понять про язык.

Вывод в две ступени

#pr Привет, мир!\n\E
#m [op=txt;] \Tp\E

Разберём построчно.

#pr Привет, мир!\n\E — команда формирует текст и кладёт его в текстовый массив t(). Она ничего не показывает на экране. \n — перевод строки, \E — обязательный признак конца текста.

#m [op=txt;] \Tp\E — команда показывает текст в окне терминала. \Tp означает «взять последний фрагмент, записанный #pr».

Конца программы специально отмечать не нужно: интерпретатор просто доходит до конца текста.

Имя команды можно писать длиннее: значимы только первые три буквы, так что #pr, #pri и #print — одна и та же команда. В программах автора чаще всего встречается короткая форма #pr. А вот #p — это другая команда: она только задаёт параметры.

Такое разделение выглядит громоздким, но у него есть смысл: текст в t() можно накопить, потом отредактировать, записать в файл, показать на экране или отправить в PDF — источник один.

Почему \E и почему \n

Аргумент #pr — это форматированный текст (в документации автора — FT). Он не заканчивается на конце строки: интерпретатор читает его, пока не встретит \E. Поэтому текст можно свободно разносить по строкам.

Внутри работают escape-коды: \n — перевод строки, \t — табуляция, \# — сам знак #, \\ — обратная косая черта.

Ловушка с пробелами

Перед каждым фрагментом текста интерпретатор пропускает пробелы и переводы строк. Это значит, что так пробел не получить:

#pr A B\E

даст A B (внутренние пробелы сохраняются), а вот так:

#pr A \E

даст A — хвостовой пробел исчезнет, потому что после A идёт \, и пробел перед ним съеден. Явный пробел записывают кодом символа:

#pr A\u32;\E

\u32; — символ с кодом 32, то есть пробел. Точка с запятой обязательна.

Считаем и печатаем

# a=2; b=3;
# c=a*b+1;
#pr a*b+1 = \G c;\n\E
#m [op=txt;] \Tp\E

Здесь два новых элемента.

# a=2; b=3; — команда вычислений. Она начинается с #, за которым сразу идёт пробел — это краткая форма команды #c. Каждое присваивание заканчивается точкой с запятой.

\G c; — вставить значение переменной c в формате «мантисса и порядок». Результат будет выглядеть так:

a*b+1 =   7.0000+00

Формат \G — фиксированной ширины 11 символов, четыре знака после точки, двузначный порядок без буквы E. Для целых чисел удобнее \I:

#pr a*b+1 = \I4 c;\n\E

даст a*b+1 = 7 — число выровнено по ширине 4.

Где кончается команда

Программа выполняется сверху вниз. У большинства команд аргументы имеют понятный конец: у #pr это \E, у #rep — одно число. Но у некоторых команд аргументов может быть сколько угодно: у вычислений #c — любое число присваиваний, у #d и #v — любое число значений, у #e — имя процедуры. Такая команда читает аргументы, пока не встретит один из трёх знаков:

Поэтому после таких команд перед поясняющим текстом ставят !:

# a=2; b=3; !
Здесь пояснение: без восклицательного знака слово «Здесь»
было бы принято за начало ещё одного присваивания.
#pr \G a b;\E

То же нужно, если такая команда стоит последней в программе: без ! интерпретатор продолжит читать аргументы за концом текста и остановится с ошибкой. Для #e в файле, который вызывается из другой программы, это проявляется сообщением, что такой процедуры нет.

Отсюда привычка, которую легко перенять у автора: заканчивать вычисления знаком !, если дальше не идёт сразу другая команда:

# a=2; b=3; c=a*b; !

Что попробовать

Откройте песочницу и запустите:

# n=5; f=1; i=1;
#rep 5
  # f=f*i; i=i+1;
#end
#pr 5! = \I6 f;\n\E
#m [op=txt;] \Tp\E

Это факториал пятёрки. #rep 5 … #end — цикл на пять повторений; про него подробно в главе Ветвления и циклы.

Дальше — вычисления и переменные.

Вычисления и переменные

Команда вычислений — самая частая в любой программе на VKACL. У неё две записи, полностью равнозначные:

#c a=1; b=2;
# a=1; b=2; !

Вторая — просто # и пробел. В реальном коде почти всегда пишут её.

Переменные

Отдельно объявлять ничего не нужно, все ячейки существуют с самого начала и равны нулю.

# a=1; z=2; A=3; Z=4; $=5; %=6; &=7;
# a1=10; b2=20; zz=30; AB=40; !

Доступны:

• однобуквенные — a…z, A…Z, $, %, & (регистр важен: a и A разные);
• буква+цифра — a0…z9, A0…Z9;
• буква+буква — aa, ab, …, ZZ.

Все они хранят вещественные числа.

Три имени имеют особый смысл по традиции: & — условие для #case (см. Ветвления), $ и % часто используют как временные.

Операции

# a=2+3; b=7-2; c=2*3; d=7/2; e=2^10; !

Да, < и > — не сравнения. a<b — это меньшее из двух чисел.

Приоритеты: главная неожиданность

Порядок связывания в VKACL такой (сверху — сильнее):

1. < > — минимум и максимум
2. ^ — степень
3. * /
4. + -

Минимум и максимум связывают сильнее всего. Поэтому:

# m=1<5+10; !

это min(1,5) + 10 = 11, а вовсе не min(1, 15). И

# n=2*3<4; !

это 2 * min(3,4) = 6.

Степень вычисляется слева направо: 2^3^2 равно (2^3)^2 = 64, а не 2^9.

Когда сомневаетесь — ставьте скобки. Они работают обычным образом.

Функции

Имя функции — ровно три буквы, сразу за ним открывающая скобка:

# a=sqr(16); b=log(10); c=exp(1);
# d=sin(1); e=cos(1); f=tan(1);
# g=ars(0.5); h=arc(0.5); k=art(1);
# m=abs(0-7); n=int(3.7); p=sgn(0-2); q=rnd(0); !

Наличие Френеля и Бесселя прямо в языке многое говорит о задачах, ради которых он создавался: Виктор Кон занимается рентгеновской оптикой.

Унарный минус

Минус в начале выражения работает:

# a=-5; b=-sgn(x); !

А вот сразу после другой операции — нет. Запись 2*-3 даёт ошибку. Пишите так:

# a=2*(0-3); !

Идиома 0-x вместо -x в середине выражения встречается в авторском коде повсеместно.

Числа

# a=42; b=3.14; c=3,14; d=1.5e3; e=2.5e-4; !

Разделителем дробной части может быть и точка, и запятая. Экспонента пишется через e или E.

Как построить условие

Раз сравнений нет, условия строят арифметикой. Самый частый приём — sgn:

Единица, если q меньше трёх, иначе ноль или минус единица
# &=-sgn(q-3); !

sgn(q-3) равен −1 при q<3, нулю при q=3 и +1 при q>3; минус переводит это в 1 / 0 / −1. Полученное значение затем разбирает #case.

Другой приём — «зажать» значение через минимум и максимум:

Ограничить x диапазоном от 0 до 100
# x=0>x<100; !

Читается справа налево по приоритетам: сначала x<100 (не больше 100), потом 0>… (не меньше 0).

Дальше — массивы и память.

Массивы и память

Кроме скалярных переменных в VKACL есть четыре массива. Они существуют всегда, общие для всей программы, и индексируются с единицы.

Обращение к элементу — обычное:

# i(1)=10; i(2)=20;
# r(100)=3.14;
# a=i(1)+i(2); !

Индексы считаются упрощённо

Внутри скобок работает урезанный вычислитель. Допустимы только числа, скалярные переменные и операции + - * / ^:

# k=5;
# a=i(k); !      это работает
# b=i(k+1); !    и это
# c=i(k*2-1); !  и это

А вот так — нельзя:

# d=i(int(k/2)); ! ошибка: функции в индексах не работают
# e=i(j(1)); !     ошибка: вложенные массивы тоже

Обходной путь один — посчитать индекс заранее в переменную:

# k=7; m=int(k/2); d=i(m); !

Заполнение массива: #d

Перечислять элементы по одному утомительно, поэтому есть команда #d:

#d 6 i(1) 7 0 0 0 9 11 !

Читается так: «шесть значений, начиная с i(1), вот они». Повторы записываются короче — через звёздочку:

#d 6 i(1) 7 0*3 9 11 !

0*3 означает «ноль три раза». Результат тот же.

За один раз можно задать не больше 500 значений. Команда продолжает читать группы количество приёмник значения…, пока не встретит следующую команду:

#d 3 i(1) 1 2 3  3 r(1) 1.5 2.5 3.5 !

Копирование: #pas

#pas 4 r(1) i(10)

«Переслать четыре элемента из r(1)…r(4) в i(10)…i(13)». Типы приводятся автоматически: вещественные округляются при записи в целый массив.

Команда корректно работает при наложении областей — если приёмник правее источника, копирование идёт с конца.

Текстовый массив t()

t() хранит символы. Записать в него можно двумя способами: числовым кодом

# t(200)=65; t(201)=66; t(202)=67; !

или, что гораздо чаще, командой #pr, которая пишет туда форматированный текст.

Прочитать фрагмент обратно в текст — escape-код \T:

#pr \T200 3\E

«Взять три символа начиная с t(200)» — получится ABC.

У \T два аргумента: начало и длина. Оба — простые числа или переменные, выражения там не работают:

# n=3;
#pr \T200 n\E      так можно
#pr \T200 n-1\E    так нельзя: напечатается ABC-1

Служебный массив s()

s() — это одновременно и параметры команд, и их результаты. Когда вы пишете

#f [op=size; file=data.txt;]

значение параметра n попадает в s(7), mo — в s(11) и так далее, а размер файла команда вернёт в s(1).

Ячейки, которые нужны чаще всего:

s(3) — самая важная. Именно её сбрасывают в единицу, чтобы начать формировать текст заново:

# s(3)=1;
#pr первая строка\n\E
#pr вторая строка\n\E

Без сброса каждый новый #pr дописывает текст к предыдущему — иногда это именно то, что нужно.

Как вывести весь накопленный текст

Типичная концовка программы:

# n9=s(3)-1;
#m [op=txt;] \T1 n9\E

Длину пришлось положить в переменную, потому что \T не понимает выражений. И точки с запятой после аргументов нет: \T читает ровно два значения и на этом останавливается — всё, что написано дальше, попадёт в вывод как текст.

Это настолько частая идиома, что её стоит запомнить целиком.

Дальше — текст и вывод.

Текст и вывод

Форматированный текст (в документации автора — FT) — это язык внутри языка. Его понимают #pr, #m и текстовые параметры команд.

Правило одно: текст читается до \E. Всё остальное — детали.

Скелет

# s(3)=1;
#pr Результат: \G x;\n\E
#m [op=txt;] \Tp\E

• #pr пишет в массив t() начиная с s(3);
• \Tp в #m означает «последний фрагмент, записанный #pr»;
• #m [op=txt;] показывает текст в терминале.

Пробелы съедаются

Перед каждым куском текста интерпретатор пропускает пробелы, табуляции и переводы строк. Это позволяет свободно форматировать исходник:

#pr Первая строка\n
     Вторая строка\n
     Третья строка\n\E

Отступы в исходнике на результат не влияют. Но и нужный пробел так не поставить — для него есть \u32;:

#pr Итого:\u32;\G x;\n\E

Другой способ — перенести строку исходника кодом \-, который не даёт ничего:

#pr Очень длинная строка, которую хочется \-
     разбить в исходнике\n\E

Escape-коды: символы

Коды \# и \@ нужны потому, что # и @ иначе оборвали бы команду.

Escape-коды: числа

Здесь начинается специфика. Каждый код читает список значений до ;:

#pr \G a b c;\n\E

выведет подряд три числа.

\G — рабочая лошадка для вещественных чисел, \I — для целых.

Обратите внимание на порядок: у \B и \N сначала идёт ширина поля и число знаков, потом сам список значений.

#pr \B 14 6 x;\n\E

Вставка из массива

Аргументы \T — только числа или переменные, не выражения.

Комментарий внутри текста

Прямо в форматированном тексте можно оставить заметку — она не попадёт в результат:

#pr Итого:\u32;![ тут будет сумма ]!\G s;\n\E

Открывается ![, закрывается ]!. Распознаётся такой комментарий только в самом начале текста или сразу после escape-кода — там, где интерпретатор пропускает пробелы. В середине обычного текста ![ … ]! будет напечатан как есть; поэтому в примере перед ним стоит \u32;.

Накопление текста

Поскольку #pr дописывает в t(), отчёт удобно собирать по частям:

# s(3)=1;
#pr Отчёт\n\E
#pr ------\n\E
# i=1;
#rep 5
  #pr строка \I2 i;\n\E
  # i=i+1;
#end
# n9=s(3)-1;
#m [op=txt;] \T1 n9\E

Каждый #pr внутри цикла дописывает строку, а в конце всё показывается разом.

Куда ещё уходит текст

Собранный в t() текст — универсальный источник:

• #m [op=txt;] — на экран;
• #io [op=wt;] — в файл (см. Файлы);
• в оригинальном интерпретаторе — в PDF, в картинку, в заголовок графика.

Именно поэтому вывод сделан двухступенчатым.

Дальше — ветвления и циклы.

Ветвления и циклы

В VKACL всего две управляющие конструкции — #rep и #case — и обе закрываются одним и тем же #end. Из них собирается всё остальное.

Цикл с известным числом повторений

# s=0; i=1;
#rep 10
  # s=s+i; i=i+1;
#end

#rep N повторяет тело N раз. N — число или переменная, но не выражение: считать его нужно заранее:

# n=5; m=n*2; !
#rep m
  ...
#end

Циклы вкладываются, глубина — до 45 уровней:

# c=0;
#rep 3
  #rep 4
    # c=c+1;
  #end
#end

После этого c равно 12.

Если N окажется нулём или отрицательным — это ошибка, а не пустой цикл. Проверяйте счётчик заранее.

Ветвление

Условие в VKACL — это значение переменной &, а #case сравнивает его со своей меткой:

# &=2;
#case 1  # z=10;  #end |
#case 2  # z=20;  #end |
#case 3  # z=40;  #end |

Выполнится только вторая ветка: & равно 2. Остальные пропускаются целиком, вместе со всем, что внутри.

Вертикальная черта после #end — не украшение. Она означает «сбросить условие»: после #end | переменная & получает служебное значение 12345, которое не совпадает ни с одной меткой. Без неё произойдёт кое-что интересное.

#case как цикл «пока»

Если после #end не написать |, то по достижении #end интерпретатор снова сравнит & с меткой ветки, и при совпадении вернётся к её началу. Это и есть цикл с условием:

# &=1; q=0;
#case 1
  # q=q+1;
  # &=-sgn(q-4);
#end
#pr q = \I3 q;\n\E

Пока q меньше 4, выражение -sgn(q-4) даёт 1, & остаётся равным метке, и блок повторяется. Когда q достигнет 4, sgn(0) даст 0, & станет нулём, и цикл закончится.

То же можно записать через #end (x) — эта форма задаёт новое значение условия прямо в закрывающей команде. В скобках допускается только число или переменная, не выражение, поэтому условие считают заранее:

# &=1; q=0; !
#case 1
  # q=q+1; w=-sgn(q-4); !
#end (w)

Как строят условия

Раз сравнений нет, всё сводится к тому, чтобы получить в & нужное целое.

Проверка на равенство — вычесть и взять модуль знака:

Единица, если a равно b
# &=1-abs(sgn(a-b)); !

Проверка «больше» — знак разности:

Единица, если a больше b, иначе 0 или -1
# &=sgn(a-b);
#case 1   ... a больше ...   #end |
#case 0   ... равны ...      #end |
#case -1  ... a меньше ...   #end |

Метка может быть отрицательной — это удобно и используется постоянно.

Флаг — просто 0 или 1:

# &=0;
#case 1   ... не выполнится ...   #end |

Ранний выход из цикла

Прямого break нет, и у #rep число повторов задано заранее — изменить его изнутри нельзя. Когда цикл должен закончиться по условию, его пишут через #case, где условие продолжения вы вычисляете сами:

# k=0; &=1; !
#case 1
  # k=k+1; &=sgn(50-k*k)>0; !
#end
#pr первое k, у которого k*k больше 50: \I3 k;\n\E
#m [op=txt;] \Tp\E

Пока k*k меньше 50, sgn(50-k*k) равен 1, и ветка повторяется. Как только квадрат превысит 50, sgn даст −1, а >0 (максимум с нулём) превратит его в 0 — ветка больше не совпадает с &, и цикл заканчивается на k = 8.

Что важно помнить

• #end | закрывает ветку, #end без черты — превращает её в цикл;
• пропущенная ветка пропускается целиком, включая вложенные блоки;
• уровней вложенности не больше 45;
• цикл нельзя оставить незакрытым к концу процедуры — это ошибка 34.

Дальше — процедуры.

Процедуры

Процедура в VKACL — именованный кусок кода. Без параметров, без возвращаемого значения, без локальных переменных. Всё общение — через общую память.

Определение и вызов

#pro summ
  # s=a+b;
@

# a=2; b=3;
#e _summ
#pr сумма = \G s;\n\E

#pro имя открывает процедуру, @ закрывает. Вызов — #e _имя с подчёркиванием перед именем.

Определения обычно собирают в начале файла, а основной код идёт после них. Интерпретатор регистрирует процедуру, когда доходит до #pro, поэтому определение должно встретиться раньше вызова.

Значимы первые четыре буквы имени

Это не опечатка: имя процедуры усекается до четырёх символов.

#pro calculate  ...  @
#pro calcform   ...  @

Обе процедуры получат имя calc — и вторая затрёт первую. Имена длиннее четырёх букв читаются нормально, но различаться должны в первых четырёх:

#pro calc-total  ...  @
#pro calc-part   ...  @

Здесь тоже конфликт: calc и calc. Безопаснее давать имена ровно из четырёх символов.

Подчёркивание в вызове

#e _summ !

Подчёркивание означает «вызвать безусловно». Без него вызов становится условным: процедура выполнится, только если параметр c совпадает с &.

#e [c=3;] summ !

выполнит summ, только когда & равно 3. Приём экзотический; в авторском коде почти везде стоит подчёркивание.

Данные передают через переменные

Раз параметров нет, договариваться приходится на уровне соглашения:

Возводит x в квадрат, результат кладёт в y
#pro sqre
  # y=x*x;
@

# x=5;
#e _sqre
#pr \G y;\n\E

Это работает, но требует дисциплины: любая процедура может испортить любую переменную. Распространённая практика — закрепить за процедурами свои буквы или диапазоны массивов.

Рекурсии нет

Вызов процедуры из неё самой — ошибка 14. Вложенные вызовы разных процедур разрешены, глубина — до 45:

#pro inne
  # c=c+1;
@

#pro oute
  #e _inne
  #e _inne
@

# c=0;
#e _oute !

После этого c равно 2.

Выполнение текста как программы

Есть особая форма вызова — #e _text. Она выполняет как программу тот текст, который лежит в массиве t():

# s(3)=1;
#pr \#\u32;q=6*7;!\E
# b=s(4); l=s(5);
#e [b=b; le=l;] _text !
#pr q = \G q;\n\E
#m [op=txt;] \Tp\E

Здесь программа сначала формирует строку # q=6*7;!, а потом исполняет её. Обратите внимание на три детали:

• \# нужен, чтобы знак # не оборвал #pr;
• пробел после него записан кодом \u32; — обычный пробел в этом месте был бы съеден, и получилось бы #q=6*7;, то есть уже не команда вычислений;
• в конце выполняемого текста стоит !. Интерпретатор автора не останавливает вычисления на границе этого текста и без ! читает дальше, в посторонние символы, с ошибкой 18. В программах автора для той же цели дописывается пустая команда #p [].

Приём выглядит экзотикой, но именно на нём построены калькуляторы автора: формулу, введённую в окне ввода, программа превращает в команду #c и исполняет. В песочнице есть пример «Мини-калькулятор».

Процедуры из файлов

Код можно держать в отдельном файле и выполнять его из программы:

#e [file=lib.acl;] _file !

Файл читается и выполняется так, как если бы его текст стоял на месте вызова. Если #e — последняя команда в таком файле, после неё обязателен !.

Две тонкости, обе проверены на интерпретаторе автора:

• путь считается от папки интерпретатора: рабочая папка, выбранная #f [op=fold;], на него не влияет;
• процедуры, объявленные внутри файла, после его окончания забываются. Если файл переопределил процедуру с тем же именем, снова действует прежнее определение. Поэтому библиотеку процедур удобнее держать в самой программе.

Краткая старая форма — ##имя: она выполняет файл proc/имя.acl. Автор ею больше не пользуется, потому что файл читается с диска при каждом вызове.

Суперкоманды

Вместо россыпи файлов в новой версии есть номерные суперкоманды: ##1, ##2, … Это готовые программы на VKACL из библиотеки автора — графики, карты, окна, интерполяция, преобразование Фурье. Каждая хранится в одной строке общего файла-библиотеки; при первом вызове читается и остаётся в памяти, в конце массива t(), так что повторные вызовы в цикле ничего не стоят.

Входные данные суперкоманде передают через переменные и массивы, а тексты — через #pr, разделяя части вертикальной чертой:

#pr Да|Нет|Продолжить вычисления?\E ##33

показывает сообщение с кнопками «Да» и «Нет»; номер нажатой кнопки попадает в &. Все 54 суперкоманды описаны в разделе Суперкоманды.

У этого устройства есть два следствия для любой программы:

• библиотека живёт в конце массива t(), поэтому своим данным можно отводить только t(1)…t(KY), где KY — переменная, которую интерпретатор задаёт при запуске;
• двухбуквенные переменные, оканчивающиеся на Y (AY…KY и другие), занял диспетчер суперкоманд — их трогать нельзя. Автор советует обходить стороной и двухбуквенные имена на X и Z.