Pular para o conteúdo
Untzel
Estreia 09.10
Páginas da documentação

Erros

A análise nunca lança exceção: devolve o programa ou uma lista de diagnósticos, cada um com posição, código estável e mensagem, que o app mostra no idioma dele (o texto inglês é a fonte). Erros de sintaxe dão um diagnóstico por linha. Os códigos são um contrato estável; as mensagens podem mudar. As mensagens abaixo são as que o app mostra hoje em português; na página em inglês, as inglesas.

UNKNOWN_INSTRUMENT

Gravidade
erro
Mensagem
Instrumento desconhecido "kik". Você quis dizer "kick"?
Como corrigir
Use um dos instrumentos da página Instrumentos; a mensagem sugere o nome mais próximo.
kick: kik x... x... x... x...

DUPLICATE_TRACK_NAME

Gravidade
erro
Mensagem
Já existe uma faixa chamada "bass" na linha 1.
Como corrigir
Dê a cada faixa um nome próprio antes dos dois-pontos, por exemplo bass2.
bass: bass c2 . . c2bass: bass . g1 . .

UNKNOWN_TRACK

Gravidade
erro
Mensagem
A seção "drop" usa "acid", mas nenhuma faixa tem esse nome.
Como corrigir
Liste só nomes de faixas que existem acima da seção, ou acrescente a faixa que falta.
kick: kick x... x... x... x...section drop kick acid

UNKNOWN_SECTION

Gravidade
erro
Mensagem
O song usa "chorus", mas nenhuma seção tem esse nome.
Como corrigir
Use um nome declarado com section, ou declare a seção.
kick: kick x... x... x... x...section drop kicksong drop 8, chorus 8

DUPLICATE_SECTION_NAME

Gravidade
erro
Mensagem
Já existe uma seção chamada "drop" na linha 3.
Como corrigir
Renomeie uma das seções; o nome é único entre as seções.
kick: kick x... x... x... x...hat:  hat  ..x. ..x. ..x. ..x.section drop kicksection drop kick hat

UNKNOWN_MODIFIER

Gravidade
erro
Mensagem
"bass" não tem o parâmetro "cutof". Você quis dizer "cutoff"?
Como corrigir
Use um modificador geral ou um parâmetro daquele instrumento; a mensagem sugere o mais próximo.
bass: bass c2 . c2 . | cutof 400

OUT_OF_RANGE

Gravidade
erro
Mensagem
tempo precisa estar entre 40 e 300.
Como corrigir
Traga o valor para dentro da faixa que a mensagem indica.
tempo 320kick: kick x... x... x... x...

EMPTY_PATTERN

Gravidade
erro
Mensagem
Esta faixa não tem passos.
Como corrigir
Escreva pelo menos um passo depois do nome do instrumento, por exemplo x... x... x... x...
kick: kick

INVALID_NOTE

Gravidade
erro
Mensagem
"b9" não é uma nota.
Como corrigir
Escreva a nota em minúscula com a oitava: de a a g, b ou # opcional, depois um dígito: c2, eb2, f#1.
lead: bass c2 . b9 .

SIGNAL_NEEDS_RANGE

Gravidade
erro
Mensagem
sine(8) precisa de uma faixa, por exemplo 40..8000.
Como corrigir
Ponha depois do sinal uma faixa dentro dos limites do parâmetro, por exemplo 300..2400.
bass: bass c2 . c2 . | cutoff sine(8)

SOURCE_TOO_LONG

Gravidade
erro
Mensagem
Uma música pode ter no máximo 65.536 caracteres.
Como corrigir
Divida a música ou tire linhas repetidas: o texto tem tamanho máximo.

Qualquer texto com mais de 65.536 caracteres.

SYNTAX_ERROR

Gravidade
erro
Mensagem
"]" inesperado.
Como corrigir
Confira a linha com a gramática: colchete, barra ou vírgula sobrando é a causa mais comum.
kick: kick x... x... ]

INTERNAL_ERROR

Gravidade
erro
Mensagem
Algo deu errado ao ler este texto.
Como corrigir
Não é causado pelo seu texto. A última versão válida continua tocando; recarregue a página se repetir.

Nenhum texto causa este erro de propósito.

UNKNOWN_SCALE

Gravidade
erro
Mensagem
Escala desconhecida "minr". Você quis dizer "minor"?
Como corrigir
Use uma das escalas da referência; a mensagem sugere a mais próxima.
key c minrbass: bass c2 . c2 .

NAME_TOO_LONG

Gravidade
erro
Mensagem
Um nome pode ter no máximo 24 caracteres.
Como corrigir
Encurte o nome da faixa ou da seção.
a-very-long-name-for-a-kick: kick x... x... x... x...

TOO_MANY_STEPS

Gravidade
erro
Mensagem
Um compasso pode ter no máximo 64 passos.
Como corrigir
Use menos passos no compasso, ou grupos entre colchetes para subdividir um passo.
hat: hat x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x.x

TOO_MANY_BARS

Gravidade
erro
Mensagem
Um padrão pode ter no máximo 64 compassos.
Como corrigir
Use menos compassos no padrão, ou seções e um song para músicas longas.
kick: kick x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x / x

PATTERN_KIND_MISMATCH

Gravidade
erro
Mensagem
"bass" toca notas, não acordes.
Como corrigir
Bateria toca batidas (x . ~), instrumentos com nota tocam notas (c2). Confira o tipo do instrumento.
pad: bass Cm7 ~ ~ ~ / Abmaj7 ~ ~ ~

MISSING_VALUE

Gravidade
erro
Mensagem
gain precisa de um valor, por exemplo gain 0.8.
Como corrigir
Dê um valor ao modificador, como no exemplo da mensagem.
kick: kick x... x... x... x... | gain

DUPLICATE_SONG

Gravidade
erro
Mensagem
Um texto só pode ter um song.
Como corrigir
Deixe uma linha song só e junte as partes com vírgulas.
kick: kick x... x... x... x...section drop kicksong drop 8song drop 16

OUT_OF_ORDER

Gravidade
erro
Mensagem
As seções vêm depois das faixas.
Como corrigir
Ordene o texto: tempo, key, swing e loop primeiro, depois as faixas, depois as seções, por fim o song.
kick: kick x... x... x... x...section drop kickhat: hat ..x. ..x. ..x. ..x.

DUPLICATE_STATEMENT

Gravidade
erro
Mensagem
tempo já foi definido na linha 1.
Como corrigir
Deixe uma linha de title, uma de tempo, uma de key, uma de swing e uma de loop; vale a primeira.
tempo 124tempo 128kick: kick x... x... x... x...

DUPLICATE_MODIFIER

Gravidade
aviso
Mensagem
gain aparece duas vezes; vale o último.
Como corrigir
É um aviso, não um erro: tire a cópia anterior; vale a última.
kick: kick x... x... x... x... | gain 0.8 | gain 0.6

UNKNOWN_PRESET

Gravidade
erro
Mensagem
"piano" não tem o som "brigth". Você quis dizer "bright"?
Como corrigir
Use um dos sons do instrumento listados na página Instrumentos; a mensagem sugere o mais próximo.
pad: piano brigth Cm7 ~ ~ ~

UNKNOWN_CHOICE

Gravidade
erro
Mensagem
"wave" pode ser saw, square, triangle ou sine.
Como corrigir
Use um dos nomes que a mensagem lista.
lead: lead c4 . eb4 . g4 . . . | wave noise

SIGNAL_NEEDS_NUMBER

Gravidade
erro
Mensagem
"wave" recebe um nome, não um sinal.
Como corrigir
Escreva um dos nomes do parâmetro: um sinal só move números.
lead: lead c4 . eb4 . g4 . . . | wave sine(4) 0..1

NO_EFFECT

Gravidade
aviso
Mensagem
legato precisa de um instrumento de uma voz só; "bass" toca várias vozes.
Como corrigir
É um aviso, não um erro: o modificador é ignorado. Use-o no tipo de instrumento que a mensagem indica, ou acrescente o que ele precisa.
bass: bass c2 . c2 . eb2 . c2 . | legato

TOO_MANY_MODULATORS

Gravidade
erro
Mensagem
Uma faixa pode ter no máximo 8 sinais rápidos.
Como corrigir
Dê a alguns parâmetros um sinal lento (período de 1 compasso ou mais) ou um valor fixo; a mensagem diz o limite por faixa.
lead: lead c4 . eb4 . | cutoff sine(1/8) 300..900 | detune sine(1/4) 0..1 | attack tri(1/2) 0.01..0.1 | release saw(1/2) 0.1..1 | gain sine(1/8) 0.2..0.8 | pan sine(1/4) -0.5..0.5 | lowpass sine(1/8) 500..5000 | highpass sine(1/8) 50..500 | distort sine(1/8) 0..0.5

DUPLICATE_LOOP_SECTION

Gravidade
erro
Mensagem
Só uma seção pode ser o loop; "groove" já é, na linha 3.
Como corrigir
Deixe | loop em uma seção só: é ela que o modo loop toca.
kick: kick x... x... x... x...hat: hat .x.x .x.x .x.x .x.xsection groove kick hat | loopsection break hat | loop

EMPTY_TITLE

Gravidade
aviso
Mensagem
O título da música está vazio; fica o último título.
Como corrigir
É um aviso, não um erro: escreva o nome entre as aspas ou tire a linha title; a música continua tocando.
title ""tempo 124kick: kick x... x... x... x...

TITLE_TOO_LONG

Gravidade
aviso
Mensagem
Um título pode ter no máximo 60 caracteres.
Como corrigir
É um aviso, não um erro: encurte o título para 60 caracteres; ficam os 60 primeiros.
title "Midnight Coast at the Harbour, the long version for the last ferry home"tempo 124kick: kick x... x... x... x...

Conteúdo da documentação do Untzel, sob a licença CPAL-1.0. Ler a licença