tracktion_TrackOutput.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 TrackOutput   : private juce::ValueTree::Listener
{
public:
    //==============================================================================
    TrackOutput (Track&);
    ~TrackOutput() override;
 
    //==============================================================================
    void initialise();
    void flushStateToValueTree();
 
    void updateOutput();
 
    //==============================================================================
    bool outputsToDevice (const juce::String& deviceName, bool compareDefaultDevices) const;
 
    juce::String getOutputName() const;
 
    juce::String getDescriptiveOutputName() const;
 
    AudioTrack* getDestinationTrack() const;
 
    bool outputsToDestTrack (AudioTrack&) const;
 
    bool feedsInto (const Track* possibleDestTrack) const;
 
    OutputDevice* getOutputDevice (bool traceThroughDestTracks) const;
 
    //==============================================================================
    void setOutputByName (const juce::String& name);
    void setOutputToTrack (AudioTrack*);
    void setOutputToDefaultDevice (bool isMidi);
 
    static void getPossibleOutputDeviceNames (const juce::Array<AudioTrack*>& tracks,
                                              juce::StringArray& s, juce::StringArray& a,
                                              juce::BigInteger& hasAudio,
                                              juce::BigInteger& hasMidi);
 
    static void getPossibleOutputNames (const juce::Array<AudioTrack*>& tracks,
                                        juce::StringArray& s, juce::StringArray& a,
                                        juce::BigInteger& hasAudio,
                                        juce::BigInteger& hasMidi);
 
    //==============================================================================
    bool canPlayAudio() const;
    bool canPlayMidi() const;
 
    bool injectLiveMidiMessage (const juce::MidiMessage&);
 
    juce::ValueTree state;
 
private:
    Track& owner;
    juce::CachedValue<juce::String> outputDevice;
    EditItemID destTrackID;
 
    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 {}
    void valueTreeParentChanged (juce::ValueTree&) override {}
 
    JUCE_DECLARE_NON_COPYABLE_WITH_LEAK_DETECTOR (TrackOutput)
};
 
}} // namespace tracktion { inline namespace engine