Classes | Public Member Functions | Protected Member Functions | Protected Attributes | List of all members
EnvelopeModulator Class Referenceabstract

A EnvelopeModulator is a base class for all envelope-type modulators. More...

Inheritance diagram for EnvelopeModulator:
Modulator VoiceModulation TimeModulation Processor Modulation Modulation SafeChangeBroadcaster RestorableObject ControlledObject Dispatchable AhdsrEnvelope ModulatorChain MonophonicEnvelope MPEModulator SimpleEnvelope TableEnvelope

Classes

struct  ModulatorState
 A ModulatorState is a container for Modulator states in a polyphonic TimeVariantModulator. More...
 

Public Member Functions

virtual bool isPlaying (int voiceIndex) const =0
 Checks if the Envelope is active for the given voice. More...
 
virtual void reset (int voiceIndex)
 Overwrite this to reset the envelope. More...
 
- Public Member Functions inherited from Modulator
virtual int getNumChildProcessors () const override
 Normally a Modulator has no child processors, you can overwrite it if you use internal chains. More...
 
 Modulator (MainController *m, const String &id, int numVoices)
 Creates a new modulator with the given Identifier. More...
 
virtual void setColour (Colour c)
 Sets the colour of the modulator. More...
 
- Public Member Functions inherited from Processor
virtual ProcessorEditorBodycreateEditor (ProcessorEditor *parentEditor)=0
 Creates a ProcessorEditor for this Processor and returns the pointer. More...
 
void enableConsoleOutput (bool shouldBeEnabled)
 Enables the Processor to output messages to the Console. More...
 
virtual ProcessorgetChildProcessor (int processorIndex)=0
 This must be overriden by every Processor and return the Chain with the Chain index. More...
 
bool getEditorState (int state) const
 Restores the state of the Processor's editor. More...
 
const String & getId () const
 Returns the unique id of the Processor instance (!= the Processor name). More...
 
virtual Identifier getIdentifierForParameterIndex (int parameterIndex) const
 This returns a Identifier with the name of the parameter. More...
 
float getInputValue () const
 This can be used to display the Processors input value. More...
 
int getLargestBlockSize () const
 Returns the block size. More...
 
virtual const String getName () const
 Overwrite this and return a pretty name. More...
 
virtual int getNumInternalChains () const
 If your processor uses internal chains, you can return the number here. More...
 
int getNumParameters () const
 This returns the number of (named) parameters. More...
 
float getOutputValue () const
 This can be used to display the Processors output value. More...
 
double getSampleRate () const
 Returns the sample rate. More...
 
const Path getSymbol () const
 Returns the symbol of the Processor. More...
 
virtual const Identifier getType () const =0
 Overwrite this method to specify the name. More...
 
int getVoiceAmount () const noexcept
 getNumVoices() is occupied by the Synthesiser class, d'oh!
 
bool isBypassed () const noexcept
 Returns true if the processor is bypassed. More...
 
 Processor (MainController *m, const String &id_, int numVoices)
 Creates a new Processor with the given Identifier. More...
 
void restoreCompleteEditorState (const XmlElement *storedState)
 Restores the EditorState from a BigInteger that was retrieved using getCompleteEditorState. More...
 
void setAttribute (int parameterIndex, float newValue, juce::NotificationType notifyEditor)
 Changes a Processor parameter. More...
 
virtual void setBypassed (bool shouldBeBypassed, NotificationType notifyChangeHandler=dontSendNotification) noexcept
 This bypasses the processor. More...
 
void setEditorState (int state, bool isOn, NotificationType notifyView=sendNotification)
 Saves the state of the Processor's editor. More...
 
void setIsOnAir (bool isBeingProcessedInAudioThread)
 Call this method after inserting the processor in the signal chain. More...
 
void setSymbol (Path newSymbol)
 Sets a special symbol for the Processor. More...
 
virtual ~Processor ()
 Overwrite this if you need custom destruction behaviour. More...
 
- Public Member Functions inherited from SafeChangeBroadcaster
void addChangeListener (SafeChangeListener *listener)
 Registers a listener to receive change callbacks from this broadcaster. More...
 
void removeAllChangeListeners ()
 Removes all listeners from the list. More...
 
void removeChangeListener (SafeChangeListener *listener)
 Unregisters a listener from the list. More...
 
void sendAllocationFreeChangeMessage ()
 This will send a message without allocating a message slot. More...
 
void sendChangeMessage (const String &=String())
 Causes an asynchronous change message to be sent to all the registered listeners. More...
 
void sendSynchronousChangeMessage ()
 Sends a synchronous change message to all the registered listeners. More...
 
- Public Member Functions inherited from ControlledObject
 ControlledObject (MainController *m)
 Creates a new ControlledObject. More...
 
const MainControllergetMainController () const noexcept
 Provides read-only access to the main controller. More...
 
MainControllergetMainController () noexcept
 Provides write access to the main controller. More...
 
- Public Member Functions inherited from Modulation
void applyModulationValue (float calculatedModulationValue, float &destinationValue) const noexcept
 This applies the previously calculated value to the supplied destination value depending on the modulation mode (adding or multiplying). More...
 
float calcIntensityValue (float calculatedModulationValue) const noexcept
 This applies the intensity to the given value and returns the applied value. More...
 
float getDisplayIntensity () const noexcept
 Returns the actual intensity of the Modulation. More...
 
float getIntensity () const noexcept
 Returns the intensity. More...
 
Mode getMode () const noexcept
 returns the mode the Modulator is operating. More...
 
void setIntensity (float newIntensity) noexcept
 Sets the intensity of the modulation. More...
 
void setIntensityFromSlider (float sliderValue) noexcept
 Use this method to set the intensity from the ModulatorEditorHeader's intensity slider converting linear -12 ... More...
 
- Public Member Functions inherited from TimeModulation
void applyTimeModulation (float *destinationBuffer, int startIndex, int samplesToCopy)
 This applies the intensity to the calculated values. More...
 
virtual void calculateBlock (int startSample, int numSamples)=0
 This calculates the time modulated values and stores them in the internal buffer.
 
virtual const float * getCalculatedValues (int)
 Returns a read pointer to the calculated values. More...
 

Protected Member Functions

virtual ModulatorStatecreateSubclassedState (int) const =0
 Overwrite this method and return a newly created ModulatorState of the desired subclass. More...
 
- Protected Member Functions inherited from Processor
void setInputValue (float newValue, NotificationType notify=sendNotification)
 Call this from the baseclass whenever you want its editor to display a input value change. More...
 
void setOutputValue (float newValue)
 Call this from the baseclass whenever you want its editor to display a value change. More...
 
- Protected Member Functions inherited from TimeModulation
void applyGainModulation (float *calculatedModulationValues, float *destinationValues, float fixedIntensity, int numValues) const noexcept
 a vectorized version of the calcIntensityValue() and applyModulationValue() for Gain modulation with a fixed intensity value. More...
 
void applyGainModulation (float *calculatedModulationValues, float *destinationValues, float fixedIntensity, const float *intensityValues, int numValues) const noexcept
 A vectorized version of the calcIntensityValue() and applyModulationValue() for Gain modulation with varying intensities. More...
 
void applyPitchModulation (float *calculatedModulationValues, float *destinationValues, float fixedIntensity, const float *intensityValues, int numValues) const noexcept
 A vectorized version of the calcIntensityValue() and applyModulationValue() for Pitch modulation with varying intensities. More...
 
void applyPitchModulation (float *calculatedModulationValues, float *destinationValues, float fixedIntensity, int numValues) const noexcept
 a vectorized version of the calcIntensityValue() and applyModulationValue() for Pitch modulation with a fixed intensity value. More...
 
virtual bool isInitialized ()
 Checks if the prepareToPlay method has been called. More...
 
virtual void prepareToModulate (double, int samplesPerBlock)
 Creates the internal buffer with double the size of the expected buffer block size.
 

Protected Attributes

OwnedArray< ModulatorStatestates
 Use this array to access the state. More...
 

Additional Inherited Members

- Public Types inherited from Processor
enum  InternalChains
 Overwrite this enum and list all internal chains. More...
 
enum  SpecialParameters
 Overwrite this enum and add new parameters. More...
 
- Public Types inherited from Modulation
enum  Mode { GainMode = 0, PitchMode, PanMode }
 There are two modes that Modulation can work: GainMode and PitchMode. More...
 

Detailed Description

A EnvelopeModulator is a base class for all envelope-type modulators.

It is basically a TimeVariantModulator with two additional features:

  1. Polyphony - multiple states are allowed. See ModulatorStates for more information.
  2. Release Trail - prevent note from stopping until the release phase is finished.

Member Function Documentation

virtual ModulatorState* createSubclassedState ( int  ) const
protectedpure virtual

Overwrite this method and return a newly created ModulatorState of the desired subclass.

It will be owned by the Modulator.

virtual bool isPlaying ( int  voiceIndex) const
pure virtual

Checks if the Envelope is active for the given voice.

Overwrite this and return true as long as you want the envelope to sound.

Implemented in ModulatorChain, TableEnvelope, and AhdsrEnvelope.

virtual void reset ( int  voiceIndex)
inlinevirtual

Overwrite this to reset the envelope.

If you want to have the display resetted, call this method from your subclass.

Reimplemented in ModulatorChain.

Member Data Documentation

OwnedArray<ModulatorState> states
protected

Use this array to access the state.

©2017 HISE. This documentation is autogenerated from the HISE source code using Doxygen.