From b34312250f6712333c8ce783758cc760290be204 Mon Sep 17 00:00:00 2001
From: LMW <williamchange@gmail.com>
Date: Mon, 18 Dec 2023 13:21:17 +0800
Subject: [PATCH 1/3] Add Hue, Saturation, Color and Value blend modes

---
 addons/material_maker/nodes/blend2.mmg        |  83 +++++++++++++++++-
 material_maker/doc/images/blend_color.png     | Bin 0 -> 4138 bytes
 material_maker/doc/images/blend_hue.png       | Bin 0 -> 6784 bytes
 .../doc/images/blend_saturation.png           | Bin 0 -> 6755 bytes
 material_maker/doc/images/blend_value.png     | Bin 0 -> 3906 bytes
 material_maker/doc/node_filter_blend.rst      |  16 ++++
 6 files changed, 97 insertions(+), 2 deletions(-)
 create mode 100644 material_maker/doc/images/blend_color.png
 create mode 100644 material_maker/doc/images/blend_hue.png
 create mode 100644 material_maker/doc/images/blend_saturation.png
 create mode 100644 material_maker/doc/images/blend_value.png

diff --git a/addons/material_maker/nodes/blend2.mmg b/addons/material_maker/nodes/blend2.mmg
index 626edc14..69808271 100644
--- a/addons/material_maker/nodes/blend2.mmg
+++ b/addons/material_maker/nodes/blend2.mmg
@@ -6,7 +6,7 @@
 		"y": 0
 	},
 	"parameters": {
-		"amount1": 0.5,
+		"amount1": 1,
 		"blend_type1": 0
 	},
 	"seed_int": 0,
@@ -61,10 +61,73 @@
 			"",
 			"vec3 blend_exclusion(vec2 uv, vec3 c1, vec3 c2, float opacity) {",
 			"\treturn opacity*vec3(blend_exclusion_f(c1.x, c2.x), blend_exclusion_f(c1.y, c2.y), blend_exclusion_f(c1.z, c2.z)) + (1.0-opacity)*c2;",
+			"}",
+			"",
+			"vec3 blend_hue(vec2 uv, vec3 c1, vec3 c2, float opacity) {",
+			"\tvec3 outcol = c2;",
+			"",
+			"\tvec3 hsv, hsv2, tmp;",
+			"\thsv2 = rgb_to_hsv(c1);",
+			"",
+			"\tif (hsv2.y != 0.0) {",
+			"\t\thsv = rgb_to_hsv(outcol);",
+			"\t\thsv.x = hsv2.x;",
+			"\t\ttmp = hsv_to_rgb(hsv);",
+			"\t\toutcol = mix(outcol, tmp, opacity);",
+			"\t}",
+			"\treturn outcol;",
+			"}",
+			"",
+			"vec3 blend_saturation(vec2 uv, vec3 c1, vec3 c2, float opacity) {",
+			"\tfloat facm = 1.0 - opacity;",
+			"",
+			"\tvec3 outcol = c2;",
+			"\tvec3 hsv, hsv2;",
+			"",
+			"\thsv = rgb_to_hsv(outcol);",
+			"",
+			"\tif (hsv.y != 0.0) {",
+			"\t\thsv2 = rgb_to_hsv(c1);",
+			"",
+			"\t\thsv.y = facm * hsv.y + opacity * hsv2.y;",
+			"\t\toutcol = hsv_to_rgb(hsv);",
+			"\t}",
+			"\treturn outcol;",
+			"}",
+			"",
+			"vec3 blend_color(vec2 uv, vec3 c1, vec3 c2, float opacity) {",
+			"\tfloat facm = 1.0 - opacity;",
+			"",
+			"\tvec3 outcol = c2;",
+			"",
+			"\tvec3 hsv, hsv2, tmp;",
+			"\thsv2 = rgb_to_hsv(c1);",
+			"",
+			"\tif (hsv2.y != 0.0) {",
+			"\t\thsv = rgb_to_hsv(outcol);",
+			"\t\thsv.x = hsv2.x;",
+			"\t\thsv.y = hsv2.y;",
+			"\t\ttmp = hsv_to_rgb(hsv);",
+			"",
+			"\t\toutcol = mix(outcol, tmp, opacity);",
+			"\t}",
+			"\treturn outcol;",
+			"}",
+			"",
+			"vec3 blend_value(vec2 uv, vec3 c1, vec3 c2, float opacity) {",
+			"\tfloat facm = 1.0 - opacity;",
+			"",
+			"\tvec3 hsv, hsv2;",
+			"\thsv = rgb_to_hsv(c2);",
+			"\thsv2 = rgb_to_hsv(c1);",
+			"",
+			"\thsv.z = facm * hsv.z + opacity * hsv2.z;",
+			"\treturn hsv_to_rgb(hsv);",
 			"}"
 		],
 		"includes": [
-			"blend"
+			"blend",
+			"adjust_hsv"
 		],
 		"inputs": [
 			{
@@ -187,6 +250,22 @@
 					{
 						"name": "Exclusion",
 						"value": "exclusion"
+					},
+					{
+						"name": "Hue",
+						"value": "hue"
+					},
+					{
+						"name": "Saturation",
+						"value": "saturation"
+					},
+					{
+						"name": "Color",
+						"value": "color"
+					},
+					{
+						"name": "Value",
+						"value": "value"
 					}
 				]
 			},
diff --git a/material_maker/doc/images/blend_color.png b/material_maker/doc/images/blend_color.png
new file mode 100644
index 0000000000000000000000000000000000000000..c76772f128a5d135cd71d9d5b0ee7c3a15aab821
GIT binary patch
literal 4138
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
E0KbK}hyVZp

literal 0
HcmV?d00001

diff --git a/material_maker/doc/images/blend_hue.png b/material_maker/doc/images/blend_hue.png
new file mode 100644
index 0000000000000000000000000000000000000000..509b6778dd0f60fcd96b121beeb8faf5ee634756
GIT binary patch
literal 6784
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

literal 0
HcmV?d00001

diff --git a/material_maker/doc/images/blend_saturation.png b/material_maker/doc/images/blend_saturation.png
new file mode 100644
index 0000000000000000000000000000000000000000..589ad4af85aa3b41948388545ef12227950797bf
GIT binary patch
literal 6755
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

literal 0
HcmV?d00001

diff --git a/material_maker/doc/images/blend_value.png b/material_maker/doc/images/blend_value.png
new file mode 100644
index 0000000000000000000000000000000000000000..a17534028b531c3793bcd8ebac4f61f64d09d622
GIT binary patch
literal 3906
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

literal 0
HcmV?d00001

diff --git a/material_maker/doc/node_filter_blend.rst b/material_maker/doc/node_filter_blend.rst
index 611c2879..120764aa 100644
--- a/material_maker/doc/node_filter_blend.rst
+++ b/material_maker/doc/node_filter_blend.rst
@@ -83,6 +83,14 @@ Blending modes
 
 .. |blend_exclusion| image:: images/blend_exclusion.png
 
+.. |blend_hue| image:: images/blend_hue.png
+
+.. |blend_saturation| image:: images/blend_saturation.png
+
+.. |blend_color| image:: images/blend_color.png
+
+.. |blend_value| image:: images/blend_value.png
+
 +-----------------------+-------------------------------+-------------------------------------------------------------------------------------------------------------------------------+
 | Blend mode            | Example                       | Description                                                                                                                   |
 +=======================+===============================+===============================================================================================================================+
@@ -124,6 +132,14 @@ Blending modes
 +-----------------------+-------------------------------+-------------------------------------------------------------------------------------------------------------------------------+
 | Exclusion             | |blend_exclusion|             | This blend mode is similar to Difference, but it is less intense                                                              |
 +-----------------------+-------------------------------+-------------------------------------------------------------------------------------------------------------------------------+
+| Hue                   | |blend_hue|                   | This blend mode takes the hue of the bottom layer and combines them with the saturation and value of the top layer            |
++-----------------------+-------------------------------+-------------------------------------------------------------------------------------------------------------------------------+
+| Saturation            | |blend_saturation|            | This blend mode takes the saturation of the bottom layer and combines them with the hue and value of the top layer            |
++-----------------------+-------------------------------+-------------------------------------------------------------------------------------------------------------------------------+
+| Color                 | |blend_color|                 | This blend mode takes the hue and saturation of the bottom layer and combines them with the value of the top layer            |
++-----------------------+-------------------------------+-------------------------------------------------------------------------------------------------------------------------------+
+| Value                 | |blend_value|                 | This blend mode takes the value of the bottom layer and combines them with the hue and saturation of the top layer            |
++-----------------------+-------------------------------+-------------------------------------------------------------------------------------------------------------------------------+
 
 Notes
 +++++

From 07bd5c156dea6cc5f965a550dc48312e844cec32 Mon Sep 17 00:00:00 2001
From: LMW <williamchange@gmail.com>
Date: Mon, 18 Dec 2023 13:31:31 +0800
Subject: [PATCH 2/3] reverts to 0.5 for default opacity

---
 addons/material_maker/nodes/blend2.mmg | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/addons/material_maker/nodes/blend2.mmg b/addons/material_maker/nodes/blend2.mmg
index 69808271..e4d05141 100644
--- a/addons/material_maker/nodes/blend2.mmg
+++ b/addons/material_maker/nodes/blend2.mmg
@@ -6,7 +6,7 @@
 		"y": 0
 	},
 	"parameters": {
-		"amount1": 1,
+		"amount1": 0.5,
 		"blend_type1": 0
 	},
 	"seed_int": 0,

From 277a5e43ce83d08a8da2cce94aafec92a5037b9b Mon Sep 17 00:00:00 2001
From: LMW <williamchange@gmail.com>
Date: Wed, 28 Feb 2024 19:03:44 +0800
Subject: [PATCH 3/3] swap top/bottom in doc, add modes in param section - in
 the sense that bottom refers to the background layer, top is the foreground -
 adds new modes to the parameter section of the doc

---
 material_maker/doc/node_filter_blend.rst | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/material_maker/doc/node_filter_blend.rst b/material_maker/doc/node_filter_blend.rst
index 120764aa..5062589b 100644
--- a/material_maker/doc/node_filter_blend.rst
+++ b/material_maker/doc/node_filter_blend.rst
@@ -34,7 +34,8 @@ The **Blend** node has two or more parameters:
 
 * The *blend mode*, that can be one of the following: *Normal*, *Dissolve*, *Multiply*, *Screen*,
   *Overlay*, *Hard Light*, *Soft Light*, *Linear Light*, *Vivid Light*, *Pin Light*, *Burn*, *Dodge*,
-  *Lighten*, *Darken*, *Difference*, *Additive*, *AddSub*, *Hard Mix*, *Exclusion*.
+  *Lighten*, *Darken*, *Difference*, *Additive*, *AddSub*, *Hard Mix*, *Exclusion*, *Hue*, *Saturation*,
+  *Color*, *Value*.
 
 * The *opacity* is used when mixing the result of the blend operation with the background input
   when the corresponding input is not connected. When connected, the opacity channel is
@@ -132,13 +133,13 @@ Blending modes
 +-----------------------+-------------------------------+-------------------------------------------------------------------------------------------------------------------------------+
 | Exclusion             | |blend_exclusion|             | This blend mode is similar to Difference, but it is less intense                                                              |
 +-----------------------+-------------------------------+-------------------------------------------------------------------------------------------------------------------------------+
-| Hue                   | |blend_hue|                   | This blend mode takes the hue of the bottom layer and combines them with the saturation and value of the top layer            |
+| Hue                   | |blend_hue|                   | This blend mode takes the hue of the top layer and combines them with the saturation and value of the bottom layer            |
 +-----------------------+-------------------------------+-------------------------------------------------------------------------------------------------------------------------------+
-| Saturation            | |blend_saturation|            | This blend mode takes the saturation of the bottom layer and combines them with the hue and value of the top layer            |
+| Saturation            | |blend_saturation|            | This blend mode takes the saturation of the top layer and combines them with the hue and value of the bottom layer            |
 +-----------------------+-------------------------------+-------------------------------------------------------------------------------------------------------------------------------+
-| Color                 | |blend_color|                 | This blend mode takes the hue and saturation of the bottom layer and combines them with the value of the top layer            |
+| Color                 | |blend_color|                 | This blend mode takes the hue and saturation of the top layer and combines them with the value of the bottom layer            |
 +-----------------------+-------------------------------+-------------------------------------------------------------------------------------------------------------------------------+
-| Value                 | |blend_value|                 | This blend mode takes the value of the bottom layer and combines them with the hue and saturation of the top layer            |
+| Value                 | |blend_value|                 | This blend mode takes the value of the top layer and combines them with the hue and saturation of the bottom layer            |
 +-----------------------+-------------------------------+-------------------------------------------------------------------------------------------------------------------------------+
 
 Notes