getObjectTextures: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "{{GameCategory|arma3|New Scripting Commands}} {{GameCategory|arma3|Scripting Commands}} {{uc:{{PAGENAME}}}}" to "")
No edit summary
 
(23 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{RV|type=command
{{RV|type=command


| arma3
|game1= arma3
 
|version1= 1.38
|1.38


|arg= global
|arg= global
Line 9: Line 8:
|gr1= Object Manipulation
|gr1= Object Manipulation


| Gets all custom textures (hiddenSelectionsTextures) associated with the object. <br> Doesn't work on [[Arma 3 Simple Objects|simple objects]]
|descr= Gets all custom textures (hiddenSelectionsTextures) associated with the object. {{Feature|important|Prior to Arma 3 v2.20 it will return an empty [[Array]] when executed on [[Arma 3: Simple Objects|simple objects]].}}


| '''getObjectTextures''' obj
|s1= [[getObjectTextures]] obj


|p1= obj: [[Object]]
|p1= obj: [[Object]]


| [[Array]] of [[String]]s - array of textures
|r1= [[Array]] of [[String]]s - array of textures
 
|s2= obj [[getObjectTextures]] sels
|s2since= Arma3 2.20
 
|p21= obj: [[Object]] - entity
|p22= sels: [[Array]] - array of index(es) and/or selection(s). If array is empty [] - default object textures are returned (see example 3)
 
|r2= [[Array]] of [[String]]s - array of textures in order of 'sels'. Non existing textures filled with [[nil]]s.
 


|x1= <code>_textures = [[getObjectTextures]] [[player]];</code>
|x1= <sqf>_textures = getObjectTextures player;</sqf>
|x2= <sqf>player setObjectTexture ["clan", "\a3\missions_f_epa\data\img\orbat\b_111_texture_ca.paa"];
player getObjectTextures ["clan", 1, 0, player, "dskjhkjhsad"];
// ["a3\missions_f_epa\data\img\orbat\b_111_texture_ca.paa","","a3\characters_f\blufor\data\clothing1_co.paa",<null>,<null>]</sqf>
|x3= <sqf>player setObjectTexture [0, ""];
player getObjectTextures []; // ["a3\characters_f\blufor\data\clothing1_co.paa",""]</sqf>


| [[setObjectTexture]], [[setObjectTextureGlobal]], [[getObjectMaterials]], [[setObjectMaterial]], [[setObjectMaterialGlobal]], [[getModelInfo]]
|seealso= [[setObjectTexture]] [[setObjectTextureGlobal]] [[getObjectMaterials]] [[setObjectMaterial]] [[setObjectMaterialGlobal]] [[getModelInfo]]
}}
}}

Latest revision as of 21:33, 27 October 2024

Hover & click on the images for description

Description

Description:
Gets all custom textures (hiddenSelectionsTextures) associated with the object.
Prior to Arma 3 v2.20 it will return an empty Array when executed on simple objects.
Groups:
Object Manipulation

Syntax

Syntax:
getObjectTextures obj
Parameters:
obj: Object
Return Value:
Array of Strings - array of textures

Alternative Syntax

Syntax:
obj getObjectTextures sels
Parameters:
obj: Object - entity
sels: Array - array of index(es) and/or selection(s). If array is empty [] - default object textures are returned (see example 3)
Return Value:
Array of Strings - array of textures in order of 'sels'. Non existing textures filled with nils.

Examples

Example 1:
_textures = getObjectTextures player;
Example 2:
player setObjectTexture ["clan", "\a3\missions_f_epa\data\img\orbat\b_111_texture_ca.paa"]; player getObjectTextures ["clan", 1, 0, player, "dskjhkjhsad"]; // ["a3\missions_f_epa\data\img\orbat\b_111_texture_ca.paa","","a3\characters_f\blufor\data\clothing1_co.paa",<null>,<null>]
Example 3:
player setObjectTexture [0, ""]; player getObjectTextures []; // ["a3\characters_f\blufor\data\clothing1_co.paa",""]

Additional Information

See also:
setObjectTexture setObjectTextureGlobal getObjectMaterials setObjectMaterial setObjectMaterialGlobal getModelInfo

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note