Garry's Mod Wiki

number math.Approach( number current, number target, number change )

View Source Search Github

Description

Gradually approaches the target value by the specified amount.

Arguments

1 number current

The value we're currently at.

2 number target

The target value. This function will never overshoot this value.

3 number change

The amount that the current value is allowed to change by to approach the target. (It makes no difference whether this is positive or negative.)

Returns

1 number

New current value, closer to the target than it was previously.

Example

Demonstrates what this function does

print( math.Approach( 0, 5, 1 ) ) -- attempts to increment 0 by 1, 0 + 1 is less than 5 so returns 1 print( math.Approach( 4, 5, 3 ) ) -- attempts to increment 4 by 3, 4 + 3 = 7 is greater than 5 so returns 5

Output:

1 5

Example

Common usage example of this function with a control variable.

local MyNumber = 0 local Target = 0 local LastThink = 0 local ChangeRate = 1 hook.Add( "Think", "math.Approach Example", function() local now = CurTime() local timepassed = now - LastThink LastThink = now MyNumber = math.Approach( MyNumber, Target, ChangeRate * timepassed ) -- Normally, you would use MyNumber in code that appears here. end ) -- The following functions are for example only: function GetMyNumber() return MyNumber end function SetMyNumberTarget( newtarget ) Target = newtarget end function SetMyNumberChangeRate( newrate ) ChangeRate = newrate end

This site is a community mirror of the official Garry's Mod wiki.. This site is not maintained by Facepunch Studios.

Page content is automatically updated four times a day. Edits and history are not available.

Last Parsed: Loading...