Home   Information   Classes   Download   Usage   Mail List   Requirements   Links   Tutorial


DelayL Class Reference

#include <DelayL.h>

Inheritance diagram for DelayL:

Delay Filter Stk List of all members.

Detailed Description

STK linear interpolating delay line class.

This Delay subclass implements a fractional- length digital delay-line using first-order linear interpolation. A fixed maximum length of 4095 and a delay of zero is set using the default constructor. Alternatively, the delay and maximum length can be set during instantiation with an overloaded constructor.

Linear interpolation is an efficient technique for achieving fractional delay lengths, though it does introduce high-frequency signal attenuation to varying degrees depending on the fractional delay setting. The use of higher order Lagrange interpolators can typically improve (minimize) this attenuation characteristic.

by Perry R. Cook and Gary P. Scavone, 1995 - 2004.

Definition at line 30 of file DelayL.h.

Public Member Functions

 DelayL ()
 Default constructor creates a delay-line with maximum length of 4095 samples and zero delay.

 DelayL (StkFloat delay, unsigned long maxDelay)
 Overloaded constructor which specifies the current and maximum delay-line lengths.

 ~DelayL ()
 Class destructor.

void setDelay (StkFloat delay)
 Set the delay-line length.

StkFloat getDelay (void) const
 Return the current delay-line length.

StkFloat nextOut (void)
 Return the value which will be output by the next call to tick().

StkFloat tick (StkFloat sample)
 Input one sample to the delay-line and return one output.

virtual StkFloat * tick (StkFloat *vector, unsigned int vectorSize)
 Input vectorSize samples to the delay-line and return an equal number of outputs in vector.

virtual StkFramestick (StkFrames &frames, unsigned int channel=1)
 Take a channel of the StkFrames object as inputs to the delayline and replace with corresponding outputs.


Constructor & Destructor Documentation

DelayL::DelayL StkFloat  delay,
unsigned long  maxDelay
 

Overloaded constructor which specifies the current and maximum delay-line lengths.

An StkError will be thrown if the delay parameter is less than zero, the maximum delay parameter is less than one, or the delay parameter is greater than the maxDelay value.


Member Function Documentation

void DelayL::setDelay StkFloat  delay  ) 
 

Set the delay-line length.

The valid range for theDelay is from 0 to the maximum delay-line length.

StkFloat DelayL::nextOut void   )  [virtual]
 

Return the value which will be output by the next call to tick().

This method is valid only for delay settings greater than zero!

Reimplemented from Delay.

virtual StkFrames& DelayL::tick StkFrames frames,
unsigned int  channel = 1
[virtual]
 

Take a channel of the StkFrames object as inputs to the delayline and replace with corresponding outputs.

The channel argument should be one or greater (the first channel is specified by 1). An StkError will be thrown if the channel argument is zero or it is greater than the number of channels in the StkFrames object.

Reimplemented from Delay.


The documentation for this class was generated from the following file:
The Synthesis ToolKit in C++ (STK)
©1995-2004 Perry R. Cook and Gary P. Scavone. All Rights Reserved.