// Copyright 2015 Citra Emulator Project // Licensed under GPLv2 or any later version // Refer to the license.txt file included. #pragma once #include #include #include #include "common/common_types.h" #include "citrace.h" namespace CiTrace { class Recorder { public: struct InitialState { std::vector gpu_registers; std::vector lcd_registers; std::vector pica_registers; std::vector default_attributes; std::vector vs_program_binary; std::vector vs_swizzle_data; std::vector vs_float_uniforms; std::vector gs_program_binary; std::vector gs_swizzle_data; std::vector gs_float_uniforms; }; /** * Recorder constructor * @param default_attributes Pointer to an array of 32-bit-aligned 24-bit floating point values. * @param vs_float_uniforms Pointer to an array of 32-bit-aligned 24-bit floating point values. */ Recorder(const InitialState& initial_state); /// Finish recording of this Citrace and save it using the given filename. void Finish(const std::string& filename); /// Mark end of a frame void FrameFinished(); /** * Store a copy of the given memory range in the recording. * @note Use this whenever the GPU is about to access a particular memory region. * @note The implementation will make sure to minimize redundant memory updates. */ void MemoryAccessed(const u8* data, u32 size, u32 physical_address); /** * Record a register write. * @note Use this whenever a GPU-related MMIO register has been written to. */ template void RegisterWritten(u32 physical_address, T value); private: // Initial state of recording start InitialState initial_state; // Command stream struct StreamElement { CTStreamElement data; /** * Extra data to store along "core" data. * This is e.g. used for data used in MemoryUpdates. */ std::vector extra_data; /// Optional CRC hash (e.g. for hashing memory regions) boost::crc_32_type::value_type hash; /// If true, refer to data already written to the output file instead of extra_data bool uses_existing_data; }; std::vector stream; /** * Internal cache which maps hashes of memory contents to file offsets at which those memory * contents are stored. */ std::unordered_map memory_regions; }; } // namespace