Comprendre FRM dans FractalPark

Ce tableau de compatibilité décrit l’Éditeur compatible Classic et le parcours d’importation. Les Definitions Standard canoniques publiées utilisent l’analyseur FRM-like v1 versionné séparément, l’IR typé, le backend standard32 et l’enveloppe de sécurité fixe.

FRM-like v1 canonique et les exemples actuels de l’Éditeur Classic partagent une formule nommée et les notions de init, loop et bailout, mais leurs grammaires complètes sont différentes. En v1, des directives sémantiques et une section parameters typée facultative font aussi partie de la Definition.

Les noms de sections sont structurels, pas des commentaires : en omettre un ou l'écorcher produit un diagnostic.

Les deux surfaces restent volontairement réduites. Les résumés ci-dessous présentent des concepts communs ; utilise l’action Source d’un Formula Record publié pour les directives canoniques et les paramètres typés, et les diagnostics de l’Éditeur pour la source Classic.

Déclaration et sections

Enveloppe une formule nommée entre accolades, puis écris init:, loop: et bailout: dans cet ordre.

Valeurs et variables

Utilise des nombres réels comme 0.15, des paires complexes comme (0.05, -0.02), des valeurs d'orbite intégrées ou tes propres variables affectées.

Expressions

L'arithmétique, les puissances, les comparaisons, les opérateurs logiques, les opérateurs unaires, la syntaxe de magnitude |z| et les fonctions complexes testées peuvent être combinés.

Flux de contrôle

Utilise if, elseif, else et endif lorsqu'une mise à jour d'orbite dépend d'une condition. Les blocs doivent être équilibrés.

Fonctions intégrées

Les noms de base incluent z, c, pixel, zPrev, p1–p5, pi, e, maxit, ismand, fn1–fn4 et les fonctions couvertes par les tests du compilateur.

Commentaires et directives

Les commentaires commençant par un point-virgule documentent la source. Les directives @ reconnues configurent le comportement natif de FractalPark ; les directives inconnues ne sont pas ignorées silencieusement.

FractalPark ne colle jamais le texte source dans un shader. La source v1 canonique passe par son analyseur typé et son backend CPU/GLSL ; la source de l’Éditeur Classic passe par son analyseur lexical, son frontal d’entrée sélectionnée, son modèle de formule canonique et son compilateur de plugins.

1. 1

   Source FRM

   Le texte exact provenant de l'éditeur, d'un collage ou d'un fichier local est l'entrée faisant autorité.

2. 2

   Jetons du lexer

   Le lexer reconnaît les noms, les nombres, les opérateurs, les marqueurs de section, les commentaires et les directives tout en conservant les emplacements source.

3. 3

   AST analysé

   L'analyseur construit un arbre de formule structuré et signale les déclarations, expressions et blocs de flux de contrôle mal formés.

4. 4

   Validation et forme canonique

   Le validateur vérifie les noms, les types, les sections et la sémantique prise en charge avant qu'une formule canonique soit créée.

5. 5

   GLSL et carte de source

   La génération de code émet des fonctions de shader et enregistre les correspondances du GLSL généré vers la source FRM.

6. 6

   Plugin de formule

   Une compilation réussie devient le même contrat de plugin de formule utilisé par le moteur de rendu et le système d'assemblage de shaders.

Ce sont des exemples de l’Éditeur compatibles Classic, pas des Definitions FRM-like v1 canoniques. Ils progressent d’une petite formule quadratique aux paramètres et à une rétroaction avec état ; chaque bloc source vient du registre partagé de l’Éditeur et compile pendant les 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
}

L’Éditeur FRM autonome ouvre ces exemples compatibles Classic, vérifiés à la compilation, par ID stable. La source de formule reste dans l’onglet actuel jusqu’à ce que tu l’enregistres dans ta bibliothèque cloud et n’est jamais incorporée à l’URL. Cela n’active ni l’importation ni les writers v1 canoniques.

La compilation s'arrête au premier stade non sûr et signale des messages orientés source. Une construction rejetée n'est jamais réécrite en quelque chose qui lui ressemble simplement.

Lorsque tu corriges une erreur, commence par le premier message signalé : les diagnostics suivants peuvent être les conséquences du même jeton manquant ou de la même expression invalide.

Une formule que tu écris est privée jusqu'à ce que tu choisisses autrement. Il existe trois façons de la faire circuler — chacune explicite, aucune silencieuse.

• Privé par défaut

  Les formules vivent dans ta bibliothèque cloud, visibles uniquement par toi. Les œuvres que tu enregistres contiennent une copie de la source de la formule dans le brouillon, afin qu'elles s'ouvrent toujours telles que tu les as laissées.

• Télécharger le fichier .frm

  Ta formule est du texte brut. Télécharge-la depuis Mes formules à tout moment et conserve ta propre copie — aucune demande d'export, aucune attente.

• Publier une œuvre, partager la source

  Publier une œuvre qui utilise ta formule rend la source de la formule publique sous licence MIT : chacun peut la lire, la copier et s'en inspirer. La page communautaire affiche le nom de la formule d'après ses métadonnées et propose la source en téléchargement. Cela ne peut pas être annulé pour cette publication.

Le texte intégral de la licence MIT se trouve sur opensource.org.