getObjectMaterials: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(see also)
No edit summary
 
(38 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 |= Arguments in MP
|gr1= Object Manipulation


____________________________________________________________________________________________
|descr= Gets all custom materials associated with the object.


| Gets all custom materials associated with the object. |= Description
|s1= [[getObjectMaterials]] obj
____________________________________________________________________________________________


| '''getObjectMaterials''' obj |= Syntax
|p1= obj: [[Object]]


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


| [[Array]] of [[String]]s - array of materials |= RETURNVALUE
|s2= obj [[getObjectMaterials]] 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 materials are returned (see example 3)


|x1= <code>_materials = [[getObjectMaterials]] car;</code>|= EXAMPLE1
|r2= [[Array]] of [[String]]s - array of materials in order of 'sels'. Non existing materials filled with [[nil]]s.
____________________________________________________________________________________________


| [[setObjectMaterial]], [[setObjectTextureGlobal]], [[getObjectTextures]], [[setObjectTexture]], [[setObjectMaterialGlobal]] |= SEEALSO
|x1= <sqf>_materials = getObjectMaterials car;</sqf>
|x2= <sqf>player setObjectMaterial ["insignia", "A3\Structures_F\Data\Windows\window_set.rvmat"];
player getObjectMaterials ["insignia", 0, 1, player, "dskjhkjhsad"];
// ["a3\structures_f\data\windows\window_set.rvmat","","a3\structures_f\data\windows\window_set.rvmat",<null>,<null>]</sqf>
|x3= <sqf>player setObjectMaterial [0, "a3\structures_f\data\windows\window_set.rvmat"];
getObjectMaterials player; // ["a3\structures_f\data\windows\window_set.rvmat",""]
player getObjectMaterials []; // ["",""]</sqf>


| |= MPBEHAVIOUR
 
____________________________________________________________________________________________
|seealso= [[setObjectMaterial]] [[setObjectTextureGlobal]] [[getObjectTextures]] [[setObjectTexture]] [[setObjectMaterialGlobal]]
}}
}}
<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 00:24, 2 January 2025

Arma 3 logo black.png1.38
GAGlobal
Hover & click on the images for description

Description

Description:
Gets all custom materials associated with the object.
Groups:
Object Manipulation

Syntax

Syntax:
getObjectMaterials obj
Parameters:
obj: Object
Return Value:
Array of Strings - array of materials

Alternative Syntax

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

Examples

Example 1:
_materials = getObjectMaterials car;
Example 2:
player setObjectMaterial ["insignia", "A3\Structures_F\Data\Windows\window_set.rvmat"]; player getObjectMaterials ["insignia", 0, 1, player, "dskjhkjhsad"]; // ["a3\structures_f\data\windows\window_set.rvmat","","a3\structures_f\data\windows\window_set.rvmat",<null>,<null>]
Example 3:
player setObjectMaterial [0, "a3\structures_f\data\windows\window_set.rvmat"]; getObjectMaterials player; // ["a3\structures_f\data\windows\window_set.rvmat",""] player getObjectMaterials []; // ["",""]

Additional Information

See also:
setObjectMaterial setObjectTextureGlobal getObjectTextures setObjectTexture setObjectMaterialGlobal

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
Retrieved from "https://community.bistudio.com/wiki?title=getObjectMaterials&oldid=370528"