SetObjectMaterialText

From SA-MP Wiki

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

Description:

Replace the texture of an object with text.

Parameters:

(objectid, text[], materialindex = 0, materialsize = OBJECT_MATERIAL_SIZE_256x128, fontface[] = "Arial", fontsize = 24, bold = 1, fontcolor = 0xFFFFFFFF, backcolor = 0, textalignment = 0)

objectid

The ID of the object to replace the texture of with text.

text	The text to show on the object (MAX 2048 characters).

materialindex

The object's material index to replace with text (default: 0) (0 to 15).

materialsize

The size of the material (default: 256x128).

fontface

The font to use (default: Arial).

fontsize

The size of the text (default: 24) (MAX 255).

bold	Bold text. Set to 1 for bold, 0 for not (default: 1).

fontcolor

The color of the text, in ARGB format (default: White).

backcolor

The background color, in ARGB format (default: None (transparent)).

textalignment

The alignment of the text (default: left).

Return Values:

1: The function was executed successfully.
0: The function failed to execute.

Example Usage:

if (strcmp("/text", cmdtext, true) == 0)
{
    new objectid = CreateObject(19353, 0, 0, 10, 0.0, 0.0, 90.0); //create the object
    SetObjectMaterialText(objectid, "SA-MP {FFFFFF}0.3{008500}e {FF8200}RC7", 0, OBJECT_MATERIAL_SIZE_256x128,
    "Arial", 28, 0, 0xFFFF8200, 0xFF000000, OBJECT_MATERIAL_TEXT_ALIGN_CENTER);
    // write "SA-MP 0.3e RC7" on the object, with orange font color and black background
    return 1;
}