From 2d7b72a769b4085b893bfa3430fe7ac66c7f8f2b Mon Sep 17 00:00:00 2001
From: kd-11 <karokidii@gmail.com>
Date: Sat, 21 Feb 2026 17:44:06 +0300
Subject: [PATCH] rsx: Implement format_ex decoding for FS inputs

---
 rpcs3/Emu/RSX/RSXTexture.cpp | 61 ++++++++++++++++++++++++++++++++++++
 rpcs3/Emu/RSX/RSXTexture.h   |  3 ++
 rpcs3/Emu/RSX/color_utils.h  | 28 +++++++++++++++++
 3 files changed, 92 insertions(+)

diff --git a/rpcs3/Emu/RSX/RSXTexture.cpp b/rpcs3/Emu/RSX/RSXTexture.cpp
index e6483b51d7..6f8eec0e3b 100644
--- a/rpcs3/Emu/RSX/RSXTexture.cpp
+++ b/rpcs3/Emu/RSX/RSXTexture.cpp
@@ -2,6 +2,8 @@
 #include "RSXTexture.h"
 
 #include "rsx_utils.h"
+#include "Common/TextureUtils.h"
+#include "Program/GLSLCommon.h"
 
 #include "Emu/system_config.h"
 #include "util/simd.hpp"
@@ -63,6 +65,65 @@ namespace rsx
 		return ((registers[NV4097_SET_TEXTURE_FORMAT + (m_index * 8)] >> 8) & 0xff);
 	}
 
+	texture_format_ex fragment_texture::format_ex() const
+	{
+		const auto format_bits = format();
+		const auto base_format = format_bits & ~(CELL_GCM_TEXTURE_UN | CELL_GCM_TEXTURE_LN);
+		const auto format_features = rsx::get_format_features(base_format);
+		if (format_features == 0)
+		{
+			return { format_bits };
+		}
+
+		// NOTE: The unsigned_remap=bias flag being set flags the texture as being compressed normal (2n-1 / BX2) (UE3)
+		// NOTE: The ARGB8_signed flag means to reinterpret the raw bytes as signed. This is different than unsigned_remap=bias which does range decompression.
+		// This is a separate method of setting the format to signed mode without doing so per-channel
+		// Precedence = SNORM > GAMMA > UNSIGNED_REMAP/BX2
+		// Games using mixed flags: (See Resistance 3 for GAMMA/BX2 relationship, UE3 for BX2 effect)
+		u32 argb_signed_ = 0;
+		u32 unsigned_remap_ = 0;
+		u32 gamma_ = 0;
+
+		if (format_features & RSX_FORMAT_FEATURE_SIGNED_COMPONENTS)
+		{
+			// Tests show this is applied pre-readout. It's just a property of the incoming bytes and is therefore subject to remap.
+			argb_signed_ = decoded_remap().shuffle_mask_bits(argb_signed());
+		}
+
+		if (format_features & RSX_FORMAT_FEATURE_GAMMA_CORRECTION)
+		{
+			// Tests show this is applied post-readout. It's a property of the final value stored in the register and is not remapped.
+			// NOTE: GAMMA correction has no algorithmic effect on constants (0 and 1) so we need not mask it out for correctness.
+			gamma_ = gamma() & ~(argb_signed_);
+		}
+
+		if (format_features & RSX_FORMAT_FEATURE_BIASED_NORMALIZATION)
+		{
+			// The renormalization flag applies to all channels. It is weaker than the other flags.
+			// This applies on input and is subject to remap overrides
+			if (unsigned_remap() == CELL_GCM_TEXTURE_UNSIGNED_REMAP_BIASED)
+			{
+				unsigned_remap_ = decoded_remap().shuffle_mask_bits(0xFu) & ~(argb_signed_ | gamma_);
+			}
+		}
+
+		u32 format_convert = gamma_;
+
+		// The options are mutually exclusive
+		ensure((argb_signed_ & gamma_) == 0);
+		ensure((argb_signed_ & unsigned_remap_) == 0);
+		ensure((gamma_ & unsigned_remap_) == 0);
+
+		// NOTE: Hardware tests show that remapping bypasses the channel swizzles completely
+		format_convert |= (argb_signed_ << texture_control_bits::SEXT_OFFSET);
+		format_convert |= (unsigned_remap_ << texture_control_bits::EXPAND_OFFSET);
+
+		texture_format_ex result { format_bits };
+		result.features = format_features;
+		result.texel_remap_control = format_convert;
+		return result;
+	}
+
 	bool fragment_texture::is_compressed_format() const
 	{
 		int texture_format = format() & ~(CELL_GCM_TEXTURE_LN | CELL_GCM_TEXTURE_UN);
diff --git a/rpcs3/Emu/RSX/RSXTexture.h b/rpcs3/Emu/RSX/RSXTexture.h
index 5517a39e3f..3b0ccdebce 100644
--- a/rpcs3/Emu/RSX/RSXTexture.h
+++ b/rpcs3/Emu/RSX/RSXTexture.h
@@ -4,6 +4,8 @@
 
 namespace rsx
 {
+	struct texture_format_ex;
+
 	class fragment_texture
 	{
 	protected:
@@ -33,6 +35,7 @@ namespace rsx
 		// cubemap as a separate dimension.
 		rsx::texture_dimension_extended get_extended_texture_dimension() const;
 		u8 format() const;
+		texture_format_ex format_ex() const;
 		bool is_compressed_format() const;
 		u16 mipmap() const;
 
diff --git a/rpcs3/Emu/RSX/color_utils.h b/rpcs3/Emu/RSX/color_utils.h
index fd3156bd3e..40335c07e3 100644
--- a/rpcs3/Emu/RSX/color_utils.h
+++ b/rpcs3/Emu/RSX/color_utils.h
@@ -39,6 +39,34 @@ namespace rsx
 			return remapped;
 		}
 
+
+		/**
+		 * Remap color channel bits based on a remap vector. The output is a normalized selector of each color channel with spread.
+		 * The input bits are an action selector. e.g a mask of channels that need to be interpreted as SNORM or BX2
+		 * The output is a final mask on which post-sampling channels the operation applies to.
+		 * Examples:
+		 * - If we have remap as [ 1 R R R ] and mask of R (0010) then we get 1110. Remapper spreads 'R' action to all channels where it should apply.
+		 */
+		u32 shuffle_mask_bits(u32 bits) const
+		{
+			if (!bits || encoded == RSX_TEXTURE_REMAP_IDENTITY) [[likely]]
+			{
+				return bits;
+			}
+
+			u32 result = 0;
+			for (u8 channel = 0; channel < 4; ++channel)
+			{
+				if (control_map[channel] != CELL_GCM_TEXTURE_REMAP_REMAP ||    // Channel not read from input
+					(bits & (1u << channel_map[channel])) == 0)                // Input channel is not enabled in the mask
+				{
+					continue;
+				}
+				result |= (1u << channel);
+			}
+			return result;
+		}
+
 		template <typename T>
 			requires std::is_integral_v<T> || std::is_floating_point_v<T>
 		std::array<T, 4> remap(const std::array<T, 4>& components) const