BIS fnc KMLimport: Difference between revisions

Latest revision as of 00:25, 2 February 2024

1.00

0.50

Hover & click on the images for description

Description

Description:: Read positions from a KML file.
ⓘ
Recommended to execute in loading screen.
Execution:: call
Groups:: Map and Markers

Syntax

Syntax:

filePath call BIS_fnc_KMLimport

Parameters:

filePath: String - (Optional, default "hsim\Doc_H\GoogleEarth\Missions\" + missionName + ".kml") KML file path

Default value only works in Take On Helicopters. Do not rely on it in Arma 3.

Return Value:

Array of Arrays in format [type, positionXYZ, folder, name, description]

type: Number - 0 for a point, 1 for a line, 2 for a polygon
positionXYZ: Position - format PositionAGL
folder: String - path to the value, "" if in the .kml root
name: String - location's name
description: String - location's description

Examples

Example 1:: private _data = "subDir\myFile.kml" call BIS_fnc_KMLimport;

Additional Information

See also:: BIS_fnc_keypointsExportFromKML BIS_fnc_dbImportXML BIS_fnc_posDegToWorld

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

@@ Line 9: / Line 9: @@
 |gr1= Map and Markers
-|descr= Read positions from a {{Wikipedia|Keyhole_Markup_Language|KML file}}.
+|descr= Read positions from a {{Link|https://en.wikipedia.org/wiki/Keyhole_Markup_Language|KML file}}.
-{{Feature|Informative|Recommended to execute in loading screen.}}
+{{Feature|informative|Recommended to execute in loading screen.}}
 |s1= filePath call [[BIS_fnc_KMLimport]]
-|p1= filePath: [[String]] - (Optional, default {{ic|"hsim\Doc_H\GoogleEarth\Missions\" + [[missionName]] + ".kml"}}) KML file path
+|p1= filePath: [[String]] - (Optional, default <sqf inline>"hsim\Doc_H\GoogleEarth\Missions\" + missionName + ".kml"</sqf>) KML file path
-{{Feature|arma3|Default value only works in {{tkoh}}. Do not rely on it in {{arma3}}}}
+{{Feature|arma3|Default value only works in {{tkoh}}. Do not rely on it in {{arma3}}.}}
-|r1= [[Array]] of [[Array|Arrays]] in format [type, positionXYZ, folder, name, description]
+|r1= [[Array]] of [[Array]]s in format [type, positionXYZ, folder, name, description]
 * type: [[Number]] - 0 for a point, 1 for a line, 2 for a polygon
 * positionXYZ: [[Position]] - format [[Position#PositionAGL|PositionAGL]]
@@ Line 24: / Line 24: @@
 * description: [[String]] - location's description
-|x1= <code>[[private]] _data = "subDir\myFile.kml" [[call]] [[BIS_fnc_KMLimport]];</code>
+|x1= <sqf>private _data = "subDir\myFile.kml" call BIS_fnc_KMLimport;</sqf>
-|seealso= [[BIS_fnc_keypointsExportFromKML]] [[BIS_fnc_dbImportXML]], [[BIS_fnc_posDegToWorld]]
+|seealso= [[BIS_fnc_keypointsExportFromKML]] [[BIS_fnc_dbImportXML]] [[BIS_fnc_posDegToWorld]]
 }}