2022-04-23 10:59:50 +02:00
|
|
|
// SPDX-FileCopyrightText: Copyright 2018 yuzu Emulator Project
|
|
|
|
// SPDX-License-Identifier: GPL-2.0-or-later
|
2018-03-20 04:00:59 +01:00
|
|
|
|
|
|
|
#pragma once
|
|
|
|
|
2019-01-20 05:03:26 +01:00
|
|
|
#include <functional>
|
2019-11-28 06:15:34 +01:00
|
|
|
#include <optional>
|
2021-01-17 00:48:58 +01:00
|
|
|
#include <span>
|
2023-01-05 04:05:20 +01:00
|
|
|
#include <utility>
|
2018-03-20 04:00:59 +01:00
|
|
|
#include "common/common_types.h"
|
2022-11-21 17:31:18 +01:00
|
|
|
#include "common/polyfill_thread.h"
|
2022-11-20 03:07:14 +01:00
|
|
|
#include "video_core/cache_types.h"
|
2018-10-06 05:39:03 +02:00
|
|
|
#include "video_core/engines/fermi_2d.h"
|
2018-03-23 02:04:30 +01:00
|
|
|
#include "video_core/gpu.h"
|
2023-08-06 09:38:16 +02:00
|
|
|
#include "video_core/query_cache/types.h"
|
2023-04-30 17:14:06 +02:00
|
|
|
#include "video_core/rasterizer_download_area.h"
|
2018-03-20 04:00:59 +01:00
|
|
|
|
2019-05-07 16:55:18 +02:00
|
|
|
namespace Tegra {
|
|
|
|
class MemoryManager;
|
2021-07-12 04:10:42 +02:00
|
|
|
namespace Engines {
|
|
|
|
class AccelerateDMAInterface;
|
2019-05-07 16:55:18 +02:00
|
|
|
}
|
2021-11-05 15:52:31 +01:00
|
|
|
namespace Control {
|
|
|
|
struct ChannelState;
|
|
|
|
}
|
2021-07-12 04:10:42 +02:00
|
|
|
} // namespace Tegra
|
2019-05-07 16:55:18 +02:00
|
|
|
|
2018-03-20 04:00:59 +01:00
|
|
|
namespace VideoCore {
|
|
|
|
|
2019-01-20 05:03:26 +01:00
|
|
|
enum class LoadCallbackStage {
|
|
|
|
Prepare,
|
2019-01-21 02:40:25 +01:00
|
|
|
Build,
|
2019-01-20 05:03:26 +01:00
|
|
|
Complete,
|
|
|
|
};
|
|
|
|
using DiskResourceLoadCallback = std::function<void(LoadCallbackStage, std::size_t, std::size_t)>;
|
|
|
|
|
2018-03-20 04:00:59 +01:00
|
|
|
class RasterizerInterface {
|
|
|
|
public:
|
2020-11-17 13:17:43 +01:00
|
|
|
virtual ~RasterizerInterface() = default;
|
2018-03-20 04:00:59 +01:00
|
|
|
|
2020-02-14 22:09:37 +01:00
|
|
|
/// Dispatches a draw invocation
|
2022-10-21 09:38:50 +02:00
|
|
|
virtual void Draw(bool is_indexed, u32 instance_count) = 0;
|
2019-09-15 17:48:54 +02:00
|
|
|
|
2022-02-09 15:00:05 +01:00
|
|
|
/// Dispatches an indirect draw invocation
|
2022-02-09 15:39:40 +01:00
|
|
|
virtual void DrawIndirect() {}
|
2022-02-09 15:00:05 +01:00
|
|
|
|
2023-01-05 05:28:48 +01:00
|
|
|
/// Dispatches an draw texture invocation
|
|
|
|
virtual void DrawTexture() = 0;
|
|
|
|
|
2018-06-07 06:54:25 +02:00
|
|
|
/// Clear the current framebuffer
|
2022-11-17 04:41:40 +01:00
|
|
|
virtual void Clear(u32 layer_count) = 0;
|
2018-06-07 06:54:25 +02:00
|
|
|
|
2019-07-15 03:25:13 +02:00
|
|
|
/// Dispatches a compute shader invocation
|
2021-02-17 00:52:12 +01:00
|
|
|
virtual void DispatchCompute() = 0;
|
2019-07-15 03:25:13 +02:00
|
|
|
|
2019-07-28 00:40:10 +02:00
|
|
|
/// Resets the counter of a query
|
2023-08-04 03:32:30 +02:00
|
|
|
virtual void ResetCounter(VideoCommon::QueryType type) = 0;
|
2019-07-28 00:40:10 +02:00
|
|
|
|
2019-11-26 22:52:15 +01:00
|
|
|
/// Records a GPU query and caches it
|
2023-08-06 09:38:16 +02:00
|
|
|
virtual void Query(GPUVAddr gpu_addr, VideoCommon::QueryType type,
|
|
|
|
VideoCommon::QueryPropertiesFlags flags, u32 payload, u32 subreport) = 0;
|
2019-07-28 00:40:10 +02:00
|
|
|
|
2021-01-17 00:48:58 +01:00
|
|
|
/// Signal an uniform buffer binding
|
|
|
|
virtual void BindGraphicsUniformBuffer(size_t stage, u32 index, GPUVAddr gpu_addr,
|
|
|
|
u32 size) = 0;
|
|
|
|
|
2021-06-01 19:26:43 +02:00
|
|
|
/// Signal disabling of a uniform buffer
|
|
|
|
virtual void DisableGraphicsUniformBuffer(size_t stage, u32 index) = 0;
|
|
|
|
|
2020-02-19 18:40:37 +01:00
|
|
|
/// Signal a GPU based semaphore as a fence
|
2022-02-06 01:16:11 +01:00
|
|
|
virtual void SignalFence(std::function<void()>&& func) = 0;
|
|
|
|
|
|
|
|
/// Send an operation to be done after a certain amount of flushes.
|
|
|
|
virtual void SyncOperation(std::function<void()>&& func) = 0;
|
2020-02-19 18:40:37 +01:00
|
|
|
|
|
|
|
/// Signal a GPU based syncpoint as a fence
|
|
|
|
virtual void SignalSyncPoint(u32 value) = 0;
|
2020-02-17 23:10:23 +01:00
|
|
|
|
2021-07-06 22:23:10 +02:00
|
|
|
/// Signal a GPU based reference as point
|
|
|
|
virtual void SignalReference() = 0;
|
|
|
|
|
2020-02-18 18:24:38 +01:00
|
|
|
/// Release all pending fences.
|
2023-08-04 03:32:30 +02:00
|
|
|
virtual void ReleaseFences(bool force = true) = 0;
|
2020-02-17 23:10:23 +01:00
|
|
|
|
2018-04-04 23:07:58 +02:00
|
|
|
/// Notify rasterizer that all caches should be flushed to Switch memory
|
2018-03-20 04:00:59 +01:00
|
|
|
virtual void FlushAll() = 0;
|
|
|
|
|
2018-04-04 23:07:58 +02:00
|
|
|
/// Notify rasterizer that any caches of the specified region should be flushed to Switch memory
|
2022-11-20 03:07:14 +01:00
|
|
|
virtual void FlushRegion(VAddr addr, u64 size,
|
|
|
|
VideoCommon::CacheType which = VideoCommon::CacheType::All) = 0;
|
2018-03-20 04:00:59 +01:00
|
|
|
|
2020-04-16 18:29:53 +02:00
|
|
|
/// Check if the the specified memory area requires flushing to CPU Memory.
|
2022-11-20 03:07:14 +01:00
|
|
|
virtual bool MustFlushRegion(VAddr addr, u64 size,
|
|
|
|
VideoCommon::CacheType which = VideoCommon::CacheType::All) = 0;
|
2020-02-18 03:29:04 +01:00
|
|
|
|
2023-04-30 17:14:06 +02:00
|
|
|
virtual RasterizerDownloadArea GetFlushArea(VAddr addr, u64 size) = 0;
|
|
|
|
|
2018-03-20 04:00:59 +01:00
|
|
|
/// Notify rasterizer that any caches of the specified region should be invalidated
|
2022-11-20 03:07:14 +01:00
|
|
|
virtual void InvalidateRegion(VAddr addr, u64 size,
|
|
|
|
VideoCommon::CacheType which = VideoCommon::CacheType::All) = 0;
|
2018-03-20 04:00:59 +01:00
|
|
|
|
2023-01-05 04:05:20 +01:00
|
|
|
virtual void InnerInvalidation(std::span<const std::pair<VAddr, std::size_t>> sequences) {
|
2023-01-05 12:43:54 +01:00
|
|
|
for (const auto& [cpu_addr, size] : sequences) {
|
2023-01-05 04:05:20 +01:00
|
|
|
InvalidateRegion(cpu_addr, size);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2020-02-16 14:51:37 +01:00
|
|
|
/// Notify rasterizer that any caches of the specified region are desync with guest
|
2023-06-28 19:32:50 +02:00
|
|
|
virtual void OnCacheInvalidation(VAddr addr, u64 size) = 0;
|
|
|
|
|
|
|
|
virtual bool OnCPUWrite(VAddr addr, u64 size) = 0;
|
2020-02-16 14:51:37 +01:00
|
|
|
|
|
|
|
/// Sync memory between guest and host.
|
2022-02-06 01:16:11 +01:00
|
|
|
virtual void InvalidateGPUCache() = 0;
|
2020-02-16 14:51:37 +01:00
|
|
|
|
2020-12-30 06:25:23 +01:00
|
|
|
/// Unmap memory range
|
|
|
|
virtual void UnmapMemory(VAddr addr, u64 size) = 0;
|
|
|
|
|
2021-06-20 12:25:59 +02:00
|
|
|
/// Remap GPU memory range. This means underneath backing memory changed
|
2022-01-01 22:03:37 +01:00
|
|
|
virtual void ModifyGPUMemory(size_t as_id, GPUVAddr addr, u64 size) = 0;
|
2021-06-12 15:52:27 +02:00
|
|
|
|
2018-04-04 23:07:58 +02:00
|
|
|
/// Notify rasterizer that any caches of the specified region should be flushed to Switch memory
|
2018-03-20 04:00:59 +01:00
|
|
|
/// and invalidated
|
2022-11-20 03:07:14 +01:00
|
|
|
virtual void FlushAndInvalidateRegion(
|
|
|
|
VAddr addr, u64 size, VideoCommon::CacheType which = VideoCommon::CacheType::All) = 0;
|
2018-03-20 04:00:59 +01:00
|
|
|
|
2020-04-28 07:14:11 +02:00
|
|
|
/// Notify the host renderer to wait for previous primitive and compute operations.
|
|
|
|
virtual void WaitForIdle() = 0;
|
|
|
|
|
2020-12-30 06:25:23 +01:00
|
|
|
/// Notify the host renderer to wait for reads and writes to render targets and flush caches.
|
|
|
|
virtual void FragmentBarrier() = 0;
|
|
|
|
|
|
|
|
/// Notify the host renderer to make available previous render target writes.
|
|
|
|
virtual void TiledCacheBarrier() = 0;
|
|
|
|
|
2019-08-30 20:08:00 +02:00
|
|
|
/// Notify the rasterizer to send all written commands to the host GPU.
|
2019-07-26 20:20:43 +02:00
|
|
|
virtual void FlushCommands() = 0;
|
|
|
|
|
2019-06-20 08:22:25 +02:00
|
|
|
/// Notify rasterizer that a frame is about to finish
|
|
|
|
virtual void TickFrame() = 0;
|
|
|
|
|
2022-12-07 00:28:35 +01:00
|
|
|
virtual bool AccelerateConditionalRendering() {
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
2018-10-06 05:39:03 +02:00
|
|
|
/// Attempt to use a faster method to perform a surface copy
|
2020-11-17 13:17:43 +01:00
|
|
|
[[nodiscard]] virtual bool AccelerateSurfaceCopy(
|
2020-12-30 06:25:23 +01:00
|
|
|
const Tegra::Engines::Fermi2D::Surface& src, const Tegra::Engines::Fermi2D::Surface& dst,
|
2020-11-17 13:17:43 +01:00
|
|
|
const Tegra::Engines::Fermi2D::Config& copy_config) {
|
2018-03-20 04:00:59 +01:00
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
2021-07-10 18:19:10 +02:00
|
|
|
[[nodiscard]] virtual Tegra::Engines::AccelerateDMAInterface& AccessAccelerateDMA() = 0;
|
|
|
|
|
2022-01-31 23:41:29 +01:00
|
|
|
virtual void AccelerateInlineToMemory(GPUVAddr address, size_t copy_size,
|
2022-08-14 11:36:36 +02:00
|
|
|
std::span<const u8> memory) = 0;
|
2022-01-29 22:00:49 +01:00
|
|
|
|
2018-03-20 04:00:59 +01:00
|
|
|
/// Attempt to use a faster method to display the framebuffer to screen
|
2020-11-17 13:17:43 +01:00
|
|
|
[[nodiscard]] virtual bool AccelerateDisplay(const Tegra::FramebufferConfig& config,
|
|
|
|
VAddr framebuffer_addr, u32 pixel_stride) {
|
2018-03-20 04:00:59 +01:00
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
2018-08-29 00:43:08 +02:00
|
|
|
/// Increase/decrease the number of object in pages touching the specified region
|
2019-02-19 02:58:32 +01:00
|
|
|
virtual void UpdatePagesCachedCount(VAddr addr, u64 size, int delta) {}
|
2019-01-14 02:05:53 +01:00
|
|
|
|
|
|
|
/// Initialize disk cached resources for the game being emulated
|
2021-06-22 05:04:55 +02:00
|
|
|
virtual void LoadDiskResources(u64 title_id, std::stop_token stop_loading,
|
2020-06-12 02:24:45 +02:00
|
|
|
const DiskResourceLoadCallback& callback) {}
|
2021-11-05 15:52:31 +01:00
|
|
|
|
|
|
|
virtual void InitializeChannel(Tegra::Control::ChannelState& channel) {}
|
|
|
|
|
|
|
|
virtual void BindChannel(Tegra::Control::ChannelState& channel) {}
|
|
|
|
|
|
|
|
virtual void ReleaseChannel(s32 channel_id) {}
|
2018-03-20 04:00:59 +01:00
|
|
|
};
|
|
|
|
} // namespace VideoCore
|