Entenda o FRM no FractalPark

Esta tabela de compatibilidade descreve o Editor e o caminho de importação compatíveis com Classic. As Definitions Standard canônicas publicadas usam o parser FRM-like v1 versionado separadamente, IR tipado, backend standard32 e Safety Envelope fixo.

O FRM-like v1 canônico e os exemplos atuais do Editor Classic compartilham uma fórmula nomeada e as ideias de init, loop e bailout, mas suas gramáticas completas são diferentes. No v1, diretivas semânticas e uma seção opcional de parâmetros tipados também fazem parte da Definition.

Os nomes das seções são estruturais, não comentários: omitir ou escrever errado um deles gera um diagnóstico.

As duas superfícies permanecem deliberadamente pequenas. Os resumos abaixo mostram conceitos compartilhados; use a ação Source de um Formula Record publicado para ver as diretivas canônicas e os parâmetros tipados, e use os diagnósticos do Editor para código-fonte Classic.

Declaração e seções

Envolva uma fórmula nomeada em chaves e depois escreva init:, loop: e bailout:, nessa ordem.

Valores e variáveis

Use números reais como 0.15, pares complexos como (0.05, -0.02), valores de órbita integrados ou suas próprias variáveis atribuídas.

Expressões

Aritmética, potências, comparações, operadores lógicos, operadores unários, a sintaxe de magnitude |z| e funções complexas testadas podem ser combinados.

Fluxo de controle

Use if, elseif, else e endif quando uma atualização de órbita depender de uma condição. Os blocos devem estar balanceados.

Integrados

Os nomes principais incluem z, c, pixel, zPrev, p1–p5, pi, e, maxit, ismand, fn1–fn4 e as funções cobertas pelos testes do compilador.

Comentários e diretivas

Comentários com ponto e vírgula documentam o código-fonte. Diretivas @ reconhecidas configuram o comportamento nativo do FractalPark; diretivas desconhecidas não são ignoradas silenciosamente.

O FractalPark nunca cola código-fonte em um shader. O código-fonte v1 canônico passa pelo parser tipado e pelo backend CPU/GLSL; o código-fonte do Editor Classic passa pelo scanner, frontend da entrada selecionada, modelo canônico de fórmula e compilador de plugins.

1. 1

   Código-fonte FRM

   O texto exato do editor, da colagem ou do arquivo local é a entrada autoritativa.

2. 2

   Tokens do lexer

   O lexer reconhece nomes, números, operadores, marcadores de seção, comentários e diretivas, mantendo as localizações no código-fonte.

3. 3

   AST analisado

   O parser constrói uma árvore estruturada da fórmula e reporta declarações, expressões e blocos de fluxo de controle malformados.

4. 4

   Validação e forma canônica

   O validador verifica nomes, tipos, seções e semântica suportada antes de uma fórmula canônica ser criada.

5. 5

   GLSL e mapa de código-fonte

   A geração de código emite funções de shader e registra mapeamentos do GLSL gerado de volta ao código-fonte FRM.

6. 6

   Plugin de fórmula

   Uma compilação bem-sucedida se torna o mesmo contrato de plugin de fórmula usado pelo renderizador e pelo sistema de montagem de shaders.

Estes são exemplos do Editor compatíveis com Classic, não Definitions FRM-like v1 canônicas. Eles vão de uma pequena fórmula quadrática a parâmetros e realimentação com estado; cada bloco de código-fonte vem do registro compartilhado do Editor e é compilado durante os testes.

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
}

O Editor FRM independente abre esses exemplos compatíveis com Classic, verificados pela compilação, por ID estável. O código-fonte da fórmula fica na aba atual até você salvá-lo na sua biblioteca na nuvem e nunca é incorporado à URL. Isso não ativa a importação nem os writers do v1 canônico.

A compilação para no estágio inseguro mais precoce e reporta mensagens orientadas ao código-fonte. Uma construção rejeitada nunca é reescrita em algo que apenas se parece com ela.

Ao corrigir um erro, comece pela primeira mensagem reportada: diagnósticos posteriores podem ser consequências do mesmo token ausente ou da mesma expressão inválida.

Uma fórmula que você escreve é privada até você decidir o contrário. Há três formas de ela viajar — todas explícitas, nenhuma silenciosa.

• Privada por padrão

  As fórmulas ficam na sua biblioteca na nuvem, visíveis apenas para você. As obras que você salva carregam uma cópia do código-fonte da fórmula dentro do rascunho, então sempre abrem do jeito que você as deixou.

• Baixe o arquivo .frm

  Sua fórmula é texto simples. Baixe-a de Minhas Fórmulas a qualquer momento e guarde sua própria cópia — sem solicitação de exportação, sem espera.

• Publique uma obra, compartilhe o código-fonte

  Publicar uma obra que usa sua fórmula torna o código-fonte da fórmula público sob a Licença MIT: qualquer pessoa pode lê-lo, copiá-lo e desenvolver em cima dele. A página da comunidade exibe o nome da fórmula a partir de seus metadados e oferece o código-fonte como download. Isso não pode ser desfeito para aquela publicação.

O texto completo da Licença MIT está em opensource.org.