// Copyright 2019 yuzu Emulator Project // Licensed under GPLv2 or any later version // Refer to the license.txt file included. #pragma once #include #include "common/alignment.h" #include "common/bit_util.h" #include "common/cityhash.h" #include "common/common_types.h" #include "video_core/engines/fermi_2d.h" #include "video_core/engines/maxwell_3d.h" #include "video_core/shader/shader_ir.h" #include "video_core/surface.h" #include "video_core/textures/decoders.h" namespace VideoCommon { class FormatLookupTable; class SurfaceParams { public: /// Creates SurfaceCachedParams from a texture configuration. static SurfaceParams CreateForTexture(const FormatLookupTable& lookup_table, const Tegra::Texture::TICEntry& tic, const VideoCommon::Shader::Sampler& entry); /// Creates SurfaceCachedParams from an image configuration. static SurfaceParams CreateForImage(const FormatLookupTable& lookup_table, const Tegra::Texture::TICEntry& tic, const VideoCommon::Shader::Image& entry); /// Creates SurfaceCachedParams for a depth buffer configuration. static SurfaceParams CreateForDepthBuffer(Core::System& system); /// Creates SurfaceCachedParams from a framebuffer configuration. static SurfaceParams CreateForFramebuffer(Core::System& system, std::size_t index); /// Creates SurfaceCachedParams from a Fermi2D surface configuration. static SurfaceParams CreateForFermiCopySurface( const Tegra::Engines::Fermi2D::Regs::Surface& config); /// Obtains the texture target from a shader's sampler entry. static VideoCore::Surface::SurfaceTarget ExpectedTarget( const VideoCommon::Shader::Sampler& entry); /// Obtains the texture target from a shader's sampler entry. static VideoCore::Surface::SurfaceTarget ExpectedTarget( const VideoCommon::Shader::Image& entry); std::size_t Hash() const { return static_cast( Common::CityHash64(reinterpret_cast(this), sizeof(*this))); } bool operator==(const SurfaceParams& rhs) const; bool operator!=(const SurfaceParams& rhs) const { return !operator==(rhs); } std::size_t GetGuestSizeInBytes() const { return GetInnerMemorySize(false, false, false); } std::size_t GetHostSizeInBytes(bool is_converted) const { if (!is_converted) { return GetInnerMemorySize(true, false, false); } // ASTC is uncompressed in software, in emulated as RGBA8 std::size_t host_size_in_bytes = 0; for (u32 level = 0; level < num_levels; ++level) { host_size_in_bytes += GetConvertedMipmapSize(level) * GetNumLayers(); } return host_size_in_bytes; } u32 GetBlockAlignedWidth() const { return Common::AlignUp(width, 64 / GetBytesPerPixel()); } /// Returns the width of a given mipmap level. u32 GetMipWidth(u32 level) const { return std::max(1U, width >> level); } /// Returns the height of a given mipmap level. u32 GetMipHeight(u32 level) const { return std::max(1U, height >> level); } /// Returns the depth of a given mipmap level. u32 GetMipDepth(u32 level) const { return is_layered ? depth : std::max(1U, depth >> level); } /// Returns the block height of a given mipmap level. u32 GetMipBlockHeight(u32 level) const; /// Returns the block depth of a given mipmap level. u32 GetMipBlockDepth(u32 level) const; /// Returns the best possible row/pitch alignment for the surface. u32 GetRowAlignment(u32 level, bool is_converted) const { const u32 bpp = is_converted ? 4 : GetBytesPerPixel(); return 1U << Common::CountTrailingZeroes32(GetMipWidth(level) * bpp); } /// Returns the offset in bytes in guest memory of a given mipmap level. std::size_t GetGuestMipmapLevelOffset(u32 level) const; /// Returns the offset in bytes in host memory (linear) of a given mipmap level. std::size_t GetHostMipmapLevelOffset(u32 level, bool is_converted) const; /// Returns the size in bytes in guest memory of a given mipmap level. std::size_t GetGuestMipmapSize(u32 level) const { return GetInnerMipmapMemorySize(level, false, false); } /// Returns the size in bytes in host memory (linear) of a given mipmap level. std::size_t GetHostMipmapSize(u32 level) const { return GetInnerMipmapMemorySize(level, true, false) * GetNumLayers(); } std::size_t GetConvertedMipmapSize(u32 level) const; /// Get this texture Tegra Block size in guest memory layout u32 GetBlockSize() const; /// Get X, Y coordinates max sizes of a single block. std::pair GetBlockXY() const; /// Get the offset in x, y, z coordinates from a memory offset std::tuple GetBlockOffsetXYZ(u32 offset) const; /// Returns the size of a layer in bytes in guest memory. std::size_t GetGuestLayerSize() const { return GetLayerSize(false, false); } /// Returns the size of a layer in bytes in host memory for a given mipmap level. std::size_t GetHostLayerSize(u32 level) const { ASSERT(target != VideoCore::Surface::SurfaceTarget::Texture3D); return GetInnerMipmapMemorySize(level, true, false); } /// Returns the max possible mipmap that the texture can have in host gpu u32 MaxPossibleMipmap() const { const u32 max_mipmap_w = Common::Log2Ceil32(width) + 1U; const u32 max_mipmap_h = Common::Log2Ceil32(height) + 1U; const u32 max_mipmap = std::max(max_mipmap_w, max_mipmap_h); if (target != VideoCore::Surface::SurfaceTarget::Texture3D) return max_mipmap; return std::max(max_mipmap, Common::Log2Ceil32(depth) + 1U); } /// Returns if the guest surface is a compressed surface. bool IsCompressed() const { return GetDefaultBlockHeight() > 1 || GetDefaultBlockWidth() > 1; } /// Returns the default block width. u32 GetDefaultBlockWidth() const { return VideoCore::Surface::GetDefaultBlockWidth(pixel_format); } /// Returns the default block height. u32 GetDefaultBlockHeight() const { return VideoCore::Surface::GetDefaultBlockHeight(pixel_format); } /// Returns the bits per pixel. u32 GetBitsPerPixel() const { return VideoCore::Surface::GetFormatBpp(pixel_format); } /// Returns the bytes per pixel. u32 GetBytesPerPixel() const { return VideoCore::Surface::GetBytesPerPixel(pixel_format); } /// Returns true if the pixel format is a depth and/or stencil format. bool IsPixelFormatZeta() const { return pixel_format >= VideoCore::Surface::PixelFormat::MaxColorFormat && pixel_format < VideoCore::Surface::PixelFormat::MaxDepthStencilFormat; } /// Returns is the surface is a TextureBuffer type of surface. bool IsBuffer() const { return target == VideoCore::Surface::SurfaceTarget::TextureBuffer; } /// Returns the number of layers in the surface. std::size_t GetNumLayers() const { return is_layered ? depth : 1; } /// Returns the debug name of the texture for use in graphic debuggers. std::string TargetName() const; // Helper used for out of class size calculations static std::size_t AlignLayered(const std::size_t out_size, const u32 block_height, const u32 block_depth) { return Common::AlignBits(out_size, Tegra::Texture::GOB_SIZE_SHIFT + block_height + block_depth); } /// Converts a width from a type of surface into another. This helps represent the /// equivalent value between compressed/non-compressed textures. static u32 ConvertWidth(u32 width, VideoCore::Surface::PixelFormat pixel_format_from, VideoCore::Surface::PixelFormat pixel_format_to) { const u32 bw1 = VideoCore::Surface::GetDefaultBlockWidth(pixel_format_from); const u32 bw2 = VideoCore::Surface::GetDefaultBlockWidth(pixel_format_to); return (width * bw2 + bw1 - 1) / bw1; } /// Converts a height from a type of surface into another. This helps represent the /// equivalent value between compressed/non-compressed textures. static u32 ConvertHeight(u32 height, VideoCore::Surface::PixelFormat pixel_format_from, VideoCore::Surface::PixelFormat pixel_format_to) { const u32 bh1 = VideoCore::Surface::GetDefaultBlockHeight(pixel_format_from); const u32 bh2 = VideoCore::Surface::GetDefaultBlockHeight(pixel_format_to); return (height * bh2 + bh1 - 1) / bh1; } // Finds the maximun possible width between 2 2D layers of different formats static u32 IntersectWidth(const SurfaceParams& src_params, const SurfaceParams& dst_params, const u32 src_level, const u32 dst_level) { const u32 bw1 = src_params.GetDefaultBlockWidth(); const u32 bw2 = dst_params.GetDefaultBlockWidth(); const u32 t_src_width = (src_params.GetMipWidth(src_level) * bw2 + bw1 - 1) / bw1; const u32 t_dst_width = (dst_params.GetMipWidth(dst_level) * bw1 + bw2 - 1) / bw2; return std::min(t_src_width, t_dst_width); } // Finds the maximun possible height between 2 2D layers of different formats static u32 IntersectHeight(const SurfaceParams& src_params, const SurfaceParams& dst_params, const u32 src_level, const u32 dst_level) { const u32 bh1 = src_params.GetDefaultBlockHeight(); const u32 bh2 = dst_params.GetDefaultBlockHeight(); const u32 t_src_height = (src_params.GetMipHeight(src_level) * bh2 + bh1 - 1) / bh1; const u32 t_dst_height = (dst_params.GetMipHeight(dst_level) * bh1 + bh2 - 1) / bh2; return std::min(t_src_height, t_dst_height); } bool is_tiled; bool srgb_conversion; bool is_layered; u32 block_width; u32 block_height; u32 block_depth; u32 tile_width_spacing; u32 width; u32 height; u32 depth; u32 pitch; u32 num_levels; u32 emulated_levels; VideoCore::Surface::PixelFormat pixel_format; VideoCore::Surface::SurfaceType type; VideoCore::Surface::SurfaceTarget target; private: /// Returns the size of a given mipmap level inside a layer. std::size_t GetInnerMipmapMemorySize(u32 level, bool as_host_size, bool uncompressed) const; /// Returns the size of all mipmap levels and aligns as needed. std::size_t GetInnerMemorySize(bool as_host_size, bool layer_only, bool uncompressed) const { return GetLayerSize(as_host_size, uncompressed) * (layer_only ? 1U : (is_layered ? depth : 1U)); } /// Returns the size of a layer std::size_t GetLayerSize(bool as_host_size, bool uncompressed) const; /// Returns true if these parameters are from a layered surface. bool IsLayered() const; }; } // namespace VideoCommon namespace std { template <> struct hash { std::size_t operator()(const VideoCommon::SurfaceParams& k) const noexcept { return k.Hash(); } }; } // namespace std