roadsConnectedTo: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(alt syntax)
m (Text replacement - "<sqf>([^↵][^\/]*↵[^\/]*)<\/sqf>" to "<sqf> $1 </sqf>")
 
(39 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command
____________________________________________________________________________________________


| arma2 |Game name=
|game1= arma2
|version1= 1.00


|1.00|Game version=
|game2= arma2oa
____________________________________________________________________________________________
|version2= 1.50


| Find the road segments connected to the given road segment.
|game3= tkoh
{{Important | Pedestrian roads such as <tt>"TRAIL"</tt>s are missing connection information by design, therefore basic command will return empty array for those. Use alternative syntax to return pedestrian roads (available since Since Arma 3 v1.99.146461) }}  |DESCRIPTION=
|version3= 1.00
____________________________________________________________________________________________


| '''roadsConnectedTo''' roadSegment |SYNTAX=
|game4= arma3
|version4= 0.50


|p1= roadSegment: [[Object]] - road segment |PARAMETER1=  
|gr1= Roads and Airports


|p2= |PARAMETER2=
|descr= Find the road segments connected to the given road segment.
{{Feature|important|
* Pedestrian roads such as {{hl|"TRAIL"}}s are missing connection information by design, therefore the primary syntax will return empty array for those - use the alternative syntax to return pedestrian roads.
* Road connection is not bidirectional; e.g road segment Y can be connected to road segment Z, but road segment Z can lack a connection with road segment Y.
}}


|p3= |PARAMETER3=  
|s1= [[roadsConnectedTo]] roadSegment


| [[Array]] of [[Object]]s - connected road segments|RETURNVALUE=
|p1= roadSegment: [[Object]] - road segment


|s2 = [[roadsConnectedTo]] [roadSegment, extended] &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <i>(Since Arma 3 v1.99.146461)</i> |SYNTAX2=
|r1= [[Array]] of [[Object]]s - connected road segments
|p21 = [roadSegment, extended] - [[Array]] |PARAMETER21=
|p22= roadSegment: [[Object]] - road segment |PARAMETER22=
|p23= extended (Optional): [[Boolean]] - when [[true]] performs more thorough search on top of base behaviour, slower but returns pedestrian and other missing road segments. Default: [[false]] - base behaviour |PARAMETER23=


|r2= [[Array]] of [[Object]]s - connected road segments|RETURNVALUE2=
|s2= [[roadsConnectedTo]] [roadSegment, extended]


|x1= <code>_road = ([[player]] [[nearRoads]] 50) [[select]] 0;
|s2since= arma3 2.00
_connectedRoads = [[roadsConnectedTo]] _road;</code>|EXAMPLE1=  


|x2= <code>_road = ([[player]] [[nearRoads]] 50) [[select]] 0;
|p21= roadSegment: [[Object]] - road segment
_connectedRoadsIncPedestrian = [[roadsConnectedTo]] [_road, [[true]]];</code>|EXAMPLE2=


____________________________________________________________________________________________
|p22= extended: [[Boolean]] - (Optional, default [[false]]) when [[true]], performs a more thorough search on top of base behaviour, slower but returns pedestrian and other missing road segments


| [[nearRoads]], [[isOnRoad]], [[roadAt]], [[surfaceIsWater]]  |SEEALSO=
|r2= [[Array]] of [[Object]]s - connected road segments


| |MPBEHAVIOUR=  
|x1= <sqf>
____________________________________________________________________________________________
_road = (player nearRoads 50) select 0;
}}
_connectedRoads = roadsConnectedTo _road;
</sqf>


<h3 style='display:none'>Notes</h3>
|x2= <sqf>
<dl class='command_description'>
_road = (player nearRoads 50) select 0;
<!-- Note Section BEGIN -->
_connectedRoadsIncPedestrian = roadsConnectedTo [_road, true];
</sqf>


<!-- Note Section END -->
|seealso= [[nearRoads]] [[isOnRoad]] [[roadAt]] [[surfaceIsWater]] [[getRoadInfo]] [[nearestTerrainObjects]]
</dl>
}}
 
<h3 style='display:none'>Bottom Section</h3>
 
[[Category:Scripting Commands Arma 2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Take On Helicopters|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]

Latest revision as of 11:34, 3 September 2024

Logo A2.png1.00A2 OA Logo.png1.50tkoh logo small.png1.00Arma 3 logo black.png0.50
Hover & click on the images for description

Description

Description:
Find the road segments connected to the given road segment.
⚠
  • Pedestrian roads such as "TRAIL"s are missing connection information by design, therefore the primary syntax will return empty array for those - use the alternative syntax to return pedestrian roads.
  • Road connection is not bidirectional; e.g road segment Y can be connected to road segment Z, but road segment Z can lack a connection with road segment Y.
Groups:
Roads and Airports

Syntax

Syntax:
roadsConnectedTo roadSegment
Parameters:
roadSegment: Object - road segment
Return Value:
Array of Objects - connected road segments

Alternative Syntax

Syntax:
roadsConnectedTo [roadSegment, extended]
Parameters:
roadSegment: Object - road segment
extended: Boolean - (Optional, default false) when true, performs a more thorough search on top of base behaviour, slower but returns pedestrian and other missing road segments
Return Value:
Array of Objects - connected road segments

Examples

Example 1:
_road = (player nearRoads 50) select 0; _connectedRoads = roadsConnectedTo _road;
Example 2:
_road = (player nearRoads 50) select 0; _connectedRoadsIncPedestrian = roadsConnectedTo [_road, true];

Additional Information

See also:
nearRoads isOnRoad roadAt surfaceIsWater getRoadInfo nearestTerrainObjects

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=roadsConnectedTo&oldid=369200"