juce_AudioThumbnail.h

Go to the documentation of this file.

 /*
  ==============================================================================
 
   This file is part of the JUCE library.
   Copyright (c) 2022 - Raw Material Software Limited
 
   JUCE is an open source library subject to commercial or open-source
   licensing.
 
   By using JUCE, you agree to the terms of both the JUCE 7 End-User License
   Agreement and JUCE Privacy Policy.
 
   End User License Agreement: www.juce.com/juce-7-licence
   Privacy Policy: www.juce.com/juce-privacy-policy
 
   Or: You may also use this code under the terms of the GPL v3 (see
   www.gnu.org/licenses).
 
   JUCE IS PROVIDED "AS IS" WITHOUT ANY WARRANTY, AND ALL WARRANTIES, WHETHER
   EXPRESSED OR IMPLIED, INCLUDING MERCHANTABILITY AND FITNESS FOR PURPOSE, ARE
   DISCLAIMED.
 
  ==============================================================================
*/
 
namespace juce
{
 
//==============================================================================
class JUCE_API  AudioThumbnail    : public AudioThumbnailBase
{
public:
    //==============================================================================
    AudioThumbnail (int sourceSamplesPerThumbnailSample,
                    AudioFormatManager& formatManagerToUse,
                    AudioThumbnailCache& cacheToUse);
 
    ~AudioThumbnail() override;
 
    //==============================================================================
    void clear() override;
 
    bool setSource (InputSource* newSource) override;
 
    void setReader (AudioFormatReader* newReader, int64 hashCode) override;
 
    void setSource (const AudioBuffer<float>* newSource, double sampleRate, int64 hashCode);
 
    void setSource (const AudioBuffer<int>* newSource, double sampleRate, int64 hashCode);
 
    void reset (int numChannels, double sampleRate, int64 totalSamplesInSource = 0) override;
 
    void addBlock (int64 sampleNumberInSource, const AudioBuffer<float>& newData,
                   int startOffsetInBuffer, int numSamples) override;
 
    //==============================================================================
    bool loadFrom (InputStream& input) override;
 
    void saveTo (OutputStream& output) const override;
 
    //==============================================================================
    int getNumChannels() const noexcept override;
 
    double getTotalLength() const noexcept override;
 
    void drawChannel (Graphics& g,
                      const Rectangle<int>& area,
                      double startTimeSeconds,
                      double endTimeSeconds,
                      int channelNum,
                      float verticalZoomFactor) override;
 
    void drawChannels (Graphics& g,
                       const Rectangle<int>& area,
                       double startTimeSeconds,
                       double endTimeSeconds,
                       float verticalZoomFactor) override;
 
    bool isFullyLoaded() const noexcept override;
 
    double getProportionComplete() const noexcept;
 
    int64 getNumSamplesFinished() const noexcept override;
 
    float getApproximatePeak() const override;
 
    void getApproximateMinMax (double startTime, double endTime, int channelIndex,
                               float& minValue, float& maxValue) const noexcept override;
 
    int64 getHashCode() const override;
 
private:
    //==============================================================================
    AudioFormatManager& formatManagerToUse;
    AudioThumbnailCache& cache;
 
    class LevelDataSource;
    struct MinMaxValue;
    class ThumbData;
    class CachedWindow;
 
    std::unique_ptr<LevelDataSource> source;
    std::unique_ptr<CachedWindow> window;
    OwnedArray<ThumbData> channels;
 
    int32 samplesPerThumbSample = 0;
    int64 totalSamples { 0 };
    int64 numSamplesFinished = 0;
    int32 numChannels = 0;
    double sampleRate = 0;
    CriticalSection lock;
 
    void clearChannelData();
    bool setDataSource (LevelDataSource* newSource);
    void setLevels (const MinMaxValue* const* values, int thumbIndex, int numChans, int numValues);
    void createChannels (int length);
 
    JUCE_DECLARE_NON_COPYABLE_WITH_LEAK_DETECTOR (AudioThumbnail)
};
 
} // namespace juce