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.

TextDrawSetString

Description

Changes the text on a textdraw.

Name	Description
Text:textid	The TextDraw to change
const format[]	The new string for the TextDraw
OPEN_MP_TAGS:...	Indefinite number of arguments of any tag.

Returns

This function does not return any specific values.

Examples

new Text:gMyTextdraw;

public OnGameModeInit()
{
    gMyTextdraw = TextDrawCreate(1.0, 5.6, "Hi, how are you?");
    return 1;
}

public OnPlayerConnect(playerid)
{
    new
        string[64],
        playerName[MAX_PLAYER_NAME];

    GetPlayerName(playerid, playerName, sizeof playerName);

    format(string, sizeof(string), "Welcome %s!", playerName);
    TextDrawSetString(gMyTextdraw, string);

    // PRO TIP: You don't need `format` in open.mp
    TextDrawSetString(gMyTextdraw, "Welcome %s!", playerName);

    TextDrawShowForPlayer(playerid, gMyTextdraw);
    return 1;
}

Notes

warning

There are limits to the length of textdraw strings - see here for more info.

Related Functions

TextDrawCreate: Create a textdraw.
TextDrawDestroy: Destroy a textdraw.
TextDrawSetStringForPlayer: Changes the text on a textdraw for a specific player.
TextDrawColor: Set the color of the text in a textdraw.
TextDrawBoxColor: Set the color of the box in a textdraw.
TextDrawBackgroundColor: Set the background color of a textdraw.
TextDrawAlignment: Set the alignment of a textdraw.
TextDrawFont: Set the font of a textdraw.
TextDrawLetterSize: Set the letter size of the text in a textdraw.
TextDrawTextSize: Set the size of a textdraw box.
TextDrawSetOutline: Choose whether the text has an outline.
TextDrawSetShadow: Toggle shadows on a textdraw.
TextDrawSetProportional: Scale the text spacing in a textdraw to a proportional ratio.
TextDrawUseBox: Toggle if the textdraw has a box or not.
TextDrawShowForPlayer: Show a textdraw for a certain player.
TextDrawHideForPlayer: Hide a textdraw for a certain player.
TextDrawShowForAll: Show a textdraw for all players.
TextDrawHideForAll: Hide a textdraw for all players.
TextDrawGetString: Gets the text of a textdraw.