Loris::Breakpoint Class Reference

Class Breakpoint represents a single breakpoint in the Partial parameter (frequency, amplitude, bandwidth) envelope. More...

#include <Breakpoint.h>

List of all members.

Public Member Functions
	Breakpoint (void)
	Construct a new Breakpoint with all parameters initialized to 0 (needed for STL containability).
	Breakpoint (double f, double a, double b, double p=0.)
	Construct a new Breakpoint with the specified parameters.
double	amplitude (void) const
	Return the amplitude of this Breakpoint.
double	bandwidth (void) const
	Return the bandwidth (noisiness) coefficient of this Breakpoint.
double	frequency (void) const
	Return the frequency of this Breakpoint.
double	phase (void) const
	Return the phase of this Breakpoint.
void	setAmplitude (double x)
	Set the amplitude of this Breakpoint.
void	setBandwidth (double x)
	Set the bandwidth (noisiness) coefficient of this Breakpoint.
void	setFrequency (double x)
	Set the frequency of this Breakpoint.
void	setPhase (double x)
	Set the phase of this Breakpoint.
void	addNoiseEnergy (double enoise)
	Add noise (bandwidth) energy to this Breakpoint by computing new amplitude and bandwidth values.

---

Detailed Description

Class Breakpoint represents a single breakpoint in the Partial parameter (frequency, amplitude, bandwidth) envelope.

Instantaneous phase is also stored, but is only used at the onset of a partial, or when it makes a transition from zero to nonzero amplitude.

Loris Partials represent reassigned bandwidth-enhanced model components. A Partial consists of a chain of Breakpoints describing the time-varying frequency, amplitude, and bandwidth (noisiness) of the component. For more information about Reassigned Bandwidth-Enhanced Analysis and the Reassigned Bandwidth-Enhanced Additive Sound Model, refer to the Loris website: www.cerlsoundgroup.org/Loris/.

Breakpoint is a leaf class, do not subclass.

---

Constructor & Destructor Documentation

Loris::Breakpoint::Breakpoint (  double  f, double  a, double  b, double  p = 0. )

Construct a new Breakpoint with the specified parameters. Parameters: f  is the intial frequency. a  is the initial amplitude. b  is the initial bandwidth. p  is the initial phase, if specified (if unspecified, 0 is assumed).

---

Member Function Documentation

void Loris::Breakpoint::addNoiseEnergy (  double  enoise  )

Add noise (bandwidth) energy to this Breakpoint by computing new amplitude and bandwidth values. enoise may be negative, but noise energy cannot be removed (negative energy added) in excess of the current noise energy. Parameters: enoise  is the amount of noise energy to add to this Breakpoint.

void Loris::Breakpoint::setAmplitude (  double  x  )

Set the amplitude of this Breakpoint. Parameters: x  is the new amplitude

void Loris::Breakpoint::setBandwidth (  double  x  )

Set the bandwidth (noisiness) coefficient of this Breakpoint. Parameters: x  is the new bandwidth

void Loris::Breakpoint::setFrequency (  double  x  )

Set the frequency of this Breakpoint. Parameters: x  is the new frequency.

void Loris::Breakpoint::setPhase (  double  x  )

Set the phase of this Breakpoint. Parameters: x  is the new phase.

---