User manual · Objects & Properties
Oscillator
The Oscillator is used to induce vibration based on a waveform in each Body or Resonator that is connected to it via an Exciter Link. The orientation of the Oscillator controls the direction in which each object is vibrated.
The settings every Exciter shares (its MIDI note, Mode, Velocity, Orientation and Position) are described on the Exciter & Exciter Link page. When a new note starts on a voice that is still sounding, the Oscillator fades from the old note's waveform and loudness to the new one's over a few milliseconds, so fast repeated notes don't click, and a soft note after a loud one fades in smoothly.
Video tutorial · 2:54
Oscillator Properties#
- Gain: The amount of gain that will be applied to the Oscillator waveform before it is applied as a directional force to connected objects.
- Shape: The type of waveform that this Oscillator will generate: Sine, Triangle, Sawtooth, Square, White Noise, Sample & Hold, Sample & Interpolate Smooth, or Sample & Interpolate Linear. The Sawtooth, Square and Triangle waves are band-limited, so they stay clean on high notes instead of turning gritty. The randomize button beside the drop-down picks a different shape for each selected Oscillator, rolled separately, so a group of them ends up with a mixture of shapes. White Noise has no pitch, so the pitch and phase properties below are hidden for it.
- Octave: The number of octaves by which to raise or lower the pitch of the Oscillator.
- Semitone: The number of semitones (interval) by which to raise or lower the pitch of the Oscillator.
- Detune: The number of cents by which to raise or lower the pitch of the Oscillator.
- Pulse Width: When the Shape is set to Square, this is the duty cycle of the wave, or the fraction of time that it is positive. If a Modulator is attached to this Oscillator, this can be modulated for PWM. Shown only for the Square shape.
- Phase: Where the waveform starts each note. When a note is triggered, Free ignores it and keeps running, as an analog oscillator does, so repeated notes differ a little. Retrigger restarts it at the Retrigger Phase, for the same attack every time, and Random restarts it somewhere new. The randomize button beside the drop-down picks a random phase mode for each selected Oscillator.
- Retrigger Phase: The phase a retriggered note begins at, as a fraction of the cycle. 0 is a sawtooth's edge and a square's step, the hard start; a sawtooth crosses zero at 0.5, a triangle at 0.25 and a sine at 0. Modulated, it wraps around the cycle, so velocity or an LFO can give each note its own start. Shown only when Phase is Retrigger.
- Use Dilated Time: Normally the Oscillator's output waveform speed is scaled based on what MIDI note is being played, with higher notes running faster. If this option is disabled, the Oscillator waveform will run at a constant rate regardless of the note. This is useful for drones and other effects.
Envelope#
- Envelope graph: Drag the points to set the attack, decay, sustain and release, and drag the hollow handle on a stage up or down to curve it. When several Oscillators are selected, a drag moves every selected envelope by the same amount; hold Alt to give them all the dragged value. Double-click a hollow handle to straighten its stage.
- Attack: When the MIDI note is pressed, this is the duration it takes for the envelope to increase from minimum to maximum gain.
- Decay: After the attack phase of the envelope is finished, this is the duration it takes for the envelope to drop from full gain to sustain gain.
- Sustain: After the decay phase of the envelope is finished, this is the fraction of maximum gain that the envelope will sustain.
- Release: When the MIDI note is released, this is the duration it takes for the envelope to decrease from sustain gain to minimum gain.
- Attack Curve: (On the graph) The attack's curvature: 0 rises in a straight line, below 0 rises fast and then slows, above 0 rises slowly and then fast.
- Decay Curve: (On the graph) The decay's curvature: 0 falls in a straight line, below 0 falls fast and then slows, as an analog envelope does, above 0 falls slowly and then fast.
- Release Curve: (On the graph) The release's curvature: 0 falls in a straight line, below 0 falls fast and then slows, as an analog envelope does, above 0 falls slowly and then fast.