juce::PositionableAudioSource Class Reference

A type of AudioSource which can be repositioned. More...

#include "juce_PositionableAudioSource.h"

Inheritance diagram for juce::PositionableAudioSource:

Public Member Functions
	~PositionableAudioSource () override=default
	Destructor.
virtual void	setNextReadPosition (int64 newPosition)=0
	Tells the stream to move to a new position.
virtual int64	getNextReadPosition () const =0
	Returns the position from which the next block will be returned.
virtual int64	getTotalLength () const =0
	Returns the total length of the stream (in samples).
virtual bool	isLooping () const =0
	Returns true if this source is actually playing in a loop.
virtual void	setLooping (bool shouldLoop)
	Tells the source whether you'd like it to play in a loop.
Public Member Functions inherited from juce::AudioSource
virtual	~AudioSource ()=default
	Destructor.
virtual void	prepareToPlay (int samplesPerBlockExpected, double sampleRate)=0
	Tells the source to prepare for playing.
virtual void	releaseResources ()=0
	Allows the source to release anything it no longer needs after playback has stopped.
virtual void	getNextAudioBlock (const AudioSourceChannelInfo &bufferToFill)=0
	Called repeatedly to fetch subsequent blocks of audio data.

Protected Member Functions
	PositionableAudioSource ()=default
	Creates the PositionableAudioSource.
Protected Member Functions inherited from juce::AudioSource
	AudioSource ()=default
	Creates an AudioSource.

Detailed Description

A type of AudioSource which can be repositioned.

The basic AudioSource just streams continuously with no idea of a current time or length, so the PositionableAudioSource is used for a finite stream that has a current read position.

See also

AudioSource, AudioTransportSource

@tags{Audio}

Definition at line 38 of file juce_PositionableAudioSource.h.

Member Function Documentation

getNextReadPosition()

virtual int64 juce::PositionableAudioSource::getNextReadPosition ( ) const

pure virtual

Returns the position from which the next block will be returned.

See also

setNextReadPosition

Implemented in juce::BufferingAudioSource, juce::MemoryAudioSource, juce::AudioTransportSource, juce::AudioFormatReaderSource, and juce::AudioBufferSource.

getTotalLength()

virtual int64 juce::PositionableAudioSource::getTotalLength ( ) const

pure virtual

Returns the total length of the stream (in samples).

Implemented in juce::BufferingAudioSource, juce::MemoryAudioSource, juce::AudioTransportSource, juce::AudioFormatReaderSource, and juce::AudioBufferSource.

isLooping()

virtual bool juce::PositionableAudioSource::isLooping ( ) const

pure virtual

Returns true if this source is actually playing in a loop.

Implemented in juce::BufferingAudioSource, juce::MemoryAudioSource, juce::AudioTransportSource, juce::AudioFormatReaderSource, and juce::AudioBufferSource.

setLooping()

void juce::PositionableAudioSource::setLooping ( bool  shouldLoop )

virtual

Tells the source whether you'd like it to play in a loop.

Reimplemented in juce::MemoryAudioSource, juce::AudioFormatReaderSource, and juce::AudioBufferSource.

Definition at line 26 of file juce_PositionableAudioSource.cpp.

setNextReadPosition()

virtual void juce::PositionableAudioSource::setNextReadPosition ( int64  newPosition )

pure virtual

Tells the stream to move to a new position.

Calling this indicates that the next call to AudioSource::getNextAudioBlock() should return samples from this position.

Note that this may be called on a different thread to getNextAudioBlock(), so the subclass should make sure it's synchronised.

Implemented in juce::BufferingAudioSource, juce::MemoryAudioSource, juce::AudioTransportSource, juce::AudioFormatReaderSource, and juce::AudioBufferSource.

---

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

• juce_audio_basics/sources/juce_PositionableAudioSource.h
• juce_audio_basics/sources/juce_PositionableAudioSource.cpp