SuperCollider CLASSES

CheckBadValues

Test for infinity, not-a-number, and denormals
Inherits from: UGen : AbstractFunction : Object

Description

This UGen tests for infinity, NaN (not a number), and denormals. If one of these is found, it posts a warning. Its output is as follows: 0 = a normal float, 1 = NaN, 2 = infinity, and 3 = a denormal.

Class Methods

*ar (in: 0, id: 0, post: 2)

*kr (in: 0, id: 0, post: 2)

Arguments:

in

the UGen whose output is to be tested.

id

an id number to identify this UGen. The default is 0.

post

One of three post modes:

  • 0 = no posting;
  • 1 = post a line for every bad value;
  • 2 = post a line only when the floating-point classification changes (e.g., normal -> NaN and vice versa)

The default post mode is 2. Post mode 1 is retained for backward compatibility; be aware that it generates a large amount of output.

Inherited class methods

Instance Methods

Inherited instance methods

Examples

{ CheckBadValues.kr(SinOsc.ar); 0}.play // nothing wrong here

{ CheckBadValues.kr(1 / 0, 1).poll; 0 }.play // check infinity

x = { arg test = -1; CheckBadValues.kr(test); 0 }.play // check NaN
x.set(\test, -1.sqrt);

// don't post, but do something with the output
(
x = { arg freq = 440;
    var good;
    good = BinaryOpUGen('==', CheckBadValues.kr(freq, 0, 0), 0);
    SinOsc.ar(freq, 0, 0.1) * good // silence the output if freq is bad
}.play;
)
x.set(\freq, -1.sqrt);

// the UGen method checkBadValues passes through the input for quick testing
{ SinOsc.ar(440, 0, 0.1).checkBadValues }.play