getObjectMaterials: Difference between revisions

Latest revision as of 00:24, 2 January 2025

1.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

2.20

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

@@ 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
-| Gets all custom materials associated with the object.
+|descr= Gets all custom materials associated with the object.
-| '''getObjectMaterials''' obj
+|s1= [[getObjectMaterials]] obj
 |p1= obj: [[Object]]
-| [[Array]] of [[String]]s - array of materials
+|r1= [[Array]] of [[String]]s - array of materials
+|s2= obj [[getObjectMaterials]] sels
+|s2since= Arma3 2.20
-|x1= <code>_materials = [[getObjectMaterials]] car;</code>
+|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)
-| [[setObjectMaterial]], [[setObjectTextureGlobal]], [[getObjectTextures]], [[setObjectTexture]], [[setObjectMaterialGlobal]]
+|r2= [[Array]] of [[String]]s - array of materials in order of 'sels'. Non existing materials filled with [[nil]]s.
-|
+|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>
-<dl class='command_description'>
-<!-- Note Section BEGIN -->
-<!-- Note Section END -->
-</dl>
-<h3 style='display:none'>Bottom Section</h3>
+|seealso= [[setObjectMaterial]] [[setObjectTextureGlobal]] [[getObjectTextures]] [[setObjectTexture]] [[setObjectMaterialGlobal]]
-{{GameCategory|arma3|New Scripting Commands}}
+}}
-{{GameCategory|arma3|Scripting Commands}}
-[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]