@thi.ng/dsp/curve.d.ts

Composable signal generators, oscillators, filters, FFT, spectrum, windowing & related DSP utils

import { MAdd } from "./madd.js";
/**
 * Returns new {@link MAdd} gen, producing an exponential curve (with adjustable
 * curvature) between `start` and `end` values over `num` steps. This is the
 * exponential equivalent of {@link line}.
 *
 * @remarks
 * Unless `skipFirst` is true (default: false), the `end` value is only reached
 * at `num + 1` steps. Unless `clampEnd` is true (default: false), the curve
 * will NOT stop at `end` but continue indefinitely if more values are requested
 * from the generator.
 *
 * The curvature can be controlled via the logarithmic `rate` param. Recommended
 * range `[0.0001,10000]` (curved -> linear). Default: 0.1
 *
 * Also see {@link madd}.
 *
 * @example
 * ```ts tangle:../export/curve.ts
 * import { curve } from "@thi.ng/dsp";
 *
 * console.log(
 *   curve(-1, 1, 5, 0.1).take(7)
 * );
 * // [
 * //   -1,
 * //   -0.04228753006664476,
 * //   0.4786567612639258,
 * //   0.7620225554764573,
 * //   0.9161583712747458,
 * //   1.0000000000000002,  // target
 * //   1.0456053557111122
 * // ]
 * ```
 *
 * @param start - start value
 * @param end - end value
 * @param num - num steps
 * @param rate - curvature control
 * @param skipFirst - true to skip start value (default: false)
 * @param clampEnd - true to clamp curve at end value (default: false)
 */
export declare const curve: (start: number, end: number, num: number, rate?: number, skipFirst?: boolean, clampEnd?: boolean) => MAdd;
//# sourceMappingURL=curve.d.ts.map