satwarn - triggers warning when input buffer is saturating.
Inputs:
in [BUFFER] [REQUIRED]: input buffer to check. Sampling rate and interpolation are ignored.
Outputs:
out [BUFFER]: passthrough of input. Copies the data pointer from in so all buffer parameters are preserved. Useful when this node is the last of the stack, so that sndc will output the buffer being analyzed.
Go through all samples in the in buffer. Increment a warning counter every time a sample has an absolute value strictly higher that 1. At the end, if the counter is not zero, print a warning in stderr of the form:
<name>: SATURATION WARNING: <n> samples are saturated
Where <name> is the node’s name.