Darwin Grosse

Talking with the editor (Gregory), we decided that putting together a series on JavaScript would be a great addition to the newsletter. First, it gives us a chance to talk through problems that might be difficult to solve with standard Max. Secondly, JavaScript is clearly going to become more important with the upcoming release of Max 8, since Node (an advanced JavaScript runtime) will be integrated as part of that release. Finally, the Max-JavaScript link is a fun intermediate-to-advanced subject, and we can do some pretty crazy stuff with it. So it was decided: let’s give it a try!

For this first article, we are going to dive into something that I touched on in an earlier newsletter article: the JavaScript audio buffer object. We used it in the 

 last year, and there was a lot of interest in the project. But one of the tools that made the project sing is the Buffer object provided by the 

Let’s start by creating a simple patch with a 

jsing-001001.png

Save the patch, then double-click on the 

 object and enter in the following JavaScript code:

// Get some info from a buffer~
//

var buff = new Buffer("loop");

function bang() {
    post("Channels: " + buff.channelcount() + '\n');
    post("Frames (samples): " + buff.framecount() + '\n');
    post("Length (in ms): " + buff.length() + '\n');
}

When you are done, make sure you save it in the same location as the patch – this way, the patch will always be able to find the JavaScript file.

All we are doing here is querying the named buffer to find out the number of channels and length (in frames/samples and milliseconds). We use the 

 command to display the results to the Max Window (along with the required newlines…), and that’s about it.

Finding out the number of channels is something the

 object can do for us, so that isn’t much fun, is it? Let’s dig a little deeper by manipulating the contents of our buffer. In my case, I'll add the code to a new file (in this case, named reverseLoop.js), but you could add the code to your existing JavaScript file. Start by creating a function that listens for the “reverse” message, and reverses the buffer. :

Then we modify our patch to send the reverse message:

jsing-001002.png

Play the file, then reverse it, then reverse it again. You should be back to the original. Innocuous, but it starts implying some of the fun we can have. Let’s change this a little so that we have a new message “scramble”:

jsing-001003.png

When we get the message, we will reverse a small portion of the file. To do this, we will make a generic reversing function, and a global function to respond to the scramble message:

You’ll notice that I take some steps to make sure that the incoming message checks for arguments, and if none are available (or they are invalid), we properly handle the situation. With these additions, each time I scramble the buffer the contents will get weirder. And there’s no going back – which might be one of the hallmarks of a great audio effect!

Since we are already tiptoeing into glitch territory, we might as well go all-in. Let’s respond to another message – glitch – by having it generate dropouts in the buffer:

In this case, I’m looking for the number of dropouts to introduce, and a ‘factor’ that represents the amount of the file (from 0.0 to 1.0) of the file to affect. With a slight tweak to the patch, we are ready to go:

jsing-001004.png

At this point, I’m sure you can imagine volume adjustments, re-mappings and other buffer-based applications that could tweak the daylights out of your buffers. And, when things get too messy, you can always just reload the buffer with the original file – returning you to a blank canvas!

Virtually everything we’ve done is based on the JavaScript in Max Guide’s 

 object reference, available in the application documentation or online:

https://docs.cycling74.com/max7/vignettes/jsbuffer

If you want to see how I used it for manipulating live sampled content, you can check out the ROBO series I did last year:

https://cycling74.com/tutorials/the-compleat-robo-part-1-an-overview-and-the-midi-system

And, as always, there is a ton of information on programming in JavaScript on the Internet, at your library and your local book shop.

So, hopefully you can see how, with direct buffer manipulation, we are able to make some pretty serious changes to the file contents without having to touch the file itself. We can also mess things up in as creative of a way as we can imagine, so start imagining! Once you start coding, there is no end to the mess you can make.

For this first article, we are going to dive into something that I touched on in an earlier newsletter article: the JavaScript audio buffer object. We used it in the ROBO Sampling series last year, and there was a lot of interest in the project. But one of the tools that made the project sing is the Buffer object provided by the js object.

Let’s start by creating a simple patch with a buffer~, a playback system and a bang->js combo:

Save the patch, then double-click on the js object and enter in the following JavaScript code:

// Get some info from a buffer~
//

var buff = new Buffer("loop");

function bang() {
	post("Channels: " + buff.channelcount() + '\n');
	post("Frames (samples): " + buff.framecount() + '\n');
	post("Length (in ms): " + buff.length() + '\n');
}

All we are doing here is querying the named buffer to find out the number of channels and length (in frames/samples and milliseconds). We use the post command to display the results to the Max Window (along with the required newlines…), and that’s about it.

Finding out the number of channels is something the info~ object can do for us, so that isn’t much fun, is it? Let’s dig a little deeper by manipulating the contents of our buffer. In my case, I'll add the code to a new file (in this case, named reverseLoop.js), but you could add the code to your existing JavaScript file. Start by creating a function that listens for the “reverse” message, and reverses the buffer. :

Virtually everything we’ve done is based on the JavaScript in Max Guide’s Buffer object reference, available in the application documentation or online:

javascript-tutorial1.png

Welcome to the first in a series on JavaScript programming for Max users, where we’ll be looking at some problems that might be difficult to solve with standard Max objects. In addition, JavaScript is going to become more important with the upcoming release of Max 8, since Node (an advanced JavaScript runtime) will be integrated as part of that release. Finally, the Max-JavaScript link is a fun intermediate-to-advanced subject, and we can do some pretty crazy stuff with it.

javascripting-the-buffer-object

Darwin, Everything works perfectly until here 

"Then we modify our patch to send the reverse message:" 

You make a new object called "js reverseLoop.js"

When I do that it's "not found" by the Console

Then if I ignore that message and go back to "js checkLoop.js" it works anyway.

But when I add scramble and scramble 5, scramble doesn't glitch the rhythm, but scramble 5 does.

I say this as a former professional drummer - so I think I know what it should sound like :) 

Can you explain? Do I need 2 objects in the patch - one called "js checkLoop.js" and another called "js reverseLoop.js"? 

Darwin, Everything works perfectly until here 
"Then we modify our patch to send the reverse message:" 
You make a new object called "js reverseLoop.js"
When I do that it's "not found" by the Console
Then if I ignore that message and go back to "js checkLoop.js" it works anyway.
But when I add scramble and scramble 5, scramble doesn't glitch the rhythm, but scramble 5 does.
And I can't stop it from scrambling.
I say this as a former professional drummer - so I think I know what it should sound like :) 
Can you explain? Do I need 2 objects in the patch - one called "js checkLoop.js" and another called "js reverseLoop.js"? 
Or what?

Thanks!


Sorry - I just renamed checkLoop.js to reverseLoop.js so that I could keep each version around. You can either keep modifying the checkLoop.js file, or create new js entries with new file names, and copy in the old contents...

Here are the three Javascript files I created - see how they compare to yours!

checkLoop.js

reverseLoop.js

scrambleLoop.js

glitchLoop.js

As someone who does a lot of JS for work, I haven't applied it to Max yet. So thank you, Darwin, for putting this out there! This is going to be fun!

As someone who does a lot of JS for work, I haven't applied it to Max yet.  So thank you, Darwin, for putting this out there!  This is going to be fun!

I'm already looking forward to episode 2!

I wonder why "The Buffer Object" entry never appeared under the "See also" section on the "buffer~" reference page...

edit:
I wonder why "The Buffer Object" entry never appeared under the "See also" section on the "buffer~" reference page...

I'm using JS with buffer since it has been allowed and I used it for a bunch of processes. It works very fine.

It is the easiest way I found, ALL other included.

I'm currently using it for sonifying tides and make a secret piece for SHOUTING about climate change...

I'm using JS with buffer since it has been allowed and I used it for a bunch of processes. It works very fine.
It is the easiest way I found, ALL other included.
I'm currently using it for sonifying tides and make a secret piece for SHOUTING about climate change...

This sounds awesome, Julien. Hope you are able to share soon!

We are trying to partner with IGN in France.

Actually, Marseille got the Marégraphe. Which was the place where the zero reference for altimetry have been done. Very symbolic, for me.

We are currently dealing with DC offset, normalization of data or not etc. And I obviously, let you know :-)

data_ign_climate.png

We are looking for commissioning. 
We are trying to partner with IGN in France.
Actually, Marseille got the Marégraphe. Which was the place where the zero reference for altimetry have been done. Very symbolic, for me.

JavaScripting: The Buffer Object