From 1d28b2e142f845773e2b90e267d9632e196a99b9 Mon Sep 17 00:00:00 2001 From: James Rowe Date: Thu, 11 Jan 2018 20:07:44 -0700 Subject: Remove references to PICA and rasterizers in video_core --- src/video_core/debug_utils/debug_utils.h | 251 ------------------------------- 1 file changed, 251 deletions(-) delete mode 100644 src/video_core/debug_utils/debug_utils.h (limited to 'src/video_core/debug_utils/debug_utils.h') diff --git a/src/video_core/debug_utils/debug_utils.h b/src/video_core/debug_utils/debug_utils.h deleted file mode 100644 index c1f29c527..000000000 --- a/src/video_core/debug_utils/debug_utils.h +++ /dev/null @@ -1,251 +0,0 @@ -// Copyright 2014 Citra Emulator Project -// Licensed under GPLv2 -// Refer to the license.txt file included. - -#pragma once - -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include "common/common_types.h" -#include "common/vector_math.h" -#include "video_core/regs_rasterizer.h" -#include "video_core/regs_shader.h" -#include "video_core/regs_texturing.h" - -namespace CiTrace { -class Recorder; -} - -namespace Pica { - -namespace Shader { -struct ShaderSetup; -} - -class DebugContext { -public: - enum class Event { - FirstEvent = 0, - - PicaCommandLoaded = FirstEvent, - PicaCommandProcessed, - IncomingPrimitiveBatch, - FinishedPrimitiveBatch, - VertexShaderInvocation, - IncomingDisplayTransfer, - GSPCommandProcessed, - BufferSwapped, - - NumEvents - }; - - /** - * Inherit from this class to be notified of events registered to some debug context. - * Most importantly this is used for our debugger GUI. - * - * To implement event handling, override the OnPicaBreakPointHit and OnPicaResume methods. - * @warning All BreakPointObservers need to be on the same thread to guarantee thread-safe state - * access - * @todo Evaluate an alternative interface, in which there is only one managing observer and - * multiple child observers running (by design) on the same thread. - */ - class BreakPointObserver { - public: - /// Constructs the object such that it observes events of the given DebugContext. - BreakPointObserver(std::shared_ptr debug_context) - : context_weak(debug_context) { - std::unique_lock lock(debug_context->breakpoint_mutex); - debug_context->breakpoint_observers.push_back(this); - } - - virtual ~BreakPointObserver() { - auto context = context_weak.lock(); - if (context) { - std::unique_lock lock(context->breakpoint_mutex); - context->breakpoint_observers.remove(this); - - // If we are the last observer to be destroyed, tell the debugger context that - // it is free to continue. In particular, this is required for a proper Citra - // shutdown, when the emulation thread is waiting at a breakpoint. - if (context->breakpoint_observers.empty()) - context->Resume(); - } - } - - /** - * Action to perform when a breakpoint was reached. - * @param event Type of event which triggered the breakpoint - * @param data Optional data pointer (if unused, this is a nullptr) - * @note This function will perform nothing unless it is overridden in the child class. - */ - virtual void OnPicaBreakPointHit(Event event, void* data) {} - - /** - * Action to perform when emulation is resumed from a breakpoint. - * @note This function will perform nothing unless it is overridden in the child class. - */ - virtual void OnPicaResume() {} - - protected: - /** - * Weak context pointer. This need not be valid, so when requesting a shared_ptr via - * context_weak.lock(), always compare the result against nullptr. - */ - std::weak_ptr context_weak; - }; - - /** - * Simple structure defining a breakpoint state - */ - struct BreakPoint { - bool enabled = false; - }; - - /** - * Static constructor used to create a shared_ptr of a DebugContext. - */ - static std::shared_ptr Construct() { - return std::shared_ptr(new DebugContext); - } - - /** - * Used by the emulation core when a given event has happened. If a breakpoint has been set - * for this event, OnEvent calls the event handlers of the registered breakpoint observers. - * The current thread then is halted until Resume() is called from another thread (or until - * emulation is stopped). - * @param event Event which has happened - * @param data Optional data pointer (pass nullptr if unused). Needs to remain valid until - * Resume() is called. - */ - void OnEvent(Event event, void* data) { - // This check is left in the header to allow the compiler to inline it. - if (!breakpoints[(int)event].enabled) - return; - // For the rest of event handling, call a separate function. - DoOnEvent(event, data); - } - - void DoOnEvent(Event event, void* data); - - /** - * Resume from the current breakpoint. - * @warning Calling this from the same thread that OnEvent was called in will cause a deadlock. - * Calling from any other thread is safe. - */ - void Resume(); - - /** - * Delete all set breakpoints and resume emulation. - */ - void ClearBreakpoints() { - for (auto& bp : breakpoints) { - bp.enabled = false; - } - Resume(); - } - - // TODO: Evaluate if access to these members should be hidden behind a public interface. - std::array breakpoints; - Event active_breakpoint; - bool at_breakpoint = false; - - std::shared_ptr recorder = nullptr; - -private: - /** - * Private default constructor to make sure people always construct this through Construct() - * instead. - */ - DebugContext() = default; - - /// Mutex protecting current breakpoint state and the observer list. - std::mutex breakpoint_mutex; - - /// Used by OnEvent to wait for resumption. - std::condition_variable resume_from_breakpoint; - - /// List of registered observers - std::list breakpoint_observers; -}; - -extern std::shared_ptr g_debug_context; // TODO: Get rid of this global - -namespace DebugUtils { - -#define PICA_DUMP_TEXTURES 0 -#define PICA_LOG_TEV 0 - -void DumpShader(const std::string& filename, const ShaderRegs& config, - const Shader::ShaderSetup& setup, - const RasterizerRegs::VSOutputAttributes* output_attributes); - -// Utility class to log Pica commands. -struct PicaTrace { - struct Write { - u16 cmd_id; - u16 mask; - u32 value; - }; - std::vector writes; -}; - -extern bool g_is_pica_tracing; - -void StartPicaTracing(); -inline bool IsPicaTracing() { - return g_is_pica_tracing; -} -void OnPicaRegWrite(PicaTrace::Write write); -std::unique_ptr FinishPicaTracing(); - -void DumpTexture(const TexturingRegs::TextureConfig& texture_config, u8* data); - -std::string GetTevStageConfigColorCombinerString(const TexturingRegs::TevStageConfig& tev_stage); -std::string GetTevStageConfigAlphaCombinerString(const TexturingRegs::TevStageConfig& tev_stage); - -/// Dumps the Tev stage config to log at trace level -void DumpTevStageConfig(const std::array& stages); - -/** - * Used in the vertex loader to merge access records. TODO: Investigate if actually useful. - */ -class MemoryAccessTracker { - /// Combine overlapping and close ranges - void SimplifyRanges() { - for (auto it = ranges.begin(); it != ranges.end(); ++it) { - // NOTE: We add 32 to the range end address to make sure "close" ranges are combined, - // too - auto it2 = std::next(it); - while (it2 != ranges.end() && it->first + it->second + 32 >= it2->first) { - it->second = std::max(it->second, it2->first + it2->second - it->first); - it2 = ranges.erase(it2); - } - } - } - -public: - /// Record a particular memory access in the list - void AddAccess(u32 paddr, u32 size) { - // Create new range or extend existing one - ranges[paddr] = std::max(ranges[paddr], size); - - // Simplify ranges... - SimplifyRanges(); - } - - /// Map of accessed ranges (mapping start address to range size) - std::map ranges; -}; - -} // namespace - -} // namespace -- cgit v1.2.3