Создавайте фракталы на FRM

FractalPark токенизирует, разбирает, проверяет и компилирует продуманное подмножество FRM. Таблица разделяет конструкции, которые работают напрямую, конструкции с документированной семантикой FractalPark и конструкции, которые текущий рабочий процесс не может сохранить.

FRM-формула FractalPark состоит из одного именованного объявления и трёх явных секций. Вместе они определяют переход состояния для каждого пикселя.

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

Язык намеренно остаётся небольшим: выражения описывают комплексную арифметику, операторы обновляют состояние орбиты, а управляющие конструкции выбирают между обновлениями.

Объявление и секции

Заключите одну именованную формулу в фигурные скобки, затем напишите init:, loop: и bailout: в этом порядке.

Значения и переменные

Используйте вещественные числа, например 0.15, комплексные пары, например (0.05, -0.02), встроенные значения орбиты или собственные присвоенные переменные.

Выражения

Арифметические операции, степени, сравнения, логические операторы, унарные операторы, синтаксис величины |z| и проверенные комплексные функции можно комбинировать.

Управляющие конструкции

Используйте if, elseif, else и endif, когда обновление орбиты зависит от условия. Блоки должны быть сбалансированы.

Встроенные элементы

Основные имена включают z, c, pixel, zPrev, p1–p5, pi, e, maxit, ismand, fn1–fn4 и функции, покрытые тестами компилятора.

Комментарии и директивы

Комментарии с точкой с запятой документируют исходный код. Распознаваемые директивы @ настраивают нативное поведение FractalPark; неизвестные директивы не игнорируются молча.

FractalPark не вставляет текст FRM в шейдер. Он прогоняет исходный код через поэтапный компилятор, чтобы синтаксис, смысл, сгенерированный код и диагностика оставались связанными.

1. 1

   Исходный код FRM

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

2. 2

   Токены лексера

   Лексер распознаёт имена, числа, операторы, маркеры секций, комментарии и директивы, сохраняя позиции в исходном коде.

3. 3

   Разобранное AST

   Парсер строит структурированное дерево формулы и сообщает о некорректных объявлениях, выражениях и блоках управления.

4. 4

   Проверка и каноническая форма

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

5. 5

   GLSL и карта исходного кода

   Генерация кода создаёт шейдерные функции и фиксирует сопоставления сгенерированного GLSL с исходным кодом FRM.

6. 6

   Плагин формулы

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

Эти примеры идут от простейшей квадратичной формулы к параметрам и обратной связи с состоянием. Каждый блок исходного кода взят непосредственно из общего реестра примеров и компилируется во время тестов.

StarterBrot {
init:
  z = 0
loop:
  z = z^2 + c
bailout:
  |z| < 4
}

ParameterDrift {
init:
  z = 0
loop:
  z = z^2 + c + p1 * 0.15 + p2 * (0.05, -0.02)
bailout:
  cabs(z) < 8
}

OrbitEcho {
init:
  z = pixel
loop:
  z = sqr(z) + zPrev * (0.30, -0.12) + pixel * (0.85, 0.0)
bailout:
  |z| < 48
}

Редактор FRM открывает эти же примеры, проверенные компиляцией, по стабильному ID. Исходный код формулы остаётся только на текущей вкладке, пока вы не сохраните его в облачной библиотеке формул, и никогда не встраивается в URL.

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

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

Написанная вами формула приватна, пока вы не решите иначе. Есть три способа её распространения — каждый явный, ни один не молчаливый.

• Приватно по умолчанию

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

• Скачайте файл .frm

  Ваша формула — это обычный текст. Скачайте её из раздела «Мои формулы» в любое время и храните собственную копию — без запросов на экспорт и ожидания.

• Опубликуйте работу, поделитесь исходным кодом

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

Полный текст лицензии MIT находится на opensource.org.