How to Run the Fluid Sim

** Opening the Fluid Sim - Kinect Version

- Make sure your Kinect camera is plugged in.
- Go to the 'openni' folder and run 'openNISample007Debug'.  This should bring up a window showing you what Kinect can see.
- Go to the 'fluid-kinect' folder and run 'emptyExampleDebug'.  This should open up the fluid simulation.
- Make sure you have the fluid simulation open and hit 'f' to go full screen.  If you have a projector connected you can drag the window to the projector screen first and then go full screen.

** Opening the Fluid Sim - IR Camera Version

- Make sure the camera is plugged in to the firewire port of your computer.  (It won't work with non-firewire cameras.)
- Go to the 'fluid-ir-camera' folder and run the 'firewire-camera-fluid' application.
- If necessary you can move the corners of the red box around the left-most camera view to crop what the camera sees.
- Once the camera is in position and you've set up the cropping, hit 's' to take a snapshot of the background.  This is a bit like calibrating the camera so it only sees things which are not part of the background scene that people are moving within.
- To make sure the fluid sim fills the screen, hit 'w' and enter the resolution of your screen and the projector.  You might need to go to System Preferences -> Displays to find out what these are.
- Hit 'f' to go full screen.

** Opening the Fluid Sim Controller
The fluid sim has lots of parameters that you can change.  The application that lets you do this run separately.  To run it:

- Make sure Pure Data Extended (aka 'Pd-extended') is installed in your 'Applications' folder.  If not, you can download it here: http://puredata.info/downloads/pd-extended
- Go to the 'data' folder inside the 'fluid-ir-camera' OR 'fluid-kinect' folders, depending on which version you are using.
- Double click on 'fluid-sim-gui.pd'.  This should open the controller for the fluid inside Pure Data Extended.
- Move the sliders and click buttons to change the behaviour and look of the fluid.