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.

CreatePlayerTextDraw

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
const format[]	The text in the textdraw.
OPEN_MP_TAGS:...	Indefinite number of arguments of any tag.

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 OPEN.MP server");

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

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.

Related Functions

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.
IsPlayerTextDrawVisible: Checks if a player-textdraw is shown for the player.
IsValidPlayerTextDraw: Checks if a player-textdraw is valid.
PlayerTextDrawBackgroundColour: Adjust the background colour of a player-textdraw.
PlayerTextDrawBoxColour: Sets the colour of a textdraw's box (PlayerTextDrawUseBox ).
PlayerTextDrawColour: Sets the text colour of a player-textdraw.
PlayerTextDrawGetAlignment: Gets the text alignment of a player-textdraw.
PlayerTextDrawGetBackgroundColour: Gets the background colour of a player-textdraw.
PlayerTextDrawGetBoxColour: Gets the box colour of a player-textdraw.
PlayerTextDrawGetColour: Gets the text colour of a player-textdraw.
PlayerTextDrawGetFont: Gets the text font of a player-textdraw.
PlayerTextDrawGetLetterSize: Gets the width and height of the letters.
PlayerTextDrawGetOutline: Get the outline size on a player-textdraw.
PlayerTextDrawGetPos: Gets the position of a player-textdraw.
PlayerTextDrawGetPreviewModel: Gets the preview model of a 3D preview player-textdraw.
PlayerTextDrawGetPreviewRot: Gets the rotation and zoom of a 3D model preview player-textdraw.
PlayerTextDrawGetPreviewVehicleColours: Gets the preview vehicle colors of a 3D preview player-textdraw.
PlayerTextDrawGetShadow: Get the shadow size on a player-textdraw.
PlayerTextDrawGetString: Gets the text of a player-textdraw.
PlayerTextDrawGetTextSize: Gets the X axis and Y axis of the player-textdraw text size.
PlayerTextDrawIsBox: Checks if a player-textdraw is box.
PlayerTextDrawIsProportional: Checks if a player-textdraw is proportional.
PlayerTextDrawIsSelectable: Checks if a player-textdraw is selectable.
PlayerTextDrawSetPos: Sets the position of a player-textdraw.
PlayerTextDrawSetPreviewVehicleColours: Set the color of a vehicle in a player-textdraw model preview (if a vehicle is shown).

Related Resources

TextDraw Sprites