Easyflow Inc.

LED Strip Editor

Edição de padrões de fitas de LED

Desenhe a iluminação de fitas LED como se estivesse a desenhar um quadro — defina a cor, o brilho e a posição acesa de cada LED, adicione efeitos e veja o painel inteiro antes de ele chegar ao hardware.

A ideia

Uma fita de LED é um ecrã. É um ecrã comprido, estreito e pouco prático, ligado por uma ordem que alguém escolheu a pensar na comodidade das soldaduras, mas ainda assim um ecrã — e a forma natural de desenhar para um ecrã é desenhar sobre ele.

É isso que este editor lhe dá. Escolha uma cor, clique num píxel e esse LED acende. Arraste uma forma e ela passa a ser uma peça a que pode dar nome, que pode reutilizar e animar. A ordem da cablagem, a profundidade de cor e a ordem dos bytes que o seu componente exige são descritas uma só vez, numa única caixa de diálogo, e o editor encarrega-se de traduzir o seu desenho para elas.

O que produz

A maioria dos editores de imagem termina num ficheiro para olhar. Este termina em código-fonte: cada região que marcar torna-se um array const de valores de píxel, na ordem em que os LED estão ligados e com a profundidade de cor que o componente consegue guardar. O seu firmware inclui esse ficheiro e acende o painel a partir dele.

É essa a razão de o editor ser deliberadamente pequeno. Desenha píxeis e sabe o que é hardware de LED. Não faz retoque de fotografias.

Quatro palavras que vale a pena aprender primeiro

TermoO que significa aqui
CaixaUm retângulo sobre a imagem, com um nome. Uma caixa dá origem a um array exportado — normalmente um carácter de um tipo de letra.
Lista de caixasTodas as caixas da imagem atual, pela ordem em que serão exportadas. Guardada junto ao PNG num ficheiro .box.
DisposiçãoA ordem por que os LED de uma caixa são percorridos: que canto vem primeiro, linhas ou colunas, e se as linhas alternadas dobram para trás.
Ordem dos canaisA ordem por que os bytes de cor saem para o fio — RGB, GRB e por aí adiante. Uma ordem errada faz o painel acender no tom errado.

Como decorre uma sessão

  1. Abra ou crie um PNG.
  2. Desenhe, ou cole um desenho feito por outra pessoa.
  3. Marque como caixas as partes que quer e dê-lhes um nome.
  4. Defina a profundidade de bits, a ordem dos canais e a cablagem nas Definições de LED.
  5. Pré-visualize com a animação de caixas, depois exporte o código e transfira-o para a placa.
💡 Os passos 4 e 5 são os que descrevem o seu hardware. Defina-os uma vez para uma bancada e ficam definidos — são guardados, não perguntados a cada exportação.

Este programa é gratuito. Se lhe foi útil, considere fazer um donativo.

Fazer um donativo

Perguntas frequentes

O painel acende com as cores erradas

Quase sempre é a ordem dos canais. Confirme Compilar > Definições de LED > RGB face ao que o seu componente espera — os WS2812 e SK6812 são GRB, o WS2811 é normalmente RGB.

Se o tom está certo mas está tudo demasiado escuro ou com bandas, é antes a profundidade de bits.

O painel acende os píxeis errados

É a disposição. Compare os oito diagramas com o encaminhamento físico da sua fita e lembre-se dos dois modificadores: Ziguezague para uma fita dobrada para trás e para a frente, e Inverso para uma fita comandada a partir da outra ponta.

A exportação recusou-se a correr a 8 bits

Alguma cor do desenho não está na paleta. A exportação recusa-se por inteiro em vez de escrever píxeis silenciosamente errados. Use a Conversão de cor para trazer as cores perdidas para entradas da paleta e exporte de novo.

As minhas caixas desapareceram

A lista de caixas vive num ficheiro .box ao lado do PNG. Se o PNG foi copiado sem ele, as caixas não estão perdidas — estão na pasta de onde copiou. Veja Guardar.

O autoajuste engoliu uma região que eu tinha apagado

Já não deve acontecer: um píxel totalmente transparente conta como fundo. Se ainda assim acontecer, a região está preenchida com uma cor em vez de recortada — preencha-a com a cor de fundo, ou recorte-a outra vez.

A animação para antes do fim

O Fim é limitado pelo número de caixas carregadas. Se a lista tem 50 caixas, a reprodução termina em 50, seja qual for o número que escreveu. Veja Animação de caixas.

A transferência não estabelece ligação

Veja Transferir para o dispositivo — a porta, a velocidade e se há outro programa a ocupar a porta.

Outra coisa qualquer

Texto de menu no idioma errado, uma caixa de diálogo que não abre, uma exportação que dá erro: vale a pena comunicar estes casos. A aplicação escreve os erros não tratados num registo que pode anexar.