Nutcracker: Criador de Efeitos RGB Nutcracker: RGB Effects Builder

Proposta do Projeto: Project proposal:

Desenvolver uma ferramenta web que permita a criação fácil de animações para dispositivos RGB. Haverá uma variedade de modelos de destino: mega-árvores, matrizes, raios e outros formatos. Uma biblioteca de animações (espirais, textos, imagens, meteoros e muito mais) poderá ser selecionada para ser projetada sobre os modelos de destino. A animação final será exportada como um arquivo XML pronto para ser importado nos principais softwares de sequenciamento: Light Show Pro, Vixen ou Light-O-Rama.

Develop a web based tool that will allow the easy creation of animations for RGB devices. There will be a number of target models: mega-Trees, matrixes, rays and other shapes. A library of animations (spirals, text, pictures, meteors and many more) can be selected to project onto the target models. The final animation will be exported as an XML file for input for the major sequencing software: Light Show Pro, Vixen or Light-O-Rama.

Método: Method:

O design é totalmente independente de plataforma. O plano é permitir que o usuário utilize nossos modelos prontos ou faça upload dos seus próprios modelos matemáticos e de destino. O projeto é mantido como uma ferramenta de código aberto (open source).

The design is platform independent. The plan is for the user to use our models or allow the user to upload their own math models and target models. It is planned to keep this as an open source tool.

Tutoriais do Nutcracker Nutcracker Tutorials

Apresentações do Nutcracker: The Ultimate Academy, Conroe, Texas (16 de Junho de 2012) Nutcracker Presentations: The Ultimate Academy, Conroe, Texas. June 16, 2012

Aqui estão os documentos em PDF das duas palestras ministradas na Academy 2012: Here are the pdf documents from the two talks I gave at the Academy 2012:

  1. Palestra nº 1: Nutcracker: Introdução Talk #1. Nutcracker: Introduction
  2. Palestra nº 2: Nutcracker: Programação Avançada. Como criar uma Macro Talk #2. Nutcracker: Advanced Programming. How to write a Macro

É novo no mundo de iluminação natalina com LEDs? Confira estes excelentes tutoriais gerais: Are you new to Christmas Lights? Try looking at these excellent general Tutorials:

Onde postar nos fóruns de iluminação natalina? Como o Nutcracker é compatível com todos os sequenciadores, você encontrará tópicos nos seguintes locais: Where do I post on Christmas Forums? Since Nutcracker works with all sequencers, you will find Nutcracker info here:

A ferramenta Nutcracker é dividida em 4 fases: The Nutcracker tool has four parts:

Fase nºPhase # Nome da FasePhase Name Descrição da FasePhase Description
1 Modelador de Destino (Target Modeler) Target Modeler Esta ferramenta permite ao usuário modelar seu dispositivo RGB (mega-árvore, raio, matriz) e salvar em um banco de dados MySQL. É fundamental que sua árvore específica seja definida, pois esta é a única forma de mapear o efeito corretamente para o seu display real. This tool allows the user to model their RGB device (megatree, ray, matrix) and save it to a MySQL database. It is very important that your particular tree be defined. This is the only way that an effect can be mapped to your particular display.
2 Gerador de Efeitos (Effect Generator) Effect Generator Aqui você seleciona um efeito da biblioteca e o personaliza (espirais, flocos de neve, meteoros, texto rolante, etc.). Uma vez criado, o efeito fica disponível para ser utilizado em todos os sequenciadores de destino. Here you select an effect from the Library and modify it. Effects will be spirals, snowflakes, meteors, scrolling text, etc. Once an effect has been designed it is available to be used on all target sequencers.
3 Criar Sequência e Gerar GIF Animado Create a sequence and get an animated GIF Selecione seu modelo de destino (você pode ter mais de um no seu quintal) e escolha os efeitos que deseja mapear nele. Será solicitada a duração que você deseja para a sequência. You now select your target model (you might have more than one in your yard) and pick the effects that you want mapped to your display. You will be asked for how long of a duration you want the sequence to run.
4 Criar Arquivo XML para o Sequenciador Create an XML file for a sequencer O último passo é escolher o software sequenciador de destino. Atualmente há suporte para arquivos vir do Vixen e arquivos lms/lcb do LOR S2. The last thing you do is select the target sequencer. Currently we have Vixen vir files and LOR S2 lms and lcb files.

Sean Meighan
✉️ Enviar e-mail para Sean Meighan ✉️ Mail to Sean Meighan

Modelos de destino criados até agora. A mega-árvore de teste foi configurada com 16 fitas de 64 pixels, dobradas ao meio para formar 32 pixels por coluna: Here are the target models that have been created so far. The target mega-tree was 16 strings of 64 pixels. The strings have been folded over to give 32 pixels per strand:

Imagens: Comparação do Tamanho dos Pixels (gnuplot) Pictures: Pixel Size Comparison (gnuplot)

Para ser realista, qual o tamanho ideal que os pixels devem ser desenhados pelo programa gnuplot? Abaixo, a mesma imagem é gerada 4 vezes com diferentes tamanhos de ponto:

To be realistic, how large should the pixels be drawn using the gnuplot program? Here the same image is drawn 4 times with different size dots:

Para instalar o software Nutcracker no seu computador local, siga estes passos: To install the Nutcracker software on your local PC, follow these steps:

Passo a passo para instalar o Nutcracker na sua máquina local com Windows:

1) Baixe o Wamp: http://www.wampserver.com/en/
2) Mantenha todas as opções padrão durante a instalação.
3) Inicie o Wamp. Clique no ícone 'W' rosa na bandeja do sistema.
4) Teste o Wamp abrindo seu navegador em: http://localhost
   Se estiver funcionando, você verá a página inicial do WAMP.

O servidor Apache utiliza a porta 80. Se você tiver Skype ou IIS/HTTP 2.0 ativo, eles também podem usar a porta 80.
Para o Wamp, o arquivo httpd.conf fica localizado na pasta c:\wamp\bin\apache\apache2.2.22\conf

5) Obtenha uma cópia da árvore de código atualizada do Nutcracker:
   Acesse http://smeighan.github.com/nutcracker/ e baixe o arquivo zip.
   Descompacte esse arquivo na pasta c:\wamp\www\nutcracker
   (Este arquivo zip já contém o gnuplot incluso, dispensando instalação separada).

6) Adicione o gnuplot à variável de ambiente PATH do Windows:
   Execute o c:\wamp\www\nutcracker\gnuplot\bin\PathEditor.exe como administrador.
   Adicione o caminho: c:\wamp\www\nutcracker\gnuplot\bin

7) Com o Localhost funcionando, configure o banco de dados:
   Abra no seu navegador: http://localhost/nutcracker/install.php
   Esse comando executará automaticamente:
   a) Exclusão de tabelas antigas existentes no banco nutcracker
   b) Criação do banco de dados nutcracker se não existir
   c) Criação do usuário do nutcracker: nc_user
   d) Execução de sql/nutcrackertables.sql para criar todas as tabelas
   e) Execução de sql/nutcrackerdata.sql para popular cerca de 50.000 linhas de dados

Seu Nutcracker local estará pronto!
Acesse http://localhost/nutcracker e faça login com seu usuário e senha habituais.

Para futuras atualizações de código, basta repetir o passo (5), extraindo os novos arquivos sobre a pasta local.
            
Here are the steps to install Nutcracker on your local Windows 7 or Windows XP box:

1) Download Wamp: http://www.wampserver.com/en/
2) Take all defaults for installation
3) Start Wamp. Click on the Pink W icon.
4) Test Wamp by setting your browser to http://localhost
   If it is working, you will see the WAMP home page.

Apache server uses port 80. If you have Skype or Microsoft HTTP/2.0 they also use port 80.
Here is a web page that describes how to fix this conflict: http://blog.techsoftsolutions.net/?p=315
For Wamp, the httpd.conf file is located in c:\wamp\bin\apache\apache2.2.22\conf directory.

5) You now need to get a copy of the current Nutcracker code tree. Go to:
   http://smeighan.github.com/nutcracker/ and download the zip file. This file is updated daily with the latest Nutcracker code tree and with the latest export from meighan.net/nutcracker database.
   Unzip this file into c:\wamp\www\nutcracker
   This zip file also now contains gnuplot so you don't need to install it separately.

6) Add gnuplot into Windows PATH environment variable:
   I found a much better tool to do this and I have included the tool in the nutcracker zip file.
   Run c:\wamp\www\nutcracker\gnuplot\bin\PathEditor.exe as administrator.
   Add c:\wamp\www\nutcracker\gnuplot\bin

7) When you get Localhost working, install the database:
   Open http://localhost/nutcracker/install.php in a browser window.
   This command will do the following:
   a) Drop all the tables from your existing nutcracker database
   b) Create the nutcracker database if it is missing
   c) Create the nutcracker user: nc_user
   d) Execute sql/nutcrackertables.sql to create all nutcracker tables
   e) Execute sql/nutcrackerdata.sql to create 50,000 rows of data
   MaterDaddy wrote this script for me, Thanks!!

Your local nutcracker should be ready!
Go to http://localhost/nutcracker
Login using the same login and password as you have always used.

For future code releases, you just do step (5) above. Just unzip the file on top of your local nutcracker directory. This step is only a few seconds.

If there are any database changes, you will do step (7).
NOTE: You will lose any local changes you have made if you do step (7) since this is a complete re-install of the database. Before doing step (7) either screenshot the effects you have modified or better yet, re-enter the changes into the meighan.net database.
            

Simulador 3D xLights / Vixen: Mega-Árvore Cônica 360° & Densidade de Pixels xLights / Vixen 3D Simulator: 360° Conical Mega-Tree & Pixel Density

Visualização 3D autêntica no estilo xLights & Vixen Lights com matriz de câmera orbital em tempo real, mastro central, estrela iluminada de topo, anel de base, fitas de fixação e efeitos procedurais (Fogo, Butterfly, Espirais, Meteoros, etc.). Clique e arraste na tela para girar em qualquer ângulo 3D!

Authentic 3D visualization in true xLights & Vixen Lights style with real-time orbit camera matrix, center pole, illuminated star topper, base ring, mounting ribbons, and procedural effects (Fire, Butterfly, Spirals, Meteors, etc.). Click and drag on the canvas to rotate in 3D!

Ajustes & Controles Settings & Controls
Espirais & Ondas
Bengala Doce
Espiral Arco-Íris
3 Espirais RGB
Dupla Hélice
Galáxia
Ondas de Cores
Dinâmicos & Partículas
Fogo
Borboleta
Fogos de Artifício
Meteoros
Plasma
Anéis Ondulantes
Chuva Matrix
Cata-Vento
Radar 360°
Natal & Festas
Luzes Natalinas
Coração Pulsante
Estroboscópio
Flocos de Neve
Letreiro Rolante
Imagens & Texturas
Grinch
Snoopy
Foto Rosto
Carregar Imagem...
Configurações do Efeito Effect Settings
MegaTree 180°
MegaTree 270°
MegaTree 360°
Matriz Plana 2D
Configurações dos Cordões (Strings) Strand & Pixel Settings 1.920 Pixels
Espaçamento: 16.6mm (60 Pixels/m) Resolução: Padrão HD Distância Ideal: 8 a 15m Pixel Individual (1 px/LED) 5V / 12V DC
Aplicação Recomendada: Padrão profissional mais utilizado em shows xLights. Equilíbrio perfeito entre nitidez para imagens/textos e distância média de público.
Vista Fixa: Frente | Selecione "3D Orbit" para girar livremente
Cordões (Strings):Strands: 32
Pixels / Cordão:Nodes / Strand: 60
Total de Pixels:Total Pixels: 1.920
Canais DMX:DMX Channels: 5.760 (RGB)
Universos E1.31:E1.31 Universes: 12

Comparador Visual: Cordões de Pixels (Pebble / Seed Pixels vs. Pixel Bullet 12mm) Visual Comparator: Pixel Strings (Pebble / Seed Pixels vs. 12mm Bullet Pixels)

Compare o comportamento visual e o distanciamento físico entre nós pontuais interligados por fios. Veja os Pebble / Seed Pixels (ordenados do maior espaçamento de 10cm até o mais denso de 1,5cm em formato de semente) e o clássico Pixel Bullet 12mm:

Compare visual characteristics and physical spacing between discrete wired nodes. Explore Pebble / Seed Pixels (ordered from widest 10cm pitch to densest 1.5cm seed nodes) alongside standard 12mm Bullet Pixels:

Comparador Visual: Fitas de LED SMD em PCB (WS2811 3-em-3 vs. WS2812B / WS2815 1-em-1) Visual Comparator: SMD LED Strips on PCB (WS2811 3-in-1 vs. WS2812B / WS2815 1-in-1)

Compare a linearidade e o controle lógico nas fitas de LED SMD 5050 soldadas em PCB flexível: WS2811 (controle agrupado de 3 em 3 LEDs por CI) vs. WS2812B / WS2815 (controle individual pixel a pixel de 1 em 1 LED por CI) nas densidades de 30, 60, 96 e 144 LEDs/metro:

Compare linearity and logical control across 5050 SMD flexible PCB strips: WS2811 (grouped 3-in-1 IC control) vs. WS2812B / WS2815 (individual 1-in-1 pixel IC control) across 30, 60, 96, and 144 LEDs/meter:

Comparador de Modelos de Pixels Pixel Density & Hardware Comparison

Veja e compare em tempo real como os efeitos se comportam em diferentes quantidades de cordões, densidades por metro, tipos de chips e geometrias.

Compare in real-time how effects behave across different strand counts, LED densities per meter, chip types, and geometries.