SetObjectMaterial

warning

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

Description

Replace the texture of an object with the texture from another model in the game.

NameDescription
objectidThe ID of the object to change the texture of
materialindexThe material index on the object to change (0 to 15)
modelidThe modelid on which the replacement texture is located. Use 0 for alpha. Use -1 to change the material color without altering the texture.
txdnameThe name of the txd file which contains the replacement texture (use "none" if not required)
texturenameThe name of the texture to use as the replacement (use "none" if not required)
materialcolorThe object color to set, as an integer or hex in ARGB color format. Using 0 keeps the existing material color.

Returns

1: The function was executed successfully.

0: The function failed to execute.

Examples

public OnPlayerCommandText(playerid,cmdtext[])
{
if (!strcmp(cmdtext,"/mycommand",true))
{
new
Float: X, Float: Y, Float: Z,
myObject;
GetPlayerPos(playerid, X, Y, Z);
myObject = CreateObject(19371, X, Y, Z+0.5, 0.0, 0.0, 0.0, 300.0);
SetObjectMaterial(myObject, 0, 19341, "egg_texts", "easter_egg01", 0xFFFFFFFF);
//Replaces the texture of our object with the texture of object 19341
return 1;
}
return 0;
}

Notes

tip

Vertex lighting of the object will disappear if material color is changed.

warning

You MUST use ARGB color format, not RGBA like used in client messages etc.

Related Functions

  • SetPlayerObjectMaterial: Replace the texture of a player object with the texture from another model in the game.
  • SetObjectMaterialText: Replace the texture of an object with text.
  • Ultimate Creator by Nexius
  • Fusez's Map Editor by RedFusion