rsc3/doc-schelp/HelpSource/Classes/SinOscFB.scrbl

69 lines
1.3 KiB
Racket

#lang scribble/manual
@(require (for-label racket))
@title{SinOscFB}
Feedback FM oscillator@section{related}
Classes/SinOsc, Classes/FSinOsc, Classes/PMOsc
@section{categories}
UGens>Generators>Deterministic, UGens>Generators>Chaotic
@section{description}
SinOscFB is a sine oscillator that has phase modulation feedback; its output plugs back into the phase input.
Basically this allows a modulation between a sine wave and a sawtooth like wave. Overmodulation causes chaotic oscillation. It may be useful if you want to simulate feedback FM synths.
@section{classmethods}
@section{method}
ar, kr
@section{argument}
freq
The base frequency of the sine oscillator in Hertz.
@section{argument}
feedback
The second argument is the amplitude of phase feedback in radians.
@section{argument}
mul
Output will be multiplied by this value.
@section{argument}
add
This value will be added to the output after any multiplication.
@section{Examples}
@racketblock[
{SinOscFB.ar(440,MouseX.kr(0,4))*0.1}.play
{SinOscFB.ar(MouseY.kr(10,1000,'exponential'),MouseX.kr(0.5pi,pi))*0.1}.play
{SinOscFB.ar(100*SinOscFB.ar(MouseY.kr(1,1000,'exponential'))+200,MouseX.kr(0.5pi,pi))*0.1}.play
// Scope the wave form
{ SinOscFB.ar([400,301], MouseX.kr(0,4),0.3); }.scope;
::
]