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
ghi chú
- The
x, ycoordinate is the top left coordinate for the text draw area based on a 640x480 "canvas" (irrespective of screen resolution). - If you plan on using PlayerTextDrawAlignment with alignment 3 (
TEXT_DRAW_ALIGN_RIGHT), thex, ycoordinate is the top right coordinate for the text draw. - This function merely CREATES the textdraw, you must use PlayerTextDrawShow to show it to a player.
- Player-textdraws are automatically destroyed when a player disconnects.
mẹo
It is recommended to use WHOLE numbers instead of decimal positions when creating player textdraws to ensure resolution friendly design.
cảnh báo
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).