Nutcracker: RGB Effects Builder

What is Nutcracker?

A 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, HLS or Light-O-Rama.

There are two versions of Nutcracker, are you on the latest?

Nutcracker 2.0: This is the release of Nutcracker that resides on this web page you are looking at. This version runs in your browser. Version 2.0 is no longer being enhanced. There are currently no plans to turn it off so feel free to continue to use it, if you like.
Nutcracker 3.0: Matt Brown converted all of Nutcracker 2.0 effects into his xLights program in December 2012. xLights can run in Windows, Linux or MAC . This version is where all future development is being done. Nutcracker 3.0 is 10-50 times faster at creating effects as compared to Version 2.0. You may find the latest Version 3 Nutcracker code here: http://nutcracker123.com/nutcracker/releases

Where is news about Nutcracker posted? Since Nutcracker works will all sequencers, you will find Nutcracker info here:


Click here to login


Vimeo Movie tutorials:


Are you new to Christmas Lights? Try looking at these excellent general Tutorials

Sean meighan

Mail to sean meighan

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


Model Class 3 Spirals
100ms frame timing
1 pixel wide
3 Spirals
100ms frame timing
Rotate CCW
1 pixel wide
RGB = RED (hue .972) to ORANGE (hue .083)
3 Spirals
50ms frame timing
Rotate CW
1 pixel wide
RGB = RED (hue .972) to ORANGE (hue .083)

Spirals

3 Spirals
100ms frame timing
4 pixels wide
2 Spirals
50ms frame timing
Rotate CW
Only show front half of mega-tree
1 pixel wide
RGB = RED (hue .972) to ORANGE (hue .083)
Barber Pole
150ms frame timing
Only show front half of mega-tree

Spirals

6 Spirals
1 pixel wide
200ms frame timing
6 Spirals
1 pixel wide
50ms frame timing
Rotate CCW
RGB = RED (hue .972) to ORANGE (hue .083)
6 Spirals
1 pixel wide
50ms frame timing
Rotate CW
RGB = RED (hue .972) to ORANGE (hue .083)

Spirals

3 Vertical Bands
100ms frame timing
Half of a megatree
6 Vertical Bands
100ms frame timing
Half of a megatree

Vertical Bands
Chase Sequences

1 line text
100ms frame timing
Half of a megatree
2 lines of text
50ms frame timing
Half of a megatree

Scrolling text

Snowflakes

png file projected to tree
100ms frame timing
png file
100ms frame timing
png file
100ms frame timing
Photo edit out background
Random White dots
50ms frame timing
It may not show clearly, but i am also randomly
changing the intensity of the white dots
Random Color dots
50ms frame timing
Random Color dots
200ms frame timing

Random dots

Meteors

Pictures




Pictures



Pictures



Pictures



Pictures



Pictures


dots drawn 0.3 inch
50ms frame timing
dots drawn 0.6 inch
50ms frame timing
dots drawn 1.0 inch
50ms frame timing
dots drawn gnuplot default inch
50ms frame timing

Pictures
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.






To install the nutcracker software on your local PC , you need to follow these steps


		Here are the steps to install Nutcracker on your local Windows 7 or Windows XP box
		
		
		1) Download Wampp. 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 dont 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.
		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 (70.
		NOTE!!! You will lose any local changes you have made if you do step (7) since this a complete re-install of the database. Before doing step (7) either screen print the effects you have modified or better yet, re-enter the changes into the meighan.net database.