getMissionPath: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Add example values)
m (Text replacement - "‎" to "")
 
(22 intermediate revisions by 3 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
____________________________________________________________________________________________


| 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=
|gr2= Mission Information
____________________________________________________________________________________________


| [[getMissionPath]] filename |SYNTAX=
|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.


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


| [[String]] - absolute path |RETURNVALUE=
|p1= filename: [[String]]
____________________________________________________________________________________________


|x1 = <code>{{cc|would return e.g "C:\Users\Username\Documents\Arma 3\missions\MissionName.Altis\icons\myIcon.paa"}}
|r1= [[String]] - absolute path
[[private]] _path = [[getMissionPath]] "icons\myIcon.paa";
[[private]] _path = [[getMissionPath]] "\icons\myIcon.paa"; {{cc|leading \ is also fine}}
</code> |EXAMPLE1=


|x2 = <code>{{cc|would return e.g "C:\Users\Username\Documents\Arma 3\missions\MissionName.Altis\" with the trailing \}}
|x1= <sqf>
[[private]] _root = [[getMissionPath]] "";</code> |EXAMPLE2=
// 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>


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


<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");