getObjectTextures: Difference between revisions

Latest revision as of 21:33, 27 October 2024

1.38

GAGlobal

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

2.20

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

@@ Line 1: / Line 1: @@
-{{Command
+{{RV|type=command
-| arma3
+|game1= arma3
+|version1= 1.38
-|1.38
 |arg= global
@@ Line 9: / Line 8: @@
 |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]]
-| [[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.
-|
-}}
+|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>
-{{GameCategory|arma3|New Scripting Commands}}
+|seealso= [[setObjectTexture]] [[setObjectTextureGlobal]] [[getObjectMaterials]] [[setObjectMaterial]] [[setObjectMaterialGlobal]] [[getModelInfo]]
-{{GameCategory|arma3|Scripting Commands}}
+}}
-[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]