Max/Msp/Jitter to MadMapper

In this tutorial, we will quickly learn how to send Jitter’s output to MadMapper. To share video frames between these applications, we’ll use Syphon, a framework developed by the v002 team.

Note: this tutorial assumes you have some knowledge of how to use Max/Msp/Jitter.

STEP#1
Download the Syphon Max object. You can get it from here http://syphon.v002.info/. The direct download link is http://syphon.v002.info/downloads/Syphon%20for%20Jitter.dmg. If you wish you can also download the patch used in this example.
Once downloaded, make a new folder in your Max/patches folder, where you’ll copy the patches and helpfiles.
Here’s a view of my Max5 folder (normally located in my Applications folder)

STEP#2
Make a simple Jitter patch to playback a movie file. Here, I’ve made a big bang button that triggers a metro object and a read message. The read message uses the built-in countdown.mov quicktime video file. All these are connected to a jit.qt.movie (sized at 320 by 240 pixels), whose output is connected to a jit.pwindow (which is a in-patcher jitter window). Normally, you should see the movie playing. Note that you can send any Jitter matrix to Syphon, such as Jitter GLcontext, not just QuickTime movies.

STEP#3
Send the movie to a Syphon server.
Now it is time to add all the objects necessary for Syphon to send the shared video frames to MadMapper.
So I’ve added:
– a jit.gl.syphonserver object, named JitterOutput, shown in red.
– a jit.gl.videoplane object, to eventually visualize the shared context used by Syphon.
– a jit.window that will receive the Syphon context. It is currently invisible, but present in the patch.
– a jit.gl.render that will actually render the syphon context.
– a FPS counter, to check my framerate.

STEP#4
Now launch MadMapper. Syphon output coming from Jitter should be automatically displayed in the input media list,
under the Syphon section. It is named “JitterOuput” (as we did set it in STEP#3). Now double click it in the list, and it should appear in the input view of MadMapper. The size should be 320 by 240, as set in STEP#2.

STEP#5
Go to the Surface tab and make a Quad primitive. Adjust its size and input cropping portion, using the blue handles. The Quad should now appear in your Preview output on the right side of MadMapper.

STEP#6
Duplicate the selected Quad (Command-D) and make a few copies, adjusting the size and position of each copy.

STEP#7
Now that your connexion is working, minimize MadMapper, and go back to Jitter to start experimenting.
For instance try a Jitter matrix, and fill it with random data. Have fun!