SetObjectTexture

From Onset Developer Wiki
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.
SetObjectTexture

Type: Function
Context: Client
Introduced: v1.0

Description

Sets a texture on an object. For animated ones check SetObjectAnimatedTexture.

Syntax

SetObjectTexture(object, TextureFile [, MaterialSlot])

Parameters

  • object
    The object identifier.
  • TextureFile
    The texture file in your package folder.
  • MaterialSlot (optional)
    The material slot of the object model. Default: 0

Return Value

  • Returns true on success.

Example

Example taken from the example test scripts: https://github.com/BlueMountainsIO/OnsetLuaScripts/blob/master/horizon/client/world.lua#L81

function OnObjectStreamIn(object)
	local _texture = GetObjectPropertyValue(object, "_texture")

	if _texture ~= nil then
		local _textureFile = GetObjectPropertyValue(object, "_textureFile")

		if _texture == "animated" then
			local _textureRowColumns = GetObjectPropertyValue(object, "_textureRowColumns")
			SetObjectAnimatedTexture(object, _textureFile, _textureRowColumns[1], _textureRowColumns[2])
		elseif _texture == "static" then
			SetObjectTexture(object, _textureFile)
		end
	end
end
AddEvent("OnObjectStreamIn", OnObjectStreamIn)

See also