SetObjectTexture

From Onset Developer Wiki
Revision as of 11:07, 1 September 2020 by BlueMountains (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
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