GetVehicleVelocity

From SA-MP Wiki

This function was added in SA-MP 0.3a and will not work in earlier versions!

Description:

Get the velocity of a vehicle on the X, Y and Z axes.

Parameters:

(vehicleid, &Float:x, &Float:y, &Float:z)

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.

Return Values:

1: The function executed successfully.
0: The function failed to execute. This means the vehicle specified does not exist.
The vehicle's velocity is stored in the specified variables.

Example Usage:

public OnPlayerCommandText(playerid, cmdtext[])
{
    if (!strcmp("/GetMyCarVelocity", cmdtext) && IsPlayerInAnyVehicle(playerid))
    {
        new Float:Velocity[3], output[80];
	GetVehicleVelocity(GetPlayerVehicleID(playerid), Velocity[0], Velocity[1], Velocity[2]);
        format(output, sizeof(output), "You are going at a velocity of X%f, Y%f, Z%f", Velocity[0], Velocity[1], Velocity[2]);
        SendClientMessage(playerid, 0xFFFFFFFF, output);
	return 1;
    }
    return 0;
}