BIS fnc randomPosIntersection: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (infobox to template)
m (page filled)
Line 1: Line 1:
{{Function|= Comments
{{Function


| arma3 |Game name=
|game1= arma3


|1.82|Game version=
|version1= 1.82


<!---|arg= local |Multiplayer Arguments=--->
<!--|exec= server|=-->


<!---|eff= local |Multiplayer Effects=--->
<!--|arg= local-->


| <pre>/*
<!--|eff= local-->
Author: Riccardo Argiolas


Description:
|descr= Returns random 2D position inside the intersection of two circles. [-1,-1] is returned if the circles do not intersect.
Returns random 2D position inside the intersection of two circles. [-1,-1] is returned if the circles do not intersect.


Parameters:
|s1= [firstCircle, secondCircle, positioning1, positioning2] call [[BIS_fnc_randomPosIntersection]]
Select 0 - OBJECT/STRING/ARRAY : First circle. Can be a trigger, a marker or an array of [circleCenter, radius], where circleCenter is [xCenterPosition, yCenterPosition]
Select 1 - OBJECT/STRING/ARRAY : Second circle. Same as above.
Select 2 - NUMBER : If a value between 0 and 1 is passed (0 and 1 included), then a gaussian distribution is used. This will influence the random position along the axis which connects the two circles' centers. A lower value means the position will be close to the first circle.
Select 3 - NUMBER : If a value between 0 and 1 is passed (0 and 1 included), then a gaussian distribution is used. This will influence the random position along the axis perpendicular to the axis which connects the two circles' centers.
Returns:
ARRAY : 2D Position in [x,y] format
*/</pre>{{placeholder}}<!-- Remove this after fill-in --> |Description=


|[] call [[BIS_fnc_randomPosIntersection]]|Syntax=
|p1= firstCircle: [[Object]], [[String]] or [[Array]] - First circle. Can be a trigger, a marker or an array of [circleCenter, radius], where circleCenter is [xCenterPosition, yCenterPosition]


|p1= parameter: Datatype - (Optional, default defValue) description |Parameter 1=
|p2= secondCircle: [[Object]], [[String]] or [[Array]] - Second circle. Same as above.


|Datatype - description|Return value=
|p3= positioning1: [[Number]] - (Optional, default -1) If a value between 0 and 1 is passed (0 and 1 included), then a gaussian distribution is used. This will influence the random position along the axis which connects the two circles' centers. A lower value means the position will be close to the first circle


|x1= <code></code>|Example 1=
|p4= positioning2: [[Number]] - (Optional, default -1) If a value between 0 and 1 is passed (0 and 1 included), then a gaussian distribution is used. This will influence the random position along the axis perpendicular to the axis which connects the two circles' centers.


|exec= call |Execution=
|r1= [[Array]] - 2D Position
 
|x1= <code>[trigger1,trigger2,0.75,0.75] [[call]] [[BIS_fnc_randomPosIntersection]];</code>
 
|exec= call
 
|seealso=


| |See also=
}}
}}


Revision as of 12:42, 12 January 2020

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

Description

Description:
Returns random 2D position inside the intersection of two circles. [-1,-1] is returned if the circles do not intersect.
Execution:
call
Groups:
Uncategorised

Syntax

Syntax:
[firstCircle, secondCircle, positioning1, positioning2] call BIS_fnc_randomPosIntersection
Parameters:
firstCircle: Object, String or Array - First circle. Can be a trigger, a marker or an array of [circleCenter, radius], where circleCenter is [xCenterPosition, yCenterPosition]
secondCircle: Object, String or Array - Second circle. Same as above.
positioning1: Number - (Optional, default -1) If a value between 0 and 1 is passed (0 and 1 included), then a gaussian distribution is used. This will influence the random position along the axis which connects the two circles' centers. A lower value means the position will be close to the first circle
positioning2: Number - (Optional, default -1) If a value between 0 and 1 is passed (0 and 1 included), then a gaussian distribution is used. This will influence the random position along the axis perpendicular to the axis which connects the two circles' centers.
Return Value:
Array - 2D Position

Examples

Example 1:
[trigger1,trigger2,0.75,0.75] call BIS_fnc_randomPosIntersection;

Additional Information

See also:
See also needed

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=BIS_fnc_randomPosIntersection&oldid=147775"