AudioSourceEditor.h

浏览该文件的文档.

#pragma once
#include "common/Export.h"
 
 
#include "audio/editing/AudioTarget.h"
#include "audio/editing/AudioTransport.h"
#include "audio/editing/AudioWaveform.h"
#include "editor/EditorAuthority.h"
#include "editor/EditorSelection.h"
#include "editor/EditorTransactionService.h"
#include "editor/EditorWorkspace.h"
 
#include <cstdint>
#include <memory>
#include <string>
 
namespace eve::audio_editor {
 
class AudioClockTransportBackend final : public audio_editing::IAudioTransportBackend {
public:
    void play() override;
    void pause() override;
    void stop() override;
    [[nodiscard]] audio_editing::Result<void> seek(double seconds) override;
    double tell() const override { return position_; }
    double duration() const override { return duration_; }
    bool   playing() const override { return playing_; }
    void   setNativeLooping(bool) override {}
 
    void setDuration(double seconds);
    void advance(double deltaSeconds);
 
private:
    double duration_ = 1.0;
    double position_ = 0.0;
    bool   playing_  = false;
};
 
class EVENGINE_API_EDITORS AudioSourceEditor {
public:
    explicit AudioSourceEditor(std::string targetId);
 
    AudioSourceEditor(const AudioSourceEditor&)            = delete;
    AudioSourceEditor& operator=(const AudioSourceEditor&) = delete;
    ~AudioSourceEditor();
 
    const audio_editing::AudioSourceTarget& target() const noexcept { return target_; }
 
    [[nodiscard]] audio_editing::Result<void> configureWorkspace(editor::EditorWorkspace& workspace) const;
 
    [[nodiscard]] audio_editing::Result<void> setViewportWidth(float width);
 
    [[nodiscard]] audio_editing::Result<void> seekX(float x);
 
    [[nodiscard]] audio_editing::Result<void> seekSeconds(double seconds);
 
    [[nodiscard]] audio_editing::Result<void> setProperty(const std::string& path,
                                                                const audio_editing::EditorValue& value);
 
    [[nodiscard]] audio_editing::Result<editor::TransactionReceipt> undo();
    [[nodiscard]] audio_editing::Result<editor::TransactionReceipt> redo();
 
    [[nodiscard]] audio_editing::Result<void> play();
    [[nodiscard]] audio_editing::Result<void> pause();
    [[nodiscard]] audio_editing::Result<void> stop();
 
    [[nodiscard]] audio_editing::Result<audio_editing::AudioTransportSnapshot> update(double deltaSeconds);
 
    [[nodiscard]] audio_editing::Result<void> attachLiveAudition();
 
    bool          canUndo() const noexcept { return transactions_.canUndo(); }
    bool          canRedo() const noexcept { return transactions_.canRedo(); }
    bool          isPlaying() const noexcept;
    std::uint64_t revision() const noexcept { return target_.revision(); }
    std::uint64_t pcmRevision() const noexcept { return pcmRevision_; }
    double        duration() const noexcept;
    double        playhead() const noexcept;
    float         layoutWidth() const noexcept { return viewportWidth_; }
    int           bucketCount() const noexcept;
    float         playheadX() const noexcept;
    float         loopStartX() const noexcept;
    float         loopEndX() const noexcept;
 
    [[nodiscard]] audio_editing::PropertyReadResult read(const std::string& path) const;
 
    [[nodiscard]] const audio_editing::AudioWaveformBucket* bucket(int index) const;
 
    const audio_editing::AudioTransportSnapshot& transport() const noexcept { return lastTransport_; }
 
    audio_editing::EditorValue snapshot() const { return target_.snapshotValue(); }
 
private:
    [[nodiscard]] editor::SelectionSnapshot selection() const;
    [[nodiscard]] audio_editing::Result<void> rebuildWaveform();
    [[nodiscard]] audio_editing::Result<void> bindClockAudition();
    [[nodiscard]] audio_editing::Result<void> syncLoop();
    [[nodiscard]] audio_editing::Result<void> publishLive();
    [[nodiscard]] audio_editing::Revision           auditionRevision() const;
    void                                            seedPreviewDocument();
    void                                            generateTonePcm();
 
    audio_editing::AudioSourceTarget         target_;
    editor::LocalWorldAuthority              authority_;
    editor::LocalTransactionBackend          transactions_;
    audio_editing::AudioWaveformService      waveforms_;
    audio_editing::EditorAudioPcm            pcm_;
    audio_editing::AudioWaveformResult       waveform_;
    AudioClockTransportBackend               clock_;
    audio_editing::AudioAuditionTransport    transport_;
    audio_editing::AudioTransportSnapshot    lastTransport_;
    struct LiveAudition;
    std::unique_ptr<LiveAudition>            liveAudition_;
    bool                                     liveBound_    = false;
    std::uint64_t                            pcmRevision_  = 1;
    std::uint64_t                            txSequence_   = 0;
    float                                    viewportWidth_ = 640.0f;
};
 
}  // namespace eve::audio_editor