getObjectMaterials: Difference between revisions
Lou Montana (talk | contribs) 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= ") |
Killzone Kid (talk | contribs) No edit summary |
||
| (11 intermediate revisions by 2 users not shown) | |||
| Line 10: | Line 10: | ||
|descr= Gets all custom materials associated with the object. | |descr= Gets all custom materials associated with the object. | ||
|s1= | |s1= [[getObjectMaterials]] obj | ||
|p1= obj: [[Object]] | |p1= obj: [[Object]] | ||
|r1=[[Array]] of [[String]]s - array of materials | |r1= [[Array]] of [[String]]s - array of materials | ||
| | |s2= obj [[getObjectMaterials]] sels | ||
|s2since= Arma3 2.20 | |||
|seealso= [[setObjectMaterial]] | |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
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:
- 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