FreqScopeView

Location: NOT INSTALLED!

Description

FreqScopeView shows the frequency spectrum of a specified audio bus.

NOTE: The scope will remain active after a command-period. To turn it off you must use the 'active' method. Very important: You must run kill() when the parent window is closed to avoid problems. It also frees the buffers that the scope allocated and stops the FFT analysis synth. So:

Class Methods

.new

Arguments:

parent	The parent view.
bounds	An instance of Rect, or a Point indicating `width@height`.
server	The server to be shown in scope.

Discussion:

Example:// Start server s.boot; // Create analyzer in a window ( w = Window("My Analyzer", Rect(0, 0, 511, 300)); // width should be 511 f = FreqScopeView(w, w.view.bounds); f.active_(true); // turn it on the first time; w.onClose_({ f.kill }); // you must have this w.front; { SinOsc.ar([500, 1000], 0, 0.25).mean.dup }.play(s); // start two sine waves )

.response

Create a scope in a special frequency-response mode. This uses FFT-based spectral division to estimate the frequency response of some effect, on the assumption that the signal to bus1 is transformed to the signal at bus2 by some linear time-invariant process.

Arguments:

parent	The parent view.
bounds	An instance of Rect, or a Point indicating `width@height`.
bus1	The bus on which the "pre" signal is found.
bus2	The bus on which the "post" signal is found.
freqMode	Linear (0) or log(1) frequency mode. Defaults to 1.

Discussion:

Example:s.boot // basic usage. try these. Each one will open a new window // move the mouse left and right to test response in different ranges LPF.scopeResponse HPF.scopeResponse MoogFF.scopeResponse BBandPass.scopeResponse BLowShelf.scopeResponse // by default BLowShelf doesn't mangle much Resonz.scopeResponse BRF.scopeResponse Integrator.scopeResponse Median.scopeResponse // nonlinear, and therefore interesting // customize the parameters for more informative scoping {|in| MoogFF.ar(in, freq: MouseX.kr(10, 10000, 1), gain:MouseY.kr(4, 0))}.scopeResponse

Subclassing and Internal Methods

The following methods are usually not used directly or are called by a primitive. Programmers can still call or override these as needed.

Inherited class methods

Instance Methods

.kill

Very important. This must be run when the parent window is closed to avoid problems. It also frees the buffers that the scope allocated and stops the FFT analysis synth.

.active

Turn the scope on or off.

Arguments:

bool	An instance of Boolean.

.freqMode

Arguments:

mode	0 = linear, 1 = logarithmic.

.inBus

The bus to listen on.

Arguments:

num	An audio Bus number.

.dbRange

Get/set the amplitude range.

Arguments:

A Number.

.special

Put the scope into a special mode using a user-specified SynthDef. Note that only very particular SynthDefs should be used, namely ones that are derived from the \freqScope0 or \freqScope1 SynthDefs. Most users will not need to use this method directly, but it can be used to provide a customised analysis shown in the scope.

Arguments:

defname	Name of the SynthDef you wish to use.
extraArgs	Extra arguments that you may wish to pass to the synth.

.new

Arguments:

Discussion:

.response

Arguments:

Discussion:

.kill

.active

Arguments:

.freqMode

Arguments:

.inBus

Arguments:

.dbRange

Arguments:

.special

Arguments:

.server

.synth

.scope

.scopebuf

.initFreqScope

.doesNotUnderstand

.start

.allocBuffers

.freeBuffers

.bufSize

.doOnServerQuit

.doOnServerTree

.shmScopeAvailable

.specialSynthArgs

.specialSynthDef