using Ryujinx.Common; using Ryujinx.Graphics.GAL; using Ryujinx.Graphics.Texture; using System; namespace Ryujinx.Graphics.Gpu.Image { /// /// Texture format compatibility checks. /// 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 } /// /// Checks if a format is host incompatible. /// /// /// Host incompatible formats can't be used directly, the texture data needs to be converted /// to a compatible format first. /// /// Texture information /// Host GPU capabilities /// True if the format is incompatible, false otherwise public static bool IsFormatHostIncompatible(TextureInfo info, Capabilities caps) { Format originalFormat = info.FormatInfo.Format; return ToHostCompatibleFormat(info, caps).Format != originalFormat; } /// /// Converts a incompatible format to a host compatible format, or return the format directly /// if it is already host compatible. /// /// /// This can be used to convert a incompatible compressed format to the decompressor /// output format. /// /// Texture information /// Host GPU capabilities /// A host compatible format 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; } /// /// Checks if the host API supports a given texture compression format of the BC family. /// /// BC format to be checked /// Target usage of the texture /// Host GPU Capabilities /// True if the texture host supports the format with the given target usage, false otherwise 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; } /// /// Determines whether a texture can flush its data back to guest memory. /// /// Texture information /// Host GPU Capabilities /// True if the texture can flush, false otherwise 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; } /// /// Checks if the texture format matches with the specified texture information. /// /// Texture information to compare /// Texture information to compare with /// Indicates that the texture will be used for shader sampling /// Indicates if aliasing between color and depth format should be allowed /// A value indicating how well the formats match 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 (lhs.FormatInfo.Format == Format.D32Float && rhs.FormatInfo.Format == Format.R32Float && (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; } if (lhs.FormatInfo.Format == Format.D16Unorm && rhs.FormatInfo.Format == Format.R16Unorm) { return TextureMatchQuality.FormatAlias; } 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; } /// /// 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. /// /// Texture information to compare /// Texture information to compare with /// True if the layout matches, false otherwise 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; } } /// /// Obtain the minimum compatibility level of two provided view compatibility results. /// /// The first compatibility level /// The second compatibility level /// The minimum compatibility level of two provided view compatibility results public static TextureViewCompatibility PropagateViewCompatibility(TextureViewCompatibility first, TextureViewCompatibility second) { if (first == TextureViewCompatibility.Incompatible || second == TextureViewCompatibility.Incompatible) { return TextureViewCompatibility.Incompatible; } else if (first == TextureViewCompatibility.LayoutIncompatible || second == TextureViewCompatibility.LayoutIncompatible) { return TextureViewCompatibility.LayoutIncompatible; } else if (first == TextureViewCompatibility.CopyOnly || second == TextureViewCompatibility.CopyOnly) { return TextureViewCompatibility.CopyOnly; } else { return TextureViewCompatibility.Full; } } /// /// Checks if the sizes of two texture levels are copy compatible. /// /// Texture information of the texture view /// Texture information of the texture view to match against /// Mipmap level of the texture view in relation to this texture /// Mipmap level of the texture view in relation to the second texture /// True if both levels are view compatible 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; } } /// /// Checks if the sizes of two given textures are view compatible. /// /// Texture information of the texture view /// Texture information of the texture view to match against /// Indicates if the sizes must be exactly equal /// Mipmap level of the texture view in relation to this texture /// The view compatibility level of the view sizes 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)) { alignedWidthMatches = lhsSize.Width * lhs.FormatInfo.BytesPerPixel == rhsSize.Width * rhs.FormatInfo.BytesPerPixel; } 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 { return TextureViewCompatibility.LayoutIncompatible; } } /// /// Checks if the potential child texture fits within the level and layer bounds of the parent. /// /// Texture information for the parent /// Texture information for the child /// Base layer of the child texture /// Base level of the child texture /// Full compatiblity if the child's layer and level count fit within the parent, incompatible otherwise 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; } } /// /// Checks if the texture sizes of the supplied texture informations match. /// /// Texture information to compare /// Texture information to compare with /// Indicates if the size must be exactly equal between the textures, or if is allowed to be larger /// True if the sizes matches, false otherwise 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; } } /// /// 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. /// /// Texture information to calculate the aligned size from /// The width to be aligned /// The height to be aligned /// The depth to be aligned /// The aligned texture size 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); } } /// /// Gets the aligned sizes of the specified texture information. /// The alignment depends on the texture layout and format bytes per pixel. /// /// Texture information to calculate the aligned size from /// Mipmap level for texture views /// The aligned texture size 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); } /// /// Gets the size in blocks for the given texture information. /// For non-compressed formats, that's the same as the regular size. /// /// Texture information to calculate the aligned size from /// Mipmap level for texture views /// The texture size in blocks 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); } /// /// 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. /// /// Texture information of the texture view /// Texture information of the texture view to compare against /// Start level of the texture view, in relation with the first texture /// True if the layout is compatible, false otherwise 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); return gobBlocksInY == rhs.GobBlocksInY && gobBlocksInZ == rhs.GobBlocksInZ; } } /// /// 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. /// /// Texture information of the texture view /// Texture information of the texture view to compare against /// Start level of the texture view, in relation with the first texture /// Start level of the texture view, in relation with the second texture /// True if the layout is compatible, false otherwise 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); 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); return lhsGobBlocksInY == rhsGobBlocksInY && lhsGobBlocksInZ == rhsGobBlocksInZ; } } /// /// 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. /// /// Texture information of the texture view /// Texture information of the texture view /// Host GPU capabilities /// The view compatibility level of the texture formats public static TextureViewCompatibility ViewFormatCompatible(TextureInfo lhs, TextureInfo rhs, Capabilities caps) { FormatInfo lhsFormat = lhs.FormatInfo; FormatInfo rhsFormat = rhs.FormatInfo; if (lhsFormat.Format.IsDepthOrStencil() || rhsFormat.Format.IsDepthOrStencil()) { return lhsFormat.Format == rhsFormat.Format ? TextureViewCompatibility.Full : 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; } /// /// Checks if aliasing of two formats that would normally be considered incompatible be allowed, /// using copy dependencies. /// /// Format information of the first textureFormat information of the second texture /// True if aliasing should be allowed, false otherwise 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.R8Unorm && rhsFormat.Format == Format.R8G8B8A8Unorm; } /// /// 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. /// /// Texture information of the texture viewTexture information of the texture view /// Host GPU capabilities /// True if the targets are compatible, false otherwise 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; } /// /// Checks if a swizzle component in two textures functionally match, taking into account if the components are defined. /// /// Texture information to compare /// Texture information to compare with /// Swizzle component for the first texture /// Swizzle component for the second texture /// Component index, starting at 0 for red /// True if the swizzle components functionally match, false othersize private static bool SwizzleComponentMatches(TextureInfo lhs, TextureInfo rhs, SwizzleComponent swizzleLhs, SwizzleComponent swizzleRhs, int component) { int lhsComponents = lhs.FormatInfo.Components; int rhsComponents = rhs.FormatInfo.Components; if (lhsComponents == 4 && rhsComponents == 4) { return swizzleLhs == swizzleRhs; } // Swizzles after the number of components a format defines are "undefined". // We allow these to not be equal under certain circumstances. // This can only happen when there are less than 4 components in a format. // It tends to happen when float depth textures are sampled. bool lhsDefined = (swizzleLhs - SwizzleComponent.Red) < lhsComponents; bool rhsDefined = (swizzleRhs - SwizzleComponent.Red) < rhsComponents; if (lhsDefined == rhsDefined) { // If both are undefined, return true. Otherwise just check if they're equal. return lhsDefined ? swizzleLhs == swizzleRhs : true; } else { SwizzleComponent defined = lhsDefined ? swizzleLhs : swizzleRhs; SwizzleComponent undefined = lhsDefined ? swizzleRhs : swizzleLhs; // Undefined swizzle can be matched by a forced value (0, 1), exact equality, or expected value. // For example, R___ matches R001, RGBA but not RBGA. return defined == undefined || defined < SwizzleComponent.Red || defined == SwizzleComponent.Red + component; } } /// /// Checks if the texture shader sampling parameters of two texture informations match. /// /// Texture information to compare /// Texture information to compare with /// True if the texture shader sampling parameters matches, false otherwise public static bool SamplerParamsMatches(TextureInfo lhs, TextureInfo rhs) { return lhs.DepthStencilMode == rhs.DepthStencilMode && SwizzleComponentMatches(lhs, rhs, lhs.SwizzleR, rhs.SwizzleR, 0) && SwizzleComponentMatches(lhs, rhs, lhs.SwizzleG, rhs.SwizzleG, 1) && SwizzleComponentMatches(lhs, rhs, lhs.SwizzleB, rhs.SwizzleB, 2) && SwizzleComponentMatches(lhs, rhs, lhs.SwizzleA, rhs.SwizzleA, 3); } /// /// Check if the texture target and samples count (for multisampled textures) matches. /// /// Texture information to compare with /// Texture information to compare with /// True if the texture target and samples count matches, false otherwise public static bool TargetAndSamplesCompatible(TextureInfo lhs, TextureInfo rhs) { return lhs.Target == rhs.Target && lhs.SamplesInX == rhs.SamplesInX && lhs.SamplesInY == rhs.SamplesInY; } /// /// Gets the texture format class, for compressed textures, or Unclassified otherwise. /// /// The format /// Format class private static FormatClass GetFormatClass(Format format) { switch (format) { case Format.Bc1RgbaSrgb: case Format.Bc1RgbaUnorm: return FormatClass.Bc1Rgba; case Format.Bc2Srgb: case Format.Bc2Unorm: return FormatClass.Bc2; case Format.Bc3Srgb: case Format.Bc3Unorm: return FormatClass.Bc3; case Format.Bc4Snorm: case Format.Bc4Unorm: return FormatClass.Bc4; case Format.Bc5Snorm: case Format.Bc5Unorm: return FormatClass.Bc5; case Format.Bc6HSfloat: case Format.Bc6HUfloat: return FormatClass.Bc6; case Format.Bc7Srgb: case Format.Bc7Unorm: return FormatClass.Bc7; case Format.Etc2RgbSrgb: case Format.Etc2RgbUnorm: return FormatClass.Etc2Rgb; case Format.Etc2RgbaSrgb: case Format.Etc2RgbaUnorm: return FormatClass.Etc2Rgba; case Format.Astc4x4Srgb: case Format.Astc4x4Unorm: return FormatClass.Astc4x4; case Format.Astc5x4Srgb: case Format.Astc5x4Unorm: return FormatClass.Astc5x4; case Format.Astc5x5Srgb: case Format.Astc5x5Unorm: return FormatClass.Astc5x5; case Format.Astc6x5Srgb: case Format.Astc6x5Unorm: return FormatClass.Astc6x5; case Format.Astc6x6Srgb: case Format.Astc6x6Unorm: return FormatClass.Astc6x6; case Format.Astc8x5Srgb: case Format.Astc8x5Unorm: return FormatClass.Astc8x5; case Format.Astc8x6Srgb: case Format.Astc8x6Unorm: return FormatClass.Astc8x6; case Format.Astc8x8Srgb: case Format.Astc8x8Unorm: return FormatClass.Astc8x8; case Format.Astc10x5Srgb: case Format.Astc10x5Unorm: return FormatClass.Astc10x5; case Format.Astc10x6Srgb: case Format.Astc10x6Unorm: return FormatClass.Astc10x6; case Format.Astc10x8Srgb: case Format.Astc10x8Unorm: return FormatClass.Astc10x8; case Format.Astc10x10Srgb: case Format.Astc10x10Unorm: return FormatClass.Astc10x10; case Format.Astc12x10Srgb: case Format.Astc12x10Unorm: return FormatClass.Astc12x10; case Format.Astc12x12Srgb: case Format.Astc12x12Unorm: return FormatClass.Astc12x12; } return FormatClass.Unclassified; } } }