This page is incomplete! Help wanted!

Please finish this page using the corresponding Old Wiki article.
Go to Contribution guidelines for more information.

---

This function returns the distance between two 3 dimensional points using the pythagorean theorem.

Note

This function is equivalent to the Vector3 class getLength method when used with a vector that holds the direction and distance between two points. In other words, it produces exactly the same result as substracting the points' coordinates and getting the length of the result vector.

Syntax

 getDistanceBetweenPoints3D ( )

Code Examples

Example 1 Example 2 Example 3

server

-- create the vehicles which we're going to measure distance between of
vehicle1 = createVehicle(445, -2629.79248, 1370.82996, 7.10079)
vehicle2 = createVehicle(560, -2629.71899, 1350.18188, 7.10897)

-- get position of both created vehicles
vehicle1x, vehicle1y, vehicle1z = getElementPosition(vehicle1)
vehicle2x, vehicle2y, vehicle2z = getElementPosition(vehicle2)

-- measure the distance
outputChatBox("The distance between vehicle1 and vehicle2 is " ..tostring(getDistanceBetweenPoints3D(vehicle1x, vehicle1y, vehicle1z, vehicle2x, vehicle2y, vehicle2z)))

server

function checkIfClose(p, cmd)
    -- player x, y, z
    local x1, y1, z1 = getElementPosition(p)
    -- location x, y, z (to check if player is close enough to)
    local x2, y2, z2 = -2629.79248, 1370.82996, 7.10079

    if getDistanceBetweenPoints3D(x1, y1, z1, x2, y2, z2) <= 5 then
        return outputChatBox("You are close enough (within 5 meters)!")
    else
        return outputChatBox("You are NOT close enough!")
    end
end
addCommandHandler("closeornot", checkIfClose)

--[REWRITE BY ANDREI]
local half = 1 / 2
function getDistanceFromPoints(x1, y1, z1, x2, y2, z2)
    return ((x2 - x1) * (x2 - x1) ^ 2 + (y2 - y1) * (y2 - y1) ^ 2 + (z2 - z1) * (z2 - z1)) ^ half
end

server

getDistanceBetweenPoints3Dcan also be used to measure the length of 3 dimensional vectors. This example calculates the speed of a vehicle by measuring the size of the it's velocity vector:

speed = getDistanceBetweenPoints3D ( 0, 0, 0, getElementVelocity ( vehicle ) )

See Also

Utility Functions

• addDebugHook
• bitAnd
• bitArShift
• bitExtract
• bitLRotate
• bitLShift
• bitNot
• bitOr
• bitReplace
• bitRRotate
• bitRShift
• bitTest
• bitXor
• createTrayNotification
• debugSleep
• decodeString
• deref
• downloadFile
• encodeString
• fromJSON
• generateKeyPair
• getColorFromString
• getDevelopmentMode
• getDistanceBetweenPoints2D
• getDistanceBetweenPoints3D
• getEasingValue
• getFPSLimit
• getKeyboardLayout
• getLocalization
• getNetworkStats
• getNetworkUsageData
• getPerformanceStats
• getProcessMemoryStats
• getRealTime
• getServerIp
• getTickCount
• getTimerDetails
• getTimers
• gettok
• getUserdataType
• getVersion
• hash
• inspect
• interpolateBetween
• iprint
• isOOPEnabled
• isShowCollisionsEnabled
• isShowSoundEnabled
• isTimer
• isTimerPaused
• isTransferBoxAlwaysVisible
• isTransferBoxVisible
• isTrayNotificationEnabled
• killTimer
• md5
• passwordHash
• passwordVerify
• pregFind
• pregMatch
• pregReplace
• ref
• removeDebugHook
• resetTimer
• setClipboard
• setDevelopmentMode
• setFPSLimit
• setTimer
• setTimerPaused
• setTransferBoxVisible
• setWindowFlashing
• sha256
• showCol
• showSound
• split
• teaDecode
• teaEncode
• tocolor
• toJSON
• utfChar
• utfCode
• utfLen
• utfSeek
• utfSub

Reference

• Scripting Functions