CreatePlayerTextDraw

Tags: player textdraw playertextdraw

WARNING

This feature (player-textdraws) was added in SA-MP 0.3e and will not work in earlier versions!

Description

Creates a textdraw for a single player. This can be used as a way around the global text-draw limit.

Name Description
playerid The ID of the player to create the textdraw for
Float:x X-Coordinate
Float:y Y-Coordinate
text[] The text in the textdraw.

Returns

The ID of the created textdraw

Examples

// This variable is used to store the id of the textdraw
// so that we can use it throught the script
new PlayerText:welcomeText[MAX_PLAYERS];

public OnPlayerConnect(playerid)
{
    // First, create the textdraw
    welcomeText[playerid] = CreatePlayerTextDraw(playerid, 320.0, 240.0, "Welcome to my SA-MP server");

    // Now show it
    PlayerTextDrawShow(playerid, welcomeText[playerid]);
}

Notes

TIP

Player-textdraws are automatically destroyed when a player disconnects.

WARNING

Keyboard key mapping codes (such as ~k~~VEHICLE_ENTER_EXIT~ Doesn't work beyond 255th character.

  • PlayerTextDrawDestroy: Destroy a player-textdraw.
  • PlayerTextDrawColor: Set the color of the text in a player-textdraw.
  • PlayerTextDrawBoxColor: Set the color of a player-textdraw's box.
  • PlayerTextDrawBackgroundColor: Set the background color of a player-textdraw.
  • PlayerTextDrawAlignment: Set the alignment of a player-textdraw.
  • PlayerTextDrawFont: Set the font of a player-textdraw.
  • PlayerTextDrawLetterSize: Set the letter size of the text in a player-textdraw.
  • PlayerTextDrawTextSize: Set the size of a player-textdraw box (or clickable area for PlayerTextDrawSetSelectable).
  • PlayerTextDrawSetOutline: Toggle the outline on a player-textdraw.
  • PlayerTextDrawSetShadow: Set the shadow on a player-textdraw.
  • PlayerTextDrawSetProportional: Scale the text spacing in a player-textdraw to a proportional ratio.
  • PlayerTextDrawUseBox: Toggle the box on a player-textdraw.
  • PlayerTextDrawSetString: Set the text of a player-textdraw.
  • PlayerTextDrawShow: Show a player-textdraw.
  • PlayerTextDrawHide: Hide a player-textdraw.