linear interpolation for vectors.

[Demigod916]

math.lerpVectors is a standard linear interpolation between 2 vectors. This will allow developers to smoothy transition between 2 vectors for rotations or coords over a set duration.

this function is currently blocking. optional async is something that we can add if desired.

example:

RegisterCommand('testLerp', function(source, args, raw)
	lib.requestModel(`gr_prop_gr_target_04b`)

	local offset = GetOffsetFromEntityInWorldCoords(cache.ped, 0, 3.0, 0)
	local object = CreateObject(`gr_prop_gr_target_04b`, offset.x, offset.y, offset.z, false, false, false)

	PlaceObjectOnGroundProperly_2(object)
	math.lerpVectors(vec3(0, 0, 0), vec3(-90.0, 0, 0), 500, function(interpolated)
		SetEntityRotation(object, interpolated.x, interpolated.y, interpolated.z, 0, false)
	end)
end)

lerp.-.Trim.mp4

[thelindat]

An iterator might look a bit nicer in this situation.

for interpolated in math.lerpVectors(vec3(0, 0, 0), vec3(-90.0, 0, 0), 500) do
    SetEntityRotation(object, interpolated.x, interpolated.y, interpolated.z, 0, false)
end)

I would also prefer math.lerp that can handle interpolation of scalars, vectors, or even tables (both arrays and hashmaps, to a limit).

[Demigod916]

so for the iterator method, it would use a coroutine?

[thelindat]

You basically just return a function instead of having a function argument; it calls the function until it gets a nil value.

[Demigod916]

okay updated.

for value in math.lerp(0, 100, 500) do
    print(value)
end

for vec in math.lerp(vec3(0, 0, 0), vec3(10, 10, 10), 1000) do
    print(vec.x, vec.y, vec.z)
end

for tbl in math.lerp({x=0, y=0}, {x=10, y=20}, 1000) do
    print(tbl.x, tbl.y)
end

[thelindat]

I don't mind making these changes myself, but here's some nitpicks.