BIS fnc configViewer: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " <h3 style="display:none">Notes</h3> <dl class="command_description"> <!-- Note Section BEGIN --> <!-- Note Section END --> </dl>" to "")
m (Text replacement - "<code>(\[[a-zA-Z0-9_, ]*\] )?\[\[(call|spawn)\]\] \[\[(BI[NS]\_fnc\_[a-zA-Z0-9_]+)\]\];?<\/code>" to "<sqf>$1$2 $3;</sqf>")
(16 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Function|Comments=
{{RV|type=function


| arma2oa |Game name=
|game1= arma2oa
|version1= 1.50


|1.00|Game version=
|game2= tkoh
|version2= 1.00


|gr1 = Diagnostic |GROUP1=
|game3= arma3
|version3= 0.50


| Splendid™ Config Viewer. |DESCRIPTION=
|gr1= Diagnostic


| [parent, cfg, showOk, onSelect, onAdd, header] call [[BIS_fnc_configViewer]] |SYNTAX=
|descr= Opens the [[Arma 3: Splendid Config Viewer|Splendid&trade; Config Viewer]].


|p1= parent: [[Display]] - (Optional, default mission display) parent display |PARAMETER1=
|s1= [parent, cfg, showOk, onSelect, onAdd, header] call [[BIS_fnc_configViewer]]


|p2= cfg: [[Config]] - (Optional, default all configs) root config |PARAMETER2=
|p1= parent: [[Display]] - (Optional, default mission display) parent display


|p3= showOk: [[Boolean]] - (Optional, default [[false]]) true to display OK button. Script will then wait until viewer is closed and return selected class and param |PARAMETER3=
|p2= cfg: [[Config]] - (Optional, default all configs) Root config


|p4= onSelect: [[Code]] - (Optional, default {}) executed upon selecting a class. '''Must return [[String]]''', which will be shown as structured text instead of params. |PARAMETER4=
|p3= showOk: [[Boolean]] - (Optional, default [[false]]) [[true]] to display OK button. Script will then wait until viewer is closed and return selected class and param


|p5= onAdd: [[Code]] - (Optional, default {}) executed upon adding a class to list. Returned value (STRING) is item text. Empty string will skip the item. |PARAMETER5=
|p4= onSelect: [[Code]] - (Optional, default {}) executed upon selecting a class. '''Must return [[String]]''', which will be shown as structured text instead of params. Currently evaluated config is passed in the {{ic|_this}} variable.


|p6= header: [[String]] - (Optional, default "%1") custom header. Use %1 to refer to original name ("Splendid Config Viewer") |PARAMETER6=
|p5= onAdd: [[Code]] - (Optional, default {}) executed upon adding a class to list. Returned value (STRING) is item text. Empty string will skip the item. Currently evaluated config is passed in the {{ic|_this}} variable.


| [[Array]]
|p6= header: [[String]] - (Optional, default "%1") custom header. Use %1 to refer to original name ("Splendid Config Viewer")
* when OK button is not displayed, empty array is returned
* else, an array of currently selected entries in format [class ([[Config]]), param ([[String]])] is returned. |RETURNVALUE=


|x1= <code>[[call]] [[BIS_fnc_configViewer]];</code> |EXAMPLE1=
|r1= [[Array]]
* When OK button is not displayed, empty array is returned
* Else, an array of currently selected entries in format [class ([[Config]]), param ([[String]])] is returned.


| [[BIS_fnc_animViewer]], [[BIS_fnc_help]] |SEEALSO=
|x1= <sqf>call BIS_fnc_configViewer;</sqf>
}}


|x2= <code>[[private]] _return = [
[[nil]],
[[configFile]] >> "CfgWeapons",
[[true]],
[[nil]],
{
[[params]] ["_cfg"];
[[if]] (
[[getNumber]](_cfg >> "scope") == 2 &&
{ {{cc|Layzy evaluation}}
[[getNumber]](_cfg >> "type") [[in]] [1,2,4] && {{cc|primary, secondary, handgun weapons}}
{ ![[isClass]] (_cfg >> "LinkedItems") [[or]] [[getText]](_cfg >> "baseWeapon") == [[configName]] _cfg } {{cc|only base weapons, no accessories}}
}
) [[exitWith]] {
[_cfg] [[call]] [[BIS_fnc_displayName]]; {{cc|add the weapon with its displayname}}
};
"" {{cc|don't add}}
},
"Select Weapon"
] [[call]] [[BIS_fnc_configViewer]];
_cfgSelected = _return [[param]] [0, [[configNull]]];
[[systemChat]] [[str]] [<nowiki/>[[configName]] _cfgSelected, _cfgSelected];</code>


<h3 style="display:none">Bottom Section</h3>
|seealso= [[BIS_fnc_animViewer]] [[BIS_fnc_help]]
[[Category:Functions|{{uc:configViewer}}]]
}}
[[Category:{{Name|arma2oa}}: Functions|{{uc:configViewer}}]]
[[Category:{{Name|tkoh}}: Functions|{{uc:configViewer}}]]
[[Category:{{Name|arma3}}: Functions|{{uc:configViewer}}]]

Revision as of 14:04, 5 May 2022

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

Description

Description:
Opens the Splendid™ Config Viewer.
Execution:
call
Groups:
Diagnostic

Syntax

Syntax:
[parent, cfg, showOk, onSelect, onAdd, header] call BIS_fnc_configViewer
Parameters:
parent: Display - (Optional, default mission display) parent display
cfg: Config - (Optional, default all configs) Root config
showOk: Boolean - (Optional, default false) true to display OK button. Script will then wait until viewer is closed and return selected class and param
onSelect: Code - (Optional, default {}) executed upon selecting a class. Must return String, which will be shown as structured text instead of params. Currently evaluated config is passed in the _this variable.
onAdd: Code - (Optional, default {}) executed upon adding a class to list. Returned value (STRING) is item text. Empty string will skip the item. Currently evaluated config is passed in the _this variable.
header: String - (Optional, default "%1") custom header. Use %1 to refer to original name ("Splendid Config Viewer")
Return Value:
Array
  • When OK button is not displayed, empty array is returned
  • Else, an array of currently selected entries in format [class (Config), param (String)] is returned.

Examples

Example 1:
call BIS_fnc_configViewer;
Example 2:
private _return = [ nil, configFile >> "CfgWeapons", true, nil, { params ["_cfg"]; if ( getNumber(_cfg >> "scope") == 2 && { // Layzy evaluation getNumber(_cfg >> "type") in [1,2,4] && // primary, secondary, handgun weapons { !isClass (_cfg >> "LinkedItems") or getText(_cfg >> "baseWeapon") == configName _cfg } // only base weapons, no accessories } ) exitWith { [_cfg] call BIS_fnc_displayName; // add the weapon with its displayname }; "" // don't add }, "Select Weapon" ] call BIS_fnc_configViewer; _cfgSelected = _return param [0, configNull]; systemChat str [configName _cfgSelected, _cfgSelected];

Additional Information

See also:
BIS_fnc_animViewer BIS_fnc_help

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=BIS_fnc_configViewer&oldid=309439"