tracktion_WaveAudioClip.h

Go to the documentation of this file.

 /*
    ,--.                     ,--.     ,--.  ,--.
  ,-'  '-.,--.--.,--,--.,---.|  |,-.,-'  '-.`--' ,---. ,--,--,      Copyright 2024
  '-.  .-'|  .--' ,-.  | .--'|     /'-.  .-',--.| .-. ||      \   Tracktion Software
    |  |  |  |  \ '-'  \ `--.|  \  \  |  |  |  |' '-' '|  ||  |       Corporation
    `---' `--'   `--`--'`---'`--'`--' `---' `--' `---' `--''--'    www.tracktion.com
 
    Tracktion Engine uses a GPL/commercial licence - see LICENCE.md for details.
*/
 
namespace tracktion { inline namespace engine
{
 
//==============================================================================
class WaveAudioClip  : public AudioClipBase
{
public:
    WaveAudioClip (const juce::ValueTree&, EditItemID, ClipOwner&);
 
    ~WaveAudioClip() override;
 
    using Ptr = juce::ReferenceCountedObjectPtr<WaveAudioClip>;
 
    //==============================================================================
    void addTake (ProjectItemID);
 
    void addTake (const juce::File&);
 
    void deleteAllUnusedTakes (bool deleteSourceFiles);
 
    void deleteAllUnusedTakesConfirmingWithUser (bool deleteSourceFiles);
 
    WaveCompManager& getCompManager();
 
    //==============================================================================
    bool needsRender() const override;
    RenderManager::Job::Ptr getRenderJob (const AudioFile& destFile) override;
    juce::String getRenderMessage() override;
    void renderComplete() override;
 
    bool isUsingFile (const AudioFile&) override;
 
    //==============================================================================
    void initialise() override;
    void cloneFrom (Clip*) override;
 
    //==============================================================================
    juce::String getSelectableDescription() override;
 
    bool isMidi() const override                                { return false; }
    bool usesSourceFile() const override                        { return true; }
 
    TimeDuration getSourceLength() const override;
    void sourceMediaChanged() override;
 
    juce::File getOriginalFile() const override;
    HashCode getHash() const override;
 
    void setLoopDefaults() override;
 
    //==============================================================================
    juce::StringArray getTakeDescriptions() const override;
    bool hasAnyTakes() const override                           { return getTakesTree().getNumChildren() > 0; }
    int getNumTakes (bool includeComps) override;
    juce::Array<ProjectItemID> getTakes() const override;
    void clearTakes() override;
    int getCurrentTake() const override;
    void setCurrentTake (int takeIndex) override;
    bool isCurrentTakeComp() override;
    Clip::Array unpackTakes (bool toNewTracks) override;
 
    void reassignReferencedItem (const ReferencedItem&, ProjectItemID newID, double newStartTime) override;
 
private:
    //==============================================================================
    mutable TimeDuration sourceLength;
    WaveCompManager::Ptr compManager;
 
    static constexpr int takeIndexNeedsUpdating = -2;
    mutable int currentTakeIndex = takeIndexNeedsUpdating;
 
    juce::ValueTree getTakesTree() const                        { return state.getChildWithName (IDs::TAKES); }
    void invalidateCurrentTake() noexcept;
    void invalidateCurrentTake (const juce::ValueTree&) noexcept;
 
    void valueTreePropertyChanged (juce::ValueTree&, const juce::Identifier&) override;
    void valueTreeChildAdded (juce::ValueTree&, juce::ValueTree&) override;
    void valueTreeChildRemoved (juce::ValueTree&, juce::ValueTree&, int) override;
    void valueTreeChildOrderChanged (juce::ValueTree&, int, int) override;
 
    //==============================================================================
    JUCE_DECLARE_NON_COPYABLE_WITH_LEAK_DETECTOR (WaveAudioClip)
};
 
}} // namespace tracktion { inline namespace engine