Sets target values for selected coefficients within a valid single-precision multichannel biquad IIR filter object. Filter coefficients are given in single precision. Each selected coefficient is incremented at each sample until the difference between its value and the target value is less than a specified threshold.
- iOS 9.0+
- macOS 10.11+
- Mac Catalyst 13.0+
- tvOS 9.0+
- watchOS 2.0+
The filter state object whose coefficients are to be updated.
An input array of single-precision target values to be applied to selected coefficients.
The rate constant: This determines the size of increments to the coefficient values (see Discussion). The value must satisfy the condition 0 <= rate <= 0; if this condition is not met, behavior is undefined.
The threshold constant: This determines how close a coefficient’s value must be to the target value before incrementation stops (see Discussion). The value must satisfy the condition threshold > 0; if this condition is not met, behavior is undefined.
First section to update in each channel.
First channel to update.
Number of sections to update in each channel.
Number of channels to update.
The existing setup is modified by applying the target values in
coeffs to the specified ranges of channels and sections. Which coefficients are changed depends on the last four parameters. At each sample, a coefficient’s value is incremented until the difference between its value and the target value is less than the specified
threshold constant. The size of the increment for each selected coefficient is a function of the
rate constant and the difference between the target value and the initial value.
This function does not allocate any additional memory.
coeffs array contains only the new target values, laid out in the same way as the original array of coefficients – as if laying out original coefficients for
nsec sections in
nchn channels. See discussion for