CreatePlayerObject

CreatePlayerObject

Description:

Function CreatePlayerObject сreates an object which will be visible to only one player.

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

Parameters:

(playerid, modelid, Float:X, Float:Y, Float:Z, Float:rX, Float:rY, Float:rZ, Float:DrawDistance)

int

playerid

The ID of the player to create the object for.

int

modelid

The model to create.

float

X

The X coordinate to create the object at.

float

Y

The Y coordinate to create the object at.

float

Z

The Z coordinate to create the object at.

float

rX

The X rotation of the object.

float

rY

The Y rotation of the object.

float

rZ

The Z rotation of the object.

float

DrawDistance

The 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.

Examples:

Example 1

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.

• DestroyPlayerObject: Destroy a player object.
• IsValidPlayerObject: Checks if a certain player object is vaild.
• MovePlayerObject: Move a player object.
• StopPlayerObject: Stop a player object from moving.
• SetPlayerObjectPos: Set the position of a player object.
• SetPlayerObjectRot: Set the rotation of a player object.
• GetPlayerObjectPos: Locate a player object.
• GetPlayerObjectRot: Check the rotation of a player object.
• AttachPlayerObjectToPlayer: Attach a player object to a player.