getObjectTextures: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " *\| *([Cc]omments|COMMENTS|Game|[Gg]ame [Nn]ame( +[0-9])?|Game [Vv]ersion( +[0-9])?|Game Version \(number surrounded by NO SPACES\)|Arguments in MP|Multiplayer Arguments( \("local" or "global"\))?|Effects|Execution|Effects? in MP|M...)
No edit summary
 
(31 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{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


|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]].}}


| Gets all custom textures (hiddenSelectionsTextures) associated with the object. <br> Doesn't work on [[Arma 3 Simple Objects|simple objects]]
|s1= [[getObjectTextures]] obj
 
| '''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


|x1= <code>_textures = [[getObjectTextures]] [[player]];</code>
|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)


| [[setObjectTexture]], [[setObjectTextureGlobal]], [[getObjectMaterials]], [[setObjectMaterial]], [[setObjectMaterialGlobal]], [[getModelInfo]]
|r2= [[Array]] of [[String]]s - array of textures in order of 'sels'. Non existing textures filled with [[nil]]s.


|
}}


<h3 style='display:none'>Notes</h3>
|x1= <sqf>_textures = getObjectTextures player;</sqf>
<dl class='command_description'>
|x2= <sqf>player setObjectTexture ["clan", "\a3\missions_f_epa\data\img\orbat\b_111_texture_ca.paa"];
<!-- Note Section BEGIN -->
player getObjectTextures ["clan", 1, 0, player, "dskjhkjhsad"];
<!-- Note Section END -->
// ["a3\missions_f_epa\data\img\orbat\b_111_texture_ca.paa","","a3\characters_f\blufor\data\clothing1_co.paa",<null>,<null>]</sqf>
</dl>
|x3= <sqf>player setObjectTexture [0, ""];
player getObjectTextures []; // ["a3\characters_f\blufor\data\clothing1_co.paa",""]</sqf>


<h3 style='display:none'>Bottom Section</h3>
|seealso= [[setObjectTexture]] [[setObjectTextureGlobal]] [[getObjectMaterials]] [[setObjectMaterial]] [[setObjectMaterialGlobal]] [[getModelInfo]]
{{GameCategory|arma3|New Scripting Commands}}
}}
{{GameCategory|arma3|Scripting Commands}}
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]

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