FindRotation3D

2017-07-16T12:12:57Z

Jirppa: Created page with "{{Useful Function}} <lowercasetitle></lowercasetitle> __NOTOC__ This function takes two sets of XYZ coordinates. It returns the 3D direction from point A to point B. This can..."

{{Useful Function}}
<lowercasetitle></lowercasetitle>
__NOTOC__
This function takes two sets of XYZ coordinates. It returns the 3D direction from point A to point B. This can for example be used to make objects point at specified point
==Syntax==
<syntaxhighlight lang="lua">float float float findRotation3D( float x1, float y1, float z1, float x2, float y2, float z2 )</syntaxhighlight>

===Required Arguments===
* '''x1''': The X coordinate of the starting point.
* '''y1''': The Y coordinate of the starting point.
* '''z1''': The Z coordinate of the starting point.
* '''x2''': The X coordinate of the target point.
* '''y2''': The Y coordinate of the target point.
* '''z2''': The Z coordinate of the starting point.

==Code==
<syntaxhighlight lang="lua">
function findRotation3D( x1, y1, z1, x2, y2, z2 )
local rotx = math.atan2 ( z2 - z1, getDistanceBetweenPoints2D ( x2,y2, x1,y1 ) )
rotx = math.deg(rotx)
local rotz = -math.deg( math.atan2( x2 - x1, y2 - y1 ) )
rotz = rotz < 0 and rotz + 360 or rotz
return rotx, 0,rotz
end
</syntaxhighlight>

==Example==
This command makes the player's vehicle to rotate at vehicle near it.
''Note: This example needs [[OOP]] to be enabled in order to work''
<section name="Client-side example" class="client" show="true">
<syntaxhighlight lang="lua">
local function setRotationAtNearestVehicle()

if not localPlayer.vehicle then return end

local nearestVehicle = false
local dist = 10000
for index,vehicle in ipairs(getElementsByType("vehicle",root,true)) do
if getDistanceBetweenPoints3D(localPlayer.vehicle.position,vehicle.position) < dist and localPlayer.vehicle ~= vehicle then
nearestVehicle = vehicle
dist = getDistanceBetweenPoints3D(localPlayer.vehicle.position,vehicle.position)
end
end

local x1,y1,z1 = getElementPosition(localPlayer.vehicle)
local x2,y2,z2 = getElementPosition(nearestVehicle)
local rx,ry,rz = findRotation3D(x1,y1,z1,x2,y2,z2)

localPlayer.vehicle.rotation = Vector3(rx,ry,rz)

end

addCommandHandler("lookatnearestveh",setRotationAtNearestVehicle)
</syntaxhighlight>
</section>

Thanks for '''ccw''' for alternative [[getCameraRotation]] function which formula is used in this function. Also thanks for '''Doomed_Space_Marine''' for more accurate formula for z-axis which is used in [[findRotation]]

==See Also==
{{Useful_Functions}}

Multi Theft Auto: Wiki - User contributions [en]

FindRotation3D