@quenty/numbersequenceutils 3.1.0 → 3.1.1-canary.38bdfe3.0

package/CHANGELOG.md

@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [3.1.1-canary.38bdfe3.0](https://github.com/Quenty/NevermoreEngine/compare/@quenty/numbersequenceutils@3.1.0...@quenty/numbersequenceutils@3.1.1-canary.38bdfe3.0) (2022-09-07)
+
+**Note:** Version bump only for package @quenty/numbersequenceutils
+
+
+
+
+
 # [3.1.0](https://github.com/Quenty/NevermoreEngine/compare/@quenty/numbersequenceutils@3.0.0...@quenty/numbersequenceutils@3.1.0) (2022-03-27)
 
 **Note:** Version bump only for package @quenty/numbersequenceutils

package/LICENSE.md

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2014-2021 Quenty
+Copyright (c) 2014-2022 Quenty
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quenty/numbersequenceutils",
-  "version": "3.1.0",
+  "version": "3.1.1-canary.38bdfe3.0",
   "description": "Utility functions involving NumberSequences on Roblox",
   "keywords": [
     "Roblox",
@@ -27,5 +27,9 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "501844bd6c3d3f765fd3032b997d8030bc963a1f"
+  "dependencies": {
+    "@quenty/loader": "5.0.1",
+    "@quenty/math": "2.2.0"
+  },
+  "gitHead": "38bdfe3721bddf1d272628b1104b1d8e0abaf24f"
 }

package/src/Shared/NumberSequenceUtils.lua

@@ -3,10 +3,91 @@
 	@class NumberSequenceUtils
 ]=]
 
+local require = require(script.Parent.loader).load(script)
+
+local Math = require("Math")
+
 local NumberSequenceUtils = {}
 
 local EPSILON = 1e-3
 
+--[=[
+	Gets the current NumberSequence value for a given t
+
+	@param numberSequence NumberSequence
+	@return (number) -> number
+]=]
+function NumberSequenceUtils.getValueGenerator(numberSequence: NumberSequence): number
+	assert(typeof(numberSequence) == "NumberSequence", "Bad numberSequence")
+
+	-- TODO: Binary search
+	local keypoints = numberSequence.Keypoints
+	if #keypoints == 1 then
+		local keypoint = keypoints[1]
+		if keypoint.Envelope == 0 then
+			return function(t)
+				assert(type(t) == "number", "Bad t")
+
+				return keypoint.Value
+			end
+		else
+			return function(t)
+				assert(type(t) == "number", "Bad t")
+
+				return keypoint.Value + (math.random()-0.5)*keypoint.Envelope
+			end
+		end
+	elseif #keypoints == 2 then
+		local first = keypoints[1]
+		local second = keypoints[2]
+
+		if first.Value == second.Value and first.Envelope == 0 and second.Envelope == 0 then
+			return function(t)
+				assert(type(t) == "number", "Bad t")
+
+				return first.Value
+			end
+		else
+			local firstValue = first.Value + (math.random() - 0.5)*first.Envelope
+			local secondValue = second.Value + (math.random() - 0.5)*second.Envelope
+			return function(t)
+				assert(type(t) == "number", "Bad t")
+				local scale = math.clamp(Math.map(t, first.Time, second.Time, 0, 1), 0, 1)
+				return Math.lerp(firstValue, secondValue, scale)
+			end
+		end
+	else
+		-- pregenerate
+		local values = {}
+		for i=1, #keypoints do
+			local point = keypoints[i]
+			values[i] = point.Value + (math.random()-0.5)*point.Envelope
+		end
+
+		return function(t)
+			assert(type(t) == "number", "Bad t")
+
+			if t <= keypoints[1].Time then
+				return values[1]
+			end
+
+			-- TODO: Binary search
+			for i=2, #keypoints do
+				local point = keypoints[i]
+				if point.Time < t then
+					continue
+				end
+
+				local prevPoint = keypoints[i-1]
+				local scale = math.clamp(Math.map(t, prevPoint.Time, point.Time, 0, 1), 0, 1)
+				return Math.lerp(values[i-1], values[i], scale)
+			end
+
+			return values[#keypoints]
+		end
+	end
+end
+
 --[=[
 	Scales a number sequence value by the set amount
 	@param sequence NumberSequence

package/src/node_modules.project.json

@@ -0,0 +1,7 @@
+{
+  "name": "node_modules",
+  "globIgnorePaths": [ "**/.package-lock.json" ],
+  "tree": {
+    "$path": { "optional": "../node_modules" }
+  }
+}