dolphin/Source/Core/VideoCommon/Widescreen.h

// Copyright 2023 Dolphin Emulator Project
// SPDX-License-Identifier: GPL-2.0-or-later

#pragma once

#include <memory>

#include "VideoCommon/VideoConfig.h"
#include "VideoCommon/VideoEvents.h"

class PointerWrap;

// This class is responsible for tracking the game's aspect ratio.
// This exclusively supports 4:3 or 16:9 detection by default.
class WidescreenManager
{
public:
  WidescreenManager();

  // Just a helper to tell whether the game seems to be running in widescreen,
  // or if it's being forced to.
  bool IsGameWidescreen() const { return m_is_game_widescreen; }

  void DoState(PointerWrap& p);

private:
  enum class HeuristicState
  {
    Inactive,
    Active_NotFound,
    Active_Found_Normal,
    Active_Found_Anamorphic,
  };

  // Returns whether the widescreen state wants to change, and its target value
  std::optional<bool> GetWidescreenOverride() const;
  void UpdateWidescreenHeuristic();

  bool m_is_game_widescreen = false;
  bool m_was_orthographically_anamorphic = false;
  HeuristicState m_heuristic_state = HeuristicState::Inactive;

  Common::EventHook m_update_widescreen;
  Common::EventHook m_config_changed;
};

extern std::unique_ptr<WidescreenManager> g_widescreen;