GetPlayerCameraTargetObject

GetPlayerCameraTargetObject

Description:

Function GetPlayerCameraTargetObject retrieve the ID of the object the player is looking at.

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

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 ID of the object playerid is looking at. If INVALID_OBJECT_ID (65535) is returned, playerid isn't looking at any object.

Examples:

Example 1

new globalObjectID;
public OnGameModeInit()
{
    globalObjectID = CreateObject(1337, 0.0, 0.0, 3.0, 0.0, 0.0, 0.0);
    return 1;
}
 
public OnPlayerCommandText(playerid, cmdtext[])
{
    if(!strcmp(cmdtext, "/check", true))
    {
        new objectid = GetPlayerCameraTargetObject(playerid);
        if(objectid == globalObjectID)
        {
             SendClientMessage(playerid, -1, "You're looking at your object.");
        }
        else if(objectid == INVALID_OBJECT_ID) // INVALID_OBJECT_ID = 65535
        {
             SendClientMessage(playerid, -1, "You're not looking at any object.");
        }
        return 1;
    }
    return 0;
}

Related Functions

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

• GetPlayerCameraTargetVehicle: Get the ID of the vehicle a player is looking at.
• GetPlayerCameraTargetPlayer: Get the ID of the player a player is looking at.
• GetPlayerCameraFrontVector: Get the player's camera front vector.