getMissionPath: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "_{10,} " to "")
m (Text replacement - "‎" to "")
 
(20 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command


| arma3 |Game name=
|game1= arma3
|version1= 1.96


|1.96|Game version=
|gr1= System


|gr1= System |GROUP1=
|gr2= Mission Information


|gr2= Mission Information |GROUP2=
|descr= Returns mission root plus the filename in a form of filepath to be used with commands requiring absolute path such as [[playSound3D]], [[drawIcon3D]], [[createSimpleObject]], etc.
Any leading "\" in the filename will be stripped as the mission root includes one already.


| Returns mission root plus the filename in a form of filepath to be used with commands requiring absolute path such as [[playSound3D]], [[drawIcon3D]], [[createSimpleObject]], etc. Any leading "\" in the filename will be stripped as the mission root includes one already. |DESCRIPTION=
|s1= [[getMissionPath]] filename


| [[getMissionPath]] filename |SYNTAX=
|p1= filename: [[String]]


|p1 = filename: [[String]]
|r1= [[String]] - absolute path


| [[String]] - absolute path |RETURNVALUE=
|x1= <sqf>
// returns e.g "C:\Users\Username\Documents\Arma 3\missions\MissionName.Altis\icons\myIcon.paa"
private _path = getMissionPath "icons\myIcon.paa";
private _path = getMissionPath "\icons\myIcon.paa"; // leading \ is also fine
</sqf>


|x1 = <code>{{cc|would return e.g "C:\Users\Username\Documents\Arma 3\missions\MissionName.Altis\icons\myIcon.paa"}}
|x2= <sqf>
[[private]] _path = [[getMissionPath]] "icons\myIcon.paa";
// returns e.g "C:\Users\Username\Documents\Arma 3\missions\MissionName.Altis\" with the trailing \
[[private]] _path = [[getMissionPath]] "\icons\myIcon.paa"; {{cc|leading \ is also fine}}
private _root = getMissionPath "";
</code> |EXAMPLE1=
</sqf>


|x2 = <code>{{cc|would return e.g "C:\Users\Username\Documents\Arma 3\missions\MissionName.Altis\" with the trailing \}}
|seealso= [[missionConfigFile]] [[playSound3D]] [[drawIcon3D]] [[createSimpleObject]] [[Description.ext|description.ext]] [[playSoundUI]]
[[private]] _root = [[getMissionPath]] "";</code> |EXAMPLE2=
 
| [[missionConfigFile]], [[playSound3D]], [[drawIcon3D]], [[createSimpleObject]], [[description.ext]] |SEEALSO=
}}
}}


<h3 style="display:none">Notes</h3>
{{Note
<dl class="command_description">
|user= Lou Montana
|timestamp= 20230418205440
|text=
Before the introduction of [[getMissionPath]], absolute mission directory could be obtained as follow in config:
<syntaxhighlight lang="cpp">
__EXEC(MISSION_DIRECTORY = __FILE__ select [0, count __FILE__ - 15])
// ...
texture = __EVAL(MISSION_DIRECTORY + "subDirectory\texture.paa");
</syntaxhighlight>


</dl>
}}
 
<h3 style="display:none">Bottom Section</h3>

Latest revision as of 11:54, 26 April 2023

Hover & click on the images for description

Description

Description:
Returns mission root plus the filename in a form of filepath to be used with commands requiring absolute path such as playSound3D, drawIcon3D, createSimpleObject, etc. Any leading "\" in the filename will be stripped as the mission root includes one already.
Groups:
SystemMission Information

Syntax

Syntax:
getMissionPath filename
Parameters:
filename: String
Return Value:
String - absolute path

Examples

Example 1:
// returns e.g "C:\Users\Username\Documents\Arma 3\missions\MissionName.Altis\icons\myIcon.paa" private _path = getMissionPath "icons\myIcon.paa"; private _path = getMissionPath "\icons\myIcon.paa"; // leading \ is also fine
Example 2:
// returns e.g "C:\Users\Username\Documents\Arma 3\missions\MissionName.Altis\" with the trailing \ private _root = getMissionPath "";

Additional Information

See also:
missionConfigFile playSound3D drawIcon3D createSimpleObject description.ext playSoundUI

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
Lou Montana - c
Posted on Apr 18, 2023 - 20:54 (UTC)
Before the introduction of getMissionPath, absolute mission directory could be obtained as follow in config:
__EXEC(MISSION_DIRECTORY = __FILE__ select [0, count __FILE__ - 15])
// ...
texture = __EVAL(MISSION_DIRECTORY + "subDirectory\texture.paa");