showHUD: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "[[Category:Scripting_Commands_Take_On_Helicopters" to "[[Category:Scripting Commands Take On Helicopters")
m (style fix)
 
(39 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Command
{{RV|type=command


|game1= arma2
|game1= arma2
|version1= 1.00
|version1= 1.00
|game2= arma2oa
|version2= 1.50
|game3= tkoh
|version3= 1.00
|game4= arma3
|version4= 0.50
|eff= local
|eff= local
|gr1= Interaction


|descr= Enable / disable showing of HUD. Defines visibility of weapon crosshair and any informational tags that appear when pointing the weapon at an object as well as availability of the default action menu. Unfortunately, it also hides icons drawn with [[drawIcon3D]].
|descr= Enable / disable showing of HUD. Defines visibility of weapon crosshair and any informational tags that appear when pointing the weapon at an object as well as availability of the default action menu. Unfortunately, it also hides icons drawn with [[drawIcon3D]].
{{Informative | Appearance of HUD can also be controlled with [[Description.ext#showHUD|showHUD[]<nowiki/>]] param in Description.ext.}}
{{Feature|arma3|
{{Feature arma3| Since {{arma3}} v1.49.131879 there is a Description.ext's [[Description.ext#showHUD|showHUD[]<nowiki/>]] array param that is identical in format to the extended [[showHUD]] command. When present, it will disable [[showHUD]] command entirely, allowing mission makers to permanently alter visibility of some HUD elements.}}
'''Since {{arma3}} v1.50''' there is a Description.ext's [[Description.ext#showHUD|showHUD[]<nowiki/>]] array param that is identical in format to the extended [[showHUD]] command.
When present, it will disable [[showHUD]] command entirely, allowing mission makers to permanently alter visibility of some HUD elements.<br>
'''Since {{arma3}} v2.04''' it is possible to force drawing of [[drawIcon3D]] icons when HUD is hidden.
The icons will also show when custom camera is [[camCreate|created]] and the view is switched to it via [[switchCamera]] or [[cameraEffect]] provided [[cameraEffectEnableHUD]] is enabled.
For more information see [[drawIcon3D]].
}}


|s1= [[showHUD]] enable
|s1= [[showHUD]] enable
Line 15: Line 32:
|r1= [[Nothing]]
|r1= [[Nothing]]


|s2= [[showHUD]] [scriptedHUD, info, radar, compass, direction, menu, group, cursors, panels, kills, showIcon3D]


|s2= [[showHUD]] [hud, info, radar, compass, direction, menu, group, cursors, panels, kills]
|p21= scriptedHUD: [[Boolean]] - show scripted HUD such as weapon crosshair, action menu and overlays created with [[cutRsc]] and [[titleRsc]]. Same as [[showHUD]]'s first syntax
 
|p21= [hud, info, radar, compass, direction, menu, group, cursors, panels, kills]: [[Array]]


|p22= hud: [[Boolean]] - show scripted HUD (same as normal [[showHUD]] true/false)
|p22= info: [[Boolean]] - (Optional, default [[true]]) show vehicle, soldier and weapon info


|p23= info: [[Boolean]] - show vehicle + soldier info (hides weapon info from the HUD as well)
|p23= radar: [[Boolean]] - (Optional, default [[true]]) show vehicle radar


|p24= radar: [[Boolean]] - show vehicle radar
|p24= compass: [[Boolean]] - (Optional, default [[true]]) show vehicle compass


|p25= compass: [[Boolean]] - show vehicle compass
|p25= direction: [[Boolean]] - (Optional, default [[true]]) show tank direction indicator. Not present in vanilla {{arma3}}


|p26= direction: [[Boolean]] - show tank direction indicator (not present in vanilla Arma 3)
|p26= menu: [[Boolean]] - (Optional, default [[true]]) show commanding menu (HC related menus)


|p27= menu: [[Boolean]] - show commanding menu (hides HC related menus)
|p27= group: [[Boolean]] - (Optional, default [[true]]) show group info bar (Squad leader info bar)


|p28= group: [[Boolean]] - show group info bar (hides squad leader info bar)
|p28= cursors: [[Boolean]] - (Optional, default [[true]]) show HUD weapon cursors (connected with scripted HUD)


|p29= cursors: [[Boolean]] - show HUD weapon cursors (connected with scripted HUD)
|p29= panels: [[Boolean]] - (Optional, default [[true]]) show [[Arma 3: Custom Info]]
|p29since= arma3 1.70


|p30= panels: [[Boolean]] - show vehicle panels
|p30= kills: [[Boolean]] - (Optional, default [[true]]) show "x killed by y" [[systemChat]] messages
<!--
|p30= ?
-->


|p31= kills: [[Boolean]] - show "x killed by y" [[systemChat]] messages
|p31= showIcon3D: [[Boolean]] - (Optional, default [[false]]) - show icons drawn with [[drawIcon3D]] even when the HUD is hidden
|p31since= arma3 2.04


|r2= [[Nothing]]
|r2= [[Nothing]]


|x1= <sqf>showHUD false;</sqf>


|x1= <code>[[showHUD]] [[false]];</code>
|x2= Hide vehicle radar and compass:
<sqf>
showHUD [
true, // scriptedHUD
true, // info
true, // radar
true, // compass
true, // direction
true, // menu
true, // group
true, // cursors
true, // panels
true, // kills
true  // showIcon3D
];
</sqf>


|x2= Hide vehicle radar and compass:<code>[[showHUD]] [<nowiki/>[[true]], [[true]], [[false]], [[false]], [[true]], [[true]], [[true]], [[true]], [[true]]];</code>
|x3= Check if HUD visibility is hardcoded in mission config and [[showHUD]] command is overridden:
<sqf>private _disabledShowHUD = isArray (missionConfigFile >> "showHUD");</sqf>


|x3= Check if HUD visibility is hardcoded in mission config and [[showHUD]] command is overriden:<code>_disabledShowHUD = [[isArray]] ([[missionConfigFile]] >> "showHUD");</code>
|seealso= [[shownHUD]] [[showCinemaBorder]] [[showSubtitles]] [[showWatch]] [[showRadio]] [[showMap]] [[showGPS]] [[showCompass]] [[showPad]]
}}


|seealso= [[shownHUD]], [[showCinemaBorder]], [[showSubtitles]], [[showWatch]], [[showRadio]], [[showMap]], [[showGPS]], [[showCompass]], [[showPad]], [[actionIDs]], [[actionParams]], [[addAction]], [[setUserActionText]], [[inGameUISetEventHandler]], [[inputAction]], [[removeAction]], [[removeAllActions]], [[action]]
{{Note
|user= Killzone_Kid
|timestamp= 20150817190800
|text= The "cursors" parameter controls visibility of the action menu as well as weapon cursors.
However if 1st param "hud" hides and disables action menu, param "cursors" only hides it. So you get invisible action menu that is fully operational.
[[inGameUISetEventHandler]] will still fire on interaction, giving the information about selected item on the action menu even if you cannot see it.
Unfortunately it also hides icons drawn with [[drawIcon3D]].
}}
}}


<h3 style="display:none">Notes</h3>
{{Note
<dl class="command_description">
|user= POLPOX
<!-- Note Section BEGIN -->
|timestamp= 20200301143300
 
|text= <sqf>showHUD false;</sqf> removes [[Arma 3 Contact|Contact]]'s compass that is shown at the top of the screen.
<!-- Note Section END -->
}}
</dl>
 
<h3 style='display:none'>Bottom Section</h3>
 
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Take On Helicopters|{{uc:{{PAGENAME}}}}]]
 
<!-- CONTINUE Notes -->
<dl class="command_description">
<dd class="notedate">Posted on August 17, 2015 - 17:08 (UTC)</dd>
<dt class="note">[[User:Killzone Kid|Killzone Kid]]</dt>
<dd class="note">
param "cursors" controls visibility of the action menu as well as weapon cursors. However if 1st param "hud" hides and disables action menu, param "cursors" only hides it. So you get invisible action menu that is fully operational. [[inGameUISetEventHandler]] will still fire on interaction, giving the information about selected item on the action menu even if you cannot see it. Unfortunately it also hides icons drawn with [[drawIcon3D]].
</dd>
 
<dd class="notedate">Posted on March 1, 2020 - 14:33 (UTC)</dd>
<dt class="note">[[User:POLPOX|POLPOX]]</dt>
<dd class="note">
<code>[[showHUD]] [[false]]</code>removes [[Arma 3 Contact|Contact]]'s compass that shown in the top of the screen.
</dd>
</dl>
<!-- DISCONTINUE Notes -->

Latest revision as of 09:26, 4 October 2024

Hover & click on the images for description

Description

Description:
Enable / disable showing of HUD. Defines visibility of weapon crosshair and any informational tags that appear when pointing the weapon at an object as well as availability of the default action menu. Unfortunately, it also hides icons drawn with drawIcon3D.
Arma 3
Since Arma 3 v1.50 there is a Description.ext's showHUD[] array param that is identical in format to the extended showHUD command.

When present, it will disable showHUD command entirely, allowing mission makers to permanently alter visibility of some HUD elements.
Since Arma 3 v2.04 it is possible to force drawing of drawIcon3D icons when HUD is hidden. The icons will also show when custom camera is created and the view is switched to it via switchCamera or cameraEffect provided cameraEffectEnableHUD is enabled.

For more information see drawIcon3D.
Groups:
Interaction

Syntax

Syntax:
showHUD enable
Parameters:
enable: Boolean
Return Value:
Nothing

Alternative Syntax

Syntax:
showHUD [scriptedHUD, info, radar, compass, direction, menu, group, cursors, panels, kills, showIcon3D]
Parameters:
scriptedHUD: Boolean - show scripted HUD such as weapon crosshair, action menu and overlays created with cutRsc and titleRsc. Same as showHUD's first syntax
info: Boolean - (Optional, default true) show vehicle, soldier and weapon info
radar: Boolean - (Optional, default true) show vehicle radar
compass: Boolean - (Optional, default true) show vehicle compass
direction: Boolean - (Optional, default true) show tank direction indicator. Not present in vanilla Arma 3
menu: Boolean - (Optional, default true) show commanding menu (HC related menus)
group: Boolean - (Optional, default true) show group info bar (Squad leader info bar)
cursors: Boolean - (Optional, default true) show HUD weapon cursors (connected with scripted HUD)
since Arma 3 logo black.png1.70
panels: Boolean - (Optional, default true) show Arma 3: Custom Info
kills: Boolean - (Optional, default true) show "x killed by y" systemChat messages
since Arma 3 logo black.png2.04
showIcon3D: Boolean - (Optional, default false) - show icons drawn with drawIcon3D even when the HUD is hidden
Return Value:
Nothing

Examples

Example 1:
showHUD false;
Example 2:
Hide vehicle radar and compass:
showHUD [ true, // scriptedHUD true, // info true, // radar true, // compass true, // direction true, // menu true, // group true, // cursors true, // panels true, // kills true // showIcon3D ];
Example 3:
Check if HUD visibility is hardcoded in mission config and showHUD command is overridden:
private _disabledShowHUD = isArray (missionConfigFile >> "showHUD");

Additional Information

See also:
shownHUD showCinemaBorder showSubtitles showWatch showRadio showMap showGPS showCompass showPad

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
Killzone_Kid - c
Posted on Aug 17, 2015 - 19:08 (UTC)
The "cursors" parameter controls visibility of the action menu as well as weapon cursors. However if 1st param "hud" hides and disables action menu, param "cursors" only hides it. So you get invisible action menu that is fully operational. inGameUISetEventHandler will still fire on interaction, giving the information about selected item on the action menu even if you cannot see it. Unfortunately it also hides icons drawn with drawIcon3D.
POLPOX - c
Posted on Mar 01, 2020 - 14:33 (UTC)
showHUD false;
removes Contact's compass that is shown at the top of the screen.