Active Visualiser by Timbo_KZ. Demo on YouTube.

This project uses Java SDK 1.7. You will need Beads Project, LWJGL 2.9.1 and Slick.

First of all, make sure all dependencies are installed and the Core class is the main class.

For Active Visualiser to run correctly, you must add a path to LWJGL natives, which are usually found in LWJGL archive. This is done by specifying appropriate VM options before running the application. I'm using Windows and path to Windows natices on my system is D:\Workspaces\Java\Libraries\lwjgl-2.9.1\native\windows, so my VM options look like this:

-Djava.library.path="D:\Workspaces\Java\Libraries\lwjgl-2.9.1\native\windows"

At this point in time, if everything was done correctly, you should be able to run the visualiser without any issues. You can test that all default render modes work by pressing buttons 1-5 and T to run the test mode. Pressing F should display the name of the render mode and the current frame rate. Hover the bottom of the window to reveal the progress bar. Clicking at any point on the progress bar will play the audio from that point.

Additionally, you can configure the visualiser by specifying program arguments. Table of all possible program arguments can be found below, but keep in mind none of them are required for the app to run.

Examples of different configurations:

1. Create a class in RenderModes package that extends RenderMode, example:

   public class Your_Visualiser extends RenderMode {
   
       public Your_Visualiser(String name, int key) {
           super(name, key);
       }
   
       public void render(float delta) {
   
               Core.initGL();
   
               float[] values = Core.getValues(0);
               float[] bassValues = Core.getValues(20);
   
               float mean = 0;
               float bassMean = 0;
               for (float i = 0.0f; i < 512.0f; i++) {
                   mean += values[(int) i];
                   bassMean += bassValues[(int) i];
               }
               mean /= 512.0f;
               bassMean /= 512.0f;
   
               // Any code for drawing here
   
       }
   
   }

2. Register your render mode inside initRenderModes method in the Core class. The method will look something like this:

   // ....
   
   private static void initRenderModes() {
       renderModes = new ArrayList<RenderMode>();
   
       // Registering new render modes
       renderModes.add(new Pulse("Pulse", Keyboard.KEY_1));
       renderModes.add(new ShaderTest("Shader Test", Keyboard.KEY_5));
       renderModes.add(new Blur("Blur", Keyboard.KEY_4));
       renderModes.add(new Twist("Twist", Keyboard.KEY_3));
       renderModes.add(new Flow("Flow", Keyboard.KEY_2));
       renderModes.add(new Test("Test", Keyboard.KEY_T));
   
       if(renderModes.size() == 0) {
           System.out.println("No render modes available.");
           System.exit(1);
       }
   
       currentRenderMode = renderModes.get(0);
   }
   
   // ....

   You will need to add an object of your visualiser to the renderModes list. The first parameter is the name of the visualiser, the second parameter is the keyboard key assigned to your visualiser. The line you'd add should look something like this:

   renderModes.add(new Your_Visualiser("Your Visualiser", Keyboard.KEY_6));

   Now you can see your render mode by launching the visualiser and pressing the key you assigned, in this case it's 6.