CreatePlayerObject

From SA-MP Wiki

Jump to: navigation, search


Description:

Creates an object which will be visible to only one player.


Parameters:
(playerid, modelid, Float:X, Float:Y, Float:Z, Float:rX, Float:rY, Float:rZ, Float:DrawDistance = 0.0)
playeridThe ID of the player to create the object for.
modelidThe model to create.
Float:XThe X coordinate to create the object at.
Float:YThe Y coordinate to create the object at.
Float:ZThe Z coordinate to create the object at.
Float:rXThe X rotation of the object.
Float:rYThe Y rotation of the object.
Float:rZThe Z rotation of the object.
Float:DrawDistanceThe distance from which objects will appear to players. 0.0 will cause an object to render at its default distance. Leaving this parameter out will cause objects to be rendered at their default distance. The maximum usable distance is 300 in versions prior to 0.3x, in which drawdistance can be unlimited.


Return Values:

The ID of the object that was created (1 to MAX_OBJECTS-1), or INVALID_OBJECT_ID if the object limit (MAX_OBJECTS) was reached.


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

Important
Note

The 'DrawDistance' parameter was added in 0.3b. It must be left out in scripts for older versions of SA:MP.


Example Usage:

new pObject[MAX_PLAYERS];
 
public OnPlayerConnect(playerid)
{
    pObject[playerid] = CreatePlayerObject(playerid, 2587, 2001.195679, 1547.113892, 14.283400, 0, 0, 96);
 
    // Or alternatively, using the DrawDistance parameter to show it from as far away as possible:
    pObject[playerid] = CreatePlayerObject(playerid, 2587, 2001.195679, 1547.113892, 14.283400, 0, 0, 96, 300.0);
    return 1;
}
 
public OnPlayerDisconnect(playerid, reason)
{
    DestroyPlayerObject(playerid, pObject[playerid]);
    return 1;
}

Related Functions

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


Personal tools
Navigation
Toolbox
In other languages