note Help Needed
This wiki is the result of an ongoing community effort — thank you all for helping!
If you want to provide changes to this page then please click here.
GetPlayerCameraTargetActor
warning
This function was added in SA-MP 0.3.7 and will not work in earlier versions!
Description
Allows you to retrieve the ID of the actor the player is looking at (in any).
Name | Description |
---|---|
playerid | The ID of the player to get the target actor of. |
Returns
The ID of the actor the player is looking at.
Examples
new bool:ActorHandsup[MAX_ACTORS];
public OnPlayerConnect(playerid)
{
EnablePlayerCameraTarget(playerid, true);
return 1;
}
public OnPlayerUpdate(playerid)
{
// Find out what actor (if any) the player is LOOKING at
new playerTargetActor = GetPlayerCameraTargetActor(playerid);
// If they ARE looking at ANY actor
if (playerTargetActor != INVALID_ACTOR_ID)
{
// Store the player's weapon so we can check if they are armed
new playerWeapon = GetPlayerWeapon(playerid);
// Get the player's keys so we can check if they are aiming
new KEY:keys, updown, leftright;
GetPlayerKeys(playerid, keys, updown, leftright);
// If the actor hasn't put its hands up yet, AND the player is ARMED
if (!ActorHandsup[playerTargetActor] && playerWeapon >= 22 && playerWeapon <= 42 && keys & KEY_AIM)
{
// Apply 'hands up' animation
ApplyActorAnimation(playerTargetActor, "SHOP", "SHP_HandsUp_Scr",4.1,0,0,0,1,0);
// Set 'ActorHandsup' to true, so the animation won't keep being reapplied
ActorHandsup[playerTargetActor] = true;
}
}
return 1;
}
Notes
tip
This function only tells you which actor (if any) the player is looking at. To find out if they are aiming at them, you need to use GetPlayerTargetActor.
warning
This function is disabled by default to save bandwidth. Use EnablePlayerCameraTarget to enable it for each player.
Related Functions
- GetPlayerTargetActor: Gets id of an actor which is aimed by certain player.
- GetPlayerCameraTargetPlayer: Get the ID of the player a player is looking at.
- GetPlayerCameraTargetVehicle: Get the ID of the vehicle a player is looking at.
- GetPlayerCameraTargetObject: Get the ID of the object a player is looking at.
- GetPlayerCameraFrontVector: Get the player's camera front vector