Manual do HandpanTuner

Este manual descreve tudo o que o HandpanTuner faz: cada ecrã, cada botão, cada definição, cada cor e cada mensagem. Pode lê-lo sem abrir a aplicação ou mantê-lo aberto ao lado enquanto trabalha.

Atualizado em setembro de 2026.

1Primeiros passos

1.1Do que precisa

• Um navegador recente, no computador (Windows, Mac, Linux), no Android, no iPhone ou no iPad. Não é preciso descarregar nada nem criar uma conta.
• Um microfone. O do telemóvel ou do computador basta para medir. Um microfone externo de qualidade, colocado perto da nota, capta melhor os parciais fracos e as frequências agudas.
• Uma ligação à Internet na primeira utilização, para carregar a aplicação e, se for o caso, ativar a sua licença. Depois, o afinador funciona sem ligação (ver Offline, dados e privacidade).

1.2O ecrã inicial

É o ecrã que aparece quando abre a aplicação. Contém:

• Acesso ilimitado: inicia o afinador se houver uma licença ativa neste dispositivo. Caso contrário, este botão abre a janela de ativação da licença (ver Ativar uma licença).
• Teste grátis: inicia o afinador em modo de teste. No botão, por baixo do nome, aparecem o tempo que lhe resta hoje («todas as funções · 30 min restantes hoje») e os dias de teste já utilizados («teste: 3/14 dias usados»). Esta última linha fica com uma cor clara quando restam apenas dois dias. Enquanto o servidor não responder (ou sem ligação), limita-se a recordar a oferta: «teste: 14 dias · 30 min por dia». Quando o teste se esgota, o botão indica «teste gratuito terminado».
• ⬇ Instalar a aplicação: só aparece se o seu dispositivo permitir a instalação, com a indicação «Instala-se como uma app real · depois funciona offline» (ver Instalar a aplicação).
• Criador de escalas grátis: abre a segunda ferramenta do site (ver O criador de escalas).
• Descobrir as ferramentas ↓: desloca o ecrã até à apresentação das funções, seguida das secções Afinar um handpan, O que o HandpanTuner mostra, Porque é que um handpan desafina e Perguntas frequentes. O botão ↑ Voltar ao topo leva-o de novo ao início da página.
• A escolha do idioma, no topo do ecrã.
• No rodapé: os links Criador de escalas, Como afinar um handpan, Manual de utilização (este manual), Comprar o software de afinação e Aviso legal; o endereço de contacto, seguido de um pequeno botão ⧉ que o copia (mostra ✓ durante um instante); os links para o site em cada idioma.

1.3Autorizar o microfone

Quando prime Acesso ilimitado ou Teste grátis, o navegador pede autorização para usar o microfone. Aceite: sem microfone, não é possível medir nada.

Se o microfone for recusado ou estiver indisponível, o ecrã de trabalho abre na mesma, com uma faixa vermelha: «Microfone indisponível. Verifica as permissões do navegador.» Autorize o microfone nas definições do navegador (no computador, o ícone à esquerda do endereço do site; no telemóvel, as permissões do site) e depois prima Tentar de novo. O ✕ fecha a faixa.

A aplicação pede ao sistema que desative o cancelamento de eco, a redução de ruído e o ganho automático, que falseariam a medição. Se, mesmo assim, o sistema mantiver algum destes processamentos, aparece um aviso ⚠ nas definições, ao lado da escolha do microfone (ver Microfone).

1.4O teste gratuito

O teste dá acesso a todas as funções, sem cartão bancário e sem conta. Condições atuais: 30 minutos por dia, durante 14 dias de utilização. O botão Teste grátis indica sempre o que lhe resta.

• O tempo só é contado enquanto o afinador está visível no ecrã. Se mudar para outro separador ou outra aplicação, a contagem para.
• Um dia só conta se utilizar realmente o teste nesse dia.
• O teste está associado à ligação à Internet: os dispositivos que usam a mesma ligação (uma oficina, uma casa) partilham o mesmo teste.
• Quando o tempo do dia se esgota, o afinador para e aparece a janela da licença com a mensagem «O teste de hoje acabou. Volta amanhã ou desbloqueia tudo com uma licença.», por vezes seguida do número de dias utilizados.
• Quando todos os dias tiverem sido utilizados: «O teu teste gratuito terminou: cobria 14 dias de utilização. Desbloqueia tudo com uma licença.»

1.5Ativar uma licença

Após a compra, recebe uma chave no formato HPTN-XXXX-XXXX-XXXX, mostrada no ecrã e enviada por e-mail. Para a ativar:

1. Abra a janela Ativar HandpanTuner: prima Acesso ilimitado no ecrã inicial (enquanto não houver nenhuma licença ativa) ou Chave nas definições, na linha Licença. A janela indica: «O modo de afinação requer uma licença. Introduz a chave recebida após a compra.»
2. Escreva os doze caracteres nas três caixas a seguir a «HPTN» (algarismos e letras de A a F). O cursor passa sozinho para a caixa seguinte; se premir Retrocesso numa caixa vazia, o cursor volta à caixa anterior. Também pode colar a chave inteira, com ou sem «HPTN-», em qualquer caixa: distribui-se sozinha pelas caixas.
3. Prima Ativar (ou Enter). A janela fecha-se e o afinador arranca.

Na mesma janela, Comprar uma licença abre a página de compra e Fechar fecha a janela. Se a ativação falhar, aparece uma mensagem por baixo das caixas:

• «Chave inválida.»: verifique o que escreveu.
• «Não foi possível contactar o servidor. Verifica a ligação e tenta de novo.»
• «Estás offline. Ativar uma licença exige ligação.»
• «O servidor devolveu o erro…» ou «Resposta inesperada do servidor…»: tente novamente um pouco mais tarde e escreva-nos se o problema persistir.
• O próprio servidor também pode explicar a recusa, por exemplo quando a chave já está ativa em todos os dispositivos autorizados.

Dois dispositivos. Atualmente, uma licença pode ser usada em dois dispositivos, ou, mais exatamente, em dois navegadores: o Chrome e o Firefox no mesmo computador ocupam duas vagas. A linha Licença das definições indica quantas estão ocupadas (por exemplo 1/2 dispositivos). Para mudar de dispositivo, por exemplo antes de vender um computador, prima Libertar e confirme («Libertar este dispositivo? A licença será desativada aqui e a vaga ficará disponível para outro dispositivo.»). Aparece a mensagem «Dispositivo libertado. Já podes ativar a tua chave noutro dispositivo.» e a aplicação é recarregada: a sua chave, que continua válida, pode ser ativada noutro dispositivo. Se o pedido falhar, a aplicação mostra «Servidor inacessível. Tenta novamente online.» (ou uma mensagem sobre a ligação). Uma vaga que não seja usada durante 90 dias também se liberta sozinha.

Sem ligação. Depois de ativada, a licença funciona 30 dias sem Internet. Volta a ser verificada automaticamente quando há ligação disponível: ao abrir a aplicação e quando regressa a ela após mais de uma hora. Ao fim de 30 dias sem nenhuma verificação, a linha Licença indica «Expirada, liga-te para renovar»: volte a ligar o dispositivo à Internet e reabra a aplicação.

Os outros estados possíveis desta linha: «Não ativada», «Ativa · offline até …» (com uma data) e, para uma chave temporária (diferente do teste gratuito), «Teste, faltam 12 dias (até …)» e depois «Teste terminado». Se o servidor recusar uma chave que deixou de ser válida, a aplicação indica-o: «O servidor não conseguiu verificar a tua licença. Introduz novamente a tua chave.»

1.6Instalar a aplicação

Depois de instalada, a aplicação tem o seu próprio ícone, abre em ecrã inteiro sem as barras do navegador e funciona sem ligação. É a forma mais confortável de a utilizar.

• Computador e Android: prima ⬇ Instalar a aplicação no ecrã inicial do HandpanTuner e confirme. Se a instalação direta não estiver disponível, a janela Instalar no Android indica os passos a seguir: abra o menu ⋮ do Chrome, no canto superior direito, escolha Instalar aplicação (consoante a versão: Adicionar ao ecrã principal) e confirme. Entendido fecha a janela.
• iPhone e iPad: o botão abre a janela Instalar no iPhone, que indica os passos a seguir no Safari: toque no botão Partilhar do Safari (em baixo no ecrã do iPhone, em cima no iPad), escolha Adicionar ao ecrã principal e depois Adicionar. Entendido fecha a janela.

1.7Atualizações

A aplicação atualiza-se sozinha. Quando uma nova versão está pronta, uma faixa anuncia-o: «Está disponível uma nova versão.» Atualizar recarrega a aplicação de imediato; o ✕ fecha a faixa, e a nova versão será aplicada da próxima vez que a abrir. O número da versão aparece ao lado do nome HandpanTuner, no topo do ecrã, e nas definições, na linha Versão.

2O ecrã de trabalho

O ecrã de trabalho organiza-se de forma diferente consoante a largura da janela: duas colunas num computador, uma só coluna num telemóvel ou num tablet na vertical. As ferramentas são as mesmas.

2.1No computador

1. Barra de trabalho: Capturar, Caderno, Histórico (ver Captura e caderno, bem como O histórico).
2. O visor, que mostra os três parciais (ver O visor).
3. O espetro e a sua barra de zoom (ver O espetro).
4. O espetrograma, com a faixa das relações e a barra que regula a gama de frequências (ver O espetrograma).
5. A estabilidade e os seus botões de escala (ver A estabilidade).
6. O diapasão 440 432 − A4 + e o botão Definições.
7. O gerador de sons, sempre aberto no computador (ver O gerador de sons).
8. A escolha da nota (ver Escolher a nota a afinar).

No canto superior direito: a escolha do idioma e o botão que põe o navegador em ecrã inteiro.

2.2No telemóvel e no tablet

No topo do ecrã, uma fila de botões:

• Capturar: prepara um registo para o caderno;
• Caderno e Histórico;
• Som: desloca o ecrã até ao gerador de sons, que fica mesmo no fundo;
• Definições;
• Ecrã inteiro.

No telemóvel, o diapasão e o idioma encontram-se nas definições: o diapasão ocupa a primeira linha.

2.3Os balões de ajuda

Os rótulos sublinhados a ponteado abrem um balão explicativo: passe o rato por cima deles ou, num ecrã tátil, toque neles. O balão fecha-se sozinho ao fim de cinco segundos, ou quando toca noutro sítio. Os botões também mostram uma breve descrição quando o rato se detém sobre eles.

2.4Ecrã inteiro

• O navegador em ecrã inteiro: botão no topo. Prima-o outra vez, ou prima Esc, para sair do ecrã inteiro.
• Um só painel: cada painel (visor, espetro, espetrograma, estabilidade) tem um botão ⤢ (Ecrã inteiro) no canto superior direito. Prima-o: o painel ocupa toda a janela. Prima de novo ⤢ para voltar a ver todos os painéis.
• Os três desvios em ecrã inteiro: quando um painel está em ecrã inteiro, uma faixa em baixo mostra os três desvios (Fund., Oit., Quinta), cada um com o seu valor a cores e a frequência medida em Hz. O ✕ desta faixa oculta-a (a definição Parciais em ecrã inteiro passa então para Não).
• Link direto: se acrescentar ?vue=spectrogramme ao endereço (ou ?vue=spectre, ?vue=stabilite, ?vue=afficheur), a aplicação abre diretamente com esse painel em ecrã inteiro. Prático para um marcador, ou para um segundo ecrã dedicado a um só gráfico.

3Ler uma medição

3.1Os três parciais

Cada nota de um handpan produz vários sons ao mesmo tempo. O HandpanTuner mede permanentemente, e em simultâneo, os três parciais que se afinam:

No espetro, no espetrograma e na estabilidade, cada parcial mantém sempre a mesma cor: dourado para a fundamental, ciano para a oitava, rosa para a quinta.

3.2O desvio em cents

O número mostrado para cada parcial é o desvio entre a frequência medida e a frequência-alvo, em cents. Cem cents equivalem a um meio-tom; um cent é, portanto, uma diferença muito pequena, e o valor aparece com precisão de um décimo de cent.

• Um sinal + (por exemplo +3.2): o parcial está demasiado alto.
• Um sinal − (por exemplo −1.4): o parcial está demasiado baixo.

A frequência-alvo calcula-se a partir da nota escolhida e do diapasão (o lá a 440 Hz, por predefinição): a fundamental visa a frequência da nota, a oitava o dobro dessa frequência, a quinta cerca do triplo (o valor exato depende da Referência dos parciais). O Desvio dos alvos permite ainda deslocar cada uma destas frequências.

Um parcial é considerado afinado quando o seu desvio fica dentro da tolerância: ±2 cents, por predefinição.

3.3As cores

Estas quatro cores aplicam-se aos números, aos medidores e aos anéis da roda. Em Onda e em Barras, as linhas da caixa ficam verdes quando o parcial está afinado (ver O visor). Nos gráficos, as cores dourado, ciano e rosa designam os parciais, as marcas que põe são creme, e uma referência fixada no espetro aparece a verde-acinzentado.

3.4A nota mostrada

O nome da nota medida aparece em grande no visor, com o número da oitava em pequeno (por exemplo D3). Se o visor estiver oculto, o nome da nota aparece no primeiro painel visível.

Na vista Roda, o centro da roda indica a nota, o desvio da fundamental em grande (por exemplo +1.8 ¢) e a frequência-alvo (por exemplo 146.83 Hz alvo). Quando nenhuma nota está a ser medida, a nota é substituída por um traço e o desvio por três pontos.

As notas escrevem-se na notação anglo-saxónica, com letras, que é a mais difundida no mundo. O algarismo que se segue é o número da oitava: o lá do diapasão é A4, e C4 é o dó central do piano.

O sinal # significa sustenido: C# é um dó sustenido, A#3 um lá sustenido da oitava 3.

4O visor

O visor mostra o estado dos três parciais num relance. Tem quatro apresentações, a escolher nas definições, na linha Estroboscópio (é o nome que o visor tem nesse painel): Onda (predefinida), Barras, Roda e Nenhum.

Em Onda, em Barras e em Nenhum, cada parcial tem a sua linha: o nome (FUNDA., OITAVA, QUINTA), um botão ▶ que faz ouvir o alvo, o desvio em cents, uma caixa de animação (vazia em Nenhum) e um medidor.

4.1O medidor

• O traço central representa o alvo.
• As pequenas graduações, em baixo, marcam ±5, ±10, ±25 e ±50 cents.
• A escala não é regular: dá muito espaço aos pequenos desvios, perto do centro, e comprime os grandes. As duas extremidades correspondem a ±100 cents.
• A zona verde cobre a tolerância.
• O cursor assume a cor do desvio. Fica à direita do centro quando o parcial está demasiado alto e à esquerda quando está demasiado baixo. Quando o parcial está afinado, a zona verde e o contorno do medidor iluminam-se.

O cursor e as animações acompanham a medição continuamente. O número, por sua vez, atualiza-se ao ritmo escolhido na definição Apresentação dos números, para se manter legível.

4.2Onda

Na caixa, três linhas onduladas. Quanto mais longe o parcial estiver do alvo, mais amplas são as ondulações. Deslocam-se para a direita quando o parcial está demasiado alto e para a esquerda quando está demasiado baixo, tanto mais depressa quanto maior for o desvio. Quando o parcial entra na tolerância, as linhas ficam verdes; abaixo de 0,3 cents de desvio, ficam perfeitamente planas e imóveis. Fora da tolerância, as linhas são douradas para a fundamental e azul-acinzentadas para a oitava e a quinta.

4.3Barras

Na caixa, deslizam faixas luminosas: para a direita quando o parcial está demasiado alto e para a esquerda quando está demasiado baixo, tanto mais depressa quanto maior for o desvio. Quando o parcial está afinado, ficam verdes e quase param. Fora da tolerância, são douradas para a fundamental e azul-acinzentadas para a oitava e a quinta.

4.4Roda

É o estroboscópio circular clássico, com três anéis concêntricos:

• o anel exterior, com 14 segmentos: a fundamental;
• o anel do meio, com 18 segmentos: a oitava;
• o anel interior, com 24 segmentos: a quinta.

Cada anel gira no sentido dos ponteiros do relógio quando o seu parcial está demasiado alto e no sentido contrário quando está demasiado baixo, tanto mais depressa quanto maior for o desvio (a velocidade deixa de aumentar acima de 25 cents). Fica imóvel quando o parcial está afinado. A sua cor segue a regra habitual: verde, laranja ou azul, e cinzento-escuro sem medição. Quando os três parciais estão afinados ao mesmo tempo, um halo verde ilumina a roda.

Ao centro: a nota, o desvio da fundamental em grande e a frequência-alvo. No computador, a roda aparece ao lado das três linhas (nome, desvio e medidor). Quando o visor está em ecrã inteiro, a roda ocupa todo o painel, com três cartões por baixo, Funda., Oitava ×2 e Quinta ×3: cada um tem um botão ▶, o desvio e a frequência medida. Um cartão esbatido assinala um parcial fraco, cuja medição é menos fiável. O nome de cada cartão abre um balão de ajuda: «O som principal da nota, o que mais se ouve. O grande anel exterior.», «Parcial que vibra ao dobro da frequência: uma oitava acima. Anel do meio.», «Parcial ao triplo da frequência: uma oitava mais uma quinta. Pequeno anel central.»

4.5Nenhum

Nenhuma animação: cada linha mantém o nome, o botão ▶, o desvio e o medidor, e a caixa fica vazia. Para um ecrã calmo, quando só lhe interessam os números.

4.6Ouvir o alvo

O botão ▶ de cada parcial faz ouvir um som puro na frequência-alvo desse parcial; transforma-se em ■, que para o som. O som acompanha a nota quando esta muda, e tem em conta a referência dos parciais e o desvio dos alvos. Vários parciais podem soar em simultâneo. É útil para comparar de ouvido a nota do instrumento com o seu alvo.

É preciso haver uma nota em curso: em Nota fixa, é sempre o caso; em Auto, o botão não tem efeito enquanto nenhuma nota for reconhecida, e o som para quando a nota deixa de ser detetada.

5Escolher a nota a afinar

O bloco de escolha da nota encontra-se na coluna da direita no computador, e por baixo dos gráficos no telemóvel. De cima para baixo: o botão de escala (e, para uma escala predefinida, a escolha do ding), os três modos Auto, Nota fixa e Captar, os botões de oitava e a grelha das notas.

5.1Auto

A aplicação reconhece e mede a nota que toca. A nota reconhecida ilumina-se na grelha.

• Com a escala livre (cromática), identifica o meio-tom mais próximo do som tocado.
• Com uma escala predefinida ou com A minha escala, só considera as notas dessa escala: a mais próxima do som tocado, se estiver suficientemente perto. Escolher a escala do seu instrumento evita, por isso, muitas confusões.

Se tocar na nota iluminada na grelha, a aplicação fica bloqueada nela (modo Nota fixa).

5.2Nota fixa

A aplicação fica numa só nota, mesmo que outra soe. É o modo a usar durante o trabalho com o martelo: as marteladas dadas à volta do campo da nota não mudam o alvo.

• Nota fixa bloqueia a nota que está a ser tocada ou, na falta dela, a última nota reconhecida em Auto.
• Também pode tocar em qualquer nota da grelha: a aplicação fica diretamente bloqueada nela.
• Tocar de novo na nota bloqueada faz voltar a Auto.

Se tocar claramente outra nota, uma faixa vermelha indica-o no topo do ecrã, por exemplo «Está a tocar A3, bloqueado em D3». As medições continuam a ser as da nota bloqueada. A faixa desaparece quando volta a tocar essa nota, ou após um segundo de silêncio.

5.3Captar

Prima Captar e depois toque a nota a afinar. O botão mostra «Toca uma nota…» durante a escuta. Assim que a nota soar claramente, bem acima do limiar de sensibilidade, durante cerca de 0,4 segundos, a aplicação fica bloqueada nela e o botão volta ao normal. Prima de novo Captar para cancelar. Se estiver em Nota fixa, a aplicação passa para Auto durante a escuta.

Balão de ajuda: «Carrega e depois toca a nota que queres afinar: a app deteta-a e fica fixada nela até mudares.»

5.4A grelha das notas

• Com a escala livre, a grelha mostra as doze notas, de C a B, e os botões Oct 1 a Oct 6 escolhem a oitava dessas notas.
• Com uma escala predefinida, mostra as notas da escala com a respetiva oitava (por exemplo D3, A3, A#3, C4…).
• Com A minha escala, serve para marcar as suas notas (ver abaixo).

A nota reconhecida (em Auto) ou bloqueada (em Nota fixa) fica em destaque.

5.5As escalas

O botão de escala mostra a escala atual, por exemplo Escala: livre (cromática) ▾. Abre a lista das escalas:

• um campo de pesquisa: escreva parte do nome (Kurd, Celtic, Hijaz…); Esc fecha a lista, tal como um clique fora dela;
• Escala: livre (cromática) e ★ A minha escala (personalizada);
• depois, as escalas agrupadas em Menores, Maiores, Orientais e do mundo e Outras.

Para uma escala predefinida, aparecem duas listas ao lado do botão: a nota do ding (C a B) e a sua oitava (Oct 2, Oct 3 ou Oct 4). A escala é construída a partir desse ding, D3 por predefinição. Escolher uma escala ou mudar de ding faz voltar ao modo Auto.

5.6A minha escala

Escolha ★ A minha escala (personalizada) para compor a lista exata das notas do seu instrumento. Aparece uma mensagem de ajuda: «Marca as notas do teu handpan na grelha (muda de oitava com os botões). Toca num cartão para o afinar, ✕ para o remover.»

• Escolha uma oitava (Oct 1 a Oct 6) e depois toque nas notas a acrescentar. Toque numa nota marcada para a desmarcar.
• Cada nota acrescentada aparece como um cartão por cima da grelha; os cartões ficam ordenados do grave para o agudo. Toque num cartão para bloquear o afinador nessa nota (toque de novo para voltar a Auto); o respetivo ✕ retira-a da escala.

A sua escala fica guardada no navegador do dispositivo: da próxima vez que abrir a aplicação, escolha de novo ★ A minha escala (personalizada) na lista das escalas para a recuperar. Fica também inscrita no endereço da página (a parte que começa por #g=): um marcador ou um link partilhado reabre diretamente o afinador com essa escala.

6O diapasão (A4)

O diapasão é a frequência do lá (A4), da qual derivam todos os alvos. A norma internacional é 440 Hz; alguns handpans estão afinados em 432 Hz.

• 440 e 432: os dois valores habituais, num só gesto.
• − e +: descem ou sobem um hertz.
• O campo ao lado de «A4» aceita qualquer valor de 400 a 480 Hz, com precisão de um décimo de hertz. Para confirmar, prima Enter ou saia do campo.

A alteração aplica-se de imediato a todos os alvos e fica memorizada. No computador, o diapasão está no topo da coluna da direita; no telemóvel, nas definições. O seu balão de ajuda: «Frequência de referência do Lá. 440 Hz = padrão internacional. Alguns handpans estão afinados em 432 Hz.»

7O espetro

7.1O que mostra

O espetro mostra, no instante presente, onde se encontra a energia do som: as frequências da esquerda para a direita (numa escala logarítmica, em que cada oitava ocupa a mesma largura) e o nível de baixo para cima. Permite ver qual o parcial que domina e se aparece um pico estranho onde nada deveria soar.

• A curva azul, preenchida por baixo: o espetro do som neste momento.
• As cristas, mais claras: cada frequência deixa o rasto do nível mais alto que atingiu, e esse rasto desce lentamente. Assim, vê qual o parcial que se extingue primeiro. A velocidade de descida das cristas depende da definição Deslocamento.
• Três traços verticais com as cores dos parciais marcam as frequências-alvo: fundamental (o traço mais espesso), oitava, quinta. Um pico exatamente em cima do seu traço é um parcial afinado. Estes traços seguem a referência dos parciais e o desvio dos alvos.
• Em baixo à direita, a legenda: ● Fund. ● Oitava ● Quinta.
• A escala vertical adapta-se: quando o som é muito forte, o topo da escala sobe, e o seu valor aparece no canto superior esquerdo (por exemplo −22 dB).

Pode pôr marcas no espetro e ler uma frequência precisa ao passar o rato: ver Marcas e cursor de leitura.

7.2O zoom

A barra por baixo do espetro escolhe a gama de frequências mostrada. A escolha fica memorizada.

7.3Fixar uma referência

O botão Fixar guarda a impressão de uma batida para a comparar com as seguintes, por exemplo antes e depois de uma martelada, ou entre duas notas:

1. Prima Fixar: «Captura armada: toca a nota quando quiseres, fixa-se sozinha.»
2. Toque a nota. A aplicação guarda o espetro mais nítido dos dois segundos seguintes e desenha-o a verde-acinzentado por trás do espetro em direto: «Referência fixada: toca para comparar.»
3. Volte a tocar: vê de imediato o que mudou em relação à referência.

Prima de novo Fixar para apagar a referência (ou cancelar uma captura armada): «Comparação apagada». O botão fica iluminado enquanto houver uma captura armada ou uma referência visível.

Balão do botão: «Fixar uma referência: ativa, toca a nota quando quiseres, a impressão mais nítida fica sobreposta.»

7.4Apagar as marcas

O ✕ no fim da barra de zoom apaga de uma só vez todas as marcas, tanto no espetro como no espetrograma.

8O espetrograma

8.1Ler o espetrograma

O espetro mostra um instante; o espetrograma mostra a sua evolução no tempo. Permite ver que frequências duram, quais se extinguem primeiro, o que aparece numa batida e não noutra, e até as frequências secundárias a que os construtores de handpans chamam shoulder tones.

• O tempo corre de baixo para cima: o instante presente está em baixo, e a imagem sobe uma linha a cada 28 milissegundos. O espetrograma guarda aproximadamente os últimos 22 segundos; a parte visível depende da altura do painel.
• As frequências vão da esquerda para a direita, numa escala logarítmica ancorada na fundamental da nota atual. Por predefinição, a gama vai de 0,7 a 24 vezes essa fundamental: cada frequência lê-se pela sua relação com a nota (×2, ×3, ×9 e mais além). Sem nota, a gama começa nos 60 Hz.
• A cor indica o nível: do azul-noite (fraco) ao turquesa, depois ao dourado e ao branco (forte), entre cerca de −95 e −35 dB.

Pode pôr marcas, seguir um parcial secundário durante o trabalho e ler uma frequência ao passar o rato: ver Marcas e cursor de leitura.

8.2A faixa por baixo do gráfico

Por baixo do espetrograma, uma faixa ajuda a situar as frequências:

• riscas claras e escuras, como as teclas brancas e pretas de um piano, assinalam as notas;
• uma régua cinzenta marca os múltiplos inteiros da fundamental incluídos na gama, com a respetiva etiqueta (×1, ×2, ×3 e outros, consoante o espaço);
• três traços de cor mostram os alvos da fundamental, da oitava e da quinta, no seu lugar exato, de acordo com a referência dos parciais e o desvio dos alvos.

8.3Escolher a gama de frequências

A barra por baixo da faixa representa toda a extensão possível, de 0,35 a 32 vezes a fundamental. A parte iluminada corresponde à gama mostrada, indicada à direita (por exemplo ×0.7-24). O seu balão: «Arraste para se deslocar, puxe as extremidades para ampliar».

• Arraste a parte iluminada para deslocar a gama sem mudar a sua largura.
• Puxe uma das suas extremidades para a alargar ou estreitar.
• Clique noutro ponto da barra para centrar a gama nesse sítio.
• Roda do rato sobre a barra: aumenta ou diminui o zoom à volta do ponteiro.

A gama não pode ficar mais estreita do que uma relação de 1,6. Volta à gama predefinida (0,7 a 24 vezes) sempre que a aplicação é aberta.

8.4Fixar o estado como fundo

O botão Fixar, no fim da barra da gama por baixo do espetrograma, fixa a imagem atual como fundo, semitransparente: as novas linhas desenham-se por cima, e vê o que se deslocou. Aparece a mensagem «Estado congelado ao fundo». Prima de novo para apagar esse fundo (mensagem «Fundo apagado»). Balão do botão: «Congela o estado atual ao fundo, para ver o deslocamento».

9Marcas e cursor de leitura

Uma marca assinala uma frequência precisa no espetro e no espetrograma. Serve para encontrar um parcial, segui-lo enquanto trabalha a nota e ouvi-lo no gerador. Também fica guardada com os seus registos.

9.1Pôr, mover, eliminar

• Pôr: clique no espetro ou no espetrograma (num ecrã tátil, toque nele). Aparece um traço vertical creme, com um pequeno triângulo no topo e a sua frequência (por exemplo 1043.2 Hz). A mesma marca vê-se nos dois gráficos.
• Mover: arraste o traço. Fica mais claro durante o movimento.
• Eliminar: toque no pequeno ✕ na base do traço, ou no da marca na lista (ver abaixo). O ✕ no fim da barra de zoom do espetro apaga todas as marcas.

O número máximo de marcas depende do tamanho do espetrograma (de 3 a 40). Atingido esse limite, cada nova marca substitui a mais antiga. Enquanto não tiver posto nenhuma marca, aparece uma indicação no canto do espetrograma: «Clique para pôr uma marca».

9.2A lista das marcas e o acompanhamento

No canto superior esquerdo do espetrograma, cada marca tem a sua caixa:

• à esquerda, a sua posição em relação à fundamental da nota atual (por exemplo ×2.97), ou a sua frequência em Hz quando nenhuma nota está a ser medida;
• à direita, um desvio em cents que indica quanto se deslocou o pico situado por baixo da marca desde que a pôs;
• um ✕ para eliminar a marca.

No momento em que põe uma marca, a aplicação mede onde se encontrava esse pico, em média, nos segundos registados pelo espetrograma: é a sua posição de partida. Depois, compara continuamente a posição atual do pico com essa posição de partida.

A partir de duas marcas, uma última caixa Apagar tudo elimina-as todas.

9.3O cursor de leitura

Passe o rato sobre o espetro ou o espetrograma: um traço ponteado segue o ponteiro, com uma etiqueta que indica a frequência (em Hz), o nível nesse ponto (em dB) e, no espetrograma, a idade dessa linha (por exemplo −3.2 s).

Num ecrã tátil, mantenha o dedo pressionado durante um terço de segundo: a etiqueta aparece e desaparece 1,6 segundos depois de levantar o dedo. Como qualquer toque no gráfico, esta pressão também põe uma marca; retire-a com o seu ✕ se não precisar dela.

10A estabilidade

O painel Estabilidade traça o desvio de cada parcial ao longo dos últimos segundos. Um número sozinho não mostra se uma nota evolui enquanto ressoa, ou se oscila entre duas alturas muito próximas: este gráfico, sim.

• Três curvas: fundamental, oitava, quinta (legenda em baixo à direita). O instante mais recente está à direita.
• Duração mostrada: 1,2 segundos, 1,8 segundos ou 3 segundos, consoante a definição Deslocamento (Rápido, Normal, Amplo).
• Eixo vertical: o desvio em cents. O traço central é o alvo; a faixa verde cobre a tolerância; linhas ponteadas, numeradas à esquerda, servem de graduações (por exemplo +13, +5, −5 e −13 na escala ±25).
• Escala: os botões ±10 ¢ ±25 ¢ ±50 ¢ ±100 ¢ por baixo do gráfico (±25 por predefinição, fica memorizada). A escala atual é indicada em baixo à esquerda. Um valor que ultrapasse a escala fica colado à margem.
• Uma curva interrompe-se quando o seu parcial deixa de ser medido.
• Uma curva esbate-se e fica mais fina à medida que o som se extingue, e recupera todo o brilho na batida seguinte. Assim, distingue a parte plena do som do seu final, mais frágil. É apenas visual: a medição não muda.

Como ler: uma curva plana é uma nota estável. Uma curva que sobe ou desce é uma nota que se move enquanto ressoa. Uma curva que ondula regularmente assinala duas alturas muito próximas que batem entre si. Os primeiros instantes logo após a batida são muitas vezes agitados: leia de preferência a parte sustentada do som.

11Captura e caderno

11.1Capturar um registo

O botão Capturar («Guarda o espetrograma e as medições no caderno.») regista o estado da nota atual: a imagem do espetrograma com a sua faixa, o nome da nota e a sua frequência-alvo, os três desvios e as frequências medidas, o diapasão, a gama do espetrograma e as suas marcas. É preciso que uma nota tenha sido medida; caso contrário: «Nenhuma nota detetada: toque uma nota antes de capturar.»

Abre-se então a janela Guardar este registo:

• uma pré-visualização da imagem;
• Instrumento: o nome do instrumento, já preenchido com o do registo anterior;
• Notas: os seus comentários livres (o que fez, o que falta fazer…);
• Exportar: descarrega de imediato a imagem, com as informações escritas nela, sem a guardar no caderno;
• Cancelar (ou um clique fora da janela): anula a captura;
• Guardar: guarda o registo no caderno.

Se o armazenamento do navegador estiver cheio, a janela indica-o: «Este registo não pôde ser guardado: o armazenamento do navegador está cheio. Exporte esta imagem e liberte espaço no caderno.»

11.2O caderno

O botão Caderno abre o Caderno de afinação: a lista dos seus Registos guardados, do mais recente para o mais antigo, com o número total. Cada registo mostra a imagem (com as suas marcas desenhadas por cima), o nome do instrumento e a nota, a data e a hora, e um resumo das medições. Os seus botões:

• ✕ Eliminar, após confirmação: «Apagar este registo? … Esta ação é definitiva.»
• → 3 (o número de marcas do registo, se as tiver): Enviar as marcas para o gráfico. São recolocadas no espetrograma, o caderno fecha-se e uma mensagem confirma: «3 marcas postas no espetrograma». Prático para reencontrar, semanas mais tarde, as frequências que estava a vigiar.
• ⛶ Ver em grande (pormenores em 11.4).
• ✎ Renomear: a aplicação pede o Nome do instrumento e depois os seus comentários (Notas).
• Um clique no registo seleciona-o ou desseleciona-o.

Por baixo da lista: Selecionar tudo, Desselecionar, Exportar e Eliminar (que atuam sobre a seleção; a eliminação pede confirmação: «Eliminar 4 captura(s)? Esta ação é definitiva.»), e Importar. O número de registos selecionados aparece ao lado (por exemplo «3 selecionado(s)»). O caderno fecha-se com o seu ✕ ou com um clique fora dele. Enquanto estiver vazio, indica: «Nenhum registo. Prima Capturar depois de tocar uma nota.»

11.3Exportar e importar

Selecione os registos e prima Exportar: uma janela indica quantos estão selecionados e propõe três formatos. Sem seleção, a aplicação avisa: «Selecione primeiro as capturas a exportar.»

Cancelar, ou um clique fora, fecha a janela sem exportar nada.

Importar: escolha um ficheiro .json exportado anteriormente. Os seus registos são acrescentados ao caderno; os que já lá estão não são duplicados. Uma mensagem confirma a importação («12 registo(s) importado(s).») ou assinala um ficheiro que não é um caderno («Ficheiro ilegível.»).

11.4Ver em grande

O botão ⛶ de um registo do caderno, ou de uma captura do histórico, abre-o em grande:

• Ampliar: roda do rato ou movimento de pinça com dois dedos. Um duplo clique amplia o ponto visado; outro duplo clique volta à imagem inteira.
• Deslocar-se: arraste a imagem.
• Acrescentar uma marca: clique na imagem. A aplicação coloca-a com precisão no pico mais próximo (a não ser que já exista uma marca muito perto).
• Retirar uma marca: faça duplo clique nela, ou toque no seu ✕ na lista.

No topo aparecem as medições do registo e a lista das suas marcas (relação com a fundamental e frequência), com Enviar 3 marcas para o gráfico e Apagar tudo. Exportar como imagem descarrega a imagem com as suas informações. Uma linha indica o instrumento, a nota, a frequência-alvo da fundamental, a data, o diapasão e o nível de zoom. As marcas acrescentadas ou retiradas aqui ficam guardadas no registo. Feche com ✕ ou com um clique fora.

11.5O espaço de armazenamento

Os registos ficam guardados no navegador do dispositivo, e em mais lado nenhum. Um medidor por baixo da lista indica o seu número e o espaço utilizado (por exemplo «18 capturas, 1.4 MB usados.»). O caderno e o histórico partilham um espaço de cerca de 5 MB.

• Aos 60%: «O espaço está a encher. Convém exportar.»
• Aos 85%: «Quase cheio, exporte e apague os mais antigos.»

Se uma operação no caderno falhar por falta de espaço (guardar, mudar o nome, importar…), uma mensagem indica-o: «Armazenamento cheio: exporte os registos e apague os mais antigos.»

O caderno mostra dois lembretes: «Estes registos ficam neste navegador. Exporte-os regularmente: limpar a cache apaga-os.» e «A imagem leva os dados mas não se pode reimportar. Para isso, use a exportação do caderno.»

12O histórico

Enquanto trabalha, a aplicação guarda automaticamente capturas do espetrograma e das medições, para que possa recuperar um momento que se esqueceu de capturar.

• No máximo, uma captura a cada 22 segundos, aproximadamente, e só se tiver tocado entretanto.
• São conservadas as 20 mais recentes (até um limite de cerca de 2 MB); a partir daí, a mais antiga é apagada.

O botão Histórico abre o painel Histórico do espetrograma e das medições, com a indicação «Capturas automáticas durante o trabalho, imagem e medições. A mais antiga desaparece quando cheio.» A lista vai da mais recente para a mais antiga. O painel fecha-se com o seu ✕.

Cada captura mostra a imagem, a nota, a hora, o número de marcas (por exemplo 2 ✛) e as medições. Os seus botões:

• ⛶ Ver em grande (pormenores em 11.4);
• ↑ Adicionar ao caderno: a captura passa a ser um registo do caderno («Adicionado ao caderno.», ou «Armazenamento cheio…» se já não houver espaço);
• ✕ Eliminar.

Em baixo: Desativar interrompe as capturas automáticas (o botão passa a Reativar; esta escolha fica memorizada), Limpar esvazia o histórico após confirmação («Apagar todo o histórico?»), e um contador indica o preenchimento (por exemplo 12 / 20). Quando a lista está vazia, mostra «Ainda nada. O histórico enche-se sozinho enquanto toca.», ou «Histórico desativado.» se as capturas automáticas estiverem desativadas.

Abrir o caderno ou o histórico corta o som do gerador.

13O gerador de sons

O gerador faz ouvir qualquer frequência: uma frequência livre, uma nota do teclado, um múltiplo da nota atual, um alvo de afinação ou uma marca. No computador, está sempre aberto na coluna da direita. No telemóvel, encontra-se mesmo no fundo da página, e o botão Som leva diretamente até ele.

13.1Frequência livre

O botão ▶ toca a frequência do campo e passa a ■ para parar. O campo aceita de 20 a 8000 Hz, com precisão de um décimo de hertz. Ao lado aparecem a nota mais próxima, com o respetivo desvio quando a frequência fica entre duas notas, e a frequência tocada (por exemplo D3 · 146.8 Hz ou D3 +37 ¢ · 150.0 Hz). Pode mudar o valor enquanto o som toca.

13.2Nota

Um teclado de doze teclas, de C a B, e a escolha da oitava (− e +, de 0 a 8; 3 no início). Prima uma tecla para ouvir a nota, calculada a partir do diapasão atual.

13.3Múltiplo da nota atual

Os botões ×1 a ×24 tocam os múltiplos inteiros da fundamental da nota atual (até 16 000 Hz). É a série dos harmónicos puros, independente das definições: serve para explorar o espetro e identificar uma frequência vista no espetrograma. Ao passar o rato, cada botão indica a sua frequência e o nome da nota mais próxima.

13.4Parciais da nota

Três botões, Fund., Oit. e Quinta, com a respetiva frequência: são os alvos de afinação da nota atual. Ao contrário dos múltiplos, seguem a Referência dos parciais (indicada ao lado do título: Temperada, Justa ou Personal.) e o Desvio dos alvos.

13.5As minhas marcas

Um botão por cada marca posta, com a sua frequência e a sua relação com a fundamental. Sem marcas: «Ponha uma marca no espetrograma: aparecerá aqui, pronta para ouvir.»

13.6Timbre e nível

• Timbre: ∿ som puro (sinusoide, predefinido); △ triangular, um pouco mais rico; ◺ dente de serra, muito rico em harmónicos. Mudar de timbre reinicia o som em curso.
• Nível: o cursor regula o volume, de 0 a 100 (45 no início).

13.7Como se comporta

• O botão do som em curso fica em destaque. Tocar no botão da frequência que está a soar interrompe-a.
• Enquanto nenhuma nota for detetada, as secções Múltiplo da nota atual e Parciais da nota indicam: «Toque uma nota ou ponha uma marca para obter atalhos.»
• Quando a nota muda (em Auto ou através de um novo bloqueio), um múltiplo ou um parcial que esteja a soar acompanha a nova nota. Uma frequência escrita à mão, pelo contrário, nunca muda.
• Abrir o caderno ou o histórico corta o som.
• As definições do gerador (timbre, nível, oitava) não ficam memorizadas de uma sessão para a outra.

14As definições

O botão Definições (no telemóvel, o ícone ) abre o painel das definições: em baixo à direita no computador, na parte inferior do ecrã no telemóvel. Fecha-se com o seu ✕. Cada alteração aplica-se de imediato, e a maior parte das definições fica memorizada (ver O que a aplicação memoriza). Eis as definições pela ordem em que aparecem. Os textos recuados são os dos balões de ajuda.

15O que a aplicação memoriza

O que é memorizado fica guardado no navegador: cada dispositivo, e até cada navegador, tem as suas próprias definições.

16Offline, dados e privacidade

16.1Sem ligação

Depois de carregada (e, de preferência, instalada), a aplicação funciona sem Internet: medição, gráficos, caderno, histórico, gerador e definições. Continua a ser necessária uma ligação para o primeiro carregamento, para ativar uma licença, para a voltar a verificar pelo menos uma vez a cada 30 dias, para receber as atualizações e para abrir o criador de escalas.

16.2Os seus dados

• O som é analisado no seu dispositivo, em direto. Não é gravado nem enviado. Os registos são imagens do espetrograma, não gravações sonoras.
• O caderno, o histórico e as definições ficam no navegador do dispositivo. Não são enviados para lado nenhum e não são sincronizados entre os seus dispositivos. Apagar os dados do navegador (ou «limpar a cache» do site) elimina-os: exporte o seu caderno regularmente.
• O que passa pelos nossos servidores: a verificação da licença (a chave e um identificador técnico do dispositivo), a contagem do tempo de teste (associada a uma impressão digital irreversível do seu endereço IP, que, em si, nunca é conservado) e estatísticas de tráfego anónimas, como o número de visitas e de testes, sem nenhum dado pessoal. Os pormenores constam do aviso legal.

17Conselhos de medição

• Ajuste o diapasão (440 ou 432 Hz) antes de começar.
• Coloque o microfone perto da nota medida e mantenha a mesma posição de uma medição para a outra.
• Trabalhe num ambiente silencioso. Um frigorífico, um ventilador ou um computador barulhento acrescentam picos ao espetro.
• Percuta a nota como se estivesse a tocar, deixe-a ressoar e leia a parte sustentada do som em vez do instante da batida.
• Bloqueie a nota (Nota fixa ou Captar) durante o trabalho com o martelo: o alvo deixa de saltar.
• Se os valores saltarem no impacto, regule o filtro de ataque para 80 ou 160 ms.
• Se um parcial fraco desaparecer, aumente a sensibilidade; se o ruído da sala provocar leituras parasitas, diminua-a.
• Compare antes e depois de uma martelada com Fixar no espetro, ou Fixar no espetrograma.
• Capture cada nota no início e no fim de uma sessão: o caderno guarda a história do instrumento.

18Resolução de problemas

19Glossário

20O criador de escalas

Uma segunda ferramenta, gratuita e sem licença: componha uma escala nota a nota, ouça-a, veja-a disposta nas duas cúpulas, compare várias escalas e exporte-as como imagem. Abre-se a partir do ecrã inicial, do rodapé do site ou das definições (linha Criador de escalas, botão Abrir).

Abrir o criador de escalas

21Contacto

Uma pergunta, um problema, uma ideia? Escreva para contact@handpantuner.app, indicando, se possível, o seu dispositivo, o seu navegador e o número da versão (linha Versão das definições).

Leia também: Como afinar um handpan · Comprar o software de afinação · Aviso legal.