ComPasso - v2026.4.0

ComPasso v2026.4.0

Esta versão é, sobretudo, uma correção de sincronização. Se você usa o ComPasso para coleta,
esta é uma atualização recomendada: sessões longas vinham acumulando um desalinhamento entre o
beep, o início do áudio e o gráfico.

O que foi corrigido

• ⏱️ Beep, áudio e gráfico dessincronizando ao longo da sessão — o sintoma era o beep tocar
  progressivamente fora do tempo configurado conforme o experimento avançava. Havia duas causas
  independentes, ambas corrigidas:

  • O ComPasso tratava o horário das amostras do BITalino e o horário do computador como se fossem
    o mesmo relógio. Não são: são cristais diferentes, que se afastam um do outro com o tempo
    (medimos ~0,17 s de desvio ao longo de uma sessão de 12 faixas). Isso deslocava por igual todos
    os marcadores de cada faixa, cada vez mais.
  • A contagem regressiva era feita somando esperas de 1 segundo, e cada espera custava um pouco
    mais que 1 segundo. Agora os instantes do beep, do gráfico e do áudio são calculados como
    horários exatos a partir do início do estímulo.

  Resultado medido: o intervalo entre o beep e o áudio fica abaixo de 1 milissegundo de erro, e
  a 20ª faixa vale exatamente o mesmo que a 1ª.

• 📉 Vão no fim do gráfico — o traço parava um pouco antes do fim do eixo e o marcador saltava.

• 🏷️ Rótulos do eixo X instáveis — ora de 1 em 1 segundo, ora de 5 em 5, conforme a faixa; e um
  rótulo isolado sumia perto do fim. Agora são sempre de 5 em 5 segundos.

• 💾 Configurações do gráfico não permaneciam — salvar e fechar revertia o gráfico ao estado
  anterior. As alterações agora valem imediatamente e continuam valendo.

• 🎨 Grade escura demais nos temas claros (Sereno e Aurora), que atrapalhava a leitura do sinal.

• 🗂️ Coluna do nome do áudio vazia na planilha dados_da_execucao.xlsx.

• 🛡️ Interface travando após um erro inesperado, sem qualquer aviso.

• 🪟 Avisos de erro abrindo atrás da janela de configuração, ficando inacessíveis.

O que há de novo

• 🔄 Menu "Atualizações" — o ComPasso agora avisa quando há uma versão nova. A verificação
  acontece uma vez ao abrir o programa, discretamente; havendo novidade, o menu ganha um ponto
  vermelho e o item passa a "Baixar atualização!". Você também pode verificar quando quiser.
• 🌗 Botão sol/lua no canto da barra de menus, para alternar entre tema claro e escuro num
  clique. Ele lembra o último tema usado de cada tipo: se você usa o Iris e vai para o claro, ao
  voltar você recebe o Iris de volta, não um tema padrão.
• ✅ Avisos de preenchimento nos formulários — endereço MAC, quantidade de músicas e de ruído,
  colunas da planilha (que não podem ser a mesma) e faixa de volume da calibração agora contornam
  o campo de vermelho e explicam o problema logo abaixo dele.
• 🔔 Instante do beep gravado nos dados — passa a existir um marcador BEEP no CSV/XLSX, o que
  permite conferir depois, nos próprios dados, se o intervalo até o áudio foi o configurado.

Mudanças que valem atenção

• 📈 A taxa de atualização do gráfico deixou de ser configurável e passou a ser fixa em 30 fps.
  A opção saiu do menu Configurações → Gráfico. Valores mais altos só consumiam processamento
  sem diferença visível.
• 🔊 A reprodução de áudio migrou para o mecanismo do Qt (o mesmo da interface). Nada muda no uso.

Como atualizar e baixar

1. Baixe o executável.
2. Execute em seu computador e seja feliz!

Notas técnicas

• Nenhuma mudança no schema do .config (CONFIG_VERSION inalterado) — arquivos de
  configuração de versões anteriores continuam funcionando sem conversão.
• A chave fps em prefs.json deixou de existir; um valor remanescente de versões anteriores é
  simplesmente ignorado, sem quebrar a leitura das demais preferências.
• Novo módulo core/updates.py (consulta à API de releases do GitHub usando apenas a biblioteca
  padrão — nenhuma dependência nova). A dependência pygame-ce deixou de ser necessária.
• O gráfico passou a usar memória constante ao longo da faixa (antes acumulava todas as amostras
  brutas) e a taxa de quadros só roda durante a gravação.
• Suíte de testes ampliada para 292 casos, incluindo regressões dedicadas para a deriva de
  relógio, a ausência de deriva do beep ao longo de 20 faixas e a persistência das configurações
  do gráfico.