warning Not Translated
This page has not been translated into the language that your browser requested yet. The English content is being shown as a fallback.
If you want to contribute a translation for this page then please click here.
GetVehicleVelocity
Description
Get the velocity of a vehicle on the X, Y and Z axes.
Name | Description |
---|---|
vehicleid | The ID of the vehicle to get the velocity of. |
&Float:x | A float variable in to which to store the vehicle's X velocity, passed by reference. |
&Float:y | A float variable in to which to store the vehicle's Y velocity, passed by reference. |
&Float:z | A float variable in to which to store the vehicle's Z velocity, passed by reference. |
Returns
true - The function was executed successfully.
false - The function failed to execute. This means the vehicle specified does not exist.
The vehicle's velocity is stored in the specified variables.
Examples
public OnPlayerCommandText(playerid, cmdtext[])
{
if (!strcmp("/GetMyCarVelocity", cmdtext))
{
if (!IsPlayerInAnyVehicle(playerid))
{
return 1;
}
new
Float: vehVelocity[3],
string[128];
GetVehicleVelocity(GetPlayerVehicleID(playerid), vehVelocity[0], vehVelocity[1], vehVelocity[2]);
format(string, sizeof(string), "You are going at a velocity of X%f, Y%f, Z%f", vehVelocity[0], vehVelocity[1], vehVelocity[2]);
SendClientMessage(playerid, 0xFFFFFFFF, string);
return 1;
}
return 0;
}
Notes
tip
This function can be used to retrieve a vehicle's speed (km/h, m/s or mph).
Related Functions
- SetVehicleVelocity: Set a vehicle's velocity.
- SetPlayerVelocity: Set a player's velocity.
- GetPlayerVelocity: Get a player's velocity.