getObjectTextures: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "|= Game version" to "|Game version=")
No edit summary
 
(40 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command
____________________________________________________________________________________________


| arma3 |= Game name
|game1= arma3
|version1= 1.38


|1.38|Game version=
|arg= global


|arg= global |Multiplayer Arguments=
|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]] |DESCRIPTION=
|s1= [[getObjectTextures]] obj
____________________________________________________________________________________________


| '''getObjectTextures''' obj |SYNTAX=
|p1= obj: [[Object]]


|p1= obj: [[Object]] |PARAMETER1=
|r1= [[Array]] of [[String]]s - array of textures


| [[Array]] of [[String]]s - array of textures |RETURNVALUE=  
|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)


|x1= <code>_textures = [[getObjectTextures]] [[player]];</code>|EXAMPLE1=
|r2= [[Array]] of [[String]]s - array of textures in order of 'sels'. Non existing textures filled with [[nil]]s.
____________________________________________________________________________________________


| [[setObjectTexture]], [[setObjectTextureGlobal]], [[getObjectMaterials]], [[setObjectMaterial]], [[setObjectMaterialGlobal]], [[getModelInfo]] |SEEALSO=


| |MPBEHAVIOUR=  
|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>
 
|seealso= [[setObjectTexture]] [[setObjectTextureGlobal]] [[getObjectMaterials]] [[setObjectMaterial]] [[setObjectMaterialGlobal]] [[getModelInfo]]
}}
}}
<h3 style='display:none'>Notes</h3>
<dl class='command_description'>
<!-- Note Section BEGIN -->
<!-- Note Section END -->
</dl>
<h3 style='display:none'>Bottom Section</h3>
[[Category:Arma_3:_New_Scripting_Commands_List|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[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