@quenty/animations 1.2.1-canary.405.6fa018e.0 → 1.3.1-canary.407.46d4d39.0

package/CHANGELOG.md

@@ -3,12 +3,32 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
-## [1.2.1-canary.405.6fa018e.0](https://github.com/Quenty/NevermoreEngine/compare/@quenty/animations@1.2.0...@quenty/animations@1.2.1-canary.405.6fa018e.0) (2023-08-14)
+## [1.3.1-canary.407.46d4d39.0](https://github.com/Quenty/NevermoreEngine/compare/@quenty/animations@1.3.0...@quenty/animations@1.3.1-canary.407.46d4d39.0) (2023-09-04)
+
+
+### Bug Fixes
+
+* Add versions to package ([104323f](https://github.com/Quenty/NevermoreEngine/commit/104323fb7f53b866282b2cdef9bf8a849cfb308c))
+
+
+
+
+
+# [1.3.0](https://github.com/Quenty/NevermoreEngine/compare/@quenty/animations@1.2.0...@quenty/animations@1.3.0) (2023-08-23)
+
+
+### Bug Fixes
+
+* Add missing dependency ([42ac596](https://github.com/Quenty/NevermoreEngine/commit/42ac5964e2154311070278732bf61b2b6b6982ce))
+* Rename HoarcekatRigAnimator ([87ff244](https://github.com/Quenty/NevermoreEngine/commit/87ff244c1ef964a496fd71c08e9a4f3fb195a2b7))
+* Track weight will only adjust if we get a track ([e885fce](https://github.com/Quenty/NevermoreEngine/commit/e885fced59555520dce0ed0a21f95157ba45f14d))
 
 
 ### Features
 
 * Add AnimationSlotPlayer.new(animationTarget) ([86f1e99](https://github.com/Quenty/NevermoreEngine/commit/86f1e9989d4c52b136078a9c4c34c205e2e88549))
+* Add AnimationTrackPlayer.new(animationTarget, animationId) ([7b254c2](https://github.com/Quenty/NevermoreEngine/commit/7b254c2870b8ed930c33081df84944925702d10a))
+* Add studio rig animator ([9a6578b](https://github.com/Quenty/NevermoreEngine/commit/9a6578bfd712728b179ce40096f1ee7c581c112f))
 
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quenty/animations",
-  "version": "1.2.1-canary.405.6fa018e.0",
+  "version": "1.3.1-canary.407.46d4d39.0",
   "description": "Utility methods for playing back animations on Roblox",
   "keywords": [
     "Roblox",
@@ -25,17 +25,20 @@
     "Quenty"
   ],
   "dependencies": {
-    "@quenty/baseobject": "6.2.1",
+    "@quenty/baseobject": "6.3.0",
     "@quenty/enumutils": "3.1.0",
     "@quenty/humanoidanimatorutils": "2.2.0",
-    "@quenty/loader": "6.2.1",
-    "@quenty/maid": "2.5.0",
-    "@quenty/promisemaid": "1.2.0",
-    "@quenty/rbxasset": "1.1.0",
-    "@quenty/valueobject": "7.21.1-canary.405.6fa018e.0"
+    "@quenty/loader": "6.3.0",
+    "@quenty/maid": "2.6.0",
+    "@quenty/promise": "6.8.0",
+    "@quenty/promisemaid": "1.3.0",
+    "@quenty/rbxasset": "1.2.0",
+    "@quenty/rx": "7.15.0",
+    "@quenty/signal": "2.4.0",
+    "@quenty/valueobject": "7.22.1-canary.407.46d4d39.0"
   },
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "6fa018eb1f165230fe1eb0417d8d6951010e4971"
+  "gitHead": "46d4d393561a0f2e77eaac99453d043bf6475b16"
 }

package/src/Shared/AnimationSlotPlayer.lua

@@ -65,9 +65,13 @@ function AnimationSlotPlayer:Play(id, fadeTime, weight, speed, priority)
 		local maid = brio:ToMaid()
 
 		local track = AnimationUtils.playAnimation(animationTarget, id, fadeTime, weight, speed, priority)
-		maid:GiveTask(function()
-			track:AdjustWeight(0, fadeTime or self._defaultFadeTime.Value)
-		end)
+		if track then
+			maid:GiveTask(function()
+				track:AdjustWeight(0, fadeTime or self._defaultFadeTime.Value)
+			end)
+		else
+			warn("[AnimationSlotPlayer] - Failed to get animation to play")
+		end
 	end))
 
 	self._maid._current = topMaid

package/src/Shared/AnimationTrackPlayer.lua

@@ -0,0 +1,155 @@
+--[=[
+	@class AnimationTrackPlayer
+]=]
+
+local require = require(script.Parent.loader).load(script)
+
+local BaseObject = require("BaseObject")
+local ValueObject = require("ValueObject")
+local Rx = require("Rx")
+local AnimationUtils = require("AnimationUtils")
+local Signal = require("Signal")
+
+local AnimationTrackPlayer = setmetatable({}, BaseObject)
+AnimationTrackPlayer.ClassName = "AnimationTrackPlayer"
+AnimationTrackPlayer.__index = AnimationTrackPlayer
+
+function AnimationTrackPlayer.new(animationTarget, animationId)
+	local self = setmetatable(BaseObject.new(), AnimationTrackPlayer)
+
+	self._animationTarget = ValueObject.new(nil)
+	self._maid:GiveTask(self._animationTarget)
+
+	self._trackId = ValueObject.new(nil)
+	self._maid:GiveTask(self._trackId)
+
+	self._currentTrack = ValueObject.new(nil)
+	self._maid:GiveTask(self._currentTrack)
+
+	self.KeyframeReached = Signal.new()
+	self._maid:GiveTask(self.KeyframeReached)
+
+	self._animationPriority = ValueObject.new(nil)
+	self._maid:GiveTask(self._animationPriority)
+
+	if animationTarget then
+		self:SetAnimationTarget(animationTarget)
+	end
+
+	if animationId then
+		self:SetAnimationId(animationId)
+	end
+
+	self:_setupState()
+
+	return self
+end
+
+function AnimationTrackPlayer:_setupState()
+	self._maid:GiveTask(Rx.combineLatest({
+		animationTarget = self._animationTarget:Observe();
+		trackId = self._trackId:Observe();
+		animationPriority = self._animationPriority:Observe();
+	}):Pipe({
+		Rx.throttleDefer();
+	}):Subscribe(function(state)
+		if state.animationTarget and state.trackId then
+			self._currentTrack.Value = AnimationUtils.getOrCreateAnimationTrack(state.animationTarget, state.trackId, state.animationPriority)
+		else
+			self._currentTrack.Value = nil
+		end
+	end))
+
+	self._maid:GiveTask(self._currentTrack:ObserveBrio(function(track)
+		return track ~= nil
+	end):Subscribe(function(brio)
+		if brio:IsDead() then
+			return
+		end
+
+		local maid = brio:ToMaid()
+		local track = brio:GetValue()
+
+		maid:GiveTask(track.KeyframeReached:Connect(function(...)
+			self.KeyframeReached:Fire(...)
+		end))
+	end))
+end
+
+function AnimationTrackPlayer:SetAnimationId(animationId)
+	return self._trackId:Mount(animationId)
+end
+
+function AnimationTrackPlayer:GetAnimationId()
+	return self._trackId.Value
+end
+
+function AnimationTrackPlayer:SetAnimationTarget(animationTarget)
+	return self._animationTarget:Mount(animationTarget)
+end
+
+function AnimationTrackPlayer:SetWeightTargetIfNotSet(weight, fadeTime)
+	self._maid._adjustWeight = self:_onEachTrack(function(_maid, track)
+		if track.WeightTarget ~= weight then
+			track:AdjustWeight(weight, fadeTime)
+		end
+	end)
+end
+
+function AnimationTrackPlayer:Play(fadeTime, weight, speed)
+	if weight then
+		self._maid._adjustWeight = nil
+	end
+
+	if speed then
+		self._maid._adjustSpeed = nil
+	end
+
+	self._maid._stop = nil
+	self._maid._play = self:_onEachTrack(function(_maid, track)
+		track:Play(fadeTime, weight, speed)
+	end)
+end
+
+function AnimationTrackPlayer:Stop(fadeTime)
+	self._maid._play = nil
+	self._maid._stop = self:_onEachTrack(function(_maid, track)
+		track:Stop(fadeTime)
+	end)
+end
+
+function AnimationTrackPlayer:AdjustWeight(weight, fadeTime)
+	self._maid._adjustWeight = self:_onEachTrack(function(_maid, track)
+		track:AdjustWeight(weight, fadeTime)
+	end)
+end
+
+function AnimationTrackPlayer:AdjustSpeed(speed, fadeTime)
+	self._maid._adjustSpeed = self:_onEachTrack(function(_maid, track)
+		track:AdjustSpeed(speed, fadeTime)
+	end)
+end
+
+function AnimationTrackPlayer:IsPlaying()
+	local track = self._currentTrack.Value
+	if track then
+		return track.IsPlaying
+	else
+		return false
+	end
+end
+
+function AnimationTrackPlayer:_onEachTrack(callback)
+	return self._currentTrack:ObserveBrio(function(track)
+		return track ~= nil
+	end):Subscribe(function(brio)
+		if brio:IsDead() then
+			return
+		end
+
+		local track = brio:GetValue()
+		callback(brio:ToMaid(), track)
+	end)
+end
+
+return AnimationTrackPlayer

package/src/Shared/Testing/StudioRigAnimator.lua

@@ -0,0 +1,41 @@
+--[=[
+	Ship to run animations in hoarcekat
+
+	@class StudioRigAnimator
+]=]
+
+local require = require(script.Parent.loader).load(script)
+
+local RunService = game:GetService("RunService")
+
+local BaseObject = require("BaseObject")
+local AnimationUtils = require("AnimationUtils")
+
+local StudioRigAnimator = setmetatable({}, BaseObject)
+StudioRigAnimator.ClassName = "StudioRigAnimator"
+StudioRigAnimator.__index = StudioRigAnimator
+
+function StudioRigAnimator.new(animatorOrHumanoid)
+	local self = setmetatable(BaseObject.new(animatorOrHumanoid), StudioRigAnimator)
+
+	if RunService:IsStudio() and not RunService:IsRunning() then
+		self:_setupStudio()
+	end
+
+	return self
+end
+
+function StudioRigAnimator:_setupStudio()
+	self._animator = AnimationUtils.getOrCreateAnimator(self._obj)
+	self._lastTime = os.clock()
+
+	self._maid:GiveTask(RunService.RenderStepped:Connect(function()
+		local now = os.clock()
+		local delta = now - self._lastTime
+		self._lastTime = now
+
+		self._animator:StepAnimations(delta)
+	end))
+end
+
+return StudioRigAnimator