BIS fnc locations: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " {2,}\}\}" to " }}")
m (Text replacement - "(\|[pr][0-9]+ *= *[^- ]*) *- *L([a-z ])" to "$1 - l$2")
 
(27 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Function
{{RV|type=function


| arma2
|game1= arma2
|version1= 1.00


|1.00
|game2= arma2oa
|version2= 1.50


|gr1 = Systems
|game3= tkoh
|version3= 1.00


|arg=|eff=| Creates or registers location logics (used in various modules, like [[Ambient Civilians]], [[Ambient Civilian Vehicles]] or Warfare 2).
|game4= arma3
|version4= 0.50


Upon registering, function will set following variables into location logic's variable space:
|gr1= Systems
*"class" - unique class of location (either BIS_loc_<configname> or BIS_loc_custom_<ID>)
*"name" - name of location from config or [[setName]] command. If none is defined, class is used
*"type" - config type
*"neighbors" - config defined neighbor locations


If you're registering currently existing object and some of variables above is already stored in it, it '''won't''' be replaced.
|arg=


| [type(s),area,''debug''] call '''BIS_fnc_locations'''
|eff=


|p1= type(s): [[String]] or [[Array]] of strings
|descr= Creates or registers location logics (used in various modules, like [[Ambient Civilians]], [[Ambient Civilian Vehicles]] or Warfare 2).


|p2= area: [[Array]] in format [center,distance]
Upon registering, function will set following variables into location logic's variable space:
* "class" - unique class of location (either {{hl|BIS_loc_<configname>}} or {{hl|BIS_loc_custom_<ID>}})
* "name" - name of location from config or [[setName]] command. If none is defined, class is used
* "type" - config type
* "neighbors" - config defined neighbor locations


|p3= debug: ''(Optional)'': [[Boolean]]
If you are registering currently existing object and some of variables above is already stored in it, it will '''not''' be replaced.


| [[Array]] - List of registered locations<br><br>
|s1= [types, area, debug] call [[BIS_fnc_locations]]


|s2= [objects] call '''BIS_fnc_locations'''
|p1= types: [[String]] or [[Array]] of [[String]]s


|p21= objects: Array of [[Object]]s or [[Location]]s - list of specific locations to be registered |PARAMETER21=
|p2= area: [[Array]] in format [center, distance]


|r2= [[Array]] - List of registered locations<br><br>
|p3= debug: [[Boolean]] (Optional)


|r1= [[Array]] - list of registered locations
|x1= <code>["CityCenter",<nowiki>[</nowiki>[[position]] [[player]],1000]] call bis_fnc_locations;</code>


|x2= <code><nowiki>[[</nowiki>"acityc_dolina"<nowiki>]]</nowiki> call bis_fnc_locations;</code>
|s2= [objects] call [[BIS_fnc_locations]]


|x3= <code><nowiki>[[</nowiki>myLocation1,myLocation2],[],true] call bis_fnc_locations;</code>
|p21= objects: Array of [[Object]]s or [[Location]]s - list of specific locations to be registered


| [[Functions Library]]
|r2= [[Array]] - list of registered locations
}}
|x1= <sqf>["CityCenter", [getPosATL player, 1000]] call BIS_fnc_locations;</sqf>


<dl class='command_description'>
|x2= <sqf>[["acityc_dolina"]] call BIS_fnc_locations;</sqf>
<!-- Note Section BEGIN -->


<dd class="notedate">Posted on May 31, 2009 - 15:15</dd>
|x3= <sqf>[[myLocation1, myLocation2], [], true] call BIS_fnc_locations;</sqf>
<dt class="note">[[User:Str|Str]]</dt><dd class="note">You can also use '''"" call bis_fnc_locations''' for quick debug of all locations on landscape</dd>


<!-- Note Section END -->
|seealso= [[Functions Library]]
</dl>
}}


 
{{Note
[[Category:Functions|{{uc:locations}}]]
|user= Str
[[Category:{{Name|arma2}}: Functions|{{uc:locations}}]]
|timestamp= 20090531151500
[[Category:{{Name|arma2oa}}: Functions|{{uc:locations}}]]
|text= You can also use <sqf inline>"" call BIS_fnc_locations</sqf> for quick debug of all locations on landscape
[[Category:{{Name|tkoh}}: Functions|{{uc:locations}}]]
}}
[[Category:{{Name|arma3}}: Functions|{{uc:locations}}]]

Latest revision as of 15:38, 8 November 2023

Hover & click on the images for description

Description

Description:
Creates or registers location logics (used in various modules, like Ambient Civilians, Ambient Civilian Vehicles or Warfare 2). Upon registering, function will set following variables into location logic's variable space:
  • "class" - unique class of location (either BIS_loc_<configname> or BIS_loc_custom_<ID>)
  • "name" - name of location from config or setName command. If none is defined, class is used
  • "type" - config type
  • "neighbors" - config defined neighbor locations
If you are registering currently existing object and some of variables above is already stored in it, it will not be replaced.
Execution:
call
Groups:
Systems

Syntax

Syntax:
[types, area, debug] call BIS_fnc_locations
Parameters:
types: String or Array of Strings
area: Array in format [center, distance]
debug: Boolean (Optional)
Return Value:
Array - list of registered locations

Alternative Syntax

Syntax:
[objects] call BIS_fnc_locations
Parameters:
objects: Array of Objects or Locations - list of specific locations to be registered
Return Value:
Array - list of registered locations

Examples

Example 1:
["CityCenter", [getPosATL player, 1000]] call BIS_fnc_locations;
Example 2:
[["acityc_dolina"]] call BIS_fnc_locations;
Example 3:
[[myLocation1, myLocation2], [], true] call BIS_fnc_locations;

Additional Information

See also:
Functions Library

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
Str - c
Posted on May 31, 2009 - 15:15 (UTC)
You can also use "" call BIS_fnc_locations for quick debug of all locations on landscape