Record to a soundfile to disk. Uses a Buffer.
See RecordBuf for recording into a buffer in memory.
Recording to disk involves several steps, which should be taken in the right order. Server: -record performs these steps for you. To record arbitrary buses using DiskOut explicitly, make sure to do the following:
s.sampleRate.nextPowerOfTwo.leaveOpen flag set to true. This is the only way to set the file path and recording format.b.close. This step updates the recorded file's audio header. Without it, the file will be unusable.b.free.These steps are illustrated in the Examples section. In general, only the "Object Style" approach is needed. ("Messaging Style" is provided as a historical reference, but it isn't needed for typical use.)
| bufnum |
The number of the buffer to write to (prepared with /b-write or Buffer.write) NOTE: The Buffer's numFrames must be a power of two and is recommended to be at least 65536 -- preferably 131072 or 262144. Smaller buffer sizes mean more frequent disk access, which can cause glitches. |
| channelsArray |
The Array of channels to write to the file. NOTE: The number of channels in the buffer and the channelsArray must be the same, otherwise DiskOut will fail silently (and not write anything to your file). |
The number of frames written to disk.
s.boot; // start the server(// something to recordSynthDef("bubbles", { |out| var f, zout; f = LFSaw.kr(0.4, 0, 24, LFSaw.kr([8,7.23], 0, 3, 80)).midicps; // glissando function zout = CombN.ar(SinOsc.ar(f, 0, 0.04), 0.2, 0.2, 4); // echoing sine wave Out.ar(out, zout)}).add;// this will record to the diskSynthDef("help-Diskout", { |bufnum| DiskOut.ar(bufnum, In.ar(0,2));}).add;// this will play it backSynthDef("help-Diskin-2chan", { |out, bufnum = 0| Out.ar(out, DiskIn.ar(2, bufnum))}).add;)xxxxxxxxxx// start something to recordx = Synth("bubbles");// allocate a disk i/o bufferb= Buffer.alloc(s, 65536, 2);// create an output file for this buffer, leave it openb.write("~/diskouttest.wav".standardizePath, "wav", "int16", 0, 0, true);// create the diskout node; making sure it comes after the sourced = Synth.tail(nil, "help-Diskout", ["bufnum", b]);// stop recordingd.free;// stop the bubblesx.free;// close the buffer and the soundfileb.close;// free the bufferb.free;// play it back(x = Synth.basicNew("help-Diskin-2chan");m = { |buf| x.addToHeadMsg(nil, [\bufnum,buf])};b = Buffer.cueSoundFile(s,"~/diskouttest.wav".standardizePath, 0, 2, completionMessage: m);)x.free; b.close; b.free; // cleanupxxxxxxxxxx// The same thing done in Messaging Style (less overhead but without the convenience of objects)// This does nothing different from the Messaging Style example.// If any of the following is confusing, stick to Object Style// and ignore this part.// start something to records.sendMsg("/s_new", "bubbles", 2003, 1, 1);// allocate a disk i/o buffers.sendMsg("/b_alloc", 0, 65536, 2); // Buffer number is 0// create an output file for this buffer, leave it opens.sendMsg("/b_write", 0, "~/diskouttest.wav".standardizePath, "wav", "int16", 0, 0, 1);// create the diskout nodes.sendMsg("/s_new", "help-Diskout", 2004, 3, 2003, "bufnum", 0);s.sendMsg("/n_free", 2004); // stop recordings.sendMsg("/n_free", 2003); // stop the bubbless.sendMsg("/b_close", 0); // close the file.s.sendMsg("/b_free", 0);