@quenty/color3utils 6.0.0-canary.367.e9fdcbc.0 → 6.0.0

package/CHANGELOG.md

@@ -3,7 +3,112 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
-# [6.0.0-canary.367.e9fdcbc.0](https://github.com/Quenty/NevermoreEngine/compare/@quenty/color3utils@5.19.0...@quenty/color3utils@6.0.0-canary.367.e9fdcbc.0) (2023-06-05)
+# [6.0.0](https://github.com/Quenty/NevermoreEngine/compare/@quenty/color3utils@5.30.0...@quenty/color3utils@6.0.0) (2023-10-11)
+
+
+### Bug Fixes
+
+* Fix LuvColor3Utils lerping logic ([b3bb154](https://github.com/Quenty/NevermoreEngine/commit/b3bb154f507977726a117b8d366600b73f04cc52))
+
+
+
+
+
+# [5.30.0](https://github.com/Quenty/NevermoreEngine/compare/@quenty/color3utils@5.29.0...@quenty/color3utils@5.30.0) (2023-09-21)
+
+**Note:** Version bump only for package @quenty/color3utils
+
+
+
+
+
+# [5.29.0](https://github.com/Quenty/NevermoreEngine/compare/@quenty/color3utils@5.28.0...@quenty/color3utils@5.29.0) (2023-09-04)
+
+**Note:** Version bump only for package @quenty/color3utils
+
+
+
+
+
+# [5.28.0](https://github.com/Quenty/NevermoreEngine/compare/@quenty/color3utils@5.27.0...@quenty/color3utils@5.28.0) (2023-08-23)
+
+
+### Features
+
+* Add Color3Utils.toWebHexString(color3) ([e99602a](https://github.com/Quenty/NevermoreEngine/commit/e99602a9a30dfeb5008f6f75b36cbbfc9043ef51))
+
+
+
+
+
+# [5.27.0](https://github.com/Quenty/NevermoreEngine/compare/@quenty/color3utils@5.26.0...@quenty/color3utils@5.27.0) (2023-08-01)
+
+
+### Features
+
+* Add Color3Utils.toHexInteger(color3) ([4c0884f](https://github.com/Quenty/NevermoreEngine/commit/4c0884f2fa2c76420789b9637f0337fa591d5403))
+
+
+
+
+
+# [5.26.0](https://github.com/Quenty/NevermoreEngine/compare/@quenty/color3utils@5.25.0...@quenty/color3utils@5.26.0) (2023-07-28)
+
+**Note:** Version bump only for package @quenty/color3utils
+
+
+
+
+
+# [5.25.0](https://github.com/Quenty/NevermoreEngine/compare/@quenty/color3utils@5.24.0...@quenty/color3utils@5.25.0) (2023-07-25)
+
+**Note:** Version bump only for package @quenty/color3utils
+
+
+
+
+
+# [5.24.0](https://github.com/Quenty/NevermoreEngine/compare/@quenty/color3utils@5.23.0...@quenty/color3utils@5.24.0) (2023-07-23)
+
+**Note:** Version bump only for package @quenty/color3utils
+
+
+
+
+
+# [5.23.0](https://github.com/Quenty/NevermoreEngine/compare/@quenty/color3utils@5.22.1...@quenty/color3utils@5.23.0) (2023-07-15)
+
+**Note:** Version bump only for package @quenty/color3utils
+
+
+
+
+
+## [5.22.1](https://github.com/Quenty/NevermoreEngine/compare/@quenty/color3utils@5.22.0...@quenty/color3utils@5.22.1) (2023-07-11)
+
+**Note:** Version bump only for package @quenty/color3utils
+
+
+
+
+
+# [5.22.0](https://github.com/Quenty/NevermoreEngine/compare/@quenty/color3utils@5.21.0...@quenty/color3utils@5.22.0) (2023-07-10)
+
+**Note:** Version bump only for package @quenty/color3utils
+
+
+
+
+
+# [5.21.0](https://github.com/Quenty/NevermoreEngine/compare/@quenty/color3utils@5.20.0...@quenty/color3utils@5.21.0) (2023-06-17)
+
+**Note:** Version bump only for package @quenty/color3utils
+
+
+
+
+
+# [5.20.0](https://github.com/Quenty/NevermoreEngine/compare/@quenty/color3utils@5.19.0...@quenty/color3utils@5.20.0) (2023-06-05)
 
 **Note:** Version bump only for package @quenty/color3utils
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quenty/color3utils",
-  "version": "6.0.0-canary.367.e9fdcbc.0",
+  "version": "6.0.0",
   "description": "Utility methods for Roblox Color3 values",
   "keywords": [
     "Roblox",
@@ -28,11 +28,12 @@
     "access": "public"
   },
   "dependencies": {
-    "@quenty/blend": "7.0.0-canary.367.e9fdcbc.0",
-    "@quenty/loader": "6.2.1",
-    "@quenty/math": "3.0.0-canary.367.e9fdcbc.0",
-    "@quenty/rx": "7.11.0",
-    "@quenty/valueobject": "8.0.0-canary.367.e9fdcbc.0"
+    "@quenty/blend": "^7.0.0",
+    "@quenty/loader": "^7.0.0",
+    "@quenty/maid": "^2.6.0",
+    "@quenty/math": "^2.5.0",
+    "@quenty/rx": "^8.0.0",
+    "@quenty/valueobject": "^8.0.0"
   },
-  "gitHead": "e9fdcbc6ea1d46e068bf42a08b833099e9005259"
+  "gitHead": "fdeae46099587019ec5fc15317dc673aed379400"
 }

package/src/Shared/Color3Utils.lua

@@ -115,4 +115,50 @@ function Color3Utils.areEqual(a, b, epsilon)
 		and math.abs(a.b - b.b) <= epsilon
 end
 
+--[=[
+	Converts the color3 to the actual hex integer used in web and other
+	areas.
+
+	@param color3 Color3
+	@return number
+]=]
+function Color3Utils.toHexInteger(color3)
+	assert(typeof(color3) == "Color3", "Bad color3")
+
+	return bit32.bor(bit32.lshift(color3.r*0xFF, 16), bit32.lshift(color3.g*0xFF, 8), color3.b*0xFF)
+end
+
+--[=[
+	Converts the color3 to the actual hex integer used in web and other
+	areas.
+
+	```
+	Color3Utils.toHexString(Color3.fromRGB(0, 255, 0)) --> 00FF00
+	```
+
+	@param color3 Color3
+	@return number
+]=]
+function Color3Utils.toHexString(color3)
+	assert(typeof(color3) == "Color3", "Bad color3")
+
+	return string.format("%06X", Color3Utils.toHexInteger(color3))
+end
+
+--[=[
+	Converts the color3 to the standard web hex string
+
+	```
+	Color3Utils.toWebHexString(Color3.fromRGB(0, 255, 0)) --> #00FF00
+	```
+
+	@param color3 Color3
+	@return number
+]=]
+function Color3Utils.toWebHexString(color3)
+	assert(typeof(color3) == "Color3", "Bad color3")
+
+	return string.format("#%06X", Color3Utils.toHexInteger(color3))
+end
+
 return Color3Utils

package/src/Shared/luv/LuvColor3Utils.lua

@@ -33,7 +33,8 @@ function LuvColor3Utils.lerp(color0, color1, t)
 		local l0, u0, v0 = unpack(LuvColor3Utils.fromColor3(color0))
 		local l1, u1, v1 = unpack(LuvColor3Utils.fromColor3(color1))
 
-		local l = Math.lerp(l0, l1, t)
+		local shortest_angle = ((((l1 - l0) % 360) + 540) % 360) - 180
+		local l = l0 + shortest_angle*t
 		local u = Math.lerp(u0, u1, t)
 		local v = Math.lerp(v0, v1, t)
 
@@ -41,6 +42,16 @@ function LuvColor3Utils.lerp(color0, color1, t)
 	end
 end
 
+function LuvColor3Utils.desaturate(color0, proportion)
+	local l0, u0, v0 = unpack(LuvColor3Utils.fromColor3(color0))
+	return LuvColor3Utils.toColor3({l0, u0*math.clamp(1 - proportion, 0, 1), v0})
+end
+
+function LuvColor3Utils.darken(color0, proportion)
+	local l0, u0, v0 = unpack(LuvColor3Utils.fromColor3(color0))
+	return LuvColor3Utils.toColor3({l0, u0, v0*math.clamp(1 - proportion, 0, 1)})
+end
+
 --[=[
 	Converts from Color3 to LUV
 	@param color3 Color3

package/src/Shared/luv/LuvColor3Utils.story.lua

@@ -0,0 +1,39 @@
+--[[
+	@class LuvColor3Utils.story
+]]
+
+local require = require(game:GetService("ServerScriptService"):FindFirstChild("LoaderUtils", true).Parent).load(script)
+
+local Maid = require("Maid")
+local LuvColor3Utils = require("LuvColor3Utils")
+
+return function(target)
+	local maid = Maid.new()
+
+	local start = Color3.fromRGB(184, 127, 100)
+	local finish = Color3.fromRGB(16, 60, 76)
+
+	for i=0, 100 do
+		local frame = Instance.new("Frame")
+		frame.BackgroundColor3 = LuvColor3Utils.lerp(start, finish, i/100)
+		frame.Size = UDim2.fromScale(1/(100 + 1), 0.5)
+		frame.Position = UDim2.fromScale(i/(100 + 1), 0)
+		frame.BorderSizePixel = 0
+		frame.Parent = target
+		maid:GiveTask(frame)
+	end
+
+	for i=0, 100 do
+		local frame = Instance.new("Frame")
+		frame.BackgroundColor3 = start:Lerp(finish, i/100)
+		frame.Size = UDim2.fromScale(1/(100 + 1), 0.5)
+		frame.Position = UDim2.fromScale(i/(100 + 1), 0.5)
+		frame.BorderSizePixel = 0
+		frame.Parent = target
+		maid:GiveTask(frame)
+	end
+
+	return function()
+		maid:DoCleaning()
+	end
+end