GetPlayerCameraTargetVehicle

From SA-MP Wiki

Jump to: navigation, search

GetPlayerCameraTargetVehicle was added in SA-MP 0.3.7 This function was added in SA-MP 0.3.7 and will not work in earlier versions!


Description:

Get the ID of the vehicle the player is looking at.


Image:32px-Circle-style-warning.png

Important
Note

This function is disabled by default to save bandwidth. Use EnablePlayerCameraTarget to enable it for each player.


Parameters:
(playerid)
playeridThe ID of the player to check.


Return Values:

The vehicle ID of the vehicle the player is looking at. INVALID_VEHICLE_ID if none.


Example Usage:

new globalVehicleID;
public OnGameModeInit()
{
    globalVehicleID = CreateVehicle(596, 0, 0, 3, 0, 0, 0, -1, -1, -1);
    return 1;
}
 
public OnPlayerConnect(playerid)
{
    EnablePlayerCameraTarget(playerid, true);
    return 1;
}
 
public OnPlayerCommandText(playerid, cmdtext[])
{
    if(!strcmp(cmdtext, "/check", true))
    {
        new vehicleid = GetPlayerCameraTargetVehicle(playerid);
        if(vehicleid == globalVehicleID)
        {
             SendClientMessage(playerid, -1, "You're looking at your vehicle!");
        }
        else 
        {
            SendClientMessage(playerid, -1, "You're not looking at your vehicle.");
        }
        return 1;
    }
    return 0;
}
Image:32px-Ambox_warning_orange.png

Note

This function can (obviously) only return one vehicle ID at a time, while the player may be looking at multiple. It generally seems to detect the closest vehicle first.


Related Functions

The following functions may be useful, as they are related to this function in one way or another.

In other languages