getObjectTextures: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " \| *(game[0-9]|version[0-9]|gr[0-9]|serverExec|mp|pr|descr|s[0-9]|p[0-9]{1,3}|r[0-9]|x1?[0-9]|seealso) *= +" to " |$1= ")
No edit summary
 
(16 intermediate revisions by 2 users not shown)
Line 8: Line 8:
|gr1= Object Manipulation
|gr1= Object Manipulation


|descr= Gets all custom textures (hiddenSelectionsTextures) associated with the object. {{Feature|important|It will return an empty [[Array]] when executed 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]].}}


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


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


|r1=[[Array]] of [[String]]s - array of textures
|r1= [[Array]] of [[String]]s - array of textures


|x1= <code>_textures = [[getObjectTextures]] [[player]];</code>
|s2= obj [[getObjectTextures]] sels
|s2since= Arma3 2.20


|seealso= [[setObjectTexture]], [[setObjectTextureGlobal]], [[getObjectMaterials]], [[setObjectMaterial]], [[setObjectMaterialGlobal]], [[getModelInfo]]
|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= <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]]
}}
}}

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