music_audio_debug_panel.h

Go to the documentation of this file.

#ifndef YAZE_APP_EDITOR_MUSIC_PANELS_MUSIC_AUDIO_DEBUG_PANEL_H_
#define YAZE_APP_EDITOR_MUSIC_PANELS_MUSIC_AUDIO_DEBUG_PANEL_H_
 
#include <string>
#include "util/i18n/tr.h"
 
#include "app/editor/music/music_player.h"
#include "app/editor/system/workspace/editor_panel.h"
#include "app/emu/emulator.h"
#include "app/gui/core/icons.h"
#include "imgui/imgui.h"
 
namespace yaze {
namespace editor {
 
class MusicAudioDebugPanel : public WindowContent {
 public:
  explicit MusicAudioDebugPanel(editor::music::MusicPlayer* player)
      : player_(player) {}
 
  // ==========================================================================
  // WindowContent Identity
  // ==========================================================================
 
  std::string GetId() const override { return "music.audio_debug"; }
  std::string GetDisplayName() const override { return "Audio Debug"; }
  std::string GetIcon() const override { return ICON_MD_BUG_REPORT; }
  std::string GetEditorCategory() const override { return "Music"; }
  int GetPriority() const override { return 95; }  // Just before Help
 
  // ==========================================================================
  // WindowContent Drawing
  // ==========================================================================
 
  void Draw(bool* p_open) override {
    if (!player_) {
      ImGui::TextDisabled(tr("Music player not available"));
      return;
    }
 
    emu::Emulator* debug_emu = player_->emulator();
    if (!debug_emu || !debug_emu->is_snes_initialized()) {
      ImGui::TextColored(ImVec4(0.8f, 0.8f, 0.4f, 1.0f),
                         ICON_MD_INFO " Play a song to initialize audio");
      ImGui::Separator();
      ImGui::TextDisabled(tr("Audio emulator not initialized"));
      return;
    }
 
    auto* audio_backend = debug_emu->audio_backend();
    if (!audio_backend) {
      ImGui::TextColored(ImVec4(1.0f, 0.3f, 0.3f, 1.0f),
                         ICON_MD_ERROR " No audio backend!");
      return;
    }
 
    DrawBackendInfo(audio_backend);
    ImGui::Separator();
    DrawQueueStatus(audio_backend);
    ImGui::Separator();
    DrawResamplingStatus(audio_backend);
    ImGui::Separator();
    DrawDspStatus();
    ImGui::Separator();
    DrawApuStatus();
    ImGui::Separator();
    DrawDebugActions();
  }
 
 private:
  void DrawBackendInfo(emu::audio::IAudioBackend* backend) {
    auto config = backend->GetConfig();
 
    ImGui::Text(ICON_MD_SPEAKER " Backend Configuration");
    ImGui::Indent();
    ImGui::Text(tr("Backend: %s"), backend->GetBackendName().c_str());
    ImGui::Text(tr("Device Rate: %d Hz"), config.sample_rate);
    ImGui::Text(tr("Native Rate: 32040 Hz (SPC700)"));
    ImGui::Text(tr("Channels: %d"), config.channels);
    ImGui::Text(tr("Buffer Frames: %d"), config.buffer_frames);
    ImGui::Unindent();
  }
 
  void DrawQueueStatus(emu::audio::IAudioBackend* backend) {
    auto status = backend->GetStatus();
 
    ImGui::Text(ICON_MD_QUEUE_MUSIC " Queue Status");
    ImGui::Indent();
 
    if (status.is_playing) {
      ImGui::TextColored(ImVec4(0.3f, 0.9f, 0.3f, 1.0f), tr("Status: Playing"));
    } else {
      ImGui::TextColored(ImVec4(0.9f, 0.9f, 0.3f, 1.0f), tr("Status: Stopped"));
    }
 
    ImGui::Text(tr("Queued Frames: %u"), status.queued_frames);
    ImGui::Text(tr("Queued Bytes: %u"), status.queued_bytes);
 
    if (status.has_underrun) {
      ImGui::TextColored(ImVec4(1.0f, 0.3f, 0.3f, 1.0f),
                         ICON_MD_WARNING " Underrun detected!");
    }
 
    ImGui::Unindent();
  }
 
  void DrawResamplingStatus(emu::audio::IAudioBackend* backend) {
    auto config = backend->GetConfig();
    bool resampling_enabled = backend->IsAudioStreamEnabled();
 
    ImGui::Text(ICON_MD_TRANSFORM " Resampling");
    ImGui::Indent();
 
    if (resampling_enabled) {
      float ratio = static_cast<float>(config.sample_rate) / 32040.0f;
      ImGui::TextColored(ImVec4(0.3f, 0.9f, 0.3f, 1.0f),
                         tr("Status: ENABLED (32040 -> %d Hz)"),
                         config.sample_rate);
      ImGui::Text(tr("Ratio: %.3f"), ratio);
 
      // Check for correct ratio (should be ~1.498 for 32040->48000)
      if (ratio < 1.4f || ratio > 1.6f) {
        ImGui::TextColored(ImVec4(1.0f, 0.5f, 0.0f, 1.0f),
                           ICON_MD_WARNING " Unexpected ratio!");
      }
    } else {
      ImGui::TextColored(ImVec4(1.0f, 0.3f, 0.3f, 1.0f),
                         tr("Status: DISABLED"));
      ImGui::TextColored(ImVec4(1.0f, 0.5f, 0.0f, 1.0f),
                         ICON_MD_WARNING " Audio will play at 1.5x speed!");
    }
 
    // Playback speed info
    auto player_state = player_->GetState();
    ImGui::Text(tr("Playback Speed: %.2fx"), player_state.playback_speed);
    ImGui::Text(tr("Effective Rate: %.0f Hz"),
                32040.0f * player_state.playback_speed);
 
    ImGui::Unindent();
  }
 
  void DrawDspStatus() {
    auto dsp_status = player_->GetDspStatus();
 
    ImGui::Text(ICON_MD_MEMORY " DSP Status");
    ImGui::Indent();
 
    ImGui::Text(tr("Sample Offset: %u"), dsp_status.sample_offset);
    ImGui::Text(tr("Frame Boundary: %u"), dsp_status.frame_boundary);
    ImGui::Text(tr("Master Vol L/R: %d / %d"), dsp_status.master_vol_l,
                dsp_status.master_vol_r);
 
    if (dsp_status.mute) {
      ImGui::TextColored(ImVec4(1.0f, 0.5f, 0.0f, 1.0f), tr("Muted"));
    }
    if (dsp_status.reset) {
      ImGui::TextColored(ImVec4(1.0f, 0.3f, 0.3f, 1.0f), tr("Reset"));
    }
 
    ImGui::Text(tr("Echo: %s (delay: %u)"),
                dsp_status.echo_enabled ? "ON" : "OFF", dsp_status.echo_delay);
 
    ImGui::Unindent();
  }
 
  void DrawApuStatus() {
    auto apu_status = player_->GetApuStatus();
 
    ImGui::Text(ICON_MD_TIMER " APU Status");
    ImGui::Indent();
 
    ImGui::Text(tr("Cycles: %llu"), apu_status.cycles);
 
    // Timers in columns
    if (ImGui::BeginTable("ApuTimers", 4, ImGuiTableFlags_Borders)) {
      ImGui::TableSetupColumn("Timer");
      ImGui::TableSetupColumn("Enabled");
      ImGui::TableSetupColumn("Counter");
      ImGui::TableSetupColumn("Target");
      ImGui::TableHeadersRow();
 
      // Timer 0
      ImGui::TableNextRow();
      ImGui::TableSetColumnIndex(0);
      ImGui::Text(tr("T0"));
      ImGui::TableSetColumnIndex(1);
      ImGui::Text("%s", apu_status.timer0_enabled ? "ON" : "OFF");
      ImGui::TableSetColumnIndex(2);
      ImGui::Text("%u", apu_status.timer0_counter);
      ImGui::TableSetColumnIndex(3);
      ImGui::Text("%u", apu_status.timer0_target);
 
      // Timer 1
      ImGui::TableNextRow();
      ImGui::TableSetColumnIndex(0);
      ImGui::Text(tr("T1"));
      ImGui::TableSetColumnIndex(1);
      ImGui::Text("%s", apu_status.timer1_enabled ? "ON" : "OFF");
      ImGui::TableSetColumnIndex(2);
      ImGui::Text("%u", apu_status.timer1_counter);
      ImGui::TableSetColumnIndex(3);
      ImGui::Text("%u", apu_status.timer1_target);
 
      // Timer 2
      ImGui::TableNextRow();
      ImGui::TableSetColumnIndex(0);
      ImGui::Text(tr("T2"));
      ImGui::TableSetColumnIndex(1);
      ImGui::Text("%s", apu_status.timer2_enabled ? "ON" : "OFF");
      ImGui::TableSetColumnIndex(2);
      ImGui::Text("%u", apu_status.timer2_counter);
      ImGui::TableSetColumnIndex(3);
      ImGui::Text("%u", apu_status.timer2_target);
 
      ImGui::EndTable();
    }
 
    // Ports
    ImGui::Text(tr("Ports In:  %02X %02X"), apu_status.port0_in,
                apu_status.port1_in);
    ImGui::Text(tr("Ports Out: %02X %02X"), apu_status.port0_out,
                apu_status.port1_out);
 
    ImGui::Unindent();
  }
 
  void DrawDebugActions() {
    ImGui::Text(ICON_MD_BUILD " Debug Actions");
    ImGui::Indent();
 
    if (ImGui::Button(tr("Clear Audio Queue"))) {
      player_->ClearAudioQueue();
    }
    ImGui::SameLine();
    if (ImGui::Button(tr("Reset DSP Buffer"))) {
      player_->ResetDspBuffer();
    }
    ImGui::SameLine();
    if (ImGui::Button(tr("Force NewFrame"))) {
      player_->ForceNewFrame();
    }
 
    if (ImGui::Button(tr("Reinit Audio"))) {
      player_->ReinitAudio();
    }
 
    ImGui::Unindent();
  }
 
  editor::music::MusicPlayer* player_ = nullptr;
};
 
}  // namespace editor
}  // namespace yaze
 
#endif  // YAZE_APP_EDITOR_MUSIC_PANELS_MUSIC_AUDIO_DEBUG_PANEL_H_