Understand FRM in FractalPark

This compatibility table describes the Classic-compatible Editor and import path. Canonical published Standard Definitions use the separately versioned FRM-like v1 parser, typed IR, standard32 backend, and fixed Safety Envelope.

Canonical FRM-like v1 and the current Classic Editor examples share a named formula and the init, loop, and bailout ideas, but their complete grammars are different. In v1, semantic directives and an optional typed parameters section are also part of the Definition.

The section names are structural, not comments: omitting or misspelling one produces a diagnostic.

Both surfaces stay deliberately small. The summaries below are shared concepts; use a published Formula Record's Source action for canonical directives and typed parameters, and use the Editor diagnostics for Classic source.

Declaration and sections

Wrap one named formula in braces, then write init:, loop:, and bailout: in that order.

Values and variables

Use real numbers such as 0.15, complex pairs such as (0.05, -0.02), built-in orbit values, or your own assigned variables.

Expressions

Arithmetic, powers, comparisons, logical operators, unary operators, |z| magnitude syntax, and tested complex functions can be combined.

Control flow

Use if, elseif, else, and endif when an orbit update depends on a condition. Blocks must be balanced.

Built-ins

Core names include z, c, pixel, zPrev, p1–p5, pi, e, maxit, ismand, fn1–fn4, and the functions covered by compiler tests.

Comments and directives

Semicolon comments document source. Recognized @ directives configure FractalPark native behavior; unknown directives are not silently ignored.

FractalPark never pastes source text into a shader. Canonical v1 source flows through its typed parser and CPU/GLSL backend; Classic Editor source flows through its scanner, selected-entry frontend, canonical formula model, and plugin compiler.

1. 1

   FRM source

   The exact text from the editor, paste, or local file is the authoritative input.

2. 2

   Lexer tokens

   The lexer recognizes names, numbers, operators, section markers, comments, and directives while retaining source locations.

3. 3

   Parsed AST

   The parser builds a structured formula tree and reports malformed declarations, expressions, and control-flow blocks.

4. 4

   Validation and canonical form

   The validator checks names, types, sections, and supported semantics before a canonical formula is created.

5. 5

   GLSL and source map

   Code generation emits shader functions and records mappings from generated GLSL back to FRM source.

6. 6

   Formula plugin

   A successful compile becomes the same formula-plugin contract used by the renderer and shader assembly system.

These are Classic-compatible Editor examples, not canonical FRM-like v1 Definitions. They advance from a small quadratic formula to parameters and stateful feedback; every source block comes from the shared Editor registry and compiles during tests.

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
}

The standalone FRM Editor opens these Classic-compatible, compile-checked examples by stable ID. Formula source stays in the current tab until you save it to your cloud library and is never embedded in the URL. This does not activate canonical v1 import or writers.

Compilation stops at the earliest unsafe stage and reports source-oriented messages. A rejected construct is never rewritten into something that merely looks similar.

When fixing an error, start with the first reported message: later diagnostics can be consequences of the same missing token or invalid expression.

A formula you write is private until you choose otherwise. There are three ways it can travel — each explicit, none silent.

• Private by default

  Formulas live in your cloud library, visible only to you. Artworks you save carry a copy of the formula source inside the draft, so they always open the way you left them.

• Download the .frm file

  Your formula is plain text. Download it from My Formulas any time and keep your own copy — no export request, no waiting.

• Publish an artwork, share the source

  Publishing an artwork that uses your formula makes the formula source public under the MIT License: anyone may read, copy, and build on it. The community page shows the formula name from its metadata and offers the source as a download. This cannot be undone for that publication.

The full MIT License text lives at opensource.org.