70d65d3d8e
* Enable copy dependency between RGBA8 and RGBA32 formats * Take packed flag into account for texture formats * Account for widths not being a multiple of each other * Don't try to alias depth textures as color, fix log condition * PR feedback
871 lines
40 KiB
C#
871 lines
40 KiB
C#
using Ryujinx.Common;
|
|
using Ryujinx.Graphics.GAL;
|
|
using Ryujinx.Graphics.Texture;
|
|
using System;
|
|
using System.Diagnostics;
|
|
using System.Numerics;
|
|
|
|
namespace Ryujinx.Graphics.Gpu.Image
|
|
{
|
|
/// <summary>
|
|
/// Texture format compatibility checks.
|
|
/// </summary>
|
|
static class TextureCompatibility
|
|
{
|
|
private enum FormatClass
|
|
{
|
|
Unclassified,
|
|
Bc1Rgba,
|
|
Bc2,
|
|
Bc3,
|
|
Bc4,
|
|
Bc5,
|
|
Bc6,
|
|
Bc7,
|
|
Etc2Rgb,
|
|
Etc2Rgba,
|
|
Astc4x4,
|
|
Astc5x4,
|
|
Astc5x5,
|
|
Astc6x5,
|
|
Astc6x6,
|
|
Astc8x5,
|
|
Astc8x6,
|
|
Astc8x8,
|
|
Astc10x5,
|
|
Astc10x6,
|
|
Astc10x8,
|
|
Astc10x10,
|
|
Astc12x10,
|
|
Astc12x12,
|
|
}
|
|
|
|
/// <summary>
|
|
/// Checks if a format is host incompatible.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// Host incompatible formats can't be used directly, the texture data needs to be converted
|
|
/// to a compatible format first.
|
|
/// </remarks>
|
|
/// <param name="info">Texture information</param>
|
|
/// <param name="caps">Host GPU capabilities</param>
|
|
/// <returns>True if the format is incompatible, false otherwise</returns>
|
|
public static bool IsFormatHostIncompatible(TextureInfo info, Capabilities caps)
|
|
{
|
|
Format originalFormat = info.FormatInfo.Format;
|
|
return ToHostCompatibleFormat(info, caps).Format != originalFormat;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Converts a incompatible format to a host compatible format, or return the format directly
|
|
/// if it is already host compatible.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// This can be used to convert a incompatible compressed format to the decompressor
|
|
/// output format.
|
|
/// </remarks>
|
|
/// <param name="info">Texture information</param>
|
|
/// <param name="caps">Host GPU capabilities</param>
|
|
/// <returns>A host compatible format</returns>
|
|
public static FormatInfo ToHostCompatibleFormat(TextureInfo info, Capabilities caps)
|
|
{
|
|
// The host API does not support those compressed formats.
|
|
// We assume software decompression will be done for those textures,
|
|
// and so we adjust the format here to match the decompressor output.
|
|
|
|
if (!caps.SupportsAstcCompression)
|
|
{
|
|
if (info.FormatInfo.Format.IsAstcUnorm())
|
|
{
|
|
return GraphicsConfig.EnableTextureRecompression
|
|
? new FormatInfo(Format.Bc7Unorm, 4, 4, 16, 4)
|
|
: new FormatInfo(Format.R8G8B8A8Unorm, 1, 1, 4, 4);
|
|
}
|
|
else if (info.FormatInfo.Format.IsAstcSrgb())
|
|
{
|
|
return GraphicsConfig.EnableTextureRecompression
|
|
? new FormatInfo(Format.Bc7Srgb, 4, 4, 16, 4)
|
|
: new FormatInfo(Format.R8G8B8A8Srgb, 1, 1, 4, 4);
|
|
}
|
|
}
|
|
|
|
if (!HostSupportsBcFormat(info.FormatInfo.Format, info.Target, caps))
|
|
{
|
|
switch (info.FormatInfo.Format)
|
|
{
|
|
case Format.Bc1RgbaSrgb:
|
|
case Format.Bc2Srgb:
|
|
case Format.Bc3Srgb:
|
|
case Format.Bc7Srgb:
|
|
return new FormatInfo(Format.R8G8B8A8Srgb, 1, 1, 4, 4);
|
|
case Format.Bc1RgbaUnorm:
|
|
case Format.Bc2Unorm:
|
|
case Format.Bc3Unorm:
|
|
case Format.Bc7Unorm:
|
|
return new FormatInfo(Format.R8G8B8A8Unorm, 1, 1, 4, 4);
|
|
case Format.Bc4Unorm:
|
|
return new FormatInfo(Format.R8Unorm, 1, 1, 1, 1);
|
|
case Format.Bc4Snorm:
|
|
return new FormatInfo(Format.R8Snorm, 1, 1, 1, 1);
|
|
case Format.Bc5Unorm:
|
|
return new FormatInfo(Format.R8G8Unorm, 1, 1, 2, 2);
|
|
case Format.Bc5Snorm:
|
|
return new FormatInfo(Format.R8G8Snorm, 1, 1, 2, 2);
|
|
case Format.Bc6HSfloat:
|
|
case Format.Bc6HUfloat:
|
|
return new FormatInfo(Format.R16G16B16A16Float, 1, 1, 8, 4);
|
|
}
|
|
}
|
|
|
|
if (!caps.SupportsEtc2Compression)
|
|
{
|
|
switch (info.FormatInfo.Format)
|
|
{
|
|
case Format.Etc2RgbaSrgb:
|
|
case Format.Etc2RgbPtaSrgb:
|
|
case Format.Etc2RgbSrgb:
|
|
return new FormatInfo(Format.R8G8B8A8Srgb, 1, 1, 4, 4);
|
|
case Format.Etc2RgbaUnorm:
|
|
case Format.Etc2RgbPtaUnorm:
|
|
case Format.Etc2RgbUnorm:
|
|
return new FormatInfo(Format.R8G8B8A8Unorm, 1, 1, 4, 4);
|
|
}
|
|
}
|
|
|
|
if (!caps.SupportsR4G4Format && info.FormatInfo.Format == Format.R4G4Unorm)
|
|
{
|
|
if (caps.SupportsR4G4B4A4Format)
|
|
{
|
|
return new FormatInfo(Format.R4G4B4A4Unorm, 1, 1, 2, 4);
|
|
}
|
|
else
|
|
{
|
|
return new FormatInfo(Format.R8G8B8A8Unorm, 1, 1, 4, 4);
|
|
}
|
|
}
|
|
|
|
if (info.FormatInfo.Format == Format.R4G4B4A4Unorm)
|
|
{
|
|
if (!caps.SupportsR4G4B4A4Format)
|
|
{
|
|
return new FormatInfo(Format.R8G8B8A8Unorm, 1, 1, 4, 4);
|
|
}
|
|
}
|
|
else if (!caps.Supports5BitComponentFormat && info.FormatInfo.Format.Is16BitPacked())
|
|
{
|
|
return new FormatInfo(info.FormatInfo.Format.IsBgr() ? Format.B8G8R8A8Unorm : Format.R8G8B8A8Unorm, 1, 1, 4, 4);
|
|
}
|
|
|
|
return info.FormatInfo;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Checks if the host API supports a given texture compression format of the BC family.
|
|
/// </summary>
|
|
/// <param name="format">BC format to be checked</param>
|
|
/// <param name="target">Target usage of the texture</param>
|
|
/// <param name="caps">Host GPU Capabilities</param>
|
|
/// <returns>True if the texture host supports the format with the given target usage, false otherwise</returns>
|
|
public static bool HostSupportsBcFormat(Format format, Target target, Capabilities caps)
|
|
{
|
|
bool not3DOr3DCompressionSupported = target != Target.Texture3D || caps.Supports3DTextureCompression;
|
|
|
|
switch (format)
|
|
{
|
|
case Format.Bc1RgbaSrgb:
|
|
case Format.Bc1RgbaUnorm:
|
|
case Format.Bc2Srgb:
|
|
case Format.Bc2Unorm:
|
|
case Format.Bc3Srgb:
|
|
case Format.Bc3Unorm:
|
|
return caps.SupportsBc123Compression && not3DOr3DCompressionSupported;
|
|
case Format.Bc4Unorm:
|
|
case Format.Bc4Snorm:
|
|
case Format.Bc5Unorm:
|
|
case Format.Bc5Snorm:
|
|
return caps.SupportsBc45Compression && not3DOr3DCompressionSupported;
|
|
case Format.Bc6HSfloat:
|
|
case Format.Bc6HUfloat:
|
|
case Format.Bc7Srgb:
|
|
case Format.Bc7Unorm:
|
|
return caps.SupportsBc67Compression && not3DOr3DCompressionSupported;
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Determines whether a texture can flush its data back to guest memory.
|
|
/// </summary>
|
|
/// <param name="info">Texture information</param>
|
|
/// <param name="caps">Host GPU Capabilities</param>
|
|
/// <returns>True if the texture can flush, false otherwise</returns>
|
|
public static bool CanTextureFlush(TextureInfo info, Capabilities caps)
|
|
{
|
|
if (IsFormatHostIncompatible(info, caps))
|
|
{
|
|
return false; // Flushing this format is not supported, as it may have been converted to another host format.
|
|
}
|
|
|
|
if (info.Target == Target.Texture2DMultisample ||
|
|
info.Target == Target.Texture2DMultisampleArray)
|
|
{
|
|
return false; // Flushing multisample textures is not supported, the host does not allow getting their data.
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Checks if the texture format matches with the specified texture information.
|
|
/// </summary>
|
|
/// <param name="lhs">Texture information to compare</param>
|
|
/// <param name="rhs">Texture information to compare with</param>
|
|
/// <param name="forSampler">Indicates that the texture will be used for shader sampling</param>
|
|
/// <param name="depthAlias">Indicates if aliasing between color and depth format should be allowed</param>
|
|
/// <returns>A value indicating how well the formats match</returns>
|
|
public static TextureMatchQuality FormatMatches(TextureInfo lhs, TextureInfo rhs, bool forSampler, bool depthAlias)
|
|
{
|
|
// D32F and R32F texture have the same representation internally,
|
|
// however the R32F format is used to sample from depth textures.
|
|
if (IsValidDepthAsColorAlias(lhs.FormatInfo.Format, rhs.FormatInfo.Format) && (forSampler || depthAlias))
|
|
{
|
|
return TextureMatchQuality.FormatAlias;
|
|
}
|
|
|
|
if (depthAlias)
|
|
{
|
|
// The 2D engine does not support depth-stencil formats, so it will instead
|
|
// use equivalent color formats. We must also consider them as compatible.
|
|
if (lhs.FormatInfo.Format == Format.S8Uint && rhs.FormatInfo.Format == Format.R8Unorm)
|
|
{
|
|
return TextureMatchQuality.FormatAlias;
|
|
}
|
|
else if ((lhs.FormatInfo.Format == Format.D24UnormS8Uint ||
|
|
lhs.FormatInfo.Format == Format.S8UintD24Unorm) && rhs.FormatInfo.Format == Format.B8G8R8A8Unorm)
|
|
{
|
|
return TextureMatchQuality.FormatAlias;
|
|
}
|
|
}
|
|
|
|
return lhs.FormatInfo.Format == rhs.FormatInfo.Format ? TextureMatchQuality.Perfect : TextureMatchQuality.NoMatch;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Checks if the texture layout specified matches with this texture layout.
|
|
/// The layout information is composed of the Stride for linear textures, or GOB block size
|
|
/// for block linear textures.
|
|
/// </summary>
|
|
/// <param name="lhs">Texture information to compare</param>
|
|
/// <param name="rhs">Texture information to compare with</param>
|
|
/// <returns>True if the layout matches, false otherwise</returns>
|
|
public static bool LayoutMatches(TextureInfo lhs, TextureInfo rhs)
|
|
{
|
|
if (lhs.IsLinear != rhs.IsLinear)
|
|
{
|
|
return false;
|
|
}
|
|
|
|
// For linear textures, gob block sizes are ignored.
|
|
// For block linear textures, the stride is ignored.
|
|
if (rhs.IsLinear)
|
|
{
|
|
return lhs.Stride == rhs.Stride;
|
|
}
|
|
else
|
|
{
|
|
return lhs.GobBlocksInY == rhs.GobBlocksInY &&
|
|
lhs.GobBlocksInZ == rhs.GobBlocksInZ;
|
|
}
|
|
}
|
|
|
|
/// <summary>
|
|
/// Obtain the minimum compatibility level of two provided view compatibility results.
|
|
/// </summary>
|
|
/// <param name="first">The first compatibility level</param>
|
|
/// <param name="second">The second compatibility level</param>
|
|
/// <returns>The minimum compatibility level of two provided view compatibility results</returns>
|
|
public static TextureViewCompatibility PropagateViewCompatibility(TextureViewCompatibility first, TextureViewCompatibility second)
|
|
{
|
|
return (TextureViewCompatibility)Math.Min((int)first, (int)second);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Checks if the sizes of two texture levels are copy compatible.
|
|
/// </summary>
|
|
/// <param name="lhs">Texture information of the texture view</param>
|
|
/// <param name="rhs">Texture information of the texture view to match against</param>
|
|
/// <param name="lhsLevel">Mipmap level of the texture view in relation to this texture</param>
|
|
/// <param name="rhsLevel">Mipmap level of the texture view in relation to the second texture</param>
|
|
/// <returns>True if both levels are view compatible</returns>
|
|
public static bool CopySizeMatches(TextureInfo lhs, TextureInfo rhs, int lhsLevel, int rhsLevel)
|
|
{
|
|
Size size = GetAlignedSize(lhs, lhsLevel);
|
|
|
|
Size otherSize = GetAlignedSize(rhs, rhsLevel);
|
|
|
|
if (size.Width == otherSize.Width && size.Height == otherSize.Height)
|
|
{
|
|
return true;
|
|
}
|
|
else if (lhs.IsLinear && rhs.IsLinear)
|
|
{
|
|
// Copy between linear textures with matching stride.
|
|
int stride = BitUtils.AlignUp(Math.Max(1, lhs.Stride >> lhsLevel), Constants.StrideAlignment);
|
|
|
|
return stride == rhs.Stride;
|
|
}
|
|
else
|
|
{
|
|
return false;
|
|
}
|
|
}
|
|
|
|
/// <summary>
|
|
/// Checks if the sizes of two given textures are view compatible.
|
|
/// </summary>
|
|
/// <param name="lhs">Texture information of the texture view</param>
|
|
/// <param name="rhs">Texture information of the texture view to match against</param>
|
|
/// <param name="exact">Indicates if the sizes must be exactly equal</param>
|
|
/// <param name="level">Mipmap level of the texture view in relation to this texture</param>
|
|
/// <returns>The view compatibility level of the view sizes</returns>
|
|
public static TextureViewCompatibility ViewSizeMatches(TextureInfo lhs, TextureInfo rhs, bool exact, int level)
|
|
{
|
|
Size lhsAlignedSize = GetAlignedSize(lhs, level);
|
|
Size rhsAlignedSize = GetAlignedSize(rhs);
|
|
|
|
Size lhsSize = GetSizeInBlocks(lhs, level);
|
|
Size rhsSize = GetSizeInBlocks(rhs);
|
|
|
|
bool alignedWidthMatches = lhsAlignedSize.Width == rhsAlignedSize.Width;
|
|
|
|
if (lhs.FormatInfo.BytesPerPixel != rhs.FormatInfo.BytesPerPixel && IsIncompatibleFormatAliasingAllowed(lhs.FormatInfo, rhs.FormatInfo))
|
|
{
|
|
// If the formats are incompatible, but the texture strides match,
|
|
// we might allow them to be copy compatible depending on the format.
|
|
// The strides are aligned because the format with higher bytes per pixel
|
|
// might need a bit of padding at the end due to one width not being a multiple of the other.
|
|
|
|
Debug.Assert((1 << BitOperations.Log2((uint)lhs.FormatInfo.BytesPerPixel)) == lhs.FormatInfo.BytesPerPixel);
|
|
Debug.Assert((1 << BitOperations.Log2((uint)rhs.FormatInfo.BytesPerPixel)) == rhs.FormatInfo.BytesPerPixel);
|
|
|
|
int alignment = Math.Max(lhs.FormatInfo.BytesPerPixel, rhs.FormatInfo.BytesPerPixel);
|
|
|
|
int lhsStride = BitUtils.AlignUp(lhsSize.Width * lhs.FormatInfo.BytesPerPixel, alignment);
|
|
int rhsStride = BitUtils.AlignUp(rhsSize.Width * rhs.FormatInfo.BytesPerPixel, alignment);
|
|
|
|
alignedWidthMatches = lhsStride == rhsStride;
|
|
}
|
|
|
|
TextureViewCompatibility result = TextureViewCompatibility.Full;
|
|
|
|
// For copies, we can copy a subset of the 3D texture slices,
|
|
// so the depth may be different in this case.
|
|
if (rhs.Target == Target.Texture3D && lhsSize.Depth != rhsSize.Depth)
|
|
{
|
|
result = TextureViewCompatibility.CopyOnly;
|
|
}
|
|
|
|
// Some APIs align the width for copy and render target textures,
|
|
// so the width may not match in this case for different uses of the same texture.
|
|
// To account for this, we compare the aligned width here.
|
|
// We expect height to always match exactly, if the texture is the same.
|
|
if (alignedWidthMatches && lhsSize.Height == rhsSize.Height)
|
|
{
|
|
return (exact && lhsSize.Width != rhsSize.Width) || lhsSize.Width < rhsSize.Width
|
|
? TextureViewCompatibility.CopyOnly
|
|
: result;
|
|
}
|
|
else if (lhs.IsLinear && rhs.IsLinear && lhsSize.Height == rhsSize.Height)
|
|
{
|
|
// Copy between linear textures with matching stride.
|
|
int stride = BitUtils.AlignUp(Math.Max(1, lhs.Stride >> level), Constants.StrideAlignment);
|
|
|
|
return stride == rhs.Stride ? TextureViewCompatibility.CopyOnly : TextureViewCompatibility.LayoutIncompatible;
|
|
}
|
|
else if (lhs.Target.IsMultisample() != rhs.Target.IsMultisample() && alignedWidthMatches && lhsAlignedSize.Height == rhsAlignedSize.Height)
|
|
{
|
|
// Copy between multisample and non-multisample textures with mismatching size is allowed,
|
|
// as long aligned size matches.
|
|
|
|
return TextureViewCompatibility.CopyOnly;
|
|
}
|
|
else
|
|
{
|
|
return TextureViewCompatibility.LayoutIncompatible;
|
|
}
|
|
}
|
|
|
|
/// <summary>
|
|
/// Checks if the potential child texture fits within the level and layer bounds of the parent.
|
|
/// </summary>
|
|
/// <param name="parent">Texture information for the parent</param>
|
|
/// <param name="child">Texture information for the child</param>
|
|
/// <param name="layer">Base layer of the child texture</param>
|
|
/// <param name="level">Base level of the child texture</param>
|
|
/// <returns>Full compatiblity if the child's layer and level count fit within the parent, incompatible otherwise</returns>
|
|
public static TextureViewCompatibility ViewSubImagesInBounds(TextureInfo parent, TextureInfo child, int layer, int level)
|
|
{
|
|
if (level + child.Levels <= parent.Levels &&
|
|
layer + child.GetSlices() <= parent.GetSlices())
|
|
{
|
|
return TextureViewCompatibility.Full;
|
|
}
|
|
else
|
|
{
|
|
return TextureViewCompatibility.LayoutIncompatible;
|
|
}
|
|
}
|
|
|
|
/// <summary>
|
|
/// Checks if the texture sizes of the supplied texture informations match.
|
|
/// </summary>
|
|
/// <param name="lhs">Texture information to compare</param>
|
|
/// <param name="rhs">Texture information to compare with</param>
|
|
/// <param name="exact">Indicates if the size must be exactly equal between the textures, or if <paramref name="rhs"/> is allowed to be larger</param>
|
|
/// <returns>True if the sizes matches, false otherwise</returns>
|
|
public static bool SizeMatches(TextureInfo lhs, TextureInfo rhs, bool exact)
|
|
{
|
|
if (lhs.GetLayers() != rhs.GetLayers())
|
|
{
|
|
return false;
|
|
}
|
|
|
|
Size lhsSize = GetSizeInBlocks(lhs);
|
|
Size rhsSize = GetSizeInBlocks(rhs);
|
|
|
|
if (exact || lhs.IsLinear || rhs.IsLinear)
|
|
{
|
|
return lhsSize.Width == rhsSize.Width &&
|
|
lhsSize.Height == rhsSize.Height &&
|
|
lhsSize.Depth == rhsSize.Depth;
|
|
}
|
|
else
|
|
{
|
|
Size lhsAlignedSize = GetAlignedSize(lhs);
|
|
Size rhsAlignedSize = GetAlignedSize(rhs);
|
|
|
|
return lhsAlignedSize.Width == rhsAlignedSize.Width &&
|
|
lhsSize.Width >= rhsSize.Width &&
|
|
lhsSize.Height == rhsSize.Height &&
|
|
lhsSize.Depth == rhsSize.Depth;
|
|
}
|
|
}
|
|
|
|
/// <summary>
|
|
/// Gets the aligned sizes for the given dimensions, using the specified texture information.
|
|
/// The alignment depends on the texture layout and format bytes per pixel.
|
|
/// </summary>
|
|
/// <param name="info">Texture information to calculate the aligned size from</param>
|
|
/// <param name="width">The width to be aligned</param>
|
|
/// <param name="height">The height to be aligned</param>
|
|
/// <param name="depth">The depth to be aligned</param>
|
|
/// <returns>The aligned texture size</returns>
|
|
private static Size GetAlignedSize(TextureInfo info, int width, int height, int depth)
|
|
{
|
|
if (info.IsLinear)
|
|
{
|
|
return SizeCalculator.GetLinearAlignedSize(
|
|
width,
|
|
height,
|
|
info.FormatInfo.BlockWidth,
|
|
info.FormatInfo.BlockHeight,
|
|
info.FormatInfo.BytesPerPixel);
|
|
}
|
|
else
|
|
{
|
|
return SizeCalculator.GetBlockLinearAlignedSize(
|
|
width,
|
|
height,
|
|
depth,
|
|
info.FormatInfo.BlockWidth,
|
|
info.FormatInfo.BlockHeight,
|
|
info.FormatInfo.BytesPerPixel,
|
|
info.GobBlocksInY,
|
|
info.GobBlocksInZ,
|
|
info.GobBlocksInTileX);
|
|
}
|
|
}
|
|
|
|
/// <summary>
|
|
/// Gets the aligned sizes of the specified texture information.
|
|
/// The alignment depends on the texture layout and format bytes per pixel.
|
|
/// </summary>
|
|
/// <param name="info">Texture information to calculate the aligned size from</param>
|
|
/// <param name="level">Mipmap level for texture views</param>
|
|
/// <returns>The aligned texture size</returns>
|
|
public static Size GetAlignedSize(TextureInfo info, int level = 0)
|
|
{
|
|
int width = Math.Max(1, info.Width >> level);
|
|
int height = Math.Max(1, info.Height >> level);
|
|
int depth = Math.Max(1, info.GetDepth() >> level);
|
|
|
|
return GetAlignedSize(info, width, height, depth);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Gets the size in blocks for the given texture information.
|
|
/// For non-compressed formats, that's the same as the regular size.
|
|
/// </summary>
|
|
/// <param name="info">Texture information to calculate the aligned size from</param>
|
|
/// <param name="level">Mipmap level for texture views</param>
|
|
/// <returns>The texture size in blocks</returns>
|
|
public static Size GetSizeInBlocks(TextureInfo info, int level = 0)
|
|
{
|
|
int width = Math.Max(1, info.Width >> level);
|
|
int height = Math.Max(1, info.Height >> level);
|
|
int depth = Math.Max(1, info.GetDepth() >> level);
|
|
|
|
return new Size(
|
|
BitUtils.DivRoundUp(width, info.FormatInfo.BlockWidth),
|
|
BitUtils.DivRoundUp(height, info.FormatInfo.BlockHeight),
|
|
depth);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Check if it's possible to create a view with the layout of the second texture information from the first.
|
|
/// The layout information is composed of the Stride for linear textures, or GOB block size
|
|
/// for block linear textures.
|
|
/// </summary>
|
|
/// <param name="lhs">Texture information of the texture view</param>
|
|
/// <param name="rhs">Texture information of the texture view to compare against</param>
|
|
/// <param name="level">Start level of the texture view, in relation with the first texture</param>
|
|
/// <returns>True if the layout is compatible, false otherwise</returns>
|
|
public static bool ViewLayoutCompatible(TextureInfo lhs, TextureInfo rhs, int level)
|
|
{
|
|
if (lhs.IsLinear != rhs.IsLinear)
|
|
{
|
|
return false;
|
|
}
|
|
|
|
// For linear textures, gob block sizes are ignored.
|
|
// For block linear textures, the stride is ignored.
|
|
if (rhs.IsLinear)
|
|
{
|
|
int stride = Math.Max(1, lhs.Stride >> level);
|
|
stride = BitUtils.AlignUp(stride, Constants.StrideAlignment);
|
|
|
|
return stride == rhs.Stride;
|
|
}
|
|
else
|
|
{
|
|
int height = Math.Max(1, lhs.Height >> level);
|
|
int depth = Math.Max(1, lhs.GetDepth() >> level);
|
|
|
|
(int gobBlocksInY, int gobBlocksInZ) = SizeCalculator.GetMipGobBlockSizes(
|
|
height,
|
|
depth,
|
|
lhs.FormatInfo.BlockHeight,
|
|
lhs.GobBlocksInY,
|
|
lhs.GobBlocksInZ,
|
|
level);
|
|
|
|
return gobBlocksInY == rhs.GobBlocksInY &&
|
|
gobBlocksInZ == rhs.GobBlocksInZ;
|
|
}
|
|
}
|
|
|
|
/// <summary>
|
|
/// Check if it's possible to create a view with the layout of the second texture information from the first.
|
|
/// The layout information is composed of the Stride for linear textures, or GOB block size
|
|
/// for block linear textures.
|
|
/// </summary>
|
|
/// <param name="lhs">Texture information of the texture view</param>
|
|
/// <param name="rhs">Texture information of the texture view to compare against</param>
|
|
/// <param name="lhsLevel">Start level of the texture view, in relation with the first texture</param>
|
|
/// <param name="rhsLevel">Start level of the texture view, in relation with the second texture</param>
|
|
/// <returns>True if the layout is compatible, false otherwise</returns>
|
|
public static bool ViewLayoutCompatible(TextureInfo lhs, TextureInfo rhs, int lhsLevel, int rhsLevel)
|
|
{
|
|
if (lhs.IsLinear != rhs.IsLinear)
|
|
{
|
|
return false;
|
|
}
|
|
|
|
// For linear textures, gob block sizes are ignored.
|
|
// For block linear textures, the stride is ignored.
|
|
if (rhs.IsLinear)
|
|
{
|
|
int lhsStride = Math.Max(1, lhs.Stride >> lhsLevel);
|
|
lhsStride = BitUtils.AlignUp(lhsStride, Constants.StrideAlignment);
|
|
|
|
int rhsStride = Math.Max(1, rhs.Stride >> rhsLevel);
|
|
rhsStride = BitUtils.AlignUp(rhsStride, Constants.StrideAlignment);
|
|
|
|
return lhsStride == rhsStride;
|
|
}
|
|
else
|
|
{
|
|
int lhsHeight = Math.Max(1, lhs.Height >> lhsLevel);
|
|
int lhsDepth = Math.Max(1, lhs.GetDepth() >> lhsLevel);
|
|
|
|
(int lhsGobBlocksInY, int lhsGobBlocksInZ) = SizeCalculator.GetMipGobBlockSizes(
|
|
lhsHeight,
|
|
lhsDepth,
|
|
lhs.FormatInfo.BlockHeight,
|
|
lhs.GobBlocksInY,
|
|
lhs.GobBlocksInZ,
|
|
lhsLevel);
|
|
|
|
int rhsHeight = Math.Max(1, rhs.Height >> rhsLevel);
|
|
int rhsDepth = Math.Max(1, rhs.GetDepth() >> rhsLevel);
|
|
|
|
(int rhsGobBlocksInY, int rhsGobBlocksInZ) = SizeCalculator.GetMipGobBlockSizes(
|
|
rhsHeight,
|
|
rhsDepth,
|
|
rhs.FormatInfo.BlockHeight,
|
|
rhs.GobBlocksInY,
|
|
rhs.GobBlocksInZ,
|
|
rhsLevel);
|
|
|
|
return lhsGobBlocksInY == rhsGobBlocksInY &&
|
|
lhsGobBlocksInZ == rhsGobBlocksInZ;
|
|
}
|
|
}
|
|
|
|
/// <summary>
|
|
/// Checks if the view format of the first texture format is compatible with the format of the second.
|
|
/// In general, the formats are considered compatible if the bytes per pixel values are equal,
|
|
/// but there are more complex rules for some formats, like compressed or depth-stencil formats.
|
|
/// This follows the host API copy compatibility rules.
|
|
/// </summary>
|
|
/// <param name="lhs">Texture information of the texture view</param>
|
|
/// <param name="rhs">Texture information of the texture view</param>
|
|
/// <param name="caps">Host GPU capabilities</param>
|
|
/// <param name="flags">Texture search flags</param>
|
|
/// <returns>The view compatibility level of the texture formats</returns>
|
|
public static TextureViewCompatibility ViewFormatCompatible(TextureInfo lhs, TextureInfo rhs, Capabilities caps, TextureSearchFlags flags)
|
|
{
|
|
FormatInfo lhsFormat = lhs.FormatInfo;
|
|
FormatInfo rhsFormat = rhs.FormatInfo;
|
|
|
|
if (lhsFormat.Format.IsDepthOrStencil() || rhsFormat.Format.IsDepthOrStencil())
|
|
{
|
|
bool forSampler = flags.HasFlag(TextureSearchFlags.ForSampler);
|
|
bool depthAlias = flags.HasFlag(TextureSearchFlags.DepthAlias);
|
|
|
|
TextureMatchQuality matchQuality = FormatMatches(lhs, rhs, forSampler, depthAlias);
|
|
|
|
if (matchQuality == TextureMatchQuality.Perfect)
|
|
{
|
|
return TextureViewCompatibility.Full;
|
|
}
|
|
else if (matchQuality == TextureMatchQuality.FormatAlias)
|
|
{
|
|
return TextureViewCompatibility.FormatAlias;
|
|
}
|
|
else if (IsValidColorAsDepthAlias(lhsFormat.Format, rhsFormat.Format) || IsValidDepthAsColorAlias(lhsFormat.Format, rhsFormat.Format))
|
|
{
|
|
return TextureViewCompatibility.CopyOnly;
|
|
}
|
|
else
|
|
{
|
|
return TextureViewCompatibility.Incompatible;
|
|
}
|
|
}
|
|
|
|
if (IsFormatHostIncompatible(lhs, caps) || IsFormatHostIncompatible(rhs, caps))
|
|
{
|
|
return lhsFormat.Format == rhsFormat.Format ? TextureViewCompatibility.Full : TextureViewCompatibility.Incompatible;
|
|
}
|
|
|
|
if (lhsFormat.IsCompressed && rhsFormat.IsCompressed)
|
|
{
|
|
FormatClass lhsClass = GetFormatClass(lhsFormat.Format);
|
|
FormatClass rhsClass = GetFormatClass(rhsFormat.Format);
|
|
|
|
return lhsClass == rhsClass ? TextureViewCompatibility.Full : TextureViewCompatibility.Incompatible;
|
|
}
|
|
else if (lhsFormat.BytesPerPixel == rhsFormat.BytesPerPixel)
|
|
{
|
|
return lhs.FormatInfo.IsCompressed == rhs.FormatInfo.IsCompressed
|
|
? TextureViewCompatibility.Full
|
|
: TextureViewCompatibility.CopyOnly;
|
|
}
|
|
else if (IsIncompatibleFormatAliasingAllowed(lhsFormat, rhsFormat))
|
|
{
|
|
return TextureViewCompatibility.CopyOnly;
|
|
}
|
|
|
|
return TextureViewCompatibility.Incompatible;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Checks if it's valid to alias a color format as a depth format.
|
|
/// </summary>
|
|
/// <param name="lhsFormat">Source format to be checked</param>
|
|
/// <param name="rhsFormat">Target format to be checked</param>
|
|
/// <returns>True if it's valid to alias the formats</returns>
|
|
private static bool IsValidColorAsDepthAlias(Format lhsFormat, Format rhsFormat)
|
|
{
|
|
return (lhsFormat == Format.R32Float && rhsFormat == Format.D32Float) ||
|
|
(lhsFormat == Format.R16Unorm && rhsFormat == Format.D16Unorm);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Checks if it's valid to alias a depth format as a color format.
|
|
/// </summary>
|
|
/// <param name="lhsFormat">Source format to be checked</param>
|
|
/// <param name="rhsFormat">Target format to be checked</param>
|
|
/// <returns>True if it's valid to alias the formats</returns>
|
|
private static bool IsValidDepthAsColorAlias(Format lhsFormat, Format rhsFormat)
|
|
{
|
|
return (lhsFormat == Format.D32Float && rhsFormat == Format.R32Float) ||
|
|
(lhsFormat == Format.D16Unorm && rhsFormat == Format.R16Unorm);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Checks if aliasing of two formats that would normally be considered incompatible be allowed,
|
|
/// using copy dependencies.
|
|
/// </summary>
|
|
/// <param name="lhsFormat">Format information of the first texture</param
|
|
/// <param name="rhsFormat">Format information of the second texture</param>
|
|
/// <returns>True if aliasing should be allowed, false otherwise</returns>
|
|
private static bool IsIncompatibleFormatAliasingAllowed(FormatInfo lhsFormat, FormatInfo rhsFormat)
|
|
{
|
|
// Some games will try to alias textures with incompatible foramts, with different BPP (bytes per pixel).
|
|
// We allow that in some cases as long Width * BPP is equal on both textures.
|
|
// This is very conservative right now as we want to avoid copies as much as possible,
|
|
// so we only consider the formats we have seen being aliased.
|
|
|
|
if (rhsFormat.BytesPerPixel < lhsFormat.BytesPerPixel)
|
|
{
|
|
(lhsFormat, rhsFormat) = (rhsFormat, lhsFormat);
|
|
}
|
|
|
|
return (lhsFormat.Format == Format.R8G8B8A8Unorm && rhsFormat.Format == Format.R32G32B32A32Float) ||
|
|
(lhsFormat.Format == Format.R8Unorm && rhsFormat.Format == Format.R8G8B8A8Unorm);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Check if the target of the first texture view information is compatible with the target of the second texture view information.
|
|
/// This follows the host API target compatibility rules.
|
|
/// </summary>
|
|
/// <param name="lhs">Texture information of the texture view</param
|
|
/// <param name="rhs">Texture information of the texture view</param>
|
|
/// <param name="caps">Host GPU capabilities</param>
|
|
/// <returns>True if the targets are compatible, false otherwise</returns>
|
|
public static TextureViewCompatibility ViewTargetCompatible(TextureInfo lhs, TextureInfo rhs, ref Capabilities caps)
|
|
{
|
|
bool result = false;
|
|
switch (lhs.Target)
|
|
{
|
|
case Target.Texture1D:
|
|
case Target.Texture1DArray:
|
|
result = rhs.Target == Target.Texture1D ||
|
|
rhs.Target == Target.Texture1DArray;
|
|
break;
|
|
|
|
case Target.Texture2D:
|
|
result = rhs.Target == Target.Texture2D ||
|
|
rhs.Target == Target.Texture2DArray;
|
|
break;
|
|
|
|
case Target.Texture2DArray:
|
|
result = rhs.Target == Target.Texture2D ||
|
|
rhs.Target == Target.Texture2DArray;
|
|
|
|
if (rhs.Target == Target.Cubemap || rhs.Target == Target.CubemapArray)
|
|
{
|
|
return caps.SupportsCubemapView ? TextureViewCompatibility.Full : TextureViewCompatibility.CopyOnly;
|
|
}
|
|
break;
|
|
case Target.Cubemap:
|
|
case Target.CubemapArray:
|
|
result = rhs.Target == Target.Cubemap ||
|
|
rhs.Target == Target.CubemapArray;
|
|
|
|
if (rhs.Target == Target.Texture2D || rhs.Target == Target.Texture2DArray)
|
|
{
|
|
return caps.SupportsCubemapView ? TextureViewCompatibility.Full : TextureViewCompatibility.CopyOnly;
|
|
}
|
|
break;
|
|
case Target.Texture2DMultisample:
|
|
case Target.Texture2DMultisampleArray:
|
|
if (rhs.Target == Target.Texture2D || rhs.Target == Target.Texture2DArray)
|
|
{
|
|
return TextureViewCompatibility.CopyOnly;
|
|
}
|
|
|
|
result = rhs.Target == Target.Texture2DMultisample ||
|
|
rhs.Target == Target.Texture2DMultisampleArray;
|
|
break;
|
|
|
|
case Target.Texture3D:
|
|
if (rhs.Target == Target.Texture2D)
|
|
{
|
|
return TextureViewCompatibility.CopyOnly;
|
|
}
|
|
|
|
result = rhs.Target == Target.Texture3D;
|
|
break;
|
|
}
|
|
|
|
return result ? TextureViewCompatibility.Full : TextureViewCompatibility.Incompatible;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Checks if the texture shader sampling parameters of two texture informations match.
|
|
/// </summary>
|
|
/// <param name="lhs">Texture information to compare</param>
|
|
/// <param name="rhs">Texture information to compare with</param>
|
|
/// <returns>True if the texture shader sampling parameters matches, false otherwise</returns>
|
|
public static bool SamplerParamsMatches(TextureInfo lhs, TextureInfo rhs)
|
|
{
|
|
return lhs.DepthStencilMode == rhs.DepthStencilMode &&
|
|
lhs.SwizzleR == rhs.SwizzleR &&
|
|
lhs.SwizzleG == rhs.SwizzleG &&
|
|
lhs.SwizzleB == rhs.SwizzleB &&
|
|
lhs.SwizzleA == rhs.SwizzleA;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Check if the texture target and samples count (for multisampled textures) matches.
|
|
/// </summary>
|
|
/// <param name="first">Texture information to compare with</param>
|
|
/// <param name="rhs">Texture information to compare with</param>
|
|
/// <returns>True if the texture target and samples count matches, false otherwise</returns>
|
|
public static bool TargetAndSamplesCompatible(TextureInfo lhs, TextureInfo rhs)
|
|
{
|
|
return lhs.Target == rhs.Target &&
|
|
lhs.SamplesInX == rhs.SamplesInX &&
|
|
lhs.SamplesInY == rhs.SamplesInY;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Gets the texture format class, for compressed textures, or Unclassified otherwise.
|
|
/// </summary>
|
|
/// <param name="format">The format</param>
|
|
/// <returns>Format class</returns>
|
|
private static FormatClass GetFormatClass(Format format)
|
|
{
|
|
return format switch
|
|
{
|
|
Format.Bc1RgbaSrgb or Format.Bc1RgbaUnorm => FormatClass.Bc1Rgba,
|
|
Format.Bc2Srgb or Format.Bc2Unorm => FormatClass.Bc2,
|
|
Format.Bc3Srgb or Format.Bc3Unorm => FormatClass.Bc3,
|
|
Format.Bc4Snorm or Format.Bc4Unorm => FormatClass.Bc4,
|
|
Format.Bc5Snorm or Format.Bc5Unorm => FormatClass.Bc5,
|
|
Format.Bc6HSfloat or Format.Bc6HUfloat => FormatClass.Bc6,
|
|
Format.Bc7Srgb or Format.Bc7Unorm => FormatClass.Bc7,
|
|
Format.Etc2RgbSrgb or Format.Etc2RgbUnorm => FormatClass.Etc2Rgb,
|
|
Format.Etc2RgbaSrgb or Format.Etc2RgbaUnorm => FormatClass.Etc2Rgba,
|
|
Format.Astc4x4Srgb or Format.Astc4x4Unorm => FormatClass.Astc4x4,
|
|
Format.Astc5x4Srgb or Format.Astc5x4Unorm => FormatClass.Astc5x4,
|
|
Format.Astc5x5Srgb or Format.Astc5x5Unorm => FormatClass.Astc5x5,
|
|
Format.Astc6x5Srgb or Format.Astc6x5Unorm => FormatClass.Astc6x5,
|
|
Format.Astc6x6Srgb or Format.Astc6x6Unorm => FormatClass.Astc6x6,
|
|
Format.Astc8x5Srgb or Format.Astc8x5Unorm => FormatClass.Astc8x5,
|
|
Format.Astc8x6Srgb or Format.Astc8x6Unorm => FormatClass.Astc8x6,
|
|
Format.Astc8x8Srgb or Format.Astc8x8Unorm => FormatClass.Astc8x8,
|
|
Format.Astc10x5Srgb or Format.Astc10x5Unorm => FormatClass.Astc10x5,
|
|
Format.Astc10x6Srgb or Format.Astc10x6Unorm => FormatClass.Astc10x6,
|
|
Format.Astc10x8Srgb or Format.Astc10x8Unorm => FormatClass.Astc10x8,
|
|
Format.Astc10x10Srgb or Format.Astc10x10Unorm => FormatClass.Astc10x10,
|
|
Format.Astc12x10Srgb or Format.Astc12x10Unorm => FormatClass.Astc12x10,
|
|
Format.Astc12x12Srgb or Format.Astc12x12Unorm => FormatClass.Astc12x12,
|
|
_ => FormatClass.Unclassified,
|
|
};
|
|
}
|
|
}
|
|
}
|