getObjectMaterials: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " |r1=[[" to " |r1= [[")
No edit summary
 
(9 intermediate revisions by 2 users not shown)
Line 16: Line 16:
|r1= [[Array]] of [[String]]s - array of materials
|r1= [[Array]] of [[String]]s - array of materials


|x1= <code>_materials = [[getObjectMaterials]] car;</code>
|s2= obj [[getObjectMaterials]] sels
|s2since= Arma3 2.20


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

Latest revision as of 00:24, 2 January 2025

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