SetObjectTexture: Difference between revisions

From Onset Developer Wiki
No edit summary
No edit summary
Line 10: Line 10:
{{FuncParamOptional|MaterialSlot|The material slot of the object model}}
{{FuncParamOptional|MaterialSlot|The material slot of the object model}}


{{FuncReturnValue|__EDIT_ME__}}
{{FuncReturnValue|Returns '''true''' on success.}}


== Example ==
== Example ==
__EDIT_ME__
Example taken from the example test scripts: https://github.com/BlueMountainsIO/OnsetLuaScripts/blob/master/horizon/client/world.lua#L81
<syntaxhighlight lang="Lua">
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)
</syntaxhighlight>


{{RelatedFunctions}}
{{RelatedFunctions}}

Revision as of 11:06, 1 September 2020

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

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