RU/getElementSpeed - Revision history

Alex7202: Created page with "NOTOC {{RU/Useful Function}} Эта функция возвращает скорость элемента в м/с, км/ч или миль/ч. ==Синтаксис==
2020-06-03T10:43:06Z

Created page with "NOTOC {{RU/Useful Function}} Эта функция возвращает скорость элемента в м/с, км/ч или миль/ч. ==Синтаксис== <sy..."

New page
NOTOC
{{RU/Useful Function}}
Эта функция возвращает скорость элемента в м/с, км/ч или миль/ч.

==Синтаксис==
<syntaxhighlight lang="lua">
float/nil getElementSpeed ( element theElement [, int/string unit="m/s" ] )
</syntaxhighlight>

===Аргументы===
* '''theElement''': [[element|Элемент]] скорость которого нужно получить. Доступны следующие типы [[element|элементов]]:
[[Player|Игроки]]
[[Ped|Педы]]
[[Object|Объекты]]
[[Vehicle|Машины]]
** [[Projectile|Снаряды]]

===Дополнительные аргументы===
{{RU/OptionalArg}}
* '''Unit''': Единицы измерения. Если не установлены, вернет в ''м/с''. Они могут быть заданы ''[[string|текстом]]'' или ''числом'':
'''0''' or '''m/s''': метров в секунду.
'''1''' or '''km/h''': километров в час.
** '''2''' or '''mph''': миль в час.

==Возврат==
Вернет скорость [[element|элемнта]] если он есть, или ''[[nil]]'' если его нет.

==Код==
<section name="Для сервера и клиента" class="both" show="true">
<syntaxhighlight lang="lua">
function getElementSpeed(theElement, unit)
assert(isElement(theElement), "Bad argument 1 @ getElementSpeed (element expected, got " .. type(theElement) .. ")")
local elementType = getElementType(theElement)
assert(elementType == "player" or elementType == "ped" or elementType == "object" or elementType == "vehicle" or elementType == "projectile", "Invalid element type @ getElementSpeed (player/ped/object/vehicle/projectile expected, got " .. elementType .. ")")
assert((unit == nil or type(unit) == "string" or type(unit) == "number") and (unit == nil or (tonumber(unit) and (tonumber(unit) == 0 or tonumber(unit) == 1 or tonumber(unit) == 2)) or unit == "m/s" or unit == "km/h" or unit == "mph"), "Bad argument 2 @ getElementSpeed (invalid speed unit)")
unit = unit == nil and 0 or ((not tonumber(unit)) and unit or tonumber(unit))
local mult = (unit == 0 or unit == "m/s") and 50 or ((unit == 1 or unit == "km/h") and 180 or 111.84681456)
return (Vector3(getElementVelocity(theElement)) * mult).length
end
</syntaxhighlight>
</section>

==Пример==
<section name="Клиент" class="client" show="true">
<syntaxhighlight lang="lua">
local sx = guiGetScreenSize()
local function drawSpeed()
local vehicle = getPedOccupiedVehicle(getLocalPlayer())
local speedms, speedkmh, speedmph = getElementSpeed(vehicle), getElementSpeed(vehicle, 1), getElementSpeed(vehicle, 2)
local roundedSpeedms, roundedSpeedkmh, roundedSpeedmph = math.floor(speedms) == speedms and speedms or string.format(speedms, "%.1f"), math.floor(speedkmh) == speedkmh and speedkmh or string.format(speedkmh, "%.1f"), math.floor(speedmph) == speedmph and speedmph or string.format(speedmph, "%.1f")
local speedoText = "Current speed: " .. roundedSpeedms .. " m/s | " .. roundedSpeedkmh .. " km/h | " .. roundedSpeedmph .. " mph"
dxDrawText(speedoText, sx - dxGetTextWidth(speedoText), 0)
end
addEventHandler("onClientRender", getRootElement(), drawSpeed)
</syntaxhighlight>
</section>

==Смотрите также==
{{RU/Useful_Functions}}
[[en:getElementSpeed]]