surfaceTexture: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(Add new syntax for 2.18)
No edit summary
 
(3 intermediate revisions by the same user not shown)
Line 14: Line 14:
|p2= y: [[Number]] - world y coordinate of the position
|p2= y: [[Number]] - world y coordinate of the position
|p3since=arma3 2.18
|p3since=arma3 2.18
|p3= z or useLayerMask: [[Number]] or [[Boolean]] - When a number is provided (Z in 3D positions), it is ignored. When a boolean is provided, it defines whether the layer mask should be used. Using layer mask is more accurate but slightly slower.
|p3= z or useLayerMask: [[Number]] or [[Boolean]] - When a number is provided (Z in 3D positions), it is ignored. When a boolean is provided, it defines whether the layer mask should be used. Using the layer mask is more accurate but slightly slower.
[[File:Capture.png|thumb|256px|The "dirt" texture is defined using a layer mask. The "concrete" texture is the primary surface texture.]]
[[File:Capture.png|thumb|256px|The patches of "dirt" are defined using a layer mask. The "concrete" is the primary surface texture.]]
|r1= [[String]] - Surface texture
|r1= [[String]] - Surface texture


|x1= <sqf>private _groundTexture = surfaceTexture getPosATL player;</sqf>
|x1= <sqf>private _groundTexture = surfaceTexture getPosATL player;</sqf>
|x2= <sqf>private _pos = getPosATL player;
_pos set [2, true]; // use layer mask
private _groundTexture = surfaceTexture _pos;
</sqf>


|seealso= [[surfaceType]] [[getRoadInfo]]
|seealso= [[surfaceType]] [[getRoadInfo]]
}}
}}

Latest revision as of 10:57, 31 March 2024

Hover & click on the images for description

Description

Description:
Same as surfaceType, but returns texture path to ground texture as string.
The texture returned is of the ground, even if there is a road at that position. To get road texture use getRoadInfo command.
Groups:
Positions

Syntax

Syntax:
surfaceTexture [x, y, z or useLayerMask]
Parameters:
x: Number - world x coordinate of the position
y: Number - world y coordinate of the position
since Arma 3 logo black.png2.18
z or useLayerMask: Number or Boolean - When a number is provided (Z in 3D positions), it is ignored. When a boolean is provided, it defines whether the layer mask should be used. Using the layer mask is more accurate but slightly slower.
The patches of "dirt" are defined using a layer mask. The "concrete" is the primary surface texture.
Return Value:
String - Surface texture

Examples

Example 1:
private _groundTexture = surfaceTexture getPosATL player;
Example 2:
private _pos = getPosATL player; _pos set [2, true]; // use layer mask private _groundTexture = surfaceTexture _pos;

Additional Information

See also:
surfaceType getRoadInfo

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