Add Convert Color Space Menu to Ramp Atlas

Author: JasonMa0012

.obsidian/hotkeys.json

@@ -0,0 +1,11 @@
+{
+  "markdown:toggle-preview": [],
+  "editor:toggle-source": [
+    {
+      "modifiers": [
+        "Mod"
+      ],
+      "key": "E"
+    }
+  ]
+}

.obsidian/workspace.json

@@ -108,13 +108,13 @@
             "state": {
               "type": "outline",
               "state": {
-                "file": "README.md",
+                "file": "README_CN.md",
                 "followCursor": false,
                 "showSearch": false,
                 "searchQuery": ""
               },
               "icon": "lucide-list",
-              "title": "Outline of README"
+              "title": "Outline of README_CN"
             }
           }
         ]
@@ -208,8 +208,10 @@
       "obsidian-git:Open Git source control": false
     }
   },
-  "active": "d93ffc2d4e7b14bd",
+  "active": "1ab61776fdab9c7c",
   "lastOpenFiles": [
+    "package.json~",
+    "README.md",
     "README_CN.md",
     "Editor/ScriptableObject.meta",
     "Editor/ScriptableObject/LwguiShaderPropertyPreset.cs.meta",
@@ -221,7 +223,6 @@
     "Editor/ScriptableObject",
     "Editor/ScriptableObject/LWGUIShaderPropertyPreset.cs",
     "Editor/ScriptableObject/LWGUIRampAtlas.cs.meta",
-    "README.md",
     "assets~/Pasted image 20250523120309.png",
     "assets~/Pasted image 20250522183200.png",
     "assets~/Pasted image 20250321174432.png",

Editor/ScriptableObject/LwguiRampAtlas.cs

@@ -211,6 +211,38 @@ public void DiscardChanges()
 			EditorUtility.ClearDirty(this);
 		}
 
+		public void ConvertColorSpace(ColorSpace targetColorSpace)
+		{
+			foreach (var ramp in ramps)
+			{
+				if (ramp.colorSpace != targetColorSpace)
+				{
+					ramp.colorSpace = targetColorSpace;
+					ramp.gradient.ConvertColorSpaceWithoutCopy(
+						targetColorSpace != ColorSpace.Gamma
+						? ColorSpace.Linear
+						: ColorSpace.Gamma);
+				}
+			}
+			
+			rampAtlasSRGB = targetColorSpace == ColorSpace.Gamma;
+			RampHelper.SetRampTextureImporter(_rampAtlasTexturePath, true, !rampAtlasSRGB, EditorJsonUtility.ToJson(this));
+			UpdateTexturePixels();
+			SaveTexture();
+		}
+		
+		[ContextMenu("Convert Gamma To Linear")]
+		public void ConvertGammaToLinear()
+		{
+			ConvertColorSpace(ColorSpace.Linear);
+		}
+
+		[ContextMenu("Convert Linear To Gamma")]
+		public void ConvertLinearToGamma()
+		{
+			ConvertColorSpace(ColorSpace.Gamma);
+		}
+
 		private void OnEnable()
 		{
 			InitData();
@@ -382,6 +414,5 @@ public static LwguiRampAtlas SaveRampAtlasSOToAsset(LwguiRampAtlas rampAtlasSO,
 
 			return null;
 		}
-
 	}
 }

Editor/ShaderDrawer.cs

@@ -805,18 +805,24 @@ public override void Apply(MaterialProperty prop)
 	/// Note:
 	///		- Currently only 8 bits are supported.
 	///
-	/// Warning: If used to set Stencil, it will conflict with SRP Batcher!  
+	/// Warning 1: If used to set Stencil, it will conflict with SRP Batcher!  
 	///		(Reproduced in Unity 2022)  
 	///		SRP Batcher does not correctly handle multiple materials with different Stencil Ref values,  
 	///		mistakenly merging them into a single Batch and randomly selecting one material's Stencil Ref value for the entire Batch.  
 	///		In theory, if different materials have different Stencil Ref values, they should not be merged into a single Batch due to differing Render States.  
 	/// Solution:  
 	///		- Force disable SRP Batcher by setting the Material Property Block  
 	///		- Place materials with the same Stencil Ref value in a separate Render Queue to ensure the Batch's Render State is correct
-	///  
+	///
+	/// Warning 2: Once in use, do not change the Target Property Type!
+	///		The underlying type of Int Property is Float Property, and in Materials, Int and Integer are stored separately.  
+	///		Once a Material is saved, the Property Type is determined.  
+	///		If you change the Property Type at this point (such as switching between Int/Integer), some strange bugs may occur.  
+	///		If you must change the Property Type, it is recommended to modify the Property Name as well or delete the saved Property in the material.
+	/// 
 	/// group: parent group name (Default: none)
 	/// bitDescription 7-0: Description of each Bit. (Default: none)
-	/// Target Property Type: Int
+	/// Target Property Type: Int/Integer
 	/// </summary>
 	public class BitMaskDrawer : SubDrawer
 	{

README.md

@@ -374,6 +374,20 @@ The Property Value in the selected Preset will be the default value:
 /// Note:
 ///    - Currently only 8 bits are supported.
 ///
+/// Warning 1: If used to set Stencil, it will conflict with SRP Batcher!  
+///		(Reproduced in Unity 2022)  
+///		SRP Batcher does not correctly handle multiple materials with different Stencil Ref values,  
+///		mistakenly merging them into a single Batch and randomly selecting one material's Stencil Ref value for the entire Batch.  
+///		In theory, if different materials have different Stencil Ref values, they should not be merged into a single Batch due to differing Render States.  
+/// Solution:  
+///		- Force disable SRP Batcher by setting the Material Property Block  
+///		- Place materials with the same Stencil Ref value in a separate Render Queue to ensure the Batch's Render State is correct
+///
+/// Warning 2: Once in use, do not change the Target Property Type!
+///		The underlying type of Int Property is Float Property, and in Materials, Int and Integer are stored separately.  
+///		Once a Material is saved, the Property Type is determined.  
+///		If you change the Property Type at this point (such as switching between Int/Integer), some strange bugs may occur.  
+///		If you must change the Property Type, it is recommended to modify the Property Name as well or delete the saved Property in the material.
 /// group: parent group name (Default: none)
 /// bitDescription 7-0: Description of each Bit. (Default: none)
 /// Target Property Type: Int
@@ -606,7 +620,9 @@ You can create an SO in the following ways:
 - Right-click on a material property using RampAtlas(): `Create Ramp Atlas` or `Clone Ramp Atlas`  
   - An SO created this way will include default values for all Ramps in the current material.  
 
-You can click the add button of RampAtlasIndexer() to add a new Ramp to the SO.
+You can click the add button of RampAtlasIndexer() to add a new Ramp to the SO. 
+
+The context menu in the upper right corner has a one-click color space conversion feature.
 
 > [!CAUTION] 
 >Currently, the material only saves Texture references and Int values. If you manually modify the number and order of Ramps in the Ramp Atlas SO, the selected Ramps in the material may be disrupted!  

README_CN.md

@@ -371,6 +371,20 @@ Result:
 /// Note:
 ///    - Currently only 8 bits are supported.
 ///
+/// Warning 1: If used to set Stencil, it will conflict with SRP Batcher!  
+///		(Reproduced in Unity 2022)  
+///		SRP Batcher does not correctly handle multiple materials with different Stencil Ref values,  
+///		mistakenly merging them into a single Batch and randomly selecting one material's Stencil Ref value for the entire Batch.  
+///		In theory, if different materials have different Stencil Ref values, they should not be merged into a single Batch due to differing Render States.  
+/// Solution:  
+///		- Force disable SRP Batcher by setting the Material Property Block  
+///		- Place materials with the same Stencil Ref value in a separate Render Queue to ensure the Batch's Render State is correct
+///
+/// Warning 2: Once in use, do not change the Target Property Type!
+///		The underlying type of Int Property is Float Property, and in Materials, Int and Integer are stored separately.  
+///		Once a Material is saved, the Property Type is determined.  
+///		If you change the Property Type at this point (such as switching between Int/Integer), some strange bugs may occur.  
+///		If you must change the Property Type, it is recommended to modify the Property Name as well or delete the saved Property in the material.
 /// group: parent group name (Default: none)
 /// bitDescription 7-0: Description of each Bit. (Default: none)
 /// Target Property Type: Int
@@ -601,7 +615,9 @@ Ramp Atlas SO负责存储并生成Ramp Atlas Texture:
 - 在使用RampAtlas()的材质属性上右键: `Create Ramp Atlas`或`Clone Ramp Atlas`
 	- 用这种方式创建的SO会包含当前材质中所有Ramp的默认值
 
-你可以点击RampAtlasIndexer()的添加按钮向SO添加新的Ramp.
+你可以点击RampAtlasIndexer()的添加按钮向SO添加新的Ramp.  
+
+右上角的上下文菜单中有一键转换颜色空间功能.
 
 > [!CAUTION]
 > 目前材质仅保存Texture引用和Int值, 如果你手动修改了Ramp Atlas SO中的Ramp数量和顺序, 那么材质中已选择的Ramp可能被打乱!

Runtime/LwguiGradient/LwguiGradient.cs

@@ -524,5 +524,35 @@ public Gradient ToGradient(int maxGradientKeyCount = 8)
         }
 
         #endregion
+
+        #region Gamma <=> Linear
+
+        public LwguiGradient ConvertColorSpaceWithoutCopy(ColorSpace targetColorSpace)
+        {
+            for (int c = 0; c < (int)Channel.Num; c++)
+            {
+                if (c != (int)Channel.Alpha)
+                {
+                    var keys = rawCurves[c].keys;
+                    for (int i = 0; i < keys.Length; i++)
+                    {
+                        if (targetColorSpace == ColorSpace.Gamma)
+                            keys[i].value = Mathf.LinearToGammaSpace(keys[i].value);
+                        else
+                            keys[i].value = Mathf.GammaToLinearSpace(keys[i].value);
+                    }
+
+                    rawCurves[c].keys = keys;
+                }
+            }
+
+            return this;
+        }
+
+        public LwguiGradient gamma => new LwguiGradient(this).ConvertColorSpaceWithoutCopy(ColorSpace.Gamma);
+        
+        public LwguiGradient linear => new LwguiGradient(this).ConvertColorSpaceWithoutCopy(ColorSpace.Linear);
+
+        #endregion
     }
 }

package.json

@@ -1,6 +1,6 @@
 {
   "name": "com.jasonma.lwgui",
-  "version": "1.26.2",
+  "version": "1.27.0",
   "displayName": "LWGUI",
   "description": "A Lightweight, Flexible, Powerful Shader GUI System for Unity.",
   "keywords": [