General tweening API

[As8D]

Hi there!

I’ve encountered several issues lately with people wanting to transition properties of various instances in an easy way - all of which problems arises because it either requires developers to set up the actual updating mechanism for the transition, precision inaccuracies and so forth.

Sound:FadeIn(time) and Sound:FadeOut(time)

Could be used to smoothly tween a sound’s volume in or out over a specified time. Even though this can already be achieved fairly easily with loops, I feel like it’s a common enough occurrence to deserve its own function.

BasePart:MoveTo(CFrame, time)

Countless times we are required to move objects without bothering about players standing in it’s way or the object hitting other bricks. Such as when you: move a big ship, move a helicopter along a certain path, move heavy doors that shouldn’t stop moving just because a player stands inbetween. These are all times where a simple command like: part:MoveTo(endCF, 2) would come in handy. Example: local part = workspace.HeavyDoor local endCF = part.CFrame + Vector3.new(0,-10,0) part:MoveTo(endCF,…

Add Easing For Camera:Interpolate()

Camera:Interpolate() is really cool, but it often looks very awkward when it reaches its destination or when it starts, as it goes 0 to max speed instantly, or abruptly comes to a screeching halt. Please give us easing options similar to what we have with tweeting GUI objects, so the beginning and end of interpolation looks smooth and professional.

http://devforum.roblox.com/t/model-rotation-tween/28945

just to mention a few related issues.

We have a service, TweenService, which is currently only used for GUI tweening mechanisms - but adding API methods for generic tweening across any sort of instance would be useful for many people.

I suggest the following methods to be added to TweenService:

void TweenService:Tween(Instance instance, string property, variant targetValue, Enum.EasingDirection easingDirection, Enum.EasingStyle easingStyle, number duration[, function callback(Enum.TweenStatus)])

void TweenService:TweenFunc(function tweenFunction(number), Enum.EasingDirection easingDirection, Enum.EasingStyle easingStyle, number duration[, function callback(Enum.TweenStatus)])

void TweenService:Lerp(Instance instance, string property, variant targetValue, number duration[, function callback(Enum.TweenStatus)])

The given methods would be interrupted if called with the same combination of instance and property or function reference. (I’m not certain if a boolean parameter for override would be needed, as I’ve never actually used it, and don’t see anything that makes it useful)

Other than just the above issues mentioned, this suggestion would prevent further API bloat, as we already have GUIObject:TweenPosition, GUIObject:TweenSize, Camera:Interpolate (which is simply CFrame tweening with a linear easing style)

For an equivalent RBX.Lua implementation, I have this ModuleScript:
TweenUtility.rbxmx (14.4 KB)