sfrecord~
Description
Use the sfrecord~ object to record and save MSP output as an audio file.
Examples

Save an audio file containing 'real world' sound and/or sound created in MSP
Arguments
number-of-input-channels [int]
Optional
Sets the number of input channels, which determines the number of inlets that the sfrecord~ object will have. The maximum number of channels is 64, and the default is 1. The audio file created will have the same number of channels as this argument. Whether you can actually record the maximum number of channels is dependent on the speed of your processor and hard disk.
buffer-size [int]
Optional
An optional second argument sets the buffer size. The defult value is 20160.
Attributes
Common Box Attributes
Messages
int
Arguments
recording-start/stop-flag (0 or nonzero)
[int]
In left inlet: If a file has been opened with the sfrecord~ requires another message to record again if a has been sent.
Recording may also stop spontaneously if there is an error, such as running out of space on your hard disk.
message, a non-zero value begins recording, and stops recording and closes the file. Recording may also stop spontaneously if there is an error, such as running out of space on your hard disk.
format
Arguments
bit-depth
[int]
A backwards-compatible message for file format. Use the
message for full soundfile specification. loop
Arguments
looping-flag (0 or 1)
[float]
In left inlet: If a file has been opened with the
message, the word , followed by a number that specifies the loop length in milliseconds, begins recording for the specified amount of time, repeating within the specified area. turns off recording. nchans
Arguments
number-of-channels
[int]
The word
, followed by a number in the range 1-64, sets the number of channels for the audio file to be recorded. The default is 1. open
Arguments
file-type
[symbol]
filename [symbol]
filename [symbol]
In left inlet: Opens a file for recording. By default, the file type is AIFF, but sfrecord~ also supports NeXT/Sun, and WAV formats. The word , without an argument, brings up a standard Save As dialog allowing you to choose a filename. The optional symbols , , , or specify the file format (which can also be set in the Save As dialog with a Format pop-up menu). If is followed by a second symbol, it creates a file in the current default volume. An existing file with the same name will be overwritten. The format symbol (e.g., ) can follow the optional filename argument. If only one argument is given to the message, which is a filename, the file type is determined from the file extension (e.g., "open test.wav" sets the file type to ).
Outputs cryptic status information about the progress of the recording.
record
Arguments
recording-time
[float]
In left inlet: If a file has been opened with the sfrecord~ a in its left init.
message, the word , followed by a time in milliseconds, begins recording for the specified amount of time. The recording can be stopped before it reaches the end by sending resample
Arguments
sampling-rate-coefficient
[float]
The word
, followed by a float, will upsample or downsample the file. Sample rates are expressed as floating-point values - 1.0 is the current sampling rate, 0.5 is half the current, 2.0 is twice the current sample rate, etc. samptype
Arguments
sample-type
[symbol]
byte-swap-flag [int]
byte-swap-flag [int]
In left inlet: The word
: 8-bit integer
: 16-bit integer
: 24-bit integer
: 32-bit integer
: 32-bit floating-point
: 64-bit floating-point
: 8-bit "mu"-law encoding
: 8-bit a-law encoding
The optional second argument, a 0 or 1, specifies whether or not byte-swapping should be used, which is only useful when writing a 'raw' audio file.
, followed by a symbol, specifies the sample type to use when recording the audio file. The following types of sample data are supported: : 8-bit integer
: 16-bit integer
: 24-bit integer
: 32-bit integer
: 32-bit floating-point
: 64-bit floating-point
: 8-bit "mu"-law encoding
: 8-bit a-law encoding
The optional second argument, a 0 or 1, specifies whether or not byte-swapping should be used, which is only useful when writing a 'raw' audio file.
signal
Each inlet of sfrecord~ accepts a signal which is recorded to a channel of an audio file when recording is turned on.
Output
signal
The time, in milliseconds, since recording of the file began. If recording has stopped, the signal value will remain at the length of the last recording until a new recording is started.
See Also
Name | Description |
---|---|
sfplay~ | |
mc.sfplay~ | |
mc.sfrecord~ | |
MSP Sampling Tutorial 6: Record and Play Audio Files | MSP Sampling Tutorial 6: Record and Play Audio Files |