Loading...
Searching...
No Matches
juce::SamplerVoice Class Reference

`#include <juce_Sampler.h>`

Inheritance diagram for juce::SamplerVoice:

## Public Member Functions

| SamplerVoice ()
| ~SamplerVoice () override
bool | canPlaySound (SynthesiserSound *) override
void | startNote (int midiNoteNumber, float velocity, SynthesiserSound *, int pitchWheel) override
void | stopNote (float velocity, bool allowTailOff) override
void | pitchWheelMoved (int newValue) override
void | controllerMoved (int controllerNumber, int newValue) override
void | renderNextBlock (AudioBuffer< float > &, int startSample, int numSamples) override
virtual void | renderNextBlock (AudioBuffer< double > &outputBuffer, int startSample, int numSamples)
Public Member Functions inherited from juce::SynthesiserVoice
| SynthesiserVoice ()
virtual | ~SynthesiserVoice ()
int | getCurrentlyPlayingNote () const noexcept
SynthesiserSound::Ptr | getCurrentlyPlayingSound () const noexcept
virtual bool | isVoiceActive () const
virtual void | aftertouchChanged (int newAftertouchValue)
virtual void | channelPressureChanged (int newChannelPressureValue)
virtual void | setCurrentPlaybackSampleRate (double newRate)
virtual bool | isPlayingChannel (int midiChannel) const
double | getSampleRate () const noexcept
bool | isKeyDown () const noexcept
void | setKeyDown (bool isNowDown) noexcept
bool | isSustainPedalDown () const noexcept
void | setSustainPedalDown (bool isNowDown) noexcept
bool | isSostenutoPedalDown () const noexcept
void | setSostenutoPedalDown (bool isNowDown) noexcept
bool | isPlayingButReleased () const noexcept
bool | wasStartedBefore (const SynthesiserVoice &other) const noexcept

## Additional Inherited Members

Protected Member Functions inherited from juce::SynthesiserVoice
void | clearCurrentNote ()

## Detailed Description

A subclass of SynthesiserVoice that can play a SamplerSound.

To use it, create a Synthesiser, add some SamplerVoice objects to it, then give it some SampledSound objects to play.

See also
  SamplerSound, Synthesiser, SynthesiserVoice

Definition at line 120 of file juce_Sampler.h.

## Constructor & Destructor Documentation

## SamplerVoice()

juce::SamplerVoice::SamplerVoice | ( |  | ) |

Creates a SamplerVoice.

Definition at line 70 of file juce_Sampler.cpp.

## ~SamplerVoice()

juce::SamplerVoice::~SamplerVoice | ( |  | ) |

override

Destructor.

Definition at line 71 of file juce_Sampler.cpp.

## Member Function Documentation

## canPlaySound()

bool juce::SamplerVoice::canPlaySound | ( | SynthesiserSound * |  | ) |

override virtual

Must return true if this voice object is capable of playing the given sound.

If there are different classes of sound, and different classes of voice, a voice can choose which ones it wants to take on.

A typical implementation of this method may just return true if there's only one type of voice and sound, or it might check the type of the sound object passed-in and see if it's one that it understands.

Implements juce::SynthesiserVoice.

Definition at line 73 of file juce_Sampler.cpp.

## controllerMoved()

void juce::SamplerVoice::controllerMoved | ( | int | controllerNumber,
|  | int | newControllerValue )

override virtual

Called to let the voice know that a midi controller has been moved. This will be called during the rendering callback, so must be fast and thread-safe.

Implements juce::SynthesiserVoice.

Definition at line 114 of file juce_Sampler.cpp.

## pitchWheelMoved()

void juce::SamplerVoice::pitchWheelMoved | ( | int | newPitchWheelValue | ) |

override virtual

Called to let the voice know that the pitch wheel has been moved. This will be called during the rendering callback, so must be fast and thread-safe.

Implements juce::SynthesiserVoice.

Definition at line 113 of file juce_Sampler.cpp.

## renderNextBlock() [1/2]

void juce::SynthesiserVoice::renderNextBlock | ( | AudioBuffer< double > & | outputBuffer,
|  | int | startSample,
|  | int | numSamples )

virtual

A double-precision version of renderNextBlock()

Reimplemented from juce::SynthesiserVoice.

Definition at line 191 of file juce_Synthesiser.cpp.

## renderNextBlock() [2/2]

void juce::SamplerVoice::renderNextBlock | ( | AudioBuffer< float > & | outputBuffer,
|  | int | startSample,
|  | int | numSamples )

override virtual

Renders the next block of data for this voice.

The output audio data must be added to the current contents of the buffer provided. Only the region of the buffer between startSample and (startSample + numSamples) should be altered by this method.

If the voice is currently silent, it should just return without doing anything.

If the sound that the voice is playing finishes during the course of this rendered block, it must call clearCurrentNote(), to tell the synthesiser that it has finished.

The size of the blocks that are rendered can change each time it is called, and may involve rendering as little as 1 sample at a time. In between rendering callbacks, the voice's methods will be called to tell it about note and controller events.

Implements juce::SynthesiserVoice.

Definition at line 117 of file juce_Sampler.cpp.

## startNote()

void juce::SamplerVoice::startNote | ( | int | midiNoteNumber,
|  | float | velocity,
|  | SynthesiserSound * | sound,
|  | int | currentPitchWheelPosition )

override virtual

Called to start a new note. This will be called during the rendering callback, so must be fast and thread-safe.

Implements juce::SynthesiserVoice.

Definition at line 78 of file juce_Sampler.cpp.

## stopNote()

void juce::SamplerVoice::stopNote | ( | float | velocity,
|  | bool | allowTailOff )

override virtual

Called to stop a note.

This will be called during the rendering callback, so must be fast and thread-safe.

The velocity indicates how quickly the note was released - 0 is slowly, 1 is quickly.

If allowTailOff is false or the voice doesn't want to tail-off, then it must stop all sound immediately, and must call clearCurrentNote() to reset the state of this voice and allow the synth to reassign it another sound.

If allowTailOff is true and the voice decides to do a tail-off, then it's allowed to begin fading out its sound, and it can stop playing until it's finished. As soon as it finishes playing (during the rendering callback), it must make sure that it calls clearCurrentNote().

Implements juce::SynthesiserVoice.

Definition at line 100 of file juce_Sampler.cpp.

Referenced by renderNextBlock().

The documentation for this class was generated from the following files:

- juce_Sampler.h
- juce_Sampler.cpp