/usr/share/SuperCollider/HelpSource/Classes/CheckBadValues.schelp is in supercollider-common 1:3.8.0~repack-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 | class:: CheckBadValues
summary:: Test for infinity, not-a-number, and denormals
categories:: UGens>Info
description::
This link::Classes/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.
classmethods::
method:: ar, kr
argument:: in
the link::Classes/UGen:: whose output is to be tested.
argument:: id
an id number to identify this link::Classes/UGen::. The default is 0.
argument:: post
One of three post modes:
list::
## 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.
examples::
code::
{ 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
::
|