Изучите FRM в FractalPark

Эта таблица совместимости описывает Editor и путь import, совместимые с Classic. Канонические опубликованные Standard Definition используют отдельно версионируемые parser FRM-like v1, типизированный IR, backend standard32 и фиксированную Safety Envelope.

Канонический FRM-like v1 и текущие примеры Classic Editor разделяют именованную формулу и идеи init, loop и bailout, но их полные грамматики различаются. В v1 семантические директивы и необязательный типизированный раздел parameters также являются частью Definition.

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

Обе поверхности намеренно остаются небольшими. Приведённые ниже сводки описывают общие понятия; для канонических директив и типизированных параметров используйте действие Source опубликованного Formula Record, а для исходного кода Classic — диагностику Editor.

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

Заключите одну именованную формулу в фигурные скобки, затем напишите 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 никогда не вставляет исходный текст в шейдер. Канонический исходный код v1 проходит через типизированный parser и backend CPU/GLSL; исходный код Classic Editor проходит через scanner, frontend выбранной записи, каноническую модель формулы и plugin compiler.

1. 1

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

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

2. 2

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

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

3. 3

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

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

4. 4

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

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

5. 5

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

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

6. 6

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

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

Это примеры Editor, совместимые с Classic, а не канонические Definition FRM-like v1. Они переходят от небольшой квадратичной формулы к параметрам и обратной связи с состоянием; каждый блок исходного кода взят из общего реестра Editor и компилируется во время тестов.

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 Editor открывает эти примеры, совместимые с Classic и проверенные компиляцией, по стабильному ID. Исходный код формулы остаётся на текущей вкладке, пока вы не сохраните его в облачной библиотеке, и никогда не встраивается в URL. Это не активирует import или writers канонического v1.

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

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

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

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

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

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

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

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

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

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