GetPlayerCameraTargetVehicle

GetPlayerCameraTargetVehicle

Description:

Function GetPlayerCameraTargetVehicle get the ID of the vehicle the player is looking at.

Function GetPlayerCameraTargetVehicle was added in 0.3.7 and will not work in earlier versions!

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.

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

Parameters:

(playerid)

int

playerid

The ID of the player to check.

Return Values:

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

Examples:

Example 1

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;
}

Related Functions

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

• GetPlayerCameraTargetPlayer: Get the ID of the player a player is looking at.
• GetPlayerCameraTargetObject: Get the ID of the object a player is looking at.
• EnablePlayerCameraTarget: Enable player camera targetting functions.
• GetPlayerCameraFrontVector: Get the player's camera front vector.