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 acidUNKNOWN_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 8DUPLICATE_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 hatUNKNOWN_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 400OUT_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: kickINVALID_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.xTOO_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 / xPATTERN_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... | gainDUPLICATE_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 16OUT_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.6UNKNOWN_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 noiseSIGNAL_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..1NO_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 . | legatoTOO_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.5DUPLICATE_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 | loopEMPTY_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