SetObjectTexture: Difference between revisions

From Onset Developer Wiki
Created page with "{{Info|Function|Client|1.0}} {{FuncDescription|__EDIT_ME__}} {{FuncSyntax|SetObjectTexture(object, TextureFile [, MaterialSlot])}} {{FuncParameters}} {{FuncParam|object|__E..."
 
No edit summary
 
(5 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Info|Function|Client|1.0}}
{{Info|Function|Client|1.0}}


{{FuncDescription|__EDIT_ME__}}
{{FuncDescription|Sets a texture on an object. For animated ones check [[SetObjectAnimatedTexture]].}}


{{FuncSyntax|SetObjectTexture(object, TextureFile [, MaterialSlot])}}
{{FuncSyntax|SetObjectTexture(object, TextureFile [, MaterialSlot])}}


{{FuncParameters}}
{{FuncParameters}}
{{FuncParam|object|__EDIT_ME__}}
{{FuncParam|object|The object identifier.}}
{{FuncParam|TextureFile |__EDIT_ME__}}
{{FuncParam|TextureFile|The texture file in your package folder.}}
{{FuncParamOptional|MaterialSlot|__EDIT_ME__}}
{{FuncParamOptional|MaterialSlot|The material slot of the object model. Default: 0}}


{{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}}
__EDIT_ME__
* [[GetObjectCount]]
* [[GetObjectModelCount]]
* [[GetObjectModelGroup]]
* [[GetObjectModelName]]
* [[GetStreamedObjects]]
* [[GetObjectModel]]
* [[GetObjectLocation]]
* [[GetObjectRotation]]
* [[GetObjectScale]]
* [[GetObjectBoundingBox]]
* [[GetObjectSize]]
* [[EnableObjectHitEvents]]
* [[GetObjectMass]]
* [[SetObjectEditorSpeed]]
* [[SetObjectEditable]]
* [[SetObjectOutline]]
* [[SetObjectCastShadow]]
* [[SetObjectColor]]
* [[SetObjectEmissiveColor]]
* [[SetObjectAnimatedTexture]]

Latest revision as of 11:07, 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. 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