QuickTween 1.4.1
Loading...
Searching...
No Matches
QuickVectorTween.h
1// Copyright 2025 Juan Pablo Hernandez Mosti. All Rights Reserved.
2
3#pragma once
4
5#include "CoreMinimal.h"
6#include "QuickTweenBase.h"
7#include "QuickVectorTween.generated.h"
8
10DECLARE_DELEGATE_RetVal_OneParam(FVector, FNativeVectorGetter, UQuickVectorTween*);
11DECLARE_DELEGATE_TwoParams( FNativeVectorSetter, const FVector&, UQuickVectorTween* );
12
17UCLASS(BlueprintType)
18class QUICKTWEEN_API UQuickVectorTween : public UQuickTweenBase
19{
20 GENERATED_BODY()
21private:
22 UQuickVectorTween() = default;
23
27 void SetUp(
28 const UObject* worldContextObject,
29 FNativeVectorGetter from,
30 FNativeVectorGetter to,
31 FNativeVectorSetter setter,
32 float duration = 1.0f,
33 float timeScale = 1.0f,
34 EEaseType easeType = EEaseType::Linear,
35 UCurveFloat* easeCurve = nullptr,
36 int32 loops = 1,
37 ELoopType loopType = ELoopType::Restart,
38 const FString& tweenTag = FString(),
39 bool bShouldAutoKill = true,
40 bool bShouldPlayWhilePaused = false,
41 bool bShouldAutoPlay = false)
42 {
43 From = MoveTemp(from);
44 To = MoveTemp(to);
45 Setter = MoveTemp(setter);
47 worldContextObject,
48 duration,
49 timeScale,
50 easeType,
51 easeCurve,
52 loops,
53 loopType,
54 tweenTag,
55 bShouldAutoKill,
56 bShouldPlayWhilePaused,
57 bShouldAutoPlay);
58
59 }
60public:
61
82 static UQuickVectorTween* CreateTween(
83 UObject* worldContextObject,
84 FNativeVectorGetter from,
85 FNativeVectorGetter to,
86 FNativeVectorSetter setter,
87 float duration = 1.0f,
88 float timeScale = 1.0f,
89 EEaseType easeType = EEaseType::Linear,
90 UCurveFloat* easeCurve = nullptr,
91 int32 loops = 1,
92 ELoopType loopType = ELoopType::Restart,
93 const FString& tweenTag = FString(),
94 bool bShouldAutoKill = true,
95 bool bShouldPlayWhilePaused = false,
96 bool bShouldAutoPlay = false)
97 {
98 if (!from.IsBound() || !to.IsBound() || !setter.IsBound())
99 {
100 UE_LOG(LogQuickTweenBase, Warning, TEXT("UQuickVectorTween::CreateTween: One or more delegate functions are not bound."));
101 return nullptr;
102 }
103
104 UQuickVectorTween* tween = NewObject<UQuickVectorTween>(worldContextObject);
105 tween->SetUp(
106 worldContextObject,
107 MoveTemp(from),
108 MoveTemp(to),
109 MoveTemp(setter),
110 duration,
111 timeScale,
112 easeType,
113 easeCurve,
114 loops,
115 loopType,
116 tweenTag,
117 bShouldAutoKill,
118 bShouldPlayWhilePaused,
119 bShouldAutoPlay);
120 return tween;
121 }
122
124 UFUNCTION(BlueprintPure, meta = (Keywords = "Tween"), Category = "Tween|Info")
125 [[nodiscard]] FVector GetCurrentValue() const { return CurrentValue; }
126
128 UFUNCTION(BlueprintPure, meta = (Keywords = "Tween"), Category = "Tween|Info")
129 [[nodiscard]] FVector GetStartValue() const { return StartValue.Get(FVector::ZeroVector); }
130
132 UFUNCTION(BlueprintPure, meta = (Keywords = "Tween"), Category = "Tween|Info")
133 [[nodiscard]] FVector GetEndValue() const { return EndValue.Get(FVector::ZeroVector); }
134
135protected:
136 virtual void ApplyAlphaValue(float alpha) override;
137
138 virtual void HandleOnStart() override;
139
140 virtual void HandleOnComplete() override;
141
142private:
144 FNativeVectorGetter From;
145
147 FNativeVectorGetter To;
148
150 TOptional<FVector> StartValue;
151
153 TOptional<FVector> EndValue;
154
156 FNativeVectorSetter Setter;
157
159 FVector CurrentValue;
160};
Definition QuickTweenBase.h:26
void SetUp(const UObject *worldContextObject, float duration, float timeScale, EEaseType easeType, UCurveFloat *easeCurve, int32 loops, ELoopType loopType, const FString &tweenTag=FString(), bool bShouldAutoKill=true, bool bShouldPlayWhilePaused=false, bool bShouldAutoPlay=false)
Definition QuickTweenBase.cpp:20
Definition QuickVectorTween.h:19
FVector GetCurrentValue() const
Definition QuickVectorTween.h:125
FVector GetEndValue() const
Definition QuickVectorTween.h:133
virtual void ApplyAlphaValue(float alpha) override
Definition QuickVectorTween.cpp:9
static UQuickVectorTween * CreateTween(UObject *worldContextObject, FNativeVectorGetter from, FNativeVectorGetter to, FNativeVectorSetter setter, float duration=1.0f, float timeScale=1.0f, EEaseType easeType=EEaseType::Linear, UCurveFloat *easeCurve=nullptr, int32 loops=1, ELoopType loopType=ELoopType::Restart, const FString &tweenTag=FString(), bool bShouldAutoKill=true, bool bShouldPlayWhilePaused=false, bool bShouldAutoPlay=false)
Definition QuickVectorTween.h:82
virtual void HandleOnStart() override
Definition QuickVectorTween.cpp:21
FVector GetStartValue() const
Definition QuickVectorTween.h:129
virtual void HandleOnComplete() override
Definition QuickVectorTween.cpp:46