CreatePlayer3DTextLabel

From SA-MP Wiki

Jump to: navigation, search


CreatePlayer3DTextLabel was added in SA-MP 0.3a This function was added in SA-MP 0.3a and will not work in earlier versions!


Description:

Creates a 3D Text Label only for a specific player

.

Parameters:
(playerid, text[], color, Float:X, Float:Y, Float:Z, Float:DrawDistance, attachedplayer, attachedvehicle, testLOS)
playeridThe player which should see the newly created 3DText Label.
text[]The text to display.
colorThe text color
xX Coordinate (or offset if attached)
yY Coordinate (or offset if attached)
zZ Coordinate (or offset if attached)
DrawDistanceThe distance where you are able to see the 3D Text Label
attachedplayerThe player you want to attach the 3D Text Label to. (None: INVALID_PLAYER_ID)
attachedvehicleThe vehicle you want to attach the 3D Text Label to. (None: INVALID_VEHICLE_ID)
testLOS0/1 Test the line-of-sight so this text can't be seen through walls


Return Values:

The ID of the newly created Player 3D Text Label, or INVALID_3DTEXT_ID if the Player 3D Text Label limit (MAX_3DTEXT_PLAYER) was reached.


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

Important
Note

If text[] is empty, the server/clients next to the text might crash!


Image:32px-Ambox_warning_orange.png

Note

drawdistance seems to be a lot smaller when spectating.


Example Usage:

if(strcmp(cmd, "/playerlabel", true) == 0)
{
    new PlayerText3D:playertextid;
    new Float:X, Float:Y, Float:Z;
    GetPlayerPos( playerid, X, Y, Z );
    playertextid = CreatePlayer3DTextLabel(playerid,"Hello\nI'm at your position",0x008080FF,X,Y,Z,40.0);
    return 1;
}

Related Functions

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


Personal tools
In other languages