subsection:: Disk recording procedure

Recording to disk involves several steps, which should be taken in the right order. link::Classes/Server#-record:: performs these steps for you. To record arbitrary buses using DiskOut explicitly, make sure to do the following:

numberedlist::

## Define a DiskOut link::Classes/SynthDef::, as shown in the example below.

## Allocate a link::Classes/Buffer:: for recording.

list::

## The buffer size should be a power of two.

## A duration of at least one second is recommended: code::s.sampleRate.nextPowerOfTwo::.

## Do not allocate the buffer inside the SynthDef.

## Keep the buffer in a variable.

::

## Specify the file path and recording format using link::Classes/Buffer#-write::, with the teletype::leaveOpen:: flag set to code::true::. This is the only way to set the file path and recording format.

## Create a link::Classes/Synth:: node to run the DiskOut UGen.

## When recording is finished, stop the DiskOut synth.

## Close the buffer: code::b.close::. This step updates the recorded file's audio header. Without it, the file will be unusable.

## Free the buffer: code::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.)

// This does nothing different from the Messaging Style example.

// If any of the following is confusing, stick to Messaging Style

// and ignore this part.