FreeSpace Wiki - User contributions [en]

Controlconfigdefaults.tbl

2022-12-27T02:44:03Z

Z64555: /* $Bind Name: */ Updated to hopefully clarify that these options and suboptions are deprecated

{{TableVersionGit| 2021-02-13 UTC | db2bd97669c949e7d68baa9560192b7d3ad96563}}

{{Tables}}
The '''controlconfigdefaults.tbl''' can be used to modify the default key bindings in FSO.

==#ControlConfigOverride==
* Starts an Override section
* Begins with '''#ControlConfigOverride''' and ends with '''#End'''.
* Only entries that you want to change are required, the rest will use the default binding
* Entries not listed will be assigned to their default/hardcoded values.
{{Table371|
* Multiple #ControlConfigOverride...#End blocks can be provided.
** Each block defines a separate control config preset
** The "Defaults" button in the control config screen may be used to reset to the selected preset, then cycle through to the next preset.
** The first given block is used as the "global" defaults, and is used when working with the key-pressed SEXP and LUA scripts.
** Note: It's a good idea to also use [[Strings.tbl]] to change the "Defaults" text on the button to for example "Cycle\nPresets".
}}

==#ControlConfigPreset==
{{Table212|
* Starts a Preset section
* Begins with '''#ControlConfigPreset''' and ends with '''#End'''.
* All keybinds you wish to have bound must be specified, any unspecified keys will be unbound.
}}

===$Name:===
{{Table373|
* The name of this control config preset, displayed at the top left corner of the control config screen when selected through the "Defaults" button.
* If not provided, the first [[#ControlConfigOverride]] block will override the hardcoded defaults, all subsequent blocks will be '''<unnamed preset>.'''
{{Table212|
* If not provided, the [[#ControlConfigPreset]] block will be '''<unnamed preset>'''
}}
**Syntax: '''''String'''''
}}

===$Bind Name:===
*Name of the bind or action to modify the default key of.
*Valid entries: [[Controlconfigdefaults.tbl#Table of Bindings|Table of Bindings]]
*Required
*Syntax: '''String'''
{{Table220|
As of FSO 22.0, '''$Bind Name:''', '''$Key Default:''', '''$Joy Default:''', '''$Key Mod Shift:''', '''$Key Mod Alt:''', and '''$Key Mod Ctrl:''' are deprecated in favor of '''Bind:''' and its respective suboptions.
}}

====$Key Default:====
*Key to set as default
*Valid entries: [[Controlconfigdefaults.tbl#Allowed Keys|Allowed Keys]]
{{Table372|
*May be unbound by specifying '''NONE''' instead of a key}}
*Optional
*Syntax: '''String'''
{{Table220|
As of FSO 22.0, '''$Bind Name:''', '''$Key Default:''', '''$Joy Default:''', '''$Key Mod Shift:''', '''$Key Mod Alt:''', and '''$Key Mod Ctrl:''' are deprecated in favor of '''Bind:''' and its respective suboptions.
}}

====$Joy Default:====
*Joystick button to set as default
*Optional
*Syntax: '''Integer'''
{{Table220|
As of FSO 22.0, '''$Bind Name:''', '''$Key Default:''', '''$Joy Default:''', '''$Key Mod Shift:''', '''$Key Mod Alt:''', and '''$Key Mod Ctrl:''' are deprecated in favor of '''Bind:''' and its respective suboptions.
}}

====$Key Mod Shift:====
*Sets the key to require the Shift key
*'''1''' for yes, '''0''' for no
*Optional
*Syntax: '''Integer'''
{{Table220|
As of FSO 22.0, '''$Bind Name:''', '''$Key Default:''', '''$Joy Default:''', '''$Key Mod Shift:''', '''$Key Mod Alt:''', and '''$Key Mod Ctrl:''' are deprecated in favor of '''Bind:''' and its respective suboptions.
}}

====$Key Mod Alt:====

*Sets the key to require the Alt key
*'''1''' for yes, '''0''' for no
*Optional
*Syntax: '''Integer'''
{{Table220|
As of FSO 22.0, '''$Bind Name:''', '''$Key Default:''', '''$Joy Default:''', '''$Key Mod Shift:''', '''$Key Mod Alt:''', and '''$Key Mod Ctrl:''' are deprecated in favor of '''Bind:''' and its respective suboptions.
}}

====$Key Mod Ctrl:====
* Sets the key to require the Ctrl key
* '''1''' for yes, '''0''' for no
* Optional
* Syntax: '''Integer'''
{{Table220|
As of FSO 22.0, '''$Bind Name:''', '''$Key Default:''', '''$Joy Default:''', '''$Key Mod Shift:''', '''$Key Mod Alt:''', and '''$Key Mod Ctrl:''' are deprecated in favor of '''Bind:''' and its respective suboptions.
}}

===$Bind:===
{{Table220|
*The IoActionID of the action to bind to.
*Valid entries: [[Controlconfigdefaults.tbl#Table of Bindings|Table of Bindings]]
*Required
*Syntax: '''String'''
}}

====$Primary:====
{{Table220|
*Denotes the following binding is a Primary binding of the control
*Optional
*Syntax: (No arguments)
}}

=====$Controller:=====
{{Table220|
*Denotes which controller this binding is for
*Required
*Syntax: '''String''', any of the following:
**'''CID_NONE'''
**'''CID_KEYBOARD'''
**'''CID_MOUSE'''
**'''CID_JOY0'''
**'''CID_JOY1'''
**'''CID_JOY2'''
**'''CID_JOY3'''
}}

=====$Flags:=====
{{Table220|
*Denotes a number of flags for button behavior
*Required
*Syntax: '''String''', any of the following:
}}
{| class="wikitable"
| '''AXIS_BTN''' || An axis that's treated as a digital control should it be deflected past a certain threshold (Note: WIP)
|-
| '''RELATIVE''' || A relative axis which increases or decreases the control's value instead of directly setting its value. (Example: Relative Throttle)
|-
| '''INVERTED''' || An axis who's input is inverted
|-
| '''AXIS''' || Input is an axis
|-
| '''HAT''' || Input is a POV HAT switch
|-
| '''BALL''' || Input is a trackball
|-
| '''NONE''' || Input is assumed to be a standard button or key
|}

=====$Input:=====
{{Table220|
*Which button, key, or axis is bound
*Required
*Syntax: '''string''', any of the following:

Joystick axes:
*'''X_AXIS'''
*'''Y_AXIS'''
*'''Z_AXIS'''
*'''RX_AXIS'''
*'''RY_AXIS'''
*'''RZ_AXIS'''

Joystick Buttons:
*Buttons are simply the button number, such as "1" for button 1.

Mouse Buttons:
*'''LEFT_BUTTON'''
*'''RIGHT_BUTTON'''
*'''MIDDLE_BUTTON'''
*'''X1_BUTTON'''
*'''X2_BUTTON'''
*'''WHEEL_UP'''
*'''WHEEL_DOWN'''
*'''WHEEL_LEFT'''
*'''WHEEL_RIGHT'''

Keyboard Keys:
[[Controlconfigdefaults.tbl#Allowed Keys|Allowed Keys]]
*Key modifiers '''ALT-''' and '''SHIFT-''' can be prepended to the Key ID.
**Example: '''ALT-J''', '''SHIFT-KEY_Q''', '''ALT-SHIFT-KEY_1'''
}}

====$Secondary:====
{{Table220|
*Denotes the following binding is a Secondary binding of the control
*Has the same suboptions as [[Controlconfigdefaults.tbl#$Primary:|$Primary]]
*Optional
*Syntax: (No Arguments)
}}

===$Category:===
* Tab where the binding appears in the options menu.
* Valid entries: TARGET_TAB, SHIP_TAB, WEAPON_TAB, COMPUTER_TAB
* Optional
* Only valid in [[#ControlConfigOverride]] blocks
* Syntax: '''String'''

===$Text:===
{{Table212|
* The label of the control to use in the controls config menu.
* Is overridden by XSTR, if provided
** '''Note:''' This is meant to be a lazy temporary substitution to modifying [[strings.tbl]]. Your released mod should nstill provide its own strings.tbl.
* Optional
* Syntax: '''String'''
}}

===$Has XStr:===
* Whether or not the binding has an entry in [[strings.tbl]]
** If '''0''', assumes no XSTR is provided
** If '''1''', assumes an XSTR is provided alongside the other ControlConfig strings according to its internal, hardcoded index
{{Table382|
** If any nonzero integer >1, is the exact XSTR index within [[strings.tbl]]
}}
* Optional
* Only valid in [[#ControlConfigOverride]] blocks
* Syntax: '''Integer'''

===$Type:===
*Determines the type of control this is.

*Valid entries:
**CC_TYPE_TRIGGER
***Normal control that activates upon the first press. Resetting devices (such as weapons) will keep firing as long as the key/button is held down.
**CC_TYPE_CONTINUOUS
***Control that activates when the key/button is held down, and stays activated until the key/button is released. Ex: Afterburner key.
*Optional
*Only valid in [[#ControlConfigOverride]] blocks
*Syntax '''String'''

===$Disable:===
{{Table373|
*Determines whether the binding can be used and appears in the options menu. Can be used to hide bindings which are not needed, or to enable bindings which are hidden by default.
*Syntax: '''''Boolean'''''
}}

===+Disable===
{{Table212|
* Disables the control
* Optional
* Only valid in [[#ControlConfigOverride]] blocks
* Syntax: (No arguments)
}}

==#End==
* All [[#ControlConfigOverride]] and [[#ControlConfigPreset]] sections must be terminated by #End

==Sample==
===Post-22.0===
{{Table220|
This example is for Post-22.0 and does the following...
*Sets Clear Escort List to Alt-Shift-Q
*Sets Target Target's Attacker to Alt-Shift-J and Button 2 on Joystick 0, moves it to the Ship Tab, denotes it's type as a trigger and sets it to not have a XString
*Sets Transfer Energy from Shield to Laser to R

Note that for compatibility, FSO builds 22.0 and later can still read Pre-22.0 format.

Note: the indents are optional, and are provided to improve readibility.
}}

<pre>
#ControlConfigOverride

$Bind: ESCORT_CLEAR
$Primary:
$Controller: CID_KEYBOARD
$Flags: NONE
$Input: ALT-SHIFT-KEY_Q

$Bind: TARGET_CLOSEST_SHIP_ATTACKING_TARGET
$Primary:
$Controller: CID_KEYBOARD
$Flags: NONE
$Input: ALT-SHIFT-KEY_J
$Secondary:
$Controller: CID_JOY0
$Flags: NONE
$Input: 2
$Category: SHIP_TAB
$Has XStr: 0
$TYPE: CC_TYPE_TRIGGER

$Bind: XFER_LASER
$Primary:
$Controller: CID_KEYBOARD
$FLAGS: NONE
$Inpute: KEY_R

#End
</pre>

===Pre-22.0===
This example is for Pre-22.0 and does the following...
*Sets Clear Escort List to Alt-Shift-Q
*Sets Target Target's Attacker to Ctrl-Alt-Shift-J, moves it to the Ship Tab, denotes it's type as a trigger and sets it to not have a XString
*Sets Transfer Energy from Shield to Laser to R

<pre>
#ControlConfigOverride

$Bind Name: Clear Escort List
$Key Default: KEY_Q
$Key Mod Shift: 1
$Key Mod Alt: 1

$Bind Name: Target Target's Nearest Attacker
$Key Default: KEY_J
$Key Mod Shift: 1
$Key Mod Alt: 1
$Key Mod Ctrl: 1
$Category: SHIP_TAB
$Has XStr: 0
$TYPE: CC_TYPE_TRIGGER

$Bind Name: Transfer Energy Shield->Laser
$Key Default: KEY_R

#End
</pre>

==Table of Bindings==
* This is a table of all possible bindings that can be modified, grouped into smaller tables for easier reference.
* '''$Bind Name:''' column is to be used with '''$Bind Name:''' entries, and '''$Bind:''' column is to be used with '''$Bind:''' entries.
* These bindings are case-sensitive
* Controls added after 22.0 might not have a '''$Bind Name:'''. Use the '''$Bind:''' identifier instead.
{| class="wikitable"
|+ style="color:white" | Targeting
|-
! $Bind Name: !! $Bind:
|-
| Target Next Ship || TARGET_NEXT
|-
| Target Previous Ship || TARGET_PREV
|-
| Target Next Closest Hostile Ship || TARGET_NEXT_CLOSEST_HOSTILE
|-
| Target Previous Closest Hostile Ship || TARGET_PREV_CLOSEST_HOSTILE
|-
| Toggle Auto Targeting || TOGGLE_AUTO_TARGETING
|-
| Target Next Closest Friendly Ship || TARGET_NEXT_CLOSEST_FRIENDLY
|-
| Target Previous Closest Friendly Ship || TARGET_PREV_CLOSEST_FRIENDLY
|-
| Target Ship in Reticle || TARGET_SHIP_IN_RETICLE
|-
| Target Targets Nearest Attacker || TARGET_CLOSEST_SHIP_ATTACKING_TARGET
|-
| Target Last Ship to Send Transmission || TARGET_LAST_TRANMISSION_SENDER
|-
| Turn Off Targeting || STOP_TARGETING_SHIP
|-
| Target Closest Attacking Ship || TARGET_CLOSEST_SHIP_ATTACKING_SELF
|-
| Target Next Escort Ship || TARGET_NEXT_ESCORT_SHIP
|-
| Target Closest Repair Ship || TARGET_CLOSEST_REPAIR_SHIP
|-
| Target Next Uninspected Cargo || TARGET_NEXT_UNINSPECTED_CARGO
|-
| Target Previous Uninspected Cargo || TARGET_PREV_UNINSPECTED_CARGO
|-
| Target Newest Ship in Area || TARGET_NEWEST_SHIP
|-
| Target Targets Target || TARGET_TARGETS_TARGET
|-
| Target Next Hostile Bomb or Bomber || TARGET_NEXT_BOMB
|-
| Target Previous Hostile Bomb or Bomber || TARGET_PREV_BOMB
|}

{| class="wikitable"
|+ style="color:white" | Targeting Subsystems and Turrets
|-
! $Bind Name: !! $Bind:
|-
| Target Subsystem in Reticle || TARGET_SUBOBJECT_IN_RETICLE
|-
| Target Next Subsystem || TARGET_NEXT_SUBOBJECT
|-
| Target Previous Subsystem || TARGET_PREV_SUBOBJECT
|-
| Turn Off Targeting of Subsystems || STOP_TARGETING_SUBSYSTEM
|-
| Target Next Live Turret || TARGET_NEXT_LIVE_TURRET
|-
| Target Previous Live Turret || TARGET_PREV_LIVE_TURRET
|}

{| class="wikitable"
|+ style="color:white" | Weapons
|-
! $Bind Name: !! $Bind:
|-
| Fire Primary Weapon || FIRE_PRIMARY
|-
| Fire Secondary Weapon || FIRE_SECONDARY
|-
| Cycle Forward Primary Weapon || CYCLE_NEXT_PRIMARY
|-
| Cycle Backward Primary Weapon || CYCLE_PREV_PRIMARY
|-
| Cycle Primary Weapon Firing Rate || CYCLE_PRIMARY_WEAPON_SEQUENCE
|-
| Cycle Secondary Weapon Bank || CYCLE_SECONDARY
|-
| Cycle Secondary Weapon Firing Rate || CYCLE_NUM_MISSLES
|-
| Launch Countermeasure || LAUNCH_COUNTERMEASURE
|}

{| class="wikitable"
|+ style="color:white" | Flight Controls
|-
! $Bind Name: !! $Bind:
|-
| Forward Thrust || FORWARD_THRUST
|-
| Reverse Thrust || REVERSE_THRUST
|-
| Bank Left || BANK_LEFT
|-
| Bank Right || BANK_RIGHT
|-
| Pitch Forward || PITCH_FORWARD
|-
| Pitch Backward || PITCH_BACK
|-
| Turn Left || YAW_LEFT
|-
| Turn Right || YAW_RIGHT
|-
| Right Thrust || RIGHT_SLIDE_THRUST
|-
| Left Thrust || LEFT_SLIDE_THRUST
|-
| Up Thrust || UP_SLIDE_THRUST
|-
| Down Thrust || DOWN_SLIDE_THRUST
|-
| Afterburner || AFTERBURNER
|-
| Glide When Pressed || GLIDE_WHEN_PRESSED
|-
| Bank When Pressed || BANK_WHEN_PRESSED
|-
| Match Target Speed || MATCH_TARGET_SPEED
|}

{| class="wikitable"
|-
|+ style="color:white" | Throttle Control
|-
! $Bind Name: !! $Bind:
|-
| Set Throttle to Zero || ZERO_THROTTLE
|-
| Set Throttle to Max || MAX_THROTTLE
|-
| Set Throttle to One-Third || ONE_THIRD_THROTTLE
|-
| Set Throttle to Two-Thirds || TWO_THIRDS_THROTTLE
|-
| Increase Throttle 5 Percent || PLUS_5_PERCENT_THROTTLE
|-
| Decrease Throttle 5 Percent || MINUS_5_PERCENT_THROTTLE
|}

{| class="wikitable"
|+ style="color:white" | HUD Controls
|-
! $Bind Name: !! $Bind:
|-
| Toggle High HUD Contrast || TOGGLE_HUD_CONTRAST
|-
| Toggle HUD || TOGGLE_HUD
|-
| Toggle HUD Wireframe Target View || HUD_TARGETBOX_TOGGLE_WIREFRAME
|-
| Cycle Radar Range || RADAR_RANGE_CYCLE
|-
| Communications Menu || SQUADMSG_MENU
|-
| Show Objectives || SHOW_GOALS
|-
| Show Nav Map || SHOW_NAVMAP
|-
| Add or Remove Escort || ADD_REMOVE_ESCORT
|-
| Clear Escort List || ESCORT_CLEAR
|-
| - || TOGGLE_HUD_SHADOWS
|}

{| class="wikitable"
|+ style="color:white" | Squadmate Messaging
|-
! $Bind Name: !! $Bind:
|-
| Attack My Target || ATTACK_MESSAGE
|-
| Disarm My Target || DISARM_MESSAGE
|-
| Disable My Target || DISABLE_MESSAGE
|-
| Attack My Subsystem || ATTACK_SUBSYSTEM_MESSAGE
|-
| Capture My Target || CAPTURE_MESSAGE
|-
| Engage Enemy || ENGAGE_MESSAGE
|-
| Form on My Wing || FORM_MESSAGE
|-
| Ignore My Target || IGNORE_MESSAGE
|-
| Protect My Target || PROTECT_MESSAGE
|-
| Cover Me || COVER_MESSAGE
|-
| Return to Base || WARP_MESSAGE
|-
| Rearm Me || REARM_MESSAGE
|}

{| class="wikitable"
|+ style="color:white" | Views
|-
! $Bind Name: !! $Bind:
|-
| Chase View || VIEW_CHASE
|-
| External View || VIEW_EXTERNAL
|-
| Toggle External Camera Lock || VIEW_EXTERNAL_TOGGLE_CAMERA_LOCK
|-
| Free Look View || VIEW_SLEW
|-
| Current Target View || VIEW_OTHER_SHIP
|-
| Increase View Distance || VIEW_DIST_INCREASE
|-
| Decrease View Distance || VIEW_DIST_DECREASE
|-
| Center View || VIEW_CENTER
|-
| View Up || PADLOCK_UP
|-
| View Rear || PADLOCK_DOWN
|-
| View Left || PADLOCK_LEFT
|-
| View Right || PADLOCK_RIGHT
|-
| Top-Down View || VIEW_TOPDOWN
|-
| Target Padlock View || VIEW_TRACK_TARGET
|}

{| class="wikitable"
|-
|+ style="color:white" | ETS and Shields
|-
! $Bind Name: !! $Bind:
|-
| Increase Weapon Energy || INCREASE_WEAPON
|-
| Decrease Weapon Energy || DECREASE_WEAPON
|-
| Increase Shield Energy || INCREASE_SHIELD
|-
| Decrease Shield Energy || DECREASE_SHIELD
|-
|-
| Increase Engine Energy || INCREASE_ENGINE
|-
| Decrease Engine Energy || DECREASE_ENGINE
|-
| Equalize Energy Settings || ETS_EQUALIZE
|-
| Equalize Shields || SHIELD_EQUALIZE
|-
| Augment Forward Shield || SHIELD_XFER_TOP
|-
| Augment Rear Shield || SHIELD_XFER_BOTTOM
|-
| Augment Left Shield || SHIELD_XFER_LEFT
|-
| Augment Right Shield || SHIELD_XFER_RIGHT
|-
| Transfer Energy Laser->Shield || XFER_SHIELD
|-
| Transfer Energy Shield->Laser || XFER_LASER
|}

{| class="wikitable"
|+ style="color:white" | Misc
|-
! $Bind Name: !! $Bind:
|-
| Enter Subspace (End Mission) || END_MISSION
|-
| Increase Time Compression || TIME_SPEED_UP
|-
| Decrease Time Compression || TIME_SLOW_DOWN
|-
| Toggle Auto Pilot || AUTO_PILOT_TOGGLE
|-
| Cycle Nav Points || NAV_CYCLE
|-
| Toggle Gliding || TOGGLE_GLIDING
|-
| Toggle Auto Speed Matching || TOGGLE_AUTO_MATCH_TARGET_SPEED
|}

{| class="wikitable"
|+ style="color:white" | Multiplayer Only
|-
! $Bind Name: !! $Bind:
|-
| (Multiplayer) Message All || MULTI_MESSAGE_ALL
|-
| (Multiplayer) Message Friendly || MULTI_MESSAGE_FRIENDLY
|-
| (Multiplayer) Message Hostile || MULTI_MESSAGE_HOSTILE
|-
| (Multiplayer) Message Target || MULTI_MESSAGE_TARGET
|-
| (Multiplayer) Observer Zoom To Target || MULTI_OBSERVER_ZOOM_TO
|-
| (Multiplayer) Toggle Network info || MULTI_TOGGLE_NETINFO
|-
| (Multiplayer) Self Destruct || MULTI_SELF_DESTRUCT
|}

{| class="wikitable"
|+ style="color:white" | Custom Controls
|-
! $Bind Name: !! $Bind:
|-
| Custom Control 1 || CUSTOM_CONTROL_1
|-
| Custom Control 2 || CUSTOM_CONTROL_2
|-
| Custom Control 3 || CUSTOM_CONTROL_3
|-
| Custom Control 4 || CUSTOM_CONTROL_4
|-
| Custom Control 5 || CUSTOM_CONTROL_5
|}

{| class="wikitable"
|+ style="color:white" | Analog Controls
|-
! $Bind Name: !! $Bind:
|-
| - || JOY_HEADING_AXIS
|-
| - || JOY_PITCH_AXIS
|-
| - || JOY_BANK_AXIS
|-
| - || JOY_ABS_THROTTLE_AXIS
|-
| - || JOY_REL_THROTTLE_AXIS
|}

===Custom Controls===
{{Table382|
* 'Custom Control 1'
* 'Custom Control 2'
* 'Custom Control 3'
* 'Custom Control 4'
* 'Custom Control 5'

These are empty controls for modders and/or scripters to use.

Disabled by default

Default XSTR index is 0 (thus, they do not have an entry in [[strings.tbl]])

The default key bindings are Shift-Alt (1-5) for Custom Control 1-5, respectively.

To use these, create a new entry in a [[#ControlConfigOverride]] block and with the respective name. You should specify a label in [[strings.tbl]], otherwise they'll show up as "Custom Control" in the control config menu.

Example:
* $Bind Name: Custom Control 1
* $Has XStr: 1570
* $Disable: false
}}

==Allowed Keys==
*Not all keys are checked by FSO for key bindings, so some of these may not work.
*List coppied from controlsconfigcommon.cpp and edited to make readable.
*Must use the string below (without quotes).
*List of keys
:'KEY_0'
:'KEY_1'
:'KEY_2'
:'KEY_3'
:'KEY_4'
:'KEY_5'
:'KEY_6'
:'KEY_7'
:'KEY_8'
:'KEY_9'
:'KEY_A'
:'KEY_B'
:'KEY_C'
:'KEY_D'
:'KEY_E'
:'KEY_F'
:'KEY_G'
:'KEY_H'
:'KEY_I'
:'KEY_J'
:'KEY_K'
:'KEY_L'
:'KEY_M'
:'KEY_N'
:'KEY_O'
:'KEY_P'
:'KEY_Q'
:'KEY_R'
:'KEY_S'
:'KEY_T'
:'KEY_U'
:'KEY_V'
:'KEY_W'
:'KEY_X'
:'KEY_Y'
:'KEY_Z'
:'KEY_MINUS'
:'KEY_EQUAL'
:'KEY_DIVIDE'
:'KEY_SLASH'
:'KEY_SLASH_UK'
:'KEY_COMMA'
:'KEY_PERIOD'
:'KEY_SEMICOL'
:'KEY_LBRACKET'
:'KEY_RBRACKET'
:'KEY_RAPOSTRO'
:'KEY_LAPOSTRO'
:'KEY_ESC'
:'KEY_ENTER'
:'KEY_BACKSP'
:'KEY_TAB'
:'KEY_SPACEBAR'
:'KEY_NUMLOCK'
:'KEY_SCROLLOCK'
:'KEY_CAPSLOCK'
:'KEY_LSHIFT'
:'KEY_RSHIFT'
:'KEY_LALT'
:'KEY_RALT'
:'KEY_LCTRL'
:'KEY_RCTRL'
:'KEY_F1'
:'KEY_F2'
:'KEY_F3'
:'KEY_F4'
:'KEY_F5'
:'KEY_F6'
:'KEY_F7'
:'KEY_F8'
:'KEY_F9'
:'KEY_F10'
:'KEY_F11'
:'KEY_F12'
:'KEY_PAD0'
:'KEY_PAD1'
:'KEY_PAD2'
:'KEY_PAD3'
:'KEY_PAD4'
:'KEY_PAD5'
:'KEY_PAD6'
:'KEY_PAD7'
:'KEY_PAD8'
:'KEY_PAD9'
:'KEY_PADMINUS'
:'KEY_PADPLUS'
:'KEY_PADPERIOD'
:'KEY_PADDIVIDE'
:'KEY_PADMULTIPLY'
:'KEY_PADENTER'
:'KEY_INSERT'
:'KEY_HOME'
:'KEY_PAGEUP'
:'KEY_DELETE'
:'KEY_END'
:'KEY_PAGEDOWN'
:'KEY_UP'
:'KEY_DOWN'
:'KEY_LEFT'
:'KEY_RIGHT'
:'KEY_PRINT_SCRN'
:'KEY_PAUSE'
:'KEY_BREAK'

[[Category:Tables]]

==Debug Commands==
===save_ccd===
If running a Debug Build, the '''save_ccd''' command may be used on the debug console to save the current Control Configuration Defaults (in the default preset) to a .tbl. This should allow developers to quickly modify the default preset without needing to transcribe everything by hand, or try to use a controlconfigdefaults.tbl from somewhere else.

Hud gauges.tbl

2022-10-14T15:02:24Z

Z64555: /* +Radar: */

{{SCP table}}
{{TableVersionGit|2016-09-14|f9bc01c}}
{{Tables}}
The '''hud_gauges.tbl''' is used for modifying the elements of the HUD. Not all gauges can be modified. However, custom gauges may be added to mimic their behavior (such as the wingman status display).

HUD Elements in FS2 are called Gauges, and each gauge has various options to customize appearance and, in some cases, their behavior as well.

This table is one of the [[Modular Tables]] and can be extended with xxx-hdg.tbm

==HUD Configurations==
The following entries are used on the HUD system, but have not been grouped with any particular gauge.

===$Load Retail Configuration:===
Optional. If yes, any gauge missing from the HUD gauge definitions below will be loaded using the retail defaults.

If no, any missing (default) gauge will prompt an error.

*Syntax: '''Boolean'''

===$Color:===
Optional. Sets the default HUD color for all gauges.

*Syntax: ('''Integer''' Red, '''Integer''' Green, '''Integer''' Blue)
*Valid Values: all values from 0 to 255

===$Font:===
Optional. Sets the font type to use for the HUD. This can either be a string or a number. A string references a font with a specific name while a number references a font with a specific index in the fonts table. The number option is deprecated and is only there for backwards-compatibility. Use the name if possible.

*Syntax: '''String''' or '''Integer''' font index number
*Valid Values: Any name or font index as defined in [[Fonts.tbl]]

===$Chase View Only:===
{{Table381|
Optional. Sets gauges to be displayed only in Chase View.

*Syntax: '''Boolean'''
*Default Value: '''False'''
}}

===$Max Directives:===
Optional. Sets the default maximum number of directives displayed simultaneously.

*Syntax: '''Integer''' maximum number of directives
*Valid Values: Any positive number
*Default Value: '''5'''

===$Max Escort Ships:===
Optional. Sets the default maximum number of escort ships to be shown in the escort list.

*Syntax: '''Integer'''
*Valid Values: Any positive number
{{Warning|
Entries more than 16 will cause the list to overflow into the weapons list for resolutions lower than 1024x768.}}

===$Length Unit Multiplier:===
Optional. Sets the multiplier to applied to the reported distances. For example, if the multiplier is 0.5, then the distance reported to the player will (or at least should) be 0.5 x actual distance.

*Syntax: '''Float'''
*Valid Values: Any positive number

===$Speed Unit Multiplier:===
Optional. Analogous to [[Hud_gauges.tbl#$Length Unit Multiplier:|$Length Unit Multiplier]], this sets the multiplier to be applied to all speeds reported to the player. For example, if the multiplier is 0.5, the the speed reported to the player will (or at least should) be 0.5 x actual speed.

*Syntax: '''Float'''
*Valid Values: Any positive number
*Default Values:
:'''The value used in $Length Unit Multiplier''', or
:'''1''', if $Length Unit Multiplier is undefined

===$Wireframe Targetbox:===
Optional. Defines the default draw method for the target viewer (a.k.a. targetbox).

*Syntax: '''Integer''' Draw method ID
*Valid Values:
::'''0''' - Standard with full, bright lighting
::'''1''' - Wireframe
::'''2''' - Standard with proper lighting (i.e. lit the same as the actual target)
{{Table3615|
::'''3''' - Untextured with full bright lighting (i.e. drawn with a single flat color)}}

===$Targetbox Shader Effect:===
{{Table3615|
Optional. If set, defines a unique ID for a shader effect to be used when rendering a ship for the targeting box. The ID will be passed to the main shader as in [[Post_processing.tbl##Ship_Effects|#Ship_Effects]], but a table entry for the effect is not needed.

*Syntax: '''Integer'''
*Valid Values: Any positive number
}}

===$Lock Wireframe Mode:===
Optional. If set, prevents targetbox draw method from being changed during the gaming session.
*Syntax: '''Boolean'''

===$Scale Gauges:===
{{Table371|
Optional. If set, all gauges will use this value as the default for scaling individual gauge sizes (i.e. doesn't affect gauges that use Position:, and doesn't affect the values of Offset:. In addition, if "$Load Retail Configuration:" is true then all unspecified retail gauges will use this value.

If not set, defaults to yes.

*Syntax: '''Boolean'''
}}

===$Force Scaling Above:===
{{Table373|
Optional. If gauge scaling is disabled, then gauges will be scaled as though the base resolution were this resolution or the real base resolution, whichever is greater.

Use this to disable scaling at lower resolutions while preventing gauges from getting too small at higher resolutions.

To disable this feature, use '''(-1, -1)'''.

*Syntax: ('''Integer''' width, '''Integer''' height)
}}

===$Reticle Style:===
Optional. Defines which aiming reticle to use.
*Syntax: '''String'''
*Valid Values:
:'''FS1''' - uses '''''reticle1_fs1.ani'''''
:'''FS2''' - uses '''''reticle1.ani'''''

==#Gauge Config==
The following entries define default gauge appearance and behavior. Each gauge has the option of overriding these options.

===$Ship:===
Deprecated and superceded by $Ships in FSO revision 9208. If defined, the following config data will only be used if the player ship is of the supplied ship class. Can be defined multiple times within a #Gauge config group to allow unique HUD configurations per ship class.

If not defined, all following config data will be applied to all ships.

*Syntax: '''String''', ship class name

===$Ships:===
Optional. Can be used to define a list of ships the hud definition that follows will be applied to. Can be defined multiple times within a #Gauge config group to allow unique HUD configurations per ship class.

If not defined, all following config data will be applied to all ships.

*`Syntax: '''( "Class name 1" "Class name 2" )''', ship class names formatted like a flag list.

====$Load Retail Configuration:====
Optional. Overrides the [[Hud_gauges.tbl#$Load Retail Configuration: 1|$Load Retail Configuration]] global option for this ship class.

*Syntax: '''Boolean'''

====$Color:====
Optional. Overrides the [[Hud_gauges.tbl#$Color: 1|$Color]] global option for this ship class.

*Syntax: See [[Hud_gauges.tbl#$Color: 1|$Color]]

====$Font:====
Optional. Overrides the [[Hud_gauges.tbl#$Font: 1|$Font]] global option for this ship class.

*Syntax: See [[Hud_gauges.tbl#$Font: 1|$Font]]

====$Chase View Only:====
{{Table381|
Optional. Overrides the [[Hud_gauges.tbl#$Chase View Only: 1|$Chase View Only]] global option for this ship class.

*Syntax: See [[Hud_gauges.tbl#$Chase View Only: 1|$Chase View Only]]
}}

===$Base:===
Required. Defines the base resolution for this HUD configuration, upon which other gauge options (such as [[Hud_gauges.tbl#Position:|Position:]] / [[Hud_gauges.tbl#Origin:|Origin:]] / [[Hud_gauges.tbl#Offset:|Offset:]]) will use as its coordinate system.

*Syntax: ('''Integer''' width, '''Integer''' height)
*Valid Values: All supported resolutions (?)

===$Scale Gauges:===
{{Table371|
Optional. If set, will configure gauges Scaling behaviour for gauges in this #Gauge Config section. i.e. overriding the default, or the value specified at the top of the file. Individual gauges can override this setting.

*Syntax: '''Boolean'''
}}

===$Force Scaling Above:===
{{Table373|
Optional. If gauge scaling is disabled, then gauges will be scaled as though the base resolution were this resolution or the real base resolution, whichever is greater.

Use this to disable scaling at lower resolutions while preventing gauges from getting too small at higher resolutions.

To disable this feature, use '''(-1, -1)'''.

*Syntax: ('''Integer''' width, '''Integer''' height)
}}

===$Required Aspect:===
Optional. If set, this configuration will only be loaded for the specified aspect ratios.

Used as a filter when there are multiple $Base: resolutions in the table

*Syntax: '''String'''
*Valid Values:
:"Full Screen" (4:3, aspect ratio < 1.5)
:"Wide Screen" (16:9, 16:10, or similar, aspect ratio >= 1.5)

===$Min:===
Optional. Minimum resolution for this config. Any resolution lower than specified will not use this configuration.

Used as a filter when there are multiple $Base: resolutions in the table

*Syntax: ('''Integer''' width, '''Integer''' height)
*Valid Values: All supported resolutions (?)

===$Max:===
Optional. Maximum resolution for this config. Any resolution higher than specified will not use this configuration.

Used as a filter when there are multiple $Base: resolutions in the table

*Syntax: ('''Integer''' width, '''Integer''' height)
*Valid Values: All supported resolutions (?)

===$Gauges:===
Following entries define gauge-specific behavior. For the most part, each gauge has its own overrides that, if not defined, would otherwise use the global values.

Since many gauges have the same configuration options, each gauge entry has a list of valid sub-entries. Unless stated otherwise, these options must be defined in the same order as they are shown, starting from the top and ending at the bottom.

====+Custom:====
Adds a custom gauge type.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Name:|Name:]]
:[[Hud_gauges.tbl#Text:|Text:]]
:[[Hud_gauges.tbl#X Offset:|X Offset:]] (Optional)
:[[Hud_gauges.tbl#Y Offset:|Y Offset:]] (Optional)
:[[Hud_gauges.tbl#Gauge Type:|Gauge Type:]]
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Active by default:|Active by default:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]

{{table381|
====+Scripted Gauge:====
Adds a scripted gauge type.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Name:|Name:]]
}}

====+Messages:====
Adds a gauge that display mission messages.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Max Lines:|Max Lines:]] (Optional)
:[[Hud_gauges.tbl#Max Width:|Max Width:]] (Optional)
:[[Hud_gauges.tbl#Line Height:|Line Height]] (Optional)
:[[Hud_gauges.tbl#Total Lifetime:|Total Lifetime:]] (Optional)
:[[Hud_gauges.tbl#Scroll Time:|Scroll Time]] (Optional)
:[[Hud_gauges.tbl#Step Size:|Step Size:]] (Optional)
:[[Hud_gauges.tbl#Hidden By Comms Menu:|Hidden By Comms Menu:]] (Optional)

====+Training Messages:====
Adds a text box, like the ones seen in the FS1 and FS2 training missions.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}

====+Support:====
Adds a text box that shows the Support ship's status and ETA

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Text Y-offset:|Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Dock Status X-offset:|Dock Status X-offset:]] (Optional)
:[[Hud_gauges.tbl#Dock Time X-offset:|Dock Time X-offset:]] (Optional)

====+Damage:====
Adds a gauge that shows how much damage a target (or the player?) has.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Hull Integrity Offsets:|Hull Integrity Offsets]] (Optional)
:[[Hud_gauges.tbl#Hull Integrity Value X-offset:|Hull Integrity Value X-offset]] (Optional)
:[[Hud_gauges.tbl#Top Background Height:|Top Background Height:]] (Optional)
:[[Hud_gauges.tbl#Subsystem Entry Height:|Subsystem Entry Height:]] (Optional)
:[[Hud_gauges.tbl#Subsystem List Start Offsets:|Subsystem List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Subsystem Entry Value X-offset:|Subsystem Entry Value X-offset:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Offset:|Bottom Background Offset:]] (Optional)

====+Wingman Status:====
Adds a gauge that monitors the status of your wing and squadron.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Left Background Filename:|Left Background Filename:]] (Optional) (needs an animation with one frame)
{{table3615|
:[[Hud_gauges.tbl#First Background Filename:|First Background Filename:]] (Optional) (needs an animation with one frame)}}
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional) (needs an animation with one frame)
:[[Hud_gauges.tbl#Right Background Filename:|Right Background Filename:]] (Optional) (needs an animation with one frame)
{{table3615|
:[[Hud_gauges.tbl#Last Background Filename:|Last Background Filename:]] (Optional) (needs an animation with one frame)}}
:[[Hud_gauges.tbl#Dot Filename:|Dot Filename:]] (Optional) (needs an animation with two frames, 1st is for alive wingmen, 2nd is for dead or missing wingmen)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
{{table373|
[[Hud_gauges.tbl#Fixed Header Position:|Fixed Header Position:]] (Optional)}}
:[[Hud_gauges.tbl#Left Background Width:|Left Background Width:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#First Background Size:|First Background Size:]] (Optional)}}
:[[Hud_gauges.tbl#Entry Width:|Entry Width:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Entry Size:|Entry Size:]] (Optional)
:[[Hud_gauges.tbl#Right Background Offset:|Right Background Offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Offset:|Last Background Offset:]] (Optional)}}
:[[Hud_gauges.tbl#Single Wing Offsets:|Single Wing Offsets:]] (Optional)
:[[Hud_gauges.tbl#Multiple Wing Start Offsets:|Multiple Wing Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Wing Name Offsets:|Wing Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Dot Offsets:|Dot Offsets:]] (Optional)
:[[Hud_gauges.tbl#Expansion Mode:|Expansion Mode:]] (Optional)
{{Table214|
:[[Hud_gauges.tbl#Use Full Wing Names:|Use Full Wing Names:]] (Optional)
:[[Hud_gauges.tbl#Use Expanded Colors:|Use Expanded Colors:]] (Optional)
}}

====+Auto Speed:====
Adds the Auto-Speed mode gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (needs animation with 4 frames, 3rd is without auto-match-speed enabled, 4th is with... and frames 0 & 1 are not used, done this way because retail fs2 uses the same animation file for the auto speed & auto targeting gauges)
:[[Hud_gauges.tbl#Auto Offsets:|Auto Offsets:]] (Optional)
:[[Hud_gauges.tbl#Speed Offsets:|Speed Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#On Text Color:|On Text Color:]] (Optional)
:[[Hud_gauges.tbl#On Text Color:|Off Text Color:]] (Optional)}}

====+Auto Target:====
Adds the Auto-target mode gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (needs animation with 2 frames, 1st is without auto-targeting enabled, 2nd is with)
:[[Hud_gauges.tbl#Auto Offsets:|Auto Offsets:]] (Optional)
:[[Hud_gauges.tbl#Target Offsets:|Target Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#On Text Color:|On Text Color:]] (Optional)
:[[Hud_gauges.tbl#On Text Color:|Off Text Color:]] (Optional)}}

====+Countermeasures:====
Adds a gauge that monitors the amount of remaining countermeasures the player's ship currently has.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (needs an animation with a single frame)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
:[[Hud_gauges.tbl#Value Offsets:|Value Offsets:]] (Optional)

====+Talking Head:====
Adds a video window to display pilot message videos (a.k.a talking heads).

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Animation Offsets:|Animation Offsets:]] (Optional)
:[[Hud_gauges.tbl#Animation Background Size:|Animation Background Size:]] (Deprecated)
{{table373|
:[[Hud_gauges.tbl#Animation Size:|Animation Size:]] (Optional)
}}

====+Directives:====
Adds a gauge that displays all currently active directives (includes current , completed, and failed)

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional) (needs animation with one frame)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional) (needs animation with one frame)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional) (needs animation with one frame)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Background Height:|Top Background Height:]] (Optional)
:[[Hud_gauges.tbl#List Start Offsets:|List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Bottom Background Offset:|Bottom Background Offset:]] (Optional)
:[[Hud_gauges.tbl#Max Line Width:|Max Line Width:]] (Optional)
}}

====+Weapons:====
Adds a weapon status and ammunition gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Primary List Top Background Filename:|Primary List Top Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Primary List Middle Background Filename:|Primary List Middle Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Primary List Bottom Background Filename:|Primary List Bottom Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Secondary List Top Background Filename:|Secondary List Top Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Secondary List Entry Background Filename:|Secondary List Entry Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Secondary List Bottom Background Filename:|Secondary List Bottom Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
::[[Hud_gauges.tbl#Alt Ballistic Offsets:|Alt Ballistic Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Primary Background X-offset:|Top Primary BackgroundX-offset:]] (Optional)
::[[Hud_gauges.tbl#Alt Ballistic X-offset:|Alt Ballistic X-offset:]] (Optional)
:[[Hud_gauges.tbl#Text X-offset:|Text X-offset:]] (Optional)
::[[Hud_gauges.tbl#Alt Ballistic X-offset:|Alt Ballistic X-offset:]] (Optional)
:[[Hud_gauges.tbl#Top Primary Frame Height:|Top Primary Frame Height:]] (Optional)
:[[Hud_gauges.tbl#Top Secondary Frame Height:|Top Secondary Frame Height:]] (Optional)
:[[Hud_gauges.tbl#Primary List Start Y-offset:|Primary List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary List Start Y-offset:|Secondary List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Ammo X-offset:|Primary Weapon Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Link X-offset:|Primary Weapon Link X-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Name X-offset:|Primary Weapon Name X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Ammo X-offset:|Secondary Weapon Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Linked X-offset:|Secondary Weapon Linked X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Name X-offset:|Secondary Weapon Name X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Reload X-offset:|Secondary Weapon Reload X-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Entry Height:|Primary Weapon Entry Height:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Entry Height:|Secondary Weapon Entry Height:]] (Optional)

====+Objective notify:====
Adds a Objective notifier gauge. This gauge alerts the player when receiving a new objective, or when an objective has been completed or failed. Additionally, this gauge alerts the player when entering subspace, and when a Red Alert mission orders are being received (prior to a forced subspace jump).

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Objective Text Y-offset:|Objective Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Objective Value Y-offset:|Objective Value Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Subspace Text Y-offset:|Subspace Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Subspace Value Y-offset:|Subspace Value Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Red Alert Text Y-offset:|Red Alert Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Red Alert Value Y-offset:|Red Alert Value Y-offset:]] (Optional)

====+Squad Message====
Adds the squad message gauge. In FS1 and FS2, this gauge is used to send commands to your squad. (?)

*Valid sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#List Start Offsets:|List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Background Height:|Top Background Height:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Bottom Background Offset|Bottom Background Offset]] (Optional)}}
:[[Hud_gauges.tbl#Command X-offset:|Command X-offset:]] (Optional)
:[[Hud_gauges.tbl#Page Up Offsets:|Page Up Offsets:]] (Optional)
:[[Hud_gauges.tbl#Page Down Offsets:|Page Down Offsets:]] (Optional)

====+Lag:====
Adds a Lag gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]

====+Mini Target Shields:====
Adds a mini Target shields gauge. In FS1 and FS2, the Mini Target Shield gauge is the one right below the center reticle, and shows the hull damage in %

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (animation needs 8 frames; 0->3 are the top, right, bottom & left shield quads; 4->7 are the same except brighter for when the quad is flashing from being hit)
:[[Hud_gauges.tbl#3 Digit Hull Offsets:|3 Digit Hull Offsets:]] (Optional)
:[[Hud_gauges.tbl#2 Digit Hull Offsets:|2 Digit Hull Offsets:]] (Optional)
:[[Hud_gauges.tbl#1 Digit Hull Offsets:|1 Digit Hull Offsets:]] (Optional)

====+Player Shields:====
Adds a gauge that shows the shield and hull status icon of the player's craft or ship.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)

====+Target Shields:====
Adds a gauge that shows the shield and hull status icon of the targeted craft or ship.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)

====+Escort View:====
Adds an escort monitor/view gauge. This gauge monitors the status of all ships assigned to the player to escort.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height]] (Optional)
:[[Hud_gauges.tbl#Entry Stagger Width:|Entry Stagger Width:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Bottom Background Offset:|Bottom Background Offset:]] (Optional)}}
:[[Hud_gauges.tbl#Header Text:|Header Text]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#List Start Offsets:|List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Hull X-offset:|Hull X-offset]] (Optional)
:[[Hud_gauges.tbl#Name X-offset:|Name X-offset]] (Optional)
:[[Hud_gauges.tbl#Status X-offset:|Status X-offset]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Ship Name Max Width:|Ship Name Max Width:]] (Optional)}}
{{table373|
:[[Hud_gauges.tbl#Right-Align Ship Names:|Right-Align Ship Names:]] (Optional)}}

====+Mission Time:====
Adds a gauge that displays the current mission time.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
:[[Hud_gauges.tbl#Value Offsets:|Value Offsets:]] (Optional)

====+ETS Retail:====
{{Table3613|
Draws the three other ETS gauges as a single gauge. Will automatically rearrange itself (like retail) if shields or other systems are missing.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
{{Table3613|
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)
:[[Hud_gauges.tbl#Gauge Offset:|Gauge Offset:]] (Optional)

}}

====+ETS Weapons:====
Adds a gauge that displays the energy transfer rate for the energy weapons.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)

====+ETS Engines:====
Adds a gauge that displays the energy transfer rate for the afterburner/engines.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)

====+ETS Shields:====
Adds a gauge that displays the energy transfer rate for the shields.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)

====+Target Monitor:====
Adds a target monitor gauge that shows the targeted ship's relative orientation and hull strength, among other things.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Monitor Filename:|Monitor Filename:]] (Optional) (needs animation with 2 frames, 1st is the background for the target, 2nd is the border; rendered last)
{{table3615|
:[[Hud_gauges.tbl#Monitor Alpha Mask Filename:|Monitor Alpha Mask Filename:]] (Optional) (needs animation with a single frame)}}
:[[Hud_gauges.tbl#Integrity Bar Filename:|Integrity Bar Filename:]] (Optional) (needs animation with 2 frames, 1st is a zero/dark filled bar, 2nd is a max/bright filled bar)
:[[Hud_gauges.tbl#Viewport Offsets:|Viewport Offsets:]] (Optional)
:[[Hud_gauges.tbl#Viewport Size:|Viewport Size:]] (Optional)
:[[Hud_gauges.tbl#Integrity Bar Offsets:|Integrity Bar Offsets:]] (Optional)
:[[Hud_gauges.tbl#Integrity Bar Foreground Clip Height:|Integrity Bar Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Status Offsets:|Status Offsets:]] (Optional)
:[[Hud_gauges.tbl#Name Offsets:|Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Class Offsets:|Class Offsets:]] (Optional)
:[[Hud_gauges.tbl#Distance Offsets:|Distance Offsets:]] (Optional)
:[[Hud_gauges.tbl#Speed Offsets:|Speed Offsets:]] (Optional)
:[[Hud_gauges.tbl#Hull Offsets:|Hull Offsets:]] (Optional)
:[[Hud_gauges.tbl#Cargo Contents Offsets:|Cargo Contents Offsets:]] (Optional)
:[[Hud_gauges.tbl#Cargo Scan Start Offsets:|Cargo Scan Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Cargo Scan Size:|Cargo Scan Size:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Subsystem Name Offsets:|Subsystem Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Subsystem Integrity Offsets:|Subsystem Integrity Offsets:]] (Optional)
:[[Hud_gauges.tbl#Disabled Status Offsets:|Disabled Status Offsets:]] (Optional)
:[[Hud_gauges.tbl#Desaturate:|Desaturate:]] (Optional)
}}

====+Extra Target Data:====
Adds a gauge that displays "extra" target data, such as its current orders and docking status.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs an animation with 1 frame)
:[[Hud_gauges.tbl#Bracket Offsets:|Bracket Offsets:]] (Optional)
:[[Hud_gauges.tbl#Dock Offsets:|Dock Offsets:]] (Optional)
{{table373|
:[[Hud_gauges.tbl#Dock Max Width:|Dock Max Width:]] (Optional)}}
:[[Hud_gauges.tbl#Order Offsets:|Order Offsets:]] (Optional)
{{table373|
:[[Hud_gauges.tbl#Order Max Width:|Order Max Width:]] (Optional)}}
:[[Hud_gauges.tbl#Time Offsets:|Time Offsets:]] (Optional)

====+Radar:====
Adds a standard radar gauge

*Valid Sub-entries:
{{table190|
:[[Hud_gauges.tbl#Ngon Sides:|Ngon Sides:]] (Optional)
:[[Hud_gauges.tbl#Ngon Sides:|Ngon Offset:]] (Optional)
}}
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs animation with 2 frames, only the 2nd frame is used)
{{table373|
:[[Hud_gauges.tbl#Radar Center Offsets:|Radar Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Radar Size:|Radar Size:]] (Optional)
}}
:[[Hud_gauges.tbl#Infinity Distance Offsets:|Infinity Distance Offsets]] (Optional)
:[[Hud_gauges.tbl#Long Distance Offsets:|Long Distance Offsets:]] (Optional)
:[[Hud_gauges.tbl#Short Distance Offsets:|Short Distance Offsets:]] (Optional)

====+Radar Orb:====
Adds a 3D orb radar gauge

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs animation with 2 frames, only the 2nd frame is used)
{{table373|
:[[Hud_gauges.tbl#Radar Center Offsets:|Radar Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Radar Size:|Radar Size:]] (Optional)
}}
:[[Hud_gauges.tbl#Infinity Distance Offsets:|Infinity Distance Offsets]] (Optional)
:[[Hud_gauges.tbl#Long Distance Offsets:|Long Distance Offsets:]] (Optional)
:[[Hud_gauges.tbl#Short Distance Offsets:|Short Distance Offsets:]] (Optional)

====+Radar BSG:====
Adds a BSG style radar (a.k.a DRADIS).

:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Size:|Size:]] (Optional)
:[[Hud_gauges.tbl#XY Disc Filename:|XY Disc Filename:]] (Optional)
:[[Hud_gauges.tbl#XZ YZ Disc Filename:|XZ YZ Disc Filename:]] (Optional)
:[[Hud_gauges.tbl#Sweep Disc Filename:|Sweep Disc Filename:]] (Optional)
:[[Hud_gauges.tbl#Default Contact Filename:|Default Contact Filename:]] (Optional)
:[[Hud_gauges.tbl#Unknown Contact Filename:|Unknown Contact Filename:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]]
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]]
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Loop Volume:|Loop Volume:]] (Optional)
:[[Hud_gauges.tbl#Minimum Beep Delay:|Minimum Beep Delay]] (Optional)

====+Afterburner Energy:====
Adds a gauge that shows the remaining afterburner energy. Note that it only supports a vertical fill.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs animation with 2 frames, the 1st is the bar lit for zero energy, the 2nd is the bar lit for max energy)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)

====+Weapon Energy:====
Adds a gauge that shows the remaining weapon energy. Note that it only supports a vertical fill.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs an animation with 4 frames, the 3rd is the bar lit for zero energy, the 2nd is the bar lit for max energy, frames 1 & 2 are not used)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Text Alignment:|Text Alignment:]] (Optional)
:[[Hud_gauges.tbl#Always Show Text:|Always Show Text:]] (Optional)
:[[Hud_gauges.tbl#Text Follows:|Text Follows:]] (Optional)
:[[Hud_gauges.tbl#Show Ballistic Ammo:|Show Ballistic Ammo:]] (Optional)
:[[Hud_gauges.tbl#Armed Guns List Offsets:|Armed Guns List Offsets:]] (Optional)
:[[Hud_gauges.tbl#Armed Guns List Alignment:|Armed Guns List Alignment:]] (Optional)
:[[Hud_gauges.tbl#Armed Guns List Entry Height:|Armed Guns List Entry Height:]] (Optional)
}}

====+Text Warnings:====
Adds a gauge that warns the player (current warnings are EMP, Launch, Evaded, Collision, Blast & Engine Wash).

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)

====+Center Reticle:====
Adds a "custom" center reticle.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Firepoint display:|Firepoint display:]] (Optional)
:[[Hud_gauges.tbl#Firepoint size:|Firepoint size:]] (Optional)
:[[Hud_gauges.tbl#Firepoint X coordinate multiplier:|Firepoint X coordinate multiplier:]] (Optional)
:[[Hud_gauges.tbl#Firepoint Y coordinate multiplier:|Firepoint Y coordinate multiplier:]] (Optional)

====+Throttle:====
Adds a gauge that shows the current throttle position.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Bottom Y-offset:|Foreground Clip Bottom Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Width:|Foreground Clip Width:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Afterburner Clip Height:|Afterburner Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Show Background:|Show Background:]] (Optional)
:[[Hud_gauges.tbl#Max Speed Label Offsets:|Max Speed Label Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Show Max Speed Label:|Show Max Speed Label:]] (Optional)}}
:[[Hud_gauges.tbl#Min Speed Label Offsets:|Min Speed Label Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Show Min Speed Label:|Show Min Speed Label:]] (Optional)}}
:[[Hud_gauges.tbl#Orbit Center Offsets:|Orbit Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Orbit Radius:|Orbit Radius:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Current Speed Offsets:|Current Speed Offsets:]] (Optional)
:[[Hud_gauges.tbl#Target Speed Offsets:|Target Speed Offsets:]] (Optional)
:[[Hud_gauges.tbl#Show Percentage:|Show Percentage:]] (Optional)
:[[Hud_gauges.tbl#Glide Status Offsets:|Glide Status Offsets:]] (Optional)
:[[Hud_gauges.tbl#Match Speed Status Offsets:|Match Speed Status Offsets:]] (Optional)
}}

====+Threat Indicator:====
Adds a gauge that indicates when a lock-on has been achieved by an attacker, and if the player is being shot at.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Arc Filename:|Arc Filename:]] (Optional)
:[[Hud_gauges.tbl#Dumbfire Filename:|Dumbfire Filename:]] (Optional)
:[[Hud_gauges.tbl#Lock Filename:|Lock Filename:]] (Optional)
:[[Hud_gauges.tbl#Dumbfire Offsets:|Dumbfire Offsets:]] (Optional)
:[[Hud_gauges.tbl#Lock Offsets:|Lock Offsets:]] (Optional)

====+Multiplayer Messages:====
Adds a gauge that displays the multiplayer messages.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}

====+Voice Status:====
Adds a gauge that displays the voice status.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}

====+Ping:====
Adds a gauge that the ping time to the multiplayer server.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}

====+Supernova:====
Adds a gauge that warns the player of an impending supernova shock wave.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}

====+Lock Indicator:====
Adds a Lock Indicator gauge.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Lock Filename:|Lock Filename:]] (Optional)
:[[Hud_gauges.tbl#Locked Filename:|Locked Filename:]] (Optional)
:[[Hud_gauges.tbl#Lock Center Offsets:|Lock Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Locked Center Offsets:|Locked Center Offsets:]] (Optional)
{{table224|
:[[Hud_gauges.tbl#Loop Locked Animation:|Loop Locked Animation:]] (Optional)
:[[Hud_gauges.tbl#Blink Locked Animation:|Blink Locked Animation:]] (Optional)}}

====+Offscreen Indicator:====
Adds an Offscreen Indicator.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}

====+Target Brackets:====
Adds a Target Bracket gauge. This is drawn around current target(s) and talkers.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Dot Filename:|Dot Filename:]] (Optional)

====+Hostile Triangle:====
Adds a gauge that points to the nearest attacker, if it is off-screen and is not currently targeted.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)
:[[Hud_gauges.tbl#Triangle Base:|Triangle Base:]] (Optional)
:[[Hud_gauges.tbl#Triangle Height:|Triangle Height:]] (Optional)

====+Target Triangle:====
Adds a gauge that points to the targeted craft, if it is currently off-screen.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)
:[[Hud_gauges.tbl#Triangle Base:|Triangle Base:]] (Optional)
:[[Hud_gauges.tbl#Triangle Height:|Triangle Height:]] (Optional)

====+Missile Triangles:====
Adds a gauge that is used during attempting to lock onto a target when using an aspect seeking missile.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)
:[[Hud_gauges.tbl#Triangle Base:|Triangle Base:]] (Optional)
:[[Hud_gauges.tbl#Triangle Height:|Triangle Height:]] (Optional)

====+Lead Indicator:====
Adds a gauge that leads (is in front) of the target. Aim your crosshairs at this indicator to increase probability of hitting the target.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
::Frame #0: Secondaries lead indicator (Dumbfire)
::Frame #1: Secondaries lead indicator (Homing)
::Frame #2: Primaries lead indicator
:[[Hud_gauges.tbl#Center Offsets:|Center Offsets:]] (Optional)

====+Orientation Tee:====
Adds a gauge that indicates the targeted craft's orientation in relation to the player's craft.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)

====+Lead Sight:====
Adds a gauge that lags (is behind) the target. Indicates where your shots will end up relative to the target's position. To score a hit, this gauge should be over the target. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
::Frame #0 is used for secondaries
::* If only one frame is found in the file, then it is used for primaries instead
::Frame #1 is used for primaries

====+Kills:====
Adds a gauge that keeps track of how many kills the player has scored during a mission.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
:[[Hud_gauges.tbl#Value Offsets:|Value Offsets:]] (Optional)

====+Weapon Linking:====
Adds a gauge that indicates the selected weapons and their firing rates.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Arc Filename:|Arc Filename:]] (Optional)
:[[Hud_gauges.tbl#Single Primary Filename:|Single Primary Filename:]] (Optional)
:[[Hud_gauges.tbl#Double Primary Filename:|Double Primary Filename:]] (Optional)
:[[Hud_gauges.tbl#Single Secondary Filename:|Single Secondary Filename:]] (Optional)
:[[Hud_gauges.tbl#Double Secondary Filename:|Double Secondary Filename:]] (Optional)
:[[Hud_gauges.tbl#Triple Secondary Filename:|Triple Secondary Filename:]] (Optional)
:[[Hud_gauges.tbl#Single Primary Offsets:|Single Primary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Double Primary Offsets:|Double Primary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Single Secondary Offsets:|Single Secondary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Double Secondary Offsets:|Double Secondary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Triple Secondary Offsets:|Triple Secondary Offsets:]] (Optional)

====+Fixed Messages:====

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
{{table375|
:[[Hud_gauges.tbl#Center Text On Gauge X-Position:|Center Text On Gauge X-Position:]] (Optional)
}}

====+Flight Path Marker:====
{{table3615|
Adds a gauge that indicates the direction where your ship is traveling. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Center Offsets:|Center Offsets:]] (Optional)}}

====+Warhead Count:====
{{table3615|
Displays the name of the current secondary weapon. Tallies the ammo left. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs an animation with a single frame)
:[[Hud_gauges.tbl#Name Offsets:|Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Count Offsets:|Count Offsets:]] (Optional)
:[[Hud_gauges.tbl#Icon Width:|Icon Width:]] (Optional)
:[[Hud_gauges.tbl#Icon Height:|Icon Height:]] (Optional)
:[[Hud_gauges.tbl#Max Icons:|Max Icons:]] (Optional)
:[[Hud_gauges.tbl#Max Columns:|Max Columns:]] (Optional)
:[[Hud_gauges.tbl#Name Alignment:|Name Alignment:]] (Optional)
}}

====+Hardpoints:====
{{table3615|
Draws a silhouette of the player's ship and mounted weapons. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Size:|Size:]] (Optional)
:[[Hud_gauges.tbl#Line Width:|Line Width:]] (Optional)
:[[Hud_gauges.tbl#View Direction:|View Direction:]] (Optional)
:[[Hud_gauges.tbl#Show Primary Weapons:|Show Primary Weapons:]] (Optional)
:[[Hud_gauges.tbl#Show Secondary Weapons:|Show Secondary Weapons:]] (Optional)
}}

====+Primary Weapons:====
{{table3615|
Like the Weapons gauge but simpler. Only displays primary weapons. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Header Text:|Header Text:]] (Optional)
:[[Hud_gauges.tbl#First Background Filename:|First Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#First Background Height:|First Background Height:]] (Optional)
:[[Hud_gauges.tbl#First Background X-offset:|First Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Entry Background Height:|Entry Background Height:]] (Optional)
:[[Hud_gauges.tbl#Entry Background X-offset:|Entry Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Filename:|Last Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Last Background X-offset:|Last Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Y-offset:|Last Background Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
:[[Hud_gauges.tbl#List Start Y-offset:|List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Ammo X-offset:|Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Link X-offset:|Link X-offset:]] (Optional)
:[[Hud_gauges.tbl#Name X-offset:|Name X-offset:]] (Optional)
}}

====+Secondary Weapons:====
{{table3615|
Like the Weapons gauge but simpler. Only displays secondary weapons. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Header Text:|Header Text:]] (Optional)
:[[Hud_gauges.tbl#First Background Filename:|First Background Filename:]] (Optional)
:[[Hud_gauges.tbl#First Background Height:|First Background Height:]] (Optional)
:[[Hud_gauges.tbl#First Background X-offset:|First Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Height:|Entry Background Height:]] (Optional)
:[[Hud_gauges.tbl#Entry Background X-offset:|Entry Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Filename:|Last Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Last Background X-offset:|Last Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Y-offset:|Last Background Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
:[[Hud_gauges.tbl#List Start Y-offset:|List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Ammo X-offset:|Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Link X-offset:|Link X-offset:]] (Optional)
:[[Hud_gauges.tbl#Name X-offset:|Name X-offset:]] (Optional)
:[[Hud_gauges.tbl#Unlink X-offset:|Unlink X-offset:]] (Optional)
:[[Hud_gauges.tbl#Reload X-offset:|Reload X-offset:]] (Optional)
}}

===$End Gauges===
The Gauges section must end with $End Gauges. No Exceptions.

==#End==
The very last entry in the Hud_gauges.tbl must be #End. No Exceptions.

----
----

==Gauge Configuration Options==
Since a vast majority of gauges share the same entries, the configuration options for each gauge have been grouped here for formatting consistency.

====Position:====
Defines the screen coordinates for the upper left corner of this gauge.

*Syntax: '''Integer''' horizontal pixel, '''Integer''' vertical pixel position

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Training Messages:|+Training Messages:]], [[Hud_gauges.tbl#+Support:|+Support]] (and many others)

====Scale Gauge:====

{{table371|
Define if a gauge size will scale or not.

If false then gauge bitmaps will always show at their original size which may result in gauges being very small at high resolutions.

If true then gauge bitmaps will scale in proportion to the current resolution vs the base HUD resolution in use. This may result in gauges becoming blurry at non-base resolutions.

Defaults to yes/true.

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: '''Boolean''' scale_this_gauge

Used by: most gauges
}}

====Force Scaling Above:====

{{Table373|
Optional. If scaling is disabled for this gauge, then it will be scaled as though the base resolution were this resolution or the real base resolution, whichever is greater.

Use this to disable scaling at lower resolutions while preventing gauges from getting too small at higher resolutions.

To disable this feature, use '''(-1, -1)'''.

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: ('''Integer''' width, '''Integer''' height)

Used by: most gauges
}}

====Origin:====

{{table371|
Define gauge position as a ratio of the screen size (base or current, it doesn't matter).

Requires [[Hud_gauges.tbl#Offset:|Offset:]]

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: '''Float''' horizontal ratio 0.0 - 1.0, '''Float''' vertical ratio 0.0 - 1.0

Used by: most gauges
}}

====Offset:====

{{table371|
Define gauge offset from [[Hud_gauges.tbl#Origin:|Origin:]] in base resolution pixels

Requires [[Hud_gauges.tbl#Origin:|Origin:]]

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: '''Integer''' horizontal pixel offset from Origin:, '''Integer''' vertical pixel offset from Origin:

Used by: most gauges
}}

====Cockpit Target:====
The cockpit display that this gauge will be rendered to. Refers to the +Display Name: defined in [[ships.tbl#$Cockpit Display:|$Cockpit Display:]].

*Syntax: '''String''' String defined in +Display Name: in [[ships.tbl#$Cockpit Display:|$Cockpit Display:]]

=====Canvas Size:=====
The off-screen canvas this gauge will be rendered to before being interpolated into the actual cockpit display. The smaller this number is, the larger the gauge will appear on the cockpit display.

*Syntax: '''Integer''' width, '''Integer''' height

=====Display Offset:=====
The position of the canvas on the cockpit display texture

*Syntax: '''Integer''' width, '''Integer''' height

=====Display Size:=====
The interpolated size on the cockpit display texture that the canvas will be rendered to.

*Syntax: '''Integer''' width, '''Integer''' height

====Color:====
Optional. Overrides both previous color settings ([[Hud_gauges.tbl#$Color: 1|$Color]] HUD option and [[Hud_gauges#$Color: 2|$Color]] ship class option) for this particular gauge.

*Syntax: See [[Hud_gauges.tbl#$Color: 1|$Color:]]

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Font:====
Optional. Overrides both previous font settings ([[Hud_gauges.tbl#$Font: 1|$Font]] HUD option and [[Hud_gauges#$Font: 2|$Font]] ship class option) for this particular gauge.

*Syntax: See [[Hud_gauges.tbl#$Font: 1|$Font:]]

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Training Messages:|+Training Messages:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Name:====
Defines the name of this custom gauge.

*Syntax: '''String'''
*Max Length: 32 characters

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Text:====
Default text to be displayed. Can be altered using the hud-set-message, hud-set-text and hud-set-directive sexps.

*Syntax: '''String'''
*Max Length: 32 characters

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====X Offset:====
Optional. Defines the horizontal pixel offset (from the gauge's origin as defined by [[Hud_gauges.tbl#Position:|Position:]]) that the Text will be displayed.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Y Offset:====
Optional. Defines the vertical pixel offset (from the gauge's origin defined by [[Hud_gauges.tbl#Position:|Position:]]) that the Text will be displayed.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Gauge Type:====
Defines the type of gauge this is.

*Syntax: '''String'''
*Valid Values: Any one of the possible [[gauge types]].

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Slew:====
Optional. Determines whether or not this gauge is affected by afterburner shaking or similar effects. If set to "true", the gauge will not follow the player's head movements when using TrackIR/padlock. i.e. should be used for gauges like the gunsight/leadsight.

*Syntax: '''Boolean'''

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Max Lines:====
Optional. Specifies the maximum number of message lines that are displayed.

*Syntax: '''Integer'''
*Default Value: 3

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Max Width:====
Optional. Determines how long each message line may be.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Line Height:====
Optional. Determines the distance between line origins. (i.g. for a 12pt Font, there are needs to be at least 12 pixels between the bottom of one line and the next, otherwise the text will overlap each)

*Syntax: '''Integer'''
*Units: Pixels
*Default Value: 9

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Total Lifetime:====
Optional. Determines the maximum time the message gauge will be displayed from the time a new message is received.

*Syntax: '''Integer'''
*Units: milliseconds
*Default Value: 14000 (14 seconds)

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Scroll Time:====
Optional. Determines the time for the messages to scroll up one step.( See [[Hud_gauges.tbl#Step Size:|Step Size:]] )

*Syntax: '''Integer'''
*Units: milliseconds
*Default Value: 30

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Step Size:====
Optional. Determines how many pixels to shift message lines during scrolling. Messages will be shifted up by this amount until they are on the next line (as defined by [[Hud_gauges.tbl#Line Height:|Line Height:]])

*Syntax: '''Integer'''
*Units: Pixels
*Default Value: 3

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Active by default:====
Optional. Determines whether or not this gauge is always active, or only available after being activated via sexp.

*Syntax: '''Boolean'''

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Filename:====
Designates the [[Multimedia_Files#ANI|.ANI]] or [[Multimedia_Files#EFF|.EFF]] used for this gauge's background graphic.
{{Note| All HUD .ANI's must have the same color palette as the retail .ANI's in order to render properly. (.EFF's do not have this restriction)}}

*Syntax: '''Filename'''
**No filename extension is needed.

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Top Background Filename:====
Optional. Designates which file to use for the top background. (?)

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Damage|+Damage]]

====Bottom Background Filename:====
Optional. Designates which file to use for the Bottom background (?)

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Damage|+Damage]]

====Left Background Filename:====
Optional. Designates which file to use for the Left side of gauge.

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====First Background Filename:====
Optional. Alias for [[Hud_gauges.tbl#Left Background Filename:|Left Background Filename:]]

====Right Background Filename:====
Optional. Designates which file to use for the Right side of the gauge.

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Last Background Filename:====
Optional. Alias for [[Hud_gauges.tbl#Right Background Filename:|Right Background Filename:]]

====Entry Background Filename:====
Optional. Designates which file to use for the (Wing) Entry section of the gauge (aka the middle sections).

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Damage|+Damage]], [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Primary List Top Background Filename:====
Optional. Designates which file to use for the Primary List Top Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary List Middle Background Filename:====
Optional. Designates which file to use for the Primary List Middle Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary List Bottom Background Filename:====
Optional. Designates which file to use for the Primary List Bottom Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Top Background Filename:====
Optional. Designates which file to use for the Secondary List Top Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Entry Background Filename:====
Optional. Designates which file to use for the Secondary List Entry Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Bottom Background Filename:====
Optional. Designates which file to use for the Secondary List Bottom Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Alt Ballistic Filename:====
Optional. Designates an alternate file to be used for ballistic weapons.

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#Primary List Top Background Filename:|Primary List Top Background Filename]], [[Hud_gauges.tbl#Primary List Middle Background Filename:|Primary List Middle Background Filename]], [[Hud_gauges.tbl#Primary List Bottom Background Filename:|Primary List Bottom Background Filename]], [[Hud_gauges.tbl#Secondary List Top Background Filename:|Secondary List Top Background Filename]], [[Hud_gauges.tbl#Secondary List Entry Background Filename:|Secondary List Entry Background Filename]], [[Hud_gauges.tbl#Secondary List Bottom Background Filename:|Secondary List Bottom Background Filename]]

====Dot Filename:====
Optional. Designates which file to use for the wingman graphic (a.k.a. the Dot)

*Syntax: '''Filename'''

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Header Offsets:====
Optional. Designates the offset from the gauge's upper left corner for headers of various gauges

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels
*Valid Sub-entries:
:Weapons:
::[[Hud_gauges.tbl#Alt Ballistic Offsets:|Alt Ballistic Offsets:]]

Used by: [[Hud_gauges.tbl#+Support:|+Support:]], [[Hud_gauges.tbl#+Damage|+Damage:]], [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Fixed Header Position:====
Optional. If set, the header text will not change position when the gauge changes size.

*Syntax: '''Boolean'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Text Y-offset:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship Text. (?)

*Syntax: '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]]

====Text Offsets:====
Optional. Defines the screen position offsets for the text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: :[[Hud_gauges.tbl#+Countermeasures:|+Countermeasures:]]

====Value Offsets:====
Optional. Defines the screen position offsets for the value label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: :[[Hud_gauges.tbl#+Countermeasures:|+Countermeasures:]]

====Dock Status X-offset:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship's dock status. (?)

*Syntax: '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]]

====Dock Time X-offset:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship's dock time. (?)

*Syntax: '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]]

====Hull Integrity Offsets:====
Optional. Designates the offsets from the gauge's upper left corner for the for the Damage gauge Hull integrity textbox(?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Hull Integrity Value X-offset:====
Optional. Designates the offsets from the hull integrity textbox's upper left corner for the hull integrity value. (?)

*Syntax: '''Integer''' horizontal offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Top Background Height:====
Optional. Designates the height of the Top background (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Left Background Width:====
Optional. Defines the width of the Left Background.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Entry Width:====
Optional. Defines the width of the Entry Background (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Subsystem Entry Height:====
Optional. Designates the height of the Subsystem entry (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Subsystem List Start Offsets:====
Optional. Designates the offsets from the gauge's upper left corner for the for the start of the Subsytem List (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Subsystem Entry Value X-offset:====
Optional. Designates the horizontal offset from the Subsystem List's position (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Single Wing Offsets:====
Optional. Designates the offset from the gauge's upper left corner for a single wing (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Multiple Wing Start Offsets:====
Optional. Designates the offset from the gauge's upper left corner for multiple wings (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Wing Name Offsets:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship header (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Dot Offsets:====
Optional. Designates the offset from the gauge's upper left corner for the All wingman status icons.
*Syntax:
:'''Integer''' x, '''Integer''' y ;; Wingman 1
:'''Integer''' x, '''Integer''' y ;; Wingman 2
:'''Integer''' x, '''Integer''' y ;; Wingman 3
:'''Integer''' x, '''Integer''' y ;; Wingman 4
:'''Integer''' x, '''Integer''' y ;; Wingman 5
:'''Integer''' x, '''Integer''' y ;; Wingman 6
*Units: Pixels

{{Warning|
All 6 wingman positions must be defined}}

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Expansion Mode:====
Optional. Denotes which direction (in relation to the player's wing) that the other wings should be appended to the gauge. If enabled, then wingmen dot colors will be

*Syntax: '''Boolean'''
*Default Value: '''False'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Use Full Wing Names:====
{{Table214|
Optional. If enabled the wingmen gauge draws the full wing name and does not alter the capitalization. Default behavior is to draw the first three letters of the wing in all lower-case.

*Syntax: '''Boolean'''
*Default Value: '''False'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]
}}

====Use Expanded Colors:====
{{Table214|
Optional. If enabled the wingmen gauge status dots use red, yellow, or green color to designate wingmen health (green full to greater thon two-thirds, yellow two-thirds to greater than one-third, and red less than or equal to one-third). Default is to use red for less than half health and gauge color otherwise.

*Syntax: '''Boolean'''
*Default Value: '''False'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]
}}

====Auto Offsets:====
Optional. Defines the screen coordinates for the "Auto" text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Auto Speed:|+Auto Speed:]], [[Hud_gagues.tbl#+Auto Target:|+Auto Target:]]

====Speed Offsets:====
Optional. Defines the screen coordinates for the "Speed" text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Auto Speed:|+Auto Speed:]]

====Target Offsets:====
Optional. Defines the screen coordinates for the "Target" text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Auto Target:|+Auto Target:]]

====Animation Offsets:====
Optional. Defines the offsets for the animation graphics.

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Talking Head:|+Talking Head:]]

====Animation Background Size:====
Deprecated. Originally, this set the size of the black box that's drawn behind the animation. Since Git revision 556e9a4 (2015-11-01), it has the same effect as [[Hud_gauges.tbl#Animation Size:|Animation Size:]].

*Syntax: '''Integer''' horizontal size, '''Integer''' vertical size
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Talking Head:|+Talking Head:]]

====Animation Size:====
{{table373|
Optional. Defines the size of the animation. All animations will be scaled to match this size.

*Syntax: '''Integer''' horizontal size, '''Integer''' vertical size
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Talking Head:|+Talking Head:]]
}}

====List Start Offsets:====
Optional. Defines the screen coordinate offsets for the start of the Directives list.

*Syntax: '''Integer''' x, '''Integer''' y
*Units: Pixels

Used by: [[Hud_guages.tbl#+Directives:|+Directives:]]

====Entry Height:====
Optional. Defines the height of each Directive

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_guages.tbl#+Directives:|+Directives:]]

====Alt Ballistic Offsets:====
Opetional. Defines the screen coordinate offsets for headers of ballistic weapons

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Header Offset:|+Header Offset:]]

====Top Primary Background X-offset:====
Optional. Defines the screen coordinate offset for the Top Primary Background

*Syntax: '''Integer'''
*Units: Pixels
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic X-offset:|Alt Ballistic X-offset:]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Text X-offset:====
(Optional) Defines the screen coordinate X-offset for weapon labels

*Syntax: '''Integer'''
*Units: Pixels
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic X-offset:|Alt Ballistic X-offset:]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Alt Ballistic X-offset:====
Optional. Defines the screen coordinate X-offset for ballistic weapons

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#Top Primary Background X-offset:|Top Primary Background X-offset:]], [[Hud_gauges.tbl#Text X-offset:|Text X-offset:]]

====Top Primary Frame Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Top Secondary Frame Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary List Start Y-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Start Y-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Ammo X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Link X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Name X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Ammo X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Linked X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Name X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Reload X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Entry Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Entry Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====3 Digit Hull Offsets:====
Designates the screen position offsets for the hull damage % when it is the 3 digit range (i.e. >= 100%)

*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Mini Target Shields:|+Mini Target Shields:]]

====2 Digit Hull Offsets:====
Designates the screen position offsets for the hull damage % when it is the 2 digit range (i.e. 100% > hull damage% >= 10%)

*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Mini Target Shields:|+Mini Target Shields:]]

====1 Digit Hull Offsets:====
Designates the screen position offsets for the hull damage % when it is the 1 digit range (i.e. 10% > hull damage% >= 0%)

*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Mini Target Shields:|+Mini Target Shields:]]

====Objective Text Y-offset:====
Designates the screen position offset for the Objective label

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Objective Value Y-offset====
Designates the screen position offset for the Objective value

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Subspace Text Y-offset:====
Designates the screen position offset for the Subspace label

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Subspace Value Y-offset====
Designates the screen position offset for the Subspace value (?)

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Red Alert Text Y-offset====
Designates the screen position offset for the Red Alert label

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Red Alert Value Y-offset====
Designates the screen position offset for the Red Alert value (?)

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Command X-offset:====
*Syntax: '''Integer''' x offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Squad Message:|+Squad Message:]]

====Page Up Offsets:====
*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Squad Message:|+Squad Message:]]

====Page Down Offsets:====
*Syntax: '''Integer''' x offset, ''' Integer y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Squad Message:|+Squad Message:]]

====Entry Height:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Entry Stagger Width:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Header Text:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Header Offsets:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====List Start Offsets:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Hull X-offset:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Name X-offset:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Status X-offset:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Ship Name Max Width:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Right-Align Ship Names:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Foreground Clip Height:====

* Sets the height, in pixels, of the gauge.
** For the [[Hud_gauges.tbl#+Throttle|Throttle]], sets the height of the gauge that represents 0% to 100% throttle. The total height of the gauge is the sum of this value and the [[Hud_gauges.tbl#Afterburner Clip Height:|Afterburner Clip Height]] value.
* Syntax: '''Integer'''

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]], [[Hud_gauges.tbl#+ETS Weapons:|+ETS Weapons]], [[Hud_gauges.tbl#+ETS Engines:|+ETS Engines]], [[Hud_gauges.tbl#+ETS Shields:|+ETS Shields]], [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor]], [[Hud_gauges.tbl#+Afterburner Energy|+Afterburner Energy]], [[Hud_gauges.tbl#+Weapon Energy|+Weapon Energy]], [[Hud_gauges.tbl#+Throttle:|+Throttle]]

====Letter Offsets:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Top Offsets:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Bottom Offsets:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Gauge Offset:====
*Distance between the individual weapon/shield/engine ETS gauges that comprise this gauge
*Syntax: '''Integer'''

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Monitor Filename:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Integrity Bar Filename:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Viewport Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Viewport Size:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Integrity Bar Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Integrity Bar Foreground Clip Height:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Status Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Name Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Class Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Speed Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Hull Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Cargo Contents Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Cargo Scan Start Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Cargo Scan Size:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Bracket Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Dock Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Dock Max Width:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Order Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Order Max Width:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Time Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Radar Center Offsets:====
Defines the radar's plot origin as an offset, in pixels, from this gauge's [[Hud_gauges.tbl#Position|Position]] coordinates
*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

====Radar Size:====
Size, in pixels, of the radar plot area.

Syntax: '''Integer''' horizontal size, '''Integer''' vertical size

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

====Infinity Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

Offset to draw the infinity radar range symbol.

====Long Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

Offset to draw the long range radar text (i.e. 10k).

====Short Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

Offset to draw the short range radar text (i.e. 2k).

====Size:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====XY Disc Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====XZ YZ Disc Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Sweep Disc Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Default Contact Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Unknown Contact Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Loop Volume:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG]]

====Minimum Beep Delay:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG]]

====Firepoint display:====
Displays the positions of the gun firepoints on your ship
*Syntax: '''Boolean''', YES or NO

NOTE: The position of the firepoints is calculated from the Eye Point position in the POF. You may encounter weird results if you have no Eye Point defined, but no debug warnings will be raised.

Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Firepoint size:====
Diameter of the gunpoint circles. '''Must be 4 or greater''' in order to work properly.
*Syntax: '''Integer'''

Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Firepoint X coordinate multiplier:====
Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Firepoint Y coordinate multiplier:====
Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Foreground Clip Bottom Y-offset:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Foreground Clip Width:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Afterburner Clip Height:====
* Sets the area of the throttle gauge that represents the Afterburner segment (which is on top of the 0% to 100% area). The total height of the gauge is determined by the sum of this value and [[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]]

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Show Background:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Max Speed Label Offsets:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Min Speed Label Offsets:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Orbit Center Offsets:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Orbit Radius:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Arc Filename:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Needs to be an [[Multimedia_Files#ANI|ani]] with a least 2 frames (but only the 2nd frame is used ?!?!? for threat & weapon linking so far)

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Dumbfire Filename:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Needs to be an [[Multimedia_Files#ANI|ani]] with a least 2 frames. The 1st frame is "no warning", the rest of the frames are cycled through when a warning is active.

Internally FSO also refers to this as the "laser threat warning".

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Lock Filename:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Needs to be an [[Multimedia_Files#ANI|ani]] with a least 2 frames. The 1st frame is "no warning", the rest of the frames are cycled through when a warning is active. Frames cycle twice as fast when a lock has been acquired, compared to when a lock is being acquired.

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Dumbfire Offsets:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Lock Offsets:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Lock Filename:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Locked Filename:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Lock Center Offsets:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Locked Center Offsets:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Loop Locked Animation:====

Controls whether the animation should loop after locking on, like in FS1.

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Blink Locked Animation:====

Controls whether the animation should blink after locking on, like in FS2.

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Radius:====
Defines the distance from the center of the screen to the base of the Hostile Triangle gauge.

*Syntax: '''Integer'''
*Default value:
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Hostile Triangle:|+Hostile Triangle:]]

====Triangle Base:====
Defines the width of the Hostile Triangle's base.

*Syntax: '''Float'''
*Default value:
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Hostile Triangle:|+Hostile Triangle:]]

====Triangle Height:====
Defines the height of the Hostile Triangle.

*Syntax: '''Float'''
Default value:
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Hostile Triangle:|+Hostile Triangle:]]

====Center Offsets:====

Used by: [[Hud_gauges.tbl#+Lead Indicator:|+Lead Indicator:]]

====Single Primary Filename:====
Designates the file to use for primary linking for ships with a single primary bank.

Needs to be an [[Multimedia_Files#ANI|ani]] with 2 frames; 1st is bank 1 not selected (not that this should ever be able to happen), 2nd is bank 1 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Primary Filename:====

Designates the file to use for primary linking for ships with two primary banks.

Needs to be an [[Multimedia_Files#ANI|ani]] with 4 frames:
* Frame 0 is no banks selected
* Frame 1 is 1st bank selected
* Frame 2 is 2nd bank selected
* Frame 3 is both banks selected/linked

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Single Secondary Filename:====

Designates the file to use for selected secondary bank for ships with a single secondary bank.

Needs to be an [[Multimedia_Files#ANI|ani]] with 2 frames; 1st is bank 1 not selected, 2nd is bank 1 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Secondary Filename:====

Designates the file to use for selected secondary bank for ships with two secondary banks.

Needs to be an [[Multimedia_Files#ANI|ani]] with 3 frames; 1st is no banks selected, 2nd is bank 1 selected, 3rd is bank 2 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Triple Secondary Filename:====

Designates the file to use for selected secondary bank for ships with two secondary banks.

Needs to be an [[Multimedia_Files#ANI|ani]] with 4 frames; 1st is no banks selected, 2nd is bank 1 selected, 3rd is bank 2 selected, 4th is bank 3 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Single Primary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Primary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Single Secondary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Secondary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Triple Secondary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Hidden By Comms Menu:====
{{Table3615|
Defines whether the messages gauge may be drawn at the same time as the wingman comms menu.
*Syntax: '''Boolean'''
*Default Value: '''false''' (messages are not visible while the comms menu is open)
Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]}}

====Bottom Background Offset:====
{{Table3615|
Defines the vertical pixel offset added to the position of the bottom background frame.
*Syntax: '''Integer''' vertical offset
*Units: Pixels
Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]}}

====Center Text On Gauge X-Position:====
{{Table375|
Sets whether to position the center of the text to the gauge's X-position.
*Syntax '''Boolean'''
*Default Value: '''false''' if the gauge is explicitly given a position, '''true''' otherwise
Used by: [[Hud_gauges.tbl#+Fixed Messages:|+Fixed Messages:]]}}

====Ngon Sides:====
{{Table190|
Defines the number of sides a regular polygon (N-gon) radar has. If defined, the standard radar's edge is drawn as an N-gon, instead of the standard ellipsoid. Blips that are projected outside of the N-gon are snapped to the edge: the blip's angle stays the same but the blip's radius to the center of the plot area is reduced.
*Syntax '''Integer'''
*Default Value: '''0''' A value of 0 means to use the standard ellipsoid radar
*Minimum value: '''3''' (which is a triangle)
Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]}}

====Ngon Offset:====
{{Table190|
Defines the angular offset to apply to the N-gon perimeter. The first vertex is at the 3 o'clock position, positive offsets spin this vertex counter-clockwise, negative offsets spin this clockwise.
*Syntax '''Float''' (radians)
*Default Value: '''0'''
Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]}}

[[Category:Tables]]

Hud gauges.tbl

2022-10-14T15:01:57Z

Z64555: /* N-gon Offset: */

{{SCP table}}
{{TableVersionGit|2016-09-14|f9bc01c}}
{{Tables}}
The '''hud_gauges.tbl''' is used for modifying the elements of the HUD. Not all gauges can be modified. However, custom gauges may be added to mimic their behavior (such as the wingman status display).

HUD Elements in FS2 are called Gauges, and each gauge has various options to customize appearance and, in some cases, their behavior as well.

This table is one of the [[Modular Tables]] and can be extended with xxx-hdg.tbm

==HUD Configurations==
The following entries are used on the HUD system, but have not been grouped with any particular gauge.

===$Load Retail Configuration:===
Optional. If yes, any gauge missing from the HUD gauge definitions below will be loaded using the retail defaults.

If no, any missing (default) gauge will prompt an error.

*Syntax: '''Boolean'''

===$Color:===
Optional. Sets the default HUD color for all gauges.

*Syntax: ('''Integer''' Red, '''Integer''' Green, '''Integer''' Blue)
*Valid Values: all values from 0 to 255

===$Font:===
Optional. Sets the font type to use for the HUD. This can either be a string or a number. A string references a font with a specific name while a number references a font with a specific index in the fonts table. The number option is deprecated and is only there for backwards-compatibility. Use the name if possible.

*Syntax: '''String''' or '''Integer''' font index number
*Valid Values: Any name or font index as defined in [[Fonts.tbl]]

===$Chase View Only:===
{{Table381|
Optional. Sets gauges to be displayed only in Chase View.

*Syntax: '''Boolean'''
*Default Value: '''False'''
}}

===$Max Directives:===
Optional. Sets the default maximum number of directives displayed simultaneously.

*Syntax: '''Integer''' maximum number of directives
*Valid Values: Any positive number
*Default Value: '''5'''

===$Max Escort Ships:===
Optional. Sets the default maximum number of escort ships to be shown in the escort list.

*Syntax: '''Integer'''
*Valid Values: Any positive number
{{Warning|
Entries more than 16 will cause the list to overflow into the weapons list for resolutions lower than 1024x768.}}

===$Length Unit Multiplier:===
Optional. Sets the multiplier to applied to the reported distances. For example, if the multiplier is 0.5, then the distance reported to the player will (or at least should) be 0.5 x actual distance.

*Syntax: '''Float'''
*Valid Values: Any positive number

===$Speed Unit Multiplier:===
Optional. Analogous to [[Hud_gauges.tbl#$Length Unit Multiplier:|$Length Unit Multiplier]], this sets the multiplier to be applied to all speeds reported to the player. For example, if the multiplier is 0.5, the the speed reported to the player will (or at least should) be 0.5 x actual speed.

*Syntax: '''Float'''
*Valid Values: Any positive number
*Default Values:
:'''The value used in $Length Unit Multiplier''', or
:'''1''', if $Length Unit Multiplier is undefined

===$Wireframe Targetbox:===
Optional. Defines the default draw method for the target viewer (a.k.a. targetbox).

*Syntax: '''Integer''' Draw method ID
*Valid Values:
::'''0''' - Standard with full, bright lighting
::'''1''' - Wireframe
::'''2''' - Standard with proper lighting (i.e. lit the same as the actual target)
{{Table3615|
::'''3''' - Untextured with full bright lighting (i.e. drawn with a single flat color)}}

===$Targetbox Shader Effect:===
{{Table3615|
Optional. If set, defines a unique ID for a shader effect to be used when rendering a ship for the targeting box. The ID will be passed to the main shader as in [[Post_processing.tbl##Ship_Effects|#Ship_Effects]], but a table entry for the effect is not needed.

*Syntax: '''Integer'''
*Valid Values: Any positive number
}}

===$Lock Wireframe Mode:===
Optional. If set, prevents targetbox draw method from being changed during the gaming session.
*Syntax: '''Boolean'''

===$Scale Gauges:===
{{Table371|
Optional. If set, all gauges will use this value as the default for scaling individual gauge sizes (i.e. doesn't affect gauges that use Position:, and doesn't affect the values of Offset:. In addition, if "$Load Retail Configuration:" is true then all unspecified retail gauges will use this value.

If not set, defaults to yes.

*Syntax: '''Boolean'''
}}

===$Force Scaling Above:===
{{Table373|
Optional. If gauge scaling is disabled, then gauges will be scaled as though the base resolution were this resolution or the real base resolution, whichever is greater.

Use this to disable scaling at lower resolutions while preventing gauges from getting too small at higher resolutions.

To disable this feature, use '''(-1, -1)'''.

*Syntax: ('''Integer''' width, '''Integer''' height)
}}

===$Reticle Style:===
Optional. Defines which aiming reticle to use.
*Syntax: '''String'''
*Valid Values:
:'''FS1''' - uses '''''reticle1_fs1.ani'''''
:'''FS2''' - uses '''''reticle1.ani'''''

==#Gauge Config==
The following entries define default gauge appearance and behavior. Each gauge has the option of overriding these options.

===$Ship:===
Deprecated and superceded by $Ships in FSO revision 9208. If defined, the following config data will only be used if the player ship is of the supplied ship class. Can be defined multiple times within a #Gauge config group to allow unique HUD configurations per ship class.

If not defined, all following config data will be applied to all ships.

*Syntax: '''String''', ship class name

===$Ships:===
Optional. Can be used to define a list of ships the hud definition that follows will be applied to. Can be defined multiple times within a #Gauge config group to allow unique HUD configurations per ship class.

If not defined, all following config data will be applied to all ships.

*`Syntax: '''( "Class name 1" "Class name 2" )''', ship class names formatted like a flag list.

====$Load Retail Configuration:====
Optional. Overrides the [[Hud_gauges.tbl#$Load Retail Configuration: 1|$Load Retail Configuration]] global option for this ship class.

*Syntax: '''Boolean'''

====$Color:====
Optional. Overrides the [[Hud_gauges.tbl#$Color: 1|$Color]] global option for this ship class.

*Syntax: See [[Hud_gauges.tbl#$Color: 1|$Color]]

====$Font:====
Optional. Overrides the [[Hud_gauges.tbl#$Font: 1|$Font]] global option for this ship class.

*Syntax: See [[Hud_gauges.tbl#$Font: 1|$Font]]

====$Chase View Only:====
{{Table381|
Optional. Overrides the [[Hud_gauges.tbl#$Chase View Only: 1|$Chase View Only]] global option for this ship class.

*Syntax: See [[Hud_gauges.tbl#$Chase View Only: 1|$Chase View Only]]
}}

===$Base:===
Required. Defines the base resolution for this HUD configuration, upon which other gauge options (such as [[Hud_gauges.tbl#Position:|Position:]] / [[Hud_gauges.tbl#Origin:|Origin:]] / [[Hud_gauges.tbl#Offset:|Offset:]]) will use as its coordinate system.

*Syntax: ('''Integer''' width, '''Integer''' height)
*Valid Values: All supported resolutions (?)

===$Scale Gauges:===
{{Table371|
Optional. If set, will configure gauges Scaling behaviour for gauges in this #Gauge Config section. i.e. overriding the default, or the value specified at the top of the file. Individual gauges can override this setting.

*Syntax: '''Boolean'''
}}

===$Force Scaling Above:===
{{Table373|
Optional. If gauge scaling is disabled, then gauges will be scaled as though the base resolution were this resolution or the real base resolution, whichever is greater.

Use this to disable scaling at lower resolutions while preventing gauges from getting too small at higher resolutions.

To disable this feature, use '''(-1, -1)'''.

*Syntax: ('''Integer''' width, '''Integer''' height)
}}

===$Required Aspect:===
Optional. If set, this configuration will only be loaded for the specified aspect ratios.

Used as a filter when there are multiple $Base: resolutions in the table

*Syntax: '''String'''
*Valid Values:
:"Full Screen" (4:3, aspect ratio < 1.5)
:"Wide Screen" (16:9, 16:10, or similar, aspect ratio >= 1.5)

===$Min:===
Optional. Minimum resolution for this config. Any resolution lower than specified will not use this configuration.

Used as a filter when there are multiple $Base: resolutions in the table

*Syntax: ('''Integer''' width, '''Integer''' height)
*Valid Values: All supported resolutions (?)

===$Max:===
Optional. Maximum resolution for this config. Any resolution higher than specified will not use this configuration.

Used as a filter when there are multiple $Base: resolutions in the table

*Syntax: ('''Integer''' width, '''Integer''' height)
*Valid Values: All supported resolutions (?)

===$Gauges:===
Following entries define gauge-specific behavior. For the most part, each gauge has its own overrides that, if not defined, would otherwise use the global values.

Since many gauges have the same configuration options, each gauge entry has a list of valid sub-entries. Unless stated otherwise, these options must be defined in the same order as they are shown, starting from the top and ending at the bottom.

====+Custom:====
Adds a custom gauge type.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Name:|Name:]]
:[[Hud_gauges.tbl#Text:|Text:]]
:[[Hud_gauges.tbl#X Offset:|X Offset:]] (Optional)
:[[Hud_gauges.tbl#Y Offset:|Y Offset:]] (Optional)
:[[Hud_gauges.tbl#Gauge Type:|Gauge Type:]]
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Active by default:|Active by default:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]

{{table381|
====+Scripted Gauge:====
Adds a scripted gauge type.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Name:|Name:]]
}}

====+Messages:====
Adds a gauge that display mission messages.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Max Lines:|Max Lines:]] (Optional)
:[[Hud_gauges.tbl#Max Width:|Max Width:]] (Optional)
:[[Hud_gauges.tbl#Line Height:|Line Height]] (Optional)
:[[Hud_gauges.tbl#Total Lifetime:|Total Lifetime:]] (Optional)
:[[Hud_gauges.tbl#Scroll Time:|Scroll Time]] (Optional)
:[[Hud_gauges.tbl#Step Size:|Step Size:]] (Optional)
:[[Hud_gauges.tbl#Hidden By Comms Menu:|Hidden By Comms Menu:]] (Optional)

====+Training Messages:====
Adds a text box, like the ones seen in the FS1 and FS2 training missions.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}

====+Support:====
Adds a text box that shows the Support ship's status and ETA

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Text Y-offset:|Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Dock Status X-offset:|Dock Status X-offset:]] (Optional)
:[[Hud_gauges.tbl#Dock Time X-offset:|Dock Time X-offset:]] (Optional)

====+Damage:====
Adds a gauge that shows how much damage a target (or the player?) has.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Hull Integrity Offsets:|Hull Integrity Offsets]] (Optional)
:[[Hud_gauges.tbl#Hull Integrity Value X-offset:|Hull Integrity Value X-offset]] (Optional)
:[[Hud_gauges.tbl#Top Background Height:|Top Background Height:]] (Optional)
:[[Hud_gauges.tbl#Subsystem Entry Height:|Subsystem Entry Height:]] (Optional)
:[[Hud_gauges.tbl#Subsystem List Start Offsets:|Subsystem List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Subsystem Entry Value X-offset:|Subsystem Entry Value X-offset:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Offset:|Bottom Background Offset:]] (Optional)

====+Wingman Status:====
Adds a gauge that monitors the status of your wing and squadron.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Left Background Filename:|Left Background Filename:]] (Optional) (needs an animation with one frame)
{{table3615|
:[[Hud_gauges.tbl#First Background Filename:|First Background Filename:]] (Optional) (needs an animation with one frame)}}
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional) (needs an animation with one frame)
:[[Hud_gauges.tbl#Right Background Filename:|Right Background Filename:]] (Optional) (needs an animation with one frame)
{{table3615|
:[[Hud_gauges.tbl#Last Background Filename:|Last Background Filename:]] (Optional) (needs an animation with one frame)}}
:[[Hud_gauges.tbl#Dot Filename:|Dot Filename:]] (Optional) (needs an animation with two frames, 1st is for alive wingmen, 2nd is for dead or missing wingmen)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
{{table373|
[[Hud_gauges.tbl#Fixed Header Position:|Fixed Header Position:]] (Optional)}}
:[[Hud_gauges.tbl#Left Background Width:|Left Background Width:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#First Background Size:|First Background Size:]] (Optional)}}
:[[Hud_gauges.tbl#Entry Width:|Entry Width:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Entry Size:|Entry Size:]] (Optional)
:[[Hud_gauges.tbl#Right Background Offset:|Right Background Offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Offset:|Last Background Offset:]] (Optional)}}
:[[Hud_gauges.tbl#Single Wing Offsets:|Single Wing Offsets:]] (Optional)
:[[Hud_gauges.tbl#Multiple Wing Start Offsets:|Multiple Wing Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Wing Name Offsets:|Wing Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Dot Offsets:|Dot Offsets:]] (Optional)
:[[Hud_gauges.tbl#Expansion Mode:|Expansion Mode:]] (Optional)
{{Table214|
:[[Hud_gauges.tbl#Use Full Wing Names:|Use Full Wing Names:]] (Optional)
:[[Hud_gauges.tbl#Use Expanded Colors:|Use Expanded Colors:]] (Optional)
}}

====+Auto Speed:====
Adds the Auto-Speed mode gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (needs animation with 4 frames, 3rd is without auto-match-speed enabled, 4th is with... and frames 0 & 1 are not used, done this way because retail fs2 uses the same animation file for the auto speed & auto targeting gauges)
:[[Hud_gauges.tbl#Auto Offsets:|Auto Offsets:]] (Optional)
:[[Hud_gauges.tbl#Speed Offsets:|Speed Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#On Text Color:|On Text Color:]] (Optional)
:[[Hud_gauges.tbl#On Text Color:|Off Text Color:]] (Optional)}}

====+Auto Target:====
Adds the Auto-target mode gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (needs animation with 2 frames, 1st is without auto-targeting enabled, 2nd is with)
:[[Hud_gauges.tbl#Auto Offsets:|Auto Offsets:]] (Optional)
:[[Hud_gauges.tbl#Target Offsets:|Target Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#On Text Color:|On Text Color:]] (Optional)
:[[Hud_gauges.tbl#On Text Color:|Off Text Color:]] (Optional)}}

====+Countermeasures:====
Adds a gauge that monitors the amount of remaining countermeasures the player's ship currently has.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (needs an animation with a single frame)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
:[[Hud_gauges.tbl#Value Offsets:|Value Offsets:]] (Optional)

====+Talking Head:====
Adds a video window to display pilot message videos (a.k.a talking heads).

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Animation Offsets:|Animation Offsets:]] (Optional)
:[[Hud_gauges.tbl#Animation Background Size:|Animation Background Size:]] (Deprecated)
{{table373|
:[[Hud_gauges.tbl#Animation Size:|Animation Size:]] (Optional)
}}

====+Directives:====
Adds a gauge that displays all currently active directives (includes current , completed, and failed)

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional) (needs animation with one frame)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional) (needs animation with one frame)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional) (needs animation with one frame)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Background Height:|Top Background Height:]] (Optional)
:[[Hud_gauges.tbl#List Start Offsets:|List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Bottom Background Offset:|Bottom Background Offset:]] (Optional)
:[[Hud_gauges.tbl#Max Line Width:|Max Line Width:]] (Optional)
}}

====+Weapons:====
Adds a weapon status and ammunition gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Primary List Top Background Filename:|Primary List Top Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Primary List Middle Background Filename:|Primary List Middle Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Primary List Bottom Background Filename:|Primary List Bottom Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Secondary List Top Background Filename:|Secondary List Top Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Secondary List Entry Background Filename:|Secondary List Entry Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Secondary List Bottom Background Filename:|Secondary List Bottom Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
::[[Hud_gauges.tbl#Alt Ballistic Offsets:|Alt Ballistic Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Primary Background X-offset:|Top Primary BackgroundX-offset:]] (Optional)
::[[Hud_gauges.tbl#Alt Ballistic X-offset:|Alt Ballistic X-offset:]] (Optional)
:[[Hud_gauges.tbl#Text X-offset:|Text X-offset:]] (Optional)
::[[Hud_gauges.tbl#Alt Ballistic X-offset:|Alt Ballistic X-offset:]] (Optional)
:[[Hud_gauges.tbl#Top Primary Frame Height:|Top Primary Frame Height:]] (Optional)
:[[Hud_gauges.tbl#Top Secondary Frame Height:|Top Secondary Frame Height:]] (Optional)
:[[Hud_gauges.tbl#Primary List Start Y-offset:|Primary List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary List Start Y-offset:|Secondary List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Ammo X-offset:|Primary Weapon Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Link X-offset:|Primary Weapon Link X-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Name X-offset:|Primary Weapon Name X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Ammo X-offset:|Secondary Weapon Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Linked X-offset:|Secondary Weapon Linked X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Name X-offset:|Secondary Weapon Name X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Reload X-offset:|Secondary Weapon Reload X-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Entry Height:|Primary Weapon Entry Height:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Entry Height:|Secondary Weapon Entry Height:]] (Optional)

====+Objective notify:====
Adds a Objective notifier gauge. This gauge alerts the player when receiving a new objective, or when an objective has been completed or failed. Additionally, this gauge alerts the player when entering subspace, and when a Red Alert mission orders are being received (prior to a forced subspace jump).

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Objective Text Y-offset:|Objective Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Objective Value Y-offset:|Objective Value Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Subspace Text Y-offset:|Subspace Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Subspace Value Y-offset:|Subspace Value Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Red Alert Text Y-offset:|Red Alert Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Red Alert Value Y-offset:|Red Alert Value Y-offset:]] (Optional)

====+Squad Message====
Adds the squad message gauge. In FS1 and FS2, this gauge is used to send commands to your squad. (?)

*Valid sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#List Start Offsets:|List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Background Height:|Top Background Height:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Bottom Background Offset|Bottom Background Offset]] (Optional)}}
:[[Hud_gauges.tbl#Command X-offset:|Command X-offset:]] (Optional)
:[[Hud_gauges.tbl#Page Up Offsets:|Page Up Offsets:]] (Optional)
:[[Hud_gauges.tbl#Page Down Offsets:|Page Down Offsets:]] (Optional)

====+Lag:====
Adds a Lag gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]

====+Mini Target Shields:====
Adds a mini Target shields gauge. In FS1 and FS2, the Mini Target Shield gauge is the one right below the center reticle, and shows the hull damage in %

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (animation needs 8 frames; 0->3 are the top, right, bottom & left shield quads; 4->7 are the same except brighter for when the quad is flashing from being hit)
:[[Hud_gauges.tbl#3 Digit Hull Offsets:|3 Digit Hull Offsets:]] (Optional)
:[[Hud_gauges.tbl#2 Digit Hull Offsets:|2 Digit Hull Offsets:]] (Optional)
:[[Hud_gauges.tbl#1 Digit Hull Offsets:|1 Digit Hull Offsets:]] (Optional)

====+Player Shields:====
Adds a gauge that shows the shield and hull status icon of the player's craft or ship.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)

====+Target Shields:====
Adds a gauge that shows the shield and hull status icon of the targeted craft or ship.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)

====+Escort View:====
Adds an escort monitor/view gauge. This gauge monitors the status of all ships assigned to the player to escort.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height]] (Optional)
:[[Hud_gauges.tbl#Entry Stagger Width:|Entry Stagger Width:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Bottom Background Offset:|Bottom Background Offset:]] (Optional)}}
:[[Hud_gauges.tbl#Header Text:|Header Text]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#List Start Offsets:|List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Hull X-offset:|Hull X-offset]] (Optional)
:[[Hud_gauges.tbl#Name X-offset:|Name X-offset]] (Optional)
:[[Hud_gauges.tbl#Status X-offset:|Status X-offset]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Ship Name Max Width:|Ship Name Max Width:]] (Optional)}}
{{table373|
:[[Hud_gauges.tbl#Right-Align Ship Names:|Right-Align Ship Names:]] (Optional)}}

====+Mission Time:====
Adds a gauge that displays the current mission time.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
:[[Hud_gauges.tbl#Value Offsets:|Value Offsets:]] (Optional)

====+ETS Retail:====
{{Table3613|
Draws the three other ETS gauges as a single gauge. Will automatically rearrange itself (like retail) if shields or other systems are missing.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
{{Table3613|
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)
:[[Hud_gauges.tbl#Gauge Offset:|Gauge Offset:]] (Optional)

}}

====+ETS Weapons:====
Adds a gauge that displays the energy transfer rate for the energy weapons.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)

====+ETS Engines:====
Adds a gauge that displays the energy transfer rate for the afterburner/engines.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)

====+ETS Shields:====
Adds a gauge that displays the energy transfer rate for the shields.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)

====+Target Monitor:====
Adds a target monitor gauge that shows the targeted ship's relative orientation and hull strength, among other things.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Monitor Filename:|Monitor Filename:]] (Optional) (needs animation with 2 frames, 1st is the background for the target, 2nd is the border; rendered last)
{{table3615|
:[[Hud_gauges.tbl#Monitor Alpha Mask Filename:|Monitor Alpha Mask Filename:]] (Optional) (needs animation with a single frame)}}
:[[Hud_gauges.tbl#Integrity Bar Filename:|Integrity Bar Filename:]] (Optional) (needs animation with 2 frames, 1st is a zero/dark filled bar, 2nd is a max/bright filled bar)
:[[Hud_gauges.tbl#Viewport Offsets:|Viewport Offsets:]] (Optional)
:[[Hud_gauges.tbl#Viewport Size:|Viewport Size:]] (Optional)
:[[Hud_gauges.tbl#Integrity Bar Offsets:|Integrity Bar Offsets:]] (Optional)
:[[Hud_gauges.tbl#Integrity Bar Foreground Clip Height:|Integrity Bar Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Status Offsets:|Status Offsets:]] (Optional)
:[[Hud_gauges.tbl#Name Offsets:|Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Class Offsets:|Class Offsets:]] (Optional)
:[[Hud_gauges.tbl#Distance Offsets:|Distance Offsets:]] (Optional)
:[[Hud_gauges.tbl#Speed Offsets:|Speed Offsets:]] (Optional)
:[[Hud_gauges.tbl#Hull Offsets:|Hull Offsets:]] (Optional)
:[[Hud_gauges.tbl#Cargo Contents Offsets:|Cargo Contents Offsets:]] (Optional)
:[[Hud_gauges.tbl#Cargo Scan Start Offsets:|Cargo Scan Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Cargo Scan Size:|Cargo Scan Size:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Subsystem Name Offsets:|Subsystem Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Subsystem Integrity Offsets:|Subsystem Integrity Offsets:]] (Optional)
:[[Hud_gauges.tbl#Disabled Status Offsets:|Disabled Status Offsets:]] (Optional)
:[[Hud_gauges.tbl#Desaturate:|Desaturate:]] (Optional)
}}

====+Extra Target Data:====
Adds a gauge that displays "extra" target data, such as its current orders and docking status.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs an animation with 1 frame)
:[[Hud_gauges.tbl#Bracket Offsets:|Bracket Offsets:]] (Optional)
:[[Hud_gauges.tbl#Dock Offsets:|Dock Offsets:]] (Optional)
{{table373|
:[[Hud_gauges.tbl#Dock Max Width:|Dock Max Width:]] (Optional)}}
:[[Hud_gauges.tbl#Order Offsets:|Order Offsets:]] (Optional)
{{table373|
:[[Hud_gauges.tbl#Order Max Width:|Order Max Width:]] (Optional)}}
:[[Hud_gauges.tbl#Time Offsets:|Time Offsets:]] (Optional)

====+Radar:====
Adds a standard radar gauge

*Valid Sub-entries:
{{table190|
:[[Hud_gauges.tbl#N-gon Sides:|Ngon Sides:]] (Optional)
:[[Hud_gauges.tbl#N-gon Sides:|Ngon Offset:]] (Optional)
}}
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs animation with 2 frames, only the 2nd frame is used)
{{table373|
:[[Hud_gauges.tbl#Radar Center Offsets:|Radar Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Radar Size:|Radar Size:]] (Optional)
}}
:[[Hud_gauges.tbl#Infinity Distance Offsets:|Infinity Distance Offsets]] (Optional)
:[[Hud_gauges.tbl#Long Distance Offsets:|Long Distance Offsets:]] (Optional)
:[[Hud_gauges.tbl#Short Distance Offsets:|Short Distance Offsets:]] (Optional)

====+Radar Orb:====
Adds a 3D orb radar gauge

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs animation with 2 frames, only the 2nd frame is used)
{{table373|
:[[Hud_gauges.tbl#Radar Center Offsets:|Radar Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Radar Size:|Radar Size:]] (Optional)
}}
:[[Hud_gauges.tbl#Infinity Distance Offsets:|Infinity Distance Offsets]] (Optional)
:[[Hud_gauges.tbl#Long Distance Offsets:|Long Distance Offsets:]] (Optional)
:[[Hud_gauges.tbl#Short Distance Offsets:|Short Distance Offsets:]] (Optional)

====+Radar BSG:====
Adds a BSG style radar (a.k.a DRADIS).

:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Size:|Size:]] (Optional)
:[[Hud_gauges.tbl#XY Disc Filename:|XY Disc Filename:]] (Optional)
:[[Hud_gauges.tbl#XZ YZ Disc Filename:|XZ YZ Disc Filename:]] (Optional)
:[[Hud_gauges.tbl#Sweep Disc Filename:|Sweep Disc Filename:]] (Optional)
:[[Hud_gauges.tbl#Default Contact Filename:|Default Contact Filename:]] (Optional)
:[[Hud_gauges.tbl#Unknown Contact Filename:|Unknown Contact Filename:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]]
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]]
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Loop Volume:|Loop Volume:]] (Optional)
:[[Hud_gauges.tbl#Minimum Beep Delay:|Minimum Beep Delay]] (Optional)

====+Afterburner Energy:====
Adds a gauge that shows the remaining afterburner energy. Note that it only supports a vertical fill.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs animation with 2 frames, the 1st is the bar lit for zero energy, the 2nd is the bar lit for max energy)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)

====+Weapon Energy:====
Adds a gauge that shows the remaining weapon energy. Note that it only supports a vertical fill.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs an animation with 4 frames, the 3rd is the bar lit for zero energy, the 2nd is the bar lit for max energy, frames 1 & 2 are not used)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Text Alignment:|Text Alignment:]] (Optional)
:[[Hud_gauges.tbl#Always Show Text:|Always Show Text:]] (Optional)
:[[Hud_gauges.tbl#Text Follows:|Text Follows:]] (Optional)
:[[Hud_gauges.tbl#Show Ballistic Ammo:|Show Ballistic Ammo:]] (Optional)
:[[Hud_gauges.tbl#Armed Guns List Offsets:|Armed Guns List Offsets:]] (Optional)
:[[Hud_gauges.tbl#Armed Guns List Alignment:|Armed Guns List Alignment:]] (Optional)
:[[Hud_gauges.tbl#Armed Guns List Entry Height:|Armed Guns List Entry Height:]] (Optional)
}}

====+Text Warnings:====
Adds a gauge that warns the player (current warnings are EMP, Launch, Evaded, Collision, Blast & Engine Wash).

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)

====+Center Reticle:====
Adds a "custom" center reticle.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Firepoint display:|Firepoint display:]] (Optional)
:[[Hud_gauges.tbl#Firepoint size:|Firepoint size:]] (Optional)
:[[Hud_gauges.tbl#Firepoint X coordinate multiplier:|Firepoint X coordinate multiplier:]] (Optional)
:[[Hud_gauges.tbl#Firepoint Y coordinate multiplier:|Firepoint Y coordinate multiplier:]] (Optional)

====+Throttle:====
Adds a gauge that shows the current throttle position.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Bottom Y-offset:|Foreground Clip Bottom Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Width:|Foreground Clip Width:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Afterburner Clip Height:|Afterburner Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Show Background:|Show Background:]] (Optional)
:[[Hud_gauges.tbl#Max Speed Label Offsets:|Max Speed Label Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Show Max Speed Label:|Show Max Speed Label:]] (Optional)}}
:[[Hud_gauges.tbl#Min Speed Label Offsets:|Min Speed Label Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Show Min Speed Label:|Show Min Speed Label:]] (Optional)}}
:[[Hud_gauges.tbl#Orbit Center Offsets:|Orbit Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Orbit Radius:|Orbit Radius:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Current Speed Offsets:|Current Speed Offsets:]] (Optional)
:[[Hud_gauges.tbl#Target Speed Offsets:|Target Speed Offsets:]] (Optional)
:[[Hud_gauges.tbl#Show Percentage:|Show Percentage:]] (Optional)
:[[Hud_gauges.tbl#Glide Status Offsets:|Glide Status Offsets:]] (Optional)
:[[Hud_gauges.tbl#Match Speed Status Offsets:|Match Speed Status Offsets:]] (Optional)
}}

====+Threat Indicator:====
Adds a gauge that indicates when a lock-on has been achieved by an attacker, and if the player is being shot at.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Arc Filename:|Arc Filename:]] (Optional)
:[[Hud_gauges.tbl#Dumbfire Filename:|Dumbfire Filename:]] (Optional)
:[[Hud_gauges.tbl#Lock Filename:|Lock Filename:]] (Optional)
:[[Hud_gauges.tbl#Dumbfire Offsets:|Dumbfire Offsets:]] (Optional)
:[[Hud_gauges.tbl#Lock Offsets:|Lock Offsets:]] (Optional)

====+Multiplayer Messages:====
Adds a gauge that displays the multiplayer messages.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}

====+Voice Status:====
Adds a gauge that displays the voice status.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}

====+Ping:====
Adds a gauge that the ping time to the multiplayer server.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}

====+Supernova:====
Adds a gauge that warns the player of an impending supernova shock wave.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}

====+Lock Indicator:====
Adds a Lock Indicator gauge.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Lock Filename:|Lock Filename:]] (Optional)
:[[Hud_gauges.tbl#Locked Filename:|Locked Filename:]] (Optional)
:[[Hud_gauges.tbl#Lock Center Offsets:|Lock Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Locked Center Offsets:|Locked Center Offsets:]] (Optional)
{{table224|
:[[Hud_gauges.tbl#Loop Locked Animation:|Loop Locked Animation:]] (Optional)
:[[Hud_gauges.tbl#Blink Locked Animation:|Blink Locked Animation:]] (Optional)}}

====+Offscreen Indicator:====
Adds an Offscreen Indicator.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}

====+Target Brackets:====
Adds a Target Bracket gauge. This is drawn around current target(s) and talkers.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Dot Filename:|Dot Filename:]] (Optional)

====+Hostile Triangle:====
Adds a gauge that points to the nearest attacker, if it is off-screen and is not currently targeted.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)
:[[Hud_gauges.tbl#Triangle Base:|Triangle Base:]] (Optional)
:[[Hud_gauges.tbl#Triangle Height:|Triangle Height:]] (Optional)

====+Target Triangle:====
Adds a gauge that points to the targeted craft, if it is currently off-screen.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)
:[[Hud_gauges.tbl#Triangle Base:|Triangle Base:]] (Optional)
:[[Hud_gauges.tbl#Triangle Height:|Triangle Height:]] (Optional)

====+Missile Triangles:====
Adds a gauge that is used during attempting to lock onto a target when using an aspect seeking missile.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)
:[[Hud_gauges.tbl#Triangle Base:|Triangle Base:]] (Optional)
:[[Hud_gauges.tbl#Triangle Height:|Triangle Height:]] (Optional)

====+Lead Indicator:====
Adds a gauge that leads (is in front) of the target. Aim your crosshairs at this indicator to increase probability of hitting the target.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
::Frame #0: Secondaries lead indicator (Dumbfire)
::Frame #1: Secondaries lead indicator (Homing)
::Frame #2: Primaries lead indicator
:[[Hud_gauges.tbl#Center Offsets:|Center Offsets:]] (Optional)

====+Orientation Tee:====
Adds a gauge that indicates the targeted craft's orientation in relation to the player's craft.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)

====+Lead Sight:====
Adds a gauge that lags (is behind) the target. Indicates where your shots will end up relative to the target's position. To score a hit, this gauge should be over the target. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
::Frame #0 is used for secondaries
::* If only one frame is found in the file, then it is used for primaries instead
::Frame #1 is used for primaries

====+Kills:====
Adds a gauge that keeps track of how many kills the player has scored during a mission.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
:[[Hud_gauges.tbl#Value Offsets:|Value Offsets:]] (Optional)

====+Weapon Linking:====
Adds a gauge that indicates the selected weapons and their firing rates.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Arc Filename:|Arc Filename:]] (Optional)
:[[Hud_gauges.tbl#Single Primary Filename:|Single Primary Filename:]] (Optional)
:[[Hud_gauges.tbl#Double Primary Filename:|Double Primary Filename:]] (Optional)
:[[Hud_gauges.tbl#Single Secondary Filename:|Single Secondary Filename:]] (Optional)
:[[Hud_gauges.tbl#Double Secondary Filename:|Double Secondary Filename:]] (Optional)
:[[Hud_gauges.tbl#Triple Secondary Filename:|Triple Secondary Filename:]] (Optional)
:[[Hud_gauges.tbl#Single Primary Offsets:|Single Primary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Double Primary Offsets:|Double Primary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Single Secondary Offsets:|Single Secondary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Double Secondary Offsets:|Double Secondary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Triple Secondary Offsets:|Triple Secondary Offsets:]] (Optional)

====+Fixed Messages:====

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
{{table375|
:[[Hud_gauges.tbl#Center Text On Gauge X-Position:|Center Text On Gauge X-Position:]] (Optional)
}}

====+Flight Path Marker:====
{{table3615|
Adds a gauge that indicates the direction where your ship is traveling. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Center Offsets:|Center Offsets:]] (Optional)}}

====+Warhead Count:====
{{table3615|
Displays the name of the current secondary weapon. Tallies the ammo left. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs an animation with a single frame)
:[[Hud_gauges.tbl#Name Offsets:|Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Count Offsets:|Count Offsets:]] (Optional)
:[[Hud_gauges.tbl#Icon Width:|Icon Width:]] (Optional)
:[[Hud_gauges.tbl#Icon Height:|Icon Height:]] (Optional)
:[[Hud_gauges.tbl#Max Icons:|Max Icons:]] (Optional)
:[[Hud_gauges.tbl#Max Columns:|Max Columns:]] (Optional)
:[[Hud_gauges.tbl#Name Alignment:|Name Alignment:]] (Optional)
}}

====+Hardpoints:====
{{table3615|
Draws a silhouette of the player's ship and mounted weapons. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Size:|Size:]] (Optional)
:[[Hud_gauges.tbl#Line Width:|Line Width:]] (Optional)
:[[Hud_gauges.tbl#View Direction:|View Direction:]] (Optional)
:[[Hud_gauges.tbl#Show Primary Weapons:|Show Primary Weapons:]] (Optional)
:[[Hud_gauges.tbl#Show Secondary Weapons:|Show Secondary Weapons:]] (Optional)
}}

====+Primary Weapons:====
{{table3615|
Like the Weapons gauge but simpler. Only displays primary weapons. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Header Text:|Header Text:]] (Optional)
:[[Hud_gauges.tbl#First Background Filename:|First Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#First Background Height:|First Background Height:]] (Optional)
:[[Hud_gauges.tbl#First Background X-offset:|First Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Entry Background Height:|Entry Background Height:]] (Optional)
:[[Hud_gauges.tbl#Entry Background X-offset:|Entry Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Filename:|Last Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Last Background X-offset:|Last Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Y-offset:|Last Background Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
:[[Hud_gauges.tbl#List Start Y-offset:|List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Ammo X-offset:|Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Link X-offset:|Link X-offset:]] (Optional)
:[[Hud_gauges.tbl#Name X-offset:|Name X-offset:]] (Optional)
}}

====+Secondary Weapons:====
{{table3615|
Like the Weapons gauge but simpler. Only displays secondary weapons. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Header Text:|Header Text:]] (Optional)
:[[Hud_gauges.tbl#First Background Filename:|First Background Filename:]] (Optional)
:[[Hud_gauges.tbl#First Background Height:|First Background Height:]] (Optional)
:[[Hud_gauges.tbl#First Background X-offset:|First Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Height:|Entry Background Height:]] (Optional)
:[[Hud_gauges.tbl#Entry Background X-offset:|Entry Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Filename:|Last Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Last Background X-offset:|Last Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Y-offset:|Last Background Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
:[[Hud_gauges.tbl#List Start Y-offset:|List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Ammo X-offset:|Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Link X-offset:|Link X-offset:]] (Optional)
:[[Hud_gauges.tbl#Name X-offset:|Name X-offset:]] (Optional)
:[[Hud_gauges.tbl#Unlink X-offset:|Unlink X-offset:]] (Optional)
:[[Hud_gauges.tbl#Reload X-offset:|Reload X-offset:]] (Optional)
}}

===$End Gauges===
The Gauges section must end with $End Gauges. No Exceptions.

==#End==
The very last entry in the Hud_gauges.tbl must be #End. No Exceptions.

----
----

==Gauge Configuration Options==
Since a vast majority of gauges share the same entries, the configuration options for each gauge have been grouped here for formatting consistency.

====Position:====
Defines the screen coordinates for the upper left corner of this gauge.

*Syntax: '''Integer''' horizontal pixel, '''Integer''' vertical pixel position

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Training Messages:|+Training Messages:]], [[Hud_gauges.tbl#+Support:|+Support]] (and many others)

====Scale Gauge:====

{{table371|
Define if a gauge size will scale or not.

If false then gauge bitmaps will always show at their original size which may result in gauges being very small at high resolutions.

If true then gauge bitmaps will scale in proportion to the current resolution vs the base HUD resolution in use. This may result in gauges becoming blurry at non-base resolutions.

Defaults to yes/true.

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: '''Boolean''' scale_this_gauge

Used by: most gauges
}}

====Force Scaling Above:====

{{Table373|
Optional. If scaling is disabled for this gauge, then it will be scaled as though the base resolution were this resolution or the real base resolution, whichever is greater.

Use this to disable scaling at lower resolutions while preventing gauges from getting too small at higher resolutions.

To disable this feature, use '''(-1, -1)'''.

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: ('''Integer''' width, '''Integer''' height)

Used by: most gauges
}}

====Origin:====

{{table371|
Define gauge position as a ratio of the screen size (base or current, it doesn't matter).

Requires [[Hud_gauges.tbl#Offset:|Offset:]]

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: '''Float''' horizontal ratio 0.0 - 1.0, '''Float''' vertical ratio 0.0 - 1.0

Used by: most gauges
}}

====Offset:====

{{table371|
Define gauge offset from [[Hud_gauges.tbl#Origin:|Origin:]] in base resolution pixels

Requires [[Hud_gauges.tbl#Origin:|Origin:]]

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: '''Integer''' horizontal pixel offset from Origin:, '''Integer''' vertical pixel offset from Origin:

Used by: most gauges
}}

====Cockpit Target:====
The cockpit display that this gauge will be rendered to. Refers to the +Display Name: defined in [[ships.tbl#$Cockpit Display:|$Cockpit Display:]].

*Syntax: '''String''' String defined in +Display Name: in [[ships.tbl#$Cockpit Display:|$Cockpit Display:]]

=====Canvas Size:=====
The off-screen canvas this gauge will be rendered to before being interpolated into the actual cockpit display. The smaller this number is, the larger the gauge will appear on the cockpit display.

*Syntax: '''Integer''' width, '''Integer''' height

=====Display Offset:=====
The position of the canvas on the cockpit display texture

*Syntax: '''Integer''' width, '''Integer''' height

=====Display Size:=====
The interpolated size on the cockpit display texture that the canvas will be rendered to.

*Syntax: '''Integer''' width, '''Integer''' height

====Color:====
Optional. Overrides both previous color settings ([[Hud_gauges.tbl#$Color: 1|$Color]] HUD option and [[Hud_gauges#$Color: 2|$Color]] ship class option) for this particular gauge.

*Syntax: See [[Hud_gauges.tbl#$Color: 1|$Color:]]

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Font:====
Optional. Overrides both previous font settings ([[Hud_gauges.tbl#$Font: 1|$Font]] HUD option and [[Hud_gauges#$Font: 2|$Font]] ship class option) for this particular gauge.

*Syntax: See [[Hud_gauges.tbl#$Font: 1|$Font:]]

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Training Messages:|+Training Messages:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Name:====
Defines the name of this custom gauge.

*Syntax: '''String'''
*Max Length: 32 characters

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Text:====
Default text to be displayed. Can be altered using the hud-set-message, hud-set-text and hud-set-directive sexps.

*Syntax: '''String'''
*Max Length: 32 characters

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====X Offset:====
Optional. Defines the horizontal pixel offset (from the gauge's origin as defined by [[Hud_gauges.tbl#Position:|Position:]]) that the Text will be displayed.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Y Offset:====
Optional. Defines the vertical pixel offset (from the gauge's origin defined by [[Hud_gauges.tbl#Position:|Position:]]) that the Text will be displayed.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Gauge Type:====
Defines the type of gauge this is.

*Syntax: '''String'''
*Valid Values: Any one of the possible [[gauge types]].

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Slew:====
Optional. Determines whether or not this gauge is affected by afterburner shaking or similar effects. If set to "true", the gauge will not follow the player's head movements when using TrackIR/padlock. i.e. should be used for gauges like the gunsight/leadsight.

*Syntax: '''Boolean'''

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Max Lines:====
Optional. Specifies the maximum number of message lines that are displayed.

*Syntax: '''Integer'''
*Default Value: 3

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Max Width:====
Optional. Determines how long each message line may be.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Line Height:====
Optional. Determines the distance between line origins. (i.g. for a 12pt Font, there are needs to be at least 12 pixels between the bottom of one line and the next, otherwise the text will overlap each)

*Syntax: '''Integer'''
*Units: Pixels
*Default Value: 9

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Total Lifetime:====
Optional. Determines the maximum time the message gauge will be displayed from the time a new message is received.

*Syntax: '''Integer'''
*Units: milliseconds
*Default Value: 14000 (14 seconds)

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Scroll Time:====
Optional. Determines the time for the messages to scroll up one step.( See [[Hud_gauges.tbl#Step Size:|Step Size:]] )

*Syntax: '''Integer'''
*Units: milliseconds
*Default Value: 30

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Step Size:====
Optional. Determines how many pixels to shift message lines during scrolling. Messages will be shifted up by this amount until they are on the next line (as defined by [[Hud_gauges.tbl#Line Height:|Line Height:]])

*Syntax: '''Integer'''
*Units: Pixels
*Default Value: 3

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Active by default:====
Optional. Determines whether or not this gauge is always active, or only available after being activated via sexp.

*Syntax: '''Boolean'''

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Filename:====
Designates the [[Multimedia_Files#ANI|.ANI]] or [[Multimedia_Files#EFF|.EFF]] used for this gauge's background graphic.
{{Note| All HUD .ANI's must have the same color palette as the retail .ANI's in order to render properly. (.EFF's do not have this restriction)}}

*Syntax: '''Filename'''
**No filename extension is needed.

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Top Background Filename:====
Optional. Designates which file to use for the top background. (?)

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Damage|+Damage]]

====Bottom Background Filename:====
Optional. Designates which file to use for the Bottom background (?)

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Damage|+Damage]]

====Left Background Filename:====
Optional. Designates which file to use for the Left side of gauge.

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====First Background Filename:====
Optional. Alias for [[Hud_gauges.tbl#Left Background Filename:|Left Background Filename:]]

====Right Background Filename:====
Optional. Designates which file to use for the Right side of the gauge.

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Last Background Filename:====
Optional. Alias for [[Hud_gauges.tbl#Right Background Filename:|Right Background Filename:]]

====Entry Background Filename:====
Optional. Designates which file to use for the (Wing) Entry section of the gauge (aka the middle sections).

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Damage|+Damage]], [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Primary List Top Background Filename:====
Optional. Designates which file to use for the Primary List Top Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary List Middle Background Filename:====
Optional. Designates which file to use for the Primary List Middle Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary List Bottom Background Filename:====
Optional. Designates which file to use for the Primary List Bottom Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Top Background Filename:====
Optional. Designates which file to use for the Secondary List Top Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Entry Background Filename:====
Optional. Designates which file to use for the Secondary List Entry Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Bottom Background Filename:====
Optional. Designates which file to use for the Secondary List Bottom Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Alt Ballistic Filename:====
Optional. Designates an alternate file to be used for ballistic weapons.

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#Primary List Top Background Filename:|Primary List Top Background Filename]], [[Hud_gauges.tbl#Primary List Middle Background Filename:|Primary List Middle Background Filename]], [[Hud_gauges.tbl#Primary List Bottom Background Filename:|Primary List Bottom Background Filename]], [[Hud_gauges.tbl#Secondary List Top Background Filename:|Secondary List Top Background Filename]], [[Hud_gauges.tbl#Secondary List Entry Background Filename:|Secondary List Entry Background Filename]], [[Hud_gauges.tbl#Secondary List Bottom Background Filename:|Secondary List Bottom Background Filename]]

====Dot Filename:====
Optional. Designates which file to use for the wingman graphic (a.k.a. the Dot)

*Syntax: '''Filename'''

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Header Offsets:====
Optional. Designates the offset from the gauge's upper left corner for headers of various gauges

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels
*Valid Sub-entries:
:Weapons:
::[[Hud_gauges.tbl#Alt Ballistic Offsets:|Alt Ballistic Offsets:]]

Used by: [[Hud_gauges.tbl#+Support:|+Support:]], [[Hud_gauges.tbl#+Damage|+Damage:]], [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Fixed Header Position:====
Optional. If set, the header text will not change position when the gauge changes size.

*Syntax: '''Boolean'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Text Y-offset:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship Text. (?)

*Syntax: '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]]

====Text Offsets:====
Optional. Defines the screen position offsets for the text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: :[[Hud_gauges.tbl#+Countermeasures:|+Countermeasures:]]

====Value Offsets:====
Optional. Defines the screen position offsets for the value label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: :[[Hud_gauges.tbl#+Countermeasures:|+Countermeasures:]]

====Dock Status X-offset:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship's dock status. (?)

*Syntax: '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]]

====Dock Time X-offset:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship's dock time. (?)

*Syntax: '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]]

====Hull Integrity Offsets:====
Optional. Designates the offsets from the gauge's upper left corner for the for the Damage gauge Hull integrity textbox(?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Hull Integrity Value X-offset:====
Optional. Designates the offsets from the hull integrity textbox's upper left corner for the hull integrity value. (?)

*Syntax: '''Integer''' horizontal offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Top Background Height:====
Optional. Designates the height of the Top background (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Left Background Width:====
Optional. Defines the width of the Left Background.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Entry Width:====
Optional. Defines the width of the Entry Background (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Subsystem Entry Height:====
Optional. Designates the height of the Subsystem entry (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Subsystem List Start Offsets:====
Optional. Designates the offsets from the gauge's upper left corner for the for the start of the Subsytem List (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Subsystem Entry Value X-offset:====
Optional. Designates the horizontal offset from the Subsystem List's position (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Single Wing Offsets:====
Optional. Designates the offset from the gauge's upper left corner for a single wing (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Multiple Wing Start Offsets:====
Optional. Designates the offset from the gauge's upper left corner for multiple wings (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Wing Name Offsets:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship header (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Dot Offsets:====
Optional. Designates the offset from the gauge's upper left corner for the All wingman status icons.
*Syntax:
:'''Integer''' x, '''Integer''' y ;; Wingman 1
:'''Integer''' x, '''Integer''' y ;; Wingman 2
:'''Integer''' x, '''Integer''' y ;; Wingman 3
:'''Integer''' x, '''Integer''' y ;; Wingman 4
:'''Integer''' x, '''Integer''' y ;; Wingman 5
:'''Integer''' x, '''Integer''' y ;; Wingman 6
*Units: Pixels

{{Warning|
All 6 wingman positions must be defined}}

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Expansion Mode:====
Optional. Denotes which direction (in relation to the player's wing) that the other wings should be appended to the gauge. If enabled, then wingmen dot colors will be

*Syntax: '''Boolean'''
*Default Value: '''False'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Use Full Wing Names:====
{{Table214|
Optional. If enabled the wingmen gauge draws the full wing name and does not alter the capitalization. Default behavior is to draw the first three letters of the wing in all lower-case.

*Syntax: '''Boolean'''
*Default Value: '''False'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]
}}

====Use Expanded Colors:====
{{Table214|
Optional. If enabled the wingmen gauge status dots use red, yellow, or green color to designate wingmen health (green full to greater thon two-thirds, yellow two-thirds to greater than one-third, and red less than or equal to one-third). Default is to use red for less than half health and gauge color otherwise.

*Syntax: '''Boolean'''
*Default Value: '''False'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]
}}

====Auto Offsets:====
Optional. Defines the screen coordinates for the "Auto" text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Auto Speed:|+Auto Speed:]], [[Hud_gagues.tbl#+Auto Target:|+Auto Target:]]

====Speed Offsets:====
Optional. Defines the screen coordinates for the "Speed" text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Auto Speed:|+Auto Speed:]]

====Target Offsets:====
Optional. Defines the screen coordinates for the "Target" text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Auto Target:|+Auto Target:]]

====Animation Offsets:====
Optional. Defines the offsets for the animation graphics.

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Talking Head:|+Talking Head:]]

====Animation Background Size:====
Deprecated. Originally, this set the size of the black box that's drawn behind the animation. Since Git revision 556e9a4 (2015-11-01), it has the same effect as [[Hud_gauges.tbl#Animation Size:|Animation Size:]].

*Syntax: '''Integer''' horizontal size, '''Integer''' vertical size
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Talking Head:|+Talking Head:]]

====Animation Size:====
{{table373|
Optional. Defines the size of the animation. All animations will be scaled to match this size.

*Syntax: '''Integer''' horizontal size, '''Integer''' vertical size
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Talking Head:|+Talking Head:]]
}}

====List Start Offsets:====
Optional. Defines the screen coordinate offsets for the start of the Directives list.

*Syntax: '''Integer''' x, '''Integer''' y
*Units: Pixels

Used by: [[Hud_guages.tbl#+Directives:|+Directives:]]

====Entry Height:====
Optional. Defines the height of each Directive

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_guages.tbl#+Directives:|+Directives:]]

====Alt Ballistic Offsets:====
Opetional. Defines the screen coordinate offsets for headers of ballistic weapons

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Header Offset:|+Header Offset:]]

====Top Primary Background X-offset:====
Optional. Defines the screen coordinate offset for the Top Primary Background

*Syntax: '''Integer'''
*Units: Pixels
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic X-offset:|Alt Ballistic X-offset:]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Text X-offset:====
(Optional) Defines the screen coordinate X-offset for weapon labels

*Syntax: '''Integer'''
*Units: Pixels
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic X-offset:|Alt Ballistic X-offset:]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Alt Ballistic X-offset:====
Optional. Defines the screen coordinate X-offset for ballistic weapons

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#Top Primary Background X-offset:|Top Primary Background X-offset:]], [[Hud_gauges.tbl#Text X-offset:|Text X-offset:]]

====Top Primary Frame Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Top Secondary Frame Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary List Start Y-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Start Y-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Ammo X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Link X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Name X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Ammo X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Linked X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Name X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Reload X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Entry Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Entry Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====3 Digit Hull Offsets:====
Designates the screen position offsets for the hull damage % when it is the 3 digit range (i.e. >= 100%)

*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Mini Target Shields:|+Mini Target Shields:]]

====2 Digit Hull Offsets:====
Designates the screen position offsets for the hull damage % when it is the 2 digit range (i.e. 100% > hull damage% >= 10%)

*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Mini Target Shields:|+Mini Target Shields:]]

====1 Digit Hull Offsets:====
Designates the screen position offsets for the hull damage % when it is the 1 digit range (i.e. 10% > hull damage% >= 0%)

*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Mini Target Shields:|+Mini Target Shields:]]

====Objective Text Y-offset:====
Designates the screen position offset for the Objective label

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Objective Value Y-offset====
Designates the screen position offset for the Objective value

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Subspace Text Y-offset:====
Designates the screen position offset for the Subspace label

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Subspace Value Y-offset====
Designates the screen position offset for the Subspace value (?)

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Red Alert Text Y-offset====
Designates the screen position offset for the Red Alert label

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Red Alert Value Y-offset====
Designates the screen position offset for the Red Alert value (?)

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Command X-offset:====
*Syntax: '''Integer''' x offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Squad Message:|+Squad Message:]]

====Page Up Offsets:====
*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Squad Message:|+Squad Message:]]

====Page Down Offsets:====
*Syntax: '''Integer''' x offset, ''' Integer y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Squad Message:|+Squad Message:]]

====Entry Height:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Entry Stagger Width:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Header Text:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Header Offsets:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====List Start Offsets:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Hull X-offset:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Name X-offset:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Status X-offset:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Ship Name Max Width:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Right-Align Ship Names:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Foreground Clip Height:====

* Sets the height, in pixels, of the gauge.
** For the [[Hud_gauges.tbl#+Throttle|Throttle]], sets the height of the gauge that represents 0% to 100% throttle. The total height of the gauge is the sum of this value and the [[Hud_gauges.tbl#Afterburner Clip Height:|Afterburner Clip Height]] value.
* Syntax: '''Integer'''

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]], [[Hud_gauges.tbl#+ETS Weapons:|+ETS Weapons]], [[Hud_gauges.tbl#+ETS Engines:|+ETS Engines]], [[Hud_gauges.tbl#+ETS Shields:|+ETS Shields]], [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor]], [[Hud_gauges.tbl#+Afterburner Energy|+Afterburner Energy]], [[Hud_gauges.tbl#+Weapon Energy|+Weapon Energy]], [[Hud_gauges.tbl#+Throttle:|+Throttle]]

====Letter Offsets:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Top Offsets:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Bottom Offsets:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Gauge Offset:====
*Distance between the individual weapon/shield/engine ETS gauges that comprise this gauge
*Syntax: '''Integer'''

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Monitor Filename:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Integrity Bar Filename:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Viewport Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Viewport Size:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Integrity Bar Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Integrity Bar Foreground Clip Height:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Status Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Name Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Class Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Speed Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Hull Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Cargo Contents Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Cargo Scan Start Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Cargo Scan Size:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Bracket Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Dock Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Dock Max Width:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Order Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Order Max Width:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Time Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Radar Center Offsets:====
Defines the radar's plot origin as an offset, in pixels, from this gauge's [[Hud_gauges.tbl#Position|Position]] coordinates
*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

====Radar Size:====
Size, in pixels, of the radar plot area.

Syntax: '''Integer''' horizontal size, '''Integer''' vertical size

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

====Infinity Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

Offset to draw the infinity radar range symbol.

====Long Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

Offset to draw the long range radar text (i.e. 10k).

====Short Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

Offset to draw the short range radar text (i.e. 2k).

====Size:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====XY Disc Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====XZ YZ Disc Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Sweep Disc Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Default Contact Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Unknown Contact Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Loop Volume:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG]]

====Minimum Beep Delay:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG]]

====Firepoint display:====
Displays the positions of the gun firepoints on your ship
*Syntax: '''Boolean''', YES or NO

NOTE: The position of the firepoints is calculated from the Eye Point position in the POF. You may encounter weird results if you have no Eye Point defined, but no debug warnings will be raised.

Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Firepoint size:====
Diameter of the gunpoint circles. '''Must be 4 or greater''' in order to work properly.
*Syntax: '''Integer'''

Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Firepoint X coordinate multiplier:====
Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Firepoint Y coordinate multiplier:====
Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Foreground Clip Bottom Y-offset:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Foreground Clip Width:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Afterburner Clip Height:====
* Sets the area of the throttle gauge that represents the Afterburner segment (which is on top of the 0% to 100% area). The total height of the gauge is determined by the sum of this value and [[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]]

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Show Background:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Max Speed Label Offsets:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Min Speed Label Offsets:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Orbit Center Offsets:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Orbit Radius:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Arc Filename:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Needs to be an [[Multimedia_Files#ANI|ani]] with a least 2 frames (but only the 2nd frame is used ?!?!? for threat & weapon linking so far)

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Dumbfire Filename:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Needs to be an [[Multimedia_Files#ANI|ani]] with a least 2 frames. The 1st frame is "no warning", the rest of the frames are cycled through when a warning is active.

Internally FSO also refers to this as the "laser threat warning".

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Lock Filename:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Needs to be an [[Multimedia_Files#ANI|ani]] with a least 2 frames. The 1st frame is "no warning", the rest of the frames are cycled through when a warning is active. Frames cycle twice as fast when a lock has been acquired, compared to when a lock is being acquired.

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Dumbfire Offsets:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Lock Offsets:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Lock Filename:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Locked Filename:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Lock Center Offsets:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Locked Center Offsets:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Loop Locked Animation:====

Controls whether the animation should loop after locking on, like in FS1.

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Blink Locked Animation:====

Controls whether the animation should blink after locking on, like in FS2.

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Radius:====
Defines the distance from the center of the screen to the base of the Hostile Triangle gauge.

*Syntax: '''Integer'''
*Default value:
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Hostile Triangle:|+Hostile Triangle:]]

====Triangle Base:====
Defines the width of the Hostile Triangle's base.

*Syntax: '''Float'''
*Default value:
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Hostile Triangle:|+Hostile Triangle:]]

====Triangle Height:====
Defines the height of the Hostile Triangle.

*Syntax: '''Float'''
Default value:
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Hostile Triangle:|+Hostile Triangle:]]

====Center Offsets:====

Used by: [[Hud_gauges.tbl#+Lead Indicator:|+Lead Indicator:]]

====Single Primary Filename:====
Designates the file to use for primary linking for ships with a single primary bank.

Needs to be an [[Multimedia_Files#ANI|ani]] with 2 frames; 1st is bank 1 not selected (not that this should ever be able to happen), 2nd is bank 1 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Primary Filename:====

Designates the file to use for primary linking for ships with two primary banks.

Needs to be an [[Multimedia_Files#ANI|ani]] with 4 frames:
* Frame 0 is no banks selected
* Frame 1 is 1st bank selected
* Frame 2 is 2nd bank selected
* Frame 3 is both banks selected/linked

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Single Secondary Filename:====

Designates the file to use for selected secondary bank for ships with a single secondary bank.

Needs to be an [[Multimedia_Files#ANI|ani]] with 2 frames; 1st is bank 1 not selected, 2nd is bank 1 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Secondary Filename:====

Designates the file to use for selected secondary bank for ships with two secondary banks.

Needs to be an [[Multimedia_Files#ANI|ani]] with 3 frames; 1st is no banks selected, 2nd is bank 1 selected, 3rd is bank 2 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Triple Secondary Filename:====

Designates the file to use for selected secondary bank for ships with two secondary banks.

Needs to be an [[Multimedia_Files#ANI|ani]] with 4 frames; 1st is no banks selected, 2nd is bank 1 selected, 3rd is bank 2 selected, 4th is bank 3 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Single Primary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Primary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Single Secondary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Secondary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Triple Secondary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Hidden By Comms Menu:====
{{Table3615|
Defines whether the messages gauge may be drawn at the same time as the wingman comms menu.
*Syntax: '''Boolean'''
*Default Value: '''false''' (messages are not visible while the comms menu is open)
Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]}}

====Bottom Background Offset:====
{{Table3615|
Defines the vertical pixel offset added to the position of the bottom background frame.
*Syntax: '''Integer''' vertical offset
*Units: Pixels
Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]}}

====Center Text On Gauge X-Position:====
{{Table375|
Sets whether to position the center of the text to the gauge's X-position.
*Syntax '''Boolean'''
*Default Value: '''false''' if the gauge is explicitly given a position, '''true''' otherwise
Used by: [[Hud_gauges.tbl#+Fixed Messages:|+Fixed Messages:]]}}

====Ngon Sides:====
{{Table190|
Defines the number of sides a regular polygon (N-gon) radar has. If defined, the standard radar's edge is drawn as an N-gon, instead of the standard ellipsoid. Blips that are projected outside of the N-gon are snapped to the edge: the blip's angle stays the same but the blip's radius to the center of the plot area is reduced.
*Syntax '''Integer'''
*Default Value: '''0''' A value of 0 means to use the standard ellipsoid radar
*Minimum value: '''3''' (which is a triangle)
Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]}}

====Ngon Offset:====
{{Table190|
Defines the angular offset to apply to the N-gon perimeter. The first vertex is at the 3 o'clock position, positive offsets spin this vertex counter-clockwise, negative offsets spin this clockwise.
*Syntax '''Float''' (radians)
*Default Value: '''0'''
Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]}}

[[Category:Tables]]

Hud gauges.tbl

2022-10-14T15:01:46Z

Z64555: /* N-gon Sides: */

{{SCP table}}
{{TableVersionGit|2016-09-14|f9bc01c}}
{{Tables}}
The '''hud_gauges.tbl''' is used for modifying the elements of the HUD. Not all gauges can be modified. However, custom gauges may be added to mimic their behavior (such as the wingman status display).

HUD Elements in FS2 are called Gauges, and each gauge has various options to customize appearance and, in some cases, their behavior as well.

This table is one of the [[Modular Tables]] and can be extended with xxx-hdg.tbm

==HUD Configurations==
The following entries are used on the HUD system, but have not been grouped with any particular gauge.

===$Load Retail Configuration:===
Optional. If yes, any gauge missing from the HUD gauge definitions below will be loaded using the retail defaults.

If no, any missing (default) gauge will prompt an error.

*Syntax: '''Boolean'''

===$Color:===
Optional. Sets the default HUD color for all gauges.

*Syntax: ('''Integer''' Red, '''Integer''' Green, '''Integer''' Blue)
*Valid Values: all values from 0 to 255

===$Font:===
Optional. Sets the font type to use for the HUD. This can either be a string or a number. A string references a font with a specific name while a number references a font with a specific index in the fonts table. The number option is deprecated and is only there for backwards-compatibility. Use the name if possible.

*Syntax: '''String''' or '''Integer''' font index number
*Valid Values: Any name or font index as defined in [[Fonts.tbl]]

===$Chase View Only:===
{{Table381|
Optional. Sets gauges to be displayed only in Chase View.

*Syntax: '''Boolean'''
*Default Value: '''False'''
}}

===$Max Directives:===
Optional. Sets the default maximum number of directives displayed simultaneously.

*Syntax: '''Integer''' maximum number of directives
*Valid Values: Any positive number
*Default Value: '''5'''

===$Max Escort Ships:===
Optional. Sets the default maximum number of escort ships to be shown in the escort list.

*Syntax: '''Integer'''
*Valid Values: Any positive number
{{Warning|
Entries more than 16 will cause the list to overflow into the weapons list for resolutions lower than 1024x768.}}

===$Length Unit Multiplier:===
Optional. Sets the multiplier to applied to the reported distances. For example, if the multiplier is 0.5, then the distance reported to the player will (or at least should) be 0.5 x actual distance.

*Syntax: '''Float'''
*Valid Values: Any positive number

===$Speed Unit Multiplier:===
Optional. Analogous to [[Hud_gauges.tbl#$Length Unit Multiplier:|$Length Unit Multiplier]], this sets the multiplier to be applied to all speeds reported to the player. For example, if the multiplier is 0.5, the the speed reported to the player will (or at least should) be 0.5 x actual speed.

*Syntax: '''Float'''
*Valid Values: Any positive number
*Default Values:
:'''The value used in $Length Unit Multiplier''', or
:'''1''', if $Length Unit Multiplier is undefined

===$Wireframe Targetbox:===
Optional. Defines the default draw method for the target viewer (a.k.a. targetbox).

*Syntax: '''Integer''' Draw method ID
*Valid Values:
::'''0''' - Standard with full, bright lighting
::'''1''' - Wireframe
::'''2''' - Standard with proper lighting (i.e. lit the same as the actual target)
{{Table3615|
::'''3''' - Untextured with full bright lighting (i.e. drawn with a single flat color)}}

===$Targetbox Shader Effect:===
{{Table3615|
Optional. If set, defines a unique ID for a shader effect to be used when rendering a ship for the targeting box. The ID will be passed to the main shader as in [[Post_processing.tbl##Ship_Effects|#Ship_Effects]], but a table entry for the effect is not needed.

*Syntax: '''Integer'''
*Valid Values: Any positive number
}}

===$Lock Wireframe Mode:===
Optional. If set, prevents targetbox draw method from being changed during the gaming session.
*Syntax: '''Boolean'''

===$Scale Gauges:===
{{Table371|
Optional. If set, all gauges will use this value as the default for scaling individual gauge sizes (i.e. doesn't affect gauges that use Position:, and doesn't affect the values of Offset:. In addition, if "$Load Retail Configuration:" is true then all unspecified retail gauges will use this value.

If not set, defaults to yes.

*Syntax: '''Boolean'''
}}

===$Force Scaling Above:===
{{Table373|
Optional. If gauge scaling is disabled, then gauges will be scaled as though the base resolution were this resolution or the real base resolution, whichever is greater.

Use this to disable scaling at lower resolutions while preventing gauges from getting too small at higher resolutions.

To disable this feature, use '''(-1, -1)'''.

*Syntax: ('''Integer''' width, '''Integer''' height)
}}

===$Reticle Style:===
Optional. Defines which aiming reticle to use.
*Syntax: '''String'''
*Valid Values:
:'''FS1''' - uses '''''reticle1_fs1.ani'''''
:'''FS2''' - uses '''''reticle1.ani'''''

==#Gauge Config==
The following entries define default gauge appearance and behavior. Each gauge has the option of overriding these options.

===$Ship:===
Deprecated and superceded by $Ships in FSO revision 9208. If defined, the following config data will only be used if the player ship is of the supplied ship class. Can be defined multiple times within a #Gauge config group to allow unique HUD configurations per ship class.

If not defined, all following config data will be applied to all ships.

*Syntax: '''String''', ship class name

===$Ships:===
Optional. Can be used to define a list of ships the hud definition that follows will be applied to. Can be defined multiple times within a #Gauge config group to allow unique HUD configurations per ship class.

If not defined, all following config data will be applied to all ships.

*`Syntax: '''( "Class name 1" "Class name 2" )''', ship class names formatted like a flag list.

====$Load Retail Configuration:====
Optional. Overrides the [[Hud_gauges.tbl#$Load Retail Configuration: 1|$Load Retail Configuration]] global option for this ship class.

*Syntax: '''Boolean'''

====$Color:====
Optional. Overrides the [[Hud_gauges.tbl#$Color: 1|$Color]] global option for this ship class.

*Syntax: See [[Hud_gauges.tbl#$Color: 1|$Color]]

====$Font:====
Optional. Overrides the [[Hud_gauges.tbl#$Font: 1|$Font]] global option for this ship class.

*Syntax: See [[Hud_gauges.tbl#$Font: 1|$Font]]

====$Chase View Only:====
{{Table381|
Optional. Overrides the [[Hud_gauges.tbl#$Chase View Only: 1|$Chase View Only]] global option for this ship class.

*Syntax: See [[Hud_gauges.tbl#$Chase View Only: 1|$Chase View Only]]
}}

===$Base:===
Required. Defines the base resolution for this HUD configuration, upon which other gauge options (such as [[Hud_gauges.tbl#Position:|Position:]] / [[Hud_gauges.tbl#Origin:|Origin:]] / [[Hud_gauges.tbl#Offset:|Offset:]]) will use as its coordinate system.

*Syntax: ('''Integer''' width, '''Integer''' height)
*Valid Values: All supported resolutions (?)

===$Scale Gauges:===
{{Table371|
Optional. If set, will configure gauges Scaling behaviour for gauges in this #Gauge Config section. i.e. overriding the default, or the value specified at the top of the file. Individual gauges can override this setting.

*Syntax: '''Boolean'''
}}

===$Force Scaling Above:===
{{Table373|
Optional. If gauge scaling is disabled, then gauges will be scaled as though the base resolution were this resolution or the real base resolution, whichever is greater.

Use this to disable scaling at lower resolutions while preventing gauges from getting too small at higher resolutions.

To disable this feature, use '''(-1, -1)'''.

*Syntax: ('''Integer''' width, '''Integer''' height)
}}

===$Required Aspect:===
Optional. If set, this configuration will only be loaded for the specified aspect ratios.

Used as a filter when there are multiple $Base: resolutions in the table

*Syntax: '''String'''
*Valid Values:
:"Full Screen" (4:3, aspect ratio < 1.5)
:"Wide Screen" (16:9, 16:10, or similar, aspect ratio >= 1.5)

===$Min:===
Optional. Minimum resolution for this config. Any resolution lower than specified will not use this configuration.

Used as a filter when there are multiple $Base: resolutions in the table

*Syntax: ('''Integer''' width, '''Integer''' height)
*Valid Values: All supported resolutions (?)

===$Max:===
Optional. Maximum resolution for this config. Any resolution higher than specified will not use this configuration.

Used as a filter when there are multiple $Base: resolutions in the table

*Syntax: ('''Integer''' width, '''Integer''' height)
*Valid Values: All supported resolutions (?)

===$Gauges:===
Following entries define gauge-specific behavior. For the most part, each gauge has its own overrides that, if not defined, would otherwise use the global values.

Since many gauges have the same configuration options, each gauge entry has a list of valid sub-entries. Unless stated otherwise, these options must be defined in the same order as they are shown, starting from the top and ending at the bottom.

====+Custom:====
Adds a custom gauge type.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Name:|Name:]]
:[[Hud_gauges.tbl#Text:|Text:]]
:[[Hud_gauges.tbl#X Offset:|X Offset:]] (Optional)
:[[Hud_gauges.tbl#Y Offset:|Y Offset:]] (Optional)
:[[Hud_gauges.tbl#Gauge Type:|Gauge Type:]]
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Active by default:|Active by default:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]

{{table381|
====+Scripted Gauge:====
Adds a scripted gauge type.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Name:|Name:]]
}}

====+Messages:====
Adds a gauge that display mission messages.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Max Lines:|Max Lines:]] (Optional)
:[[Hud_gauges.tbl#Max Width:|Max Width:]] (Optional)
:[[Hud_gauges.tbl#Line Height:|Line Height]] (Optional)
:[[Hud_gauges.tbl#Total Lifetime:|Total Lifetime:]] (Optional)
:[[Hud_gauges.tbl#Scroll Time:|Scroll Time]] (Optional)
:[[Hud_gauges.tbl#Step Size:|Step Size:]] (Optional)
:[[Hud_gauges.tbl#Hidden By Comms Menu:|Hidden By Comms Menu:]] (Optional)

====+Training Messages:====
Adds a text box, like the ones seen in the FS1 and FS2 training missions.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}

====+Support:====
Adds a text box that shows the Support ship's status and ETA

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Text Y-offset:|Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Dock Status X-offset:|Dock Status X-offset:]] (Optional)
:[[Hud_gauges.tbl#Dock Time X-offset:|Dock Time X-offset:]] (Optional)

====+Damage:====
Adds a gauge that shows how much damage a target (or the player?) has.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Hull Integrity Offsets:|Hull Integrity Offsets]] (Optional)
:[[Hud_gauges.tbl#Hull Integrity Value X-offset:|Hull Integrity Value X-offset]] (Optional)
:[[Hud_gauges.tbl#Top Background Height:|Top Background Height:]] (Optional)
:[[Hud_gauges.tbl#Subsystem Entry Height:|Subsystem Entry Height:]] (Optional)
:[[Hud_gauges.tbl#Subsystem List Start Offsets:|Subsystem List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Subsystem Entry Value X-offset:|Subsystem Entry Value X-offset:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Offset:|Bottom Background Offset:]] (Optional)

====+Wingman Status:====
Adds a gauge that monitors the status of your wing and squadron.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Left Background Filename:|Left Background Filename:]] (Optional) (needs an animation with one frame)
{{table3615|
:[[Hud_gauges.tbl#First Background Filename:|First Background Filename:]] (Optional) (needs an animation with one frame)}}
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional) (needs an animation with one frame)
:[[Hud_gauges.tbl#Right Background Filename:|Right Background Filename:]] (Optional) (needs an animation with one frame)
{{table3615|
:[[Hud_gauges.tbl#Last Background Filename:|Last Background Filename:]] (Optional) (needs an animation with one frame)}}
:[[Hud_gauges.tbl#Dot Filename:|Dot Filename:]] (Optional) (needs an animation with two frames, 1st is for alive wingmen, 2nd is for dead or missing wingmen)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
{{table373|
[[Hud_gauges.tbl#Fixed Header Position:|Fixed Header Position:]] (Optional)}}
:[[Hud_gauges.tbl#Left Background Width:|Left Background Width:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#First Background Size:|First Background Size:]] (Optional)}}
:[[Hud_gauges.tbl#Entry Width:|Entry Width:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Entry Size:|Entry Size:]] (Optional)
:[[Hud_gauges.tbl#Right Background Offset:|Right Background Offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Offset:|Last Background Offset:]] (Optional)}}
:[[Hud_gauges.tbl#Single Wing Offsets:|Single Wing Offsets:]] (Optional)
:[[Hud_gauges.tbl#Multiple Wing Start Offsets:|Multiple Wing Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Wing Name Offsets:|Wing Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Dot Offsets:|Dot Offsets:]] (Optional)
:[[Hud_gauges.tbl#Expansion Mode:|Expansion Mode:]] (Optional)
{{Table214|
:[[Hud_gauges.tbl#Use Full Wing Names:|Use Full Wing Names:]] (Optional)
:[[Hud_gauges.tbl#Use Expanded Colors:|Use Expanded Colors:]] (Optional)
}}

====+Auto Speed:====
Adds the Auto-Speed mode gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (needs animation with 4 frames, 3rd is without auto-match-speed enabled, 4th is with... and frames 0 & 1 are not used, done this way because retail fs2 uses the same animation file for the auto speed & auto targeting gauges)
:[[Hud_gauges.tbl#Auto Offsets:|Auto Offsets:]] (Optional)
:[[Hud_gauges.tbl#Speed Offsets:|Speed Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#On Text Color:|On Text Color:]] (Optional)
:[[Hud_gauges.tbl#On Text Color:|Off Text Color:]] (Optional)}}

====+Auto Target:====
Adds the Auto-target mode gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (needs animation with 2 frames, 1st is without auto-targeting enabled, 2nd is with)
:[[Hud_gauges.tbl#Auto Offsets:|Auto Offsets:]] (Optional)
:[[Hud_gauges.tbl#Target Offsets:|Target Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#On Text Color:|On Text Color:]] (Optional)
:[[Hud_gauges.tbl#On Text Color:|Off Text Color:]] (Optional)}}

====+Countermeasures:====
Adds a gauge that monitors the amount of remaining countermeasures the player's ship currently has.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (needs an animation with a single frame)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
:[[Hud_gauges.tbl#Value Offsets:|Value Offsets:]] (Optional)

====+Talking Head:====
Adds a video window to display pilot message videos (a.k.a talking heads).

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Animation Offsets:|Animation Offsets:]] (Optional)
:[[Hud_gauges.tbl#Animation Background Size:|Animation Background Size:]] (Deprecated)
{{table373|
:[[Hud_gauges.tbl#Animation Size:|Animation Size:]] (Optional)
}}

====+Directives:====
Adds a gauge that displays all currently active directives (includes current , completed, and failed)

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional) (needs animation with one frame)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional) (needs animation with one frame)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional) (needs animation with one frame)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Background Height:|Top Background Height:]] (Optional)
:[[Hud_gauges.tbl#List Start Offsets:|List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Bottom Background Offset:|Bottom Background Offset:]] (Optional)
:[[Hud_gauges.tbl#Max Line Width:|Max Line Width:]] (Optional)
}}

====+Weapons:====
Adds a weapon status and ammunition gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Primary List Top Background Filename:|Primary List Top Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Primary List Middle Background Filename:|Primary List Middle Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Primary List Bottom Background Filename:|Primary List Bottom Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Secondary List Top Background Filename:|Secondary List Top Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Secondary List Entry Background Filename:|Secondary List Entry Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Secondary List Bottom Background Filename:|Secondary List Bottom Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
::[[Hud_gauges.tbl#Alt Ballistic Offsets:|Alt Ballistic Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Primary Background X-offset:|Top Primary BackgroundX-offset:]] (Optional)
::[[Hud_gauges.tbl#Alt Ballistic X-offset:|Alt Ballistic X-offset:]] (Optional)
:[[Hud_gauges.tbl#Text X-offset:|Text X-offset:]] (Optional)
::[[Hud_gauges.tbl#Alt Ballistic X-offset:|Alt Ballistic X-offset:]] (Optional)
:[[Hud_gauges.tbl#Top Primary Frame Height:|Top Primary Frame Height:]] (Optional)
:[[Hud_gauges.tbl#Top Secondary Frame Height:|Top Secondary Frame Height:]] (Optional)
:[[Hud_gauges.tbl#Primary List Start Y-offset:|Primary List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary List Start Y-offset:|Secondary List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Ammo X-offset:|Primary Weapon Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Link X-offset:|Primary Weapon Link X-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Name X-offset:|Primary Weapon Name X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Ammo X-offset:|Secondary Weapon Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Linked X-offset:|Secondary Weapon Linked X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Name X-offset:|Secondary Weapon Name X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Reload X-offset:|Secondary Weapon Reload X-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Entry Height:|Primary Weapon Entry Height:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Entry Height:|Secondary Weapon Entry Height:]] (Optional)

====+Objective notify:====
Adds a Objective notifier gauge. This gauge alerts the player when receiving a new objective, or when an objective has been completed or failed. Additionally, this gauge alerts the player when entering subspace, and when a Red Alert mission orders are being received (prior to a forced subspace jump).

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Objective Text Y-offset:|Objective Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Objective Value Y-offset:|Objective Value Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Subspace Text Y-offset:|Subspace Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Subspace Value Y-offset:|Subspace Value Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Red Alert Text Y-offset:|Red Alert Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Red Alert Value Y-offset:|Red Alert Value Y-offset:]] (Optional)

====+Squad Message====
Adds the squad message gauge. In FS1 and FS2, this gauge is used to send commands to your squad. (?)

*Valid sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#List Start Offsets:|List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Background Height:|Top Background Height:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Bottom Background Offset|Bottom Background Offset]] (Optional)}}
:[[Hud_gauges.tbl#Command X-offset:|Command X-offset:]] (Optional)
:[[Hud_gauges.tbl#Page Up Offsets:|Page Up Offsets:]] (Optional)
:[[Hud_gauges.tbl#Page Down Offsets:|Page Down Offsets:]] (Optional)

====+Lag:====
Adds a Lag gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]

====+Mini Target Shields:====
Adds a mini Target shields gauge. In FS1 and FS2, the Mini Target Shield gauge is the one right below the center reticle, and shows the hull damage in %

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (animation needs 8 frames; 0->3 are the top, right, bottom & left shield quads; 4->7 are the same except brighter for when the quad is flashing from being hit)
:[[Hud_gauges.tbl#3 Digit Hull Offsets:|3 Digit Hull Offsets:]] (Optional)
:[[Hud_gauges.tbl#2 Digit Hull Offsets:|2 Digit Hull Offsets:]] (Optional)
:[[Hud_gauges.tbl#1 Digit Hull Offsets:|1 Digit Hull Offsets:]] (Optional)

====+Player Shields:====
Adds a gauge that shows the shield and hull status icon of the player's craft or ship.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)

====+Target Shields:====
Adds a gauge that shows the shield and hull status icon of the targeted craft or ship.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)

====+Escort View:====
Adds an escort monitor/view gauge. This gauge monitors the status of all ships assigned to the player to escort.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height]] (Optional)
:[[Hud_gauges.tbl#Entry Stagger Width:|Entry Stagger Width:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Bottom Background Offset:|Bottom Background Offset:]] (Optional)}}
:[[Hud_gauges.tbl#Header Text:|Header Text]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#List Start Offsets:|List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Hull X-offset:|Hull X-offset]] (Optional)
:[[Hud_gauges.tbl#Name X-offset:|Name X-offset]] (Optional)
:[[Hud_gauges.tbl#Status X-offset:|Status X-offset]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Ship Name Max Width:|Ship Name Max Width:]] (Optional)}}
{{table373|
:[[Hud_gauges.tbl#Right-Align Ship Names:|Right-Align Ship Names:]] (Optional)}}

====+Mission Time:====
Adds a gauge that displays the current mission time.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
:[[Hud_gauges.tbl#Value Offsets:|Value Offsets:]] (Optional)

====+ETS Retail:====
{{Table3613|
Draws the three other ETS gauges as a single gauge. Will automatically rearrange itself (like retail) if shields or other systems are missing.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
{{Table3613|
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)
:[[Hud_gauges.tbl#Gauge Offset:|Gauge Offset:]] (Optional)

}}

====+ETS Weapons:====
Adds a gauge that displays the energy transfer rate for the energy weapons.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)

====+ETS Engines:====
Adds a gauge that displays the energy transfer rate for the afterburner/engines.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)

====+ETS Shields:====
Adds a gauge that displays the energy transfer rate for the shields.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)

====+Target Monitor:====
Adds a target monitor gauge that shows the targeted ship's relative orientation and hull strength, among other things.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Monitor Filename:|Monitor Filename:]] (Optional) (needs animation with 2 frames, 1st is the background for the target, 2nd is the border; rendered last)
{{table3615|
:[[Hud_gauges.tbl#Monitor Alpha Mask Filename:|Monitor Alpha Mask Filename:]] (Optional) (needs animation with a single frame)}}
:[[Hud_gauges.tbl#Integrity Bar Filename:|Integrity Bar Filename:]] (Optional) (needs animation with 2 frames, 1st is a zero/dark filled bar, 2nd is a max/bright filled bar)
:[[Hud_gauges.tbl#Viewport Offsets:|Viewport Offsets:]] (Optional)
:[[Hud_gauges.tbl#Viewport Size:|Viewport Size:]] (Optional)
:[[Hud_gauges.tbl#Integrity Bar Offsets:|Integrity Bar Offsets:]] (Optional)
:[[Hud_gauges.tbl#Integrity Bar Foreground Clip Height:|Integrity Bar Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Status Offsets:|Status Offsets:]] (Optional)
:[[Hud_gauges.tbl#Name Offsets:|Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Class Offsets:|Class Offsets:]] (Optional)
:[[Hud_gauges.tbl#Distance Offsets:|Distance Offsets:]] (Optional)
:[[Hud_gauges.tbl#Speed Offsets:|Speed Offsets:]] (Optional)
:[[Hud_gauges.tbl#Hull Offsets:|Hull Offsets:]] (Optional)
:[[Hud_gauges.tbl#Cargo Contents Offsets:|Cargo Contents Offsets:]] (Optional)
:[[Hud_gauges.tbl#Cargo Scan Start Offsets:|Cargo Scan Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Cargo Scan Size:|Cargo Scan Size:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Subsystem Name Offsets:|Subsystem Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Subsystem Integrity Offsets:|Subsystem Integrity Offsets:]] (Optional)
:[[Hud_gauges.tbl#Disabled Status Offsets:|Disabled Status Offsets:]] (Optional)
:[[Hud_gauges.tbl#Desaturate:|Desaturate:]] (Optional)
}}

====+Extra Target Data:====
Adds a gauge that displays "extra" target data, such as its current orders and docking status.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs an animation with 1 frame)
:[[Hud_gauges.tbl#Bracket Offsets:|Bracket Offsets:]] (Optional)
:[[Hud_gauges.tbl#Dock Offsets:|Dock Offsets:]] (Optional)
{{table373|
:[[Hud_gauges.tbl#Dock Max Width:|Dock Max Width:]] (Optional)}}
:[[Hud_gauges.tbl#Order Offsets:|Order Offsets:]] (Optional)
{{table373|
:[[Hud_gauges.tbl#Order Max Width:|Order Max Width:]] (Optional)}}
:[[Hud_gauges.tbl#Time Offsets:|Time Offsets:]] (Optional)

====+Radar:====
Adds a standard radar gauge

*Valid Sub-entries:
{{table190|
:[[Hud_gauges.tbl#N-gon Sides:|Ngon Sides:]] (Optional)
:[[Hud_gauges.tbl#N-gon Sides:|Ngon Offset:]] (Optional)
}}
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs animation with 2 frames, only the 2nd frame is used)
{{table373|
:[[Hud_gauges.tbl#Radar Center Offsets:|Radar Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Radar Size:|Radar Size:]] (Optional)
}}
:[[Hud_gauges.tbl#Infinity Distance Offsets:|Infinity Distance Offsets]] (Optional)
:[[Hud_gauges.tbl#Long Distance Offsets:|Long Distance Offsets:]] (Optional)
:[[Hud_gauges.tbl#Short Distance Offsets:|Short Distance Offsets:]] (Optional)

====+Radar Orb:====
Adds a 3D orb radar gauge

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs animation with 2 frames, only the 2nd frame is used)
{{table373|
:[[Hud_gauges.tbl#Radar Center Offsets:|Radar Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Radar Size:|Radar Size:]] (Optional)
}}
:[[Hud_gauges.tbl#Infinity Distance Offsets:|Infinity Distance Offsets]] (Optional)
:[[Hud_gauges.tbl#Long Distance Offsets:|Long Distance Offsets:]] (Optional)
:[[Hud_gauges.tbl#Short Distance Offsets:|Short Distance Offsets:]] (Optional)

====+Radar BSG:====
Adds a BSG style radar (a.k.a DRADIS).

:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Size:|Size:]] (Optional)
:[[Hud_gauges.tbl#XY Disc Filename:|XY Disc Filename:]] (Optional)
:[[Hud_gauges.tbl#XZ YZ Disc Filename:|XZ YZ Disc Filename:]] (Optional)
:[[Hud_gauges.tbl#Sweep Disc Filename:|Sweep Disc Filename:]] (Optional)
:[[Hud_gauges.tbl#Default Contact Filename:|Default Contact Filename:]] (Optional)
:[[Hud_gauges.tbl#Unknown Contact Filename:|Unknown Contact Filename:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]]
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]]
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Loop Volume:|Loop Volume:]] (Optional)
:[[Hud_gauges.tbl#Minimum Beep Delay:|Minimum Beep Delay]] (Optional)

====+Afterburner Energy:====
Adds a gauge that shows the remaining afterburner energy. Note that it only supports a vertical fill.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs animation with 2 frames, the 1st is the bar lit for zero energy, the 2nd is the bar lit for max energy)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)

====+Weapon Energy:====
Adds a gauge that shows the remaining weapon energy. Note that it only supports a vertical fill.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs an animation with 4 frames, the 3rd is the bar lit for zero energy, the 2nd is the bar lit for max energy, frames 1 & 2 are not used)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Text Alignment:|Text Alignment:]] (Optional)
:[[Hud_gauges.tbl#Always Show Text:|Always Show Text:]] (Optional)
:[[Hud_gauges.tbl#Text Follows:|Text Follows:]] (Optional)
:[[Hud_gauges.tbl#Show Ballistic Ammo:|Show Ballistic Ammo:]] (Optional)
:[[Hud_gauges.tbl#Armed Guns List Offsets:|Armed Guns List Offsets:]] (Optional)
:[[Hud_gauges.tbl#Armed Guns List Alignment:|Armed Guns List Alignment:]] (Optional)
:[[Hud_gauges.tbl#Armed Guns List Entry Height:|Armed Guns List Entry Height:]] (Optional)
}}

====+Text Warnings:====
Adds a gauge that warns the player (current warnings are EMP, Launch, Evaded, Collision, Blast & Engine Wash).

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)

====+Center Reticle:====
Adds a "custom" center reticle.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Firepoint display:|Firepoint display:]] (Optional)
:[[Hud_gauges.tbl#Firepoint size:|Firepoint size:]] (Optional)
:[[Hud_gauges.tbl#Firepoint X coordinate multiplier:|Firepoint X coordinate multiplier:]] (Optional)
:[[Hud_gauges.tbl#Firepoint Y coordinate multiplier:|Firepoint Y coordinate multiplier:]] (Optional)

====+Throttle:====
Adds a gauge that shows the current throttle position.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Bottom Y-offset:|Foreground Clip Bottom Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Width:|Foreground Clip Width:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Afterburner Clip Height:|Afterburner Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Show Background:|Show Background:]] (Optional)
:[[Hud_gauges.tbl#Max Speed Label Offsets:|Max Speed Label Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Show Max Speed Label:|Show Max Speed Label:]] (Optional)}}
:[[Hud_gauges.tbl#Min Speed Label Offsets:|Min Speed Label Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Show Min Speed Label:|Show Min Speed Label:]] (Optional)}}
:[[Hud_gauges.tbl#Orbit Center Offsets:|Orbit Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Orbit Radius:|Orbit Radius:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Current Speed Offsets:|Current Speed Offsets:]] (Optional)
:[[Hud_gauges.tbl#Target Speed Offsets:|Target Speed Offsets:]] (Optional)
:[[Hud_gauges.tbl#Show Percentage:|Show Percentage:]] (Optional)
:[[Hud_gauges.tbl#Glide Status Offsets:|Glide Status Offsets:]] (Optional)
:[[Hud_gauges.tbl#Match Speed Status Offsets:|Match Speed Status Offsets:]] (Optional)
}}

====+Threat Indicator:====
Adds a gauge that indicates when a lock-on has been achieved by an attacker, and if the player is being shot at.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Arc Filename:|Arc Filename:]] (Optional)
:[[Hud_gauges.tbl#Dumbfire Filename:|Dumbfire Filename:]] (Optional)
:[[Hud_gauges.tbl#Lock Filename:|Lock Filename:]] (Optional)
:[[Hud_gauges.tbl#Dumbfire Offsets:|Dumbfire Offsets:]] (Optional)
:[[Hud_gauges.tbl#Lock Offsets:|Lock Offsets:]] (Optional)

====+Multiplayer Messages:====
Adds a gauge that displays the multiplayer messages.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}

====+Voice Status:====
Adds a gauge that displays the voice status.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}

====+Ping:====
Adds a gauge that the ping time to the multiplayer server.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}

====+Supernova:====
Adds a gauge that warns the player of an impending supernova shock wave.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}

====+Lock Indicator:====
Adds a Lock Indicator gauge.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Lock Filename:|Lock Filename:]] (Optional)
:[[Hud_gauges.tbl#Locked Filename:|Locked Filename:]] (Optional)
:[[Hud_gauges.tbl#Lock Center Offsets:|Lock Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Locked Center Offsets:|Locked Center Offsets:]] (Optional)
{{table224|
:[[Hud_gauges.tbl#Loop Locked Animation:|Loop Locked Animation:]] (Optional)
:[[Hud_gauges.tbl#Blink Locked Animation:|Blink Locked Animation:]] (Optional)}}

====+Offscreen Indicator:====
Adds an Offscreen Indicator.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}

====+Target Brackets:====
Adds a Target Bracket gauge. This is drawn around current target(s) and talkers.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Dot Filename:|Dot Filename:]] (Optional)

====+Hostile Triangle:====
Adds a gauge that points to the nearest attacker, if it is off-screen and is not currently targeted.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)
:[[Hud_gauges.tbl#Triangle Base:|Triangle Base:]] (Optional)
:[[Hud_gauges.tbl#Triangle Height:|Triangle Height:]] (Optional)

====+Target Triangle:====
Adds a gauge that points to the targeted craft, if it is currently off-screen.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)
:[[Hud_gauges.tbl#Triangle Base:|Triangle Base:]] (Optional)
:[[Hud_gauges.tbl#Triangle Height:|Triangle Height:]] (Optional)

====+Missile Triangles:====
Adds a gauge that is used during attempting to lock onto a target when using an aspect seeking missile.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)
:[[Hud_gauges.tbl#Triangle Base:|Triangle Base:]] (Optional)
:[[Hud_gauges.tbl#Triangle Height:|Triangle Height:]] (Optional)

====+Lead Indicator:====
Adds a gauge that leads (is in front) of the target. Aim your crosshairs at this indicator to increase probability of hitting the target.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
::Frame #0: Secondaries lead indicator (Dumbfire)
::Frame #1: Secondaries lead indicator (Homing)
::Frame #2: Primaries lead indicator
:[[Hud_gauges.tbl#Center Offsets:|Center Offsets:]] (Optional)

====+Orientation Tee:====
Adds a gauge that indicates the targeted craft's orientation in relation to the player's craft.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)

====+Lead Sight:====
Adds a gauge that lags (is behind) the target. Indicates where your shots will end up relative to the target's position. To score a hit, this gauge should be over the target. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
::Frame #0 is used for secondaries
::* If only one frame is found in the file, then it is used for primaries instead
::Frame #1 is used for primaries

====+Kills:====
Adds a gauge that keeps track of how many kills the player has scored during a mission.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
:[[Hud_gauges.tbl#Value Offsets:|Value Offsets:]] (Optional)

====+Weapon Linking:====
Adds a gauge that indicates the selected weapons and their firing rates.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Arc Filename:|Arc Filename:]] (Optional)
:[[Hud_gauges.tbl#Single Primary Filename:|Single Primary Filename:]] (Optional)
:[[Hud_gauges.tbl#Double Primary Filename:|Double Primary Filename:]] (Optional)
:[[Hud_gauges.tbl#Single Secondary Filename:|Single Secondary Filename:]] (Optional)
:[[Hud_gauges.tbl#Double Secondary Filename:|Double Secondary Filename:]] (Optional)
:[[Hud_gauges.tbl#Triple Secondary Filename:|Triple Secondary Filename:]] (Optional)
:[[Hud_gauges.tbl#Single Primary Offsets:|Single Primary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Double Primary Offsets:|Double Primary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Single Secondary Offsets:|Single Secondary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Double Secondary Offsets:|Double Secondary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Triple Secondary Offsets:|Triple Secondary Offsets:]] (Optional)

====+Fixed Messages:====

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
{{table375|
:[[Hud_gauges.tbl#Center Text On Gauge X-Position:|Center Text On Gauge X-Position:]] (Optional)
}}

====+Flight Path Marker:====
{{table3615|
Adds a gauge that indicates the direction where your ship is traveling. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Center Offsets:|Center Offsets:]] (Optional)}}

====+Warhead Count:====
{{table3615|
Displays the name of the current secondary weapon. Tallies the ammo left. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs an animation with a single frame)
:[[Hud_gauges.tbl#Name Offsets:|Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Count Offsets:|Count Offsets:]] (Optional)
:[[Hud_gauges.tbl#Icon Width:|Icon Width:]] (Optional)
:[[Hud_gauges.tbl#Icon Height:|Icon Height:]] (Optional)
:[[Hud_gauges.tbl#Max Icons:|Max Icons:]] (Optional)
:[[Hud_gauges.tbl#Max Columns:|Max Columns:]] (Optional)
:[[Hud_gauges.tbl#Name Alignment:|Name Alignment:]] (Optional)
}}

====+Hardpoints:====
{{table3615|
Draws a silhouette of the player's ship and mounted weapons. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Size:|Size:]] (Optional)
:[[Hud_gauges.tbl#Line Width:|Line Width:]] (Optional)
:[[Hud_gauges.tbl#View Direction:|View Direction:]] (Optional)
:[[Hud_gauges.tbl#Show Primary Weapons:|Show Primary Weapons:]] (Optional)
:[[Hud_gauges.tbl#Show Secondary Weapons:|Show Secondary Weapons:]] (Optional)
}}

====+Primary Weapons:====
{{table3615|
Like the Weapons gauge but simpler. Only displays primary weapons. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Header Text:|Header Text:]] (Optional)
:[[Hud_gauges.tbl#First Background Filename:|First Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#First Background Height:|First Background Height:]] (Optional)
:[[Hud_gauges.tbl#First Background X-offset:|First Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Entry Background Height:|Entry Background Height:]] (Optional)
:[[Hud_gauges.tbl#Entry Background X-offset:|Entry Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Filename:|Last Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Last Background X-offset:|Last Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Y-offset:|Last Background Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
:[[Hud_gauges.tbl#List Start Y-offset:|List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Ammo X-offset:|Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Link X-offset:|Link X-offset:]] (Optional)
:[[Hud_gauges.tbl#Name X-offset:|Name X-offset:]] (Optional)
}}

====+Secondary Weapons:====
{{table3615|
Like the Weapons gauge but simpler. Only displays secondary weapons. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Header Text:|Header Text:]] (Optional)
:[[Hud_gauges.tbl#First Background Filename:|First Background Filename:]] (Optional)
:[[Hud_gauges.tbl#First Background Height:|First Background Height:]] (Optional)
:[[Hud_gauges.tbl#First Background X-offset:|First Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Height:|Entry Background Height:]] (Optional)
:[[Hud_gauges.tbl#Entry Background X-offset:|Entry Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Filename:|Last Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Last Background X-offset:|Last Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Y-offset:|Last Background Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
:[[Hud_gauges.tbl#List Start Y-offset:|List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Ammo X-offset:|Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Link X-offset:|Link X-offset:]] (Optional)
:[[Hud_gauges.tbl#Name X-offset:|Name X-offset:]] (Optional)
:[[Hud_gauges.tbl#Unlink X-offset:|Unlink X-offset:]] (Optional)
:[[Hud_gauges.tbl#Reload X-offset:|Reload X-offset:]] (Optional)
}}

===$End Gauges===
The Gauges section must end with $End Gauges. No Exceptions.

==#End==
The very last entry in the Hud_gauges.tbl must be #End. No Exceptions.

----
----

==Gauge Configuration Options==
Since a vast majority of gauges share the same entries, the configuration options for each gauge have been grouped here for formatting consistency.

====Position:====
Defines the screen coordinates for the upper left corner of this gauge.

*Syntax: '''Integer''' horizontal pixel, '''Integer''' vertical pixel position

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Training Messages:|+Training Messages:]], [[Hud_gauges.tbl#+Support:|+Support]] (and many others)

====Scale Gauge:====

{{table371|
Define if a gauge size will scale or not.

If false then gauge bitmaps will always show at their original size which may result in gauges being very small at high resolutions.

If true then gauge bitmaps will scale in proportion to the current resolution vs the base HUD resolution in use. This may result in gauges becoming blurry at non-base resolutions.

Defaults to yes/true.

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: '''Boolean''' scale_this_gauge

Used by: most gauges
}}

====Force Scaling Above:====

{{Table373|
Optional. If scaling is disabled for this gauge, then it will be scaled as though the base resolution were this resolution or the real base resolution, whichever is greater.

Use this to disable scaling at lower resolutions while preventing gauges from getting too small at higher resolutions.

To disable this feature, use '''(-1, -1)'''.

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: ('''Integer''' width, '''Integer''' height)

Used by: most gauges
}}

====Origin:====

{{table371|
Define gauge position as a ratio of the screen size (base or current, it doesn't matter).

Requires [[Hud_gauges.tbl#Offset:|Offset:]]

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: '''Float''' horizontal ratio 0.0 - 1.0, '''Float''' vertical ratio 0.0 - 1.0

Used by: most gauges
}}

====Offset:====

{{table371|
Define gauge offset from [[Hud_gauges.tbl#Origin:|Origin:]] in base resolution pixels

Requires [[Hud_gauges.tbl#Origin:|Origin:]]

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: '''Integer''' horizontal pixel offset from Origin:, '''Integer''' vertical pixel offset from Origin:

Used by: most gauges
}}

====Cockpit Target:====
The cockpit display that this gauge will be rendered to. Refers to the +Display Name: defined in [[ships.tbl#$Cockpit Display:|$Cockpit Display:]].

*Syntax: '''String''' String defined in +Display Name: in [[ships.tbl#$Cockpit Display:|$Cockpit Display:]]

=====Canvas Size:=====
The off-screen canvas this gauge will be rendered to before being interpolated into the actual cockpit display. The smaller this number is, the larger the gauge will appear on the cockpit display.

*Syntax: '''Integer''' width, '''Integer''' height

=====Display Offset:=====
The position of the canvas on the cockpit display texture

*Syntax: '''Integer''' width, '''Integer''' height

=====Display Size:=====
The interpolated size on the cockpit display texture that the canvas will be rendered to.

*Syntax: '''Integer''' width, '''Integer''' height

====Color:====
Optional. Overrides both previous color settings ([[Hud_gauges.tbl#$Color: 1|$Color]] HUD option and [[Hud_gauges#$Color: 2|$Color]] ship class option) for this particular gauge.

*Syntax: See [[Hud_gauges.tbl#$Color: 1|$Color:]]

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Font:====
Optional. Overrides both previous font settings ([[Hud_gauges.tbl#$Font: 1|$Font]] HUD option and [[Hud_gauges#$Font: 2|$Font]] ship class option) for this particular gauge.

*Syntax: See [[Hud_gauges.tbl#$Font: 1|$Font:]]

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Training Messages:|+Training Messages:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Name:====
Defines the name of this custom gauge.

*Syntax: '''String'''
*Max Length: 32 characters

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Text:====
Default text to be displayed. Can be altered using the hud-set-message, hud-set-text and hud-set-directive sexps.

*Syntax: '''String'''
*Max Length: 32 characters

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====X Offset:====
Optional. Defines the horizontal pixel offset (from the gauge's origin as defined by [[Hud_gauges.tbl#Position:|Position:]]) that the Text will be displayed.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Y Offset:====
Optional. Defines the vertical pixel offset (from the gauge's origin defined by [[Hud_gauges.tbl#Position:|Position:]]) that the Text will be displayed.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Gauge Type:====
Defines the type of gauge this is.

*Syntax: '''String'''
*Valid Values: Any one of the possible [[gauge types]].

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Slew:====
Optional. Determines whether or not this gauge is affected by afterburner shaking or similar effects. If set to "true", the gauge will not follow the player's head movements when using TrackIR/padlock. i.e. should be used for gauges like the gunsight/leadsight.

*Syntax: '''Boolean'''

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Max Lines:====
Optional. Specifies the maximum number of message lines that are displayed.

*Syntax: '''Integer'''
*Default Value: 3

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Max Width:====
Optional. Determines how long each message line may be.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Line Height:====
Optional. Determines the distance between line origins. (i.g. for a 12pt Font, there are needs to be at least 12 pixels between the bottom of one line and the next, otherwise the text will overlap each)

*Syntax: '''Integer'''
*Units: Pixels
*Default Value: 9

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Total Lifetime:====
Optional. Determines the maximum time the message gauge will be displayed from the time a new message is received.

*Syntax: '''Integer'''
*Units: milliseconds
*Default Value: 14000 (14 seconds)

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Scroll Time:====
Optional. Determines the time for the messages to scroll up one step.( See [[Hud_gauges.tbl#Step Size:|Step Size:]] )

*Syntax: '''Integer'''
*Units: milliseconds
*Default Value: 30

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Step Size:====
Optional. Determines how many pixels to shift message lines during scrolling. Messages will be shifted up by this amount until they are on the next line (as defined by [[Hud_gauges.tbl#Line Height:|Line Height:]])

*Syntax: '''Integer'''
*Units: Pixels
*Default Value: 3

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Active by default:====
Optional. Determines whether or not this gauge is always active, or only available after being activated via sexp.

*Syntax: '''Boolean'''

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Filename:====
Designates the [[Multimedia_Files#ANI|.ANI]] or [[Multimedia_Files#EFF|.EFF]] used for this gauge's background graphic.
{{Note| All HUD .ANI's must have the same color palette as the retail .ANI's in order to render properly. (.EFF's do not have this restriction)}}

*Syntax: '''Filename'''
**No filename extension is needed.

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Top Background Filename:====
Optional. Designates which file to use for the top background. (?)

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Damage|+Damage]]

====Bottom Background Filename:====
Optional. Designates which file to use for the Bottom background (?)

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Damage|+Damage]]

====Left Background Filename:====
Optional. Designates which file to use for the Left side of gauge.

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====First Background Filename:====
Optional. Alias for [[Hud_gauges.tbl#Left Background Filename:|Left Background Filename:]]

====Right Background Filename:====
Optional. Designates which file to use for the Right side of the gauge.

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Last Background Filename:====
Optional. Alias for [[Hud_gauges.tbl#Right Background Filename:|Right Background Filename:]]

====Entry Background Filename:====
Optional. Designates which file to use for the (Wing) Entry section of the gauge (aka the middle sections).

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Damage|+Damage]], [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Primary List Top Background Filename:====
Optional. Designates which file to use for the Primary List Top Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary List Middle Background Filename:====
Optional. Designates which file to use for the Primary List Middle Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary List Bottom Background Filename:====
Optional. Designates which file to use for the Primary List Bottom Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Top Background Filename:====
Optional. Designates which file to use for the Secondary List Top Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Entry Background Filename:====
Optional. Designates which file to use for the Secondary List Entry Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Bottom Background Filename:====
Optional. Designates which file to use for the Secondary List Bottom Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Alt Ballistic Filename:====
Optional. Designates an alternate file to be used for ballistic weapons.

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#Primary List Top Background Filename:|Primary List Top Background Filename]], [[Hud_gauges.tbl#Primary List Middle Background Filename:|Primary List Middle Background Filename]], [[Hud_gauges.tbl#Primary List Bottom Background Filename:|Primary List Bottom Background Filename]], [[Hud_gauges.tbl#Secondary List Top Background Filename:|Secondary List Top Background Filename]], [[Hud_gauges.tbl#Secondary List Entry Background Filename:|Secondary List Entry Background Filename]], [[Hud_gauges.tbl#Secondary List Bottom Background Filename:|Secondary List Bottom Background Filename]]

====Dot Filename:====
Optional. Designates which file to use for the wingman graphic (a.k.a. the Dot)

*Syntax: '''Filename'''

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Header Offsets:====
Optional. Designates the offset from the gauge's upper left corner for headers of various gauges

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels
*Valid Sub-entries:
:Weapons:
::[[Hud_gauges.tbl#Alt Ballistic Offsets:|Alt Ballistic Offsets:]]

Used by: [[Hud_gauges.tbl#+Support:|+Support:]], [[Hud_gauges.tbl#+Damage|+Damage:]], [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Fixed Header Position:====
Optional. If set, the header text will not change position when the gauge changes size.

*Syntax: '''Boolean'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Text Y-offset:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship Text. (?)

*Syntax: '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]]

====Text Offsets:====
Optional. Defines the screen position offsets for the text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: :[[Hud_gauges.tbl#+Countermeasures:|+Countermeasures:]]

====Value Offsets:====
Optional. Defines the screen position offsets for the value label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: :[[Hud_gauges.tbl#+Countermeasures:|+Countermeasures:]]

====Dock Status X-offset:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship's dock status. (?)

*Syntax: '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]]

====Dock Time X-offset:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship's dock time. (?)

*Syntax: '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]]

====Hull Integrity Offsets:====
Optional. Designates the offsets from the gauge's upper left corner for the for the Damage gauge Hull integrity textbox(?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Hull Integrity Value X-offset:====
Optional. Designates the offsets from the hull integrity textbox's upper left corner for the hull integrity value. (?)

*Syntax: '''Integer''' horizontal offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Top Background Height:====
Optional. Designates the height of the Top background (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Left Background Width:====
Optional. Defines the width of the Left Background.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Entry Width:====
Optional. Defines the width of the Entry Background (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Subsystem Entry Height:====
Optional. Designates the height of the Subsystem entry (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Subsystem List Start Offsets:====
Optional. Designates the offsets from the gauge's upper left corner for the for the start of the Subsytem List (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Subsystem Entry Value X-offset:====
Optional. Designates the horizontal offset from the Subsystem List's position (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Single Wing Offsets:====
Optional. Designates the offset from the gauge's upper left corner for a single wing (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Multiple Wing Start Offsets:====
Optional. Designates the offset from the gauge's upper left corner for multiple wings (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Wing Name Offsets:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship header (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Dot Offsets:====
Optional. Designates the offset from the gauge's upper left corner for the All wingman status icons.
*Syntax:
:'''Integer''' x, '''Integer''' y ;; Wingman 1
:'''Integer''' x, '''Integer''' y ;; Wingman 2
:'''Integer''' x, '''Integer''' y ;; Wingman 3
:'''Integer''' x, '''Integer''' y ;; Wingman 4
:'''Integer''' x, '''Integer''' y ;; Wingman 5
:'''Integer''' x, '''Integer''' y ;; Wingman 6
*Units: Pixels

{{Warning|
All 6 wingman positions must be defined}}

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Expansion Mode:====
Optional. Denotes which direction (in relation to the player's wing) that the other wings should be appended to the gauge. If enabled, then wingmen dot colors will be

*Syntax: '''Boolean'''
*Default Value: '''False'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Use Full Wing Names:====
{{Table214|
Optional. If enabled the wingmen gauge draws the full wing name and does not alter the capitalization. Default behavior is to draw the first three letters of the wing in all lower-case.

*Syntax: '''Boolean'''
*Default Value: '''False'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]
}}

====Use Expanded Colors:====
{{Table214|
Optional. If enabled the wingmen gauge status dots use red, yellow, or green color to designate wingmen health (green full to greater thon two-thirds, yellow two-thirds to greater than one-third, and red less than or equal to one-third). Default is to use red for less than half health and gauge color otherwise.

*Syntax: '''Boolean'''
*Default Value: '''False'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]
}}

====Auto Offsets:====
Optional. Defines the screen coordinates for the "Auto" text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Auto Speed:|+Auto Speed:]], [[Hud_gagues.tbl#+Auto Target:|+Auto Target:]]

====Speed Offsets:====
Optional. Defines the screen coordinates for the "Speed" text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Auto Speed:|+Auto Speed:]]

====Target Offsets:====
Optional. Defines the screen coordinates for the "Target" text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Auto Target:|+Auto Target:]]

====Animation Offsets:====
Optional. Defines the offsets for the animation graphics.

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Talking Head:|+Talking Head:]]

====Animation Background Size:====
Deprecated. Originally, this set the size of the black box that's drawn behind the animation. Since Git revision 556e9a4 (2015-11-01), it has the same effect as [[Hud_gauges.tbl#Animation Size:|Animation Size:]].

*Syntax: '''Integer''' horizontal size, '''Integer''' vertical size
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Talking Head:|+Talking Head:]]

====Animation Size:====
{{table373|
Optional. Defines the size of the animation. All animations will be scaled to match this size.

*Syntax: '''Integer''' horizontal size, '''Integer''' vertical size
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Talking Head:|+Talking Head:]]
}}

====List Start Offsets:====
Optional. Defines the screen coordinate offsets for the start of the Directives list.

*Syntax: '''Integer''' x, '''Integer''' y
*Units: Pixels

Used by: [[Hud_guages.tbl#+Directives:|+Directives:]]

====Entry Height:====
Optional. Defines the height of each Directive

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_guages.tbl#+Directives:|+Directives:]]

====Alt Ballistic Offsets:====
Opetional. Defines the screen coordinate offsets for headers of ballistic weapons

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Header Offset:|+Header Offset:]]

====Top Primary Background X-offset:====
Optional. Defines the screen coordinate offset for the Top Primary Background

*Syntax: '''Integer'''
*Units: Pixels
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic X-offset:|Alt Ballistic X-offset:]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Text X-offset:====
(Optional) Defines the screen coordinate X-offset for weapon labels

*Syntax: '''Integer'''
*Units: Pixels
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic X-offset:|Alt Ballistic X-offset:]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Alt Ballistic X-offset:====
Optional. Defines the screen coordinate X-offset for ballistic weapons

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#Top Primary Background X-offset:|Top Primary Background X-offset:]], [[Hud_gauges.tbl#Text X-offset:|Text X-offset:]]

====Top Primary Frame Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Top Secondary Frame Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary List Start Y-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Start Y-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Ammo X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Link X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Name X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Ammo X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Linked X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Name X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Reload X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Entry Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Entry Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====3 Digit Hull Offsets:====
Designates the screen position offsets for the hull damage % when it is the 3 digit range (i.e. >= 100%)

*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Mini Target Shields:|+Mini Target Shields:]]

====2 Digit Hull Offsets:====
Designates the screen position offsets for the hull damage % when it is the 2 digit range (i.e. 100% > hull damage% >= 10%)

*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Mini Target Shields:|+Mini Target Shields:]]

====1 Digit Hull Offsets:====
Designates the screen position offsets for the hull damage % when it is the 1 digit range (i.e. 10% > hull damage% >= 0%)

*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Mini Target Shields:|+Mini Target Shields:]]

====Objective Text Y-offset:====
Designates the screen position offset for the Objective label

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Objective Value Y-offset====
Designates the screen position offset for the Objective value

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Subspace Text Y-offset:====
Designates the screen position offset for the Subspace label

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Subspace Value Y-offset====
Designates the screen position offset for the Subspace value (?)

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Red Alert Text Y-offset====
Designates the screen position offset for the Red Alert label

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Red Alert Value Y-offset====
Designates the screen position offset for the Red Alert value (?)

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Command X-offset:====
*Syntax: '''Integer''' x offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Squad Message:|+Squad Message:]]

====Page Up Offsets:====
*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Squad Message:|+Squad Message:]]

====Page Down Offsets:====
*Syntax: '''Integer''' x offset, ''' Integer y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Squad Message:|+Squad Message:]]

====Entry Height:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Entry Stagger Width:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Header Text:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Header Offsets:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====List Start Offsets:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Hull X-offset:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Name X-offset:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Status X-offset:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Ship Name Max Width:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Right-Align Ship Names:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Foreground Clip Height:====

* Sets the height, in pixels, of the gauge.
** For the [[Hud_gauges.tbl#+Throttle|Throttle]], sets the height of the gauge that represents 0% to 100% throttle. The total height of the gauge is the sum of this value and the [[Hud_gauges.tbl#Afterburner Clip Height:|Afterburner Clip Height]] value.
* Syntax: '''Integer'''

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]], [[Hud_gauges.tbl#+ETS Weapons:|+ETS Weapons]], [[Hud_gauges.tbl#+ETS Engines:|+ETS Engines]], [[Hud_gauges.tbl#+ETS Shields:|+ETS Shields]], [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor]], [[Hud_gauges.tbl#+Afterburner Energy|+Afterburner Energy]], [[Hud_gauges.tbl#+Weapon Energy|+Weapon Energy]], [[Hud_gauges.tbl#+Throttle:|+Throttle]]

====Letter Offsets:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Top Offsets:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Bottom Offsets:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Gauge Offset:====
*Distance between the individual weapon/shield/engine ETS gauges that comprise this gauge
*Syntax: '''Integer'''

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Monitor Filename:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Integrity Bar Filename:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Viewport Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Viewport Size:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Integrity Bar Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Integrity Bar Foreground Clip Height:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Status Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Name Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Class Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Speed Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Hull Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Cargo Contents Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Cargo Scan Start Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Cargo Scan Size:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Bracket Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Dock Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Dock Max Width:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Order Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Order Max Width:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Time Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Radar Center Offsets:====
Defines the radar's plot origin as an offset, in pixels, from this gauge's [[Hud_gauges.tbl#Position|Position]] coordinates
*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

====Radar Size:====
Size, in pixels, of the radar plot area.

Syntax: '''Integer''' horizontal size, '''Integer''' vertical size

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

====Infinity Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

Offset to draw the infinity radar range symbol.

====Long Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

Offset to draw the long range radar text (i.e. 10k).

====Short Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

Offset to draw the short range radar text (i.e. 2k).

====Size:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====XY Disc Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====XZ YZ Disc Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Sweep Disc Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Default Contact Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Unknown Contact Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Loop Volume:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG]]

====Minimum Beep Delay:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG]]

====Firepoint display:====
Displays the positions of the gun firepoints on your ship
*Syntax: '''Boolean''', YES or NO

NOTE: The position of the firepoints is calculated from the Eye Point position in the POF. You may encounter weird results if you have no Eye Point defined, but no debug warnings will be raised.

Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Firepoint size:====
Diameter of the gunpoint circles. '''Must be 4 or greater''' in order to work properly.
*Syntax: '''Integer'''

Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Firepoint X coordinate multiplier:====
Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Firepoint Y coordinate multiplier:====
Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Foreground Clip Bottom Y-offset:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Foreground Clip Width:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Afterburner Clip Height:====
* Sets the area of the throttle gauge that represents the Afterburner segment (which is on top of the 0% to 100% area). The total height of the gauge is determined by the sum of this value and [[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]]

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Show Background:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Max Speed Label Offsets:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Min Speed Label Offsets:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Orbit Center Offsets:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Orbit Radius:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Arc Filename:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Needs to be an [[Multimedia_Files#ANI|ani]] with a least 2 frames (but only the 2nd frame is used ?!?!? for threat & weapon linking so far)

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Dumbfire Filename:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Needs to be an [[Multimedia_Files#ANI|ani]] with a least 2 frames. The 1st frame is "no warning", the rest of the frames are cycled through when a warning is active.

Internally FSO also refers to this as the "laser threat warning".

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Lock Filename:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Needs to be an [[Multimedia_Files#ANI|ani]] with a least 2 frames. The 1st frame is "no warning", the rest of the frames are cycled through when a warning is active. Frames cycle twice as fast when a lock has been acquired, compared to when a lock is being acquired.

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Dumbfire Offsets:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Lock Offsets:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Lock Filename:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Locked Filename:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Lock Center Offsets:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Locked Center Offsets:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Loop Locked Animation:====

Controls whether the animation should loop after locking on, like in FS1.

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Blink Locked Animation:====

Controls whether the animation should blink after locking on, like in FS2.

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Radius:====
Defines the distance from the center of the screen to the base of the Hostile Triangle gauge.

*Syntax: '''Integer'''
*Default value:
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Hostile Triangle:|+Hostile Triangle:]]

====Triangle Base:====
Defines the width of the Hostile Triangle's base.

*Syntax: '''Float'''
*Default value:
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Hostile Triangle:|+Hostile Triangle:]]

====Triangle Height:====
Defines the height of the Hostile Triangle.

*Syntax: '''Float'''
Default value:
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Hostile Triangle:|+Hostile Triangle:]]

====Center Offsets:====

Used by: [[Hud_gauges.tbl#+Lead Indicator:|+Lead Indicator:]]

====Single Primary Filename:====
Designates the file to use for primary linking for ships with a single primary bank.

Needs to be an [[Multimedia_Files#ANI|ani]] with 2 frames; 1st is bank 1 not selected (not that this should ever be able to happen), 2nd is bank 1 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Primary Filename:====

Designates the file to use for primary linking for ships with two primary banks.

Needs to be an [[Multimedia_Files#ANI|ani]] with 4 frames:
* Frame 0 is no banks selected
* Frame 1 is 1st bank selected
* Frame 2 is 2nd bank selected
* Frame 3 is both banks selected/linked

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Single Secondary Filename:====

Designates the file to use for selected secondary bank for ships with a single secondary bank.

Needs to be an [[Multimedia_Files#ANI|ani]] with 2 frames; 1st is bank 1 not selected, 2nd is bank 1 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Secondary Filename:====

Designates the file to use for selected secondary bank for ships with two secondary banks.

Needs to be an [[Multimedia_Files#ANI|ani]] with 3 frames; 1st is no banks selected, 2nd is bank 1 selected, 3rd is bank 2 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Triple Secondary Filename:====

Designates the file to use for selected secondary bank for ships with two secondary banks.

Needs to be an [[Multimedia_Files#ANI|ani]] with 4 frames; 1st is no banks selected, 2nd is bank 1 selected, 3rd is bank 2 selected, 4th is bank 3 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Single Primary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Primary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Single Secondary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Secondary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Triple Secondary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Hidden By Comms Menu:====
{{Table3615|
Defines whether the messages gauge may be drawn at the same time as the wingman comms menu.
*Syntax: '''Boolean'''
*Default Value: '''false''' (messages are not visible while the comms menu is open)
Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]}}

====Bottom Background Offset:====
{{Table3615|
Defines the vertical pixel offset added to the position of the bottom background frame.
*Syntax: '''Integer''' vertical offset
*Units: Pixels
Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]}}

====Center Text On Gauge X-Position:====
{{Table375|
Sets whether to position the center of the text to the gauge's X-position.
*Syntax '''Boolean'''
*Default Value: '''false''' if the gauge is explicitly given a position, '''true''' otherwise
Used by: [[Hud_gauges.tbl#+Fixed Messages:|+Fixed Messages:]]}}

====Ngon Sides:====
{{Table190|
Defines the number of sides a regular polygon (N-gon) radar has. If defined, the standard radar's edge is drawn as an N-gon, instead of the standard ellipsoid. Blips that are projected outside of the N-gon are snapped to the edge: the blip's angle stays the same but the blip's radius to the center of the plot area is reduced.
*Syntax '''Integer'''
*Default Value: '''0''' A value of 0 means to use the standard ellipsoid radar
*Minimum value: '''3''' (which is a triangle)
Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]}}

====N-gon Offset:====
{{Table190|
Defines the angular offset to apply to the N-gon perimeter. The first vertex is at the 3 o'clock position, positive offsets spin this vertex counter-clockwise, negative offsets spin this clockwise.
*Syntax '''Float''' (radians)
*Default Value: '''0'''
Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]}}

[[Category:Tables]]

Hud gauges.tbl

2022-10-14T14:59:35Z

Z64555: /* +Radar: */ Fix typo of "N-gon" (FSO is looking for Ngon)

{{SCP table}}
{{TableVersionGit|2016-09-14|f9bc01c}}
{{Tables}}
The '''hud_gauges.tbl''' is used for modifying the elements of the HUD. Not all gauges can be modified. However, custom gauges may be added to mimic their behavior (such as the wingman status display).

HUD Elements in FS2 are called Gauges, and each gauge has various options to customize appearance and, in some cases, their behavior as well.

This table is one of the [[Modular Tables]] and can be extended with xxx-hdg.tbm

==HUD Configurations==
The following entries are used on the HUD system, but have not been grouped with any particular gauge.

===$Load Retail Configuration:===
Optional. If yes, any gauge missing from the HUD gauge definitions below will be loaded using the retail defaults.

If no, any missing (default) gauge will prompt an error.

*Syntax: '''Boolean'''

===$Color:===
Optional. Sets the default HUD color for all gauges.

*Syntax: ('''Integer''' Red, '''Integer''' Green, '''Integer''' Blue)
*Valid Values: all values from 0 to 255

===$Font:===
Optional. Sets the font type to use for the HUD. This can either be a string or a number. A string references a font with a specific name while a number references a font with a specific index in the fonts table. The number option is deprecated and is only there for backwards-compatibility. Use the name if possible.

*Syntax: '''String''' or '''Integer''' font index number
*Valid Values: Any name or font index as defined in [[Fonts.tbl]]

===$Chase View Only:===
{{Table381|
Optional. Sets gauges to be displayed only in Chase View.

*Syntax: '''Boolean'''
*Default Value: '''False'''
}}

===$Max Directives:===
Optional. Sets the default maximum number of directives displayed simultaneously.

*Syntax: '''Integer''' maximum number of directives
*Valid Values: Any positive number
*Default Value: '''5'''

===$Max Escort Ships:===
Optional. Sets the default maximum number of escort ships to be shown in the escort list.

*Syntax: '''Integer'''
*Valid Values: Any positive number
{{Warning|
Entries more than 16 will cause the list to overflow into the weapons list for resolutions lower than 1024x768.}}

===$Length Unit Multiplier:===
Optional. Sets the multiplier to applied to the reported distances. For example, if the multiplier is 0.5, then the distance reported to the player will (or at least should) be 0.5 x actual distance.

*Syntax: '''Float'''
*Valid Values: Any positive number

===$Speed Unit Multiplier:===
Optional. Analogous to [[Hud_gauges.tbl#$Length Unit Multiplier:|$Length Unit Multiplier]], this sets the multiplier to be applied to all speeds reported to the player. For example, if the multiplier is 0.5, the the speed reported to the player will (or at least should) be 0.5 x actual speed.

*Syntax: '''Float'''
*Valid Values: Any positive number
*Default Values:
:'''The value used in $Length Unit Multiplier''', or
:'''1''', if $Length Unit Multiplier is undefined

===$Wireframe Targetbox:===
Optional. Defines the default draw method for the target viewer (a.k.a. targetbox).

*Syntax: '''Integer''' Draw method ID
*Valid Values:
::'''0''' - Standard with full, bright lighting
::'''1''' - Wireframe
::'''2''' - Standard with proper lighting (i.e. lit the same as the actual target)
{{Table3615|
::'''3''' - Untextured with full bright lighting (i.e. drawn with a single flat color)}}

===$Targetbox Shader Effect:===
{{Table3615|
Optional. If set, defines a unique ID for a shader effect to be used when rendering a ship for the targeting box. The ID will be passed to the main shader as in [[Post_processing.tbl##Ship_Effects|#Ship_Effects]], but a table entry for the effect is not needed.

*Syntax: '''Integer'''
*Valid Values: Any positive number
}}

===$Lock Wireframe Mode:===
Optional. If set, prevents targetbox draw method from being changed during the gaming session.
*Syntax: '''Boolean'''

===$Scale Gauges:===
{{Table371|
Optional. If set, all gauges will use this value as the default for scaling individual gauge sizes (i.e. doesn't affect gauges that use Position:, and doesn't affect the values of Offset:. In addition, if "$Load Retail Configuration:" is true then all unspecified retail gauges will use this value.

If not set, defaults to yes.

*Syntax: '''Boolean'''
}}

===$Force Scaling Above:===
{{Table373|
Optional. If gauge scaling is disabled, then gauges will be scaled as though the base resolution were this resolution or the real base resolution, whichever is greater.

Use this to disable scaling at lower resolutions while preventing gauges from getting too small at higher resolutions.

To disable this feature, use '''(-1, -1)'''.

*Syntax: ('''Integer''' width, '''Integer''' height)
}}

===$Reticle Style:===
Optional. Defines which aiming reticle to use.
*Syntax: '''String'''
*Valid Values:
:'''FS1''' - uses '''''reticle1_fs1.ani'''''
:'''FS2''' - uses '''''reticle1.ani'''''

==#Gauge Config==
The following entries define default gauge appearance and behavior. Each gauge has the option of overriding these options.

===$Ship:===
Deprecated and superceded by $Ships in FSO revision 9208. If defined, the following config data will only be used if the player ship is of the supplied ship class. Can be defined multiple times within a #Gauge config group to allow unique HUD configurations per ship class.

If not defined, all following config data will be applied to all ships.

*Syntax: '''String''', ship class name

===$Ships:===
Optional. Can be used to define a list of ships the hud definition that follows will be applied to. Can be defined multiple times within a #Gauge config group to allow unique HUD configurations per ship class.

If not defined, all following config data will be applied to all ships.

*`Syntax: '''( "Class name 1" "Class name 2" )''', ship class names formatted like a flag list.

====$Load Retail Configuration:====
Optional. Overrides the [[Hud_gauges.tbl#$Load Retail Configuration: 1|$Load Retail Configuration]] global option for this ship class.

*Syntax: '''Boolean'''

====$Color:====
Optional. Overrides the [[Hud_gauges.tbl#$Color: 1|$Color]] global option for this ship class.

*Syntax: See [[Hud_gauges.tbl#$Color: 1|$Color]]

====$Font:====
Optional. Overrides the [[Hud_gauges.tbl#$Font: 1|$Font]] global option for this ship class.

*Syntax: See [[Hud_gauges.tbl#$Font: 1|$Font]]

====$Chase View Only:====
{{Table381|
Optional. Overrides the [[Hud_gauges.tbl#$Chase View Only: 1|$Chase View Only]] global option for this ship class.

*Syntax: See [[Hud_gauges.tbl#$Chase View Only: 1|$Chase View Only]]
}}

===$Base:===
Required. Defines the base resolution for this HUD configuration, upon which other gauge options (such as [[Hud_gauges.tbl#Position:|Position:]] / [[Hud_gauges.tbl#Origin:|Origin:]] / [[Hud_gauges.tbl#Offset:|Offset:]]) will use as its coordinate system.

*Syntax: ('''Integer''' width, '''Integer''' height)
*Valid Values: All supported resolutions (?)

===$Scale Gauges:===
{{Table371|
Optional. If set, will configure gauges Scaling behaviour for gauges in this #Gauge Config section. i.e. overriding the default, or the value specified at the top of the file. Individual gauges can override this setting.

*Syntax: '''Boolean'''
}}

===$Force Scaling Above:===
{{Table373|
Optional. If gauge scaling is disabled, then gauges will be scaled as though the base resolution were this resolution or the real base resolution, whichever is greater.

Use this to disable scaling at lower resolutions while preventing gauges from getting too small at higher resolutions.

To disable this feature, use '''(-1, -1)'''.

*Syntax: ('''Integer''' width, '''Integer''' height)
}}

===$Required Aspect:===
Optional. If set, this configuration will only be loaded for the specified aspect ratios.

Used as a filter when there are multiple $Base: resolutions in the table

*Syntax: '''String'''
*Valid Values:
:"Full Screen" (4:3, aspect ratio < 1.5)
:"Wide Screen" (16:9, 16:10, or similar, aspect ratio >= 1.5)

===$Min:===
Optional. Minimum resolution for this config. Any resolution lower than specified will not use this configuration.

Used as a filter when there are multiple $Base: resolutions in the table

*Syntax: ('''Integer''' width, '''Integer''' height)
*Valid Values: All supported resolutions (?)

===$Max:===
Optional. Maximum resolution for this config. Any resolution higher than specified will not use this configuration.

Used as a filter when there are multiple $Base: resolutions in the table

*Syntax: ('''Integer''' width, '''Integer''' height)
*Valid Values: All supported resolutions (?)

===$Gauges:===
Following entries define gauge-specific behavior. For the most part, each gauge has its own overrides that, if not defined, would otherwise use the global values.

Since many gauges have the same configuration options, each gauge entry has a list of valid sub-entries. Unless stated otherwise, these options must be defined in the same order as they are shown, starting from the top and ending at the bottom.

====+Custom:====
Adds a custom gauge type.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Name:|Name:]]
:[[Hud_gauges.tbl#Text:|Text:]]
:[[Hud_gauges.tbl#X Offset:|X Offset:]] (Optional)
:[[Hud_gauges.tbl#Y Offset:|Y Offset:]] (Optional)
:[[Hud_gauges.tbl#Gauge Type:|Gauge Type:]]
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Active by default:|Active by default:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]

{{table381|
====+Scripted Gauge:====
Adds a scripted gauge type.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Name:|Name:]]
}}

====+Messages:====
Adds a gauge that display mission messages.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Max Lines:|Max Lines:]] (Optional)
:[[Hud_gauges.tbl#Max Width:|Max Width:]] (Optional)
:[[Hud_gauges.tbl#Line Height:|Line Height]] (Optional)
:[[Hud_gauges.tbl#Total Lifetime:|Total Lifetime:]] (Optional)
:[[Hud_gauges.tbl#Scroll Time:|Scroll Time]] (Optional)
:[[Hud_gauges.tbl#Step Size:|Step Size:]] (Optional)
:[[Hud_gauges.tbl#Hidden By Comms Menu:|Hidden By Comms Menu:]] (Optional)

====+Training Messages:====
Adds a text box, like the ones seen in the FS1 and FS2 training missions.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}

====+Support:====
Adds a text box that shows the Support ship's status and ETA

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Text Y-offset:|Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Dock Status X-offset:|Dock Status X-offset:]] (Optional)
:[[Hud_gauges.tbl#Dock Time X-offset:|Dock Time X-offset:]] (Optional)

====+Damage:====
Adds a gauge that shows how much damage a target (or the player?) has.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Hull Integrity Offsets:|Hull Integrity Offsets]] (Optional)
:[[Hud_gauges.tbl#Hull Integrity Value X-offset:|Hull Integrity Value X-offset]] (Optional)
:[[Hud_gauges.tbl#Top Background Height:|Top Background Height:]] (Optional)
:[[Hud_gauges.tbl#Subsystem Entry Height:|Subsystem Entry Height:]] (Optional)
:[[Hud_gauges.tbl#Subsystem List Start Offsets:|Subsystem List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Subsystem Entry Value X-offset:|Subsystem Entry Value X-offset:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Offset:|Bottom Background Offset:]] (Optional)

====+Wingman Status:====
Adds a gauge that monitors the status of your wing and squadron.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Left Background Filename:|Left Background Filename:]] (Optional) (needs an animation with one frame)
{{table3615|
:[[Hud_gauges.tbl#First Background Filename:|First Background Filename:]] (Optional) (needs an animation with one frame)}}
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional) (needs an animation with one frame)
:[[Hud_gauges.tbl#Right Background Filename:|Right Background Filename:]] (Optional) (needs an animation with one frame)
{{table3615|
:[[Hud_gauges.tbl#Last Background Filename:|Last Background Filename:]] (Optional) (needs an animation with one frame)}}
:[[Hud_gauges.tbl#Dot Filename:|Dot Filename:]] (Optional) (needs an animation with two frames, 1st is for alive wingmen, 2nd is for dead or missing wingmen)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
{{table373|
[[Hud_gauges.tbl#Fixed Header Position:|Fixed Header Position:]] (Optional)}}
:[[Hud_gauges.tbl#Left Background Width:|Left Background Width:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#First Background Size:|First Background Size:]] (Optional)}}
:[[Hud_gauges.tbl#Entry Width:|Entry Width:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Entry Size:|Entry Size:]] (Optional)
:[[Hud_gauges.tbl#Right Background Offset:|Right Background Offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Offset:|Last Background Offset:]] (Optional)}}
:[[Hud_gauges.tbl#Single Wing Offsets:|Single Wing Offsets:]] (Optional)
:[[Hud_gauges.tbl#Multiple Wing Start Offsets:|Multiple Wing Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Wing Name Offsets:|Wing Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Dot Offsets:|Dot Offsets:]] (Optional)
:[[Hud_gauges.tbl#Expansion Mode:|Expansion Mode:]] (Optional)
{{Table214|
:[[Hud_gauges.tbl#Use Full Wing Names:|Use Full Wing Names:]] (Optional)
:[[Hud_gauges.tbl#Use Expanded Colors:|Use Expanded Colors:]] (Optional)
}}

====+Auto Speed:====
Adds the Auto-Speed mode gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (needs animation with 4 frames, 3rd is without auto-match-speed enabled, 4th is with... and frames 0 & 1 are not used, done this way because retail fs2 uses the same animation file for the auto speed & auto targeting gauges)
:[[Hud_gauges.tbl#Auto Offsets:|Auto Offsets:]] (Optional)
:[[Hud_gauges.tbl#Speed Offsets:|Speed Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#On Text Color:|On Text Color:]] (Optional)
:[[Hud_gauges.tbl#On Text Color:|Off Text Color:]] (Optional)}}

====+Auto Target:====
Adds the Auto-target mode gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (needs animation with 2 frames, 1st is without auto-targeting enabled, 2nd is with)
:[[Hud_gauges.tbl#Auto Offsets:|Auto Offsets:]] (Optional)
:[[Hud_gauges.tbl#Target Offsets:|Target Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#On Text Color:|On Text Color:]] (Optional)
:[[Hud_gauges.tbl#On Text Color:|Off Text Color:]] (Optional)}}

====+Countermeasures:====
Adds a gauge that monitors the amount of remaining countermeasures the player's ship currently has.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (needs an animation with a single frame)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
:[[Hud_gauges.tbl#Value Offsets:|Value Offsets:]] (Optional)

====+Talking Head:====
Adds a video window to display pilot message videos (a.k.a talking heads).

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Animation Offsets:|Animation Offsets:]] (Optional)
:[[Hud_gauges.tbl#Animation Background Size:|Animation Background Size:]] (Deprecated)
{{table373|
:[[Hud_gauges.tbl#Animation Size:|Animation Size:]] (Optional)
}}

====+Directives:====
Adds a gauge that displays all currently active directives (includes current , completed, and failed)

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional) (needs animation with one frame)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional) (needs animation with one frame)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional) (needs animation with one frame)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Background Height:|Top Background Height:]] (Optional)
:[[Hud_gauges.tbl#List Start Offsets:|List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Bottom Background Offset:|Bottom Background Offset:]] (Optional)
:[[Hud_gauges.tbl#Max Line Width:|Max Line Width:]] (Optional)
}}

====+Weapons:====
Adds a weapon status and ammunition gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Primary List Top Background Filename:|Primary List Top Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Primary List Middle Background Filename:|Primary List Middle Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Primary List Bottom Background Filename:|Primary List Bottom Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Secondary List Top Background Filename:|Secondary List Top Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Secondary List Entry Background Filename:|Secondary List Entry Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Secondary List Bottom Background Filename:|Secondary List Bottom Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
::[[Hud_gauges.tbl#Alt Ballistic Offsets:|Alt Ballistic Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Primary Background X-offset:|Top Primary BackgroundX-offset:]] (Optional)
::[[Hud_gauges.tbl#Alt Ballistic X-offset:|Alt Ballistic X-offset:]] (Optional)
:[[Hud_gauges.tbl#Text X-offset:|Text X-offset:]] (Optional)
::[[Hud_gauges.tbl#Alt Ballistic X-offset:|Alt Ballistic X-offset:]] (Optional)
:[[Hud_gauges.tbl#Top Primary Frame Height:|Top Primary Frame Height:]] (Optional)
:[[Hud_gauges.tbl#Top Secondary Frame Height:|Top Secondary Frame Height:]] (Optional)
:[[Hud_gauges.tbl#Primary List Start Y-offset:|Primary List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary List Start Y-offset:|Secondary List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Ammo X-offset:|Primary Weapon Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Link X-offset:|Primary Weapon Link X-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Name X-offset:|Primary Weapon Name X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Ammo X-offset:|Secondary Weapon Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Linked X-offset:|Secondary Weapon Linked X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Name X-offset:|Secondary Weapon Name X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Reload X-offset:|Secondary Weapon Reload X-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Entry Height:|Primary Weapon Entry Height:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Entry Height:|Secondary Weapon Entry Height:]] (Optional)

====+Objective notify:====
Adds a Objective notifier gauge. This gauge alerts the player when receiving a new objective, or when an objective has been completed or failed. Additionally, this gauge alerts the player when entering subspace, and when a Red Alert mission orders are being received (prior to a forced subspace jump).

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Objective Text Y-offset:|Objective Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Objective Value Y-offset:|Objective Value Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Subspace Text Y-offset:|Subspace Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Subspace Value Y-offset:|Subspace Value Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Red Alert Text Y-offset:|Red Alert Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Red Alert Value Y-offset:|Red Alert Value Y-offset:]] (Optional)

====+Squad Message====
Adds the squad message gauge. In FS1 and FS2, this gauge is used to send commands to your squad. (?)

*Valid sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#List Start Offsets:|List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Background Height:|Top Background Height:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Bottom Background Offset|Bottom Background Offset]] (Optional)}}
:[[Hud_gauges.tbl#Command X-offset:|Command X-offset:]] (Optional)
:[[Hud_gauges.tbl#Page Up Offsets:|Page Up Offsets:]] (Optional)
:[[Hud_gauges.tbl#Page Down Offsets:|Page Down Offsets:]] (Optional)

====+Lag:====
Adds a Lag gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]

====+Mini Target Shields:====
Adds a mini Target shields gauge. In FS1 and FS2, the Mini Target Shield gauge is the one right below the center reticle, and shows the hull damage in %

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (animation needs 8 frames; 0->3 are the top, right, bottom & left shield quads; 4->7 are the same except brighter for when the quad is flashing from being hit)
:[[Hud_gauges.tbl#3 Digit Hull Offsets:|3 Digit Hull Offsets:]] (Optional)
:[[Hud_gauges.tbl#2 Digit Hull Offsets:|2 Digit Hull Offsets:]] (Optional)
:[[Hud_gauges.tbl#1 Digit Hull Offsets:|1 Digit Hull Offsets:]] (Optional)

====+Player Shields:====
Adds a gauge that shows the shield and hull status icon of the player's craft or ship.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)

====+Target Shields:====
Adds a gauge that shows the shield and hull status icon of the targeted craft or ship.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)

====+Escort View:====
Adds an escort monitor/view gauge. This gauge monitors the status of all ships assigned to the player to escort.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height]] (Optional)
:[[Hud_gauges.tbl#Entry Stagger Width:|Entry Stagger Width:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Bottom Background Offset:|Bottom Background Offset:]] (Optional)}}
:[[Hud_gauges.tbl#Header Text:|Header Text]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#List Start Offsets:|List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Hull X-offset:|Hull X-offset]] (Optional)
:[[Hud_gauges.tbl#Name X-offset:|Name X-offset]] (Optional)
:[[Hud_gauges.tbl#Status X-offset:|Status X-offset]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Ship Name Max Width:|Ship Name Max Width:]] (Optional)}}
{{table373|
:[[Hud_gauges.tbl#Right-Align Ship Names:|Right-Align Ship Names:]] (Optional)}}

====+Mission Time:====
Adds a gauge that displays the current mission time.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
:[[Hud_gauges.tbl#Value Offsets:|Value Offsets:]] (Optional)

====+ETS Retail:====
{{Table3613|
Draws the three other ETS gauges as a single gauge. Will automatically rearrange itself (like retail) if shields or other systems are missing.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
{{Table3613|
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)
:[[Hud_gauges.tbl#Gauge Offset:|Gauge Offset:]] (Optional)

}}

====+ETS Weapons:====
Adds a gauge that displays the energy transfer rate for the energy weapons.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)

====+ETS Engines:====
Adds a gauge that displays the energy transfer rate for the afterburner/engines.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)

====+ETS Shields:====
Adds a gauge that displays the energy transfer rate for the shields.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)

====+Target Monitor:====
Adds a target monitor gauge that shows the targeted ship's relative orientation and hull strength, among other things.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Monitor Filename:|Monitor Filename:]] (Optional) (needs animation with 2 frames, 1st is the background for the target, 2nd is the border; rendered last)
{{table3615|
:[[Hud_gauges.tbl#Monitor Alpha Mask Filename:|Monitor Alpha Mask Filename:]] (Optional) (needs animation with a single frame)}}
:[[Hud_gauges.tbl#Integrity Bar Filename:|Integrity Bar Filename:]] (Optional) (needs animation with 2 frames, 1st is a zero/dark filled bar, 2nd is a max/bright filled bar)
:[[Hud_gauges.tbl#Viewport Offsets:|Viewport Offsets:]] (Optional)
:[[Hud_gauges.tbl#Viewport Size:|Viewport Size:]] (Optional)
:[[Hud_gauges.tbl#Integrity Bar Offsets:|Integrity Bar Offsets:]] (Optional)
:[[Hud_gauges.tbl#Integrity Bar Foreground Clip Height:|Integrity Bar Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Status Offsets:|Status Offsets:]] (Optional)
:[[Hud_gauges.tbl#Name Offsets:|Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Class Offsets:|Class Offsets:]] (Optional)
:[[Hud_gauges.tbl#Distance Offsets:|Distance Offsets:]] (Optional)
:[[Hud_gauges.tbl#Speed Offsets:|Speed Offsets:]] (Optional)
:[[Hud_gauges.tbl#Hull Offsets:|Hull Offsets:]] (Optional)
:[[Hud_gauges.tbl#Cargo Contents Offsets:|Cargo Contents Offsets:]] (Optional)
:[[Hud_gauges.tbl#Cargo Scan Start Offsets:|Cargo Scan Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Cargo Scan Size:|Cargo Scan Size:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Subsystem Name Offsets:|Subsystem Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Subsystem Integrity Offsets:|Subsystem Integrity Offsets:]] (Optional)
:[[Hud_gauges.tbl#Disabled Status Offsets:|Disabled Status Offsets:]] (Optional)
:[[Hud_gauges.tbl#Desaturate:|Desaturate:]] (Optional)
}}

====+Extra Target Data:====
Adds a gauge that displays "extra" target data, such as its current orders and docking status.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs an animation with 1 frame)
:[[Hud_gauges.tbl#Bracket Offsets:|Bracket Offsets:]] (Optional)
:[[Hud_gauges.tbl#Dock Offsets:|Dock Offsets:]] (Optional)
{{table373|
:[[Hud_gauges.tbl#Dock Max Width:|Dock Max Width:]] (Optional)}}
:[[Hud_gauges.tbl#Order Offsets:|Order Offsets:]] (Optional)
{{table373|
:[[Hud_gauges.tbl#Order Max Width:|Order Max Width:]] (Optional)}}
:[[Hud_gauges.tbl#Time Offsets:|Time Offsets:]] (Optional)

====+Radar:====
Adds a standard radar gauge

*Valid Sub-entries:
{{table190|
:[[Hud_gauges.tbl#N-gon Sides:|Ngon Sides:]] (Optional)
:[[Hud_gauges.tbl#N-gon Sides:|Ngon Offset:]] (Optional)
}}
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs animation with 2 frames, only the 2nd frame is used)
{{table373|
:[[Hud_gauges.tbl#Radar Center Offsets:|Radar Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Radar Size:|Radar Size:]] (Optional)
}}
:[[Hud_gauges.tbl#Infinity Distance Offsets:|Infinity Distance Offsets]] (Optional)
:[[Hud_gauges.tbl#Long Distance Offsets:|Long Distance Offsets:]] (Optional)
:[[Hud_gauges.tbl#Short Distance Offsets:|Short Distance Offsets:]] (Optional)

====+Radar Orb:====
Adds a 3D orb radar gauge

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs animation with 2 frames, only the 2nd frame is used)
{{table373|
:[[Hud_gauges.tbl#Radar Center Offsets:|Radar Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Radar Size:|Radar Size:]] (Optional)
}}
:[[Hud_gauges.tbl#Infinity Distance Offsets:|Infinity Distance Offsets]] (Optional)
:[[Hud_gauges.tbl#Long Distance Offsets:|Long Distance Offsets:]] (Optional)
:[[Hud_gauges.tbl#Short Distance Offsets:|Short Distance Offsets:]] (Optional)

====+Radar BSG:====
Adds a BSG style radar (a.k.a DRADIS).

:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Size:|Size:]] (Optional)
:[[Hud_gauges.tbl#XY Disc Filename:|XY Disc Filename:]] (Optional)
:[[Hud_gauges.tbl#XZ YZ Disc Filename:|XZ YZ Disc Filename:]] (Optional)
:[[Hud_gauges.tbl#Sweep Disc Filename:|Sweep Disc Filename:]] (Optional)
:[[Hud_gauges.tbl#Default Contact Filename:|Default Contact Filename:]] (Optional)
:[[Hud_gauges.tbl#Unknown Contact Filename:|Unknown Contact Filename:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]]
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]]
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Loop Volume:|Loop Volume:]] (Optional)
:[[Hud_gauges.tbl#Minimum Beep Delay:|Minimum Beep Delay]] (Optional)

====+Afterburner Energy:====
Adds a gauge that shows the remaining afterburner energy. Note that it only supports a vertical fill.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs animation with 2 frames, the 1st is the bar lit for zero energy, the 2nd is the bar lit for max energy)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)

====+Weapon Energy:====
Adds a gauge that shows the remaining weapon energy. Note that it only supports a vertical fill.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs an animation with 4 frames, the 3rd is the bar lit for zero energy, the 2nd is the bar lit for max energy, frames 1 & 2 are not used)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Text Alignment:|Text Alignment:]] (Optional)
:[[Hud_gauges.tbl#Always Show Text:|Always Show Text:]] (Optional)
:[[Hud_gauges.tbl#Text Follows:|Text Follows:]] (Optional)
:[[Hud_gauges.tbl#Show Ballistic Ammo:|Show Ballistic Ammo:]] (Optional)
:[[Hud_gauges.tbl#Armed Guns List Offsets:|Armed Guns List Offsets:]] (Optional)
:[[Hud_gauges.tbl#Armed Guns List Alignment:|Armed Guns List Alignment:]] (Optional)
:[[Hud_gauges.tbl#Armed Guns List Entry Height:|Armed Guns List Entry Height:]] (Optional)
}}

====+Text Warnings:====
Adds a gauge that warns the player (current warnings are EMP, Launch, Evaded, Collision, Blast & Engine Wash).

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)

====+Center Reticle:====
Adds a "custom" center reticle.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Firepoint display:|Firepoint display:]] (Optional)
:[[Hud_gauges.tbl#Firepoint size:|Firepoint size:]] (Optional)
:[[Hud_gauges.tbl#Firepoint X coordinate multiplier:|Firepoint X coordinate multiplier:]] (Optional)
:[[Hud_gauges.tbl#Firepoint Y coordinate multiplier:|Firepoint Y coordinate multiplier:]] (Optional)

====+Throttle:====
Adds a gauge that shows the current throttle position.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Bottom Y-offset:|Foreground Clip Bottom Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Width:|Foreground Clip Width:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Afterburner Clip Height:|Afterburner Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Show Background:|Show Background:]] (Optional)
:[[Hud_gauges.tbl#Max Speed Label Offsets:|Max Speed Label Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Show Max Speed Label:|Show Max Speed Label:]] (Optional)}}
:[[Hud_gauges.tbl#Min Speed Label Offsets:|Min Speed Label Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Show Min Speed Label:|Show Min Speed Label:]] (Optional)}}
:[[Hud_gauges.tbl#Orbit Center Offsets:|Orbit Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Orbit Radius:|Orbit Radius:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Current Speed Offsets:|Current Speed Offsets:]] (Optional)
:[[Hud_gauges.tbl#Target Speed Offsets:|Target Speed Offsets:]] (Optional)
:[[Hud_gauges.tbl#Show Percentage:|Show Percentage:]] (Optional)
:[[Hud_gauges.tbl#Glide Status Offsets:|Glide Status Offsets:]] (Optional)
:[[Hud_gauges.tbl#Match Speed Status Offsets:|Match Speed Status Offsets:]] (Optional)
}}

====+Threat Indicator:====
Adds a gauge that indicates when a lock-on has been achieved by an attacker, and if the player is being shot at.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Arc Filename:|Arc Filename:]] (Optional)
:[[Hud_gauges.tbl#Dumbfire Filename:|Dumbfire Filename:]] (Optional)
:[[Hud_gauges.tbl#Lock Filename:|Lock Filename:]] (Optional)
:[[Hud_gauges.tbl#Dumbfire Offsets:|Dumbfire Offsets:]] (Optional)
:[[Hud_gauges.tbl#Lock Offsets:|Lock Offsets:]] (Optional)

====+Multiplayer Messages:====
Adds a gauge that displays the multiplayer messages.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}

====+Voice Status:====
Adds a gauge that displays the voice status.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}

====+Ping:====
Adds a gauge that the ping time to the multiplayer server.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}

====+Supernova:====
Adds a gauge that warns the player of an impending supernova shock wave.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}

====+Lock Indicator:====
Adds a Lock Indicator gauge.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Lock Filename:|Lock Filename:]] (Optional)
:[[Hud_gauges.tbl#Locked Filename:|Locked Filename:]] (Optional)
:[[Hud_gauges.tbl#Lock Center Offsets:|Lock Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Locked Center Offsets:|Locked Center Offsets:]] (Optional)
{{table224|
:[[Hud_gauges.tbl#Loop Locked Animation:|Loop Locked Animation:]] (Optional)
:[[Hud_gauges.tbl#Blink Locked Animation:|Blink Locked Animation:]] (Optional)}}

====+Offscreen Indicator:====
Adds an Offscreen Indicator.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}

====+Target Brackets:====
Adds a Target Bracket gauge. This is drawn around current target(s) and talkers.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Dot Filename:|Dot Filename:]] (Optional)

====+Hostile Triangle:====
Adds a gauge that points to the nearest attacker, if it is off-screen and is not currently targeted.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)
:[[Hud_gauges.tbl#Triangle Base:|Triangle Base:]] (Optional)
:[[Hud_gauges.tbl#Triangle Height:|Triangle Height:]] (Optional)

====+Target Triangle:====
Adds a gauge that points to the targeted craft, if it is currently off-screen.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)
:[[Hud_gauges.tbl#Triangle Base:|Triangle Base:]] (Optional)
:[[Hud_gauges.tbl#Triangle Height:|Triangle Height:]] (Optional)

====+Missile Triangles:====
Adds a gauge that is used during attempting to lock onto a target when using an aspect seeking missile.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)
:[[Hud_gauges.tbl#Triangle Base:|Triangle Base:]] (Optional)
:[[Hud_gauges.tbl#Triangle Height:|Triangle Height:]] (Optional)

====+Lead Indicator:====
Adds a gauge that leads (is in front) of the target. Aim your crosshairs at this indicator to increase probability of hitting the target.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
::Frame #0: Secondaries lead indicator (Dumbfire)
::Frame #1: Secondaries lead indicator (Homing)
::Frame #2: Primaries lead indicator
:[[Hud_gauges.tbl#Center Offsets:|Center Offsets:]] (Optional)

====+Orientation Tee:====
Adds a gauge that indicates the targeted craft's orientation in relation to the player's craft.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)

====+Lead Sight:====
Adds a gauge that lags (is behind) the target. Indicates where your shots will end up relative to the target's position. To score a hit, this gauge should be over the target. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
::Frame #0 is used for secondaries
::* If only one frame is found in the file, then it is used for primaries instead
::Frame #1 is used for primaries

====+Kills:====
Adds a gauge that keeps track of how many kills the player has scored during a mission.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
:[[Hud_gauges.tbl#Value Offsets:|Value Offsets:]] (Optional)

====+Weapon Linking:====
Adds a gauge that indicates the selected weapons and their firing rates.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Arc Filename:|Arc Filename:]] (Optional)
:[[Hud_gauges.tbl#Single Primary Filename:|Single Primary Filename:]] (Optional)
:[[Hud_gauges.tbl#Double Primary Filename:|Double Primary Filename:]] (Optional)
:[[Hud_gauges.tbl#Single Secondary Filename:|Single Secondary Filename:]] (Optional)
:[[Hud_gauges.tbl#Double Secondary Filename:|Double Secondary Filename:]] (Optional)
:[[Hud_gauges.tbl#Triple Secondary Filename:|Triple Secondary Filename:]] (Optional)
:[[Hud_gauges.tbl#Single Primary Offsets:|Single Primary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Double Primary Offsets:|Double Primary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Single Secondary Offsets:|Single Secondary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Double Secondary Offsets:|Double Secondary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Triple Secondary Offsets:|Triple Secondary Offsets:]] (Optional)

====+Fixed Messages:====

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
{{table375|
:[[Hud_gauges.tbl#Center Text On Gauge X-Position:|Center Text On Gauge X-Position:]] (Optional)
}}

====+Flight Path Marker:====
{{table3615|
Adds a gauge that indicates the direction where your ship is traveling. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Center Offsets:|Center Offsets:]] (Optional)}}

====+Warhead Count:====
{{table3615|
Displays the name of the current secondary weapon. Tallies the ammo left. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs an animation with a single frame)
:[[Hud_gauges.tbl#Name Offsets:|Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Count Offsets:|Count Offsets:]] (Optional)
:[[Hud_gauges.tbl#Icon Width:|Icon Width:]] (Optional)
:[[Hud_gauges.tbl#Icon Height:|Icon Height:]] (Optional)
:[[Hud_gauges.tbl#Max Icons:|Max Icons:]] (Optional)
:[[Hud_gauges.tbl#Max Columns:|Max Columns:]] (Optional)
:[[Hud_gauges.tbl#Name Alignment:|Name Alignment:]] (Optional)
}}

====+Hardpoints:====
{{table3615|
Draws a silhouette of the player's ship and mounted weapons. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Size:|Size:]] (Optional)
:[[Hud_gauges.tbl#Line Width:|Line Width:]] (Optional)
:[[Hud_gauges.tbl#View Direction:|View Direction:]] (Optional)
:[[Hud_gauges.tbl#Show Primary Weapons:|Show Primary Weapons:]] (Optional)
:[[Hud_gauges.tbl#Show Secondary Weapons:|Show Secondary Weapons:]] (Optional)
}}

====+Primary Weapons:====
{{table3615|
Like the Weapons gauge but simpler. Only displays primary weapons. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Header Text:|Header Text:]] (Optional)
:[[Hud_gauges.tbl#First Background Filename:|First Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#First Background Height:|First Background Height:]] (Optional)
:[[Hud_gauges.tbl#First Background X-offset:|First Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Entry Background Height:|Entry Background Height:]] (Optional)
:[[Hud_gauges.tbl#Entry Background X-offset:|Entry Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Filename:|Last Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Last Background X-offset:|Last Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Y-offset:|Last Background Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
:[[Hud_gauges.tbl#List Start Y-offset:|List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Ammo X-offset:|Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Link X-offset:|Link X-offset:]] (Optional)
:[[Hud_gauges.tbl#Name X-offset:|Name X-offset:]] (Optional)
}}

====+Secondary Weapons:====
{{table3615|
Like the Weapons gauge but simpler. Only displays secondary weapons. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table224|
:[[Hud_gauges.tbl#Cockpit View Choice:|Cockpit View Choice:]] (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Header Text:|Header Text:]] (Optional)
:[[Hud_gauges.tbl#First Background Filename:|First Background Filename:]] (Optional)
:[[Hud_gauges.tbl#First Background Height:|First Background Height:]] (Optional)
:[[Hud_gauges.tbl#First Background X-offset:|First Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Height:|Entry Background Height:]] (Optional)
:[[Hud_gauges.tbl#Entry Background X-offset:|Entry Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Filename:|Last Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Last Background X-offset:|Last Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Y-offset:|Last Background Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
:[[Hud_gauges.tbl#List Start Y-offset:|List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Ammo X-offset:|Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Link X-offset:|Link X-offset:]] (Optional)
:[[Hud_gauges.tbl#Name X-offset:|Name X-offset:]] (Optional)
:[[Hud_gauges.tbl#Unlink X-offset:|Unlink X-offset:]] (Optional)
:[[Hud_gauges.tbl#Reload X-offset:|Reload X-offset:]] (Optional)
}}

===$End Gauges===
The Gauges section must end with $End Gauges. No Exceptions.

==#End==
The very last entry in the Hud_gauges.tbl must be #End. No Exceptions.

----
----

==Gauge Configuration Options==
Since a vast majority of gauges share the same entries, the configuration options for each gauge have been grouped here for formatting consistency.

====Position:====
Defines the screen coordinates for the upper left corner of this gauge.

*Syntax: '''Integer''' horizontal pixel, '''Integer''' vertical pixel position

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Training Messages:|+Training Messages:]], [[Hud_gauges.tbl#+Support:|+Support]] (and many others)

====Scale Gauge:====

{{table371|
Define if a gauge size will scale or not.

If false then gauge bitmaps will always show at their original size which may result in gauges being very small at high resolutions.

If true then gauge bitmaps will scale in proportion to the current resolution vs the base HUD resolution in use. This may result in gauges becoming blurry at non-base resolutions.

Defaults to yes/true.

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: '''Boolean''' scale_this_gauge

Used by: most gauges
}}

====Force Scaling Above:====

{{Table373|
Optional. If scaling is disabled for this gauge, then it will be scaled as though the base resolution were this resolution or the real base resolution, whichever is greater.

Use this to disable scaling at lower resolutions while preventing gauges from getting too small at higher resolutions.

To disable this feature, use '''(-1, -1)'''.

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: ('''Integer''' width, '''Integer''' height)

Used by: most gauges
}}

====Origin:====

{{table371|
Define gauge position as a ratio of the screen size (base or current, it doesn't matter).

Requires [[Hud_gauges.tbl#Offset:|Offset:]]

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: '''Float''' horizontal ratio 0.0 - 1.0, '''Float''' vertical ratio 0.0 - 1.0

Used by: most gauges
}}

====Offset:====

{{table371|
Define gauge offset from [[Hud_gauges.tbl#Origin:|Origin:]] in base resolution pixels

Requires [[Hud_gauges.tbl#Origin:|Origin:]]

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: '''Integer''' horizontal pixel offset from Origin:, '''Integer''' vertical pixel offset from Origin:

Used by: most gauges
}}

====Cockpit Target:====
The cockpit display that this gauge will be rendered to. Refers to the +Display Name: defined in [[ships.tbl#$Cockpit Display:|$Cockpit Display:]].

*Syntax: '''String''' String defined in +Display Name: in [[ships.tbl#$Cockpit Display:|$Cockpit Display:]]

=====Canvas Size:=====
The off-screen canvas this gauge will be rendered to before being interpolated into the actual cockpit display. The smaller this number is, the larger the gauge will appear on the cockpit display.

*Syntax: '''Integer''' width, '''Integer''' height

=====Display Offset:=====
The position of the canvas on the cockpit display texture

*Syntax: '''Integer''' width, '''Integer''' height

=====Display Size:=====
The interpolated size on the cockpit display texture that the canvas will be rendered to.

*Syntax: '''Integer''' width, '''Integer''' height

====Color:====
Optional. Overrides both previous color settings ([[Hud_gauges.tbl#$Color: 1|$Color]] HUD option and [[Hud_gauges#$Color: 2|$Color]] ship class option) for this particular gauge.

*Syntax: See [[Hud_gauges.tbl#$Color: 1|$Color:]]

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Font:====
Optional. Overrides both previous font settings ([[Hud_gauges.tbl#$Font: 1|$Font]] HUD option and [[Hud_gauges#$Font: 2|$Font]] ship class option) for this particular gauge.

*Syntax: See [[Hud_gauges.tbl#$Font: 1|$Font:]]

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Training Messages:|+Training Messages:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Name:====
Defines the name of this custom gauge.

*Syntax: '''String'''
*Max Length: 32 characters

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Text:====
Default text to be displayed. Can be altered using the hud-set-message, hud-set-text and hud-set-directive sexps.

*Syntax: '''String'''
*Max Length: 32 characters

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====X Offset:====
Optional. Defines the horizontal pixel offset (from the gauge's origin as defined by [[Hud_gauges.tbl#Position:|Position:]]) that the Text will be displayed.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Y Offset:====
Optional. Defines the vertical pixel offset (from the gauge's origin defined by [[Hud_gauges.tbl#Position:|Position:]]) that the Text will be displayed.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Gauge Type:====
Defines the type of gauge this is.

*Syntax: '''String'''
*Valid Values: Any one of the possible [[gauge types]].

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Slew:====
Optional. Determines whether or not this gauge is affected by afterburner shaking or similar effects. If set to "true", the gauge will not follow the player's head movements when using TrackIR/padlock. i.e. should be used for gauges like the gunsight/leadsight.

*Syntax: '''Boolean'''

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Max Lines:====
Optional. Specifies the maximum number of message lines that are displayed.

*Syntax: '''Integer'''
*Default Value: 3

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Max Width:====
Optional. Determines how long each message line may be.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Line Height:====
Optional. Determines the distance between line origins. (i.g. for a 12pt Font, there are needs to be at least 12 pixels between the bottom of one line and the next, otherwise the text will overlap each)

*Syntax: '''Integer'''
*Units: Pixels
*Default Value: 9

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Total Lifetime:====
Optional. Determines the maximum time the message gauge will be displayed from the time a new message is received.

*Syntax: '''Integer'''
*Units: milliseconds
*Default Value: 14000 (14 seconds)

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Scroll Time:====
Optional. Determines the time for the messages to scroll up one step.( See [[Hud_gauges.tbl#Step Size:|Step Size:]] )

*Syntax: '''Integer'''
*Units: milliseconds
*Default Value: 30

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Step Size:====
Optional. Determines how many pixels to shift message lines during scrolling. Messages will be shifted up by this amount until they are on the next line (as defined by [[Hud_gauges.tbl#Line Height:|Line Height:]])

*Syntax: '''Integer'''
*Units: Pixels
*Default Value: 3

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Active by default:====
Optional. Determines whether or not this gauge is always active, or only available after being activated via sexp.

*Syntax: '''Boolean'''

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Filename:====
Designates the [[Multimedia_Files#ANI|.ANI]] or [[Multimedia_Files#EFF|.EFF]] used for this gauge's background graphic.
{{Note| All HUD .ANI's must have the same color palette as the retail .ANI's in order to render properly. (.EFF's do not have this restriction)}}

*Syntax: '''Filename'''
**No filename extension is needed.

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Top Background Filename:====
Optional. Designates which file to use for the top background. (?)

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Damage|+Damage]]

====Bottom Background Filename:====
Optional. Designates which file to use for the Bottom background (?)

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Damage|+Damage]]

====Left Background Filename:====
Optional. Designates which file to use for the Left side of gauge.

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====First Background Filename:====
Optional. Alias for [[Hud_gauges.tbl#Left Background Filename:|Left Background Filename:]]

====Right Background Filename:====
Optional. Designates which file to use for the Right side of the gauge.

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Last Background Filename:====
Optional. Alias for [[Hud_gauges.tbl#Right Background Filename:|Right Background Filename:]]

====Entry Background Filename:====
Optional. Designates which file to use for the (Wing) Entry section of the gauge (aka the middle sections).

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Damage|+Damage]], [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Primary List Top Background Filename:====
Optional. Designates which file to use for the Primary List Top Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary List Middle Background Filename:====
Optional. Designates which file to use for the Primary List Middle Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary List Bottom Background Filename:====
Optional. Designates which file to use for the Primary List Bottom Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Top Background Filename:====
Optional. Designates which file to use for the Secondary List Top Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Entry Background Filename:====
Optional. Designates which file to use for the Secondary List Entry Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Bottom Background Filename:====
Optional. Designates which file to use for the Secondary List Bottom Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Alt Ballistic Filename:====
Optional. Designates an alternate file to be used for ballistic weapons.

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#Primary List Top Background Filename:|Primary List Top Background Filename]], [[Hud_gauges.tbl#Primary List Middle Background Filename:|Primary List Middle Background Filename]], [[Hud_gauges.tbl#Primary List Bottom Background Filename:|Primary List Bottom Background Filename]], [[Hud_gauges.tbl#Secondary List Top Background Filename:|Secondary List Top Background Filename]], [[Hud_gauges.tbl#Secondary List Entry Background Filename:|Secondary List Entry Background Filename]], [[Hud_gauges.tbl#Secondary List Bottom Background Filename:|Secondary List Bottom Background Filename]]

====Dot Filename:====
Optional. Designates which file to use for the wingman graphic (a.k.a. the Dot)

*Syntax: '''Filename'''

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Header Offsets:====
Optional. Designates the offset from the gauge's upper left corner for headers of various gauges

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels
*Valid Sub-entries:
:Weapons:
::[[Hud_gauges.tbl#Alt Ballistic Offsets:|Alt Ballistic Offsets:]]

Used by: [[Hud_gauges.tbl#+Support:|+Support:]], [[Hud_gauges.tbl#+Damage|+Damage:]], [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Fixed Header Position:====
Optional. If set, the header text will not change position when the gauge changes size.

*Syntax: '''Boolean'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Text Y-offset:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship Text. (?)

*Syntax: '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]]

====Text Offsets:====
Optional. Defines the screen position offsets for the text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: :[[Hud_gauges.tbl#+Countermeasures:|+Countermeasures:]]

====Value Offsets:====
Optional. Defines the screen position offsets for the value label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: :[[Hud_gauges.tbl#+Countermeasures:|+Countermeasures:]]

====Dock Status X-offset:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship's dock status. (?)

*Syntax: '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]]

====Dock Time X-offset:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship's dock time. (?)

*Syntax: '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]]

====Hull Integrity Offsets:====
Optional. Designates the offsets from the gauge's upper left corner for the for the Damage gauge Hull integrity textbox(?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Hull Integrity Value X-offset:====
Optional. Designates the offsets from the hull integrity textbox's upper left corner for the hull integrity value. (?)

*Syntax: '''Integer''' horizontal offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Top Background Height:====
Optional. Designates the height of the Top background (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Left Background Width:====
Optional. Defines the width of the Left Background.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Entry Width:====
Optional. Defines the width of the Entry Background (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Subsystem Entry Height:====
Optional. Designates the height of the Subsystem entry (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Subsystem List Start Offsets:====
Optional. Designates the offsets from the gauge's upper left corner for the for the start of the Subsytem List (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Subsystem Entry Value X-offset:====
Optional. Designates the horizontal offset from the Subsystem List's position (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Single Wing Offsets:====
Optional. Designates the offset from the gauge's upper left corner for a single wing (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Multiple Wing Start Offsets:====
Optional. Designates the offset from the gauge's upper left corner for multiple wings (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Wing Name Offsets:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship header (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Dot Offsets:====
Optional. Designates the offset from the gauge's upper left corner for the All wingman status icons.
*Syntax:
:'''Integer''' x, '''Integer''' y ;; Wingman 1
:'''Integer''' x, '''Integer''' y ;; Wingman 2
:'''Integer''' x, '''Integer''' y ;; Wingman 3
:'''Integer''' x, '''Integer''' y ;; Wingman 4
:'''Integer''' x, '''Integer''' y ;; Wingman 5
:'''Integer''' x, '''Integer''' y ;; Wingman 6
*Units: Pixels

{{Warning|
All 6 wingman positions must be defined}}

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Expansion Mode:====
Optional. Denotes which direction (in relation to the player's wing) that the other wings should be appended to the gauge. If enabled, then wingmen dot colors will be

*Syntax: '''Boolean'''
*Default Value: '''False'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Use Full Wing Names:====
{{Table214|
Optional. If enabled the wingmen gauge draws the full wing name and does not alter the capitalization. Default behavior is to draw the first three letters of the wing in all lower-case.

*Syntax: '''Boolean'''
*Default Value: '''False'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]
}}

====Use Expanded Colors:====
{{Table214|
Optional. If enabled the wingmen gauge status dots use red, yellow, or green color to designate wingmen health (green full to greater thon two-thirds, yellow two-thirds to greater than one-third, and red less than or equal to one-third). Default is to use red for less than half health and gauge color otherwise.

*Syntax: '''Boolean'''
*Default Value: '''False'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]
}}

====Auto Offsets:====
Optional. Defines the screen coordinates for the "Auto" text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Auto Speed:|+Auto Speed:]], [[Hud_gagues.tbl#+Auto Target:|+Auto Target:]]

====Speed Offsets:====
Optional. Defines the screen coordinates for the "Speed" text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Auto Speed:|+Auto Speed:]]

====Target Offsets:====
Optional. Defines the screen coordinates for the "Target" text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Auto Target:|+Auto Target:]]

====Animation Offsets:====
Optional. Defines the offsets for the animation graphics.

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Talking Head:|+Talking Head:]]

====Animation Background Size:====
Deprecated. Originally, this set the size of the black box that's drawn behind the animation. Since Git revision 556e9a4 (2015-11-01), it has the same effect as [[Hud_gauges.tbl#Animation Size:|Animation Size:]].

*Syntax: '''Integer''' horizontal size, '''Integer''' vertical size
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Talking Head:|+Talking Head:]]

====Animation Size:====
{{table373|
Optional. Defines the size of the animation. All animations will be scaled to match this size.

*Syntax: '''Integer''' horizontal size, '''Integer''' vertical size
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Talking Head:|+Talking Head:]]
}}

====List Start Offsets:====
Optional. Defines the screen coordinate offsets for the start of the Directives list.

*Syntax: '''Integer''' x, '''Integer''' y
*Units: Pixels

Used by: [[Hud_guages.tbl#+Directives:|+Directives:]]

====Entry Height:====
Optional. Defines the height of each Directive

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_guages.tbl#+Directives:|+Directives:]]

====Alt Ballistic Offsets:====
Opetional. Defines the screen coordinate offsets for headers of ballistic weapons

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Header Offset:|+Header Offset:]]

====Top Primary Background X-offset:====
Optional. Defines the screen coordinate offset for the Top Primary Background

*Syntax: '''Integer'''
*Units: Pixels
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic X-offset:|Alt Ballistic X-offset:]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Text X-offset:====
(Optional) Defines the screen coordinate X-offset for weapon labels

*Syntax: '''Integer'''
*Units: Pixels
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic X-offset:|Alt Ballistic X-offset:]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Alt Ballistic X-offset:====
Optional. Defines the screen coordinate X-offset for ballistic weapons

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#Top Primary Background X-offset:|Top Primary Background X-offset:]], [[Hud_gauges.tbl#Text X-offset:|Text X-offset:]]

====Top Primary Frame Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Top Secondary Frame Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary List Start Y-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Start Y-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Ammo X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Link X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Name X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Ammo X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Linked X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Name X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Reload X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Entry Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Entry Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====3 Digit Hull Offsets:====
Designates the screen position offsets for the hull damage % when it is the 3 digit range (i.e. >= 100%)

*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Mini Target Shields:|+Mini Target Shields:]]

====2 Digit Hull Offsets:====
Designates the screen position offsets for the hull damage % when it is the 2 digit range (i.e. 100% > hull damage% >= 10%)

*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Mini Target Shields:|+Mini Target Shields:]]

====1 Digit Hull Offsets:====
Designates the screen position offsets for the hull damage % when it is the 1 digit range (i.e. 10% > hull damage% >= 0%)

*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Mini Target Shields:|+Mini Target Shields:]]

====Objective Text Y-offset:====
Designates the screen position offset for the Objective label

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Objective Value Y-offset====
Designates the screen position offset for the Objective value

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Subspace Text Y-offset:====
Designates the screen position offset for the Subspace label

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Subspace Value Y-offset====
Designates the screen position offset for the Subspace value (?)

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Red Alert Text Y-offset====
Designates the screen position offset for the Red Alert label

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Red Alert Value Y-offset====
Designates the screen position offset for the Red Alert value (?)

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Command X-offset:====
*Syntax: '''Integer''' x offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Squad Message:|+Squad Message:]]

====Page Up Offsets:====
*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Squad Message:|+Squad Message:]]

====Page Down Offsets:====
*Syntax: '''Integer''' x offset, ''' Integer y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Squad Message:|+Squad Message:]]

====Entry Height:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Entry Stagger Width:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Header Text:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Header Offsets:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====List Start Offsets:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Hull X-offset:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Name X-offset:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Status X-offset:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Ship Name Max Width:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Right-Align Ship Names:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Foreground Clip Height:====

* Sets the height, in pixels, of the gauge.
** For the [[Hud_gauges.tbl#+Throttle|Throttle]], sets the height of the gauge that represents 0% to 100% throttle. The total height of the gauge is the sum of this value and the [[Hud_gauges.tbl#Afterburner Clip Height:|Afterburner Clip Height]] value.
* Syntax: '''Integer'''

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]], [[Hud_gauges.tbl#+ETS Weapons:|+ETS Weapons]], [[Hud_gauges.tbl#+ETS Engines:|+ETS Engines]], [[Hud_gauges.tbl#+ETS Shields:|+ETS Shields]], [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor]], [[Hud_gauges.tbl#+Afterburner Energy|+Afterburner Energy]], [[Hud_gauges.tbl#+Weapon Energy|+Weapon Energy]], [[Hud_gauges.tbl#+Throttle:|+Throttle]]

====Letter Offsets:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Top Offsets:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Bottom Offsets:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Gauge Offset:====
*Distance between the individual weapon/shield/engine ETS gauges that comprise this gauge
*Syntax: '''Integer'''

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Monitor Filename:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Integrity Bar Filename:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Viewport Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Viewport Size:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Integrity Bar Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Integrity Bar Foreground Clip Height:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Status Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Name Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Class Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Speed Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Hull Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Cargo Contents Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Cargo Scan Start Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Cargo Scan Size:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Bracket Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Dock Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Dock Max Width:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Order Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Order Max Width:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Time Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Radar Center Offsets:====
Defines the radar's plot origin as an offset, in pixels, from this gauge's [[Hud_gauges.tbl#Position|Position]] coordinates
*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

====Radar Size:====
Size, in pixels, of the radar plot area.

Syntax: '''Integer''' horizontal size, '''Integer''' vertical size

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

====Infinity Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

Offset to draw the infinity radar range symbol.

====Long Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

Offset to draw the long range radar text (i.e. 10k).

====Short Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

Offset to draw the short range radar text (i.e. 2k).

====Size:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====XY Disc Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====XZ YZ Disc Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Sweep Disc Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Default Contact Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Unknown Contact Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Loop Volume:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG]]

====Minimum Beep Delay:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG]]

====Firepoint display:====
Displays the positions of the gun firepoints on your ship
*Syntax: '''Boolean''', YES or NO

NOTE: The position of the firepoints is calculated from the Eye Point position in the POF. You may encounter weird results if you have no Eye Point defined, but no debug warnings will be raised.

Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Firepoint size:====
Diameter of the gunpoint circles. '''Must be 4 or greater''' in order to work properly.
*Syntax: '''Integer'''

Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Firepoint X coordinate multiplier:====
Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Firepoint Y coordinate multiplier:====
Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Foreground Clip Bottom Y-offset:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Foreground Clip Width:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Afterburner Clip Height:====
* Sets the area of the throttle gauge that represents the Afterburner segment (which is on top of the 0% to 100% area). The total height of the gauge is determined by the sum of this value and [[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]]

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Show Background:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Max Speed Label Offsets:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Min Speed Label Offsets:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Orbit Center Offsets:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Orbit Radius:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Arc Filename:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Needs to be an [[Multimedia_Files#ANI|ani]] with a least 2 frames (but only the 2nd frame is used ?!?!? for threat & weapon linking so far)

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Dumbfire Filename:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Needs to be an [[Multimedia_Files#ANI|ani]] with a least 2 frames. The 1st frame is "no warning", the rest of the frames are cycled through when a warning is active.

Internally FSO also refers to this as the "laser threat warning".

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Lock Filename:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Needs to be an [[Multimedia_Files#ANI|ani]] with a least 2 frames. The 1st frame is "no warning", the rest of the frames are cycled through when a warning is active. Frames cycle twice as fast when a lock has been acquired, compared to when a lock is being acquired.

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Dumbfire Offsets:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Lock Offsets:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Lock Filename:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Locked Filename:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Lock Center Offsets:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Locked Center Offsets:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Loop Locked Animation:====

Controls whether the animation should loop after locking on, like in FS1.

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Blink Locked Animation:====

Controls whether the animation should blink after locking on, like in FS2.

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Radius:====
Defines the distance from the center of the screen to the base of the Hostile Triangle gauge.

*Syntax: '''Integer'''
*Default value:
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Hostile Triangle:|+Hostile Triangle:]]

====Triangle Base:====
Defines the width of the Hostile Triangle's base.

*Syntax: '''Float'''
*Default value:
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Hostile Triangle:|+Hostile Triangle:]]

====Triangle Height:====
Defines the height of the Hostile Triangle.

*Syntax: '''Float'''
Default value:
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Hostile Triangle:|+Hostile Triangle:]]

====Center Offsets:====

Used by: [[Hud_gauges.tbl#+Lead Indicator:|+Lead Indicator:]]

====Single Primary Filename:====
Designates the file to use for primary linking for ships with a single primary bank.

Needs to be an [[Multimedia_Files#ANI|ani]] with 2 frames; 1st is bank 1 not selected (not that this should ever be able to happen), 2nd is bank 1 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Primary Filename:====

Designates the file to use for primary linking for ships with two primary banks.

Needs to be an [[Multimedia_Files#ANI|ani]] with 4 frames:
* Frame 0 is no banks selected
* Frame 1 is 1st bank selected
* Frame 2 is 2nd bank selected
* Frame 3 is both banks selected/linked

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Single Secondary Filename:====

Designates the file to use for selected secondary bank for ships with a single secondary bank.

Needs to be an [[Multimedia_Files#ANI|ani]] with 2 frames; 1st is bank 1 not selected, 2nd is bank 1 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Secondary Filename:====

Designates the file to use for selected secondary bank for ships with two secondary banks.

Needs to be an [[Multimedia_Files#ANI|ani]] with 3 frames; 1st is no banks selected, 2nd is bank 1 selected, 3rd is bank 2 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Triple Secondary Filename:====

Designates the file to use for selected secondary bank for ships with two secondary banks.

Needs to be an [[Multimedia_Files#ANI|ani]] with 4 frames; 1st is no banks selected, 2nd is bank 1 selected, 3rd is bank 2 selected, 4th is bank 3 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Single Primary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Primary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Single Secondary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Secondary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Triple Secondary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Hidden By Comms Menu:====
{{Table3615|
Defines whether the messages gauge may be drawn at the same time as the wingman comms menu.
*Syntax: '''Boolean'''
*Default Value: '''false''' (messages are not visible while the comms menu is open)
Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]}}

====Bottom Background Offset:====
{{Table3615|
Defines the vertical pixel offset added to the position of the bottom background frame.
*Syntax: '''Integer''' vertical offset
*Units: Pixels
Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]}}

====Center Text On Gauge X-Position:====
{{Table375|
Sets whether to position the center of the text to the gauge's X-position.
*Syntax '''Boolean'''
*Default Value: '''false''' if the gauge is explicitly given a position, '''true''' otherwise
Used by: [[Hud_gauges.tbl#+Fixed Messages:|+Fixed Messages:]]}}

====N-gon Sides:====
{{Table190|
Defines the number of sides a regular polygon (N-gon) radar has. If defined, the standard radar's edge is drawn as an N-gon, instead of the standard ellipsoid. Blips that are projected outside of the N-gon are snapped to the edge: the blip's angle stays the same but the blip's radius to the center of the plot area is reduced.
*Syntax '''Integer'''
*Default Value: '''0''' A value of 0 means to use the standard ellipsoid radar
*Minimum value: '''3''' (which is a triangle)
Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]}}

====N-gon Offset:====
{{Table190|
Defines the angular offset to apply to the N-gon perimeter. The first vertex is at the 3 o'clock position, positive offsets spin this vertex counter-clockwise, negative offsets spin this clockwise.
*Syntax '''Float''' (radians)
*Default Value: '''0'''
Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]}}

[[Category:Tables]]

Controlconfigdefaults.tbl

2022-10-12T15:27:07Z

Z64555: Add section about Debug Commands and mention save_ccd

{{TableVersionGit| 2021-02-13 UTC | db2bd97669c949e7d68baa9560192b7d3ad96563}}

{{Tables}}
The '''controlconfigdefaults.tbl''' can be used to modify the default key bindings in FSO.

==#ControlConfigOverride==
* Starts an Override section
* Begins with '''#ControlConfigOverride''' and ends with '''#End'''.
* Only entries that you want to change are required, the rest will use the default binding
* Entries not listed will be assigned to their default/hardcoded values.
{{Table371|
* Multiple #ControlConfigOverride...#End blocks can be provided.
** Each block defines a separate control config preset
** The "Defaults" button in the control config screen may be used to reset to the selected preset, then cycle through to the next preset.
** The first given block is used as the "global" defaults, and is used when working with the key-pressed SEXP and LUA scripts.
** Note: It's a good idea to also use [[Strings.tbl]] to change the "Defaults" text on the button to for example "Cycle\nPresets".
}}

==#ControlConfigPreset==
{{Table212|
* Starts a Preset section
* Begins with '''#ControlConfigPreset''' and ends with '''#End'''.
* All keybinds you wish to have bound must be specified, any unspecified keys will be unbound.
}}

===$Name:===
{{Table373|
* The name of this control config preset, displayed at the top left corner of the control config screen when selected through the "Defaults" button.
* If not provided, the first [[#ControlConfigOverride]] block will override the hardcoded defaults, all subsequent blocks will be '''<unnamed preset>.'''
{{Table212|
* If not provided, the [[#ControlConfigPreset]] block will be '''<unnamed preset>'''
}}
**Syntax: '''''String'''''
}}

===$Bind Name:===
*Name of the bind or action to modify the default key of.
*Valid entries: [[Controlconfigdefaults.tbl#Table of Bindings|Table of Bindings]]
*Required
*Syntax: '''String'''
{{Table220|
As of FSO 22.0, '''$Bind Name:''' is deprecated in favor of '''$Bind:'''
}}

====$Key Default:====
*Key to set as default
*Valid entries: [[Controlconfigdefaults.tbl#Allowed Keys|Allowed Keys]]
{{Table372|
*May be unbound by specifying '''NONE''' instead of a key}}
*Optional
*Syntax: '''String'''

====$Joy Default:====
*Joystick button to set as default
*Optional
*Syntax: '''Integer'''

====$Key Mod Shift:====
*Sets the key to require the Shift key
*'''1''' for yes, '''0''' for no
*Optional
*Syntax: '''Integer'''

====$Key Mod Alt:====

*Sets the key to require the Alt key
*'''1''' for yes, '''0''' for no
*Optional
*Syntax: '''Integer'''

====$Key Mod Ctrl:====
* Sets the key to require the Ctrl key
* '''1''' for yes, '''0''' for no
* Optional
* Syntax: '''Integer'''

===$Bind:===
{{Table220|
*The IoActionID of the action to bind to.
*Valid entries: [[Controlconfigdefaults.tbl#Table of Bindings|Table of Bindings]]
*Required
*Syntax: '''String'''
}}

====$Primary:====
{{Table220|
*Denotes the following binding is a Primary binding of the control
*Optional
*Syntax: (No arguments)
}}

=====$Controller:=====
{{Table220|
*Denotes which controller this binding is for
*Required
*Syntax: '''String''', any of the following:
**'''CID_NONE'''
**'''CID_KEYBOARD'''
**'''CID_MOUSE'''
**'''CID_JOY0'''
**'''CID_JOY1'''
**'''CID_JOY2'''
**'''CID_JOY3'''
}}

=====$Flags:=====
{{Table220|
*Denotes a number of flags for button behavior
*Required
*Syntax: '''String''', any of the following:
}}
{| class="wikitable"
| '''AXIS_BTN''' || An axis that's treated as a digital control should it be deflected past a certain threshold (Note: WIP)
|-
| '''RELATIVE''' || A relative axis which increases or decreases the control's value instead of directly setting its value. (Example: Relative Throttle)
|-
| '''INVERTED''' || An axis who's input is inverted
|-
| '''AXIS''' || Input is an axis
|-
| '''HAT''' || Input is a POV HAT switch
|-
| '''BALL''' || Input is a trackball
|-
| '''NONE''' || Input is assumed to be a standard button or key
|}

=====$Input:=====
{{Table220|
*Which button, key, or axis is bound
*Required
*Syntax: '''string''', any of the following:

Joystick axes:
*'''X_AXIS'''
*'''Y_AXIS'''
*'''Z_AXIS'''
*'''RX_AXIS'''
*'''RY_AXIS'''
*'''RZ_AXIS'''

Joystick Buttons:
*Buttons are simply the button number, such as "1" for button 1.

Mouse Buttons:
*'''LEFT_BUTTON'''
*'''RIGHT_BUTTON'''
*'''MIDDLE_BUTTON'''
*'''X1_BUTTON'''
*'''X2_BUTTON'''
*'''WHEEL_UP'''
*'''WHEEL_DOWN'''
*'''WHEEL_LEFT'''
*'''WHEEL_RIGHT'''

Keyboard Keys:
[[Controlconfigdefaults.tbl#Allowed Keys|Allowed Keys]]
*Key modifiers '''ALT-''' and '''SHIFT-''' can be prepended to the Key ID.
**Example: '''ALT-J''', '''SHIFT-KEY_Q''', '''ALT-SHIFT-KEY_1'''
}}

====$Secondary:====
{{Table220|
*Denotes the following binding is a Secondary binding of the control
*Has the same suboptions as [[Controlconfigdefaults.tbl#$Primary:|$Primary]]
*Optional
*Syntax: (No Arguments)
}}

===$Category:===
* Tab where the binding appears in the options menu.
* Valid entries: TARGET_TAB, SHIP_TAB, WEAPON_TAB, COMPUTER_TAB
* Optional
* Only valid in [[#ControlConfigOverride]] blocks
* Syntax: '''String'''

===$Text:===
{{Table212|
* The label of the control to use in the controls config menu.
* Is overridden by XSTR, if provided
** '''Note:''' This is meant to be a lazy temporary substitution to modifying [[strings.tbl]]. Your released mod should nstill provide its own strings.tbl.
* Optional
* Syntax: '''String'''
}}

===$Has XStr:===
* Whether or not the binding has an entry in [[strings.tbl]]
** If '''0''', assumes no XSTR is provided
** If '''1''', assumes an XSTR is provided alongside the other ControlConfig strings according to its internal, hardcoded index
{{Table382|
** If any nonzero integer >1, is the exact XSTR index within [[strings.tbl]]
}}
* Optional
* Only valid in [[#ControlConfigOverride]] blocks
* Syntax: '''Integer'''

===$Type:===
*Determines the type of control this is.

*Valid entries:
**CC_TYPE_TRIGGER
***Normal control that activates upon the first press. Resetting devices (such as weapons) will keep firing as long as the key/button is held down.
**CC_TYPE_CONTINUOUS
***Control that activates when the key/button is held down, and stays activated until the key/button is released. Ex: Afterburner key.
*Optional
*Only valid in [[#ControlConfigOverride]] blocks
*Syntax '''String'''

===$Disable:===
{{Table373|
*Determines whether the binding can be used and appears in the options menu. Can be used to hide bindings which are not needed, or to enable bindings which are hidden by default.
*Syntax: '''''Boolean'''''
}}

===+Disable===
{{Table212|
* Disables the control
* Optional
* Only valid in [[#ControlConfigOverride]] blocks
* Syntax: (No arguments)
}}

==#End==
* All [[#ControlConfigOverride]] and [[#ControlConfigPreset]] sections must be terminated by #End

==Sample==
===Post-22.0===
{{Table220|
This example is for Post-22.0 and does the following...
*Sets Clear Escort List to Alt-Shift-Q
*Sets Target Target's Attacker to Alt-Shift-J and Button 2 on Joystick 0, moves it to the Ship Tab, denotes it's type as a trigger and sets it to not have a XString
*Sets Transfer Energy from Shield to Laser to R

Note that for compatibility, FSO builds 22.0 and later can still read Pre-22.0 format.

Note: the indents are optional, and are provided to improve readibility.
}}

<pre>
#ControlConfigOverride

$Bind: ESCORT_CLEAR
$Primary:
$Controller: CID_KEYBOARD
$Flags: NONE
$Input: ALT-SHIFT-KEY_Q

$Bind: TARGET_CLOSEST_SHIP_ATTACKING_TARGET
$Primary:
$Controller: CID_KEYBOARD
$Flags: NONE
$Input: ALT-SHIFT-KEY_J
$Secondary:
$Controller: CID_JOY0
$Flags: NONE
$Input: 2
$Category: SHIP_TAB
$Has XStr: 0
$TYPE: CC_TYPE_TRIGGER

$Bind: XFER_LASER
$Primary:
$Controller: CID_KEYBOARD
$FLAGS: NONE
$Inpute: KEY_R

#End
</pre>

===Pre-22.0===
This example is for Pre-22.0 and does the following...
*Sets Clear Escort List to Alt-Shift-Q
*Sets Target Target's Attacker to Ctrl-Alt-Shift-J, moves it to the Ship Tab, denotes it's type as a trigger and sets it to not have a XString
*Sets Transfer Energy from Shield to Laser to R

<pre>
#ControlConfigOverride

$Bind Name: Clear Escort List
$Key Default: KEY_Q
$Key Mod Shift: 1
$Key Mod Alt: 1

$Bind Name: Target Target's Nearest Attacker
$Key Default: KEY_J
$Key Mod Shift: 1
$Key Mod Alt: 1
$Key Mod Ctrl: 1
$Category: SHIP_TAB
$Has XStr: 0
$TYPE: CC_TYPE_TRIGGER

$Bind Name: Transfer Energy Shield->Laser
$Key Default: KEY_R

#End
</pre>

==Table of Bindings==
* This is a table of all possible bindings that can be modified, grouped into smaller tables for easier reference.
* '''$Bind Name:''' column is to be used with '''$Bind Name:''' entries, and '''$Bind:''' column is to be used with '''$Bind:''' entries.
* These bindings are case-sensitive
* Controls added after 22.0 might not have a '''$Bind Name:'''. Use the '''$Bind:''' identifier instead.
{| class="wikitable"
|+ style="color:white" | Targeting
|-
! $Bind Name: !! $Bind:
|-
| Target Next Ship || TARGET_NEXT
|-
| Target Previous Ship || TARGET_PREV
|-
| Target Next Closest Hostile Ship || TARGET_NEXT_CLOSEST_HOSTILE
|-
| Target Previous Closest Hostile Ship || TARGET_PREV_CLOSEST_HOSTILE
|-
| Toggle Auto Targeting || TOGGLE_AUTO_TARGETING
|-
| Target Next Closest Friendly Ship || TARGET_NEXT_CLOSEST_FRIENDLY
|-
| Target Previous Closest Friendly Ship || TARGET_PREV_CLOSEST_FRIENDLY
|-
| Target Ship in Reticle || TARGET_SHIP_IN_RETICLE
|-
| Target Targets Nearest Attacker || TARGET_CLOSEST_SHIP_ATTACKING_TARGET
|-
| Target Last Ship to Send Transmission || TARGET_LAST_TRANMISSION_SENDER
|-
| Turn Off Targeting || STOP_TARGETING_SHIP
|-
| Target Closest Attacking Ship || TARGET_CLOSEST_SHIP_ATTACKING_SELF
|-
| Target Next Escort Ship || TARGET_NEXT_ESCORT_SHIP
|-
| Target Closest Repair Ship || TARGET_CLOSEST_REPAIR_SHIP
|-
| Target Next Uninspected Cargo || TARGET_NEXT_UNINSPECTED_CARGO
|-
| Target Previous Uninspected Cargo || TARGET_PREV_UNINSPECTED_CARGO
|-
| Target Newest Ship in Area || TARGET_NEWEST_SHIP
|-
| Target Targets Target || TARGET_TARGETS_TARGET
|-
| Target Next Hostile Bomb or Bomber || TARGET_NEXT_BOMB
|-
| Target Previous Hostile Bomb or Bomber || TARGET_PREV_BOMB
|}

{| class="wikitable"
|+ style="color:white" | Targeting Subsystems and Turrets
|-
! $Bind Name: !! $Bind:
|-
| Target Subsystem in Reticle || TARGET_SUBOBJECT_IN_RETICLE
|-
| Target Next Subsystem || TARGET_NEXT_SUBOBJECT
|-
| Target Previous Subsystem || TARGET_PREV_SUBOBJECT
|-
| Turn Off Targeting of Subsystems || STOP_TARGETING_SUBSYSTEM
|-
| Target Next Live Turret || TARGET_NEXT_LIVE_TURRET
|-
| Target Previous Live Turret || TARGET_PREV_LIVE_TURRET
|}

{| class="wikitable"
|+ style="color:white" | Weapons
|-
! $Bind Name: !! $Bind:
|-
| Fire Primary Weapon || FIRE_PRIMARY
|-
| Fire Secondary Weapon || FIRE_SECONDARY
|-
| Cycle Forward Primary Weapon || CYCLE_NEXT_PRIMARY
|-
| Cycle Backward Primary Weapon || CYCLE_PREV_PRIMARY
|-
| Cycle Primary Weapon Firing Rate || CYCLE_PRIMARY_WEAPON_SEQUENCE
|-
| Cycle Secondary Weapon Bank || CYCLE_SECONDARY
|-
| Cycle Secondary Weapon Firing Rate || CYCLE_NUM_MISSLES
|-
| Launch Countermeasure || LAUNCH_COUNTERMEASURE
|}

{| class="wikitable"
|+ style="color:white" | Flight Controls
|-
! $Bind Name: !! $Bind:
|-
| Forward Thrust || FORWARD_THRUST
|-
| Reverse Thrust || REVERSE_THRUST
|-
| Bank Left || BANK_LEFT
|-
| Bank Right || BANK_RIGHT
|-
| Pitch Forward || PITCH_FORWARD
|-
| Pitch Backward || PITCH_BACK
|-
| Turn Left || YAW_LEFT
|-
| Turn Right || YAW_RIGHT
|-
| Right Thrust || RIGHT_SLIDE_THRUST
|-
| Left Thrust || LEFT_SLIDE_THRUST
|-
| Up Thrust || UP_SLIDE_THRUST
|-
| Down Thrust || DOWN_SLIDE_THRUST
|-
| Afterburner || AFTERBURNER
|-
| Glide When Pressed || GLIDE_WHEN_PRESSED
|-
| Bank When Pressed || BANK_WHEN_PRESSED
|-
| Match Target Speed || MATCH_TARGET_SPEED
|}

{| class="wikitable"
|-
|+ style="color:white" | Throttle Control
|-
! $Bind Name: !! $Bind:
|-
| Set Throttle to Zero || ZERO_THROTTLE
|-
| Set Throttle to Max || MAX_THROTTLE
|-
| Set Throttle to One-Third || ONE_THIRD_THROTTLE
|-
| Set Throttle to Two-Thirds || TWO_THIRDS_THROTTLE
|-
| Increase Throttle 5 Percent || PLUS_5_PERCENT_THROTTLE
|-
| Decrease Throttle 5 Percent || MINUS_5_PERCENT_THROTTLE
|}

{| class="wikitable"
|+ style="color:white" | HUD Controls
|-
! $Bind Name: !! $Bind:
|-
| Toggle High HUD Contrast || TOGGLE_HUD_CONTRAST
|-
| Toggle HUD || TOGGLE_HUD
|-
| Toggle HUD Wireframe Target View || HUD_TARGETBOX_TOGGLE_WIREFRAME
|-
| Cycle Radar Range || RADAR_RANGE_CYCLE
|-
| Communications Menu || SQUADMSG_MENU
|-
| Show Objectives || SHOW_GOALS
|-
| Show Nav Map || SHOW_NAVMAP
|-
| Add or Remove Escort || ADD_REMOVE_ESCORT
|-
| Clear Escort List || ESCORT_CLEAR
|-
| - || TOGGLE_HUD_SHADOWS
|}

{| class="wikitable"
|+ style="color:white" | Squadmate Messaging
|-
! $Bind Name: !! $Bind:
|-
| Attack My Target || ATTACK_MESSAGE
|-
| Disarm My Target || DISARM_MESSAGE
|-
| Disable My Target || DISABLE_MESSAGE
|-
| Attack My Subsystem || ATTACK_SUBSYSTEM_MESSAGE
|-
| Capture My Target || CAPTURE_MESSAGE
|-
| Engage Enemy || ENGAGE_MESSAGE
|-
| Form on My Wing || FORM_MESSAGE
|-
| Ignore My Target || IGNORE_MESSAGE
|-
| Protect My Target || PROTECT_MESSAGE
|-
| Cover Me || COVER_MESSAGE
|-
| Return to Base || WARP_MESSAGE
|-
| Rearm Me || REARM_MESSAGE
|}

{| class="wikitable"
|+ style="color:white" | Views
|-
! $Bind Name: !! $Bind:
|-
| Chase View || VIEW_CHASE
|-
| External View || VIEW_EXTERNAL
|-
| Toggle External Camera Lock || VIEW_EXTERNAL_TOGGLE_CAMERA_LOCK
|-
| Free Look View || VIEW_SLEW
|-
| Current Target View || VIEW_OTHER_SHIP
|-
| Increase View Distance || VIEW_DIST_INCREASE
|-
| Decrease View Distance || VIEW_DIST_DECREASE
|-
| Center View || VIEW_CENTER
|-
| View Up || PADLOCK_UP
|-
| View Rear || PADLOCK_DOWN
|-
| View Left || PADLOCK_LEFT
|-
| View Right || PADLOCK_RIGHT
|-
| Top-Down View || VIEW_TOPDOWN
|-
| Target Padlock View || VIEW_TRACK_TARGET
|}

{| class="wikitable"
|-
|+ style="color:white" | ETS and Shields
|-
! $Bind Name: !! $Bind:
|-
| Increase Weapon Energy || INCREASE_WEAPON
|-
| Decrease Weapon Energy || DECREASE_WEAPON
|-
| Increase Shield Energy || INCREASE_SHIELD
|-
| Decrease Shield Energy || DECREASE_SHIELD
|-
|-
| Increase Engine Energy || INCREASE_ENGINE
|-
| Decrease Engine Energy || DECREASE_ENGINE
|-
| Equalize Energy Settings || ETS_EQUALIZE
|-
| Equalize Shields || SHIELD_EQUALIZE
|-
| Augment Forward Shield || SHIELD_XFER_TOP
|-
| Augment Rear Shield || SHIELD_XFER_BOTTOM
|-
| Augment Left Shield || SHIELD_XFER_LEFT
|-
| Augment Right Shield || SHIELD_XFER_RIGHT
|-
| Transfer Energy Laser->Shield || XFER_SHIELD
|-
| Transfer Energy Shield->Laser || XFER_LASER
|}

{| class="wikitable"
|+ style="color:white" | Misc
|-
! $Bind Name: !! $Bind:
|-
| Enter Subspace (End Mission) || END_MISSION
|-
| Increase Time Compression || TIME_SPEED_UP
|-
| Decrease Time Compression || TIME_SLOW_DOWN
|-
| Toggle Auto Pilot || AUTO_PILOT_TOGGLE
|-
| Cycle Nav Points || NAV_CYCLE
|-
| Toggle Gliding || TOGGLE_GLIDING
|-
| Toggle Auto Speed Matching || TOGGLE_AUTO_MATCH_TARGET_SPEED
|}

{| class="wikitable"
|+ style="color:white" | Multiplayer Only
|-
! $Bind Name: !! $Bind:
|-
| (Multiplayer) Message All || MULTI_MESSAGE_ALL
|-
| (Multiplayer) Message Friendly || MULTI_MESSAGE_FRIENDLY
|-
| (Multiplayer) Message Hostile || MULTI_MESSAGE_HOSTILE
|-
| (Multiplayer) Message Target || MULTI_MESSAGE_TARGET
|-
| (Multiplayer) Observer Zoom To Target || MULTI_OBSERVER_ZOOM_TO
|-
| (Multiplayer) Toggle Network info || MULTI_TOGGLE_NETINFO
|-
| (Multiplayer) Self Destruct || MULTI_SELF_DESTRUCT
|}

{| class="wikitable"
|+ style="color:white" | Custom Controls
|-
! $Bind Name: !! $Bind:
|-
| Custom Control 1 || CUSTOM_CONTROL_1
|-
| Custom Control 2 || CUSTOM_CONTROL_2
|-
| Custom Control 3 || CUSTOM_CONTROL_3
|-
| Custom Control 4 || CUSTOM_CONTROL_4
|-
| Custom Control 5 || CUSTOM_CONTROL_5
|}

{| class="wikitable"
|+ style="color:white" | Analog Controls
|-
! $Bind Name: !! $Bind:
|-
| - || JOY_HEADING_AXIS
|-
| - || JOY_PITCH_AXIS
|-
| - || JOY_BANK_AXIS
|-
| - || JOY_ABS_THROTTLE_AXIS
|-
| - || JOY_REL_THROTTLE_AXIS
|}

===Custom Controls===
{{Table382|
* 'Custom Control 1'
* 'Custom Control 2'
* 'Custom Control 3'
* 'Custom Control 4'
* 'Custom Control 5'

These are empty controls for modders and/or scripters to use.

Disabled by default

Default XSTR index is 0 (thus, they do not have an entry in [[strings.tbl]])

The default key bindings are Shift-Alt (1-5) for Custom Control 1-5, respectively.

To use these, create a new entry in a [[#ControlConfigOverride]] block and with the respective name. You should specify a label in [[strings.tbl]], otherwise they'll show up as "Custom Control" in the control config menu.

Example:
* $Bind Name: Custom Control 1
* $Has XStr: 1570
* $Disable: false
}}

==Allowed Keys==
*Not all keys are checked by FSO for key bindings, so some of these may not work.
*List coppied from controlsconfigcommon.cpp and edited to make readable.
*Must use the string below (without quotes).
*List of keys
:'KEY_0'
:'KEY_1'
:'KEY_2'
:'KEY_3'
:'KEY_4'
:'KEY_5'
:'KEY_6'
:'KEY_7'
:'KEY_8'
:'KEY_9'
:'KEY_A'
:'KEY_B'
:'KEY_C'
:'KEY_D'
:'KEY_E'
:'KEY_F'
:'KEY_G'
:'KEY_H'
:'KEY_I'
:'KEY_J'
:'KEY_K'
:'KEY_L'
:'KEY_M'
:'KEY_N'
:'KEY_O'
:'KEY_P'
:'KEY_Q'
:'KEY_R'
:'KEY_S'
:'KEY_T'
:'KEY_U'
:'KEY_V'
:'KEY_W'
:'KEY_X'
:'KEY_Y'
:'KEY_Z'
:'KEY_MINUS'
:'KEY_EQUAL'
:'KEY_DIVIDE'
:'KEY_SLASH'
:'KEY_SLASH_UK'
:'KEY_COMMA'
:'KEY_PERIOD'
:'KEY_SEMICOL'
:'KEY_LBRACKET'
:'KEY_RBRACKET'
:'KEY_RAPOSTRO'
:'KEY_LAPOSTRO'
:'KEY_ESC'
:'KEY_ENTER'
:'KEY_BACKSP'
:'KEY_TAB'
:'KEY_SPACEBAR'
:'KEY_NUMLOCK'
:'KEY_SCROLLOCK'
:'KEY_CAPSLOCK'
:'KEY_LSHIFT'
:'KEY_RSHIFT'
:'KEY_LALT'
:'KEY_RALT'
:'KEY_LCTRL'
:'KEY_RCTRL'
:'KEY_F1'
:'KEY_F2'
:'KEY_F3'
:'KEY_F4'
:'KEY_F5'
:'KEY_F6'
:'KEY_F7'
:'KEY_F8'
:'KEY_F9'
:'KEY_F10'
:'KEY_F11'
:'KEY_F12'
:'KEY_PAD0'
:'KEY_PAD1'
:'KEY_PAD2'
:'KEY_PAD3'
:'KEY_PAD4'
:'KEY_PAD5'
:'KEY_PAD6'
:'KEY_PAD7'
:'KEY_PAD8'
:'KEY_PAD9'
:'KEY_PADMINUS'
:'KEY_PADPLUS'
:'KEY_PADPERIOD'
:'KEY_PADDIVIDE'
:'KEY_PADMULTIPLY'
:'KEY_PADENTER'
:'KEY_INSERT'
:'KEY_HOME'
:'KEY_PAGEUP'
:'KEY_DELETE'
:'KEY_END'
:'KEY_PAGEDOWN'
:'KEY_UP'
:'KEY_DOWN'
:'KEY_LEFT'
:'KEY_RIGHT'
:'KEY_PRINT_SCRN'
:'KEY_PAUSE'
:'KEY_BREAK'

[[Category:Tables]]

==Debug Commands==
===save_ccd===
If running a Debug Build, the '''save_ccd''' command may be used on the debug console to save the current Control Configuration Defaults (in the default preset) to a .tbl. This should allow developers to quickly modify the default preset without needing to transcribe everything by hand, or try to use a controlconfigdefaults.tbl from somewhere else.

Controlconfigdefaults.tbl

2022-10-12T15:19:38Z

Z64555: /* Post-22.0 */

{{TableVersionGit| 2021-02-13 UTC | db2bd97669c949e7d68baa9560192b7d3ad96563}}

{{Tables}}
The '''controlconfigdefaults.tbl''' can be used to modify the default key bindings in FSO.

==#ControlConfigOverride==
* Starts an Override section
* Begins with '''#ControlConfigOverride''' and ends with '''#End'''.
* Only entries that you want to change are required, the rest will use the default binding
* Entries not listed will be assigned to their default/hardcoded values.
{{Table371|
* Multiple #ControlConfigOverride...#End blocks can be provided.
** Each block defines a separate control config preset
** The "Defaults" button in the control config screen may be used to reset to the selected preset, then cycle through to the next preset.
** The first given block is used as the "global" defaults, and is used when working with the key-pressed SEXP and LUA scripts.
** Note: It's a good idea to also use [[Strings.tbl]] to change the "Defaults" text on the button to for example "Cycle\nPresets".
}}

==#ControlConfigPreset==
{{Table212|
* Starts a Preset section
* Begins with '''#ControlConfigPreset''' and ends with '''#End'''.
* All keybinds you wish to have bound must be specified, any unspecified keys will be unbound.
}}

===$Name:===
{{Table373|
* The name of this control config preset, displayed at the top left corner of the control config screen when selected through the "Defaults" button.
* If not provided, the first [[#ControlConfigOverride]] block will override the hardcoded defaults, all subsequent blocks will be '''<unnamed preset>.'''
{{Table212|
* If not provided, the [[#ControlConfigPreset]] block will be '''<unnamed preset>'''
}}
**Syntax: '''''String'''''
}}

===$Bind Name:===
*Name of the bind or action to modify the default key of.
*Valid entries: [[Controlconfigdefaults.tbl#Table of Bindings|Table of Bindings]]
*Required
*Syntax: '''String'''
{{Table220|
As of FSO 22.0, '''$Bind Name:''' is deprecated in favor of '''$Bind:'''
}}

====$Key Default:====
*Key to set as default
*Valid entries: [[Controlconfigdefaults.tbl#Allowed Keys|Allowed Keys]]
{{Table372|
*May be unbound by specifying '''NONE''' instead of a key}}
*Optional
*Syntax: '''String'''

====$Joy Default:====
*Joystick button to set as default
*Optional
*Syntax: '''Integer'''

====$Key Mod Shift:====
*Sets the key to require the Shift key
*'''1''' for yes, '''0''' for no
*Optional
*Syntax: '''Integer'''

====$Key Mod Alt:====

*Sets the key to require the Alt key
*'''1''' for yes, '''0''' for no
*Optional
*Syntax: '''Integer'''

====$Key Mod Ctrl:====
* Sets the key to require the Ctrl key
* '''1''' for yes, '''0''' for no
* Optional
* Syntax: '''Integer'''

===$Bind:===
{{Table220|
*The IoActionID of the action to bind to.
*Valid entries: [[Controlconfigdefaults.tbl#Table of Bindings|Table of Bindings]]
*Required
*Syntax: '''String'''
}}

====$Primary:====
{{Table220|
*Denotes the following binding is a Primary binding of the control
*Optional
*Syntax: (No arguments)
}}

=====$Controller:=====
{{Table220|
*Denotes which controller this binding is for
*Required
*Syntax: '''String''', any of the following:
**'''CID_NONE'''
**'''CID_KEYBOARD'''
**'''CID_MOUSE'''
**'''CID_JOY0'''
**'''CID_JOY1'''
**'''CID_JOY2'''
**'''CID_JOY3'''
}}

=====$Flags:=====
{{Table220|
*Denotes a number of flags for button behavior
*Required
*Syntax: '''String''', any of the following:
}}
{| class="wikitable"
| '''AXIS_BTN''' || An axis that's treated as a digital control should it be deflected past a certain threshold (Note: WIP)
|-
| '''RELATIVE''' || A relative axis which increases or decreases the control's value instead of directly setting its value. (Example: Relative Throttle)
|-
| '''INVERTED''' || An axis who's input is inverted
|-
| '''AXIS''' || Input is an axis
|-
| '''HAT''' || Input is a POV HAT switch
|-
| '''BALL''' || Input is a trackball
|-
| '''NONE''' || Input is assumed to be a standard button or key
|}

=====$Input:=====
{{Table220|
*Which button, key, or axis is bound
*Required
*Syntax: '''string''', any of the following:

Joystick axes:
*'''X_AXIS'''
*'''Y_AXIS'''
*'''Z_AXIS'''
*'''RX_AXIS'''
*'''RY_AXIS'''
*'''RZ_AXIS'''

Joystick Buttons:
*Buttons are simply the button number, such as "1" for button 1.

Mouse Buttons:
*'''LEFT_BUTTON'''
*'''RIGHT_BUTTON'''
*'''MIDDLE_BUTTON'''
*'''X1_BUTTON'''
*'''X2_BUTTON'''
*'''WHEEL_UP'''
*'''WHEEL_DOWN'''
*'''WHEEL_LEFT'''
*'''WHEEL_RIGHT'''

Keyboard Keys:
[[Controlconfigdefaults.tbl#Allowed Keys|Allowed Keys]]
*Key modifiers '''ALT-''' and '''SHIFT-''' can be prepended to the Key ID.
**Example: '''ALT-J''', '''SHIFT-KEY_Q''', '''ALT-SHIFT-KEY_1'''
}}

====$Secondary:====
{{Table220|
*Denotes the following binding is a Secondary binding of the control
*Has the same suboptions as [[Controlconfigdefaults.tbl#$Primary:|$Primary]]
*Optional
*Syntax: (No Arguments)
}}

===$Category:===
* Tab where the binding appears in the options menu.
* Valid entries: TARGET_TAB, SHIP_TAB, WEAPON_TAB, COMPUTER_TAB
* Optional
* Only valid in [[#ControlConfigOverride]] blocks
* Syntax: '''String'''

===$Text:===
{{Table212|
* The label of the control to use in the controls config menu.
* Is overridden by XSTR, if provided
** '''Note:''' This is meant to be a lazy temporary substitution to modifying [[strings.tbl]]. Your released mod should nstill provide its own strings.tbl.
* Optional
* Syntax: '''String'''
}}

===$Has XStr:===
* Whether or not the binding has an entry in [[strings.tbl]]
** If '''0''', assumes no XSTR is provided
** If '''1''', assumes an XSTR is provided alongside the other ControlConfig strings according to its internal, hardcoded index
{{Table382|
** If any nonzero integer >1, is the exact XSTR index within [[strings.tbl]]
}}
* Optional
* Only valid in [[#ControlConfigOverride]] blocks
* Syntax: '''Integer'''

===$Type:===
*Determines the type of control this is.

*Valid entries:
**CC_TYPE_TRIGGER
***Normal control that activates upon the first press. Resetting devices (such as weapons) will keep firing as long as the key/button is held down.
**CC_TYPE_CONTINUOUS
***Control that activates when the key/button is held down, and stays activated until the key/button is released. Ex: Afterburner key.
*Optional
*Only valid in [[#ControlConfigOverride]] blocks
*Syntax '''String'''

===$Disable:===
{{Table373|
*Determines whether the binding can be used and appears in the options menu. Can be used to hide bindings which are not needed, or to enable bindings which are hidden by default.
*Syntax: '''''Boolean'''''
}}

===+Disable===
{{Table212|
* Disables the control
* Optional
* Only valid in [[#ControlConfigOverride]] blocks
* Syntax: (No arguments)
}}

==#End==
* All [[#ControlConfigOverride]] and [[#ControlConfigPreset]] sections must be terminated by #End

==Sample==
===Post-22.0===
{{Table220|
This example is for Post-22.0 and does the following...
*Sets Clear Escort List to Alt-Shift-Q
*Sets Target Target's Attacker to Alt-Shift-J and Button 2 on Joystick 0, moves it to the Ship Tab, denotes it's type as a trigger and sets it to not have a XString
*Sets Transfer Energy from Shield to Laser to R

Note that for compatibility, FSO builds 22.0 and later can still read Pre-22.0 format.

Note: the indents are optional, and are provided to improve readibility.
}}

<pre>
#ControlConfigOverride

$Bind: ESCORT_CLEAR
$Primary:
$Controller: CID_KEYBOARD
$Flags: NONE
$Input: ALT-SHIFT-KEY_Q

$Bind: TARGET_CLOSEST_SHIP_ATTACKING_TARGET
$Primary:
$Controller: CID_KEYBOARD
$Flags: NONE
$Input: ALT-SHIFT-KEY_J
$Secondary:
$Controller: CID_JOY0
$Flags: NONE
$Input: 2
$Category: SHIP_TAB
$Has XStr: 0
$TYPE: CC_TYPE_TRIGGER

$Bind: XFER_LASER
$Primary:
$Controller: CID_KEYBOARD
$FLAGS: NONE
$Inpute: KEY_R

#End
</pre>

===Pre-22.0===
This example is for Pre-22.0 and does the following...
*Sets Clear Escort List to Alt-Shift-Q
*Sets Target Target's Attacker to Ctrl-Alt-Shift-J, moves it to the Ship Tab, denotes it's type as a trigger and sets it to not have a XString
*Sets Transfer Energy from Shield to Laser to R

<pre>
#ControlConfigOverride

$Bind Name: Clear Escort List
$Key Default: KEY_Q
$Key Mod Shift: 1
$Key Mod Alt: 1

$Bind Name: Target Target's Nearest Attacker
$Key Default: KEY_J
$Key Mod Shift: 1
$Key Mod Alt: 1
$Key Mod Ctrl: 1
$Category: SHIP_TAB
$Has XStr: 0
$TYPE: CC_TYPE_TRIGGER

$Bind Name: Transfer Energy Shield->Laser
$Key Default: KEY_R

#End
</pre>

==Table of Bindings==
* This is a table of all possible bindings that can be modified, grouped into smaller tables for easier reference.
* '''$Bind Name:''' column is to be used with '''$Bind Name:''' entries, and '''$Bind:''' column is to be used with '''$Bind:''' entries.
* These bindings are case-sensitive
* Controls added after 22.0 might not have a '''$Bind Name:'''. Use the '''$Bind:''' identifier instead.
{| class="wikitable"
|+ style="color:white" | Targeting
|-
! $Bind Name: !! $Bind:
|-
| Target Next Ship || TARGET_NEXT
|-
| Target Previous Ship || TARGET_PREV
|-
| Target Next Closest Hostile Ship || TARGET_NEXT_CLOSEST_HOSTILE
|-
| Target Previous Closest Hostile Ship || TARGET_PREV_CLOSEST_HOSTILE
|-
| Toggle Auto Targeting || TOGGLE_AUTO_TARGETING
|-
| Target Next Closest Friendly Ship || TARGET_NEXT_CLOSEST_FRIENDLY
|-
| Target Previous Closest Friendly Ship || TARGET_PREV_CLOSEST_FRIENDLY
|-
| Target Ship in Reticle || TARGET_SHIP_IN_RETICLE
|-
| Target Targets Nearest Attacker || TARGET_CLOSEST_SHIP_ATTACKING_TARGET
|-
| Target Last Ship to Send Transmission || TARGET_LAST_TRANMISSION_SENDER
|-
| Turn Off Targeting || STOP_TARGETING_SHIP
|-
| Target Closest Attacking Ship || TARGET_CLOSEST_SHIP_ATTACKING_SELF
|-
| Target Next Escort Ship || TARGET_NEXT_ESCORT_SHIP
|-
| Target Closest Repair Ship || TARGET_CLOSEST_REPAIR_SHIP
|-
| Target Next Uninspected Cargo || TARGET_NEXT_UNINSPECTED_CARGO
|-
| Target Previous Uninspected Cargo || TARGET_PREV_UNINSPECTED_CARGO
|-
| Target Newest Ship in Area || TARGET_NEWEST_SHIP
|-
| Target Targets Target || TARGET_TARGETS_TARGET
|-
| Target Next Hostile Bomb or Bomber || TARGET_NEXT_BOMB
|-
| Target Previous Hostile Bomb or Bomber || TARGET_PREV_BOMB
|}

{| class="wikitable"
|+ style="color:white" | Targeting Subsystems and Turrets
|-
! $Bind Name: !! $Bind:
|-
| Target Subsystem in Reticle || TARGET_SUBOBJECT_IN_RETICLE
|-
| Target Next Subsystem || TARGET_NEXT_SUBOBJECT
|-
| Target Previous Subsystem || TARGET_PREV_SUBOBJECT
|-
| Turn Off Targeting of Subsystems || STOP_TARGETING_SUBSYSTEM
|-
| Target Next Live Turret || TARGET_NEXT_LIVE_TURRET
|-
| Target Previous Live Turret || TARGET_PREV_LIVE_TURRET
|}

{| class="wikitable"
|+ style="color:white" | Weapons
|-
! $Bind Name: !! $Bind:
|-
| Fire Primary Weapon || FIRE_PRIMARY
|-
| Fire Secondary Weapon || FIRE_SECONDARY
|-
| Cycle Forward Primary Weapon || CYCLE_NEXT_PRIMARY
|-
| Cycle Backward Primary Weapon || CYCLE_PREV_PRIMARY
|-
| Cycle Primary Weapon Firing Rate || CYCLE_PRIMARY_WEAPON_SEQUENCE
|-
| Cycle Secondary Weapon Bank || CYCLE_SECONDARY
|-
| Cycle Secondary Weapon Firing Rate || CYCLE_NUM_MISSLES
|-
| Launch Countermeasure || LAUNCH_COUNTERMEASURE
|}

{| class="wikitable"
|+ style="color:white" | Flight Controls
|-
! $Bind Name: !! $Bind:
|-
| Forward Thrust || FORWARD_THRUST
|-
| Reverse Thrust || REVERSE_THRUST
|-
| Bank Left || BANK_LEFT
|-
| Bank Right || BANK_RIGHT
|-
| Pitch Forward || PITCH_FORWARD
|-
| Pitch Backward || PITCH_BACK
|-
| Turn Left || YAW_LEFT
|-
| Turn Right || YAW_RIGHT
|-
| Right Thrust || RIGHT_SLIDE_THRUST
|-
| Left Thrust || LEFT_SLIDE_THRUST
|-
| Up Thrust || UP_SLIDE_THRUST
|-
| Down Thrust || DOWN_SLIDE_THRUST
|-
| Afterburner || AFTERBURNER
|-
| Glide When Pressed || GLIDE_WHEN_PRESSED
|-
| Bank When Pressed || BANK_WHEN_PRESSED
|-
| Match Target Speed || MATCH_TARGET_SPEED
|}

{| class="wikitable"
|-
|+ style="color:white" | Throttle Control
|-
! $Bind Name: !! $Bind:
|-
| Set Throttle to Zero || ZERO_THROTTLE
|-
| Set Throttle to Max || MAX_THROTTLE
|-
| Set Throttle to One-Third || ONE_THIRD_THROTTLE
|-
| Set Throttle to Two-Thirds || TWO_THIRDS_THROTTLE
|-
| Increase Throttle 5 Percent || PLUS_5_PERCENT_THROTTLE
|-
| Decrease Throttle 5 Percent || MINUS_5_PERCENT_THROTTLE
|}

{| class="wikitable"
|+ style="color:white" | HUD Controls
|-
! $Bind Name: !! $Bind:
|-
| Toggle High HUD Contrast || TOGGLE_HUD_CONTRAST
|-
| Toggle HUD || TOGGLE_HUD
|-
| Toggle HUD Wireframe Target View || HUD_TARGETBOX_TOGGLE_WIREFRAME
|-
| Cycle Radar Range || RADAR_RANGE_CYCLE
|-
| Communications Menu || SQUADMSG_MENU
|-
| Show Objectives || SHOW_GOALS
|-
| Show Nav Map || SHOW_NAVMAP
|-
| Add or Remove Escort || ADD_REMOVE_ESCORT
|-
| Clear Escort List || ESCORT_CLEAR
|-
| - || TOGGLE_HUD_SHADOWS
|}

{| class="wikitable"
|+ style="color:white" | Squadmate Messaging
|-
! $Bind Name: !! $Bind:
|-
| Attack My Target || ATTACK_MESSAGE
|-
| Disarm My Target || DISARM_MESSAGE
|-
| Disable My Target || DISABLE_MESSAGE
|-
| Attack My Subsystem || ATTACK_SUBSYSTEM_MESSAGE
|-
| Capture My Target || CAPTURE_MESSAGE
|-
| Engage Enemy || ENGAGE_MESSAGE
|-
| Form on My Wing || FORM_MESSAGE
|-
| Ignore My Target || IGNORE_MESSAGE
|-
| Protect My Target || PROTECT_MESSAGE
|-
| Cover Me || COVER_MESSAGE
|-
| Return to Base || WARP_MESSAGE
|-
| Rearm Me || REARM_MESSAGE
|}

{| class="wikitable"
|+ style="color:white" | Views
|-
! $Bind Name: !! $Bind:
|-
| Chase View || VIEW_CHASE
|-
| External View || VIEW_EXTERNAL
|-
| Toggle External Camera Lock || VIEW_EXTERNAL_TOGGLE_CAMERA_LOCK
|-
| Free Look View || VIEW_SLEW
|-
| Current Target View || VIEW_OTHER_SHIP
|-
| Increase View Distance || VIEW_DIST_INCREASE
|-
| Decrease View Distance || VIEW_DIST_DECREASE
|-
| Center View || VIEW_CENTER
|-
| View Up || PADLOCK_UP
|-
| View Rear || PADLOCK_DOWN
|-
| View Left || PADLOCK_LEFT
|-
| View Right || PADLOCK_RIGHT
|-
| Top-Down View || VIEW_TOPDOWN
|-
| Target Padlock View || VIEW_TRACK_TARGET
|}

{| class="wikitable"
|-
|+ style="color:white" | ETS and Shields
|-
! $Bind Name: !! $Bind:
|-
| Increase Weapon Energy || INCREASE_WEAPON
|-
| Decrease Weapon Energy || DECREASE_WEAPON
|-
| Increase Shield Energy || INCREASE_SHIELD
|-
| Decrease Shield Energy || DECREASE_SHIELD
|-
|-
| Increase Engine Energy || INCREASE_ENGINE
|-
| Decrease Engine Energy || DECREASE_ENGINE
|-
| Equalize Energy Settings || ETS_EQUALIZE
|-
| Equalize Shields || SHIELD_EQUALIZE
|-
| Augment Forward Shield || SHIELD_XFER_TOP
|-
| Augment Rear Shield || SHIELD_XFER_BOTTOM
|-
| Augment Left Shield || SHIELD_XFER_LEFT
|-
| Augment Right Shield || SHIELD_XFER_RIGHT
|-
| Transfer Energy Laser->Shield || XFER_SHIELD
|-
| Transfer Energy Shield->Laser || XFER_LASER
|}

{| class="wikitable"
|+ style="color:white" | Misc
|-
! $Bind Name: !! $Bind:
|-
| Enter Subspace (End Mission) || END_MISSION
|-
| Increase Time Compression || TIME_SPEED_UP
|-
| Decrease Time Compression || TIME_SLOW_DOWN
|-
| Toggle Auto Pilot || AUTO_PILOT_TOGGLE
|-
| Cycle Nav Points || NAV_CYCLE
|-
| Toggle Gliding || TOGGLE_GLIDING
|-
| Toggle Auto Speed Matching || TOGGLE_AUTO_MATCH_TARGET_SPEED
|}

{| class="wikitable"
|+ style="color:white" | Multiplayer Only
|-
! $Bind Name: !! $Bind:
|-
| (Multiplayer) Message All || MULTI_MESSAGE_ALL
|-
| (Multiplayer) Message Friendly || MULTI_MESSAGE_FRIENDLY
|-
| (Multiplayer) Message Hostile || MULTI_MESSAGE_HOSTILE
|-
| (Multiplayer) Message Target || MULTI_MESSAGE_TARGET
|-
| (Multiplayer) Observer Zoom To Target || MULTI_OBSERVER_ZOOM_TO
|-
| (Multiplayer) Toggle Network info || MULTI_TOGGLE_NETINFO
|-
| (Multiplayer) Self Destruct || MULTI_SELF_DESTRUCT
|}

{| class="wikitable"
|+ style="color:white" | Custom Controls
|-
! $Bind Name: !! $Bind:
|-
| Custom Control 1 || CUSTOM_CONTROL_1
|-
| Custom Control 2 || CUSTOM_CONTROL_2
|-
| Custom Control 3 || CUSTOM_CONTROL_3
|-
| Custom Control 4 || CUSTOM_CONTROL_4
|-
| Custom Control 5 || CUSTOM_CONTROL_5
|}

{| class="wikitable"
|+ style="color:white" | Analog Controls
|-
! $Bind Name: !! $Bind:
|-
| - || JOY_HEADING_AXIS
|-
| - || JOY_PITCH_AXIS
|-
| - || JOY_BANK_AXIS
|-
| - || JOY_ABS_THROTTLE_AXIS
|-
| - || JOY_REL_THROTTLE_AXIS
|}

===Custom Controls===
{{Table382|
* 'Custom Control 1'
* 'Custom Control 2'
* 'Custom Control 3'
* 'Custom Control 4'
* 'Custom Control 5'

These are empty controls for modders and/or scripters to use.

Disabled by default

Default XSTR index is 0 (thus, they do not have an entry in [[strings.tbl]])

The default key bindings are Shift-Alt (1-5) for Custom Control 1-5, respectively.

To use these, create a new entry in a [[#ControlConfigOverride]] block and with the respective name. You should specify a label in [[strings.tbl]], otherwise they'll show up as "Custom Control" in the control config menu.

Example:
* $Bind Name: Custom Control 1
* $Has XStr: 1570
* $Disable: false
}}

==Allowed Keys==
*Not all keys are checked by FSO for key bindings, so some of these may not work.
*List coppied from controlsconfigcommon.cpp and edited to make readable.
*Must use the string below (without quotes).
*List of keys
:'KEY_0'
:'KEY_1'
:'KEY_2'
:'KEY_3'
:'KEY_4'
:'KEY_5'
:'KEY_6'
:'KEY_7'
:'KEY_8'
:'KEY_9'
:'KEY_A'
:'KEY_B'
:'KEY_C'
:'KEY_D'
:'KEY_E'
:'KEY_F'
:'KEY_G'
:'KEY_H'
:'KEY_I'
:'KEY_J'
:'KEY_K'
:'KEY_L'
:'KEY_M'
:'KEY_N'
:'KEY_O'
:'KEY_P'
:'KEY_Q'
:'KEY_R'
:'KEY_S'
:'KEY_T'
:'KEY_U'
:'KEY_V'
:'KEY_W'
:'KEY_X'
:'KEY_Y'
:'KEY_Z'
:'KEY_MINUS'
:'KEY_EQUAL'
:'KEY_DIVIDE'
:'KEY_SLASH'
:'KEY_SLASH_UK'
:'KEY_COMMA'
:'KEY_PERIOD'
:'KEY_SEMICOL'
:'KEY_LBRACKET'
:'KEY_RBRACKET'
:'KEY_RAPOSTRO'
:'KEY_LAPOSTRO'
:'KEY_ESC'
:'KEY_ENTER'
:'KEY_BACKSP'
:'KEY_TAB'
:'KEY_SPACEBAR'
:'KEY_NUMLOCK'
:'KEY_SCROLLOCK'
:'KEY_CAPSLOCK'
:'KEY_LSHIFT'
:'KEY_RSHIFT'
:'KEY_LALT'
:'KEY_RALT'
:'KEY_LCTRL'
:'KEY_RCTRL'
:'KEY_F1'
:'KEY_F2'
:'KEY_F3'
:'KEY_F4'
:'KEY_F5'
:'KEY_F6'
:'KEY_F7'
:'KEY_F8'
:'KEY_F9'
:'KEY_F10'
:'KEY_F11'
:'KEY_F12'
:'KEY_PAD0'
:'KEY_PAD1'
:'KEY_PAD2'
:'KEY_PAD3'
:'KEY_PAD4'
:'KEY_PAD5'
:'KEY_PAD6'
:'KEY_PAD7'
:'KEY_PAD8'
:'KEY_PAD9'
:'KEY_PADMINUS'
:'KEY_PADPLUS'
:'KEY_PADPERIOD'
:'KEY_PADDIVIDE'
:'KEY_PADMULTIPLY'
:'KEY_PADENTER'
:'KEY_INSERT'
:'KEY_HOME'
:'KEY_PAGEUP'
:'KEY_DELETE'
:'KEY_END'
:'KEY_PAGEDOWN'
:'KEY_UP'
:'KEY_DOWN'
:'KEY_LEFT'
:'KEY_RIGHT'
:'KEY_PRINT_SCRN'
:'KEY_PAUSE'
:'KEY_BREAK'

[[Category:Tables]]

Controlconfigdefaults.tbl

2022-10-12T15:19:24Z

Z64555: /* Post-22.0 */

{{TableVersionGit| 2021-02-13 UTC | db2bd97669c949e7d68baa9560192b7d3ad96563}}

{{Tables}}
The '''controlconfigdefaults.tbl''' can be used to modify the default key bindings in FSO.

==#ControlConfigOverride==
* Starts an Override section
* Begins with '''#ControlConfigOverride''' and ends with '''#End'''.
* Only entries that you want to change are required, the rest will use the default binding
* Entries not listed will be assigned to their default/hardcoded values.
{{Table371|
* Multiple #ControlConfigOverride...#End blocks can be provided.
** Each block defines a separate control config preset
** The "Defaults" button in the control config screen may be used to reset to the selected preset, then cycle through to the next preset.
** The first given block is used as the "global" defaults, and is used when working with the key-pressed SEXP and LUA scripts.
** Note: It's a good idea to also use [[Strings.tbl]] to change the "Defaults" text on the button to for example "Cycle\nPresets".
}}

==#ControlConfigPreset==
{{Table212|
* Starts a Preset section
* Begins with '''#ControlConfigPreset''' and ends with '''#End'''.
* All keybinds you wish to have bound must be specified, any unspecified keys will be unbound.
}}

===$Name:===
{{Table373|
* The name of this control config preset, displayed at the top left corner of the control config screen when selected through the "Defaults" button.
* If not provided, the first [[#ControlConfigOverride]] block will override the hardcoded defaults, all subsequent blocks will be '''<unnamed preset>.'''
{{Table212|
* If not provided, the [[#ControlConfigPreset]] block will be '''<unnamed preset>'''
}}
**Syntax: '''''String'''''
}}

===$Bind Name:===
*Name of the bind or action to modify the default key of.
*Valid entries: [[Controlconfigdefaults.tbl#Table of Bindings|Table of Bindings]]
*Required
*Syntax: '''String'''
{{Table220|
As of FSO 22.0, '''$Bind Name:''' is deprecated in favor of '''$Bind:'''
}}

====$Key Default:====
*Key to set as default
*Valid entries: [[Controlconfigdefaults.tbl#Allowed Keys|Allowed Keys]]
{{Table372|
*May be unbound by specifying '''NONE''' instead of a key}}
*Optional
*Syntax: '''String'''

====$Joy Default:====
*Joystick button to set as default
*Optional
*Syntax: '''Integer'''

====$Key Mod Shift:====
*Sets the key to require the Shift key
*'''1''' for yes, '''0''' for no
*Optional
*Syntax: '''Integer'''

====$Key Mod Alt:====

*Sets the key to require the Alt key
*'''1''' for yes, '''0''' for no
*Optional
*Syntax: '''Integer'''

====$Key Mod Ctrl:====
* Sets the key to require the Ctrl key
* '''1''' for yes, '''0''' for no
* Optional
* Syntax: '''Integer'''

===$Bind:===
{{Table220|
*The IoActionID of the action to bind to.
*Valid entries: [[Controlconfigdefaults.tbl#Table of Bindings|Table of Bindings]]
*Required
*Syntax: '''String'''
}}

====$Primary:====
{{Table220|
*Denotes the following binding is a Primary binding of the control
*Optional
*Syntax: (No arguments)
}}

=====$Controller:=====
{{Table220|
*Denotes which controller this binding is for
*Required
*Syntax: '''String''', any of the following:
**'''CID_NONE'''
**'''CID_KEYBOARD'''
**'''CID_MOUSE'''
**'''CID_JOY0'''
**'''CID_JOY1'''
**'''CID_JOY2'''
**'''CID_JOY3'''
}}

=====$Flags:=====
{{Table220|
*Denotes a number of flags for button behavior
*Required
*Syntax: '''String''', any of the following:
}}
{| class="wikitable"
| '''AXIS_BTN''' || An axis that's treated as a digital control should it be deflected past a certain threshold (Note: WIP)
|-
| '''RELATIVE''' || A relative axis which increases or decreases the control's value instead of directly setting its value. (Example: Relative Throttle)
|-
| '''INVERTED''' || An axis who's input is inverted
|-
| '''AXIS''' || Input is an axis
|-
| '''HAT''' || Input is a POV HAT switch
|-
| '''BALL''' || Input is a trackball
|-
| '''NONE''' || Input is assumed to be a standard button or key
|}

=====$Input:=====
{{Table220|
*Which button, key, or axis is bound
*Required
*Syntax: '''string''', any of the following:

Joystick axes:
*'''X_AXIS'''
*'''Y_AXIS'''
*'''Z_AXIS'''
*'''RX_AXIS'''
*'''RY_AXIS'''
*'''RZ_AXIS'''

Joystick Buttons:
*Buttons are simply the button number, such as "1" for button 1.

Mouse Buttons:
*'''LEFT_BUTTON'''
*'''RIGHT_BUTTON'''
*'''MIDDLE_BUTTON'''
*'''X1_BUTTON'''
*'''X2_BUTTON'''
*'''WHEEL_UP'''
*'''WHEEL_DOWN'''
*'''WHEEL_LEFT'''
*'''WHEEL_RIGHT'''

Keyboard Keys:
[[Controlconfigdefaults.tbl#Allowed Keys|Allowed Keys]]
*Key modifiers '''ALT-''' and '''SHIFT-''' can be prepended to the Key ID.
**Example: '''ALT-J''', '''SHIFT-KEY_Q''', '''ALT-SHIFT-KEY_1'''
}}

====$Secondary:====
{{Table220|
*Denotes the following binding is a Secondary binding of the control
*Has the same suboptions as [[Controlconfigdefaults.tbl#$Primary:|$Primary]]
*Optional
*Syntax: (No Arguments)
}}

===$Category:===
* Tab where the binding appears in the options menu.
* Valid entries: TARGET_TAB, SHIP_TAB, WEAPON_TAB, COMPUTER_TAB
* Optional
* Only valid in [[#ControlConfigOverride]] blocks
* Syntax: '''String'''

===$Text:===
{{Table212|
* The label of the control to use in the controls config menu.
* Is overridden by XSTR, if provided
** '''Note:''' This is meant to be a lazy temporary substitution to modifying [[strings.tbl]]. Your released mod should nstill provide its own strings.tbl.
* Optional
* Syntax: '''String'''
}}

===$Has XStr:===
* Whether or not the binding has an entry in [[strings.tbl]]
** If '''0''', assumes no XSTR is provided
** If '''1''', assumes an XSTR is provided alongside the other ControlConfig strings according to its internal, hardcoded index
{{Table382|
** If any nonzero integer >1, is the exact XSTR index within [[strings.tbl]]
}}
* Optional
* Only valid in [[#ControlConfigOverride]] blocks
* Syntax: '''Integer'''

===$Type:===
*Determines the type of control this is.

*Valid entries:
**CC_TYPE_TRIGGER
***Normal control that activates upon the first press. Resetting devices (such as weapons) will keep firing as long as the key/button is held down.
**CC_TYPE_CONTINUOUS
***Control that activates when the key/button is held down, and stays activated until the key/button is released. Ex: Afterburner key.
*Optional
*Only valid in [[#ControlConfigOverride]] blocks
*Syntax '''String'''

===$Disable:===
{{Table373|
*Determines whether the binding can be used and appears in the options menu. Can be used to hide bindings which are not needed, or to enable bindings which are hidden by default.
*Syntax: '''''Boolean'''''
}}

===+Disable===
{{Table212|
* Disables the control
* Optional
* Only valid in [[#ControlConfigOverride]] blocks
* Syntax: (No arguments)
}}

==#End==
* All [[#ControlConfigOverride]] and [[#ControlConfigPreset]] sections must be terminated by #End

==Sample==
===Post-22.0===
{{Table220|
This example is for Post-22.0 and does the following...
*Sets Clear Escort List to Alt-Shift-Q
*Sets Target Target's Attacker to Alt-Shift-J and Button 2 on Joystick 0, moves it to the Ship Tab, denotes it's type as a trigger and sets it to not have a XString
*Sets Transfer Energy from Shield to Laser to R

Note that for compatibility, FSO builds 22.0 and later can still read Pre-22.0 format.
Note: the indents are optional, and are provided to improve readibility.
}}

<pre>
#ControlConfigOverride

$Bind: ESCORT_CLEAR
$Primary:
$Controller: CID_KEYBOARD
$Flags: NONE
$Input: ALT-SHIFT-KEY_Q

$Bind: TARGET_CLOSEST_SHIP_ATTACKING_TARGET
$Primary:
$Controller: CID_KEYBOARD
$Flags: NONE
$Input: ALT-SHIFT-KEY_J
$Secondary:
$Controller: CID_JOY0
$Flags: NONE
$Input: 2
$Category: SHIP_TAB
$Has XStr: 0
$TYPE: CC_TYPE_TRIGGER

$Bind: XFER_LASER
$Primary:
$Controller: CID_KEYBOARD
$FLAGS: NONE
$Inpute: KEY_R

#End
</pre>

===Pre-22.0===
This example is for Pre-22.0 and does the following...
*Sets Clear Escort List to Alt-Shift-Q
*Sets Target Target's Attacker to Ctrl-Alt-Shift-J, moves it to the Ship Tab, denotes it's type as a trigger and sets it to not have a XString
*Sets Transfer Energy from Shield to Laser to R

<pre>
#ControlConfigOverride

$Bind Name: Clear Escort List
$Key Default: KEY_Q
$Key Mod Shift: 1
$Key Mod Alt: 1

$Bind Name: Target Target's Nearest Attacker
$Key Default: KEY_J
$Key Mod Shift: 1
$Key Mod Alt: 1
$Key Mod Ctrl: 1
$Category: SHIP_TAB
$Has XStr: 0
$TYPE: CC_TYPE_TRIGGER

$Bind Name: Transfer Energy Shield->Laser
$Key Default: KEY_R

#End
</pre>

==Table of Bindings==
* This is a table of all possible bindings that can be modified, grouped into smaller tables for easier reference.
* '''$Bind Name:''' column is to be used with '''$Bind Name:''' entries, and '''$Bind:''' column is to be used with '''$Bind:''' entries.
* These bindings are case-sensitive
* Controls added after 22.0 might not have a '''$Bind Name:'''. Use the '''$Bind:''' identifier instead.
{| class="wikitable"
|+ style="color:white" | Targeting
|-
! $Bind Name: !! $Bind:
|-
| Target Next Ship || TARGET_NEXT
|-
| Target Previous Ship || TARGET_PREV
|-
| Target Next Closest Hostile Ship || TARGET_NEXT_CLOSEST_HOSTILE
|-
| Target Previous Closest Hostile Ship || TARGET_PREV_CLOSEST_HOSTILE
|-
| Toggle Auto Targeting || TOGGLE_AUTO_TARGETING
|-
| Target Next Closest Friendly Ship || TARGET_NEXT_CLOSEST_FRIENDLY
|-
| Target Previous Closest Friendly Ship || TARGET_PREV_CLOSEST_FRIENDLY
|-
| Target Ship in Reticle || TARGET_SHIP_IN_RETICLE
|-
| Target Targets Nearest Attacker || TARGET_CLOSEST_SHIP_ATTACKING_TARGET
|-
| Target Last Ship to Send Transmission || TARGET_LAST_TRANMISSION_SENDER
|-
| Turn Off Targeting || STOP_TARGETING_SHIP
|-
| Target Closest Attacking Ship || TARGET_CLOSEST_SHIP_ATTACKING_SELF
|-
| Target Next Escort Ship || TARGET_NEXT_ESCORT_SHIP
|-
| Target Closest Repair Ship || TARGET_CLOSEST_REPAIR_SHIP
|-
| Target Next Uninspected Cargo || TARGET_NEXT_UNINSPECTED_CARGO
|-
| Target Previous Uninspected Cargo || TARGET_PREV_UNINSPECTED_CARGO
|-
| Target Newest Ship in Area || TARGET_NEWEST_SHIP
|-
| Target Targets Target || TARGET_TARGETS_TARGET
|-
| Target Next Hostile Bomb or Bomber || TARGET_NEXT_BOMB
|-
| Target Previous Hostile Bomb or Bomber || TARGET_PREV_BOMB
|}

{| class="wikitable"
|+ style="color:white" | Targeting Subsystems and Turrets
|-
! $Bind Name: !! $Bind:
|-
| Target Subsystem in Reticle || TARGET_SUBOBJECT_IN_RETICLE
|-
| Target Next Subsystem || TARGET_NEXT_SUBOBJECT
|-
| Target Previous Subsystem || TARGET_PREV_SUBOBJECT
|-
| Turn Off Targeting of Subsystems || STOP_TARGETING_SUBSYSTEM
|-
| Target Next Live Turret || TARGET_NEXT_LIVE_TURRET
|-
| Target Previous Live Turret || TARGET_PREV_LIVE_TURRET
|}

{| class="wikitable"
|+ style="color:white" | Weapons
|-
! $Bind Name: !! $Bind:
|-
| Fire Primary Weapon || FIRE_PRIMARY
|-
| Fire Secondary Weapon || FIRE_SECONDARY
|-
| Cycle Forward Primary Weapon || CYCLE_NEXT_PRIMARY
|-
| Cycle Backward Primary Weapon || CYCLE_PREV_PRIMARY
|-
| Cycle Primary Weapon Firing Rate || CYCLE_PRIMARY_WEAPON_SEQUENCE
|-
| Cycle Secondary Weapon Bank || CYCLE_SECONDARY
|-
| Cycle Secondary Weapon Firing Rate || CYCLE_NUM_MISSLES
|-
| Launch Countermeasure || LAUNCH_COUNTERMEASURE
|}

{| class="wikitable"
|+ style="color:white" | Flight Controls
|-
! $Bind Name: !! $Bind:
|-
| Forward Thrust || FORWARD_THRUST
|-
| Reverse Thrust || REVERSE_THRUST
|-
| Bank Left || BANK_LEFT
|-
| Bank Right || BANK_RIGHT
|-
| Pitch Forward || PITCH_FORWARD
|-
| Pitch Backward || PITCH_BACK
|-
| Turn Left || YAW_LEFT
|-
| Turn Right || YAW_RIGHT
|-
| Right Thrust || RIGHT_SLIDE_THRUST
|-
| Left Thrust || LEFT_SLIDE_THRUST
|-
| Up Thrust || UP_SLIDE_THRUST
|-
| Down Thrust || DOWN_SLIDE_THRUST
|-
| Afterburner || AFTERBURNER
|-
| Glide When Pressed || GLIDE_WHEN_PRESSED
|-
| Bank When Pressed || BANK_WHEN_PRESSED
|-
| Match Target Speed || MATCH_TARGET_SPEED
|}

{| class="wikitable"
|-
|+ style="color:white" | Throttle Control
|-
! $Bind Name: !! $Bind:
|-
| Set Throttle to Zero || ZERO_THROTTLE
|-
| Set Throttle to Max || MAX_THROTTLE
|-
| Set Throttle to One-Third || ONE_THIRD_THROTTLE
|-
| Set Throttle to Two-Thirds || TWO_THIRDS_THROTTLE
|-
| Increase Throttle 5 Percent || PLUS_5_PERCENT_THROTTLE
|-
| Decrease Throttle 5 Percent || MINUS_5_PERCENT_THROTTLE
|}

{| class="wikitable"
|+ style="color:white" | HUD Controls
|-
! $Bind Name: !! $Bind:
|-
| Toggle High HUD Contrast || TOGGLE_HUD_CONTRAST
|-
| Toggle HUD || TOGGLE_HUD
|-
| Toggle HUD Wireframe Target View || HUD_TARGETBOX_TOGGLE_WIREFRAME
|-
| Cycle Radar Range || RADAR_RANGE_CYCLE
|-
| Communications Menu || SQUADMSG_MENU
|-
| Show Objectives || SHOW_GOALS
|-
| Show Nav Map || SHOW_NAVMAP
|-
| Add or Remove Escort || ADD_REMOVE_ESCORT
|-
| Clear Escort List || ESCORT_CLEAR
|-
| - || TOGGLE_HUD_SHADOWS
|}

{| class="wikitable"
|+ style="color:white" | Squadmate Messaging
|-
! $Bind Name: !! $Bind:
|-
| Attack My Target || ATTACK_MESSAGE
|-
| Disarm My Target || DISARM_MESSAGE
|-
| Disable My Target || DISABLE_MESSAGE
|-
| Attack My Subsystem || ATTACK_SUBSYSTEM_MESSAGE
|-
| Capture My Target || CAPTURE_MESSAGE
|-
| Engage Enemy || ENGAGE_MESSAGE
|-
| Form on My Wing || FORM_MESSAGE
|-
| Ignore My Target || IGNORE_MESSAGE
|-
| Protect My Target || PROTECT_MESSAGE
|-
| Cover Me || COVER_MESSAGE
|-
| Return to Base || WARP_MESSAGE
|-
| Rearm Me || REARM_MESSAGE
|}

{| class="wikitable"
|+ style="color:white" | Views
|-
! $Bind Name: !! $Bind:
|-
| Chase View || VIEW_CHASE
|-
| External View || VIEW_EXTERNAL
|-
| Toggle External Camera Lock || VIEW_EXTERNAL_TOGGLE_CAMERA_LOCK
|-
| Free Look View || VIEW_SLEW
|-
| Current Target View || VIEW_OTHER_SHIP
|-
| Increase View Distance || VIEW_DIST_INCREASE
|-
| Decrease View Distance || VIEW_DIST_DECREASE
|-
| Center View || VIEW_CENTER
|-
| View Up || PADLOCK_UP
|-
| View Rear || PADLOCK_DOWN
|-
| View Left || PADLOCK_LEFT
|-
| View Right || PADLOCK_RIGHT
|-
| Top-Down View || VIEW_TOPDOWN
|-
| Target Padlock View || VIEW_TRACK_TARGET
|}

{| class="wikitable"
|-
|+ style="color:white" | ETS and Shields
|-
! $Bind Name: !! $Bind:
|-
| Increase Weapon Energy || INCREASE_WEAPON
|-
| Decrease Weapon Energy || DECREASE_WEAPON
|-
| Increase Shield Energy || INCREASE_SHIELD
|-
| Decrease Shield Energy || DECREASE_SHIELD
|-
|-
| Increase Engine Energy || INCREASE_ENGINE
|-
| Decrease Engine Energy || DECREASE_ENGINE
|-
| Equalize Energy Settings || ETS_EQUALIZE
|-
| Equalize Shields || SHIELD_EQUALIZE
|-
| Augment Forward Shield || SHIELD_XFER_TOP
|-
| Augment Rear Shield || SHIELD_XFER_BOTTOM
|-
| Augment Left Shield || SHIELD_XFER_LEFT
|-
| Augment Right Shield || SHIELD_XFER_RIGHT
|-
| Transfer Energy Laser->Shield || XFER_SHIELD
|-
| Transfer Energy Shield->Laser || XFER_LASER
|}

{| class="wikitable"
|+ style="color:white" | Misc
|-
! $Bind Name: !! $Bind:
|-
| Enter Subspace (End Mission) || END_MISSION
|-
| Increase Time Compression || TIME_SPEED_UP
|-
| Decrease Time Compression || TIME_SLOW_DOWN
|-
| Toggle Auto Pilot || AUTO_PILOT_TOGGLE
|-
| Cycle Nav Points || NAV_CYCLE
|-
| Toggle Gliding || TOGGLE_GLIDING
|-
| Toggle Auto Speed Matching || TOGGLE_AUTO_MATCH_TARGET_SPEED
|}

{| class="wikitable"
|+ style="color:white" | Multiplayer Only
|-
! $Bind Name: !! $Bind:
|-
| (Multiplayer) Message All || MULTI_MESSAGE_ALL
|-
| (Multiplayer) Message Friendly || MULTI_MESSAGE_FRIENDLY
|-
| (Multiplayer) Message Hostile || MULTI_MESSAGE_HOSTILE
|-
| (Multiplayer) Message Target || MULTI_MESSAGE_TARGET
|-
| (Multiplayer) Observer Zoom To Target || MULTI_OBSERVER_ZOOM_TO
|-
| (Multiplayer) Toggle Network info || MULTI_TOGGLE_NETINFO
|-
| (Multiplayer) Self Destruct || MULTI_SELF_DESTRUCT
|}

{| class="wikitable"
|+ style="color:white" | Custom Controls
|-
! $Bind Name: !! $Bind:
|-
| Custom Control 1 || CUSTOM_CONTROL_1
|-
| Custom Control 2 || CUSTOM_CONTROL_2
|-
| Custom Control 3 || CUSTOM_CONTROL_3
|-
| Custom Control 4 || CUSTOM_CONTROL_4
|-
| Custom Control 5 || CUSTOM_CONTROL_5
|}

{| class="wikitable"
|+ style="color:white" | Analog Controls
|-
! $Bind Name: !! $Bind:
|-
| - || JOY_HEADING_AXIS
|-
| - || JOY_PITCH_AXIS
|-
| - || JOY_BANK_AXIS
|-
| - || JOY_ABS_THROTTLE_AXIS
|-
| - || JOY_REL_THROTTLE_AXIS
|}

===Custom Controls===
{{Table382|
* 'Custom Control 1'
* 'Custom Control 2'
* 'Custom Control 3'
* 'Custom Control 4'
* 'Custom Control 5'

These are empty controls for modders and/or scripters to use.

Disabled by default

Default XSTR index is 0 (thus, they do not have an entry in [[strings.tbl]])

The default key bindings are Shift-Alt (1-5) for Custom Control 1-5, respectively.

To use these, create a new entry in a [[#ControlConfigOverride]] block and with the respective name. You should specify a label in [[strings.tbl]], otherwise they'll show up as "Custom Control" in the control config menu.

Example:
* $Bind Name: Custom Control 1
* $Has XStr: 1570
* $Disable: false
}}

==Allowed Keys==
*Not all keys are checked by FSO for key bindings, so some of these may not work.
*List coppied from controlsconfigcommon.cpp and edited to make readable.
*Must use the string below (without quotes).
*List of keys
:'KEY_0'
:'KEY_1'
:'KEY_2'
:'KEY_3'
:'KEY_4'
:'KEY_5'
:'KEY_6'
:'KEY_7'
:'KEY_8'
:'KEY_9'
:'KEY_A'
:'KEY_B'
:'KEY_C'
:'KEY_D'
:'KEY_E'
:'KEY_F'
:'KEY_G'
:'KEY_H'
:'KEY_I'
:'KEY_J'
:'KEY_K'
:'KEY_L'
:'KEY_M'
:'KEY_N'
:'KEY_O'
:'KEY_P'
:'KEY_Q'
:'KEY_R'
:'KEY_S'
:'KEY_T'
:'KEY_U'
:'KEY_V'
:'KEY_W'
:'KEY_X'
:'KEY_Y'
:'KEY_Z'
:'KEY_MINUS'
:'KEY_EQUAL'
:'KEY_DIVIDE'
:'KEY_SLASH'
:'KEY_SLASH_UK'
:'KEY_COMMA'
:'KEY_PERIOD'
:'KEY_SEMICOL'
:'KEY_LBRACKET'
:'KEY_RBRACKET'
:'KEY_RAPOSTRO'
:'KEY_LAPOSTRO'
:'KEY_ESC'
:'KEY_ENTER'
:'KEY_BACKSP'
:'KEY_TAB'
:'KEY_SPACEBAR'
:'KEY_NUMLOCK'
:'KEY_SCROLLOCK'
:'KEY_CAPSLOCK'
:'KEY_LSHIFT'
:'KEY_RSHIFT'
:'KEY_LALT'
:'KEY_RALT'
:'KEY_LCTRL'
:'KEY_RCTRL'
:'KEY_F1'
:'KEY_F2'
:'KEY_F3'
:'KEY_F4'
:'KEY_F5'
:'KEY_F6'
:'KEY_F7'
:'KEY_F8'
:'KEY_F9'
:'KEY_F10'
:'KEY_F11'
:'KEY_F12'
:'KEY_PAD0'
:'KEY_PAD1'
:'KEY_PAD2'
:'KEY_PAD3'
:'KEY_PAD4'
:'KEY_PAD5'
:'KEY_PAD6'
:'KEY_PAD7'
:'KEY_PAD8'
:'KEY_PAD9'
:'KEY_PADMINUS'
:'KEY_PADPLUS'
:'KEY_PADPERIOD'
:'KEY_PADDIVIDE'
:'KEY_PADMULTIPLY'
:'KEY_PADENTER'
:'KEY_INSERT'
:'KEY_HOME'
:'KEY_PAGEUP'
:'KEY_DELETE'
:'KEY_END'
:'KEY_PAGEDOWN'
:'KEY_UP'
:'KEY_DOWN'
:'KEY_LEFT'
:'KEY_RIGHT'
:'KEY_PRINT_SCRN'
:'KEY_PAUSE'
:'KEY_BREAK'

[[Category:Tables]]

Controlconfigdefaults.tbl

2022-10-12T15:17:45Z

Z64555: /* Post-22.0 */

{{TableVersionGit| 2021-02-13 UTC | db2bd97669c949e7d68baa9560192b7d3ad96563}}

{{Tables}}
The '''controlconfigdefaults.tbl''' can be used to modify the default key bindings in FSO.

==#ControlConfigOverride==
* Starts an Override section
* Begins with '''#ControlConfigOverride''' and ends with '''#End'''.
* Only entries that you want to change are required, the rest will use the default binding
* Entries not listed will be assigned to their default/hardcoded values.
{{Table371|
* Multiple #ControlConfigOverride...#End blocks can be provided.
** Each block defines a separate control config preset
** The "Defaults" button in the control config screen may be used to reset to the selected preset, then cycle through to the next preset.
** The first given block is used as the "global" defaults, and is used when working with the key-pressed SEXP and LUA scripts.
** Note: It's a good idea to also use [[Strings.tbl]] to change the "Defaults" text on the button to for example "Cycle\nPresets".
}}

==#ControlConfigPreset==
{{Table212|
* Starts a Preset section
* Begins with '''#ControlConfigPreset''' and ends with '''#End'''.
* All keybinds you wish to have bound must be specified, any unspecified keys will be unbound.
}}

===$Name:===
{{Table373|
* The name of this control config preset, displayed at the top left corner of the control config screen when selected through the "Defaults" button.
* If not provided, the first [[#ControlConfigOverride]] block will override the hardcoded defaults, all subsequent blocks will be '''<unnamed preset>.'''
{{Table212|
* If not provided, the [[#ControlConfigPreset]] block will be '''<unnamed preset>'''
}}
**Syntax: '''''String'''''
}}

===$Bind Name:===
*Name of the bind or action to modify the default key of.
*Valid entries: [[Controlconfigdefaults.tbl#Table of Bindings|Table of Bindings]]
*Required
*Syntax: '''String'''
{{Table220|
As of FSO 22.0, '''$Bind Name:''' is deprecated in favor of '''$Bind:'''
}}

====$Key Default:====
*Key to set as default
*Valid entries: [[Controlconfigdefaults.tbl#Allowed Keys|Allowed Keys]]
{{Table372|
*May be unbound by specifying '''NONE''' instead of a key}}
*Optional
*Syntax: '''String'''

====$Joy Default:====
*Joystick button to set as default
*Optional
*Syntax: '''Integer'''

====$Key Mod Shift:====
*Sets the key to require the Shift key
*'''1''' for yes, '''0''' for no
*Optional
*Syntax: '''Integer'''

====$Key Mod Alt:====

*Sets the key to require the Alt key
*'''1''' for yes, '''0''' for no
*Optional
*Syntax: '''Integer'''

====$Key Mod Ctrl:====
* Sets the key to require the Ctrl key
* '''1''' for yes, '''0''' for no
* Optional
* Syntax: '''Integer'''

===$Bind:===
{{Table220|
*The IoActionID of the action to bind to.
*Valid entries: [[Controlconfigdefaults.tbl#Table of Bindings|Table of Bindings]]
*Required
*Syntax: '''String'''
}}

====$Primary:====
{{Table220|
*Denotes the following binding is a Primary binding of the control
*Optional
*Syntax: (No arguments)
}}

=====$Controller:=====
{{Table220|
*Denotes which controller this binding is for
*Required
*Syntax: '''String''', any of the following:
**'''CID_NONE'''
**'''CID_KEYBOARD'''
**'''CID_MOUSE'''
**'''CID_JOY0'''
**'''CID_JOY1'''
**'''CID_JOY2'''
**'''CID_JOY3'''
}}

=====$Flags:=====
{{Table220|
*Denotes a number of flags for button behavior
*Required
*Syntax: '''String''', any of the following:
}}
{| class="wikitable"
| '''AXIS_BTN''' || An axis that's treated as a digital control should it be deflected past a certain threshold (Note: WIP)
|-
| '''RELATIVE''' || A relative axis which increases or decreases the control's value instead of directly setting its value. (Example: Relative Throttle)
|-
| '''INVERTED''' || An axis who's input is inverted
|-
| '''AXIS''' || Input is an axis
|-
| '''HAT''' || Input is a POV HAT switch
|-
| '''BALL''' || Input is a trackball
|-
| '''NONE''' || Input is assumed to be a standard button or key
|}

=====$Input:=====
{{Table220|
*Which button, key, or axis is bound
*Required
*Syntax: '''string''', any of the following:

Joystick axes:
*'''X_AXIS'''
*'''Y_AXIS'''
*'''Z_AXIS'''
*'''RX_AXIS'''
*'''RY_AXIS'''
*'''RZ_AXIS'''

Joystick Buttons:
*Buttons are simply the button number, such as "1" for button 1.

Mouse Buttons:
*'''LEFT_BUTTON'''
*'''RIGHT_BUTTON'''
*'''MIDDLE_BUTTON'''
*'''X1_BUTTON'''
*'''X2_BUTTON'''
*'''WHEEL_UP'''
*'''WHEEL_DOWN'''
*'''WHEEL_LEFT'''
*'''WHEEL_RIGHT'''

Keyboard Keys:
[[Controlconfigdefaults.tbl#Allowed Keys|Allowed Keys]]
*Key modifiers '''ALT-''' and '''SHIFT-''' can be prepended to the Key ID.
**Example: '''ALT-J''', '''SHIFT-KEY_Q''', '''ALT-SHIFT-KEY_1'''
}}

====$Secondary:====
{{Table220|
*Denotes the following binding is a Secondary binding of the control
*Has the same suboptions as [[Controlconfigdefaults.tbl#$Primary:|$Primary]]
*Optional
*Syntax: (No Arguments)
}}

===$Category:===
* Tab where the binding appears in the options menu.
* Valid entries: TARGET_TAB, SHIP_TAB, WEAPON_TAB, COMPUTER_TAB
* Optional
* Only valid in [[#ControlConfigOverride]] blocks
* Syntax: '''String'''

===$Text:===
{{Table212|
* The label of the control to use in the controls config menu.
* Is overridden by XSTR, if provided
** '''Note:''' This is meant to be a lazy temporary substitution to modifying [[strings.tbl]]. Your released mod should nstill provide its own strings.tbl.
* Optional
* Syntax: '''String'''
}}

===$Has XStr:===
* Whether or not the binding has an entry in [[strings.tbl]]
** If '''0''', assumes no XSTR is provided
** If '''1''', assumes an XSTR is provided alongside the other ControlConfig strings according to its internal, hardcoded index
{{Table382|
** If any nonzero integer >1, is the exact XSTR index within [[strings.tbl]]
}}
* Optional
* Only valid in [[#ControlConfigOverride]] blocks
* Syntax: '''Integer'''

===$Type:===
*Determines the type of control this is.

*Valid entries:
**CC_TYPE_TRIGGER
***Normal control that activates upon the first press. Resetting devices (such as weapons) will keep firing as long as the key/button is held down.
**CC_TYPE_CONTINUOUS
***Control that activates when the key/button is held down, and stays activated until the key/button is released. Ex: Afterburner key.
*Optional
*Only valid in [[#ControlConfigOverride]] blocks
*Syntax '''String'''

===$Disable:===
{{Table373|
*Determines whether the binding can be used and appears in the options menu. Can be used to hide bindings which are not needed, or to enable bindings which are hidden by default.
*Syntax: '''''Boolean'''''
}}

===+Disable===
{{Table212|
* Disables the control
* Optional
* Only valid in [[#ControlConfigOverride]] blocks
* Syntax: (No arguments)
}}

==#End==
* All [[#ControlConfigOverride]] and [[#ControlConfigPreset]] sections must be terminated by #End

==Sample==
===Post-22.0===
{{Table220|
This example is for Post-22.0 and does the following...
*Sets Clear Escort List to Alt-Shift-Q
*Sets Target Target's Attacker to Alt-Shift-J and Button 2 on Joystick 0, moves it to the Ship Tab, denotes it's type as a trigger and sets it to not have a XString
*Sets Transfer Energy from Shield to Laser to R

Note that for compatibility, FSO builds 22.0 and later can still read Pre-22.0 format.
}}

<pre>
#ControlConfigOverride

$Bind: ESCORT_CLEAR
$Primary:
$Controller: CID_KEYBOARD
$Flags: NONE
$Input: ALT-SHIFT-KEY_Q

$Bind: TARGET_CLOSEST_SHIP_ATTACKING_TARGET
$Primary:
$Controller: CID_KEYBOARD
$Flags: NONE
$Input: ALT-SHIFT-KEY_J
$Secondary:
$Controller: CID_JOY0
$Flags: NONE
$Input: 2
$Category: SHIP_TAB
$Has XStr: 0
$TYPE: CC_TYPE_TRIGGER

$Bind: XFER_LASER
$Primary:
$Controller: CID_KEYBOARD
$FLAGS: NONE
$Inpute: KEY_R

#End
</pre>

===Pre-22.0===
This example is for Pre-22.0 and does the following...
*Sets Clear Escort List to Alt-Shift-Q
*Sets Target Target's Attacker to Ctrl-Alt-Shift-J, moves it to the Ship Tab, denotes it's type as a trigger and sets it to not have a XString
*Sets Transfer Energy from Shield to Laser to R

<pre>
#ControlConfigOverride

$Bind Name: Clear Escort List
$Key Default: KEY_Q
$Key Mod Shift: 1
$Key Mod Alt: 1

$Bind Name: Target Target's Nearest Attacker
$Key Default: KEY_J
$Key Mod Shift: 1
$Key Mod Alt: 1
$Key Mod Ctrl: 1
$Category: SHIP_TAB
$Has XStr: 0
$TYPE: CC_TYPE_TRIGGER

$Bind Name: Transfer Energy Shield->Laser
$Key Default: KEY_R

#End
</pre>

==Table of Bindings==
* This is a table of all possible bindings that can be modified, grouped into smaller tables for easier reference.
* '''$Bind Name:''' column is to be used with '''$Bind Name:''' entries, and '''$Bind:''' column is to be used with '''$Bind:''' entries.
* These bindings are case-sensitive
* Controls added after 22.0 might not have a '''$Bind Name:'''. Use the '''$Bind:''' identifier instead.
{| class="wikitable"
|+ style="color:white" | Targeting
|-
! $Bind Name: !! $Bind:
|-
| Target Next Ship || TARGET_NEXT
|-
| Target Previous Ship || TARGET_PREV
|-
| Target Next Closest Hostile Ship || TARGET_NEXT_CLOSEST_HOSTILE
|-
| Target Previous Closest Hostile Ship || TARGET_PREV_CLOSEST_HOSTILE
|-
| Toggle Auto Targeting || TOGGLE_AUTO_TARGETING
|-
| Target Next Closest Friendly Ship || TARGET_NEXT_CLOSEST_FRIENDLY
|-
| Target Previous Closest Friendly Ship || TARGET_PREV_CLOSEST_FRIENDLY
|-
| Target Ship in Reticle || TARGET_SHIP_IN_RETICLE
|-
| Target Targets Nearest Attacker || TARGET_CLOSEST_SHIP_ATTACKING_TARGET
|-
| Target Last Ship to Send Transmission || TARGET_LAST_TRANMISSION_SENDER
|-
| Turn Off Targeting || STOP_TARGETING_SHIP
|-
| Target Closest Attacking Ship || TARGET_CLOSEST_SHIP_ATTACKING_SELF
|-
| Target Next Escort Ship || TARGET_NEXT_ESCORT_SHIP
|-
| Target Closest Repair Ship || TARGET_CLOSEST_REPAIR_SHIP
|-
| Target Next Uninspected Cargo || TARGET_NEXT_UNINSPECTED_CARGO
|-
| Target Previous Uninspected Cargo || TARGET_PREV_UNINSPECTED_CARGO
|-
| Target Newest Ship in Area || TARGET_NEWEST_SHIP
|-
| Target Targets Target || TARGET_TARGETS_TARGET
|-
| Target Next Hostile Bomb or Bomber || TARGET_NEXT_BOMB
|-
| Target Previous Hostile Bomb or Bomber || TARGET_PREV_BOMB
|}

{| class="wikitable"
|+ style="color:white" | Targeting Subsystems and Turrets
|-
! $Bind Name: !! $Bind:
|-
| Target Subsystem in Reticle || TARGET_SUBOBJECT_IN_RETICLE
|-
| Target Next Subsystem || TARGET_NEXT_SUBOBJECT
|-
| Target Previous Subsystem || TARGET_PREV_SUBOBJECT
|-
| Turn Off Targeting of Subsystems || STOP_TARGETING_SUBSYSTEM
|-
| Target Next Live Turret || TARGET_NEXT_LIVE_TURRET
|-
| Target Previous Live Turret || TARGET_PREV_LIVE_TURRET
|}

{| class="wikitable"
|+ style="color:white" | Weapons
|-
! $Bind Name: !! $Bind:
|-
| Fire Primary Weapon || FIRE_PRIMARY
|-
| Fire Secondary Weapon || FIRE_SECONDARY
|-
| Cycle Forward Primary Weapon || CYCLE_NEXT_PRIMARY
|-
| Cycle Backward Primary Weapon || CYCLE_PREV_PRIMARY
|-
| Cycle Primary Weapon Firing Rate || CYCLE_PRIMARY_WEAPON_SEQUENCE
|-
| Cycle Secondary Weapon Bank || CYCLE_SECONDARY
|-
| Cycle Secondary Weapon Firing Rate || CYCLE_NUM_MISSLES
|-
| Launch Countermeasure || LAUNCH_COUNTERMEASURE
|}

{| class="wikitable"
|+ style="color:white" | Flight Controls
|-
! $Bind Name: !! $Bind:
|-
| Forward Thrust || FORWARD_THRUST
|-
| Reverse Thrust || REVERSE_THRUST
|-
| Bank Left || BANK_LEFT
|-
| Bank Right || BANK_RIGHT
|-
| Pitch Forward || PITCH_FORWARD
|-
| Pitch Backward || PITCH_BACK
|-
| Turn Left || YAW_LEFT
|-
| Turn Right || YAW_RIGHT
|-
| Right Thrust || RIGHT_SLIDE_THRUST
|-
| Left Thrust || LEFT_SLIDE_THRUST
|-
| Up Thrust || UP_SLIDE_THRUST
|-
| Down Thrust || DOWN_SLIDE_THRUST
|-
| Afterburner || AFTERBURNER
|-
| Glide When Pressed || GLIDE_WHEN_PRESSED
|-
| Bank When Pressed || BANK_WHEN_PRESSED
|-
| Match Target Speed || MATCH_TARGET_SPEED
|}

{| class="wikitable"
|-
|+ style="color:white" | Throttle Control
|-
! $Bind Name: !! $Bind:
|-
| Set Throttle to Zero || ZERO_THROTTLE
|-
| Set Throttle to Max || MAX_THROTTLE
|-
| Set Throttle to One-Third || ONE_THIRD_THROTTLE
|-
| Set Throttle to Two-Thirds || TWO_THIRDS_THROTTLE
|-
| Increase Throttle 5 Percent || PLUS_5_PERCENT_THROTTLE
|-
| Decrease Throttle 5 Percent || MINUS_5_PERCENT_THROTTLE
|}

{| class="wikitable"
|+ style="color:white" | HUD Controls
|-
! $Bind Name: !! $Bind:
|-
| Toggle High HUD Contrast || TOGGLE_HUD_CONTRAST
|-
| Toggle HUD || TOGGLE_HUD
|-
| Toggle HUD Wireframe Target View || HUD_TARGETBOX_TOGGLE_WIREFRAME
|-
| Cycle Radar Range || RADAR_RANGE_CYCLE
|-
| Communications Menu || SQUADMSG_MENU
|-
| Show Objectives || SHOW_GOALS
|-
| Show Nav Map || SHOW_NAVMAP
|-
| Add or Remove Escort || ADD_REMOVE_ESCORT
|-
| Clear Escort List || ESCORT_CLEAR
|-
| - || TOGGLE_HUD_SHADOWS
|}

{| class="wikitable"
|+ style="color:white" | Squadmate Messaging
|-
! $Bind Name: !! $Bind:
|-
| Attack My Target || ATTACK_MESSAGE
|-
| Disarm My Target || DISARM_MESSAGE
|-
| Disable My Target || DISABLE_MESSAGE
|-
| Attack My Subsystem || ATTACK_SUBSYSTEM_MESSAGE
|-
| Capture My Target || CAPTURE_MESSAGE
|-
| Engage Enemy || ENGAGE_MESSAGE
|-
| Form on My Wing || FORM_MESSAGE
|-
| Ignore My Target || IGNORE_MESSAGE
|-
| Protect My Target || PROTECT_MESSAGE
|-
| Cover Me || COVER_MESSAGE
|-
| Return to Base || WARP_MESSAGE
|-
| Rearm Me || REARM_MESSAGE
|}

{| class="wikitable"
|+ style="color:white" | Views
|-
! $Bind Name: !! $Bind:
|-
| Chase View || VIEW_CHASE
|-
| External View || VIEW_EXTERNAL
|-
| Toggle External Camera Lock || VIEW_EXTERNAL_TOGGLE_CAMERA_LOCK
|-
| Free Look View || VIEW_SLEW
|-
| Current Target View || VIEW_OTHER_SHIP
|-
| Increase View Distance || VIEW_DIST_INCREASE
|-
| Decrease View Distance || VIEW_DIST_DECREASE
|-
| Center View || VIEW_CENTER
|-
| View Up || PADLOCK_UP
|-
| View Rear || PADLOCK_DOWN
|-
| View Left || PADLOCK_LEFT
|-
| View Right || PADLOCK_RIGHT
|-
| Top-Down View || VIEW_TOPDOWN
|-
| Target Padlock View || VIEW_TRACK_TARGET
|}

{| class="wikitable"
|-
|+ style="color:white" | ETS and Shields
|-
! $Bind Name: !! $Bind:
|-
| Increase Weapon Energy || INCREASE_WEAPON
|-
| Decrease Weapon Energy || DECREASE_WEAPON
|-
| Increase Shield Energy || INCREASE_SHIELD
|-
| Decrease Shield Energy || DECREASE_SHIELD
|-
|-
| Increase Engine Energy || INCREASE_ENGINE
|-
| Decrease Engine Energy || DECREASE_ENGINE
|-
| Equalize Energy Settings || ETS_EQUALIZE
|-
| Equalize Shields || SHIELD_EQUALIZE
|-
| Augment Forward Shield || SHIELD_XFER_TOP
|-
| Augment Rear Shield || SHIELD_XFER_BOTTOM
|-
| Augment Left Shield || SHIELD_XFER_LEFT
|-
| Augment Right Shield || SHIELD_XFER_RIGHT
|-
| Transfer Energy Laser->Shield || XFER_SHIELD
|-
| Transfer Energy Shield->Laser || XFER_LASER
|}

{| class="wikitable"
|+ style="color:white" | Misc
|-
! $Bind Name: !! $Bind:
|-
| Enter Subspace (End Mission) || END_MISSION
|-
| Increase Time Compression || TIME_SPEED_UP
|-
| Decrease Time Compression || TIME_SLOW_DOWN
|-
| Toggle Auto Pilot || AUTO_PILOT_TOGGLE
|-
| Cycle Nav Points || NAV_CYCLE
|-
| Toggle Gliding || TOGGLE_GLIDING
|-
| Toggle Auto Speed Matching || TOGGLE_AUTO_MATCH_TARGET_SPEED
|}

{| class="wikitable"
|+ style="color:white" | Multiplayer Only
|-
! $Bind Name: !! $Bind:
|-
| (Multiplayer) Message All || MULTI_MESSAGE_ALL
|-
| (Multiplayer) Message Friendly || MULTI_MESSAGE_FRIENDLY
|-
| (Multiplayer) Message Hostile || MULTI_MESSAGE_HOSTILE
|-
| (Multiplayer) Message Target || MULTI_MESSAGE_TARGET
|-
| (Multiplayer) Observer Zoom To Target || MULTI_OBSERVER_ZOOM_TO
|-
| (Multiplayer) Toggle Network info || MULTI_TOGGLE_NETINFO
|-
| (Multiplayer) Self Destruct || MULTI_SELF_DESTRUCT
|}

{| class="wikitable"
|+ style="color:white" | Custom Controls
|-
! $Bind Name: !! $Bind:
|-
| Custom Control 1 || CUSTOM_CONTROL_1
|-
| Custom Control 2 || CUSTOM_CONTROL_2
|-
| Custom Control 3 || CUSTOM_CONTROL_3
|-
| Custom Control 4 || CUSTOM_CONTROL_4
|-
| Custom Control 5 || CUSTOM_CONTROL_5
|}

{| class="wikitable"
|+ style="color:white" | Analog Controls
|-
! $Bind Name: !! $Bind:
|-
| - || JOY_HEADING_AXIS
|-
| - || JOY_PITCH_AXIS
|-
| - || JOY_BANK_AXIS
|-
| - || JOY_ABS_THROTTLE_AXIS
|-
| - || JOY_REL_THROTTLE_AXIS
|}

===Custom Controls===
{{Table382|
* 'Custom Control 1'
* 'Custom Control 2'
* 'Custom Control 3'
* 'Custom Control 4'
* 'Custom Control 5'

These are empty controls for modders and/or scripters to use.

Disabled by default

Default XSTR index is 0 (thus, they do not have an entry in [[strings.tbl]])

The default key bindings are Shift-Alt (1-5) for Custom Control 1-5, respectively.

To use these, create a new entry in a [[#ControlConfigOverride]] block and with the respective name. You should specify a label in [[strings.tbl]], otherwise they'll show up as "Custom Control" in the control config menu.

Example:
* $Bind Name: Custom Control 1
* $Has XStr: 1570
* $Disable: false
}}

==Allowed Keys==
*Not all keys are checked by FSO for key bindings, so some of these may not work.
*List coppied from controlsconfigcommon.cpp and edited to make readable.
*Must use the string below (without quotes).
*List of keys
:'KEY_0'
:'KEY_1'
:'KEY_2'
:'KEY_3'
:'KEY_4'
:'KEY_5'
:'KEY_6'
:'KEY_7'
:'KEY_8'
:'KEY_9'
:'KEY_A'
:'KEY_B'
:'KEY_C'
:'KEY_D'
:'KEY_E'
:'KEY_F'
:'KEY_G'
:'KEY_H'
:'KEY_I'
:'KEY_J'
:'KEY_K'
:'KEY_L'
:'KEY_M'
:'KEY_N'
:'KEY_O'
:'KEY_P'
:'KEY_Q'
:'KEY_R'
:'KEY_S'
:'KEY_T'
:'KEY_U'
:'KEY_V'
:'KEY_W'
:'KEY_X'
:'KEY_Y'
:'KEY_Z'
:'KEY_MINUS'
:'KEY_EQUAL'
:'KEY_DIVIDE'
:'KEY_SLASH'
:'KEY_SLASH_UK'
:'KEY_COMMA'
:'KEY_PERIOD'
:'KEY_SEMICOL'
:'KEY_LBRACKET'
:'KEY_RBRACKET'
:'KEY_RAPOSTRO'
:'KEY_LAPOSTRO'
:'KEY_ESC'
:'KEY_ENTER'
:'KEY_BACKSP'
:'KEY_TAB'
:'KEY_SPACEBAR'
:'KEY_NUMLOCK'
:'KEY_SCROLLOCK'
:'KEY_CAPSLOCK'
:'KEY_LSHIFT'
:'KEY_RSHIFT'
:'KEY_LALT'
:'KEY_RALT'
:'KEY_LCTRL'
:'KEY_RCTRL'
:'KEY_F1'
:'KEY_F2'
:'KEY_F3'
:'KEY_F4'
:'KEY_F5'
:'KEY_F6'
:'KEY_F7'
:'KEY_F8'
:'KEY_F9'
:'KEY_F10'
:'KEY_F11'
:'KEY_F12'
:'KEY_PAD0'
:'KEY_PAD1'
:'KEY_PAD2'
:'KEY_PAD3'
:'KEY_PAD4'
:'KEY_PAD5'
:'KEY_PAD6'
:'KEY_PAD7'
:'KEY_PAD8'
:'KEY_PAD9'
:'KEY_PADMINUS'
:'KEY_PADPLUS'
:'KEY_PADPERIOD'
:'KEY_PADDIVIDE'
:'KEY_PADMULTIPLY'
:'KEY_PADENTER'
:'KEY_INSERT'
:'KEY_HOME'
:'KEY_PAGEUP'
:'KEY_DELETE'
:'KEY_END'
:'KEY_PAGEDOWN'
:'KEY_UP'
:'KEY_DOWN'
:'KEY_LEFT'
:'KEY_RIGHT'
:'KEY_PRINT_SCRN'
:'KEY_PAUSE'
:'KEY_BREAK'

[[Category:Tables]]

Controlconfigdefaults.tbl

2022-10-12T15:17:18Z

Z64555: /* Sample */ Provide example for Post 22.0 ControlConfig overrides

{{TableVersionGit| 2021-02-13 UTC | db2bd97669c949e7d68baa9560192b7d3ad96563}}

{{Tables}}
The '''controlconfigdefaults.tbl''' can be used to modify the default key bindings in FSO.

==#ControlConfigOverride==
* Starts an Override section
* Begins with '''#ControlConfigOverride''' and ends with '''#End'''.
* Only entries that you want to change are required, the rest will use the default binding
* Entries not listed will be assigned to their default/hardcoded values.
{{Table371|
* Multiple #ControlConfigOverride...#End blocks can be provided.
** Each block defines a separate control config preset
** The "Defaults" button in the control config screen may be used to reset to the selected preset, then cycle through to the next preset.
** The first given block is used as the "global" defaults, and is used when working with the key-pressed SEXP and LUA scripts.
** Note: It's a good idea to also use [[Strings.tbl]] to change the "Defaults" text on the button to for example "Cycle\nPresets".
}}

==#ControlConfigPreset==
{{Table212|
* Starts a Preset section
* Begins with '''#ControlConfigPreset''' and ends with '''#End'''.
* All keybinds you wish to have bound must be specified, any unspecified keys will be unbound.
}}

===$Name:===
{{Table373|
* The name of this control config preset, displayed at the top left corner of the control config screen when selected through the "Defaults" button.
* If not provided, the first [[#ControlConfigOverride]] block will override the hardcoded defaults, all subsequent blocks will be '''<unnamed preset>.'''
{{Table212|
* If not provided, the [[#ControlConfigPreset]] block will be '''<unnamed preset>'''
}}
**Syntax: '''''String'''''
}}

===$Bind Name:===
*Name of the bind or action to modify the default key of.
*Valid entries: [[Controlconfigdefaults.tbl#Table of Bindings|Table of Bindings]]
*Required
*Syntax: '''String'''
{{Table220|
As of FSO 22.0, '''$Bind Name:''' is deprecated in favor of '''$Bind:'''
}}

====$Key Default:====
*Key to set as default
*Valid entries: [[Controlconfigdefaults.tbl#Allowed Keys|Allowed Keys]]
{{Table372|
*May be unbound by specifying '''NONE''' instead of a key}}
*Optional
*Syntax: '''String'''

====$Joy Default:====
*Joystick button to set as default
*Optional
*Syntax: '''Integer'''

====$Key Mod Shift:====
*Sets the key to require the Shift key
*'''1''' for yes, '''0''' for no
*Optional
*Syntax: '''Integer'''

====$Key Mod Alt:====

*Sets the key to require the Alt key
*'''1''' for yes, '''0''' for no
*Optional
*Syntax: '''Integer'''

====$Key Mod Ctrl:====
* Sets the key to require the Ctrl key
* '''1''' for yes, '''0''' for no
* Optional
* Syntax: '''Integer'''

===$Bind:===
{{Table220|
*The IoActionID of the action to bind to.
*Valid entries: [[Controlconfigdefaults.tbl#Table of Bindings|Table of Bindings]]
*Required
*Syntax: '''String'''
}}

====$Primary:====
{{Table220|
*Denotes the following binding is a Primary binding of the control
*Optional
*Syntax: (No arguments)
}}

=====$Controller:=====
{{Table220|
*Denotes which controller this binding is for
*Required
*Syntax: '''String''', any of the following:
**'''CID_NONE'''
**'''CID_KEYBOARD'''
**'''CID_MOUSE'''
**'''CID_JOY0'''
**'''CID_JOY1'''
**'''CID_JOY2'''
**'''CID_JOY3'''
}}

=====$Flags:=====
{{Table220|
*Denotes a number of flags for button behavior
*Required
*Syntax: '''String''', any of the following:
}}
{| class="wikitable"
| '''AXIS_BTN''' || An axis that's treated as a digital control should it be deflected past a certain threshold (Note: WIP)
|-
| '''RELATIVE''' || A relative axis which increases or decreases the control's value instead of directly setting its value. (Example: Relative Throttle)
|-
| '''INVERTED''' || An axis who's input is inverted
|-
| '''AXIS''' || Input is an axis
|-
| '''HAT''' || Input is a POV HAT switch
|-
| '''BALL''' || Input is a trackball
|-
| '''NONE''' || Input is assumed to be a standard button or key
|}

=====$Input:=====
{{Table220|
*Which button, key, or axis is bound
*Required
*Syntax: '''string''', any of the following:

Joystick axes:
*'''X_AXIS'''
*'''Y_AXIS'''
*'''Z_AXIS'''
*'''RX_AXIS'''
*'''RY_AXIS'''
*'''RZ_AXIS'''

Joystick Buttons:
*Buttons are simply the button number, such as "1" for button 1.

Mouse Buttons:
*'''LEFT_BUTTON'''
*'''RIGHT_BUTTON'''
*'''MIDDLE_BUTTON'''
*'''X1_BUTTON'''
*'''X2_BUTTON'''
*'''WHEEL_UP'''
*'''WHEEL_DOWN'''
*'''WHEEL_LEFT'''
*'''WHEEL_RIGHT'''

Keyboard Keys:
[[Controlconfigdefaults.tbl#Allowed Keys|Allowed Keys]]
*Key modifiers '''ALT-''' and '''SHIFT-''' can be prepended to the Key ID.
**Example: '''ALT-J''', '''SHIFT-KEY_Q''', '''ALT-SHIFT-KEY_1'''
}}

====$Secondary:====
{{Table220|
*Denotes the following binding is a Secondary binding of the control
*Has the same suboptions as [[Controlconfigdefaults.tbl#$Primary:|$Primary]]
*Optional
*Syntax: (No Arguments)
}}

===$Category:===
* Tab where the binding appears in the options menu.
* Valid entries: TARGET_TAB, SHIP_TAB, WEAPON_TAB, COMPUTER_TAB
* Optional
* Only valid in [[#ControlConfigOverride]] blocks
* Syntax: '''String'''

===$Text:===
{{Table212|
* The label of the control to use in the controls config menu.
* Is overridden by XSTR, if provided
** '''Note:''' This is meant to be a lazy temporary substitution to modifying [[strings.tbl]]. Your released mod should nstill provide its own strings.tbl.
* Optional
* Syntax: '''String'''
}}

===$Has XStr:===
* Whether or not the binding has an entry in [[strings.tbl]]
** If '''0''', assumes no XSTR is provided
** If '''1''', assumes an XSTR is provided alongside the other ControlConfig strings according to its internal, hardcoded index
{{Table382|
** If any nonzero integer >1, is the exact XSTR index within [[strings.tbl]]
}}
* Optional
* Only valid in [[#ControlConfigOverride]] blocks
* Syntax: '''Integer'''

===$Type:===
*Determines the type of control this is.

*Valid entries:
**CC_TYPE_TRIGGER
***Normal control that activates upon the first press. Resetting devices (such as weapons) will keep firing as long as the key/button is held down.
**CC_TYPE_CONTINUOUS
***Control that activates when the key/button is held down, and stays activated until the key/button is released. Ex: Afterburner key.
*Optional
*Only valid in [[#ControlConfigOverride]] blocks
*Syntax '''String'''

===$Disable:===
{{Table373|
*Determines whether the binding can be used and appears in the options menu. Can be used to hide bindings which are not needed, or to enable bindings which are hidden by default.
*Syntax: '''''Boolean'''''
}}

===+Disable===
{{Table212|
* Disables the control
* Optional
* Only valid in [[#ControlConfigOverride]] blocks
* Syntax: (No arguments)
}}

==#End==
* All [[#ControlConfigOverride]] and [[#ControlConfigPreset]] sections must be terminated by #End

==Sample==
===Post-22.0===
{{Table220|
This example is for Post-22.0 and does the following...
*Sets Clear Escort List to Alt-Shift-Q
*Sets Target Target's Attacker to Alt-Shift-J and Button 2 on Joystick 0, moves it to the Ship Tab, denotes it's type as a trigger and sets it to not have a XString
*Sets Transfer Energy from Shield to Laser to R

Note that for compatibility, FSO builds 22.0 and later can still read Pre-22.0 format.

<pre>
#ControlConfigOverride

$Bind: ESCORT_CLEAR
$Primary:
$Controller: CID_KEYBOARD
$Flags: NONE
$Input: ALT-SHIFT-KEY_Q

$Bind: TARGET_CLOSEST_SHIP_ATTACKING_TARGET
$Primary:
$Controller: CID_KEYBOARD
$Flags: NONE
$Input: ALT-SHIFT-KEY_J
$Secondary:
$Controller: CID_JOY0
$Flags: NONE
$Input: 2
$Category: SHIP_TAB
$Has XStr: 0
$TYPE: CC_TYPE_TRIGGER

$Bind: XFER_LASER
$Primary:
$Controller: CID_KEYBOARD
$FLAGS: NONE
$Inpute: KEY_R

#End
</pre>

===Pre-22.0===
This example is for Pre-22.0 and does the following...
*Sets Clear Escort List to Alt-Shift-Q
*Sets Target Target's Attacker to Ctrl-Alt-Shift-J, moves it to the Ship Tab, denotes it's type as a trigger and sets it to not have a XString
*Sets Transfer Energy from Shield to Laser to R

<pre>
#ControlConfigOverride

$Bind Name: Clear Escort List
$Key Default: KEY_Q
$Key Mod Shift: 1
$Key Mod Alt: 1

$Bind Name: Target Target's Nearest Attacker
$Key Default: KEY_J
$Key Mod Shift: 1
$Key Mod Alt: 1
$Key Mod Ctrl: 1
$Category: SHIP_TAB
$Has XStr: 0
$TYPE: CC_TYPE_TRIGGER

$Bind Name: Transfer Energy Shield->Laser
$Key Default: KEY_R

#End
</pre>

==Table of Bindings==
* This is a table of all possible bindings that can be modified, grouped into smaller tables for easier reference.
* '''$Bind Name:''' column is to be used with '''$Bind Name:''' entries, and '''$Bind:''' column is to be used with '''$Bind:''' entries.
* These bindings are case-sensitive
* Controls added after 22.0 might not have a '''$Bind Name:'''. Use the '''$Bind:''' identifier instead.
{| class="wikitable"
|+ style="color:white" | Targeting
|-
! $Bind Name: !! $Bind:
|-
| Target Next Ship || TARGET_NEXT
|-
| Target Previous Ship || TARGET_PREV
|-
| Target Next Closest Hostile Ship || TARGET_NEXT_CLOSEST_HOSTILE
|-
| Target Previous Closest Hostile Ship || TARGET_PREV_CLOSEST_HOSTILE
|-
| Toggle Auto Targeting || TOGGLE_AUTO_TARGETING
|-
| Target Next Closest Friendly Ship || TARGET_NEXT_CLOSEST_FRIENDLY
|-
| Target Previous Closest Friendly Ship || TARGET_PREV_CLOSEST_FRIENDLY
|-
| Target Ship in Reticle || TARGET_SHIP_IN_RETICLE
|-
| Target Targets Nearest Attacker || TARGET_CLOSEST_SHIP_ATTACKING_TARGET
|-
| Target Last Ship to Send Transmission || TARGET_LAST_TRANMISSION_SENDER
|-
| Turn Off Targeting || STOP_TARGETING_SHIP
|-
| Target Closest Attacking Ship || TARGET_CLOSEST_SHIP_ATTACKING_SELF
|-
| Target Next Escort Ship || TARGET_NEXT_ESCORT_SHIP
|-
| Target Closest Repair Ship || TARGET_CLOSEST_REPAIR_SHIP
|-
| Target Next Uninspected Cargo || TARGET_NEXT_UNINSPECTED_CARGO
|-
| Target Previous Uninspected Cargo || TARGET_PREV_UNINSPECTED_CARGO
|-
| Target Newest Ship in Area || TARGET_NEWEST_SHIP
|-
| Target Targets Target || TARGET_TARGETS_TARGET
|-
| Target Next Hostile Bomb or Bomber || TARGET_NEXT_BOMB
|-
| Target Previous Hostile Bomb or Bomber || TARGET_PREV_BOMB
|}

{| class="wikitable"
|+ style="color:white" | Targeting Subsystems and Turrets
|-
! $Bind Name: !! $Bind:
|-
| Target Subsystem in Reticle || TARGET_SUBOBJECT_IN_RETICLE
|-
| Target Next Subsystem || TARGET_NEXT_SUBOBJECT
|-
| Target Previous Subsystem || TARGET_PREV_SUBOBJECT
|-
| Turn Off Targeting of Subsystems || STOP_TARGETING_SUBSYSTEM
|-
| Target Next Live Turret || TARGET_NEXT_LIVE_TURRET
|-
| Target Previous Live Turret || TARGET_PREV_LIVE_TURRET
|}

{| class="wikitable"
|+ style="color:white" | Weapons
|-
! $Bind Name: !! $Bind:
|-
| Fire Primary Weapon || FIRE_PRIMARY
|-
| Fire Secondary Weapon || FIRE_SECONDARY
|-
| Cycle Forward Primary Weapon || CYCLE_NEXT_PRIMARY
|-
| Cycle Backward Primary Weapon || CYCLE_PREV_PRIMARY
|-
| Cycle Primary Weapon Firing Rate || CYCLE_PRIMARY_WEAPON_SEQUENCE
|-
| Cycle Secondary Weapon Bank || CYCLE_SECONDARY
|-
| Cycle Secondary Weapon Firing Rate || CYCLE_NUM_MISSLES
|-
| Launch Countermeasure || LAUNCH_COUNTERMEASURE
|}

{| class="wikitable"
|+ style="color:white" | Flight Controls
|-
! $Bind Name: !! $Bind:
|-
| Forward Thrust || FORWARD_THRUST
|-
| Reverse Thrust || REVERSE_THRUST
|-
| Bank Left || BANK_LEFT
|-
| Bank Right || BANK_RIGHT
|-
| Pitch Forward || PITCH_FORWARD
|-
| Pitch Backward || PITCH_BACK
|-
| Turn Left || YAW_LEFT
|-
| Turn Right || YAW_RIGHT
|-
| Right Thrust || RIGHT_SLIDE_THRUST
|-
| Left Thrust || LEFT_SLIDE_THRUST
|-
| Up Thrust || UP_SLIDE_THRUST
|-
| Down Thrust || DOWN_SLIDE_THRUST
|-
| Afterburner || AFTERBURNER
|-
| Glide When Pressed || GLIDE_WHEN_PRESSED
|-
| Bank When Pressed || BANK_WHEN_PRESSED
|-
| Match Target Speed || MATCH_TARGET_SPEED
|}

{| class="wikitable"
|-
|+ style="color:white" | Throttle Control
|-
! $Bind Name: !! $Bind:
|-
| Set Throttle to Zero || ZERO_THROTTLE
|-
| Set Throttle to Max || MAX_THROTTLE
|-
| Set Throttle to One-Third || ONE_THIRD_THROTTLE
|-
| Set Throttle to Two-Thirds || TWO_THIRDS_THROTTLE
|-
| Increase Throttle 5 Percent || PLUS_5_PERCENT_THROTTLE
|-
| Decrease Throttle 5 Percent || MINUS_5_PERCENT_THROTTLE
|}

{| class="wikitable"
|+ style="color:white" | HUD Controls
|-
! $Bind Name: !! $Bind:
|-
| Toggle High HUD Contrast || TOGGLE_HUD_CONTRAST
|-
| Toggle HUD || TOGGLE_HUD
|-
| Toggle HUD Wireframe Target View || HUD_TARGETBOX_TOGGLE_WIREFRAME
|-
| Cycle Radar Range || RADAR_RANGE_CYCLE
|-
| Communications Menu || SQUADMSG_MENU
|-
| Show Objectives || SHOW_GOALS
|-
| Show Nav Map || SHOW_NAVMAP
|-
| Add or Remove Escort || ADD_REMOVE_ESCORT
|-
| Clear Escort List || ESCORT_CLEAR
|-
| - || TOGGLE_HUD_SHADOWS
|}

{| class="wikitable"
|+ style="color:white" | Squadmate Messaging
|-
! $Bind Name: !! $Bind:
|-
| Attack My Target || ATTACK_MESSAGE
|-
| Disarm My Target || DISARM_MESSAGE
|-
| Disable My Target || DISABLE_MESSAGE
|-
| Attack My Subsystem || ATTACK_SUBSYSTEM_MESSAGE
|-
| Capture My Target || CAPTURE_MESSAGE
|-
| Engage Enemy || ENGAGE_MESSAGE
|-
| Form on My Wing || FORM_MESSAGE
|-
| Ignore My Target || IGNORE_MESSAGE
|-
| Protect My Target || PROTECT_MESSAGE
|-
| Cover Me || COVER_MESSAGE
|-
| Return to Base || WARP_MESSAGE
|-
| Rearm Me || REARM_MESSAGE
|}

{| class="wikitable"
|+ style="color:white" | Views
|-
! $Bind Name: !! $Bind:
|-
| Chase View || VIEW_CHASE
|-
| External View || VIEW_EXTERNAL
|-
| Toggle External Camera Lock || VIEW_EXTERNAL_TOGGLE_CAMERA_LOCK
|-
| Free Look View || VIEW_SLEW
|-
| Current Target View || VIEW_OTHER_SHIP
|-
| Increase View Distance || VIEW_DIST_INCREASE
|-
| Decrease View Distance || VIEW_DIST_DECREASE
|-
| Center View || VIEW_CENTER
|-
| View Up || PADLOCK_UP
|-
| View Rear || PADLOCK_DOWN
|-
| View Left || PADLOCK_LEFT
|-
| View Right || PADLOCK_RIGHT
|-
| Top-Down View || VIEW_TOPDOWN
|-
| Target Padlock View || VIEW_TRACK_TARGET
|}

{| class="wikitable"
|-
|+ style="color:white" | ETS and Shields
|-
! $Bind Name: !! $Bind:
|-
| Increase Weapon Energy || INCREASE_WEAPON
|-
| Decrease Weapon Energy || DECREASE_WEAPON
|-
| Increase Shield Energy || INCREASE_SHIELD
|-
| Decrease Shield Energy || DECREASE_SHIELD
|-
|-
| Increase Engine Energy || INCREASE_ENGINE
|-
| Decrease Engine Energy || DECREASE_ENGINE
|-
| Equalize Energy Settings || ETS_EQUALIZE
|-
| Equalize Shields || SHIELD_EQUALIZE
|-
| Augment Forward Shield || SHIELD_XFER_TOP
|-
| Augment Rear Shield || SHIELD_XFER_BOTTOM
|-
| Augment Left Shield || SHIELD_XFER_LEFT
|-
| Augment Right Shield || SHIELD_XFER_RIGHT
|-
| Transfer Energy Laser->Shield || XFER_SHIELD
|-
| Transfer Energy Shield->Laser || XFER_LASER
|}

{| class="wikitable"
|+ style="color:white" | Misc
|-
! $Bind Name: !! $Bind:
|-
| Enter Subspace (End Mission) || END_MISSION
|-
| Increase Time Compression || TIME_SPEED_UP
|-
| Decrease Time Compression || TIME_SLOW_DOWN
|-
| Toggle Auto Pilot || AUTO_PILOT_TOGGLE
|-
| Cycle Nav Points || NAV_CYCLE
|-
| Toggle Gliding || TOGGLE_GLIDING
|-
| Toggle Auto Speed Matching || TOGGLE_AUTO_MATCH_TARGET_SPEED
|}

{| class="wikitable"
|+ style="color:white" | Multiplayer Only
|-
! $Bind Name: !! $Bind:
|-
| (Multiplayer) Message All || MULTI_MESSAGE_ALL
|-
| (Multiplayer) Message Friendly || MULTI_MESSAGE_FRIENDLY
|-
| (Multiplayer) Message Hostile || MULTI_MESSAGE_HOSTILE
|-
| (Multiplayer) Message Target || MULTI_MESSAGE_TARGET
|-
| (Multiplayer) Observer Zoom To Target || MULTI_OBSERVER_ZOOM_TO
|-
| (Multiplayer) Toggle Network info || MULTI_TOGGLE_NETINFO
|-
| (Multiplayer) Self Destruct || MULTI_SELF_DESTRUCT
|}

{| class="wikitable"
|+ style="color:white" | Custom Controls
|-
! $Bind Name: !! $Bind:
|-
| Custom Control 1 || CUSTOM_CONTROL_1
|-
| Custom Control 2 || CUSTOM_CONTROL_2
|-
| Custom Control 3 || CUSTOM_CONTROL_3
|-
| Custom Control 4 || CUSTOM_CONTROL_4
|-
| Custom Control 5 || CUSTOM_CONTROL_5
|}

{| class="wikitable"
|+ style="color:white" | Analog Controls
|-
! $Bind Name: !! $Bind:
|-
| - || JOY_HEADING_AXIS
|-
| - || JOY_PITCH_AXIS
|-
| - || JOY_BANK_AXIS
|-
| - || JOY_ABS_THROTTLE_AXIS
|-
| - || JOY_REL_THROTTLE_AXIS
|}

===Custom Controls===
{{Table382|
* 'Custom Control 1'
* 'Custom Control 2'
* 'Custom Control 3'
* 'Custom Control 4'
* 'Custom Control 5'

These are empty controls for modders and/or scripters to use.

Disabled by default

Default XSTR index is 0 (thus, they do not have an entry in [[strings.tbl]])

The default key bindings are Shift-Alt (1-5) for Custom Control 1-5, respectively.

To use these, create a new entry in a [[#ControlConfigOverride]] block and with the respective name. You should specify a label in [[strings.tbl]], otherwise they'll show up as "Custom Control" in the control config menu.

Example:
* $Bind Name: Custom Control 1
* $Has XStr: 1570
* $Disable: false
}}

==Allowed Keys==
*Not all keys are checked by FSO for key bindings, so some of these may not work.
*List coppied from controlsconfigcommon.cpp and edited to make readable.
*Must use the string below (without quotes).
*List of keys
:'KEY_0'
:'KEY_1'
:'KEY_2'
:'KEY_3'
:'KEY_4'
:'KEY_5'
:'KEY_6'
:'KEY_7'
:'KEY_8'
:'KEY_9'
:'KEY_A'
:'KEY_B'
:'KEY_C'
:'KEY_D'
:'KEY_E'
:'KEY_F'
:'KEY_G'
:'KEY_H'
:'KEY_I'
:'KEY_J'
:'KEY_K'
:'KEY_L'
:'KEY_M'
:'KEY_N'
:'KEY_O'
:'KEY_P'
:'KEY_Q'
:'KEY_R'
:'KEY_S'
:'KEY_T'
:'KEY_U'
:'KEY_V'
:'KEY_W'
:'KEY_X'
:'KEY_Y'
:'KEY_Z'
:'KEY_MINUS'
:'KEY_EQUAL'
:'KEY_DIVIDE'
:'KEY_SLASH'
:'KEY_SLASH_UK'
:'KEY_COMMA'
:'KEY_PERIOD'
:'KEY_SEMICOL'
:'KEY_LBRACKET'
:'KEY_RBRACKET'
:'KEY_RAPOSTRO'
:'KEY_LAPOSTRO'
:'KEY_ESC'
:'KEY_ENTER'
:'KEY_BACKSP'
:'KEY_TAB'
:'KEY_SPACEBAR'
:'KEY_NUMLOCK'
:'KEY_SCROLLOCK'
:'KEY_CAPSLOCK'
:'KEY_LSHIFT'
:'KEY_RSHIFT'
:'KEY_LALT'
:'KEY_RALT'
:'KEY_LCTRL'
:'KEY_RCTRL'
:'KEY_F1'
:'KEY_F2'
:'KEY_F3'
:'KEY_F4'
:'KEY_F5'
:'KEY_F6'
:'KEY_F7'
:'KEY_F8'
:'KEY_F9'
:'KEY_F10'
:'KEY_F11'
:'KEY_F12'
:'KEY_PAD0'
:'KEY_PAD1'
:'KEY_PAD2'
:'KEY_PAD3'
:'KEY_PAD4'
:'KEY_PAD5'
:'KEY_PAD6'
:'KEY_PAD7'
:'KEY_PAD8'
:'KEY_PAD9'
:'KEY_PADMINUS'
:'KEY_PADPLUS'
:'KEY_PADPERIOD'
:'KEY_PADDIVIDE'
:'KEY_PADMULTIPLY'
:'KEY_PADENTER'
:'KEY_INSERT'
:'KEY_HOME'
:'KEY_PAGEUP'
:'KEY_DELETE'
:'KEY_END'
:'KEY_PAGEDOWN'
:'KEY_UP'
:'KEY_DOWN'
:'KEY_LEFT'
:'KEY_RIGHT'
:'KEY_PRINT_SCRN'
:'KEY_PAUSE'
:'KEY_BREAK'

[[Category:Tables]]

Controlconfigdefaults.tbl

2022-10-12T15:07:06Z

Z64555: Add section on new $Bind entry. Add note that $Bind Name: is deprecated. Move Category, Text, Has XSTR, Type, Disable up a level.

{{TableVersionGit| 2021-02-13 UTC | db2bd97669c949e7d68baa9560192b7d3ad96563}}

{{Tables}}
The '''controlconfigdefaults.tbl''' can be used to modify the default key bindings in FSO.

==#ControlConfigOverride==
* Starts an Override section
* Begins with '''#ControlConfigOverride''' and ends with '''#End'''.
* Only entries that you want to change are required, the rest will use the default binding
* Entries not listed will be assigned to their default/hardcoded values.
{{Table371|
* Multiple #ControlConfigOverride...#End blocks can be provided.
** Each block defines a separate control config preset
** The "Defaults" button in the control config screen may be used to reset to the selected preset, then cycle through to the next preset.
** The first given block is used as the "global" defaults, and is used when working with the key-pressed SEXP and LUA scripts.
** Note: It's a good idea to also use [[Strings.tbl]] to change the "Defaults" text on the button to for example "Cycle\nPresets".
}}

==#ControlConfigPreset==
{{Table212|
* Starts a Preset section
* Begins with '''#ControlConfigPreset''' and ends with '''#End'''.
* All keybinds you wish to have bound must be specified, any unspecified keys will be unbound.
}}

===$Name:===
{{Table373|
* The name of this control config preset, displayed at the top left corner of the control config screen when selected through the "Defaults" button.
* If not provided, the first [[#ControlConfigOverride]] block will override the hardcoded defaults, all subsequent blocks will be '''<unnamed preset>.'''
{{Table212|
* If not provided, the [[#ControlConfigPreset]] block will be '''<unnamed preset>'''
}}
**Syntax: '''''String'''''
}}

===$Bind Name:===
*Name of the bind or action to modify the default key of.
*Valid entries: [[Controlconfigdefaults.tbl#Table of Bindings|Table of Bindings]]
*Required
*Syntax: '''String'''
{{Table220|
As of FSO 22.0, '''$Bind Name:''' is deprecated in favor of '''$Bind:'''
}}

====$Key Default:====
*Key to set as default
*Valid entries: [[Controlconfigdefaults.tbl#Allowed Keys|Allowed Keys]]
{{Table372|
*May be unbound by specifying '''NONE''' instead of a key}}
*Optional
*Syntax: '''String'''

====$Joy Default:====
*Joystick button to set as default
*Optional
*Syntax: '''Integer'''

====$Key Mod Shift:====
*Sets the key to require the Shift key
*'''1''' for yes, '''0''' for no
*Optional
*Syntax: '''Integer'''

====$Key Mod Alt:====

*Sets the key to require the Alt key
*'''1''' for yes, '''0''' for no
*Optional
*Syntax: '''Integer'''

====$Key Mod Ctrl:====
* Sets the key to require the Ctrl key
* '''1''' for yes, '''0''' for no
* Optional
* Syntax: '''Integer'''

===$Bind:===
{{Table220|
*The IoActionID of the action to bind to.
*Valid entries: [[Controlconfigdefaults.tbl#Table of Bindings|Table of Bindings]]
*Required
*Syntax: '''String'''
}}

====$Primary:====
{{Table220|
*Denotes the following binding is a Primary binding of the control
*Optional
*Syntax: (No arguments)
}}

=====$Controller:=====
{{Table220|
*Denotes which controller this binding is for
*Required
*Syntax: '''String''', any of the following:
**'''CID_NONE'''
**'''CID_KEYBOARD'''
**'''CID_MOUSE'''
**'''CID_JOY0'''
**'''CID_JOY1'''
**'''CID_JOY2'''
**'''CID_JOY3'''
}}

=====$Flags:=====
{{Table220|
*Denotes a number of flags for button behavior
*Required
*Syntax: '''String''', any of the following:
}}
{| class="wikitable"
| '''AXIS_BTN''' || An axis that's treated as a digital control should it be deflected past a certain threshold (Note: WIP)
|-
| '''RELATIVE''' || A relative axis which increases or decreases the control's value instead of directly setting its value. (Example: Relative Throttle)
|-
| '''INVERTED''' || An axis who's input is inverted
|-
| '''AXIS''' || Input is an axis
|-
| '''HAT''' || Input is a POV HAT switch
|-
| '''BALL''' || Input is a trackball
|-
| '''NONE''' || Input is assumed to be a standard button or key
|}

=====$Input:=====
{{Table220|
*Which button, key, or axis is bound
*Required
*Syntax: '''string''', any of the following:

Joystick axes:
*'''X_AXIS'''
*'''Y_AXIS'''
*'''Z_AXIS'''
*'''RX_AXIS'''
*'''RY_AXIS'''
*'''RZ_AXIS'''

Joystick Buttons:
*Buttons are simply the button number, such as "1" for button 1.

Mouse Buttons:
*'''LEFT_BUTTON'''
*'''RIGHT_BUTTON'''
*'''MIDDLE_BUTTON'''
*'''X1_BUTTON'''
*'''X2_BUTTON'''
*'''WHEEL_UP'''
*'''WHEEL_DOWN'''
*'''WHEEL_LEFT'''
*'''WHEEL_RIGHT'''

Keyboard Keys:
[[Controlconfigdefaults.tbl#Allowed Keys|Allowed Keys]]
*Key modifiers '''ALT-''' and '''SHIFT-''' can be prepended to the Key ID.
**Example: '''ALT-J''', '''SHIFT-KEY_Q''', '''ALT-SHIFT-KEY_1'''
}}

====$Secondary:====
{{Table220|
*Denotes the following binding is a Secondary binding of the control
*Has the same suboptions as [[Controlconfigdefaults.tbl#$Primary:|$Primary]]
*Optional
*Syntax: (No Arguments)
}}

===$Category:===
* Tab where the binding appears in the options menu.
* Valid entries: TARGET_TAB, SHIP_TAB, WEAPON_TAB, COMPUTER_TAB
* Optional
* Only valid in [[#ControlConfigOverride]] blocks
* Syntax: '''String'''

===$Text:===
{{Table212|
* The label of the control to use in the controls config menu.
* Is overridden by XSTR, if provided
** '''Note:''' This is meant to be a lazy temporary substitution to modifying [[strings.tbl]]. Your released mod should nstill provide its own strings.tbl.
* Optional
* Syntax: '''String'''
}}

===$Has XStr:===
* Whether or not the binding has an entry in [[strings.tbl]]
** If '''0''', assumes no XSTR is provided
** If '''1''', assumes an XSTR is provided alongside the other ControlConfig strings according to its internal, hardcoded index
{{Table382|
** If any nonzero integer >1, is the exact XSTR index within [[strings.tbl]]
}}
* Optional
* Only valid in [[#ControlConfigOverride]] blocks
* Syntax: '''Integer'''

===$Type:===
*Determines the type of control this is.

*Valid entries:
**CC_TYPE_TRIGGER
***Normal control that activates upon the first press. Resetting devices (such as weapons) will keep firing as long as the key/button is held down.
**CC_TYPE_CONTINUOUS
***Control that activates when the key/button is held down, and stays activated until the key/button is released. Ex: Afterburner key.
*Optional
*Only valid in [[#ControlConfigOverride]] blocks
*Syntax '''String'''

===$Disable:===
{{Table373|
*Determines whether the binding can be used and appears in the options menu. Can be used to hide bindings which are not needed, or to enable bindings which are hidden by default.
*Syntax: '''''Boolean'''''
}}

===+Disable===
{{Table212|
* Disables the control
* Optional
* Only valid in [[#ControlConfigOverride]] blocks
* Syntax: (No arguments)
}}

==#End==
* All [[#ControlConfigOverride]] and [[#ControlConfigPreset]] sections must be terminated by #End

==Sample==
This example does the following...
*Sets Clear Escort List to Alt-Shift-Q
*Sets Target Target's Attacker to Ctrl-Alt-Shift-J, moves it to the Ship Tab, denotes it's type as a trigger and sets it to not have a XString
*Sets Transfer Energy from Shield to Laser to R

<pre>
#ControlConfigOverride

$Bind Name: Clear Escort List
$Key Default: KEY_Q
$Key Mod Shift: 1
$Key Mod Alt: 1

$Bind Name: Target Target's Nearest Attacker
$Key Default: KEY_J
$Key Mod Shift: 1
$Key Mod Alt: 1
$Key Mod Ctrl: 1
$Category: SHIP_TAB
$Has XStr: 0
$TYPE: CC_TYPE_TRIGGER

$Bind Name: Transfer Energy Shield->Laser
$Key Default: KEY_R

#End
</pre>

==Table of Bindings==
* This is a table of all possible bindings that can be modified, grouped into smaller tables for easier reference.
* '''$Bind Name:''' column is to be used with '''$Bind Name:''' entries, and '''$Bind:''' column is to be used with '''$Bind:''' entries.
* These bindings are case-sensitive
* Controls added after 22.0 might not have a '''$Bind Name:'''. Use the '''$Bind:''' identifier instead.
{| class="wikitable"
|+ style="color:white" | Targeting
|-
! $Bind Name: !! $Bind:
|-
| Target Next Ship || TARGET_NEXT
|-
| Target Previous Ship || TARGET_PREV
|-
| Target Next Closest Hostile Ship || TARGET_NEXT_CLOSEST_HOSTILE
|-
| Target Previous Closest Hostile Ship || TARGET_PREV_CLOSEST_HOSTILE
|-
| Toggle Auto Targeting || TOGGLE_AUTO_TARGETING
|-
| Target Next Closest Friendly Ship || TARGET_NEXT_CLOSEST_FRIENDLY
|-
| Target Previous Closest Friendly Ship || TARGET_PREV_CLOSEST_FRIENDLY
|-
| Target Ship in Reticle || TARGET_SHIP_IN_RETICLE
|-
| Target Targets Nearest Attacker || TARGET_CLOSEST_SHIP_ATTACKING_TARGET
|-
| Target Last Ship to Send Transmission || TARGET_LAST_TRANMISSION_SENDER
|-
| Turn Off Targeting || STOP_TARGETING_SHIP
|-
| Target Closest Attacking Ship || TARGET_CLOSEST_SHIP_ATTACKING_SELF
|-
| Target Next Escort Ship || TARGET_NEXT_ESCORT_SHIP
|-
| Target Closest Repair Ship || TARGET_CLOSEST_REPAIR_SHIP
|-
| Target Next Uninspected Cargo || TARGET_NEXT_UNINSPECTED_CARGO
|-
| Target Previous Uninspected Cargo || TARGET_PREV_UNINSPECTED_CARGO
|-
| Target Newest Ship in Area || TARGET_NEWEST_SHIP
|-
| Target Targets Target || TARGET_TARGETS_TARGET
|-
| Target Next Hostile Bomb or Bomber || TARGET_NEXT_BOMB
|-
| Target Previous Hostile Bomb or Bomber || TARGET_PREV_BOMB
|}

{| class="wikitable"
|+ style="color:white" | Targeting Subsystems and Turrets
|-
! $Bind Name: !! $Bind:
|-
| Target Subsystem in Reticle || TARGET_SUBOBJECT_IN_RETICLE
|-
| Target Next Subsystem || TARGET_NEXT_SUBOBJECT
|-
| Target Previous Subsystem || TARGET_PREV_SUBOBJECT
|-
| Turn Off Targeting of Subsystems || STOP_TARGETING_SUBSYSTEM
|-
| Target Next Live Turret || TARGET_NEXT_LIVE_TURRET
|-
| Target Previous Live Turret || TARGET_PREV_LIVE_TURRET
|}

{| class="wikitable"
|+ style="color:white" | Weapons
|-
! $Bind Name: !! $Bind:
|-
| Fire Primary Weapon || FIRE_PRIMARY
|-
| Fire Secondary Weapon || FIRE_SECONDARY
|-
| Cycle Forward Primary Weapon || CYCLE_NEXT_PRIMARY
|-
| Cycle Backward Primary Weapon || CYCLE_PREV_PRIMARY
|-
| Cycle Primary Weapon Firing Rate || CYCLE_PRIMARY_WEAPON_SEQUENCE
|-
| Cycle Secondary Weapon Bank || CYCLE_SECONDARY
|-
| Cycle Secondary Weapon Firing Rate || CYCLE_NUM_MISSLES
|-
| Launch Countermeasure || LAUNCH_COUNTERMEASURE
|}

{| class="wikitable"
|+ style="color:white" | Flight Controls
|-
! $Bind Name: !! $Bind:
|-
| Forward Thrust || FORWARD_THRUST
|-
| Reverse Thrust || REVERSE_THRUST
|-
| Bank Left || BANK_LEFT
|-
| Bank Right || BANK_RIGHT
|-
| Pitch Forward || PITCH_FORWARD
|-
| Pitch Backward || PITCH_BACK
|-
| Turn Left || YAW_LEFT
|-
| Turn Right || YAW_RIGHT
|-
| Right Thrust || RIGHT_SLIDE_THRUST
|-
| Left Thrust || LEFT_SLIDE_THRUST
|-
| Up Thrust || UP_SLIDE_THRUST
|-
| Down Thrust || DOWN_SLIDE_THRUST
|-
| Afterburner || AFTERBURNER
|-
| Glide When Pressed || GLIDE_WHEN_PRESSED
|-
| Bank When Pressed || BANK_WHEN_PRESSED
|-
| Match Target Speed || MATCH_TARGET_SPEED
|}

{| class="wikitable"
|-
|+ style="color:white" | Throttle Control
|-
! $Bind Name: !! $Bind:
|-
| Set Throttle to Zero || ZERO_THROTTLE
|-
| Set Throttle to Max || MAX_THROTTLE
|-
| Set Throttle to One-Third || ONE_THIRD_THROTTLE
|-
| Set Throttle to Two-Thirds || TWO_THIRDS_THROTTLE
|-
| Increase Throttle 5 Percent || PLUS_5_PERCENT_THROTTLE
|-
| Decrease Throttle 5 Percent || MINUS_5_PERCENT_THROTTLE
|}

{| class="wikitable"
|+ style="color:white" | HUD Controls
|-
! $Bind Name: !! $Bind:
|-
| Toggle High HUD Contrast || TOGGLE_HUD_CONTRAST
|-
| Toggle HUD || TOGGLE_HUD
|-
| Toggle HUD Wireframe Target View || HUD_TARGETBOX_TOGGLE_WIREFRAME
|-
| Cycle Radar Range || RADAR_RANGE_CYCLE
|-
| Communications Menu || SQUADMSG_MENU
|-
| Show Objectives || SHOW_GOALS
|-
| Show Nav Map || SHOW_NAVMAP
|-
| Add or Remove Escort || ADD_REMOVE_ESCORT
|-
| Clear Escort List || ESCORT_CLEAR
|-
| - || TOGGLE_HUD_SHADOWS
|}

{| class="wikitable"
|+ style="color:white" | Squadmate Messaging
|-
! $Bind Name: !! $Bind:
|-
| Attack My Target || ATTACK_MESSAGE
|-
| Disarm My Target || DISARM_MESSAGE
|-
| Disable My Target || DISABLE_MESSAGE
|-
| Attack My Subsystem || ATTACK_SUBSYSTEM_MESSAGE
|-
| Capture My Target || CAPTURE_MESSAGE
|-
| Engage Enemy || ENGAGE_MESSAGE
|-
| Form on My Wing || FORM_MESSAGE
|-
| Ignore My Target || IGNORE_MESSAGE
|-
| Protect My Target || PROTECT_MESSAGE
|-
| Cover Me || COVER_MESSAGE
|-
| Return to Base || WARP_MESSAGE
|-
| Rearm Me || REARM_MESSAGE
|}

{| class="wikitable"
|+ style="color:white" | Views
|-
! $Bind Name: !! $Bind:
|-
| Chase View || VIEW_CHASE
|-
| External View || VIEW_EXTERNAL
|-
| Toggle External Camera Lock || VIEW_EXTERNAL_TOGGLE_CAMERA_LOCK
|-
| Free Look View || VIEW_SLEW
|-
| Current Target View || VIEW_OTHER_SHIP
|-
| Increase View Distance || VIEW_DIST_INCREASE
|-
| Decrease View Distance || VIEW_DIST_DECREASE
|-
| Center View || VIEW_CENTER
|-
| View Up || PADLOCK_UP
|-
| View Rear || PADLOCK_DOWN
|-
| View Left || PADLOCK_LEFT
|-
| View Right || PADLOCK_RIGHT
|-
| Top-Down View || VIEW_TOPDOWN
|-
| Target Padlock View || VIEW_TRACK_TARGET
|}

{| class="wikitable"
|-
|+ style="color:white" | ETS and Shields
|-
! $Bind Name: !! $Bind:
|-
| Increase Weapon Energy || INCREASE_WEAPON
|-
| Decrease Weapon Energy || DECREASE_WEAPON
|-
| Increase Shield Energy || INCREASE_SHIELD
|-
| Decrease Shield Energy || DECREASE_SHIELD
|-
|-
| Increase Engine Energy || INCREASE_ENGINE
|-
| Decrease Engine Energy || DECREASE_ENGINE
|-
| Equalize Energy Settings || ETS_EQUALIZE
|-
| Equalize Shields || SHIELD_EQUALIZE
|-
| Augment Forward Shield || SHIELD_XFER_TOP
|-
| Augment Rear Shield || SHIELD_XFER_BOTTOM
|-
| Augment Left Shield || SHIELD_XFER_LEFT
|-
| Augment Right Shield || SHIELD_XFER_RIGHT
|-
| Transfer Energy Laser->Shield || XFER_SHIELD
|-
| Transfer Energy Shield->Laser || XFER_LASER
|}

{| class="wikitable"
|+ style="color:white" | Misc
|-
! $Bind Name: !! $Bind:
|-
| Enter Subspace (End Mission) || END_MISSION
|-
| Increase Time Compression || TIME_SPEED_UP
|-
| Decrease Time Compression || TIME_SLOW_DOWN
|-
| Toggle Auto Pilot || AUTO_PILOT_TOGGLE
|-
| Cycle Nav Points || NAV_CYCLE
|-
| Toggle Gliding || TOGGLE_GLIDING
|-
| Toggle Auto Speed Matching || TOGGLE_AUTO_MATCH_TARGET_SPEED
|}

{| class="wikitable"
|+ style="color:white" | Multiplayer Only
|-
! $Bind Name: !! $Bind:
|-
| (Multiplayer) Message All || MULTI_MESSAGE_ALL
|-
| (Multiplayer) Message Friendly || MULTI_MESSAGE_FRIENDLY
|-
| (Multiplayer) Message Hostile || MULTI_MESSAGE_HOSTILE
|-
| (Multiplayer) Message Target || MULTI_MESSAGE_TARGET
|-
| (Multiplayer) Observer Zoom To Target || MULTI_OBSERVER_ZOOM_TO
|-
| (Multiplayer) Toggle Network info || MULTI_TOGGLE_NETINFO
|-
| (Multiplayer) Self Destruct || MULTI_SELF_DESTRUCT
|}

{| class="wikitable"
|+ style="color:white" | Custom Controls
|-
! $Bind Name: !! $Bind:
|-
| Custom Control 1 || CUSTOM_CONTROL_1
|-
| Custom Control 2 || CUSTOM_CONTROL_2
|-
| Custom Control 3 || CUSTOM_CONTROL_3
|-
| Custom Control 4 || CUSTOM_CONTROL_4
|-
| Custom Control 5 || CUSTOM_CONTROL_5
|}

{| class="wikitable"
|+ style="color:white" | Analog Controls
|-
! $Bind Name: !! $Bind:
|-
| - || JOY_HEADING_AXIS
|-
| - || JOY_PITCH_AXIS
|-
| - || JOY_BANK_AXIS
|-
| - || JOY_ABS_THROTTLE_AXIS
|-
| - || JOY_REL_THROTTLE_AXIS
|}

===Custom Controls===
{{Table382|
* 'Custom Control 1'
* 'Custom Control 2'
* 'Custom Control 3'
* 'Custom Control 4'
* 'Custom Control 5'

These are empty controls for modders and/or scripters to use.

Disabled by default

Default XSTR index is 0 (thus, they do not have an entry in [[strings.tbl]])

The default key bindings are Shift-Alt (1-5) for Custom Control 1-5, respectively.

To use these, create a new entry in a [[#ControlConfigOverride]] block and with the respective name. You should specify a label in [[strings.tbl]], otherwise they'll show up as "Custom Control" in the control config menu.

Example:
* $Bind Name: Custom Control 1
* $Has XStr: 1570
* $Disable: false
}}

==Allowed Keys==
*Not all keys are checked by FSO for key bindings, so some of these may not work.
*List coppied from controlsconfigcommon.cpp and edited to make readable.
*Must use the string below (without quotes).
*List of keys
:'KEY_0'
:'KEY_1'
:'KEY_2'
:'KEY_3'
:'KEY_4'
:'KEY_5'
:'KEY_6'
:'KEY_7'
:'KEY_8'
:'KEY_9'
:'KEY_A'
:'KEY_B'
:'KEY_C'
:'KEY_D'
:'KEY_E'
:'KEY_F'
:'KEY_G'
:'KEY_H'
:'KEY_I'
:'KEY_J'
:'KEY_K'
:'KEY_L'
:'KEY_M'
:'KEY_N'
:'KEY_O'
:'KEY_P'
:'KEY_Q'
:'KEY_R'
:'KEY_S'
:'KEY_T'
:'KEY_U'
:'KEY_V'
:'KEY_W'
:'KEY_X'
:'KEY_Y'
:'KEY_Z'
:'KEY_MINUS'
:'KEY_EQUAL'
:'KEY_DIVIDE'
:'KEY_SLASH'
:'KEY_SLASH_UK'
:'KEY_COMMA'
:'KEY_PERIOD'
:'KEY_SEMICOL'
:'KEY_LBRACKET'
:'KEY_RBRACKET'
:'KEY_RAPOSTRO'
:'KEY_LAPOSTRO'
:'KEY_ESC'
:'KEY_ENTER'
:'KEY_BACKSP'
:'KEY_TAB'
:'KEY_SPACEBAR'
:'KEY_NUMLOCK'
:'KEY_SCROLLOCK'
:'KEY_CAPSLOCK'
:'KEY_LSHIFT'
:'KEY_RSHIFT'
:'KEY_LALT'
:'KEY_RALT'
:'KEY_LCTRL'
:'KEY_RCTRL'
:'KEY_F1'
:'KEY_F2'
:'KEY_F3'
:'KEY_F4'
:'KEY_F5'
:'KEY_F6'
:'KEY_F7'
:'KEY_F8'
:'KEY_F9'
:'KEY_F10'
:'KEY_F11'
:'KEY_F12'
:'KEY_PAD0'
:'KEY_PAD1'
:'KEY_PAD2'
:'KEY_PAD3'
:'KEY_PAD4'
:'KEY_PAD5'
:'KEY_PAD6'
:'KEY_PAD7'
:'KEY_PAD8'
:'KEY_PAD9'
:'KEY_PADMINUS'
:'KEY_PADPLUS'
:'KEY_PADPERIOD'
:'KEY_PADDIVIDE'
:'KEY_PADMULTIPLY'
:'KEY_PADENTER'
:'KEY_INSERT'
:'KEY_HOME'
:'KEY_PAGEUP'
:'KEY_DELETE'
:'KEY_END'
:'KEY_PAGEDOWN'
:'KEY_UP'
:'KEY_DOWN'
:'KEY_LEFT'
:'KEY_RIGHT'
:'KEY_PRINT_SCRN'
:'KEY_PAUSE'
:'KEY_BREAK'

[[Category:Tables]]

Controlconfigdefaults.tbl

2022-10-12T14:07:05Z

Z64555: /* Table of Bindings */

{{TableVersionGit| 2021-02-13 UTC | db2bd97669c949e7d68baa9560192b7d3ad96563}}

{{Tables}}
The '''controlconfigdefaults.tbl''' can be used to modify the default key bindings in FSO.

==#ControlConfigOverride==
* Starts an Override section
* Begins with '''#ControlConfigOverride''' and ends with '''#End'''.
* Only entries that you want to change are required, the rest will use the default binding
* Entries not listed will be assigned to their default/hardcoded values.
{{Table371|
* Multiple #ControlConfigOverride...#End blocks can be provided.
** Each block defines a separate control config preset
** The "Defaults" button in the control config screen may be used to reset to the selected preset, then cycle through to the next preset.
** The first given block is used as the "global" defaults, and is used when working with the key-pressed SEXP and LUA scripts.
** Note: It's a good idea to also use [[Strings.tbl]] to change the "Defaults" text on the button to for example "Cycle\nPresets".
}}

==#ControlConfigPreset==
{{Table212|
* Starts a Preset section
* Begins with '''#ControlConfigPreset''' and ends with '''#End'''.
* All keybinds you wish to have bound must be specified, any unspecified keys will be unbound.
}}

===$Name:===
{{Table373|
* The name of this control config preset, displayed at the top left corner of the control config screen when selected through the "Defaults" button.
* If not provided, the first [[#ControlConfigOverride]] block will override the hardcoded defaults, all subsequent blocks will be '''<unnamed preset>.'''
{{Table212|
* If not provided, the [[#ControlConfigPreset]] block will be '''<unnamed preset>'''
}}
**Syntax: '''''String'''''
}}

===$Bind Name:===
*Name of the bind or action to modify the default key of.
*Valid entries: [[Controlconfigdefaults.tbl#List of Bindings|List of Bindings]]
*Required
*Syntax: '''String'''

====$Key Default:====
*Key to set as default
*Valid entries: [[Controlconfigdefaults.tbl#Allowed Keys|Allowed Keys]]
{{Table372|
*May be unbound by specifying '''NONE''' instead of a key}}
*Optional
*Syntax: '''String'''

====$Joy Default:====
*Joystick button to set as default
*Optional
*Syntax: '''Integer'''

====$Key Mod Shift:====
*Sets the key to require the Shift key
*'''1''' for yes, '''0''' for no
*Optional
*Syntax: '''Integer'''

====$Key Mod Alt:====

*Sets the key to require the Alt key
*'''1''' for yes, '''0''' for no
*Optional
*Syntax: '''Integer'''

====$Key Mod Ctrl:====
* Sets the key to require the Ctrl key
* '''1''' for yes, '''0''' for no
* Optional
* Syntax: '''Integer'''

====$Category:====
* Tab where the binding appears in the options menu.
* Valid entries: TARGET_TAB, SHIP_TAB, WEAPON_TAB, COMPUTER_TAB
* Optional
* Only valid in [[#ControlConfigOverride]] blocks
* Syntax: '''String'''

====$Text:====
{{Table212|
* The label of the control to use in the controls config menu.
* Is overridden by XSTR, if provided
** '''Note:''' This is meant to be a lazy temporary substitution to modifying [[strings.tbl]]. Your released mod should nstill provide its own strings.tbl.
* Optional
* Syntax: '''String'''
}}

====$Has XStr:====
* Whether or not the binding has an entry in [[strings.tbl]]
** If '''0''', assumes no XSTR is provided
** If '''1''', assumes an XSTR is provided alongside the other ControlConfig strings according to its internal, hardcoded index
{{Table382|
** If any nonzero integer >1, is the exact XSTR index within [[strings.tbl]]
}}
* Optional
* Only valid in [[#ControlConfigOverride]] blocks
* Syntax: '''Integer'''

====$Type:====
*Determines the type of control this is.

*Valid entries:
**CC_TYPE_TRIGGER
***Normal control that activates upon the first press. Resetting devices (such as weapons) will keep firing as long as the key/button is held down.
**CC_TYPE_CONTINUOUS
***Control that activates when the key/button is held down, and stays activated until the key/button is released. Ex: Afterburner key.
*Optional
*Only valid in [[#ControlConfigOverride]] blocks
*Syntax '''String'''

====$Disable:====
{{Table373|
*Determines whether the binding can be used and appears in the options menu. Can be used to hide bindings which are not needed, or to enable bindings which are hidden by default.
*Syntax: '''''Boolean'''''
}}

====+Disable====
{{Table212|
* Disables the control
* Optional
* Only valid in [[#ControlConfigOverride]] blocks
* Syntax: (No arguments)
}}

==#End==
* All [[#ControlConfigOverride]] and [[#ControlConfigPreset]] sections must be terminated by #End

==Sample==
This example does the following...
*Sets Clear Escort List to Alt-Shift-Q
*Sets Target Target's Attacker to Ctrl-Alt-Shift-J, moves it to the Ship Tab, denotes it's type as a trigger and sets it to not have a XString
*Sets Transfer Energy from Shield to Laser to R

<pre>
#ControlConfigOverride

$Bind Name: Clear Escort List
$Key Default: KEY_Q
$Key Mod Shift: 1
$Key Mod Alt: 1

$Bind Name: Target Target's Nearest Attacker
$Key Default: KEY_J
$Key Mod Shift: 1
$Key Mod Alt: 1
$Key Mod Ctrl: 1
$Category: SHIP_TAB
$Has XStr: 0
$TYPE: CC_TYPE_TRIGGER

$Bind Name: Transfer Energy Shield->Laser
$Key Default: KEY_R

#End
</pre>

==Table of Bindings==
* This is a table of all possible bindings that can be modified, grouped into smaller tables for easier reference.
* '''$Bind Name:''' column is to be used with '''$Bind Name:''' entries, and '''$Bind:''' column is to be used with '''$Bind:''' entries.
* These bindings are case-sensitive
* Controls added after 22.0 might not have a '''$Bind Name:'''. Use the '''$Bind:''' identifier instead.
{| class="wikitable"
|+ style="color:white" | Targeting
|-
! $Bind Name: !! $Bind:
|-
| Target Next Ship || TARGET_NEXT
|-
| Target Previous Ship || TARGET_PREV
|-
| Target Next Closest Hostile Ship || TARGET_NEXT_CLOSEST_HOSTILE
|-
| Target Previous Closest Hostile Ship || TARGET_PREV_CLOSEST_HOSTILE
|-
| Toggle Auto Targeting || TOGGLE_AUTO_TARGETING
|-
| Target Next Closest Friendly Ship || TARGET_NEXT_CLOSEST_FRIENDLY
|-
| Target Previous Closest Friendly Ship || TARGET_PREV_CLOSEST_FRIENDLY
|-
| Target Ship in Reticle || TARGET_SHIP_IN_RETICLE
|-
| Target Targets Nearest Attacker || TARGET_CLOSEST_SHIP_ATTACKING_TARGET
|-
| Target Last Ship to Send Transmission || TARGET_LAST_TRANMISSION_SENDER
|-
| Turn Off Targeting || STOP_TARGETING_SHIP
|-
| Target Closest Attacking Ship || TARGET_CLOSEST_SHIP_ATTACKING_SELF
|-
| Target Next Escort Ship || TARGET_NEXT_ESCORT_SHIP
|-
| Target Closest Repair Ship || TARGET_CLOSEST_REPAIR_SHIP
|-
| Target Next Uninspected Cargo || TARGET_NEXT_UNINSPECTED_CARGO
|-
| Target Previous Uninspected Cargo || TARGET_PREV_UNINSPECTED_CARGO
|-
| Target Newest Ship in Area || TARGET_NEWEST_SHIP
|-
| Target Targets Target || TARGET_TARGETS_TARGET
|-
| Target Next Hostile Bomb or Bomber || TARGET_NEXT_BOMB
|-
| Target Previous Hostile Bomb or Bomber || TARGET_PREV_BOMB
|}

{| class="wikitable"
|+ style="color:white" | Targeting Subsystems and Turrets
|-
! $Bind Name: !! $Bind:
|-
| Target Subsystem in Reticle || TARGET_SUBOBJECT_IN_RETICLE
|-
| Target Next Subsystem || TARGET_NEXT_SUBOBJECT
|-
| Target Previous Subsystem || TARGET_PREV_SUBOBJECT
|-
| Turn Off Targeting of Subsystems || STOP_TARGETING_SUBSYSTEM
|-
| Target Next Live Turret || TARGET_NEXT_LIVE_TURRET
|-
| Target Previous Live Turret || TARGET_PREV_LIVE_TURRET
|}

{| class="wikitable"
|+ style="color:white" | Weapons
|-
! $Bind Name: !! $Bind:
|-
| Fire Primary Weapon || FIRE_PRIMARY
|-
| Fire Secondary Weapon || FIRE_SECONDARY
|-
| Cycle Forward Primary Weapon || CYCLE_NEXT_PRIMARY
|-
| Cycle Backward Primary Weapon || CYCLE_PREV_PRIMARY
|-
| Cycle Primary Weapon Firing Rate || CYCLE_PRIMARY_WEAPON_SEQUENCE
|-
| Cycle Secondary Weapon Bank || CYCLE_SECONDARY
|-
| Cycle Secondary Weapon Firing Rate || CYCLE_NUM_MISSLES
|-
| Launch Countermeasure || LAUNCH_COUNTERMEASURE
|}

{| class="wikitable"
|+ style="color:white" | Flight Controls
|-
! $Bind Name: !! $Bind:
|-
| Forward Thrust || FORWARD_THRUST
|-
| Reverse Thrust || REVERSE_THRUST
|-
| Bank Left || BANK_LEFT
|-
| Bank Right || BANK_RIGHT
|-
| Pitch Forward || PITCH_FORWARD
|-
| Pitch Backward || PITCH_BACK
|-
| Turn Left || YAW_LEFT
|-
| Turn Right || YAW_RIGHT
|-
| Right Thrust || RIGHT_SLIDE_THRUST
|-
| Left Thrust || LEFT_SLIDE_THRUST
|-
| Up Thrust || UP_SLIDE_THRUST
|-
| Down Thrust || DOWN_SLIDE_THRUST
|-
| Afterburner || AFTERBURNER
|-
| Glide When Pressed || GLIDE_WHEN_PRESSED
|-
| Bank When Pressed || BANK_WHEN_PRESSED
|-
| Match Target Speed || MATCH_TARGET_SPEED
|}

{| class="wikitable"
|-
|+ style="color:white" | Throttle Control
|-
! $Bind Name: !! $Bind:
|-
| Set Throttle to Zero || ZERO_THROTTLE
|-
| Set Throttle to Max || MAX_THROTTLE
|-
| Set Throttle to One-Third || ONE_THIRD_THROTTLE
|-
| Set Throttle to Two-Thirds || TWO_THIRDS_THROTTLE
|-
| Increase Throttle 5 Percent || PLUS_5_PERCENT_THROTTLE
|-
| Decrease Throttle 5 Percent || MINUS_5_PERCENT_THROTTLE
|}

{| class="wikitable"
|+ style="color:white" | HUD Controls
|-
! $Bind Name: !! $Bind:
|-
| Toggle High HUD Contrast || TOGGLE_HUD_CONTRAST
|-
| Toggle HUD || TOGGLE_HUD
|-
| Toggle HUD Wireframe Target View || HUD_TARGETBOX_TOGGLE_WIREFRAME
|-
| Cycle Radar Range || RADAR_RANGE_CYCLE
|-
| Communications Menu || SQUADMSG_MENU
|-
| Show Objectives || SHOW_GOALS
|-
| Show Nav Map || SHOW_NAVMAP
|-
| Add or Remove Escort || ADD_REMOVE_ESCORT
|-
| Clear Escort List || ESCORT_CLEAR
|-
| - || TOGGLE_HUD_SHADOWS
|}

{| class="wikitable"
|+ style="color:white" | Squadmate Messaging
|-
! $Bind Name: !! $Bind:
|-
| Attack My Target || ATTACK_MESSAGE
|-
| Disarm My Target || DISARM_MESSAGE
|-
| Disable My Target || DISABLE_MESSAGE
|-
| Attack My Subsystem || ATTACK_SUBSYSTEM_MESSAGE
|-
| Capture My Target || CAPTURE_MESSAGE
|-
| Engage Enemy || ENGAGE_MESSAGE
|-
| Form on My Wing || FORM_MESSAGE
|-
| Ignore My Target || IGNORE_MESSAGE
|-
| Protect My Target || PROTECT_MESSAGE
|-
| Cover Me || COVER_MESSAGE
|-
| Return to Base || WARP_MESSAGE
|-
| Rearm Me || REARM_MESSAGE
|}

{| class="wikitable"
|+ style="color:white" | Views
|-
! $Bind Name: !! $Bind:
|-
| Chase View || VIEW_CHASE
|-
| External View || VIEW_EXTERNAL
|-
| Toggle External Camera Lock || VIEW_EXTERNAL_TOGGLE_CAMERA_LOCK
|-
| Free Look View || VIEW_SLEW
|-
| Current Target View || VIEW_OTHER_SHIP
|-
| Increase View Distance || VIEW_DIST_INCREASE
|-
| Decrease View Distance || VIEW_DIST_DECREASE
|-
| Center View || VIEW_CENTER
|-
| View Up || PADLOCK_UP
|-
| View Rear || PADLOCK_DOWN
|-
| View Left || PADLOCK_LEFT
|-
| View Right || PADLOCK_RIGHT
|-
| Top-Down View || VIEW_TOPDOWN
|-
| Target Padlock View || VIEW_TRACK_TARGET
|}

{| class="wikitable"
|-
|+ style="color:white" | ETS and Shields
|-
! $Bind Name: !! $Bind:
|-
| Increase Weapon Energy || INCREASE_WEAPON
|-
| Decrease Weapon Energy || DECREASE_WEAPON
|-
| Increase Shield Energy || INCREASE_SHIELD
|-
| Decrease Shield Energy || DECREASE_SHIELD
|-
|-
| Increase Engine Energy || INCREASE_ENGINE
|-
| Decrease Engine Energy || DECREASE_ENGINE
|-
| Equalize Energy Settings || ETS_EQUALIZE
|-
| Equalize Shields || SHIELD_EQUALIZE
|-
| Augment Forward Shield || SHIELD_XFER_TOP
|-
| Augment Rear Shield || SHIELD_XFER_BOTTOM
|-
| Augment Left Shield || SHIELD_XFER_LEFT
|-
| Augment Right Shield || SHIELD_XFER_RIGHT
|-
| Transfer Energy Laser->Shield || XFER_SHIELD
|-
| Transfer Energy Shield->Laser || XFER_LASER
|}

{| class="wikitable"
|+ style="color:white" | Misc
|-
! $Bind Name: !! $Bind:
|-
| Enter Subspace (End Mission) || END_MISSION
|-
| Increase Time Compression || TIME_SPEED_UP
|-
| Decrease Time Compression || TIME_SLOW_DOWN
|-
| Toggle Auto Pilot || AUTO_PILOT_TOGGLE
|-
| Cycle Nav Points || NAV_CYCLE
|-
| Toggle Gliding || TOGGLE_GLIDING
|-
| Toggle Auto Speed Matching || TOGGLE_AUTO_MATCH_TARGET_SPEED
|}

{| class="wikitable"
|+ style="color:white" | Multiplayer Only
|-
! $Bind Name: !! $Bind:
|-
| (Multiplayer) Message All || MULTI_MESSAGE_ALL
|-
| (Multiplayer) Message Friendly || MULTI_MESSAGE_FRIENDLY
|-
| (Multiplayer) Message Hostile || MULTI_MESSAGE_HOSTILE
|-
| (Multiplayer) Message Target || MULTI_MESSAGE_TARGET
|-
| (Multiplayer) Observer Zoom To Target || MULTI_OBSERVER_ZOOM_TO
|-
| (Multiplayer) Toggle Network info || MULTI_TOGGLE_NETINFO
|-
| (Multiplayer) Self Destruct || MULTI_SELF_DESTRUCT
|}

{| class="wikitable"
|+ style="color:white" | Custom Controls
|-
! $Bind Name: !! $Bind:
|-
| Custom Control 1 || CUSTOM_CONTROL_1
|-
| Custom Control 2 || CUSTOM_CONTROL_2
|-
| Custom Control 3 || CUSTOM_CONTROL_3
|-
| Custom Control 4 || CUSTOM_CONTROL_4
|-
| Custom Control 5 || CUSTOM_CONTROL_5
|}

{| class="wikitable"
|+ style="color:white" | Analog Controls
|-
! $Bind Name: !! $Bind:
|-
| - || JOY_HEADING_AXIS
|-
| - || JOY_PITCH_AXIS
|-
| - || JOY_BANK_AXIS
|-
| - || JOY_ABS_THROTTLE_AXIS
|-
| - || JOY_REL_THROTTLE_AXIS
|}

===Custom Controls===
{{Table382|
* 'Custom Control 1'
* 'Custom Control 2'
* 'Custom Control 3'
* 'Custom Control 4'
* 'Custom Control 5'

These are empty controls for modders and/or scripters to use.

Disabled by default

Default XSTR index is 0 (thus, they do not have an entry in [[strings.tbl]])

The default key bindings are Shift-Alt (1-5) for Custom Control 1-5, respectively.

To use these, create a new entry in a [[#ControlConfigOverride]] block and with the respective name. You should specify a label in [[strings.tbl]], otherwise they'll show up as "Custom Control" in the control config menu.

Example:
* $Bind Name: Custom Control 1
* $Has XStr: 1570
* $Disable: false
}}

==Allowed Keys==
*Not all keys are checked by FSO for key bindings, so some of these may not work.
*List coppied from controlsconfigcommon.cpp and edited to make readable.
*Must use the string below (without quotes).
*List of keys
:'KEY_0'
:'KEY_1'
:'KEY_2'
:'KEY_3'
:'KEY_4'
:'KEY_5'
:'KEY_6'
:'KEY_7'
:'KEY_8'
:'KEY_9'
:'KEY_A'
:'KEY_B'
:'KEY_C'
:'KEY_D'
:'KEY_E'
:'KEY_F'
:'KEY_G'
:'KEY_H'
:'KEY_I'
:'KEY_J'
:'KEY_K'
:'KEY_L'
:'KEY_M'
:'KEY_N'
:'KEY_O'
:'KEY_P'
:'KEY_Q'
:'KEY_R'
:'KEY_S'
:'KEY_T'
:'KEY_U'
:'KEY_V'
:'KEY_W'
:'KEY_X'
:'KEY_Y'
:'KEY_Z'
:'KEY_MINUS'
:'KEY_EQUAL'
:'KEY_DIVIDE'
:'KEY_SLASH'
:'KEY_SLASH_UK'
:'KEY_COMMA'
:'KEY_PERIOD'
:'KEY_SEMICOL'
:'KEY_LBRACKET'
:'KEY_RBRACKET'
:'KEY_RAPOSTRO'
:'KEY_LAPOSTRO'
:'KEY_ESC'
:'KEY_ENTER'
:'KEY_BACKSP'
:'KEY_TAB'
:'KEY_SPACEBAR'
:'KEY_NUMLOCK'
:'KEY_SCROLLOCK'
:'KEY_CAPSLOCK'
:'KEY_LSHIFT'
:'KEY_RSHIFT'
:'KEY_LALT'
:'KEY_RALT'
:'KEY_LCTRL'
:'KEY_RCTRL'
:'KEY_F1'
:'KEY_F2'
:'KEY_F3'
:'KEY_F4'
:'KEY_F5'
:'KEY_F6'
:'KEY_F7'
:'KEY_F8'
:'KEY_F9'
:'KEY_F10'
:'KEY_F11'
:'KEY_F12'
:'KEY_PAD0'
:'KEY_PAD1'
:'KEY_PAD2'
:'KEY_PAD3'
:'KEY_PAD4'
:'KEY_PAD5'
:'KEY_PAD6'
:'KEY_PAD7'
:'KEY_PAD8'
:'KEY_PAD9'
:'KEY_PADMINUS'
:'KEY_PADPLUS'
:'KEY_PADPERIOD'
:'KEY_PADDIVIDE'
:'KEY_PADMULTIPLY'
:'KEY_PADENTER'
:'KEY_INSERT'
:'KEY_HOME'
:'KEY_PAGEUP'
:'KEY_DELETE'
:'KEY_END'
:'KEY_PAGEDOWN'
:'KEY_UP'
:'KEY_DOWN'
:'KEY_LEFT'
:'KEY_RIGHT'
:'KEY_PRINT_SCRN'
:'KEY_PAUSE'
:'KEY_BREAK'

[[Category:Tables]]

Controlconfigdefaults.tbl

2022-10-12T14:03:47Z

Z64555: Reformat List of Bindings section into Table of Bindings section

{{TableVersionGit| 2021-02-13 UTC | db2bd97669c949e7d68baa9560192b7d3ad96563}}

{{Tables}}
The '''controlconfigdefaults.tbl''' can be used to modify the default key bindings in FSO.

==#ControlConfigOverride==
* Starts an Override section
* Begins with '''#ControlConfigOverride''' and ends with '''#End'''.
* Only entries that you want to change are required, the rest will use the default binding
* Entries not listed will be assigned to their default/hardcoded values.
{{Table371|
* Multiple #ControlConfigOverride...#End blocks can be provided.
** Each block defines a separate control config preset
** The "Defaults" button in the control config screen may be used to reset to the selected preset, then cycle through to the next preset.
** The first given block is used as the "global" defaults, and is used when working with the key-pressed SEXP and LUA scripts.
** Note: It's a good idea to also use [[Strings.tbl]] to change the "Defaults" text on the button to for example "Cycle\nPresets".
}}

==#ControlConfigPreset==
{{Table212|
* Starts a Preset section
* Begins with '''#ControlConfigPreset''' and ends with '''#End'''.
* All keybinds you wish to have bound must be specified, any unspecified keys will be unbound.
}}

===$Name:===
{{Table373|
* The name of this control config preset, displayed at the top left corner of the control config screen when selected through the "Defaults" button.
* If not provided, the first [[#ControlConfigOverride]] block will override the hardcoded defaults, all subsequent blocks will be '''<unnamed preset>.'''
{{Table212|
* If not provided, the [[#ControlConfigPreset]] block will be '''<unnamed preset>'''
}}
**Syntax: '''''String'''''
}}

===$Bind Name:===
*Name of the bind or action to modify the default key of.
*Valid entries: [[Controlconfigdefaults.tbl#List of Bindings|List of Bindings]]
*Required
*Syntax: '''String'''

====$Key Default:====
*Key to set as default
*Valid entries: [[Controlconfigdefaults.tbl#Allowed Keys|Allowed Keys]]
{{Table372|
*May be unbound by specifying '''NONE''' instead of a key}}
*Optional
*Syntax: '''String'''

====$Joy Default:====
*Joystick button to set as default
*Optional
*Syntax: '''Integer'''

====$Key Mod Shift:====
*Sets the key to require the Shift key
*'''1''' for yes, '''0''' for no
*Optional
*Syntax: '''Integer'''

====$Key Mod Alt:====

*Sets the key to require the Alt key
*'''1''' for yes, '''0''' for no
*Optional
*Syntax: '''Integer'''

====$Key Mod Ctrl:====
* Sets the key to require the Ctrl key
* '''1''' for yes, '''0''' for no
* Optional
* Syntax: '''Integer'''

====$Category:====
* Tab where the binding appears in the options menu.
* Valid entries: TARGET_TAB, SHIP_TAB, WEAPON_TAB, COMPUTER_TAB
* Optional
* Only valid in [[#ControlConfigOverride]] blocks
* Syntax: '''String'''

====$Text:====
{{Table212|
* The label of the control to use in the controls config menu.
* Is overridden by XSTR, if provided
** '''Note:''' This is meant to be a lazy temporary substitution to modifying [[strings.tbl]]. Your released mod should nstill provide its own strings.tbl.
* Optional
* Syntax: '''String'''
}}

====$Has XStr:====
* Whether or not the binding has an entry in [[strings.tbl]]
** If '''0''', assumes no XSTR is provided
** If '''1''', assumes an XSTR is provided alongside the other ControlConfig strings according to its internal, hardcoded index
{{Table382|
** If any nonzero integer >1, is the exact XSTR index within [[strings.tbl]]
}}
* Optional
* Only valid in [[#ControlConfigOverride]] blocks
* Syntax: '''Integer'''

====$Type:====
*Determines the type of control this is.

*Valid entries:
**CC_TYPE_TRIGGER
***Normal control that activates upon the first press. Resetting devices (such as weapons) will keep firing as long as the key/button is held down.
**CC_TYPE_CONTINUOUS
***Control that activates when the key/button is held down, and stays activated until the key/button is released. Ex: Afterburner key.
*Optional
*Only valid in [[#ControlConfigOverride]] blocks
*Syntax '''String'''

====$Disable:====
{{Table373|
*Determines whether the binding can be used and appears in the options menu. Can be used to hide bindings which are not needed, or to enable bindings which are hidden by default.
*Syntax: '''''Boolean'''''
}}

====+Disable====
{{Table212|
* Disables the control
* Optional
* Only valid in [[#ControlConfigOverride]] blocks
* Syntax: (No arguments)
}}

==#End==
* All [[#ControlConfigOverride]] and [[#ControlConfigPreset]] sections must be terminated by #End

==Sample==
This example does the following...
*Sets Clear Escort List to Alt-Shift-Q
*Sets Target Target's Attacker to Ctrl-Alt-Shift-J, moves it to the Ship Tab, denotes it's type as a trigger and sets it to not have a XString
*Sets Transfer Energy from Shield to Laser to R

<pre>
#ControlConfigOverride

$Bind Name: Clear Escort List
$Key Default: KEY_Q
$Key Mod Shift: 1
$Key Mod Alt: 1

$Bind Name: Target Target's Nearest Attacker
$Key Default: KEY_J
$Key Mod Shift: 1
$Key Mod Alt: 1
$Key Mod Ctrl: 1
$Category: SHIP_TAB
$Has XStr: 0
$TYPE: CC_TYPE_TRIGGER

$Bind Name: Transfer Energy Shield->Laser
$Key Default: KEY_R

#End
</pre>

==Table of Bindings==
* This is a tableof all possible bindings that can be modified.
* '''$Bind Name:''' column is to be used with '''$Bind Name:''' entries, and '''$Bind:''' column is to be used with '''$Bind:''' entries.
* These bindings are case-sensitive
* Controls added after 22.0 might not have a '''$Bind Name:'''. Use the '''$Bind:''' identifier instead.
{| class="wikitable"
|+ style="color:white" | Targeting
|-
! $Bind Name: !! $Bind:
|-
| Target Next Ship || TARGET_NEXT
|-
| Target Previous Ship || TARGET_PREV
|-
| Target Next Closest Hostile Ship || TARGET_NEXT_CLOSEST_HOSTILE
|-
| Target Previous Closest Hostile Ship || TARGET_PREV_CLOSEST_HOSTILE
|-
| Toggle Auto Targeting || TOGGLE_AUTO_TARGETING
|-
| Target Next Closest Friendly Ship || TARGET_NEXT_CLOSEST_FRIENDLY
|-
| Target Previous Closest Friendly Ship || TARGET_PREV_CLOSEST_FRIENDLY
|-
| Target Ship in Reticle || TARGET_SHIP_IN_RETICLE
|-
| Target Targets Nearest Attacker || TARGET_CLOSEST_SHIP_ATTACKING_TARGET
|-
| Target Last Ship to Send Transmission || TARGET_LAST_TRANMISSION_SENDER
|-
| Turn Off Targeting || STOP_TARGETING_SHIP
|-
| Target Closest Attacking Ship || TARGET_CLOSEST_SHIP_ATTACKING_SELF
|-
| Target Next Escort Ship || TARGET_NEXT_ESCORT_SHIP
|-
| Target Closest Repair Ship || TARGET_CLOSEST_REPAIR_SHIP
|-
| Target Next Uninspected Cargo || TARGET_NEXT_UNINSPECTED_CARGO
|-
| Target Previous Uninspected Cargo || TARGET_PREV_UNINSPECTED_CARGO
|-
| Target Newest Ship in Area || TARGET_NEWEST_SHIP
|-
| Target Targets Target || TARGET_TARGETS_TARGET
|-
| Target Next Hostile Bomb or Bomber || TARGET_NEXT_BOMB
|-
| Target Previous Hostile Bomb or Bomber || TARGET_PREV_BOMB
|}

{| class="wikitable"
|+ style="color:white" | Targeting Subsystems and Turrets
|-
! $Bind Name: !! $Bind:
|-
| Target Subsystem in Reticle || TARGET_SUBOBJECT_IN_RETICLE
|-
| Target Next Subsystem || TARGET_NEXT_SUBOBJECT
|-
| Target Previous Subsystem || TARGET_PREV_SUBOBJECT
|-
| Turn Off Targeting of Subsystems || STOP_TARGETING_SUBSYSTEM
|-
| Target Next Live Turret || TARGET_NEXT_LIVE_TURRET
|-
| Target Previous Live Turret || TARGET_PREV_LIVE_TURRET
|}

{| class="wikitable"
|+ style="color:white" | Weapons
|-
! $Bind Name: !! $Bind:
|-
| Fire Primary Weapon || FIRE_PRIMARY
|-
| Fire Secondary Weapon || FIRE_SECONDARY
|-
| Cycle Forward Primary Weapon || CYCLE_NEXT_PRIMARY
|-
| Cycle Backward Primary Weapon || CYCLE_PREV_PRIMARY
|-
| Cycle Primary Weapon Firing Rate || CYCLE_PRIMARY_WEAPON_SEQUENCE
|-
| Cycle Secondary Weapon Bank || CYCLE_SECONDARY
|-
| Cycle Secondary Weapon Firing Rate || CYCLE_NUM_MISSLES
|-
| Launch Countermeasure || LAUNCH_COUNTERMEASURE
|}

{| class="wikitable"
|+ style="color:white" | Flight Controls
|-
! $Bind Name: !! $Bind:
|-
| Forward Thrust || FORWARD_THRUST
|-
| Reverse Thrust || REVERSE_THRUST
|-
| Bank Left || BANK_LEFT
|-
| Bank Right || BANK_RIGHT
|-
| Pitch Forward || PITCH_FORWARD
|-
| Pitch Backward || PITCH_BACK
|-
| Turn Left || YAW_LEFT
|-
| Turn Right || YAW_RIGHT
|-
| Right Thrust || RIGHT_SLIDE_THRUST
|-
| Left Thrust || LEFT_SLIDE_THRUST
|-
| Up Thrust || UP_SLIDE_THRUST
|-
| Down Thrust || DOWN_SLIDE_THRUST
|-
| Afterburner || AFTERBURNER
|-
| Glide When Pressed || GLIDE_WHEN_PRESSED
|-
| Bank When Pressed || BANK_WHEN_PRESSED
|-
| Match Target Speed || MATCH_TARGET_SPEED
|}

{| class="wikitable"
|-
|+ style="color:white" | Throttle Control
|-
! $Bind Name: !! $Bind:
|-
| Set Throttle to Zero || ZERO_THROTTLE
|-
| Set Throttle to Max || MAX_THROTTLE
|-
| Set Throttle to One-Third || ONE_THIRD_THROTTLE
|-
| Set Throttle to Two-Thirds || TWO_THIRDS_THROTTLE
|-
| Increase Throttle 5 Percent || PLUS_5_PERCENT_THROTTLE
|-
| Decrease Throttle 5 Percent || MINUS_5_PERCENT_THROTTLE
|}

{| class="wikitable"
|+ style="color:white" | HUD Controls
|-
! $Bind Name: !! $Bind:
|-
| Toggle High HUD Contrast || TOGGLE_HUD_CONTRAST
|-
| Toggle HUD || TOGGLE_HUD
|-
| Toggle HUD Wireframe Target View || HUD_TARGETBOX_TOGGLE_WIREFRAME
|-
| Cycle Radar Range || RADAR_RANGE_CYCLE
|-
| Communications Menu || SQUADMSG_MENU
|-
| Show Objectives || SHOW_GOALS
|-
| Show Nav Map || SHOW_NAVMAP
|-
| Add or Remove Escort || ADD_REMOVE_ESCORT
|-
| Clear Escort List || ESCORT_CLEAR
|-
| - || TOGGLE_HUD_SHADOWS
|}

{| class="wikitable"
|+ style="color:white" | Squadmate Messaging
|-
! $Bind Name: !! $Bind:
|-
| Attack My Target || ATTACK_MESSAGE
|-
| Disarm My Target || DISARM_MESSAGE
|-
| Disable My Target || DISABLE_MESSAGE
|-
| Attack My Subsystem || ATTACK_SUBSYSTEM_MESSAGE
|-
| Capture My Target || CAPTURE_MESSAGE
|-
| Engage Enemy || ENGAGE_MESSAGE
|-
| Form on My Wing || FORM_MESSAGE
|-
| Ignore My Target || IGNORE_MESSAGE
|-
| Protect My Target || PROTECT_MESSAGE
|-
| Cover Me || COVER_MESSAGE
|-
| Return to Base || WARP_MESSAGE
|-
| Rearm Me || REARM_MESSAGE
|}

{| class="wikitable"
|+ style="color:white" | Views
|-
! $Bind Name: !! $Bind:
|-
| Chase View || VIEW_CHASE
|-
| External View || VIEW_EXTERNAL
|-
| Toggle External Camera Lock || VIEW_EXTERNAL_TOGGLE_CAMERA_LOCK
|-
| Free Look View || VIEW_SLEW
|-
| Current Target View || VIEW_OTHER_SHIP
|-
| Increase View Distance || VIEW_DIST_INCREASE
|-
| Decrease View Distance || VIEW_DIST_DECREASE
|-
| Center View || VIEW_CENTER
|-
| View Up || PADLOCK_UP
|-
| View Rear || PADLOCK_DOWN
|-
| View Left || PADLOCK_LEFT
|-
| View Right || PADLOCK_RIGHT
|-
| Top-Down View || VIEW_TOPDOWN
|-
| Target Padlock View || VIEW_TRACK_TARGET
|}

{| class="wikitable"
|-
|+ style="color:white" | ETS and Shields
|-
! $Bind Name: !! $Bind:
|-
| Increase Weapon Energy || INCREASE_WEAPON
|-
| Decrease Weapon Energy || DECREASE_WEAPON
|-
| Increase Shield Energy || INCREASE_SHIELD
|-
| Decrease Shield Energy || DECREASE_SHIELD
|-
|-
| Increase Engine Energy || INCREASE_ENGINE
|-
| Decrease Engine Energy || DECREASE_ENGINE
|-
| Equalize Energy Settings || ETS_EQUALIZE
|-
| Equalize Shields || SHIELD_EQUALIZE
|-
| Augment Forward Shield || SHIELD_XFER_TOP
|-
| Augment Rear Shield || SHIELD_XFER_BOTTOM
|-
| Augment Left Shield || SHIELD_XFER_LEFT
|-
| Augment Right Shield || SHIELD_XFER_RIGHT
|-
| Transfer Energy Laser->Shield || XFER_SHIELD
|-
| Transfer Energy Shield->Laser || XFER_LASER
|}

{| class="wikitable"
|+ style="color:white" | Misc
|-
! $Bind Name: !! $Bind:
|-
| Enter Subspace (End Mission) || END_MISSION
|-
| Increase Time Compression || TIME_SPEED_UP
|-
| Decrease Time Compression || TIME_SLOW_DOWN
|-
| Toggle Auto Pilot || AUTO_PILOT_TOGGLE
|-
| Cycle Nav Points || NAV_CYCLE
|-
| Toggle Gliding || TOGGLE_GLIDING
|-
| Toggle Auto Speed Matching || TOGGLE_AUTO_MATCH_TARGET_SPEED
|}

{| class="wikitable"
|+ style="color:white" | Multiplayer Only
|-
! $Bind Name: !! $Bind:
|-
| (Multiplayer) Message All || MULTI_MESSAGE_ALL
|-
| (Multiplayer) Message Friendly || MULTI_MESSAGE_FRIENDLY
|-
| (Multiplayer) Message Hostile || MULTI_MESSAGE_HOSTILE
|-
| (Multiplayer) Message Target || MULTI_MESSAGE_TARGET
|-
| (Multiplayer) Observer Zoom To Target || MULTI_OBSERVER_ZOOM_TO
|-
| (Multiplayer) Toggle Network info || MULTI_TOGGLE_NETINFO
|-
| (Multiplayer) Self Destruct || MULTI_SELF_DESTRUCT
|}

{| class="wikitable"
|+ style="color:white" | Custom Controls
|-
! $Bind Name: !! $Bind:
|-
| Custom Control 1 || CUSTOM_CONTROL_1
|-
| Custom Control 2 || CUSTOM_CONTROL_2
|-
| Custom Control 3 || CUSTOM_CONTROL_3
|-
| Custom Control 4 || CUSTOM_CONTROL_4
|-
| Custom Control 5 || CUSTOM_CONTROL_5
|}

{| class="wikitable"
|+ style="color:white" | Analog Controls
|-
! $Bind Name: !! $Bind:
|-
| - || JOY_HEADING_AXIS
|-
| - || JOY_PITCH_AXIS
|-
| - || JOY_BANK_AXIS
|-
| - || JOY_ABS_THROTTLE_AXIS
|-
| - || JOY_REL_THROTTLE_AXIS
|}

===Custom Controls===
{{Table382|
* 'Custom Control 1'
* 'Custom Control 2'
* 'Custom Control 3'
* 'Custom Control 4'
* 'Custom Control 5'

These are empty controls for modders and/or scripters to use.

Disabled by default

Default XSTR index is 0 (thus, they do not have an entry in [[strings.tbl]])

The default key bindings are Shift-Alt (1-5) for Custom Control 1-5, respectively.

To use these, create a new entry in a [[#ControlConfigOverride]] block and with the respective name. You should specify a label in [[strings.tbl]], otherwise they'll show up as "Custom Control" in the control config menu.

Example:
* $Bind Name: Custom Control 1
* $Has XStr: 1570
* $Disable: false
}}

==Allowed Keys==
*Not all keys are checked by FSO for key bindings, so some of these may not work.
*List coppied from controlsconfigcommon.cpp and edited to make readable.
*Must use the string below (without quotes).
*List of keys
:'KEY_0'
:'KEY_1'
:'KEY_2'
:'KEY_3'
:'KEY_4'
:'KEY_5'
:'KEY_6'
:'KEY_7'
:'KEY_8'
:'KEY_9'
:'KEY_A'
:'KEY_B'
:'KEY_C'
:'KEY_D'
:'KEY_E'
:'KEY_F'
:'KEY_G'
:'KEY_H'
:'KEY_I'
:'KEY_J'
:'KEY_K'
:'KEY_L'
:'KEY_M'
:'KEY_N'
:'KEY_O'
:'KEY_P'
:'KEY_Q'
:'KEY_R'
:'KEY_S'
:'KEY_T'
:'KEY_U'
:'KEY_V'
:'KEY_W'
:'KEY_X'
:'KEY_Y'
:'KEY_Z'
:'KEY_MINUS'
:'KEY_EQUAL'
:'KEY_DIVIDE'
:'KEY_SLASH'
:'KEY_SLASH_UK'
:'KEY_COMMA'
:'KEY_PERIOD'
:'KEY_SEMICOL'
:'KEY_LBRACKET'
:'KEY_RBRACKET'
:'KEY_RAPOSTRO'
:'KEY_LAPOSTRO'
:'KEY_ESC'
:'KEY_ENTER'
:'KEY_BACKSP'
:'KEY_TAB'
:'KEY_SPACEBAR'
:'KEY_NUMLOCK'
:'KEY_SCROLLOCK'
:'KEY_CAPSLOCK'
:'KEY_LSHIFT'
:'KEY_RSHIFT'
:'KEY_LALT'
:'KEY_RALT'
:'KEY_LCTRL'
:'KEY_RCTRL'
:'KEY_F1'
:'KEY_F2'
:'KEY_F3'
:'KEY_F4'
:'KEY_F5'
:'KEY_F6'
:'KEY_F7'
:'KEY_F8'
:'KEY_F9'
:'KEY_F10'
:'KEY_F11'
:'KEY_F12'
:'KEY_PAD0'
:'KEY_PAD1'
:'KEY_PAD2'
:'KEY_PAD3'
:'KEY_PAD4'
:'KEY_PAD5'
:'KEY_PAD6'
:'KEY_PAD7'
:'KEY_PAD8'
:'KEY_PAD9'
:'KEY_PADMINUS'
:'KEY_PADPLUS'
:'KEY_PADPERIOD'
:'KEY_PADDIVIDE'
:'KEY_PADMULTIPLY'
:'KEY_PADENTER'
:'KEY_INSERT'
:'KEY_HOME'
:'KEY_PAGEUP'
:'KEY_DELETE'
:'KEY_END'
:'KEY_PAGEDOWN'
:'KEY_UP'
:'KEY_DOWN'
:'KEY_LEFT'
:'KEY_RIGHT'
:'KEY_PRINT_SCRN'
:'KEY_PAUSE'
:'KEY_BREAK'

[[Category:Tables]]

Launcher engine interaction

2022-07-13T12:48:31Z

Z64555: /* fs2_open.ini */ Add default to ConnectionSpeed

A launcher for the FreeSpace Open engine is responsible for letting the user configure what mod data FSO should use and also how it should use the available hardware (e.g. joysticks or sound devices). It is also important with what flags FSO is started to allow how the game behaves and looks like. In order for this to work, the launcher needs to follow certain conventions which allow FSO to interpret the data the launcher sets for the engine.

This article describes the situation as of FSO version 3.8.0. Previous versions used different configuration mechanisms but those will not be listed here.

=Writing data for the engine to read=
The engine will look for the files described below in the "preferences" path. This path is determined by using the SDL2 function <tt>SDL_GetPrefPath("HardLightProductions", "FreeSpaceOpen")</tt>. Newer engine versions have a way of getting this information without having to link against SDL2, see [[#JSON output|JSON output]] for an alternative way of determining this path.

There are two major configuration mechanisms FSO uses for reading data which was set by the launcher:

==data/cmdline_fso.cfg==
This file should contain all the command line options FSO should use. They should be on a single line and parameters which contain spaces (e.g. mods line "Vassago's Dirge") must be enclosed in quotes:

<pre>
-mod "Vassago's Dirge,MediaVPs_2014" -nomotiondebris -missile_lighting -3dshockwave -post_process -soft_particles -fxaa -fb_explosions -fb_thrusters -enable_shadows -cache_bitmaps -dualscanlines -targetinfo -orbradar -rearm_timer -ballistic_gauge -3dwarp -snd_preload -nosound -nomovies -fps -window -no_unfocused_pause -benchmark_mode -fxaa_preset 6 -ambient_factor 100 -spec_exp 15 -spec_point 1.2 -spec_static 1.5 -spec_tube 1.5 -ogl_spec 20 -bloom_intensity 45
</pre>

The available flags should not be hardcoded by the launcher. Instead, it should use [[#Getting a list of supported flags and devices|-get_flags]] for determining which flags are supported by the launcher.

==fs2_open.ini==
This file contains more "permanent" options and is saved in a standard ini format. The file is separated into multiple "sections" which each contain options specific to that part of the engine:

; Default : This is the default section used by FSO if no specific section is selected.

:; VideocardFs2open
:: This value determines what display mode FSO will use. It has the following format: <tt>[API]-([width]x[height])x[bits] bit</tt>. <tt>[API]</tt> must be exactly 4 characters long. The only valid option here is "OGL " for using the OpenGL API. The other options are pretty obvious. The width and height should match one of the video modes supported by the display (see [[#JSON output|JSON output]] for a way of getting this information without linking against SDL2). The <tt>bits</tt> parameter should either be 16 or 32 but in almost all cases this should be hard-coded to 32.

:; OGL_AntiAliasSamples
:: This should be the level of anti-aliasing desired for OpenGL rendering. This should be the multiple of 2 for how many samples should be taken (e.g. a value of 3 means 8x MSAA). If set to 0 anti-aliasing will be disabled.
:::'''Note:''' As of FSO 3.8.0 this option has no effect!

:; TextureFilter
:: Sets how textures should be filtered. Valid values are 0 for bilinear filtering and 1 for trilinear filtering.

:; OGL_AnisotropicFilter
:: Specifies the level of anisotropic texture filtering if supported by the OpenGL implementation.

:; CurrentJoystickGUID
:: Specifies the GUID of the primary joystick. The case of alphabetic characters will be normalized so it doesn't matter if this string is upper or lower case. This GUID can be determined by using SDL2 or with the [[#JSON output|JSON output]] (if supported by the current build).
:::'''Note:''' This is the part of the legacy method of defining the joystick. See Joy0GUID and Joy0ID below.

:; CurrentJoystick
:: Specified the index of the primary joystick. This will only be used if there are multiple joysticks with the same GUID. This is the index used to open the joystick in SDL2 or the index into the joysticks array in the [[#JSON output|JSON output]].
:::'''Note:''' This is the part of the legacy method of defining the joystick. See Joy0GUID and Joy0ID below.

:; Joy0ID
:: As of FSO 22.0, used for defining your first of multiple joysticks. Get this ID from the ID listed in the exported flags.txt. For details on how to export visit the [https://wiki.hard-light.net/index.php/Frequently_Asked_Questions_(FAQ) FAQ].

:; Joy0GUID
:: As of FSO 22.0, used for defining your first of multiple joysticks. Get this GUID from the GUID listed in the exported flags.txt, matching the entry used for Joy0ID. For details on how to export visit the wiki's [https://wiki.hard-light.net/index.php/Frequently_Asked_Questions_(FAQ) FAQ].

:; Joy1ID
:: Same as Joy0ID, but for defining your second joystick.

:; Joy1GUID
:: Same as Joy0GUID, but for defining your second joystick.

:; Joy2ID
:: Same as Joy0ID, but for defining your third joystick.

:; Joy2GUID
:: Same as Joy0GUID, but for defining your third joystick.

:; Joy3ID
:: Same as Joy0ID, but for defining your fourth joystick.

:; Joy3GUID
:: Same as Joy0GUID, but for defining your fourth joystick.

:; LastPlayer
:: The name of the last pilot used. Used by the engine to determine which pilot should be at the top of the list and pre-loaded.

:; GammaD3D
:: The gamma (brightness) value to be used to display the game.

:; EnableJoystickFF
:: Used to determine if force feedback should be enabled if the joystick supports it. If using the [[#JSON output|JSON output]] then it's possible to determine if a joystick supports this by looking at the '''is_haptic''' field of the joystick object.

:; EnableHitEffect
:: This can be used to enable or disable a directional hit effect if Force Feedback is enabled.

:; Language
:: Sets the language of the game. Possible values are "English", "German", "French", and "Polish".

:; ForceFullscreen : If set to 1, forces the game to start in full screen mode.

:; ScreenshotNum : The number of screenshots taken by the player.

:; MaxFPS : Used to set the framerate cap for the game. If set to zero, framerate cap is disabled.

:; ForcePort : Used to force a specific port for multiplayer connections

:; ConnectionSpeed
:: Used for setting how fast the internet connection is. Possible values are "Slow", "56K", "ISDN", "Cable", and "Fast". Defaults to "Fast" for non-windows OS's.

:; SpeechTechroom : Enables or disables text-to-speech in the techroom. Valid values are 1 and 0. Defaults to 0.

:; SpeechBriefings : Enables or disables text-to-speech in the briefings. Valid values are 1 and 0. Defaults to 0.

:; SpeechIngame : Enables or disables text-to-speech in game. Valid values are 1 and 0. Defaults to 0.

:; SpeechMulti : Enables or disables text-to-speech in the multiplayer. Valid values are 1 and 0. Defaults to 0.

:; SpeechVolume : The volume scale of the text-to-speech sound. Should be in the range of 0 to 100.

:; SpeechVoice : Sets which voice to use. See [[#JSON output|JSON output]] for a cross-platform way of determining which voices are available.

:; PXOBanners : Whether or not to use Banners for multiplayer. Valid values are 1 and 0. Defaults to 1.

:; LowMem : Use Low Memory mode (Allows 2d animations to drop frames)

:; ProcessorAffinity : Set which processor should be assigned to the game. Defaults to 2. This setting applies only on Windows.

:; ImageExportNum : The index of the next file to be dds exported from FSO.

; Video : Contains options specific to the video display of FSO.

:; Display
:: Used to choose on which display FSO should be displayed on. The [[#JSON output|JSON output]] contains a list of display detected on the system and their index. Alternatively, SDL2 can be used to enumerate this information.

; ForceFeedback : Contains options for configuring the force feedback subsystem of FSO.

:; Strength : A percentage scale of how strong the effect should be. 0 means completely disabled, 100 means full strength.

; Sound : Contains options specific to how sound should be handled in FSO.

:; Quality : Specifies the quality of the sound output. The value should be in [1, 3] where 3 is the highest quality and 1 is the lowest.

:; SampleRate : Explicitly specifies the sample rate the OpenAL context should use.

:; EnableEFX : Enables or disables usage of OpenAL EFX.

:; PlaybackDevice : Sets the playback device OpenAL should use. The [[#JSON output|JSON output]] contains a list of available playback devices.

:; CaptureDevice : Sets the capture device OpenAL should use. The [[#JSON output|JSON output]] contains a list of available capture devices.

; PXO : Contains settings related to the PXO multiplayer service

:; Login : The login number for the player's account

:; Password : The password the player uses for logging into the PXO service (not the account's password)

:; SquadName : The Squad Name the player uses.

=Getting a list of supported flags and devices=
As of 3.8.1, FSO has two ways of determining what flags are supported by the engine. The JSON output has more information and should be easier to parse but is only supported by newer builds.

The flags can be queries by passing the <tt>-get_flags</tt> option to FSO (this should be done directly instead of overwriting <tt>cmdline_fso.cfg</tt>). When doing this, the command line should also contain the <tt>-parse_cmdline_only</tt> to make sure that FSO only reads the actual command line and not <tt>cmdline_fso.cfg</tt>. This avoids issues when <tt>cmdline_fso.cfg</tt> contains options not supported by the selected FSO binary. Since 3.8.1, <tt>-get_flags</tt> optionally accepts one string parameter for selecting how the flags data is formatted and where it is written.

If FSO does not support the parameter for <tt>-get_flags</tt> then it will be ignored silently and the legacy binary format will be used. Every version before 3.8.1 will behave this way. This allows to gracefully degrade to the old legacy behavior if support for older builds is desired. Also, if the build does not support the given <tt>-get_flags</tt> mode then it will print the string "OUTPUT TYPE NOT SUPPORTED!" to <tt>stdout</tt> and default to the version 1 of the JSON output. This is designed so that it is easy for a launcher to be notified if the selected format is not supported.

==JSON output==
This mode for <tt>-get_flags</tt> was introduced in 3.8.1 and can be enabled by using "json_v1" as the mode parameter <tt>-get_flags</tt> (e.g. <tt>-get_flags json_v1</tt>). In this mode FSO will output a JSON formatted data structure to stdout which will contain information about the supported flags and available devices that FSO detected. The object structure of this output is described in the following by using hierarchical lists for symbolizing if an object key is a child of another element. The root of the output will be a JSON object.

; "version" : Contains information about the version of this executable.
:; "full" : The full version string as is displayed in the main menu.
:; "major" : The major part of the version as an integer number.
:; "minor" : The minor part of the version as an integer number.
:; "build" : The build part of the version as an integer number.
:; "has_revision" : A boolean to indicate if this version has a valid revision part.
:; "revision" : An integer indicating the revision part of the build version.
:; "revision_str" : A string indicating the full revision part of the build version. This may contain the Git hash of the commit in the case of nightly builds or something like "RC2" for release candidates.

; "easy_flags" : This is an array of the available "Easy flags" configuration names. The flags array will contain two bitfields where a bit at position n (starting from the last significant bit) will reference the entry of this array which is at position n.

; "flags" : This is an array of all the flags supported by this binary.
:; "name" : A string which specifies the name of the flag (e.g. <tt>-soft_particles</tt>).
:; "description" : A short description of what this flag does. This should be displayed in the launcher overview.
:; "fso_only" : A boolean indicating whether this flag is only available in FSO builds or not.
:; "on_flags" : An integer which represents a bitfield for which easy flags enable this flag. If the bit n is set in this integer then selecting the easy flag at index n will enable this flag. No action should be taken for the bits that are not set in this bitfield.
:; "off_flags" : An integer which represents a bitfield for which easy flags disable this flag. If the bit n is set in this integer then selecting the easy flag at index n will disable this flag. No action should be taken for the bits that are not set in this bitfield.
:; "type" : Specifies the category of this flag. Typically all flags with the same category will be grouped together.
:; "web_url" : Specifies an URL where more information about this flag can be found.

; "caps"
: A string array of what capabilities this build has. The following strings may be present in the array:
:; OpenAL : This build uses OpenAL for sound.
:; No D3D : This build has no support for Direct3D rendering, only OpenGL.
:; New Sound : This build has support for the new, enhanced sound code.
:; SDL : This build uses SDL on all platforms.

; "voices" : An array of all the possible voice names detected by FSO. If a specific voice should be used then to set the <tt>SpeechVoice</tt> key to the index of that voice in this array.

; "displays" : Contains information about all the displays currently connected to the system.
:; "index" : The index in the array of this display. This should be used for the value of <tt>Video.Display</tt>
:; "name" : A more or less human-readable name of this display.
:; "x" : The x offset of where this display is located. This is only relevant for multi-monitor systems where this value specifies the x-offset relative to the other displays.
:; "y" : The y offset of where this display is located. This is only relevant for multi-monitor systems where this value specifies the y-offset relative to the other displays.
:; "width" : The x-resolution of this display.
:; "height" : The y-resolution of this display.
:; "modes" : Possible video modes of this display.
::; "x": The x-resolution of this video mode.
::; "y": The y-resolution of this video mode.
::; "bits": The bit depth of this video mode (this is typically 32).

; "openal" : Contains information about detected OpenAL properties and devices.
:; "version_major" : The major version of OpenAL as detected by FSO.
:; "version_minor" : The minor version of OpenAL as detected by FSO.
:; "default_playback" : The default playback device as reported by OpenAL. It is possible that this device does not appear in the playback device list.
:; "default_capture" : The default capture device as reported by OpenAL. It is possible that this device does not appear in the capture device list.
:; "playback_devices" : A string array of all the playback devices detected by OpenAL.
:; "capture_devices" : A string array of all the capture devices detected by OpenAL.

; "joysticks" : An array of all the joysticks that FSO detected.
:; "name" : A string which specifies a human-readable name of this joystick.
:; "guid" : The GUID ('''G'''lobally '''U'''nique '''Id'''entifier) of this joystick. This should be used for setting <tt>CurrentJoystickGUID</tt> in <tt>fs2_open.ini</tt>
:; "num_axes" : The number of axes detected on this joystick.
:; "num_balls" : The number of balls detected in this joystick.
:; "num_buttons" : The number of buttons detected on this joystick.
:; "num_hats" : The number of hats detected on this joystick.
:; "is_haptic" : A boolean indicating if this device supports haptic (Force Feedback) effects.

; "pref_path" : A string indicating where the preferences path is located.

==Binary output==
The binary output is basically a dump of the internal data structure used by FSO for representing the supported flags. If <tt>-get_flags</tt> is called without a parameter or with the parameter <tt>binary</tt> then this output mode will be chosen. In this mode FSO will create a file called "<tt>flags.lcg</tt>" in the working directory of the executable and write the binary representation of the flags in that file. The exact format will not be documented here but there are multiple examples of how to parse this (e.g. wxLauncher or Knossos). Please note that the binary format depends on the current architecture and is not normalized to little- or big-endian. Since FSO currently only support x86 based machines this file will always be little endian encoded.

Launcher engine interaction

2022-07-13T03:10:54Z

Z64555: Fix typo: missing open paren

A launcher for the FreeSpace Open engine is responsible for letting the user configure what mod data FSO should use and also how it should use the available hardware (e.g. joysticks or sound devices). It is also important with what flags FSO is started to allow how the game behaves and looks like. In order for this to work, the launcher needs to follow certain conventions which allow FSO to interpret the data the launcher sets for the engine.

This article describes the situation as of FSO version 3.8.0. Previous versions used different configuration mechanisms but those will not be listed here.

=Writing data for the engine to read=
The engine will look for the files described below in the "preferences" path. This path is determined by using the SDL2 function <tt>SDL_GetPrefPath("HardLightProductions", "FreeSpaceOpen")</tt>. Newer engine versions have a way of getting this information without having to link against SDL2, see [[#JSON output|JSON output]] for an alternative way of determining this path.

There are two major configuration mechanisms FSO uses for reading data which was set by the launcher:

==data/cmdline_fso.cfg==
This file should contain all the command line options FSO should use. They should be on a single line and parameters which contain spaces (e.g. mods line "Vassago's Dirge") must be enclosed in quotes:

<pre>
-mod "Vassago's Dirge,MediaVPs_2014" -nomotiondebris -missile_lighting -3dshockwave -post_process -soft_particles -fxaa -fb_explosions -fb_thrusters -enable_shadows -cache_bitmaps -dualscanlines -targetinfo -orbradar -rearm_timer -ballistic_gauge -3dwarp -snd_preload -nosound -nomovies -fps -window -no_unfocused_pause -benchmark_mode -fxaa_preset 6 -ambient_factor 100 -spec_exp 15 -spec_point 1.2 -spec_static 1.5 -spec_tube 1.5 -ogl_spec 20 -bloom_intensity 45
</pre>

The available flags should not be hardcoded by the launcher. Instead, it should use [[#Getting a list of supported flags and devices|-get_flags]] for determining which flags are supported by the launcher.

==fs2_open.ini==
This file contains more "permanent" options and is saved in a standard ini format. The file is separated into multiple "sections" which each contain options specific to that part of the engine:

; Default : This is the default section used by FSO if no specific section is selected.

:; VideocardFs2open
:: This value determines what display mode FSO will use. It has the following format: <tt>[API]-([width]x[height])x[bits] bit</tt>. <tt>[API]</tt> must be exactly 4 characters long. The only valid option here is "OGL " for using the OpenGL API. The other options are pretty obvious. The width and height should match one of the video modes supported by the display (see [[#JSON output|JSON output]] for a way of getting this information without linking against SDL2). The <tt>bits</tt> parameter should either be 16 or 32 but in almost all cases this should be hard-coded to 32.

:; OGL_AntiAliasSamples
:: This should be the level of anti-aliasing desired for OpenGL rendering. This should be the multiple of 2 for how many samples should be taken (e.g. a value of 3 means 8x MSAA). If set to 0 anti-aliasing will be disabled.
:::'''Note:''' As of FSO 3.8.0 this option has no effect!

:; TextureFilter
:: Sets how textures should be filtered. Valid values are 0 for bilinear filtering and 1 for trilinear filtering.

:; OGL_AnisotropicFilter
:: Specifies the level of anisotropic texture filtering if supported by the OpenGL implementation.

:; CurrentJoystickGUID
:: Specifies the GUID of the primary joystick. The case of alphabetic characters will be normalized so it doesn't matter if this string is upper or lower case. This GUID can be determined by using SDL2 or with the [[#JSON output|JSON output]] (if supported by the current build).
:::'''Note:''' This is the part of the legacy method of defining the joystick. See Joy0GUID and Joy0ID below.

:; CurrentJoystick
:: Specified the index of the primary joystick. This will only be used if there are multiple joysticks with the same GUID. This is the index used to open the joystick in SDL2 or the index into the joysticks array in the [[#JSON output|JSON output]].
:::'''Note:''' This is the part of the legacy method of defining the joystick. See Joy0GUID and Joy0ID below.

:; Joy0ID
:: As of FSO 22.0, used for defining your first of multiple joysticks. Get this ID from the ID listed in the exported flags.txt. For details on how to export visit the [https://wiki.hard-light.net/index.php/Frequently_Asked_Questions_(FAQ) FAQ].

:; Joy0GUID
:: As of FSO 22.0, used for defining your first of multiple joysticks. Get this GUID from the GUID listed in the exported flags.txt, matching the entry used for Joy0ID. For details on how to export visit the wiki's [https://wiki.hard-light.net/index.php/Frequently_Asked_Questions_(FAQ) FAQ].

:; Joy1ID
:: Same as Joy0ID, but for defining your second joystick.

:; Joy1GUID
:: Same as Joy0GUID, but for defining your second joystick.

:; Joy2ID
:: Same as Joy0ID, but for defining your third joystick.

:; Joy2GUID
:: Same as Joy0GUID, but for defining your third joystick.

:; Joy3ID
:: Same as Joy0ID, but for defining your fourth joystick.

:; Joy3GUID
:: Same as Joy0GUID, but for defining your fourth joystick.

:; LastPlayer
:: The name of the last pilot used. Used by the engine to determine which pilot should be at the top of the list and pre-loaded.

:; GammaD3D
:: The gamma (brightness) value to be used to display the game.

:; EnableJoystickFF
:: Used to determine if force feedback should be enabled if the joystick supports it. If using the [[#JSON output|JSON output]] then it's possible to determine if a joystick supports this by looking at the '''is_haptic''' field of the joystick object.

:; EnableHitEffect
:: This can be used to enable or disable a directional hit effect if Force Feedback is enabled.

:; Language
:: Sets the language of the game. Possible values are "English", "German", "French", and "Polish".

:; ForceFullscreen : If set to 1, forces the game to start in full screen mode.

:; ScreenshotNum : The number of screenshots taken by the player.

:; MaxFPS : Used to set the framerate cap for the game. If set to zero, framerate cap is disabled.

:; ForcePort : Used to force a specific port for multiplayer connections

:; ConnectionSpeed
:: Used for setting how fast the internet connection is. Possible values are "Slow", "56K", "ISDN", "Cable", and "Fast".

:; SpeechTechroom : Enables or disables text-to-speech in the techroom. Valid values are 1 and 0. Defaults to 0.

:; SpeechBriefings : Enables or disables text-to-speech in the briefings. Valid values are 1 and 0. Defaults to 0.

:; SpeechIngame : Enables or disables text-to-speech in game. Valid values are 1 and 0. Defaults to 0.

:; SpeechMulti : Enables or disables text-to-speech in the multiplayer. Valid values are 1 and 0. Defaults to 0.

:; SpeechVolume : The volume scale of the text-to-speech sound. Should be in the range of 0 to 100.

:; SpeechVoice : Sets which voice to use. See [[#JSON output|JSON output]] for a cross-platform way of determining which voices are available.

:; PXOBanners : Whether or not to use Banners for multiplayer. Valid values are 1 and 0. Defaults to 1.

:; LowMem : Use Low Memory mode (Allows 2d animations to drop frames)

:; ProcessorAffinity : Set which processor should be assigned to the game. Defaults to 2. This setting applies only on Windows.

:; ImageExportNum : The index of the next file to be dds exported from FSO.

; Video : Contains options specific to the video display of FSO.

:; Display
:: Used to choose on which display FSO should be displayed on. The [[#JSON output|JSON output]] contains a list of display detected on the system and their index. Alternatively, SDL2 can be used to enumerate this information.

; ForceFeedback : Contains options for configuring the force feedback subsystem of FSO.

:; Strength : A percentage scale of how strong the effect should be. 0 means completely disabled, 100 means full strength.

; Sound : Contains options specific to how sound should be handled in FSO.

:; Quality : Specifies the quality of the sound output. The value should be in [1, 3] where 3 is the highest quality and 1 is the lowest.

:; SampleRate : Explicitly specifies the sample rate the OpenAL context should use.

:; EnableEFX : Enables or disables usage of OpenAL EFX.

:; PlaybackDevice : Sets the playback device OpenAL should use. The [[#JSON output|JSON output]] contains a list of available playback devices.

:; CaptureDevice : Sets the capture device OpenAL should use. The [[#JSON output|JSON output]] contains a list of available capture devices.

; PXO : Contains settings related to the PXO multiplayer service

:; Login : The login number for the player's account

:; Password : The password the player uses for logging into the PXO service (not the account's password)

:; SquadName : The Squad Name the player uses.

=Getting a list of supported flags and devices=
As of 3.8.1, FSO has two ways of determining what flags are supported by the engine. The JSON output has more information and should be easier to parse but is only supported by newer builds.

The flags can be queries by passing the <tt>-get_flags</tt> option to FSO (this should be done directly instead of overwriting <tt>cmdline_fso.cfg</tt>). When doing this, the command line should also contain the <tt>-parse_cmdline_only</tt> to make sure that FSO only reads the actual command line and not <tt>cmdline_fso.cfg</tt>. This avoids issues when <tt>cmdline_fso.cfg</tt> contains options not supported by the selected FSO binary. Since 3.8.1, <tt>-get_flags</tt> optionally accepts one string parameter for selecting how the flags data is formatted and where it is written.

If FSO does not support the parameter for <tt>-get_flags</tt> then it will be ignored silently and the legacy binary format will be used. Every version before 3.8.1 will behave this way. This allows to gracefully degrade to the old legacy behavior if support for older builds is desired. Also, if the build does not support the given <tt>-get_flags</tt> mode then it will print the string "OUTPUT TYPE NOT SUPPORTED!" to <tt>stdout</tt> and default to the version 1 of the JSON output. This is designed so that it is easy for a launcher to be notified if the selected format is not supported.

==JSON output==
This mode for <tt>-get_flags</tt> was introduced in 3.8.1 and can be enabled by using "json_v1" as the mode parameter <tt>-get_flags</tt> (e.g. <tt>-get_flags json_v1</tt>). In this mode FSO will output a JSON formatted data structure to stdout which will contain information about the supported flags and available devices that FSO detected. The object structure of this output is described in the following by using hierarchical lists for symbolizing if an object key is a child of another element. The root of the output will be a JSON object.

; "version" : Contains information about the version of this executable.
:; "full" : The full version string as is displayed in the main menu.
:; "major" : The major part of the version as an integer number.
:; "minor" : The minor part of the version as an integer number.
:; "build" : The build part of the version as an integer number.
:; "has_revision" : A boolean to indicate if this version has a valid revision part.
:; "revision" : An integer indicating the revision part of the build version.
:; "revision_str" : A string indicating the full revision part of the build version. This may contain the Git hash of the commit in the case of nightly builds or something like "RC2" for release candidates.

; "easy_flags" : This is an array of the available "Easy flags" configuration names. The flags array will contain two bitfields where a bit at position n (starting from the last significant bit) will reference the entry of this array which is at position n.

; "flags" : This is an array of all the flags supported by this binary.
:; "name" : A string which specifies the name of the flag (e.g. <tt>-soft_particles</tt>).
:; "description" : A short description of what this flag does. This should be displayed in the launcher overview.
:; "fso_only" : A boolean indicating whether this flag is only available in FSO builds or not.
:; "on_flags" : An integer which represents a bitfield for which easy flags enable this flag. If the bit n is set in this integer then selecting the easy flag at index n will enable this flag. No action should be taken for the bits that are not set in this bitfield.
:; "off_flags" : An integer which represents a bitfield for which easy flags disable this flag. If the bit n is set in this integer then selecting the easy flag at index n will disable this flag. No action should be taken for the bits that are not set in this bitfield.
:; "type" : Specifies the category of this flag. Typically all flags with the same category will be grouped together.
:; "web_url" : Specifies an URL where more information about this flag can be found.

; "caps"
: A string array of what capabilities this build has. The following strings may be present in the array:
:; OpenAL : This build uses OpenAL for sound.
:; No D3D : This build has no support for Direct3D rendering, only OpenGL.
:; New Sound : This build has support for the new, enhanced sound code.
:; SDL : This build uses SDL on all platforms.

; "voices" : An array of all the possible voice names detected by FSO. If a specific voice should be used then to set the <tt>SpeechVoice</tt> key to the index of that voice in this array.

; "displays" : Contains information about all the displays currently connected to the system.
:; "index" : The index in the array of this display. This should be used for the value of <tt>Video.Display</tt>
:; "name" : A more or less human-readable name of this display.
:; "x" : The x offset of where this display is located. This is only relevant for multi-monitor systems where this value specifies the x-offset relative to the other displays.
:; "y" : The y offset of where this display is located. This is only relevant for multi-monitor systems where this value specifies the y-offset relative to the other displays.
:; "width" : The x-resolution of this display.
:; "height" : The y-resolution of this display.
:; "modes" : Possible video modes of this display.
::; "x": The x-resolution of this video mode.
::; "y": The y-resolution of this video mode.
::; "bits": The bit depth of this video mode (this is typically 32).

; "openal" : Contains information about detected OpenAL properties and devices.
:; "version_major" : The major version of OpenAL as detected by FSO.
:; "version_minor" : The minor version of OpenAL as detected by FSO.
:; "default_playback" : The default playback device as reported by OpenAL. It is possible that this device does not appear in the playback device list.
:; "default_capture" : The default capture device as reported by OpenAL. It is possible that this device does not appear in the capture device list.
:; "playback_devices" : A string array of all the playback devices detected by OpenAL.
:; "capture_devices" : A string array of all the capture devices detected by OpenAL.

; "joysticks" : An array of all the joysticks that FSO detected.
:; "name" : A string which specifies a human-readable name of this joystick.
:; "guid" : The GUID ('''G'''lobally '''U'''nique '''Id'''entifier) of this joystick. This should be used for setting <tt>CurrentJoystickGUID</tt> in <tt>fs2_open.ini</tt>
:; "num_axes" : The number of axes detected on this joystick.
:; "num_balls" : The number of balls detected in this joystick.
:; "num_buttons" : The number of buttons detected on this joystick.
:; "num_hats" : The number of hats detected on this joystick.
:; "is_haptic" : A boolean indicating if this device supports haptic (Force Feedback) effects.

; "pref_path" : A string indicating where the preferences path is located.

==Binary output==
The binary output is basically a dump of the internal data structure used by FSO for representing the supported flags. If <tt>-get_flags</tt> is called without a parameter or with the parameter <tt>binary</tt> then this output mode will be chosen. In this mode FSO will create a file called "<tt>flags.lcg</tt>" in the working directory of the executable and write the binary representation of the flags in that file. The exact format will not be documented here but there are multiple examples of how to parse this (e.g. wxLauncher or Knossos). Please note that the binary format depends on the current architecture and is not normalized to little- or big-endian. Since FSO currently only support x86 based machines this file will always be little endian encoded.

Launcher engine interaction

2022-07-13T03:06:34Z

Z64555: /* fs2_open.ini */ Add newlines to improve seperation between sentances/paragraphs.

A launcher for the FreeSpace Open engine is responsible for letting the user configure what mod data FSO should use and also how it should use the available hardware (e.g. joysticks or sound devices). It is also important with what flags FSO is started to allow how the game behaves and looks like. In order for this to work, the launcher needs to follow certain conventions which allow FSO to interpret the data the launcher sets for the engine.

This article describes the situation as of FSO version 3.8.0. Previous versions used different configuration mechanisms but those will not be listed here.

=Writing data for the engine to read=
The engine will look for the files described below in the "preferences" path. This path is determined by using the SDL2 function <tt>SDL_GetPrefPath("HardLightProductions", "FreeSpaceOpen")</tt>. Newer engine versions have a way of getting this information without having to link against SDL2, see [[#JSON output|JSON output]] for an alternative way of determining this path.

There are two major configuration mechanisms FSO uses for reading data which was set by the launcher:

==data/cmdline_fso.cfg==
This file should contain all the command line options FSO should use. They should be on a single line and parameters which contain spaces (e.g. mods line "Vassago's Dirge") must be enclosed in quotes:

<pre>
-mod "Vassago's Dirge,MediaVPs_2014" -nomotiondebris -missile_lighting -3dshockwave -post_process -soft_particles -fxaa -fb_explosions -fb_thrusters -enable_shadows -cache_bitmaps -dualscanlines -targetinfo -orbradar -rearm_timer -ballistic_gauge -3dwarp -snd_preload -nosound -nomovies -fps -window -no_unfocused_pause -benchmark_mode -fxaa_preset 6 -ambient_factor 100 -spec_exp 15 -spec_point 1.2 -spec_static 1.5 -spec_tube 1.5 -ogl_spec 20 -bloom_intensity 45
</pre>

The available flags should not be hardcoded by the launcher. Instead, it should use [[#Getting a list of supported flags and devices|-get_flags]] for determining which flags are supported by the launcher.

==fs2_open.ini==
This file contains more "permanent" options and is saved in a standard ini format. The file is separated into multiple "sections" which each contain options specific to that part of the engine:

; Default : This is the default section used by FSO if no specific section is selected.

:; VideocardFs2open
:: This value determines what display mode FSO will use. It has the following format: <tt>[API]-([width]x[height])x[bits] bit</tt>. <tt>[API]</tt> must be exactly 4 characters long. The only valid option here is "OGL " for using the OpenGL API. The other options are pretty obvious. The width and height should match one of the video modes supported by the display (see [[#JSON output|JSON output]] for a way of getting this information without linking against SDL2). The <tt>bits</tt> parameter should either be 16 or 32 but in almost all cases this should be hard-coded to 32.

:; OGL_AntiAliasSamples
:: This should be the level of anti-aliasing desired for OpenGL rendering. This should be the multiple of 2 for how many samples should be taken (e.g. a value of 3 means 8x MSAA). If set to 0 anti-aliasing will be disabled.
:::'''Note:''' As of FSO 3.8.0 this option has no effect!

:; TextureFilter
:: Sets how textures should be filtered. Valid values are 0 for bilinear filtering and 1 for trilinear filtering.

:; OGL_AnisotropicFilter
:: Specifies the level of anisotropic texture filtering if supported by the OpenGL implementation.

:; CurrentJoystickGUID
:: Specifies the GUID of the primary joystick. The case of alphabetic characters will be normalized so it doesn't matter if this string is upper or lower case. This GUID can be determined by using SDL2 or with the [[#JSON output|JSON output]] if supported by the current build).
:::'''Note:''' This is the part of the legacy method of defining the joystick. See Joy0GUID and Joy0ID below.

:; CurrentJoystick
:: Specified the index of the primary joystick. This will only be used if there are multiple joysticks with the same GUID. This is the index used to open the joystick in SDL2 or the index into the joysticks array in the [[#JSON output|JSON output]].
:::'''Note:''' This is the part of the legacy method of defining the joystick. See Joy0GUID and Joy0ID below.

:; Joy0ID
:: As of FSO 22.0, used for defining your first of multiple joysticks. Get this ID from the ID listed in the exported flags.txt. For details on how to export visit the [https://wiki.hard-light.net/index.php/Frequently_Asked_Questions_(FAQ) FAQ].

:; Joy0GUID
:: As of FSO 22.0, used for defining your first of multiple joysticks. Get this GUID from the GUID listed in the exported flags.txt, matching the entry used for Joy0ID. For details on how to export visit the wiki's [https://wiki.hard-light.net/index.php/Frequently_Asked_Questions_(FAQ) FAQ].

:; Joy1ID
:: Same as Joy0ID, but for defining your second joystick.

:; Joy1GUID
:: Same as Joy0GUID, but for defining your second joystick.

:; Joy2ID
:: Same as Joy0ID, but for defining your third joystick.

:; Joy2GUID
:: Same as Joy0GUID, but for defining your third joystick.

:; Joy3ID
:: Same as Joy0ID, but for defining your fourth joystick.

:; Joy3GUID
:: Same as Joy0GUID, but for defining your fourth joystick.

:; LastPlayer
:: The name of the last pilot used. Used by the engine to determine which pilot should be at the top of the list and pre-loaded.

:; GammaD3D
:: The gamma (brightness) value to be used to display the game.

:; EnableJoystickFF
:: Used to determine if force feedback should be enabled if the joystick supports it. If using the [[#JSON output|JSON output]] then it's possible to determine if a joystick supports this by looking at the '''is_haptic''' field of the joystick object.

:; EnableHitEffect
:: This can be used to enable or disable a directional hit effect if Force Feedback is enabled.

:; Language
:: Sets the language of the game. Possible values are "English", "German", "French", and "Polish".

:; ForceFullscreen : If set to 1, forces the game to start in full screen mode.

:; ScreenshotNum : The number of screenshots taken by the player.

:; MaxFPS : Used to set the framerate cap for the game. If set to zero, framerate cap is disabled.

:; ForcePort : Used to force a specific port for multiplayer connections

:; ConnectionSpeed
:: Used for setting how fast the internet connection is. Possible values are "Slow", "56K", "ISDN", "Cable", and "Fast".

:; SpeechTechroom : Enables or disables text-to-speech in the techroom. Valid values are 1 and 0. Defaults to 0.

:; SpeechBriefings : Enables or disables text-to-speech in the briefings. Valid values are 1 and 0. Defaults to 0.

:; SpeechIngame : Enables or disables text-to-speech in game. Valid values are 1 and 0. Defaults to 0.

:; SpeechMulti : Enables or disables text-to-speech in the multiplayer. Valid values are 1 and 0. Defaults to 0.

:; SpeechVolume : The volume scale of the text-to-speech sound. Should be in the range of 0 to 100.

:; SpeechVoice : Sets which voice to use. See [[#JSON output|JSON output]] for a cross-platform way of determining which voices are available.

:; PXOBanners : Whether or not to use Banners for multiplayer. Valid values are 1 and 0. Defaults to 1.

:; LowMem : Use Low Memory mode (Allows 2d animations to drop frames)

:; ProcessorAffinity : Set which processor should be assigned to the game. Defaults to 2. This setting applies only on Windows.

:; ImageExportNum : The index of the next file to be dds exported from FSO.

; Video : Contains options specific to the video display of FSO.

:; Display
:: Used to choose on which display FSO should be displayed on. The [[#JSON output|JSON output]] contains a list of display detected on the system and their index. Alternatively, SDL2 can be used to enumerate this information.

; ForceFeedback : Contains options for configuring the force feedback subsystem of FSO.

:; Strength : A percentage scale of how strong the effect should be. 0 means completely disabled, 100 means full strength.

; Sound : Contains options specific to how sound should be handled in FSO.

:; Quality : Specifies the quality of the sound output. The value should be in [1, 3] where 3 is the highest quality and 1 is the lowest.

:; SampleRate : Explicitly specifies the sample rate the OpenAL context should use.

:; EnableEFX : Enables or disables usage of OpenAL EFX.

:; PlaybackDevice : Sets the playback device OpenAL should use. The [[#JSON output|JSON output]] contains a list of available playback devices.

:; CaptureDevice : Sets the capture device OpenAL should use. The [[#JSON output|JSON output]] contains a list of available capture devices.

; PXO : Contains settings related to the PXO multiplayer service

:; Login : The login number for the player's account

:; Password : The password the player uses for logging into the PXO service (not the account's password)

:; SquadName : The Squad Name the player uses.

=Getting a list of supported flags and devices=
As of 3.8.1, FSO has two ways of determining what flags are supported by the engine. The JSON output has more information and should be easier to parse but is only supported by newer builds.

The flags can be queries by passing the <tt>-get_flags</tt> option to FSO (this should be done directly instead of overwriting <tt>cmdline_fso.cfg</tt>). When doing this, the command line should also contain the <tt>-parse_cmdline_only</tt> to make sure that FSO only reads the actual command line and not <tt>cmdline_fso.cfg</tt>. This avoids issues when <tt>cmdline_fso.cfg</tt> contains options not supported by the selected FSO binary. Since 3.8.1, <tt>-get_flags</tt> optionally accepts one string parameter for selecting how the flags data is formatted and where it is written.

If FSO does not support the parameter for <tt>-get_flags</tt> then it will be ignored silently and the legacy binary format will be used. Every version before 3.8.1 will behave this way. This allows to gracefully degrade to the old legacy behavior if support for older builds is desired. Also, if the build does not support the given <tt>-get_flags</tt> mode then it will print the string "OUTPUT TYPE NOT SUPPORTED!" to <tt>stdout</tt> and default to the version 1 of the JSON output. This is designed so that it is easy for a launcher to be notified if the selected format is not supported.

==JSON output==
This mode for <tt>-get_flags</tt> was introduced in 3.8.1 and can be enabled by using "json_v1" as the mode parameter <tt>-get_flags</tt> (e.g. <tt>-get_flags json_v1</tt>). In this mode FSO will output a JSON formatted data structure to stdout which will contain information about the supported flags and available devices that FSO detected. The object structure of this output is described in the following by using hierarchical lists for symbolizing if an object key is a child of another element. The root of the output will be a JSON object.

; "version" : Contains information about the version of this executable.
:; "full" : The full version string as is displayed in the main menu.
:; "major" : The major part of the version as an integer number.
:; "minor" : The minor part of the version as an integer number.
:; "build" : The build part of the version as an integer number.
:; "has_revision" : A boolean to indicate if this version has a valid revision part.
:; "revision" : An integer indicating the revision part of the build version.
:; "revision_str" : A string indicating the full revision part of the build version. This may contain the Git hash of the commit in the case of nightly builds or something like "RC2" for release candidates.

; "easy_flags" : This is an array of the available "Easy flags" configuration names. The flags array will contain two bitfields where a bit at position n (starting from the last significant bit) will reference the entry of this array which is at position n.

; "flags" : This is an array of all the flags supported by this binary.
:; "name" : A string which specifies the name of the flag (e.g. <tt>-soft_particles</tt>).
:; "description" : A short description of what this flag does. This should be displayed in the launcher overview.
:; "fso_only" : A boolean indicating whether this flag is only available in FSO builds or not.
:; "on_flags" : An integer which represents a bitfield for which easy flags enable this flag. If the bit n is set in this integer then selecting the easy flag at index n will enable this flag. No action should be taken for the bits that are not set in this bitfield.
:; "off_flags" : An integer which represents a bitfield for which easy flags disable this flag. If the bit n is set in this integer then selecting the easy flag at index n will disable this flag. No action should be taken for the bits that are not set in this bitfield.
:; "type" : Specifies the category of this flag. Typically all flags with the same category will be grouped together.
:; "web_url" : Specifies an URL where more information about this flag can be found.

; "caps"
: A string array of what capabilities this build has. The following strings may be present in the array:
:; OpenAL : This build uses OpenAL for sound.
:; No D3D : This build has no support for Direct3D rendering, only OpenGL.
:; New Sound : This build has support for the new, enhanced sound code.
:; SDL : This build uses SDL on all platforms.

; "voices" : An array of all the possible voice names detected by FSO. If a specific voice should be used then to set the <tt>SpeechVoice</tt> key to the index of that voice in this array.

; "displays" : Contains information about all the displays currently connected to the system.
:; "index" : The index in the array of this display. This should be used for the value of <tt>Video.Display</tt>
:; "name" : A more or less human-readable name of this display.
:; "x" : The x offset of where this display is located. This is only relevant for multi-monitor systems where this value specifies the x-offset relative to the other displays.
:; "y" : The y offset of where this display is located. This is only relevant for multi-monitor systems where this value specifies the y-offset relative to the other displays.
:; "width" : The x-resolution of this display.
:; "height" : The y-resolution of this display.
:; "modes" : Possible video modes of this display.
::; "x": The x-resolution of this video mode.
::; "y": The y-resolution of this video mode.
::; "bits": The bit depth of this video mode (this is typically 32).

; "openal" : Contains information about detected OpenAL properties and devices.
:; "version_major" : The major version of OpenAL as detected by FSO.
:; "version_minor" : The minor version of OpenAL as detected by FSO.
:; "default_playback" : The default playback device as reported by OpenAL. It is possible that this device does not appear in the playback device list.
:; "default_capture" : The default capture device as reported by OpenAL. It is possible that this device does not appear in the capture device list.
:; "playback_devices" : A string array of all the playback devices detected by OpenAL.
:; "capture_devices" : A string array of all the capture devices detected by OpenAL.

; "joysticks" : An array of all the joysticks that FSO detected.
:; "name" : A string which specifies a human-readable name of this joystick.
:; "guid" : The GUID ('''G'''lobally '''U'''nique '''Id'''entifier) of this joystick. This should be used for setting <tt>CurrentJoystickGUID</tt> in <tt>fs2_open.ini</tt>
:; "num_axes" : The number of axes detected on this joystick.
:; "num_balls" : The number of balls detected in this joystick.
:; "num_buttons" : The number of buttons detected on this joystick.
:; "num_hats" : The number of hats detected on this joystick.
:; "is_haptic" : A boolean indicating if this device supports haptic (Force Feedback) effects.

; "pref_path" : A string indicating where the preferences path is located.

==Binary output==
The binary output is basically a dump of the internal data structure used by FSO for representing the supported flags. If <tt>-get_flags</tt> is called without a parameter or with the parameter <tt>binary</tt> then this output mode will be chosen. In this mode FSO will create a file called "<tt>flags.lcg</tt>" in the working directory of the executable and write the binary representation of the flags in that file. The exact format will not be documented here but there are multiple examples of how to parse this (e.g. wxLauncher or Knossos). Please note that the binary format depends on the current architecture and is not normalized to little- or big-endian. Since FSO currently only support x86 based machines this file will always be little endian encoded.

Frequently Asked Questions (FAQ)

2022-06-01T14:12:02Z

Z64555: /* Windows Tutorial for obtaining the GUID */

This page contains answers to questions that may be asked when playing newer versions of FSO. They are usually questions related to new behaviors not present in older version or vanilla FreeSpace, and are often questions that don't have a simple one-line answer.

===Why are my bindings back to defaults?===
If you created or played with a pilot on FSO 22.0 or later, your bindings were moved into files known as "presets" which are saved in a sub directory of your players folder.

'''Example:''' '''''C:\Users\z64555\AppData\Roaming\HardLightProductions\FreeSpaceOpen\data\players\presets'''''

The reason why your bindings are back to defaults in pre-22.0 version is because:

1. Older versions of FSO still require that the pilot have bindings in them, or else FSO will crash because it doesn't know how to handle a pilot with missing data.

2. To prevent having a new preset generated each time the same pilot is used across pre- and post-22.0 versions of FSO, the bindings within the pilot are forced to the defaults.
* The bindings that were originally saved are still safe within the '''''\presets''''' sub directory.

Related Github issue: [https://github.com/scp-fs2open/fs2open.github.com/issues/3902 Issue 3902]

===Why can't I use my pilot with different versions of FSO?===
Our pilot file handling code has improved over the years to allow new data to be added to the pilot file, but we still haven't managed to get it in a perfect state due to a lack of manpower and interest.

Pilot files might be still usable across different versions of FSO, but this can not be guaranteed at this point in time. When in doubt, it is always recommended that you make a clone of your pilot and use the clone for that version of FSO.

===Can I use multiple joysticks in FSO?===
As of FSO version 22.0, players are now able to assign up to 4 independent joysticks, gamepads, throttles, or game controllers; independently assign the mouse to controls; can assign a primary input binding and a secondary input binding from two different joysticks per control.

In order to make use of this capability, you must use a compatible launcher or manually set the joystick ID and GUID's within your '''fs2_open.ini''' file.

====Where is the fs2_open.ini file?====
This may be found within AppData.

'''Example:''' '''''C:\Users\z64555\AppData\Roaming\HardLightProductions\FreeSpaceOpen\fs2_open.ini'''''

====How do I assign my joysticks in the fs2_open.ini?====
Add the following keys to your .ini, underneath the '''[Default]''' section:

'''''Joy0ID='''''
'''''Joy0GUID='''''
'''''Joy1ID='''''
'''''Joy1GUID='''''
'''''Joy2ID='''''
'''''Joy2GUID='''''
'''''Joy3ID='''''
'''''Joy3GUID='''''

'''Joy0''' is effectively the same as '''CurrentJoystick'''

====Where do I get the Joystick ID's and GUID's?====
{{Note|For best reliability, the GUID's must be obtained from FSO itself, not from any other third-party app.}}

This is the most difficult part of manually assigning the joysticks, depending on your operating system and familiarity with command prompt/ shell. Essentially, you'll want to run FSO with the '''-get_flags json_v1''' commandline flag from the command prompt, power shell, or bash.

'''Example:''' '''''C:\Games\FreespaceOpen\bin\FSO-22.0.0\windows\x64> fs2_open_22_0_0_x64_SSE2.exe -get_flags json_v1 > flags.txt'''''

Windows users will probably also need to set the '''FSO_KEEP_STDOUT''' environment variable, due to its tendency to shut down the STDOUT streams to console when the application is identified as a WINDOWS application (as opposed to a CONSOLE application), in which case they should try the following:

'''cmd /V /C "set FSO_KEEP_STDOUT=1&& fs2_open_22_0_0_x64_SSE2.exe -get_flags json_v1 > flags.txt"'''

Once you have a flags.txt file created, look for a section that looks like this:

{
"joysticks": [
{
"name": "Joystick Name",
"guid": "03000000EFBE00006D04000000000000",
"id": 0,
"device": 0
}
]
}

Use the "guid" and "id" key values to assign that joystick to Joy0, Joy1, Joy2, or Joy3 respectively.

=====Windows Tutorial for obtaining the GUID=====
# Navigate to your FSO installation using File Explorer. If you're using Knossos, then this directory is the same as "Library Path" within Knossos's settings.
# Right click the address bar within File Explorer and "Copy the Address as Text"
# Open the command prompt from the start menu:
#* Open the start menu,
#* Type in "prompt",
#* and then left click on "Command Prompt"
# In the command prompt window, type in "cd /D " (without the quotes), with a space after the D. Then, right click on the command prompt and Paste the address you copied from before. Hit the Enter key to execute the cd command. The prompt should then show the address text again with ">" as the last character to show that its now in that directory.
# In the command prompt, type in "dir" and hit enter to execute the dir command, which should show you a list of all files and folders within the directory. Confirm that your fs2_open.exe is in there.
# Follow the directions outlined in [[#Where do I get the Joystick ID's and GUID's?]], Using the full name of your fs2_open.exe should it differ from the instructions.

Frequently Asked Questions (FAQ)

2022-06-01T14:01:14Z

Z64555: /* Windows Tutorial for obtaining the GUID */

Frequently Asked Questions (FAQ)

2022-06-01T13:55:09Z

Z64555: Add tutorial for Windows

This page contains answers to questions that may be asked when playing newer versions of FSO. They are usually questions related to new behaviors not present in older version or vanilla FreeSpace, and are often questions that don't have a simple one-line answer.

===Why are my bindings back to defaults?===
If you created or played with a pilot on FSO 22.0 or later, your bindings were moved into files known as "presets" which are saved in a sub directory of your players folder.

'''Example:''' '''''C:\Users\z64555\AppData\Roaming\HardLightProductions\FreeSpaceOpen\data\players\presets'''''

The reason why your bindings are back to defaults in pre-22.0 version is because:

1. Older versions of FSO still require that the pilot have bindings in them, or else FSO will crash because it doesn't know how to handle a pilot with missing data.

2. To prevent having a new preset generated each time the same pilot is used across pre- and post-22.0 versions of FSO, the bindings within the pilot are forced to the defaults.
* The bindings that were originally saved are still safe within the '''''\presets''''' sub directory.

Related Github issue: [https://github.com/scp-fs2open/fs2open.github.com/issues/3902 Issue 3902]

===Why can't I use my pilot with different versions of FSO?===
Our pilot file handling code has improved over the years to allow new data to be added to the pilot file, but we still haven't managed to get it in a perfect state due to a lack of manpower and interest.

Pilot files might be still usable across different versions of FSO, but this can not be guaranteed at this point in time. When in doubt, it is always recommended that you make a clone of your pilot and use the clone for that version of FSO.

===Can I use multiple joysticks in FSO?===
As of FSO version 22.0, players are now able to assign up to 4 independent joysticks, gamepads, throttles, or game controllers; independently assign the mouse to controls; can assign a primary input binding and a secondary input binding from two different joysticks per control.

In order to make use of this capability, you must use a compatible launcher or manually set the joystick ID and GUID's within your '''fs2_open.ini''' file.

====Where is the fs2_open.ini file?====
This may be found within AppData.

'''Example:''' '''''C:\Users\z64555\AppData\Roaming\HardLightProductions\FreeSpaceOpen\fs2_open.ini'''''

====How do I assign my joysticks in the fs2_open.ini?====
Add the following keys to your .ini, underneath the '''[Default]''' section:

'''''Joy0ID='''''
'''''Joy0GUID='''''
'''''Joy1ID='''''
'''''Joy1GUID='''''
'''''Joy2ID='''''
'''''Joy2GUID='''''
'''''Joy3ID='''''
'''''Joy3GUID='''''

'''Joy0''' is effectively the same as '''CurrentJoystick'''

====Where do I get the Joystick ID's and GUID's?====
{{Note|For best reliability, the GUID's must be obtained from FSO itself, not from any other third-party app.}}

This is the most difficult part of manually assigning the joysticks, depending on your operating system and familiarity with command prompt/ shell. Essentially, you'll want to run FSO with the '''-get_flags json_v1''' commandline flag from the command prompt, power shell, or bash.

'''Example:''' '''''C:\Games\FreespaceOpen\bin\FSO-22.0.0\windows\x64> fs2_open_22_0_0_x64_SSE2.exe -get_flags json_v1 > flags.txt'''''

Windows users will probably also need to set the '''FSO_KEEP_STDOUT''' environment variable, due to its tendency to shut down the STDOUT streams to console when the application is identified as a WINDOWS application (as opposed to a CONSOLE application), in which case they should try the following:

'''cmd /V /C "set FSO_KEEP_STDOUT=1&& fs2_open_22_0_0_x64_SSE2.exe -get_flags json_v1 > flags.txt"'''

Once you have a flags.txt file created, look for a section that looks like this:

{
"joysticks": [
{
"name": "Joystick Name",
"guid": "03000000EFBE00006D04000000000000",
"id": 0,
"device": 0
}
]
}

Use the "guid" and "id" key values to assign that joystick to Joy0, Joy1, Joy2, or Joy3 respectively.

=====Windows Tutorial for obtaining the GUID=====
1. Navigate to your FSO installation using File Explorer. If you're using Knossos, then this directory is the same as "Library Path" within Knossos's settings.

2. Right click the address bar within File Explorer and "Copy the Address as Text"

3. Open the command prompt from the start menu: Open the start menu, type in "prompt", and then left click on "Command Prompt"

4. In the command prompt window, type in "cd /D " (without the quotes), with a space after the D. Then, right click on the command prompt and Paste the address you copied from before. Hit the Enter key to execute the cd command. The prompt should then show the address text again with ">" as the last character to show that its now in that directory.

5. In the command prompt, type in "dir" and hit enter to execute the dir command, which should show you a list of all files and folders within the directory. Confirm that your fs2_open.exe is in there.

6. Follow the directions outlined in [[#Where do I get the Joystick ID's and GUID's?]]

Frequently Asked Questions (FAQ)

2022-06-01T13:14:27Z

Z64555: /* Where do I get the Joystick ID's and GUID's? */ Tweak the example a bit

Hud gauges.tbl

2022-05-10T11:56:00Z

Z64555: /* N-gon Sides: */ define what an N-gon is, since its not that common of a term

{{SCP table}}
{{TableVersionGit|2016-09-14|f9bc01c}}
{{Tables}}
The '''hud_gauges.tbl''' is used for modifying the elements of the HUD. Not all gauges can be modified. However, custom gauges may be added to mimic their behavior (such as the wingman status display).

HUD Elements in FS2 are called Gauges, and each gauge has various options to customize appearance and, in some cases, their behavior as well.

This table is one of the [[Modular Tables]] and can be extended with xxx-hdg.tbm

==HUD Configurations==
The following entries are used on the HUD system, but have not been grouped with any particular gauge.

===$Load Retail Configuration:===
Optional. If yes, any gauge missing from the HUD gauge definitions below will be loaded using the retail defaults.

If no, any missing (default) gauge will prompt an error.

*Syntax: '''Boolean'''

===$Color:===
Optional. Sets the default HUD color for all gauges.

*Syntax: ('''Integer''' Red, '''Integer''' Green, '''Integer''' Blue)
*Valid Values: all values from 0 to 255

===$Font:===
Optional. Sets the font type to use for the HUD. This can either be a string or a number. A string references a font with a specific name while a number references a font with a specific index in the fonts table. The number option is deprecated and is only there for backwards-compatibility. Use the name if possible.

*Syntax: '''String''' or '''Integer''' font index number
*Valid Values: Any name or font index as defined in [[Fonts.tbl]]

===$Chase View Only:===
{{Table381|
Optional. Sets gauges to be displayed only in Chase View.

*Syntax: '''Boolean'''
*Default Value: '''False'''
}}

===$Max Directives:===
Optional. Sets the default maximum number of directives displayed simultaneously.

*Syntax: '''Integer''' maximum number of directives
*Valid Values: Any positive number
*Default Value: '''5'''

===$Max Escort Ships:===
Optional. Sets the default maximum number of escort ships to be shown in the escort list.

*Syntax: '''Integer'''
*Valid Values: Any positive number
{{Warning|
Entries more than 16 will cause the list to overflow into the weapons list for resolutions lower than 1024x768.}}

===$Length Unit Multiplier:===
Optional. Sets the multiplier to applied to the reported distances. For example, if the multiplier is 0.5, then the distance reported to the player will (or at least should) be 0.5 x actual distance.

*Syntax: '''Float'''
*Valid Values: Any positive number

===$Speed Unit Multiplier:===
Optional. Analogous to [[Hud_gauges.tbl#$Length Unit Multiplier:|$Length Unit Multiplier]], this sets the multiplier to be applied to all speeds reported to the player. For example, if the multiplier is 0.5, the the speed reported to the player will (or at least should) be 0.5 x actual speed.

*Syntax: '''Float'''
*Valid Values: Any positive number
*Default Values:
:'''The value used in $Length Unit Multiplier''', or
:'''1''', if $Length Unit Multiplier is undefined

===$Wireframe Targetbox:===
Optional. Defines the default draw method for the target viewer (a.k.a. targetbox).

*Syntax: '''Integer''' Draw method ID
*Valid Values:
::'''0''' - Standard with full, bright lighting
::'''1''' - Wireframe
::'''2''' - Standard with proper lighting (i.e. lit the same as the actual target)
{{Table3615|
::'''3''' - Untextured with full bright lighting (i.e. drawn with a single flat color)}}

===$Targetbox Shader Effect:===
{{Table3615|
Optional. If set, defines a unique ID for a shader effect to be used when rendering a ship for the targeting box. The ID will be passed to the main shader as in [[Post_processing.tbl##Ship_Effects|#Ship_Effects]], but a table entry for the effect is not needed.

*Syntax: '''Integer'''
*Valid Values: Any positive number
}}

===$Lock Wireframe Mode:===
Optional. If set, prevents targetbox draw method from being changed during the gaming session.
*Syntax: '''Boolean'''

===$Scale Gauges:===
{{Table371|
Optional. If set, all gauges will use this value as the default for scaling individual gauge sizes (i.e. doesn't affect gauges that use Position:, and doesn't affect the values of Offset:. In addition, if "$Load Retail Configuration:" is true then all unspecified retail gauges will use this value.

If not set, defaults to yes.

*Syntax: '''Boolean'''
}}

===$Force Scaling Above:===
{{Table373|
Optional. If gauge scaling is disabled, then gauges will be scaled as though the base resolution were this resolution or the real base resolution, whichever is greater.

Use this to disable scaling at lower resolutions while preventing gauges from getting too small at higher resolutions.

To disable this feature, use '''(-1, -1)'''.

*Syntax: ('''Integer''' width, '''Integer''' height)
}}

===$Reticle Style:===
Optional. Defines which aiming reticle to use.
*Syntax: '''String'''
*Valid Values:
:'''FS1''' - uses '''''reticle1_fs1.ani'''''
:'''FS2''' - uses '''''reticle1.ani'''''

==#Gauge Config==
The following entries define default gauge appearance and behavior. Each gauge has the option of overriding these options.

===$Ship:===
Deprecated and superceded by $Ships in FSO revision 9208. If defined, the following config data will only be used if the player ship is of the supplied ship class. Can be defined multiple times within a #Gauge config group to allow unique HUD configurations per ship class.

If not defined, all following config data will be applied to all ships.

*Syntax: '''String''', ship class name

===$Ships:===
Optional. Can be used to define a list of ships the hud definition that follows will be applied to. Can be defined multiple times within a #Gauge config group to allow unique HUD configurations per ship class.

If not defined, all following config data will be applied to all ships.

*`Syntax: '''( "Class name 1" "Class name 2" )''', ship class names formatted like a flag list.

====$Load Retail Configuration:====
Optional. Overrides the [[Hud_gauges.tbl#$Load Retail Configuration: 1|$Load Retail Configuration]] global option for this ship class.

*Syntax: '''Boolean'''

====$Color:====
Optional. Overrides the [[Hud_gauges.tbl#$Color: 1|$Color]] global option for this ship class.

*Syntax: See [[Hud_gauges.tbl#$Color: 1|$Color]]

====$Font:====
Optional. Overrides the [[Hud_gauges.tbl#$Font: 1|$Font]] global option for this ship class.

*Syntax: See [[Hud_gauges.tbl#$Font: 1|$Font]]

====$Chase View Only:====
{{Table381|
Optional. Overrides the [[Hud_gauges.tbl#$Chase View Only: 1|$Chase View Only]] global option for this ship class.

*Syntax: See [[Hud_gauges.tbl#$Chase View Only: 1|$Chase View Only]]
}}

===$Base:===
Required. Defines the base resolution for this HUD configuration, upon which other gauge options (such as [[Hud_gauges.tbl#Position:|Position:]] / [[Hud_gauges.tbl#Origin:|Origin:]] / [[Hud_gauges.tbl#Offset:|Offset:]]) will use as its coordinate system.

*Syntax: ('''Integer''' width, '''Integer''' height)
*Valid Values: All supported resolutions (?)

===$Scale Gauges:===
{{Table371|
Optional. If set, will configure gauges Scaling behaviour for gauges in this #Gauge Config section. i.e. overriding the default, or the value specified at the top of the file. Individual gauges can override this setting.

*Syntax: '''Boolean'''
}}

===$Force Scaling Above:===
{{Table373|
Optional. If gauge scaling is disabled, then gauges will be scaled as though the base resolution were this resolution or the real base resolution, whichever is greater.

Use this to disable scaling at lower resolutions while preventing gauges from getting too small at higher resolutions.

To disable this feature, use '''(-1, -1)'''.

*Syntax: ('''Integer''' width, '''Integer''' height)
}}

===$Required Aspect:===
Optional. If set, this configuration will only be loaded for the specified aspect ratios.

Used as a filter when there are multiple $Base: resolutions in the table

*Syntax: '''String'''
*Valid Values:
:"Full Screen" (4:3, aspect ratio < 1.5)
:"Wide Screen" (16:9, 16:10, or similar, aspect ratio >= 1.5)

===$Min:===
Optional. Minimum resolution for this config. Any resolution lower than specified will not use this configuration.

Used as a filter when there are multiple $Base: resolutions in the table

*Syntax: ('''Integer''' width, '''Integer''' height)
*Valid Values: All supported resolutions (?)

===$Max:===
Optional. Maximum resolution for this config. Any resolution higher than specified will not use this configuration.

Used as a filter when there are multiple $Base: resolutions in the table

*Syntax: ('''Integer''' width, '''Integer''' height)
*Valid Values: All supported resolutions (?)

===$Gauges:===
Following entries define gauge-specific behavior. For the most part, each gauge has its own overrides that, if not defined, would otherwise use the global values.

Since many gauges have the same configuration options, each gauge entry has a list of valid sub-entries. Unless stated otherwise, these options must be defined in the same order as they are shown, starting from the top and ending at the bottom.

====+Custom:====
Adds a custom gauge type.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Name:|Name:]]
:[[Hud_gauges.tbl#Text:|Text:]]
:[[Hud_gauges.tbl#X Offset:|X Offset:]] (Optional)
:[[Hud_gauges.tbl#Y Offset:|Y Offset:]] (Optional)
:[[Hud_gauges.tbl#Gauge Type:|Gauge Type:]]
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Active by default:|Active by default:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]

{{table381|
====+Scripted Gauge:====
Adds a scripted gauge type.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Name:|Name:]]
}}

====+Messages:====
Adds a gauge that display mission messages.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Max Lines:|Max Lines:]] (Optional)
:[[Hud_gauges.tbl#Max Width:|Max Width:]] (Optional)
:[[Hud_gauges.tbl#Line Height:|Line Height]] (Optional)
:[[Hud_gauges.tbl#Total Lifetime:|Total Lifetime:]] (Optional)
:[[Hud_gauges.tbl#Scroll Time:|Scroll Time]] (Optional)
:[[Hud_gauges.tbl#Step Size:|Step Size:]] (Optional)
:[[Hud_gauges.tbl#Hidden By Comms Menu:|Hidden By Comms Menu:]] (Optional)

====+Training Messages:====
Adds a text box, like the ones seen in the FS1 and FS2 training missions.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}

====+Support:====
Adds a text box that shows the Support ship's status and ETA

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Text Y-offset:|Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Dock Status X-offset:|Dock Status X-offset:]] (Optional)
:[[Hud_gauges.tbl#Dock Time X-offset:|Dock Time X-offset:]] (Optional)

====+Damage:====
Adds a gauge that shows how much damage a target (or the player?) has.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Hull Integrity Offsets:|Hull Integrity Offsets]] (Optional)
:[[Hud_gauges.tbl#Hull Integrity Value X-offset:|Hull Integrity Value X-offset]] (Optional)
:[[Hud_gauges.tbl#Top Background Height:|Top Background Height:]] (Optional)
:[[Hud_gauges.tbl#Subsystem Entry Height:|Subsystem Entry Height:]] (Optional)
:[[Hud_gauges.tbl#Subsystem List Start Offsets:|Subsystem List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Subsystem Entry Value X-offset:|Subsystem Entry Value X-offset:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Offset:|Bottom Background Offset:]] (Optional)

====+Wingman Status:====
Adds a gauge that monitors the status of your wing and squadron.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Left Background Filename:|Left Background Filename:]] (Optional) (needs an animation with one frame)
{{table3615|
:[[Hud_gauges.tbl#First Background Filename:|First Background Filename:]] (Optional) (needs an animation with one frame)}}
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional) (needs an animation with one frame)
:[[Hud_gauges.tbl#Right Background Filename:|Right Background Filename:]] (Optional) (needs an animation with one frame)
{{table3615|
:[[Hud_gauges.tbl#Last Background Filename:|Last Background Filename:]] (Optional) (needs an animation with one frame)}}
:[[Hud_gauges.tbl#Dot Filename:|Dot Filename:]] (Optional) (needs an animation with two frames, 1st is for alive wingmen, 2nd is for dead or missing wingmen)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
{{table373|
[[Hud_gauges.tbl#Fixed Header Position:|Fixed Header Position:]] (Optional)}}
:[[Hud_gauges.tbl#Left Background Width:|Left Background Width:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#First Background Size:|First Background Size:]] (Optional)}}
:[[Hud_gauges.tbl#Entry Width:|Entry Width:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Entry Size:|Entry Size:]] (Optional)
:[[Hud_gauges.tbl#Right Background Offset:|Right Background Offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Offset:|Last Background Offset:]] (Optional)}}
:[[Hud_gauges.tbl#Single Wing Offsets:|Single Wing Offsets:]] (Optional)
:[[Hud_gauges.tbl#Multiple Wing Start Offsets:|Multiple Wing Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Wing Name Offsets:|Wing Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Dot Offsets:|Dot Offsets:]] (Optional)
:[[Hud_gauges.tbl#Expansion Mode:|Expansion Mode:]] (Optional)
{{Table214|
:[[Hud_gauges.tbl#Use Full Wing Names:|Dot Offsets:]] (Optional)
:[[Hud_gauges.tbl#Expansion Mode:|Expansion Mode:]] (Optional)
}}

====+Auto Speed:====
Adds the Auto-Speed mode gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (needs animation with 4 frames, 3rd is without auto-match-speed enabled, 4th is with... and frames 0 & 1 are not used, done this way because retail fs2 uses the same animation file for the auto speed & auto targeting gauges)
:[[Hud_gauges.tbl#Auto Offsets:|Auto Offsets:]] (Optional)
:[[Hud_gauges.tbl#Speed Offsets:|Speed Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#On Text Color:|On Text Color:]] (Optional)
:[[Hud_gauges.tbl#On Text Color:|Off Text Color:]] (Optional)}}

====+Auto Target:====
Adds the Auto-target mode gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (needs animation with 2 frames, 1st is without auto-targeting enabled, 2nd is with)
:[[Hud_gauges.tbl#Auto Offsets:|Auto Offsets:]] (Optional)
:[[Hud_gauges.tbl#Target Offsets:|Target Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#On Text Color:|On Text Color:]] (Optional)
:[[Hud_gauges.tbl#On Text Color:|Off Text Color:]] (Optional)}}

====+Countermeasures:====
Adds a gauge that monitors the amount of remaining countermeasures the player's ship currently has.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (needs an animation with a single frame)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
:[[Hud_gauges.tbl#Value Offsets:|Value Offsets:]] (Optional)

====+Talking Head:====
Adds a video window to display pilot message videos (a.k.a talking heads).

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Animation Offsets:|Animation Offsets:]] (Optional)
:[[Hud_gauges.tbl#Animation Background Size:|Animation Background Size:]] (Deprecated)
{{table373|
:[[Hud_gauges.tbl#Animation Size:|Animation Size:]] (Optional)
}}

====+Directives:====
Adds a gauge that displays all currently active directives (includes current , completed, and failed)

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional) (needs animation with one frame)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional) (needs animation with one frame)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional) (needs animation with one frame)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Background Height:|Top Background Height:]] (Optional)
:[[Hud_gauges.tbl#List Start Offsets:|List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Bottom Background Offset:|Bottom Background Offset:]] (Optional)
:[[Hud_gauges.tbl#Max Line Width:|Max Line Width:]] (Optional)
}}

====+Weapons:====
Adds a weapon status and ammunition gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Primary List Top Background Filename:|Primary List Top Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Primary List Middle Background Filename:|Primary List Middle Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Primary List Bottom Background Filename:|Primary List Bottom Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Secondary List Top Background Filename:|Secondary List Top Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Secondary List Entry Background Filename:|Secondary List Entry Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Secondary List Bottom Background Filename:|Secondary List Bottom Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
::[[Hud_gauges.tbl#Alt Ballistic Offsets:|Alt Ballistic Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Primary Background X-offset:|Top Primary BackgroundX-offset:]] (Optional)
::[[Hud_gauges.tbl#Alt Ballistic X-offset:|Alt Ballistic X-offset:]] (Optional)
:[[Hud_gauges.tbl#Text X-offset:|Text X-offset:]] (Optional)
::[[Hud_gauges.tbl#Alt Ballistic X-offset:|Alt Ballistic X-offset:]] (Optional)
:[[Hud_gauges.tbl#Top Primary Frame Height:|Top Primary Frame Height:]] (Optional)
:[[Hud_gauges.tbl#Top Secondary Frame Height:|Top Secondary Frame Height:]] (Optional)
:[[Hud_gauges.tbl#Primary List Start Y-offset:|Primary List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary List Start Y-offset:|Secondary List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Ammo X-offset:|Primary Weapon Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Link X-offset:|Primary Weapon Link X-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Name X-offset:|Primary Weapon Name X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Ammo X-offset:|Secondary Weapon Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Linked X-offset:|Secondary Weapon Linked X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Name X-offset:|Secondary Weapon Name X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Reload X-offset:|Secondary Weapon Reload X-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Entry Height:|Primary Weapon Entry Height:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Entry Height:|Secondary Weapon Entry Height:]] (Optional)

====+Objective notify:====
Adds a Objective notifier gauge. This gauge alerts the player when receiving a new objective, or when an objective has been completed or failed. Additionally, this gauge alerts the player when entering subspace, and when a Red Alert mission orders are being received (prior to a forced subspace jump).

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Objective Text Y-offset:|Objective Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Objective Value Y-offset:|Objective Value Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Subspace Text Y-offset:|Subspace Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Subspace Value Y-offset:|Subspace Value Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Red Alert Text Y-offset:|Red Alert Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Red Alert Value Y-offset:|Red Alert Value Y-offset:]] (Optional)

====+Squad Message====
Adds the squad message gauge. In FS1 and FS2, this gauge is used to send commands to your squad. (?)

*Valid sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#List Start Offsets:|List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Background Height:|Top Background Height:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Bottom Background Offset|Bottom Background Offset]] (Optional)}}
:[[Hud_gauges.tbl#Command X-offset:|Command X-offset:]] (Optional)
:[[Hud_gauges.tbl#Page Up Offsets:|Page Up Offsets:]] (Optional)
:[[Hud_gauges.tbl#Page Down Offsets:|Page Down Offsets:]] (Optional)

====+Lag:====
Adds a Lag gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]

====+Mini Target Shields:====
Adds a mini Target shields gauge. In FS1 and FS2, the Mini Target Shield gauge is the one right below the center reticle, and shows the hull damage in %

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (animation needs 8 frames; 0->3 are the top, right, bottom & left shield quads; 4->7 are the same except brighter for when the quad is flashing from being hit)
:[[Hud_gauges.tbl#3 Digit Hull Offsets:|3 Digit Hull Offsets:]] (Optional)
:[[Hud_gauges.tbl#2 Digit Hull Offsets:|2 Digit Hull Offsets:]] (Optional)
:[[Hud_gauges.tbl#1 Digit Hull Offsets:|1 Digit Hull Offsets:]] (Optional)

====+Player Shields:====
Adds a gauge that shows the shield and hull status icon of the player's craft or ship.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)

====+Target Shields:====
Adds a gauge that shows the shield and hull status icon of the targeted craft or ship.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)

====+Escort View:====
Adds an escort monitor/view gauge. This gauge monitors the status of all ships assigned to the player to escort.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height]] (Optional)
:[[Hud_gauges.tbl#Entry Stagger Width:|Entry Stagger Width:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Bottom Background Offset:|Bottom Background Offset:]] (Optional)}}
:[[Hud_gauges.tbl#Header Text:|Header Text]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#List Start Offsets:|List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Hull X-offset:|Hull X-offset]] (Optional)
:[[Hud_gauges.tbl#Name X-offset:|Name X-offset]] (Optional)
:[[Hud_gauges.tbl#Status X-offset:|Status X-offset]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Ship Name Max Width:|Ship Name Max Width:]] (Optional)}}
{{table373|
:[[Hud_gauges.tbl#Right-Align Ship Names:|Right-Align Ship Names:]] (Optional)}}

====+Mission Time:====
Adds a gauge that displays the current mission time.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
:[[Hud_gauges.tbl#Value Offsets:|Value Offsets:]] (Optional)

====+ETS Retail:====
{{Table3613|
Draws the three other ETS gauges as a single gauge. Will automatically rearrange itself (like retail) if shields or other systems are missing.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
{{Table3613|
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)
:[[Hud_gauges.tbl#Gauge Offset:|Gauge Offset:]] (Optional)

}}

====+ETS Weapons:====
Adds a gauge that displays the energy transfer rate for the energy weapons.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)

====+ETS Engines:====
Adds a gauge that displays the energy transfer rate for the afterburner/engines.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)

====+ETS Shields:====
Adds a gauge that displays the energy transfer rate for the shields.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)

====+Target Monitor:====
Adds a target monitor gauge that shows the targeted ship's relative orientation and hull strength, among other things.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Monitor Filename:|Monitor Filename:]] (Optional) (needs animation with 2 frames, 1st is the background for the target, 2nd is the border; rendered last)
{{table3615|
:[[Hud_gauges.tbl#Monitor Alpha Mask Filename:|Monitor Alpha Mask Filename:]] (Optional) (needs animation with a single frame)}}
:[[Hud_gauges.tbl#Integrity Bar Filename:|Integrity Bar Filename:]] (Optional) (needs animation with 2 frames, 1st is a zero/dark filled bar, 2nd is a max/bright filled bar)
:[[Hud_gauges.tbl#Viewport Offsets:|Viewport Offsets:]] (Optional)
:[[Hud_gauges.tbl#Viewport Size:|Viewport Size:]] (Optional)
:[[Hud_gauges.tbl#Integrity Bar Offsets:|Integrity Bar Offsets:]] (Optional)
:[[Hud_gauges.tbl#Integrity Bar Foreground Clip Height:|Integrity Bar Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Status Offsets:|Status Offsets:]] (Optional)
:[[Hud_gauges.tbl#Name Offsets:|Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Class Offsets:|Class Offsets:]] (Optional)
:[[Hud_gauges.tbl#Distance Offsets:|Distance Offsets:]] (Optional)
:[[Hud_gauges.tbl#Speed Offsets:|Speed Offsets:]] (Optional)
:[[Hud_gauges.tbl#Hull Offsets:|Hull Offsets:]] (Optional)
:[[Hud_gauges.tbl#Cargo Contents Offsets:|Cargo Contents Offsets:]] (Optional)
:[[Hud_gauges.tbl#Cargo Scan Start Offsets:|Cargo Scan Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Cargo Scan Size:|Cargo Scan Size:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Subsystem Name Offsets:|Subsystem Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Subsystem Integrity Offsets:|Subsystem Integrity Offsets:]] (Optional)
:[[Hud_gauges.tbl#Disabled Status Offsets:|Disabled Status Offsets:]] (Optional)
:[[Hud_gauges.tbl#Desaturate:|Desaturate:]] (Optional)
}}

====+Extra Target Data:====
Adds a gauge that displays "extra" target data, such as its current orders and docking status.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs an animation with 1 frame)
:[[Hud_gauges.tbl#Bracket Offsets:|Bracket Offsets:]] (Optional)
:[[Hud_gauges.tbl#Dock Offsets:|Dock Offsets:]] (Optional)
{{table373|
:[[Hud_gauges.tbl#Dock Max Width:|Dock Max Width:]] (Optional)}}
:[[Hud_gauges.tbl#Order Offsets:|Order Offsets:]] (Optional)
{{table373|
:[[Hud_gauges.tbl#Order Max Width:|Order Max Width:]] (Optional)}}
:[[Hud_gauges.tbl#Time Offsets:|Time Offsets:]] (Optional)

====+Radar:====
Adds a standard radar gauge

*Valid Sub-entries:
{{table190|
:[[Hud_gauges.tbl#N-gon Sides:|N-gon Sides:]] (Optional)
:[[Hud_gauges.tbl#N-gon Sides:|N-gon Offset:]] (Optional)
}}
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs animation with 2 frames, only the 2nd frame is used)
{{table373|
:[[Hud_gauges.tbl#Radar Center Offsets:|Radar Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Radar Size:|Radar Size:]] (Optional)
}}
:[[Hud_gauges.tbl#Infinity Distance Offsets:|Infinity Distance Offsets]] (Optional)
:[[Hud_gauges.tbl#Long Distance Offsets:|Long Distance Offsets:]] (Optional)
:[[Hud_gauges.tbl#Short Distance Offsets:|Short Distance Offsets:]] (Optional)

====+Radar Orb:====
Adds a 3D orb radar gauge

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs animation with 2 frames, only the 2nd frame is used)
{{table373|
:[[Hud_gauges.tbl#Radar Center Offsets:|Radar Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Radar Size:|Radar Size:]] (Optional)
}}
:[[Hud_gauges.tbl#Infinity Distance Offsets:|Infinity Distance Offsets]] (Optional)
:[[Hud_gauges.tbl#Long Distance Offsets:|Long Distance Offsets:]] (Optional)
:[[Hud_gauges.tbl#Short Distance Offsets:|Short Distance Offsets:]] (Optional)

====+Radar BSG:====
Adds a BSG style radar (a.k.a DRADIS).

:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Size:|Size:]] (Optional)
:[[Hud_gauges.tbl#XY Disc Filename:|XY Disc Filename:]] (Optional)
:[[Hud_gauges.tbl#XZ YZ Disc Filename:|XZ YZ Disc Filename:]] (Optional)
:[[Hud_gauges.tbl#Sweep Disc Filename:|Sweep Disc Filename:]] (Optional)
:[[Hud_gauges.tbl#Default Contact Filename:|Default Contact Filename:]] (Optional)
:[[Hud_gauges.tbl#Unknown Contact Filename:|Unknown Contact Filename:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]]
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]]
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Loop Volume:|Loop Volume:]] (Optional)
:[[Hud_gauges.tbl#Minimum Beep Delay:|Minimum Beep Delay]] (Optional)

====+Afterburner Energy:====
Adds a gauge that shows the remaining afterburner energy. Note that it only supports a vertical fill.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs animation with 2 frames, the 1st is the bar lit for zero energy, the 2nd is the bar lit for max energy)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)

====+Weapon Energy:====
Adds a gauge that shows the remaining weapon energy. Note that it only supports a vertical fill.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs an animation with 4 frames, the 3rd is the bar lit for zero energy, the 2nd is the bar lit for max energy, frames 1 & 2 are not used)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Text Alignment:|Text Alignment:]] (Optional)
:[[Hud_gauges.tbl#Always Show Text:|Always Show Text:]] (Optional)
:[[Hud_gauges.tbl#Text Follows:|Text Follows:]] (Optional)
:[[Hud_gauges.tbl#Show Ballistic Ammo:|Show Ballistic Ammo:]] (Optional)
:[[Hud_gauges.tbl#Armed Guns List Offsets:|Armed Guns List Offsets:]] (Optional)
:[[Hud_gauges.tbl#Armed Guns List Alignment:|Armed Guns List Alignment:]] (Optional)
:[[Hud_gauges.tbl#Armed Guns List Entry Height:|Armed Guns List Entry Height:]] (Optional)
}}

====+Text Warnings:====
Adds a gauge that warns the player (current warnings are EMP, Launch, Evaded, Collision, Blast & Engine Wash).

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)

====+Center Reticle:====
Adds a "custom" center reticle.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Firepoint display:|Firepoint display:]] (Optional)
:[[Hud_gauges.tbl#Firepoint size:|Firepoint size:]] (Optional)
:[[Hud_gauges.tbl#Firepoint X coordinate multiplier:|Firepoint X coordinate multiplier:]] (Optional)
:[[Hud_gauges.tbl#Firepoint Y coordinate multiplier:|Firepoint Y coordinate multiplier:]] (Optional)

====+Throttle:====
Adds a gauge that shows the current throttle position.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Bottom Y-offset:|Foreground Clip Bottom Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Width:|Foreground Clip Width:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Afterburner Clip Height:|Afterburner Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Show Background:|Show Background:]] (Optional)
:[[Hud_gauges.tbl#Max Speed Label Offsets:|Max Speed Label Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Show Max Speed Label:|Show Max Speed Label:]] (Optional)}}
:[[Hud_gauges.tbl#Min Speed Label Offsets:|Min Speed Label Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Show Min Speed Label:|Show Min Speed Label:]] (Optional)}}
:[[Hud_gauges.tbl#Orbit Center Offsets:|Orbit Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Orbit Radius:|Orbit Radius:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Current Speed Offsets:|Current Speed Offsets:]] (Optional)
:[[Hud_gauges.tbl#Target Speed Offsets:|Target Speed Offsets:]] (Optional)
:[[Hud_gauges.tbl#Show Percentage:|Show Percentage:]] (Optional)
:[[Hud_gauges.tbl#Glide Status Offsets:|Glide Status Offsets:]] (Optional)
:[[Hud_gauges.tbl#Match Speed Status Offsets:|Match Speed Status Offsets:]] (Optional)
}}

====+Threat Indicator:====
Adds a gauge that indicates when a lock-on has been achieved by an attacker, and if the player is being shot at.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Arc Filename:|Arc Filename:]] (Optional)
:[[Hud_gauges.tbl#Dumbfire Filename:|Dumbfire Filename:]] (Optional)
:[[Hud_gauges.tbl#Lock Filename:|Lock Filename:]] (Optional)
:[[Hud_gauges.tbl#Dumbfire Offsets:|Dumbfire Offsets:]] (Optional)
:[[Hud_gauges.tbl#Lock Offsets:|Lock Offsets:]] (Optional)

====+Multiplayer Messages:====
Adds a gauge that displays the multiplayer messages.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}

====+Voice Status:====
Adds a gauge that displays the voice status.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}

====+Ping:====
Adds a gauge that the ping time to the multiplayer server.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}

====+Supernova:====
Adds a gauge that warns the player of an impending supernova shock wave.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}

====+Lock Indicator:====
Adds a Lock Indicator gauge.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Lock Filename:|Lock Filename:]] (Optional)
:[[Hud_gauges.tbl#Locked Filename:|Locked Filename:]] (Optional)
:[[Hud_gauges.tbl#Lock Center Offsets:|Lock Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Locked Center Offsets:|Locked Center Offsets:]] (Optional)

====+Offscreen Indicator:====
Adds an Offscreen Indicator.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}

====+Target Brackets:====
Adds a Target Bracket gauge. This is drawn around current target(s) and talkers.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Dot Filename:|Dot Filename:]] (Optional)

====+Hostile Triangle:====
Adds a gauge that points to the nearest attacker, if it is off-screen and is not currently targeted.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)
:[[Hud_gauges.tbl#Triangle Base:|Triangle Base:]] (Optional)
:[[Hud_gauges.tbl#Triangle Height:|Triangle Height:]] (Optional)

====+Target Triangle:====
Adds a gauge that points to the targeted craft, if it is currently off-screen.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)
:[[Hud_gauges.tbl#Triangle Base:|Triangle Base:]] (Optional)
:[[Hud_gauges.tbl#Triangle Height:|Triangle Height:]] (Optional)

====+Missile Triangles:====
Adds a gauge that is used during attempting to lock onto a target when using an aspect seeking missile.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)
:[[Hud_gauges.tbl#Triangle Base:|Triangle Base:]] (Optional)
:[[Hud_gauges.tbl#Triangle Height:|Triangle Height:]] (Optional)

====+Lead Indicator:====
Adds a gauge that leads (is in front) of the target. Aim your crosshairs at this indicator to increase probability of hitting the target.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
::Frame #0: Secondaries lead indicator (Dumbfire)
::Frame #1: Secondaries lead indicator (Homing)
::Frame #2: Primaries lead indicator
:[[Hud_gauges.tbl#Center Offsets:|Center Offsets:]] (Optional)

====+Orientation Tee:====
Adds a gauge that indicates the targeted craft's orientation in relation to the player's craft.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)

====+Lead Sight:====
Adds a gauge that lags (is behind) the target. Indicates where your shots will end up relative to the target's position. To score a hit, this gauge should be over the target. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
::Frame #0 is used for secondaries
::* If only one frame is found in the file, then it is used for primaries instead
::Frame #1 is used for primaries

====+Kills:====
Adds a gauge that keeps track of how many kills the player has scored during a mission.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
:[[Hud_gauges.tbl#Value Offsets:|Value Offsets:]] (Optional)

====+Weapon Linking:====
Adds a gauge that indicates the selected weapons and their firing rates.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Arc Filename:|Arc Filename:]] (Optional)
:[[Hud_gauges.tbl#Single Primary Filename:|Single Primary Filename:]] (Optional)
:[[Hud_gauges.tbl#Double Primary Filename:|Double Primary Filename:]] (Optional)
:[[Hud_gauges.tbl#Single Secondary Filename:|Single Secondary Filename:]] (Optional)
:[[Hud_gauges.tbl#Double Secondary Filename:|Double Secondary Filename:]] (Optional)
:[[Hud_gauges.tbl#Triple Secondary Filename:|Triple Secondary Filename:]] (Optional)
:[[Hud_gauges.tbl#Single Primary Offsets:|Single Primary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Double Primary Offsets:|Double Primary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Single Secondary Offsets:|Single Secondary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Double Secondary Offsets:|Double Secondary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Triple Secondary Offsets:|Triple Secondary Offsets:]] (Optional)

====+Fixed Messages:====

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table375|
:[[Hud_gauges.tbl#Center Text On Gauge X-Position:|Center Text On Gauge X-Position:]] (Optional)
}}

====+Flight Path Marker:====
{{table3615|
Adds a gauge that indicates the direction where your ship is traveling. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Center Offsets:|Center Offsets:]] (Optional)}}

====+Warhead Count:====
{{table3615|
Displays the name of the current secondary weapon. Tallies the ammo left. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs an animation with a single frame)
:[[Hud_gauges.tbl#Name Offsets:|Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Count Offsets:|Count Offsets:]] (Optional)
:[[Hud_gauges.tbl#Icon Width:|Icon Width:]] (Optional)
:[[Hud_gauges.tbl#Icon Height:|Icon Height:]] (Optional)
:[[Hud_gauges.tbl#Max Icons:|Max Icons:]] (Optional)
:[[Hud_gauges.tbl#Max Columns:|Max Columns:]] (Optional)
:[[Hud_gauges.tbl#Name Alignment:|Name Alignment:]] (Optional)
}}

====+Hardpoints:====
{{table3615|
Draws a silhouette of the player's ship and mounted weapons. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Size:|Size:]] (Optional)
:[[Hud_gauges.tbl#Line Width:|Line Width:]] (Optional)
:[[Hud_gauges.tbl#View Direction:|View Direction:]] (Optional)
:[[Hud_gauges.tbl#Show Primary Weapons:|Show Primary Weapons:]] (Optional)
:[[Hud_gauges.tbl#Show Secondary Weapons:|Show Secondary Weapons:]] (Optional)
}}

====+Primary Weapons:====
{{table3615|
Like the Weapons gauge but simpler. Only displays primary weapons. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Header Text:|Header Text:]] (Optional)
:[[Hud_gauges.tbl#First Background Filename:|First Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#First Background Height:|First Background Height:]] (Optional)
:[[Hud_gauges.tbl#First Background X-offset:|First Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Entry Background Height:|Entry Background Height:]] (Optional)
:[[Hud_gauges.tbl#Entry Background X-offset:|Entry Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Filename:|Last Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Last Background X-offset:|Last Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Y-offset:|Last Background Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
:[[Hud_gauges.tbl#List Start Y-offset:|List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Ammo X-offset:|Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Link X-offset:|Link X-offset:]] (Optional)
:[[Hud_gauges.tbl#Name X-offset:|Name X-offset:]] (Optional)
}}

====+Secondary Weapons:====
{{table3615|
Like the Weapons gauge but simpler. Only displays secondary weapons. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Header Text:|Header Text:]] (Optional)
:[[Hud_gauges.tbl#First Background Filename:|First Background Filename:]] (Optional)
:[[Hud_gauges.tbl#First Background Height:|First Background Height:]] (Optional)
:[[Hud_gauges.tbl#First Background X-offset:|First Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Height:|Entry Background Height:]] (Optional)
:[[Hud_gauges.tbl#Entry Background X-offset:|Entry Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Filename:|Last Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Last Background X-offset:|Last Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Y-offset:|Last Background Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
:[[Hud_gauges.tbl#List Start Y-offset:|List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Ammo X-offset:|Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Link X-offset:|Link X-offset:]] (Optional)
:[[Hud_gauges.tbl#Name X-offset:|Name X-offset:]] (Optional)
:[[Hud_gauges.tbl#Unlink X-offset:|Unlink X-offset:]] (Optional)
:[[Hud_gauges.tbl#Reload X-offset:|Reload X-offset:]] (Optional)
}}

===$End Gauges===
The Gauges section must end with $End Gauges. No Exceptions.

==#End==
The very last entry in the Hud_gauges.tbl must be #End. No Exceptions.

----
----

==Gauge Configuration Options==
Since a vast majority of gauges share the same entries, the configuration options for each gauge have been grouped here for formatting consistency.

====Position:====
Defines the screen coordinates for the upper left corner of this gauge.

*Syntax: '''Integer''' horizontal pixel, '''Integer''' vertical pixel position

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Training Messages:|+Training Messages:]], [[Hud_gauges.tbl#+Support:|+Support]] (and many others)

====Scale Gauge:====

{{table371|
Define if a gauge size will scale or not.

If false then gauge bitmaps will always show at their original size which may result in gauges being very small at high resolutions.

If true then gauge bitmaps will scale in proportion to the current resolution vs the base HUD resolution in use. This may result in gauges becoming blurry at non-base resolutions.

Defaults to yes/true.

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: '''Boolean''' scale_this_gauge

Used by: most gauges
}}

====Force Scaling Above:====

{{Table373|
Optional. If scaling is disabled for this gauge, then it will be scaled as though the base resolution were this resolution or the real base resolution, whichever is greater.

Use this to disable scaling at lower resolutions while preventing gauges from getting too small at higher resolutions.

To disable this feature, use '''(-1, -1)'''.

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: ('''Integer''' width, '''Integer''' height)

Used by: most gauges
}}

====Origin:====

{{table371|
Define gauge position as a ratio of the screen size (base or current, it doesn't matter).

Requires [[Hud_gauges.tbl#Offset:|Offset:]]

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: '''Float''' horizontal ratio 0.0 - 1.0, '''Float''' vertical ratio 0.0 - 1.0

Used by: most gauges
}}

====Offset:====

{{table371|
Define gauge offset from [[Hud_gauges.tbl#Origin:|Origin:]] in base resolution pixels

Requires [[Hud_gauges.tbl#Origin:|Origin:]]

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: '''Integer''' horizontal pixel offset from Origin:, '''Integer''' vertical pixel offset from Origin:

Used by: most gauges
}}

====Cockpit Target:====
The cockpit display that this gauge will be rendered to. Refers to the +Display Name: defined in [[ships.tbl#$Cockpit Display:|$Cockpit Display:]].

*Syntax: '''String''' String defined in +Display Name: in [[ships.tbl#$Cockpit Display:|$Cockpit Display:]]

=====Canvas Size:=====
The off-screen canvas this gauge will be rendered to before being interpolated into the actual cockpit display. The smaller this number is, the larger the gauge will appear on the cockpit display.

*Syntax: '''Integer''' width, '''Integer''' height

=====Display Offset:=====
The position of the canvas on the cockpit display texture

*Syntax: '''Integer''' width, '''Integer''' height

=====Display Size:=====
The interpolated size on the cockpit display texture that the canvas will be rendered to.

*Syntax: '''Integer''' width, '''Integer''' height

====Color:====
Optional. Overrides both previous color settings ([[Hud_gauges.tbl#$Color: 1|$Color]] HUD option and [[Hud_gauges#$Color: 2|$Color]] ship class option) for this particular gauge.

*Syntax: See [[Hud_gauges.tbl#$Color: 1|$Color:]]

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Font:====
Optional. Overrides both previous font settings ([[Hud_gauges.tbl#$Font: 1|$Font]] HUD option and [[Hud_gauges#$Font: 2|$Font]] ship class option) for this particular gauge.

*Syntax: See [[Hud_gauges.tbl#$Font: 1|$Font:]]

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Training Messages:|+Training Messages:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Name:====
Defines the name of this custom gauge.

*Syntax: '''String'''
*Max Length: 32 characters

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Text:====
Default text to be displayed. Can be altered using the hud-set-message, hud-set-text and hud-set-directive sexps.

*Syntax: '''String'''
*Max Length: 32 characters

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====X Offset:====
Optional. Defines the horizontal pixel offset (from the gauge's origin as defined by [[Hud_gauges.tbl#Position:|Position:]]) that the Text will be displayed.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Y Offset:====
Optional. Defines the vertical pixel offset (from the gauge's origin defined by [[Hud_gauges.tbl#Position:|Position:]]) that the Text will be displayed.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Gauge Type:====
Defines the type of gauge this is.

*Syntax: '''String'''
*Valid Values: Any one of the possible [[gauge types]].

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Slew:====
Optional. Determines whether or not this gauge is affected by afterburner shaking or similar effects. If set to "true", the gauge will not follow the player's head movements when using TrackIR/padlock. i.e. should be used for gauges like the gunsight/leadsight.

*Syntax: '''Boolean'''

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Max Lines:====
Optional. Specifies the maximum number of message lines that are displayed.

*Syntax: '''Integer'''
*Default Value: 3

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Max Width:====
Optional. Determines how long each message line may be.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Line Height:====
Optional. Determines the distance between line origins. (i.g. for a 12pt Font, there are needs to be at least 12 pixels between the bottom of one line and the next, otherwise the text will overlap each)

*Syntax: '''Integer'''
*Units: Pixels
*Default Value: 9

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Total Lifetime:====
Optional. Determines the maximum time the message gauge will be displayed from the time a new message is received.

*Syntax: '''Integer'''
*Units: milliseconds
*Default Value: 14000 (14 seconds)

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Scroll Time:====
Optional. Determines the time for the messages to scroll up one step.( See [[Hud_gauges.tbl#Step Size:|Step Size:]] )

*Syntax: '''Integer'''
*Units: milliseconds
*Default Value: 30

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Step Size:====
Optional. Determines how many pixels to shift message lines during scrolling. Messages will be shifted up by this amount until they are on the next line (as defined by [[Hud_gauges.tbl#Line Height:|Line Height:]])

*Syntax: '''Integer'''
*Units: Pixels
*Default Value: 3

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Active by default:====
Optional. Determines whether or not this gauge is always active, or only available after being activated via sexp.

*Syntax: '''Boolean'''

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Filename:====
Designates the [[Multimedia_Files#ANI|.ANI]] or [[Multimedia_Files#EFF|.EFF]] used for this gauge's background graphic.
{{Note| All HUD .ANI's must have the same color palette as the retail .ANI's in order to render properly. (.EFF's do not have this restriction)}}

*Syntax: '''Filename'''
**No filename extension is needed.

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Top Background Filename:====
Optional. Designates which file to use for the top background. (?)

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Damage|+Damage]]

====Bottom Background Filename:====
Optional. Designates which file to use for the Bottom background (?)

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Damage|+Damage]]

====Left Background Filename:====
Optional. Designates which file to use for the Left side of gauge.

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====First Background Filename:====
Optional. Alias for [[Hud_gauges.tbl#Left Background Filename:|Left Background Filename:]]

====Right Background Filename:====
Optional. Designates which file to use for the Right side of the gauge.

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Last Background Filename:====
Optional. Alias for [[Hud_gauges.tbl#Right Background Filename:|Right Background Filename:]]

====Entry Background Filename:====
Optional. Designates which file to use for the (Wing) Entry section of the gauge (aka the middle sections).

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Damage|+Damage]], [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Primary List Top Background Filename:====
Optional. Designates which file to use for the Primary List Top Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary List Middle Background Filename:====
Optional. Designates which file to use for the Primary List Middle Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary List Bottom Background Filename:====
Optional. Designates which file to use for the Primary List Bottom Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Top Background Filename:====
Optional. Designates which file to use for the Secondary List Top Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Entry Background Filename:====
Optional. Designates which file to use for the Secondary List Entry Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Bottom Background Filename:====
Optional. Designates which file to use for the Secondary List Bottom Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Alt Ballistic Filename:====
Optional. Designates an alternate file to be used for ballistic weapons.

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#Primary List Top Background Filename:|Primary List Top Background Filename]], [[Hud_gauges.tbl#Primary List Middle Background Filename:|Primary List Middle Background Filename]], [[Hud_gauges.tbl#Primary List Bottom Background Filename:|Primary List Bottom Background Filename]], [[Hud_gauges.tbl#Secondary List Top Background Filename:|Secondary List Top Background Filename]], [[Hud_gauges.tbl#Secondary List Entry Background Filename:|Secondary List Entry Background Filename]], [[Hud_gauges.tbl#Secondary List Bottom Background Filename:|Secondary List Bottom Background Filename]]

====Dot Filename:====
Optional. Designates which file to use for the wingman graphic (a.k.a. the Dot)

*Syntax: '''Filename'''

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Header Offsets:====
Optional. Designates the offset from the gauge's upper left corner for headers of various gauges

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels
*Valid Sub-entries:
:Weapons:
::[[Hud_gauges.tbl#Alt Ballistic Offsets:|Alt Ballistic Offsets:]]

Used by: [[Hud_gauges.tbl#+Support:|+Support:]], [[Hud_gauges.tbl#+Damage|+Damage:]], [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Fixed Header Position:====
Optional. If set, the header text will not change position when the gauge changes size.

*Syntax: '''Boolean'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Text Y-offset:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship Text. (?)

*Syntax: '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]]

====Text Offsets:====
Optional. Defines the screen position offsets for the text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: :[[Hud_gauges.tbl#+Countermeasures:|+Countermeasures:]]

====Value Offsets:====
Optional. Defines the screen position offsets for the value label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: :[[Hud_gauges.tbl#+Countermeasures:|+Countermeasures:]]

====Dock Status X-offset:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship's dock status. (?)

*Syntax: '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]]

====Dock Time X-offset:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship's dock time. (?)

*Syntax: '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]]

====Hull Integrity Offsets:====
Optional. Designates the offsets from the gauge's upper left corner for the for the Damage gauge Hull integrity textbox(?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Hull Integrity Value X-offset:====
Optional. Designates the offsets from the hull integrity textbox's upper left corner for the hull integrity value. (?)

*Syntax: '''Integer''' horizontal offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Top Background Height:====
Optional. Designates the height of the Top background (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Left Background Width:====
Optional. Defines the width of the Left Background.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Entry Width:====
Optional. Defines the width of the Entry Background (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Subsystem Entry Height:====
Optional. Designates the height of the Subsystem entry (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Subsystem List Start Offsets:====
Optional. Designates the offsets from the gauge's upper left corner for the for the start of the Subsytem List (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Subsystem Entry Value X-offset:====
Optional. Designates the horizontal offset from the Subsystem List's position (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Single Wing Offsets:====
Optional. Designates the offset from the gauge's upper left corner for a single wing (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Multiple Wing Start Offsets:====
Optional. Designates the offset from the gauge's upper left corner for multiple wings (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Wing Name Offsets:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship header (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Dot Offsets:====
Optional. Designates the offset from the gauge's upper left corner for the All wingman status icons.
*Syntax:
:'''Integer''' x, '''Integer''' y ;; Wingman 1
:'''Integer''' x, '''Integer''' y ;; Wingman 2
:'''Integer''' x, '''Integer''' y ;; Wingman 3
:'''Integer''' x, '''Integer''' y ;; Wingman 4
:'''Integer''' x, '''Integer''' y ;; Wingman 5
:'''Integer''' x, '''Integer''' y ;; Wingman 6
*Units: Pixels

{{Warning|
All 6 wingman positions must be defined}}

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Expansion Mode:====
Optional. Denotes which direction (in relation to the player's wing) that the other wings should be appended to the gauge. If enabled, then wingmen dot colors will be

*Syntax: '''Boolean'''
*Default Value: '''False'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Use Full Wing Names:====
{{Table214|
Optional. If enabled the wingmen gauge draws the full wing name and does not alter the capitalization. Default behavior is to draw the first three letters of the wing in all lower-case.

*Syntax: '''Boolean'''
*Default Value: '''False'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]
}}

====Use Expanded Colors:====
{{Table214|
Optional. If enabled the wingmen gauge status dots use red, yellow, or green color to designate wingmen health (green full to greater thon two-thirds, yellow two-thirds to greater than one-third, and red less than or equal to one-third). Default is to use red for less than half health and gauge color otherwise.

*Syntax: '''Boolean'''
*Default Value: '''False'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]
}}

====Auto Offsets:====
Optional. Defines the screen coordinates for the "Auto" text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Auto Speed:|+Auto Speed:]], [[Hud_gagues.tbl#+Auto Target:|+Auto Target:]]

====Speed Offsets:====
Optional. Defines the screen coordinates for the "Speed" text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Auto Speed:|+Auto Speed:]]

====Target Offsets:====
Optional. Defines the screen coordinates for the "Target" text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Auto Target:|+Auto Target:]]

====Animation Offsets:====
Optional. Defines the offsets for the animation graphics.

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Talking Head:|+Talking Head:]]

====Animation Background Size:====
Deprecated. Originally, this set the size of the black box that's drawn behind the animation. Since Git revision 556e9a4 (2015-11-01), it has the same effect as [[Hud_gauges.tbl#Animation Size:|Animation Size:]].

*Syntax: '''Integer''' horizontal size, '''Integer''' vertical size
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Talking Head:|+Talking Head:]]

====Animation Size:====
{{table373|
Optional. Defines the size of the animation. All animations will be scaled to match this size.

*Syntax: '''Integer''' horizontal size, '''Integer''' vertical size
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Talking Head:|+Talking Head:]]
}}

====List Start Offsets:====
Optional. Defines the screen coordinate offsets for the start of the Directives list.

*Syntax: '''Integer''' x, '''Integer''' y
*Units: Pixels

Used by: [[Hud_guages.tbl#+Directives:|+Directives:]]

====Entry Height:====
Optional. Defines the height of each Directive

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_guages.tbl#+Directives:|+Directives:]]

====Alt Ballistic Offsets:====
Opetional. Defines the screen coordinate offsets for headers of ballistic weapons

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Header Offset:|+Header Offset:]]

====Top Primary Background X-offset:====
Optional. Defines the screen coordinate offset for the Top Primary Background

*Syntax: '''Integer'''
*Units: Pixels
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic X-offset:|Alt Ballistic X-offset:]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Text X-offset:====
(Optional) Defines the screen coordinate X-offset for weapon labels

*Syntax: '''Integer'''
*Units: Pixels
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic X-offset:|Alt Ballistic X-offset:]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Alt Ballistic X-offset:====
Optional. Defines the screen coordinate X-offset for ballistic weapons

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#Top Primary Background X-offset:|Top Primary Background X-offset:]], [[Hud_gauges.tbl#Text X-offset:|Text X-offset:]]

====Top Primary Frame Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Top Secondary Frame Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary List Start Y-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Start Y-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Ammo X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Link X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Name X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Ammo X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Linked X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Name X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Reload X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Entry Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Entry Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====3 Digit Hull Offsets:====
Designates the screen position offsets for the hull damage % when it is the 3 digit range (i.e. >= 100%)

*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Mini Target Shields:|+Mini Target Shields:]]

====2 Digit Hull Offsets:====
Designates the screen position offsets for the hull damage % when it is the 2 digit range (i.e. 100% > hull damage% >= 10%)

*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Mini Target Shields:|+Mini Target Shields:]]

====1 Digit Hull Offsets:====
Designates the screen position offsets for the hull damage % when it is the 1 digit range (i.e. 10% > hull damage% >= 0%)

*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Mini Target Shields:|+Mini Target Shields:]]

====Objective Text Y-offset:====
Designates the screen position offset for the Objective label

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Objective Value Y-offset====
Designates the screen position offset for the Objective value

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Subspace Text Y-offset:====
Designates the screen position offset for the Subspace label

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Subspace Value Y-offset====
Designates the screen position offset for the Subspace value (?)

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Red Alert Text Y-offset====
Designates the screen position offset for the Red Alert label

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Red Alert Value Y-offset====
Designates the screen position offset for the Red Alert value (?)

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Command X-offset:====
*Syntax: '''Integer''' x offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Squad Message:|+Squad Message:]]

====Page Up Offsets:====
*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Squad Message:|+Squad Message:]]

====Page Down Offsets:====
*Syntax: '''Integer''' x offset, ''' Integer y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Squad Message:|+Squad Message:]]

====Entry Height:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Entry Stagger Width:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Header Text:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Header Offsets:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====List Start Offsets:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Hull X-offset:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Name X-offset:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Status X-offset:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Ship Name Max Width:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Right-Align Ship Names:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Foreground Clip Height:====

* Sets the height, in pixels, of the gauge.
** For the [[Hud_gauges.tbl#+Throttle|Throttle]], sets the height of the gauge that represents 0% to 100% throttle. The total height of the gauge is the sum of this value and the [[Hud_gauges.tbl#Afterburner Clip Height:|Afterburner Clip Height]] value.
* Syntax: '''Integer'''

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]], [[Hud_gauges.tbl#+ETS Weapons:|+ETS Weapons]], [[Hud_gauges.tbl#+ETS Engines:|+ETS Engines]], [[Hud_gauges.tbl#+ETS Shields:|+ETS Shields]], [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor]], [[Hud_gauges.tbl#+Afterburner Energy|+Afterburner Energy]], [[Hud_gauges.tbl#+Weapon Energy|+Weapon Energy]], [[Hud_gauges.tbl#+Throttle:|+Throttle]]

====Letter Offsets:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Top Offsets:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Bottom Offsets:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Gauge Offset:====
*Distance between the individual weapon/shield/engine ETS gauges that comprise this gauge
*Syntax: '''Integer'''

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Monitor Filename:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Integrity Bar Filename:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Viewport Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Viewport Size:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Integrity Bar Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Integrity Bar Foreground Clip Height:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Status Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Name Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Class Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Speed Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Hull Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Cargo Contents Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Cargo Scan Start Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Cargo Scan Size:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Bracket Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Dock Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Dock Max Width:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Order Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Order Max Width:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Time Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Radar Center Offsets:====
Defines the radar's plot origin as an offset, in pixels, from this gauge's [[Hud_gauges.tbl#Position|Position]] coordinates
*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

====Radar Size:====
Size, in pixels, of the radar plot area.

Syntax: '''Integer''' horizontal size, '''Integer''' vertical size

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

====Infinity Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

Offset to draw the infinity radar range symbol.

====Long Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

Offset to draw the long range radar text (i.e. 10k).

====Short Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

Offset to draw the short range radar text (i.e. 2k).

====Size:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====XY Disc Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====XZ YZ Disc Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Sweep Disc Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Default Contact Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Unknown Contact Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Loop Volume:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG]]

====Minimum Beep Delay:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG]]

====Firepoint display:====
Displays the positions of the gun firepoints on your ship
*Syntax: '''Boolean''', YES or NO

NOTE: The position of the firepoints is calculated from the Eye Point position in the POF. You may encounter weird results if you have no Eye Point defined, but no debug warnings will be raised.

Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Firepoint size:====
Diameter of the gunpoint circles. '''Must be 4 or greater''' in order to work properly.
*Syntax: '''Integer'''

Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Firepoint X coordinate multiplier:====
Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Firepoint Y coordinate multiplier:====
Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Foreground Clip Bottom Y-offset:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Foreground Clip Width:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Afterburner Clip Height:====
* Sets the area of the throttle gauge that represents the Afterburner segment (which is on top of the 0% to 100% area). The total height of the gauge is determined by the sum of this value and [[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]]

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Show Background:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Max Speed Label Offsets:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Min Speed Label Offsets:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Orbit Center Offsets:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Orbit Radius:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Arc Filename:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Needs to be an [[Multimedia_Files#ANI|ani]] with a least 2 frames (but only the 2nd frame is used ?!?!? for threat & weapon linking so far)

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Dumbfire Filename:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Needs to be an [[Multimedia_Files#ANI|ani]] with a least 2 frames. The 1st frame is "no warning", the rest of the frames are cycled through when a warning is active.

Internally FSO also refers to this as the "laser threat warning".

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Lock Filename:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Needs to be an [[Multimedia_Files#ANI|ani]] with a least 2 frames. The 1st frame is "no warning", the rest of the frames are cycled through when a warning is active. Frames cycle twice as fast when a lock has been acquired, compared to when a lock is being acquired.

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Dumbfire Offsets:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Lock Offsets:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Lock Filename:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Locked Filename:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Lock Center Offsets:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Locked Center Offsets:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Radius:====
Defines the distance from the center of the screen to the base of the Hostile Triangle gauge.

*Syntax: '''Integer'''
*Default value:
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Hostile Triangle:|+Hostile Triangle:]]

====Triangle Base:====
Defines the width of the Hostile Triangle's base.

*Syntax: '''Float'''
*Default value:
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Hostile Triangle:|+Hostile Triangle:]]

====Triangle Height:====
Defines the height of the Hostile Triangle.

*Syntax: '''Float'''
Default value:
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Hostile Triangle:|+Hostile Triangle:]]

====Center Offsets:====

Used by: [[Hud_gauges.tbl#+Lead Indicator:|+Lead Indicator:]]

====Single Primary Filename:====
Designates the file to use for primary linking for ships with a single primary bank.

Needs to be an [[Multimedia_Files#ANI|ani]] with 2 frames; 1st is bank 1 not selected (not that this should ever be able to happen), 2nd is bank 1 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Primary Filename:====

Designates the file to use for primary linking for ships with two primary banks.

Needs to be an [[Multimedia_Files#ANI|ani]] with 4 frames:
* Frame 0 is no banks selected
* Frame 1 is 1st bank selected
* Frame 2 is 2nd bank selected
* Frame 3 is both banks selected/linked

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Single Secondary Filename:====

Designates the file to use for selected secondary bank for ships with a single secondary bank.

Needs to be an [[Multimedia_Files#ANI|ani]] with 2 frames; 1st is bank 1 not selected, 2nd is bank 1 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Secondary Filename:====

Designates the file to use for selected secondary bank for ships with two secondary banks.

Needs to be an [[Multimedia_Files#ANI|ani]] with 3 frames; 1st is no banks selected, 2nd is bank 1 selected, 3rd is bank 2 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Triple Secondary Filename:====

Designates the file to use for selected secondary bank for ships with two secondary banks.

Needs to be an [[Multimedia_Files#ANI|ani]] with 4 frames; 1st is no banks selected, 2nd is bank 1 selected, 3rd is bank 2 selected, 4th is bank 3 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Single Primary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Primary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Single Secondary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Secondary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Triple Secondary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Hidden By Comms Menu:====
{{Table3615|
Defines whether the messages gauge may be drawn at the same time as the wingman comms menu.
*Syntax: '''Boolean'''
*Default Value: '''false''' (messages are not visible while the comms menu is open)
Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]}}

====Bottom Background Offset:====
{{Table3615|
Defines the vertical pixel offset added to the position of the bottom background frame.
*Syntax: '''Integer''' vertical offset
*Units: Pixels
Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]}}

====Center Text On Gauge X-Position:====
{{Table375|
Sets whether to position the center of the text to the gauge's X-position.
*Syntax '''Boolean'''
*Default Value: '''false''' if the gauge is explicitly given a position, '''true''' otherwise
Used by: [[Hud_gauges.tbl#+Fixed Messages:|+Fixed Messages:]]}}

====N-gon Sides:====
{{Table190|
Defines the number of sides a regular polygon (N-gon) radar has. If defined, the standard radar's edge is drawn as an N-gon, instead of the standard ellipsoid. Blips that are projected outside of the N-gon are snapped to the edge: the blip's angle stays the same but the blip's radius to the center of the plot area is reduced.
*Syntax '''Integer'''
*Default Value: '''0''' A value of 0 means to use the standard ellipsoid radar
*Minimum value: '''3''' (which is a triangle)
Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]}}

====N-gon Offset:====
{{Table190|
Defines the angular offset to apply to the N-gon perimeter. The first vertex is at the 3 o'clock position, positive offsets spin this vertex counter-clockwise, negative offsets spin this clockwise.
*Syntax '''Float''' (radians)
*Default Value: '''0'''
Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]}}

[[Category:Tables]]

Wxfred2Contributions

2022-05-01T11:05:03Z

Z64555:

{{Note | wxFRED has been abandoned in favor of qtFRED. This page has been left as a testament to efforts put into wxFRED as it laid the foundation for qtFRED.}}

First off, thanks for stopping by!

If you've found this page, it probably means that you or someone you know is interested in the development of the upcoming wxFRED2, a port of the Freespace 2 Editor to use the wxWidgets GUI library. Here we'll post some useful links as well as a guideline or two.

If you have not done so already, please skim over this forum topic: [http://www.hard-light.net/forums/index.php?topic=82688.0 The "Read Me First" Posts]

=Getting the source code=
We'll be starting off by using the GitHub repository for the wxFRED2, so as to achieve familiarity with the GitHub workflow.

* Download and install the [http://git-scm.com/downloads latest version of git]
* Sign Up on or Log Into [http://github.com GitHub]
* Fork the [https://github.com/scp-fs2open/fs2open.github.com/tree/wxfred2 wxFRED2 branch] from the GitHub repository
* Make changes to the wxfred2 branch
** Verify the changes are compilable and buildable
* Commit your changes to your local repo, then push your local repo onto your forked repo on GitHub
* Issue a Pull Request, and a badged SCP member (probably z64555) will review & commit your changes

=Mission statement of the wxFRED2 project=
Trash the MFC UI elements, Use wxWidgets UI elements, use as much of the existing code as possible (while not screwing over future development)

=Coding Gudelines=
"The Golden Rule"
* No business logic be located in the UI elements
* UI stuff is strictly UI
* Any operations in the UI that do actual work must go through an API provided by wxfred2.h and wxfred2.cpp

=Coding Style=
* Any coding style is permitted, just be sure to follow the existing style if you are editing a file
* "Allman" is the most prevalent brace and spacing style
* wxWidgets class names are camel case, and have a lowercase prefix of 2 to 4 letters. ex: "frmFRED" for frame, "glcVieport" for a glCanvas, etc.
** All other class names are camel case and have no prefix, and first letter is capitalized. ex: ViewSettings
* wxWidgets Handler methods/functions are camel case, and have the first letter capitalized ex: OnPaint()
** All other methods/functions may have their own style, but please be sure to follow existing style if present

=Features and Bugs=
<nowiki>Maintainers: Please be sure to mark the date this was last edited by using --~~~~----</nowiki>

Updated by: --[[User:Z64555|Z64555]] 11:13, 23 October 2013 (UTC)----

{| class="wikitable" style="color:red"
|- style="color:black"
! Component or Feature
! Active Developer(s)
! Completed
|- style="color:green"
| create all windows
| z64555
| yes
|-
| glViewport
| z64555
| no
|-
| docFRED
| z64555
| no
|-
| File-New Mission
| ?
| no
|-
| File-Save Mission
| niffiwan?
| no
|}

Some Pastebins for reference/discussion
* http://pastebin.com/qBSATeP2 Early API for UI/backend
* http://pastebin.com/BWXamnrf viewport header
* http://pastebin.com/uu87vurg viewport source
* http://pastebin.com/v9Sh58v9 mission frame (context) header
* http://pastebin.com/z8nADzxt mission frame (context) source

Please use [http://scp.indiegames.us/mantis/set_project.php?project_id=1;2 Mantis] for bug tracking.

Feature Requests

2022-05-01T10:59:34Z

Z64555: Add link to current feature request tracking system, the github issue board

{{Note|This page is rather out of date, and many of these features have already been implemented in FSO. All further feature requests are to be made on the [https://github.com/scp-fs2open/fs2open.github.com/issues Github issue tracker]}}

== New Requests ==

=== Internal Cockpit View - HUD System Changes ===
In order to get a more immersive in-cockpit view than we currently have, there are a number of necessary changes.
The short-term system changes would primarily involve:
* An option somewhere to turn cockpit view on or off.
* Placing a specified 'standard cockpit model' POF in the mission with it's eyepoint lined up with the players in-ship viewpoint.
* A way to move or replicate the HUD and all it's functionality to fit in with the standard cockpit model. (This would most likely involve completing the HUD_guages.tbl feature, but it would also involve a way to define an alternate 'in cockpit' HUD component layout)

In the long term this feature would involve:
* Being able to define a different internal cockpit on a per-ship basis.
* Different internal cockpit models would need to be associated with different HUD component layouts

The changes are described in detail in this thread [http://www.hard-light.net/forums/index.php/topic,48726.msg990018.html#msg990018 here.]

I'm more than willing to help out any coders who do take this on in regards to the modeling/texturing/interface art side of things. --[[User: VA|VA]]

:*'''Supported By:''' FSU, Twisted Infinities, [[Starfox:_Shadows_of_Lylat|Shadows of Lylat]], [[Star Wars Conversion|Fate of the Galaxy]], The Dark Space Project

=== Orders for bomber turrets ===
When using retail AI (as opposed to a modified AI package like Fury AI), bomber turrets only attack your target, which makes them usless as defensive weapons. The idea is to be able to order your turret and make it useful. Added comm options would be:

*turret: (keypress shift-1),
**protect me
**sync to gun (acts as a gunpoint)
**attack my target
**defend all friendlies
**attack any hostile
*all turrets: (keypress shift-2)
**protect me
**sync to gun (acts as a gunpoint)
**attack my target
**defend all friendlies
**attack any hostile

(This idea is modified from one from the thread "actually useful bomber turrets")

:*'''Supported By:''' several comunity members and by The Dark Space Project. Note that many custom AI profiles now allow turrets to select their own targets.

=== Multiple shield meshes ===
You can have an individual shield mesh for each part of the ship. It would also allow you to shield certain turrets, important parts, ect. and not shield everything else.

:*'''Supported By:''' The Dark Space, FreeSpace: Arcade (unadvertised mod)

=== Toggleable subsystems ===
Support for subsystems that can be turned on and off (ie when 'off', act as though they never existed - are untargetable, leave behind no damage LOD, do not take damage, cannot be collided with, etc.) This would be useful for ships where someone might want to remove or swap a subsystem (ie fighter cockpits could have Terran and Vasudan versions). The ability to do this with turrets too would be great.
:* '''Supported By:''' [[Starfox:_Shadows_of_Lylat|Shadows of Lylat]], Twisted Infinities, [[Fringespace]], [[The Sagitta Project]]

=== Minefields ===

Just like asteroid fields, only they're mines, and they explode violently instead of burning up.

:*'''Supported By:''' Starforce

=== Ship headlights ===

Ship headlights/floodlights that actually cast light on objects.

:*'''Supported By:''' Starforce, The Dark Space Project

=== Maximum asteroid number increase ===

From 256 to 1024+ (possibly use depth culling to reduce rendering load).

:*'''Supported By:''' Starforce

=== Gatling Turrets ===
Support for Gatling gun turrets, which work same as a regular multipart turret but has an extra subobject (child of the barel) that rotates while the turret is firing.
:* '''Supported By:''' Nukemod - Children of Shiva, [[The Sagitta Project]], The Dark Space Project

=== Submodel Animation Triggers & Upgrades ===
Trigger Requests:
* Subspace - Performs animation on entrance to supspace, and undoes when a ship comes out of subspace, and acts as a initial position if the "mission takes place in subspace" flag is set.
*Weapon Fire - Performs animation when weapon is fired and undoes it before the weapon can fire again.
*Sexp - Animation triggered by sexp.
*Flight Control - Triggered by the the activation, toggle or motion of a particular flight control.
Requested Upgrades:
*Support for submodel translation within the submodel animation code. (It *can* already be done, but only with scripting, and doing it this way breaks collision detection)
*Support for "model-relative" movement in addition to "current submodel position-relative" movement that already exists.
*Incremental movement - moves a submodel to the position indicated, but does not undo the motion.
*Glowpoint linking - Make it possible to activate/deactivate/toggle a certain bank/slot of glowpoint(s).
*Counter-rotate option - allow an object to inherit its parent's motion while counter-rotating, usefull for translation effect.
*Increase heirarchy depth instance limit to at least 10 levels of heirarchy.
*Simple linked animation support - Support for animations liked with flight controls and other variable setting ship controls, usefull for making animated cockpit controls, control surfaces, and thrust vectoring nozzels.
:* '''Supported By:''' Nukemod - Children of Shiva, Twisted Infinities, [[Starfox:_Shadows_of_Lylat|Shadows of Lylat]], [[Fringespace]], [[The Sagitta Project]]

=== 3D Muzzle Flashes ===
Support for pof based 3d muzzel flashes. perhaps also add variables for scale factor and fade speed.
:* '''Supported By:''' Nukemod - Children of Shiva

=== Arrays and Other Collections ===
Support for FRED using arrays or other collections (or both) in a similar fashion to variables as there is currently no way to directly associate two variables with each other. Obviously some way to search the collection for a certain value would be needed.
:* '''Supported By:''' MindGames, [[The Babylon Project]], Twisted Infinities

=== Warping Without Vortex ===
Adds another checkbox to the arrival and departure cues for ships and wings, to disable rendering of the warp vortex, but will preserve all other aspescts of conventional warping, such as the arrival/departure speeds and deceleration/accelleration. Current option to disable warp rendering, will cause ship to appear and disappear without movement.
:* '''Supported By:''' [[The Babylon Project]], [[Fringespace]]

=== Convergence Firing ===
Also called "X-Firing", allows a weapon to have secondary source effects so that a weapon can appear to gain a charge boost from converging fire from other sources on the model. Could be either a beam or a standard primary. Would require additional data in the weapon table entry, for effects to be used and timing of the secondary prior to the main firing sequence, as well as data on the turret entry in the ships table, indicating co-ords for where the secondary effects will originate, and the number of secondary sources.
:* '''Supported By:''' [[The Babylon Project]], [[Fringespace]]

=== Adjustable Weapon Convergence ===

Add an ability in-game to adjust the distance from the firing points where a fighter/bomber's weapons will converge on a specific point, in distance from the ship (i.e. 100 m, 300 m, etc).

:* '''Supported By:''' [[Beyond the Red Line]], [[Star Wars Conversion]], [[Fringespace]]

=== Cinematic Controls ===

Add in a large number of commands in FRED to make in-mission cut scenes easier to do and with more exact control. The full list is as follows:
* FirePrimary (Ship) (# seconds)
* FireSecondary (Ship) (# times)
* FireCM (Ship) (# times)
* FireTurret (Ship) (Turret) (Target <co-ords or ship>) (# times)
* MoveRotation (Ship) (Degrees)
* MoveSmoothFP (Ship) (Waypoint)
* IgnoreAllButOrders (Ship)
* UseAfterburner (Ship) (# seconds)
* ForwardShields (Ship) (# Times)
* RightShields (Ship) (# Times)
* RearShields (Ship) (# Times)
* LeftShields (Ship) (# Times)
* TogglePrimaryB1 (Ship)
* TogglePrimaryB2 (Ship)
* ToggleSecondaryB1 (Ship)
* ToggleSecondaryB2 (Ship)
* ToggleSecondaryB3 (Ship)
* SetDoublePrimary (Ship)
* SetDoubleSecondary (Ship) (Bank)
* CounterDestroysMissile (Target Ship) (Firing Ship)

:* '''Supported By:''' [[The Sagitta Project]]

=== Include List of Completed Campaigns in Pilot File ===

When a Pilot begins a campaign, the name of this campaign is saved in the Pilot file along with an Integer at 0. If and when the Campaign is completed, 1 is added to the Integer. The Campaign and the number of completions can be viewed in the Barracks.

=== Persistent Impact Explosion Effects ===

When a weapon with this enabled hits its target, it will leave behind a sustained explosion effect to give more proper impression of damage to a target vessel. Explosion effects would be defined in the tables, with fields for explosion size, duration, effect, and an option for large explosion effects to have a series of smaller explosions along the perimeter to make it more convincing. Damage for beam weapons should be simple, with the exception of slasher types, since they don't create a continuous swath of damage. Persistent explosions could also be made to be created when subsystems are destroyed. Could tie in with damage decals if it ever gets implemented.

=== In-Game Microphone Chat ===

It would be nice to have this feature integrated into the multiplayer instead of having to run another program, such as TeamSpeak, in the background.

=== Sound Test ===

And/or music player. Both FS1 & 2 tracks. Accessible from the Tech Room.

== In Progress ==
=== Customizable ship types ===
Add a new table (or an addendum to ships.tbl) that would allow modders to turn on and off individual aspects of ship types, as well as define new ones. Type should be settable in the $Flags: variable, just as it is now, and the :V: defaults should be integrated so that they may be overriden by mods.
:* '''Supported By:''' [[The Babylon Project]], Twisted Infinities, [[Fringespace]]

== Partially Complete ==

=== Side Multipart Turrets ===
Support for fully rotating turrets on the sides of ships.
:* '''Supported By:''' [[Beyond the Red Line]], [[The Babylon Project]], [[Wing Commander Saga]], Nukemod - Children of Shiva, [[Star Wars Conversion|Fate of the Galaxy]]

'''Implemented. See [http://www.hard-light.net/forums/index.php/topic,43524.0.html Bobboau's Turret Build]''' ''However'', changes have since been put '''on hiatus''' due to code incompatibilites, in both stable and HEAD builds.

== Implemented ==

=== Flak Screen ===
Ability to set detonation range/time for flak shots so that flak weapons could fire at approaching ships beyond their 'detonation range' thus generating a flak screen in front of the approaching ships with the flak explosions. Preferably with little variance in the exact detonation time as there is always a little variance in normal flak explosions. Beams already support this sort of firing with +range: option. 
[[User:Wanderer|Wanderer]] 10:56, 9 Dec 2005 (GMT)
:* '''Supported By:''' The Apocalypse Project

=== Submodel Animation Triggers & Upgrades ===
*Afterburners - Performs animation when afterburners are used and undoes the anumation when they go off.
*Turret Fire - Performs animation when a particular turret is fired and undoes it before the turret can fire again.

=== Muzzle Flashes and Turrets ===
Extented support for muzzle flashes so that all turreted weapons could use the muzzle flashes.
:* '''Supported By:''' [[Starfox:_Shadows_of_Lylat|Shadows of Lylat]], Twisted Infinities, The Dark Space

=== Limited Sensor Range For Non-Primitive Sensors ===
Self-explanatory. Implemented, see [[SCP SEXPs#radar set max range|Radar set max range]]. [[User:Shade|Shade]] 23:52, 17 August 2007 (CDT)
:*'''Supported By:''' [[The Starforce Mod|Starforce]]

[[Category:Source Code Project]]

Frequently Asked Questions

2022-04-25T14:00:42Z

Z64555: Z64555 moved page Frequently Asked Questions to Frequently Asked Questions (FAQ): Rename for search bar to hit on common abbreviation

#REDIRECT [[Frequently Asked Questions (FAQ)]]

Frequently Asked Questions (FAQ)

2022-04-25T14:00:42Z

Z64555: Z64555 moved page Frequently Asked Questions to Frequently Asked Questions (FAQ): Rename for search bar to hit on common abbreviation

This page contains answers to questions that may be asked when playing newer versions of FSO. They are usually questions related to new behaviors not present in older version or vanilla FreeSpace, and are often questions that don't have a simple one-line answer.

===Why are my bindings back to defaults?===
If you created or played with a pilot on FSO 22.0 or later, your bindings were moved into files known as "presets" which are saved in a sub directory of your players folder.

'''Example:''' '''''C:\Users\z64555\AppData\Roaming\HardLightProductions\FreeSpaceOpen\data\players\presets'''''

The reason why your bindings are back to defaults in pre-22.0 version is because:

1. Older versions of FSO still require that the pilot have bindings in them, or else FSO will crash because it doesn't know how to handle a pilot with missing data.

2. To prevent having a new preset generated each time the same pilot is used across pre- and post-22.0 versions of FSO, the bindings within the pilot are forced to the defaults.
* The bindings that were originally saved are still safe within the '''''\presets''''' sub directory.

Related Github issue: [https://github.com/scp-fs2open/fs2open.github.com/issues/3902 Issue 3902]

===Why can't I use my pilot with different versions of FSO?===
Our pilot file handling code has improved over the years to allow new data to be added to the pilot file, but we still haven't managed to get it in a perfect state due to a lack of manpower and interest.

Pilot files might be still usable across different versions of FSO, but this can not be guaranteed at this point in time. When in doubt, it is always recommended that you make a clone of your pilot and use the clone for that version of FSO.

===Can I use multiple joysticks in FSO?===
As of FSO version 22.0, players are now able to assign up to 4 independent joysticks, gamepads, throttles, or game controllers; independently assign the mouse to controls; can assign a primary input binding and a secondary input binding from two different joysticks per control.

In order to make use of this capability, you must use a compatible launcher or manually set the joystick ID and GUID's within your '''fs2_open.ini''' file.

====Where is the fs2_open.ini file?====
This may be found within AppData.

'''Example:''' '''''C:\Users\z64555\AppData\Roaming\HardLightProductions\FreeSpaceOpen\fs2_open.ini'''''

====How do I assign my joysticks in the fs2_open.ini?====
Add the following keys to your .ini, underneath the '''[Default]''' section:

'''''Joy0ID='''''
'''''Joy0GUID='''''
'''''Joy1ID='''''
'''''Joy1GUID='''''
'''''Joy2ID='''''
'''''Joy2GUID='''''
'''''Joy3ID='''''
'''''Joy3GUID='''''

'''Joy0''' is effectively the same as '''CurrentJoystick'''

====Where do I get the Joystick ID's and GUID's?====
{{Note|For best reliability, the GUID's must be obtained from FSO itself, not from any other third-party app.}}

This is the most difficult part of manually assigning the joysticks, depending on your operating system and familiarity with command prompt/ shell. Essentially, you'll want to run FSO with the '''-get_flags json_v1''' commandline flag from the command prompt, power shell, or bash.

'''Example:''' '''''C;\Games\FreeSpaceOpen\fs2_open_22_0_0_x64_SSE2.exe -get_flags json_v1 > flags.txt'''''

Windows users will probably also need to set the '''FSO_KEEP_STDOUT''' environment variable, due to its tendency to shut down the STDOUT streams to console when the application is identified as a WINDOWS application (as opposed to a CONSOLE application), in which case they should try the following:

'''cmd /V /C "set FSO_KEEP_STDOUT=1&& fs2_open_22_0_0_x64_SSE2.exe -get_flags json_v1 > flags.txt"'''

Once you have a flags.txt file created, look for a section that looks like this:

{
"joysticks": [
{
"name": "Joystick Name",
"guid": "03000000EFBE00006D04000000000000",
"id": 0,
"device": 0
}
]
}

Use the "guid" and "id" key values to assign that joystick to Joy0, Joy1, Joy2, or Joy3 respectively.

Frequently Asked Questions (FAQ)

2022-02-09T19:21:26Z

Z64555: /* Can I use multiple joysticks in FSO? */

This page contains answers to questions that may be asked when playing newer versions of FSO. They are usually questions related to new behaviors not present in older version or vanilla FreeSpace, and are often questions that don't have a simple one-line answer.

===Why are my bindings back to defaults?===
If you created or played with a pilot on FSO 22.0 or later, your bindings were moved into files known as "presets" which are saved in a sub directory of your players folder.

'''Example:''' '''''C:\Users\z64555\AppData\Roaming\HardLightProductions\FreeSpaceOpen\data\players\presets'''''

The reason why your bindings are back to defaults in pre-22.0 version is because:

1. Older versions of FSO still require that the pilot have bindings in them, or else FSO will crash because it doesn't know how to handle a pilot with missing data.

2. To prevent having a new preset generated each time the same pilot is used across pre- and post-22.0 versions of FSO, the bindings within the pilot are forced to the defaults.
* The bindings that were originally saved are still safe within the '''''\presets''''' sub directory.

Related Github issue: [https://github.com/scp-fs2open/fs2open.github.com/issues/3902 Issue 3902]

===Why can't I use my pilot with different versions of FSO?===
Our pilot file handling code has improved over the years to allow new data to be added to the pilot file, but we still haven't managed to get it in a perfect state due to a lack of manpower and interest.

Pilot files might be still usable across different versions of FSO, but this can not be guaranteed at this point in time. When in doubt, it is always recommended that you make a clone of your pilot and use the clone for that version of FSO.

===Can I use multiple joysticks in FSO?===
As of FSO version 22.0, players are now able to assign up to 4 independent joysticks, gamepads, throttles, or game controllers; independently assign the mouse to controls; can assign a primary input binding and a secondary input binding from two different joysticks per control.

In order to make use of this capability, you must use a compatible launcher or manually set the joystick ID and GUID's within your '''fs2_open.ini''' file.

====Where is the fs2_open.ini file?====
This may be found within AppData.

'''Example:''' '''''C:\Users\z64555\AppData\Roaming\HardLightProductions\FreeSpaceOpen\fs2_open.ini'''''

====How do I assign my joysticks in the fs2_open.ini?====
Add the following keys to your .ini, underneath the '''[Default]''' section:

'''''Joy0ID='''''
'''''Joy0GUID='''''
'''''Joy1ID='''''
'''''Joy1GUID='''''
'''''Joy2ID='''''
'''''Joy2GUID='''''
'''''Joy3ID='''''
'''''Joy3GUID='''''

'''Joy0''' is effectively the same as '''CurrentJoystick'''

====Where do I get the Joystick ID's and GUID's?====
{{Note|For best reliability, the GUID's must be obtained from FSO itself, not from any other third-party app.}}

This is the most difficult part of manually assigning the joysticks, depending on your operating system and familiarity with command prompt/ shell. Essentially, you'll want to run FSO with the '''-get_flags json_v1''' commandline flag from the command prompt, power shell, or bash.

'''Example:''' '''''C;\Games\FreeSpaceOpen\fs2_open_22_0_0_x64_SSE2.exe -get_flags json_v1 > flags.txt'''''

Windows users will probably also need to set the '''FSO_KEEP_STDOUT''' environment variable, due to its tendency to shut down the STDOUT streams to console when the application is identified as a WINDOWS application (as opposed to a CONSOLE application), in which case they should try the following:

'''cmd /V /C "set FSO_KEEP_STDOUT=1&& fs2_open_22_0_0_x64_SSE2.exe -get_flags json_v1 > flags.txt"'''

Once you have a flags.txt file created, look for a section that looks like this:

{
"joysticks": [
{
"name": "Joystick Name",
"guid": "03000000EFBE00006D04000000000000",
"id": 0,
"device": 0
}
]
}

Use the "guid" and "id" key values to assign that joystick to Joy0, Joy1, Joy2, or Joy3 respectively.

Frequently Asked Questions (FAQ)

2022-02-09T18:53:57Z

Z64555: formatting

This page contains answers to questions that may be asked when playing newer versions of FSO. They are usually questions related to new behaviors not present in older version or vanilla FreeSpace, and are often questions that don't have a simple one-line answer.

===Why are my bindings back to defaults?===
If you created or played with a pilot on FSO 22.0 or later, your bindings were moved into files known as "presets" which are saved in a sub directory of your players folder.

'''Example:''' '''''C:\Users\z64555\AppData\Roaming\HardLightProductions\FreeSpaceOpen\data\players\presets'''''

The reason why your bindings are back to defaults in pre-22.0 version is because:

1. Older versions of FSO still require that the pilot have bindings in them, or else FSO will crash because it doesn't know how to handle a pilot with missing data.

2. To prevent having a new preset generated each time the same pilot is used across pre- and post-22.0 versions of FSO, the bindings within the pilot are forced to the defaults.
* The bindings that were originally saved are still safe within the '''''\presets''''' sub directory.

Related Github issue: [https://github.com/scp-fs2open/fs2open.github.com/issues/3902 Issue 3902]

===Why can't I use my pilot with different versions of FSO?===
Our pilot file handling code has improved over the years to allow new data to be added to the pilot file, but we still haven't managed to get it in a perfect state due to a lack of manpower and interest.

Pilot files might be still usable across different versions of FSO, but this can not be guaranteed at this point in time. When in doubt, it is always recommended that you make a clone of your pilot and use the clone for that version of FSO.

===Can I use multiple joysticks in FSO?===
As of FSO version 22.0, players are now able to assign up to 4 independent joysticks/controllers, independently assign the mouse to controls, and can assign a primary input binding and a secondary input binding from two different joysticks per control.

In order to make use of this capability, you must use a compatible launcher or manually set the joystick ID and GUID's within your '''fs2_open.ini''' file.

====Where is the fs2_open.ini file?====
This may be found within AppData.

'''Example:''' '''''C:\Users\z64555\AppData\Roaming\HardLightProductions\FreeSpaceOpen\fs2_open.ini'''''

====How do I assign my joysticks in the fs2_open.ini?====
Add the following keys to your .ini, underneath the '''[Default]''' section:

'''''Joy0ID='''''
'''''Joy0GUID='''''
'''''Joy1ID='''''
'''''Joy1GUID='''''
'''''Joy2ID='''''
'''''Joy2GUID='''''
'''''Joy3ID='''''
'''''Joy3GUID='''''

'''Joy0''' is effectively the same as '''CurrentJoystick'''

====Where do I get the Joystick ID's and GUID's?====
{{Note|For best reliability, the GUID's must be obtained from FSO itself, not from any other third-party app.}}

This is the most difficult part of manually assigning the joysticks, depending on your operating system and familiarity with command prompt/ shell. Essentially, you'll want to run FSO with the '''-get_flags json_v1''' commandline flag from the command prompt, power shell, or bash.

'''Example:''' '''''C;\Games\FreeSpaceOpen\fs2_open_22_0_0_x64_SSE2.exe -get_flags json_v1 > flags.txt'''''

Windows users will probably also need to set the '''FSO_KEEP_STDOUT''' environment variable, due to its tendency to shut down the STDOUT streams to console when the application is identified as a WINDOWS application (as opposed to a CONSOLE application), in which case they should try the following:

'''cmd /V /C "set FSO_KEEP_STDOUT=1&& fs2_open_22_0_0_x64_SSE2.exe -get_flags json_v1 > flags.txt"'''

Once you have a flags.txt file created, look for a section that looks like this:

{
"joysticks": [
{
"name": "Joystick Name",
"guid": "03000000EFBE00006D04000000000000",
"id": 0,
"device": 0
}
]
}

Use the "guid" and "id" key values to assign that joystick to Joy0, Joy1, Joy2, or Joy3 respectively.

Frequently Asked Questions (FAQ)

2022-02-09T18:53:08Z

Z64555: Formatting; Add FAQs for multi-joy.

This page contains answers to questions that may be asked when playing newer versions of FSO. They are usually questions related to new behaviors not present in older version or vanilla FreeSpace, and are often questions that don't have a simple one-line answer.

===Why are my bindings back to defaults?===
If you created or played with a pilot on FSO 22.0 or later, your bindings were moved into files known as "presets" which are saved in a sub directory of your players folder.

'''Example:''' '''''C:\Users\z64555\AppData\Roaming\HardLightProductions\FreeSpaceOpen\data\players\presets'''''

The reason why your bindings are back to defaults in pre-22.0 version is because:

1. Older versions of FSO still require that the pilot have bindings in them, or else FSO will crash because it doesn't know how to handle a pilot with missing data.

2. To prevent having a new preset generated each time the same pilot is used across pre- and post-22.0 versions of FSO, the bindings within the pilot are forced to the defaults.
* The bindings that were originally saved are still safe within the '''''\presets''''' sub directory.

Related Github issue: [https://github.com/scp-fs2open/fs2open.github.com/issues/3902 Issue 3902]

===Why can't I use my pilot with different versions of FSO?===
Our pilot file handling code has improved over the years to allow new data to be added to the pilot file, but we still haven't managed to get it in a perfect state due to a lack of manpower and interest.

Pilot files might be still usable across different versions of FSO, but this can not be guaranteed at this point in time. When in doubt, it is always recommended that you make a clone of your pilot and use the clone for that version of FSO.

===Can I use multiple joysticks in FSO?===
As of FSO version 22.0, players are now able to assign up to 4 independent joysticks/controllers, independently assign the mouse to controls, and can assign a primary input binding and a secondary input binding from two different joysticks per control.

In order to make use of this capability, you must use a compatible launcher or manually set the joystick ID and GUID's within your '''fs2_open.ini''' file.

====Where is the fs2_open.ini file?====
This may be found within AppData.

'''Example:''' '''''C:\Users\z64555\AppData\Roaming\HardLightProductions\FreeSpaceOpen\fs2_open.ini'''''

====How do I assign my joysticks in the fs2_open.ini?====
Add the following keys to your .ini, underneath the '''[Default]''' section:

'''''Joy0ID='''''
'''''Joy0GUID='''''
'''''Joy1ID='''''
'''''Joy1GUID='''''
'''''Joy2ID='''''
'''''Joy2GUID='''''
'''''Joy3ID='''''
'''''Joy3GUID='''''

'''Joy0''' is effectively the same as '''CurrentJoystick'''

====Where do I get the Joystick ID's and GUID's?====
{{Note|For best reliability, the GUID's must be obtained from FSO itself, not from any other third-party app.}}

This is the most difficult part of manually assigning the joysticks, depending on your operating system and familiarity with command prompt/ shell. Essentially, you'll want to run FSO with the '''-get_flags json_v1''' commandline flag from the command prompt, power shell, or bash.

'''Example:''' '''''C;\Games\FreeSpaceOpen\fs2_open_22_0_0_x64_SSE2.exe -get_flags json_v1 > flags.txt'''''

Windows users will probably also need to set the '''FSO_KEEP_STDOUT''' environment variable, due to its tendency to shut down the STDOUT streams to console when the application is identified as a WINDOWS application (as opposed to a CONSOLE application), in which case they should try the following:

'''cmd /V /C "set FSO_KEEP_STDOUT=1&& fs2_open_22_0_0_x64_SSE2.exe -get_flags json_v1 > flags.txt"'''

Once you have a flags.txt file created, look for a section that looks like this:

{
"joysticks": [
{
"name": "Joystick Name",
"guid": "03000000EFBE00006D04000000000000",
"id": 0,
"device": 0
}
]
}

Use the "guid" and "id" key values to assign that joystick to Joy0, Joy1, Joy2, or Joy3 respectively.

Template:Main nav

2022-02-09T18:03:07Z

Z64555: add link to FAQ page

{| border=0 align=right cellpadding=4 cellspacing=0 width=20% style="margin: 0 0 1em 1em; background: #302020; border: 1px #AA2020 solid; border-collapse: collapse; font-size: 95%;"
! style="color: white; height: 30px; background: #512020; 70%;"|''Retail FreeSpace''
|-
| [[Getting started|Introduction]]
|-
| [[Portal:FreeSpace 1|FreeSpace 1]]
|-
| [[Portal:FreeSpace 2|FreeSpace 2]]
|-
! style="color: white; height: 30px; background: #512020; 70%;"|''FreeSpace Source Code Project''
|-
| [[Getting Started (FreeSpace Open)|Getting Started]]
|-
| [[Installing Mods for FS2 Open|Mod installation instructions]]
|-
| [[SCP_Additions|List of added capabilities]]
|-
| [[Portal:Multiplayer|Multiplayer]]
|-
| [[Command-Line_Reference|Command-Line Reference]]
|-
| [[Development_Reference|Development Reference]]
|-
| [[Feature Requests|Feature Requests]]
|-
| [[Screenshots]]
|-
| [[Frequently Asked Questions]]
|-
! style="color: white; height: 30px; background: #512020; 70%;"|''Modding FreeSpace''
|-
| [[Portal:Modding|Modding Portal]]
|-
| [[Mod Database]]
|-
| [[Portal:FRED|FRED]]
|-
| [[Campaign List|User-made Campaigns]]
|-
| [[User-made Ships|User-made Ships]]
|-
| [[User-Made Weapons|User-made Weapons]]
|-
| [[Total conversions|Total Conversions]]
|-
! style="color: white; height: 30px; background: #512020; 70%;"|''FreeSpace Universe''
|-
| [[Portal:FreeSpace Universe|The Universe]]
|-
! style="color: white; height: 30px; background: #512020; 70%;"|''Other''
|-
| [[:Category:Campaign Walkthroughs|Campaign Walkthroughs]]
|-
| [[Various Terms|FreeSpace Jargon]]
|-
| [[FreeSpace Alpha]]
|-
| [[Freespace_Wiki:Community_Portal|FreeSpace Community]]
|-
| [[Getting FreeSpace]]
|-
| [[Guide to FS Open on Linux]]
|-
! style="color: white; height: 30px; background: #462424; 70%;"|Alternately, explore the '''FreeSpace''' universe through ''[[:Category:Main|categories]].''
|-
|}

<noinclude>[[Category:Templates|Main nav]]</noinclude>

Frequently Asked Questions (FAQ)

2022-02-06T16:58:45Z

Z64555: added section - Why can't I use my pilot with different versions

==Why are my bindings back to defaults?==
If you created or played with a pilot on FSO 22.0 or later, your bindings were moved into files known as "presets" which are saved in a sub directory of your players folder.

'''Example:''' '''''C:\Users\z64555\AppData\Roaming\HardLightProductions\FreeSpaceOpen\data\players\presets'''''

The reason why your bindings are back to defaults in pre-22.0 version is because:

1. Older versions of FSO still require that the pilot have bindings in them, or else FSO will crash because it doesn't know how to handle a pilot with missing data.

2. To prevent having a new preset generated each time the same pilot is used across pre- and post-22.0 versions of FSO, the bindings within the pilot are forced to the defaults.
* The bindings that were originally saved are still safe within the '''''\presets''''' sub directory.

Related Github issue: [https://github.com/scp-fs2open/fs2open.github.com/issues/3902 Issue 3902]

==Why can't I use my pilot with different versions of FSO?==
Our pilot file handling code has improved over the years to allow new data to be added to the pilot file, but we still haven't managed to get it in a perfect state due to a lack of manpower and interest.

Pilot files might be still usable across different versions of FSO, but this can not be guaranteed at this point in time. When in doubt, it is always recommended that you make a clone of your pilot and use the clone for that version of FSO.

Frequently Asked Questions (FAQ)

2022-01-23T00:22:55Z

Z64555: Actually fix link

Frequently Asked Questions (FAQ)

2022-01-23T00:22:11Z

Z64555: Fix link

Frequently Asked Questions (FAQ)

2022-01-22T23:58:59Z

Z64555: added related github issue link

Frequently Asked Questions (FAQ)

2022-01-22T23:58:05Z

Z64555: Created page with "==Why are my bindings back to defaults?== If you created or played with a pilot on FSO 22.0 or later, your bindings were moved into files known as "presets" which are saved in..."

Bug Reporting

2021-08-12T02:56:46Z

Z64555: /* Basic Guidelines */ Edit again. Email isn't necessary since the issue tracker has ability for discussion. Also add discord link

== Places to ask about or report bugs ==

* All new bugs are submitted here:
**[https://github.com/scp-fs2open/fs2open.github.com/issues GitHub issues page]

* If you want to ask about bugs, you can do so on the forums:
**[https://www.hard-light.net/forums/index.php/board,50.0.html FSSCP Forums]

== Basic Guidelines ==

# Look before you leap - make sure there isn't a similar bug before you post a new one. If there is a similar bug, post info on your particular circumstance.
# ALWAYS post what build you're using (If it's named something like "fs2_open_r", post where you got it from and what date it was posted).
# ALWAYS post what command lines you're using (And which ones the bug happens with).
# ALWAYS post what graphics options you are using (OpenGL/D3D).
# Don't just post the bug. Post any and all relevant info, and if you aren't sure if something might be relevant - post it anyway.
# If at all possible, please post contact info in the form of a Discord handle. The Github Issue tracker does well for keeping relevant information about bugs stapled to the bug report, but sometimes a real-time conversation on [https://discord.gg/QFdueKEYrN Discord] is best.
# If you've got the time, run a debug build and post any errors you get with it (Not all builds have a debug build with them though).
# Keep track of any bugs you post (in)! Nothing is more annoying than not being able to close a bug simply because you don't know if it's solved or not.
# Make sure to include what mediaVPs you're using.

== Error logs ==

Especially when using debug builds, FreeSpace 2 will generate files called "errorlog.txt" and more importantly "fs2_open.log" (new version of older "fs.log").

=== fs.log OR fs2_open.log ===

These files - "fs.log" and "fs2_open.log" - are generally the same except the later is renamed and is placed into the main data directory instead of the root FreeSpace 2 directory (where the "fs.log" is placed)
 
Debug build builds new "fs2_open.log" file every time its run - even when there is no problems encountered - so make sure to gather the relevant data before running the debug build again. Posting the last five lines or so of "fs2_open.log" can be handy. Note that Notepad will not display it properly, so you'll have to open it up in Wordpad to view it properly. Posting the "fs2_open.log" in its full extent is not very useful as it contains a lot of information that debug build reports there.
 
In some cases it also helps to create an empty text file named "[[debug_filter.cfg]]" to the '''data''' directory under the 'root' FreeSpace 2 directory and then recreate the "fs2_open.log" file (that is to run debug build again) - with older "fs.log" file the "[[debug_filter.cfg]]" ought to be placed into 'root' FreeSpace 2 directory. This causes the debug build to gather a lot more data into the "fs2_open.log" file which may prove useful for debugging the actual issues. The "fs2_open.log" files created with "debug_filter.cfg" in use are easily over a megabyte in size often will not even open in Notepad.
 
If you read the "fs2_open.log" file you may notice problematic sections by yourself as well but in general '''do not post the whole "fs2_open.log"''' file - just the last five or so lines. There are also other very important sections in the "fs2_open.log" file that may help in identifying the issues. Like the section that begins with '''Building file index...''' (search for this) and ends to '''Found 21 roots and 12326 files''' (numbers may vary) as it contains information of all the various vp files the game loads. Also other sections like OpenAL initialization or OpenGL/D3D initialization may be of some use

=== errorlog.txt ===

Posting the first chunk of data from the corresponding entry in errorlog.txt can be a big help, as it may tell the dev exactly what went wrong where. (This chunk is recognizable, as it should have the date and time that the crash occured).
 
Most recent 'crash report' is the last one that has been listed into the "errorlog.txt". If you encounter the crash repeatedly you might want to first remove the "errorlog.txt" file from the 'root' FreeSpace 2 directory and then run the game again. Then you get only single entry to the "errorlog.txt".
 
Often the only useful information from the "errorlog.txt" is found from the first line of the corresponding entry.

==== Example ====

*The first chunk from a "errorlog.txt" entry

<pre>fs2_open_r-P4 caused an Illegal Instruction in module fs2_open_r-P4.exe at 001b:005f11b7.
Exception handler called in FreeSpace 2 Main Thread.
Error occurred at 1/14/2007 15:17:32.
E:\Games\FreeSpace2\fs2_open_r-P4.exe, run by Unknown.
1 processor(s), type 586.
1024 MBytes physical memory.</pre>

*The first line - in this case '''fs2_open_r-P4 caused an Illegal Instruction in module fs2_open_r-P4.exe at 001b:005f11b7.''' - tells something about the error that occurred. It is also the line that ought to be included into to the error/bug reports.

[[Category:Source Code Project]]

Bug Reporting

2021-08-12T02:51:48Z

Z64555: /* Basic Guidelines */ Replace ICQ guideline with Discord and/or email.

== Places to ask about or report bugs ==

* All new bugs are submitted here:
**[https://github.com/scp-fs2open/fs2open.github.com/issues GitHub issues page]

* If you want to ask about bugs, you can do so on the forums:
**[https://www.hard-light.net/forums/index.php/board,50.0.html FSSCP Forums]

== Basic Guidelines ==

# Look before you leap - make sure there isn't a similar bug before you post a new one. If there is a similar bug, post info on your particular circumstance.
# ALWAYS post what build you're using (If it's named something like "fs2_open_r", post where you got it from and what date it was posted).
# ALWAYS post what command lines you're using (And which ones the bug happens with).
# ALWAYS post what graphics options you are using (OpenGL/D3D).
# Don't just post the bug. Post any and all relevant info, and if you aren't sure if something might be relevant - post it anyway.
# If at all possible, please post contact info in the form of a Discord handle or email address.
# If you've got the time, run a debug build and post any errors you get with it (Not all builds have a debug build with them though).
# Keep track of any bugs you post (in)! Nothing is more annoying than not being able to close a bug simply because you don't know if it's solved or not.
# Make sure to include what mediaVPs you're using.

== Error logs ==

Especially when using debug builds, FreeSpace 2 will generate files called "errorlog.txt" and more importantly "fs2_open.log" (new version of older "fs.log").

=== fs.log OR fs2_open.log ===

These files - "fs.log" and "fs2_open.log" - are generally the same except the later is renamed and is placed into the main data directory instead of the root FreeSpace 2 directory (where the "fs.log" is placed)
 
Debug build builds new "fs2_open.log" file every time its run - even when there is no problems encountered - so make sure to gather the relevant data before running the debug build again. Posting the last five lines or so of "fs2_open.log" can be handy. Note that Notepad will not display it properly, so you'll have to open it up in Wordpad to view it properly. Posting the "fs2_open.log" in its full extent is not very useful as it contains a lot of information that debug build reports there.
 
In some cases it also helps to create an empty text file named "[[debug_filter.cfg]]" to the '''data''' directory under the 'root' FreeSpace 2 directory and then recreate the "fs2_open.log" file (that is to run debug build again) - with older "fs.log" file the "[[debug_filter.cfg]]" ought to be placed into 'root' FreeSpace 2 directory. This causes the debug build to gather a lot more data into the "fs2_open.log" file which may prove useful for debugging the actual issues. The "fs2_open.log" files created with "debug_filter.cfg" in use are easily over a megabyte in size often will not even open in Notepad.
 
If you read the "fs2_open.log" file you may notice problematic sections by yourself as well but in general '''do not post the whole "fs2_open.log"''' file - just the last five or so lines. There are also other very important sections in the "fs2_open.log" file that may help in identifying the issues. Like the section that begins with '''Building file index...''' (search for this) and ends to '''Found 21 roots and 12326 files''' (numbers may vary) as it contains information of all the various vp files the game loads. Also other sections like OpenAL initialization or OpenGL/D3D initialization may be of some use

=== errorlog.txt ===

Posting the first chunk of data from the corresponding entry in errorlog.txt can be a big help, as it may tell the dev exactly what went wrong where. (This chunk is recognizable, as it should have the date and time that the crash occured).
 
Most recent 'crash report' is the last one that has been listed into the "errorlog.txt". If you encounter the crash repeatedly you might want to first remove the "errorlog.txt" file from the 'root' FreeSpace 2 directory and then run the game again. Then you get only single entry to the "errorlog.txt".
 
Often the only useful information from the "errorlog.txt" is found from the first line of the corresponding entry.

==== Example ====

*The first chunk from a "errorlog.txt" entry

<pre>fs2_open_r-P4 caused an Illegal Instruction in module fs2_open_r-P4.exe at 001b:005f11b7.
Exception handler called in FreeSpace 2 Main Thread.
Error occurred at 1/14/2007 15:17:32.
E:\Games\FreeSpace2\fs2_open_r-P4.exe, run by Unknown.
1 processor(s), type 586.
1024 MBytes physical memory.</pre>

*The first line - in this case '''fs2_open_r-P4 caused an Illegal Instruction in module fs2_open_r-P4.exe at 001b:005f11b7.''' - tells something about the error that occurred. It is also the line that ought to be included into to the error/bug reports.

[[Category:Source Code Project]]

Controlconfigdefaults.tbl

2021-03-21T18:47:15Z

Z64555: /* $Key Default: */ get fancy template action and dating

Controlconfigdefaults.tbl

2021-03-21T18:36:09Z

Z64555: /* $Key Default: */ Added "NONE" as valid entry. This feature was added by zookeeper back in 2015...

Controlconfigdefaults.tbl

2021-02-13T22:03:06Z

Z64555: /* +Disable */ Whoops, enable on specification hasn't been put in yet

Controlconfigdefaults.tbl

2021-02-13T22:02:19Z

Z64555: /* Custom Controls */

Controlconfigdefaults.tbl

2021-02-13T21:51:37Z

Z64555: /* Custom Controls */ correct placement of Table tag

Controlconfigdefaults.tbl

2021-02-13T21:50:49Z

Z64555: /* +Disable */ correct version

Controlconfigdefaults.tbl

2021-02-13T21:49:10Z

Z64555: Document 'Controls 2' changes

Controlconfigdefaults.tbl

2021-02-13T20:43:20Z

Z64555: /* $Name: */

{{TableVersion|7478}}
{{Tables}}
The '''controlconfigdefaults.tbl''' can be used to modify the default key bindings in FSO.

==General Format==
*Begins with '''#ControlConfigOverride''' and ends with '''#End'''.
*Only entries that you want to change are required.
*Entries not listed will be assigned to their default/hardcoded values.
{{Table371|
Multiple #ControlConfigOverride...#End blocks can be provided. In this case, each block defines a separate control config preset, and the "Defaults" button in the control config screen can be used to cycle through them. This can be used to provide multiple pre-defined control schemes for the player to choose from (or base their personal modifications on). If used, it's a good idea to also use [[Strings.tbl]] to change the "Defaults" text to for example "Cycle\nPresets".

The first given block is used as the "global" defaults, used for example when working with the key-pressed SEXP in FRED.}}

===$Name:===
{{Table373|
*The name of this control config preset, displayed at the top left corner of the control config screen when selected through the "Defaults" button.
* If not provided, the first preset is assumed to be overrides for the defaults, all subsequent presets will be <unnamed preset>.
**Syntax: '''''String'''''
}}

==$Bind Name:==
*Name of the bind or action to modify the default key of.
*Valid entries: [[Controlconfigdefaults.tbl#List of Bindings|List of Bindings]]
*Required
*Syntax: '''String'''

===$Key Default:===
*Key to set as default
*Valid entries: [[Controlconfigdefaults.tbl#Allowed Keys|Allowed Keys]]
*Optional
*Syntax: '''String'''

===$Joy Default:===
*Joystick button to set as default
*Optional
*Syntax: '''Integer'''

===$Key Mod Shift:===
*Sets the key to require the Shift key
*'''1''' for yes, '''0''' for no
*Optional
*Syntax: '''Integer'''
===$Key Mod Alt:===

*Sets the key to require the Alt key
*'''1''' for yes, '''0''' for no
*Optional
*Syntax: '''Integer'''

===$Key Mod Ctrl:===
*Sets the key to require the Ctrl key
*'''1''' for yes, '''0''' for no
*Optional
*Syntax: '''Integer'''

===$Category:===
*Tab where the binding appears in the options menu.
*Valid entries: TARGET_TAB, SHIP_TAB, WEAPON_TAB, COMPUTER_TAB
*Optional
*Syntax: '''String'''

===$Has XStr:===
*Whether or not the binding has an entry in [[strings.tbl]]
*'''1''' for yes, '''0''' for no
{{Table382|
Now the index within [[strings.tbl]] can also be specified, though the index must be > 1. For example, '''$Has XStr: 1570''' will use the string index 1570 instead of the default string index.
}}
*Optional
*Syntax: '''Integer'''

===$Type:===
Determines the type of control this is.

Valid entries:
*CC_TYPE_TRIGGER
**Normal control that activates upon the first press. Resetting devices (such as weapons) will keep firing as long as the key/button is held down.
*CC_TYPE_CONTINUOUS
**Control that activates when the key/button is held down, and stays activated until the key/button is released. Ex: Afterburner key.
*Optional
*Syntax '''String'''

===$Disable:===
{{Table373|
*Determines whether the binding can be used and appears in the options menu. Can be used to hide bindings which are not needed, or to enable bindings which are hidden by default.
**Syntax: '''''Boolean'''''
}}

==Sample==
This example does the following...
*Sets Clear Escort List to Alt-Shift-Q
*Sets Target Target's Attacker to Ctrl-Alt-Shift-J, moves it to the Ship Tab, denotes it's type as a trigger and sets it to not have a XString
*Sets Transfer Energy from Shield to Laser to R

<pre>
#ControlConfigOverride

$Bind Name: Clear Escort List
$Key Default: KEY_Q
$Key Mod Shift: 1
$Key Mod Alt: 1

$Bind Name: Target Target's Nearest Attacker
$Key Default: KEY_J
$Key Mod Shift: 1
$Key Mod Alt: 1
$Key Mod Ctrl: 1
$Category: SHIP_TAB
$Has XStr: 0
$TYPE: CC_TYPE_TRIGGER

$Bind Name: Transfer Energy Shield->Laser
$Key Default: KEY_R

#End
</pre>

==List of Bindings==
*This is a list of all possible bindings that can be modified.
*Must use the string below (without quotes).
*These bindings are case-sensitive

===Targeting Ships and Objects===
*'Target Next Ship'
*'Target Previous Ship'
*'Target Next Closest Hostile Ship'
*'Target Previous Closest Hostile Ship'
*'Target Next Closest Friendly Ship'
*'Target Previous Closest Friendly Ship'
*'Target Ship in Reticle'
*'Target Target's Nearest Attacker'
*'Target Last Ship to Send Transmission'
*'Turn Off Targeting'
*'Target Closest Attacking Ship'
*'Target Next Escort Ship'
*'Target Closest Repair Ship'
*'Target Next Uninspected Cargo'
*'Target Previous Uninspected Cargo'
*'Target Newest Ship in Area'
*'Target Target's Target'
*'Target Next Hostile Bomb or Bomber'
*'Target Previous Hostile Bomb or Bomber'

===Targeting Subsystems and Turrets===
*'Target Subsystem in Reticle'
*'Target Next Subsystem'
*'Target Previous Subsystem'
*'Turn Off Targeting of Subsystems'
*'Target Next Live Turret'
*'Target Previous Live Turret'

===Weapons===
*'Fire Primary Weapon'
*'Fire Secondary Weapon'
*'Cycle Forward Primary Weapon'
*'Cycle Backward Primary Weapon'
*'Cycle Secondary Weapon Bank'
*'Cycle Secondary Weapon Firing Rate'
*'Launch Countermeasure'

===Controls===
*'Forward Thrust'
*'Reverse Thrust'
*'Bank Left'
*'Bank Right'
*'Pitch Forward'
*'Pitch Backward'
*'Turn Left'
*'Turn Right'
*'Right Thrust'
*'Left Thrust'
*'Up Thrust'
*'Down Thrust'
*'Afterburner'
*'Glide When Pressed'
*'Bank When Pressed'
*'Match Target Speed'

===Throttle Control===
*'Set Throttle to Zero'
*'Set Throttle to Max'
*'Set Throttle to One-Third'
*'Set Throttle to Two-Thirds'
*'Increase Throttle 5 Percent'
*'Decrease Throttle 5 Percent'

===HUD Controls===
*'Toggle High HUD Contrast'
*'Toggle HUD'
*'Toggle HUD Wireframe Target View'
*'Cycle Radar Range'
*'Communications Menu'
*'Show Nav Map
*'Add or Remove Escort'
*'Clear Escort List'

===Squadmate Messaging===
*'Attack My Target'
*'Disarm My Target'
*'Disable My Target'
*'Attack My Subsystem'
*'Capture My Target'
*'Engage Enemy'
*'Form on My Wing'
*'Ignore My Target'
*'Protect My Target'
*'Cover Me'
*'Return to Base'
*'Rearm Me'

===Views===
*'Chase View'
*'External View'
*'Toggle External Camera Lock'
*'Free Look View'
*'Current Target View'
*'Increase View Distance'
*'Decrease View Distance'
*'Center View'
*'View Up'
*'View Rear'
*'View Left'
*'View Right
*'Top-Down View'
*'Target Padlock View'

===ETS and Shields===
*'Increase Weapon Energy'
*'Decrease Weapon Energy'
*'Increase Shield Energy'
*'Decrease Shield Energy'
*'Increase Engine Energy'
*'Decrease Engine Energy'
*'Equalize Energy Settings'
*'Equalize Shields'
*'Augment Forward Shield'
*'Augment Rear Shield'
*'Augment Left Shield'
*'Augment Right Shield'
*'Transfer Energy Laser->Shield'
*'Transfer Energy Shield->Laser'

===Misc===
*'Enter Subspace (End Mission)'
*'Increase Time Compression'
*'Decrease Time Compression'
*'Toggle Auto Pilot'
*'Cycle Nav Points'
*'Toggle Gliding'
*'Toggle Auto Speed Matching'
*'Toggle Auto Targeting'

===Multiplayer Only===
*'(Multiplayer) Message All'
*'(Multiplayer) Message Friendly'
*'(Multiplayer) Message Hostile'
*'(Multiplayer) Message Target'
*'(Multiplayer) Observer Zoom To Target'
*'(Multiplayer) Toggle Network info'
*'(Multiplayer) Self Destruct'

{{Table382|
===Custom Controls===
*'Custom Control 1'
*'Custom Control 2'
*'Custom Control 3'
*'Custom Control 4'
*'Custom Control 5'
These are empty controls for modders and/or scripters to use. They are disabled by default and no default index in [[strings.tbl]]. The default key binding is Shift-Alt (1-5) for Custom Control 1-5, respectively. To use these, create a new entry in [[Controlconfigdefaults.tbl]] and with the respective name. For example, '''$Bind Name: Custom Control 1''' for Custom Control 1. To change the string add a string entry to [[strings.tbl]] and specify that index in '''$Has XStr:''' for Custom Control 1. For example, if you add string 1570 for this key binding set '''$Has XStr: 1570'''.

The complete entry of this example would be:
* $Bind Name: Custom Control 1
* $Has XStr: 1570
}}

==Allowed Keys==
*Not all keys are checked by FSO for key bindings, so some of these may not work.
*List coppied from controlsconfigcommon.cpp and edited to make readable.
*Must use the string below (without quotes).
*List of keys
:'KEY_0'
:'KEY_1'
:'KEY_2'
:'KEY_3'
:'KEY_4'
:'KEY_5'
:'KEY_6'
:'KEY_7'
:'KEY_8'
:'KEY_9'
:'KEY_A'
:'KEY_B'
:'KEY_C'
:'KEY_D'
:'KEY_E'
:'KEY_F'
:'KEY_G'
:'KEY_H'
:'KEY_I'
:'KEY_J'
:'KEY_K'
:'KEY_L'
:'KEY_M'
:'KEY_N'
:'KEY_O'
:'KEY_P'
:'KEY_Q'
:'KEY_R'
:'KEY_S'
:'KEY_T'
:'KEY_U'
:'KEY_V'
:'KEY_W'
:'KEY_X'
:'KEY_Y'
:'KEY_Z'
:'KEY_MINUS'
:'KEY_EQUAL'
:'KEY_DIVIDE'
:'KEY_SLASH'
:'KEY_SLASH_UK'
:'KEY_COMMA'
:'KEY_PERIOD'
:'KEY_SEMICOL'
:'KEY_LBRACKET'
:'KEY_RBRACKET'
:'KEY_RAPOSTRO'
:'KEY_LAPOSTRO'
:'KEY_ESC'
:'KEY_ENTER'
:'KEY_BACKSP'
:'KEY_TAB'
:'KEY_SPACEBAR'
:'KEY_NUMLOCK'
:'KEY_SCROLLOCK'
:'KEY_CAPSLOCK'
:'KEY_LSHIFT'
:'KEY_RSHIFT'
:'KEY_LALT'
:'KEY_RALT'
:'KEY_LCTRL'
:'KEY_RCTRL'
:'KEY_F1'
:'KEY_F2'
:'KEY_F3'
:'KEY_F4'
:'KEY_F5'
:'KEY_F6'
:'KEY_F7'
:'KEY_F8'
:'KEY_F9'
:'KEY_F10'
:'KEY_F11'
:'KEY_F12'
:'KEY_PAD0'
:'KEY_PAD1'
:'KEY_PAD2'
:'KEY_PAD3'
:'KEY_PAD4'
:'KEY_PAD5'
:'KEY_PAD6'
:'KEY_PAD7'
:'KEY_PAD8'
:'KEY_PAD9'
:'KEY_PADMINUS'
:'KEY_PADPLUS'
:'KEY_PADPERIOD'
:'KEY_PADDIVIDE'
:'KEY_PADMULTIPLY'
:'KEY_PADENTER'
:'KEY_INSERT'
:'KEY_HOME'
:'KEY_PAGEUP'
:'KEY_DELETE'
:'KEY_END'
:'KEY_PAGEDOWN'
:'KEY_UP'
:'KEY_DOWN'
:'KEY_LEFT'
:'KEY_RIGHT'
:'KEY_PRINT_SCRN'
:'KEY_PAUSE'
:'KEY_BREAK'

[[Category:Tables]]

Hud gauges.tbl

2020-12-18T00:46:14Z

Z64555: /* +Radar: */ Add N-gon stuff

{{SCP table}}
{{TableVersionGit|2016-09-14|f9bc01c}}
{{Tables}}
The '''hud_gauges.tbl''' is used for modifying the elements of the HUD. Not all gauges can be modified. However, custom gauges may be added to mimic their behavior (such as the wingman status display).

HUD Elements in FS2 are called Gauges, and each gauge has various options to customize appearance and, in some cases, their behavior as well.

This table is one of the [[Modular Tables]] and can be extended with xxx-hdg.tbm

==HUD Configurations==
The following entries are used on the HUD system, but have not been grouped with any particular gauge.

===$Load Retail Configuration:===
Optional. If yes, any gauge missing from the HUD gauge definitions below will be loaded using the retail defaults.

If no, any missing (default) gauge will prompt an error.

*Syntax: '''Boolean'''

===$Color:===
Optional. Sets the default HUD color for all gauges.

*Syntax: ('''Integer''' Red, '''Integer''' Green, '''Integer''' Blue)
*Valid Values: all values from 0 to 255

===$Font:===
Optional. Sets the font type to use for the HUD. This can either be a string or a number. A string references a font with a specific name while a number references a font with a specific index in the fonts table. The number option is deprecated and is only there for backwards-compatibility. Use the name if possible.

*Syntax: '''String''' or '''Integer''' font index number
*Valid Values: Any name or font index as defined in [[Fonts.tbl]]

===$Chase View Only:===
{{Table381|
Optional. Sets gauges to be displayed only in Chase View.

*Syntax: '''Boolean'''
*Default Value: '''False'''
}}

===$Max Directives:===
Optional. Sets the default maximum number of directives displayed simultaneously.

*Syntax: '''Integer''' maximum number of directives
*Valid Values: Any positive number
*Default Value: '''5'''

===$Max Escort Ships:===
Optional. Sets the default maximum number of escort ships to be shown in the escort list.

*Syntax: '''Integer'''
*Valid Values: Any positive number
{{Warning|
Entries more than 16 will cause the list to overflow into the weapons list for resolutions lower than 1024x768.}}

===$Length Unit Multiplier:===
Optional. Sets the multiplier to applied to the reported distances. For example, if the multiplier is 0.5, then the distance reported to the player will (or at least should) be 0.5 x actual distance.

*Syntax: '''Float'''
*Valid Values: Any positive number

===$Speed Unit Multiplier:===
Optional. Analogous to [[Hud_gauges.tbl#$Length Unit Multiplier:|$Length Unit Multiplier]], this sets the multiplier to be applied to all speeds reported to the player. For example, if the multiplier is 0.5, the the speed reported to the player will (or at least should) be 0.5 x actual speed.

*Syntax: '''Float'''
*Valid Values: Any positive number
*Default Values:
:'''The value used in $Length Unit Multiplier''', or
:'''1''', if $Length Unit Multiplier is undefined

===$Wireframe Targetbox:===
Optional. Defines the default draw method for the target viewer (a.k.a. targetbox).

*Syntax: '''Integer''' Draw method ID
*Valid Values:
::'''0''' - Standard with full, bright lighting
::'''1''' - Wireframe
::'''2''' - Standard with proper lighting (i.e. lit the same as the actual target)
{{Table3615|
::'''3''' - Untextured with full bright lighting (i.e. drawn with a single flat color)}}

===$Targetbox Shader Effect:===
{{Table3615|
Optional. If set, defines a unique ID for a shader effect to be used when rendering a ship for the targeting box. The ID will be passed to the main shader as in [[Post_processing.tbl##Ship_Effects|#Ship_Effects]], but a table entry for the effect is not needed.

*Syntax: '''Integer'''
*Valid Values: Any positive number
}}

===$Lock Wireframe Mode:===
Optional. If set, prevents targetbox draw method from being changed during the gaming session.
*Syntax: '''Boolean'''

===$Scale Gauges:===
{{Table371|
Optional. If set, all gauges will use this value as the default for scaling individual gauge sizes (i.e. doesn't affect gauges that use Position:, and doesn't affect the values of Offset:. In addition, if "$Load Retail Configuration:" is true then all unspecified retail gauges will use this value.

If not set, defaults to yes.

*Syntax: '''Boolean'''
}}

===$Force Scaling Above:===
{{Table373|
Optional. If gauge scaling is disabled, then gauges will be scaled as though the base resolution were this resolution or the real base resolution, whichever is greater.

Use this to disable scaling at lower resolutions while preventing gauges from getting too small at higher resolutions.

To disable this feature, use '''(-1, -1)'''.

*Syntax: ('''Integer''' width, '''Integer''' height)
}}

===$Reticle Style:===
Optional. Defines which aiming reticle to use.
*Syntax: '''String'''
*Valid Values:
:'''FS1''' - uses '''''reticle1_fs1.ani'''''
:'''FS2''' - uses '''''reticle1.ani'''''

==#Gauge Config==
The following entries define default gauge appearance and behavior. Each gauge has the option of overriding these options.

===$Ship:===
Deprecated and superceded by $Ships in FSO revision 9208. If defined, the following config data will only be used if the player ship is of the supplied ship class. Can be defined multiple times within a #Gauge config group to allow unique HUD configurations per ship class.

If not defined, all following config data will be applied to all ships.

*Syntax: '''String''', ship class name

===$Ships:===
Optional. Can be used to define a list of ships the hud definition that follows will be applied to. Can be defined multiple times within a #Gauge config group to allow unique HUD configurations per ship class.

If not defined, all following config data will be applied to all ships.

*`Syntax: '''( "Class name 1" "Class name 2" )''', ship class names formatted like a flag list.

====$Load Retail Configuration:====
Optional. Overrides the [[Hud_gauges.tbl#$Load Retail Configuration: 1|$Load Retail Configuration]] global option for this ship class.

*Syntax: '''Boolean'''

====$Color:====
Optional. Overrides the [[Hud_gauges.tbl#$Color: 1|$Color]] global option for this ship class.

*Syntax: See [[Hud_gauges.tbl#$Color: 1|$Color]]

====$Font:====
Optional. Overrides the [[Hud_gauges.tbl#$Font: 1|$Font]] global option for this ship class.

*Syntax: See [[Hud_gauges.tbl#$Font: 1|$Font]]

====$Chase View Only:====
{{Table381|
Optional. Overrides the [[Hud_gauges.tbl#$Chase View Only: 1|$Chase View Only]] global option for this ship class.

*Syntax: See [[Hud_gauges.tbl#$Chase View Only: 1|$Chase View Only]]
}}

===$Base:===
Required. Defines the base resolution for this HUD configuration, upon which other gauge options (such as [[Hud_gauges.tbl#Position:|Position:]] / [[Hud_gauges.tbl#Origin:|Origin:]] / [[Hud_gauges.tbl#Offset:|Offset:]]) will use as its coordinate system.

*Syntax: ('''Integer''' width, '''Integer''' height)
*Valid Values: All supported resolutions (?)

===$Scale Gauges:===
{{Table371|
Optional. If set, will configure gauges Scaling behaviour for gauges in this #Gauge Config section. i.e. overriding the default, or the value specified at the top of the file. Individual gauges can override this setting.

*Syntax: '''Boolean'''
}}

===$Force Scaling Above:===
{{Table373|
Optional. If gauge scaling is disabled, then gauges will be scaled as though the base resolution were this resolution or the real base resolution, whichever is greater.

Use this to disable scaling at lower resolutions while preventing gauges from getting too small at higher resolutions.

To disable this feature, use '''(-1, -1)'''.

*Syntax: ('''Integer''' width, '''Integer''' height)
}}

===$Required Aspect:===
Optional. If set, this configuration will only be loaded for the specified aspect ratios.

Used as a filter when there are multiple $Base: resolutions in the table

*Syntax: '''String'''
*Valid Values:
:"Full Screen" (4:3, aspect ratio < 1.5)
:"Wide Screen" (16:9, 16:10, or similar, aspect ratio >= 1.5)

===$Min:===
Optional. Minimum resolution for this config. Any resolution lower than specified will not use this configuration.

Used as a filter when there are multiple $Base: resolutions in the table

*Syntax: ('''Integer''' width, '''Integer''' height)
*Valid Values: All supported resolutions (?)

===$Max:===
Optional. Maximum resolution for this config. Any resolution higher than specified will not use this configuration.

Used as a filter when there are multiple $Base: resolutions in the table

*Syntax: ('''Integer''' width, '''Integer''' height)
*Valid Values: All supported resolutions (?)

===$Gauges:===
Following entries define gauge-specific behavior. For the most part, each gauge has its own overrides that, if not defined, would otherwise use the global values.

Since many gauges have the same configuration options, each gauge entry has a list of valid sub-entries. Unless stated otherwise, these options must be defined in the same order as they are shown, starting from the top and ending at the bottom.

====+Custom:====
Adds a custom gauge type.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Name:|Name:]]
:[[Hud_gauges.tbl#Text:|Text:]]
:[[Hud_gauges.tbl#X Offset:|X Offset:]] (Optional)
:[[Hud_gauges.tbl#Y Offset:|Y Offset:]] (Optional)
:[[Hud_gauges.tbl#Gauge Type:|Gauge Type:]]
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Active by default:|Active by default:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]

{{table381|
====+Scripted Gauge:====
Adds a scripted gauge type.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Name:|Name:]]
}}

====+Messages:====
Adds a gauge that display mission messages.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Max Lines:|Max Lines:]] (Optional)
:[[Hud_gauges.tbl#Max Width:|Max Width:]] (Optional)
:[[Hud_gauges.tbl#Line Height:|Line Height]] (Optional)
:[[Hud_gauges.tbl#Total Lifetime:|Total Lifetime:]] (Optional)
:[[Hud_gauges.tbl#Scroll Time:|Scroll Time]] (Optional)
:[[Hud_gauges.tbl#Step Size:|Step Size:]] (Optional)
:[[Hud_gauges.tbl#Hidden By Comms Menu:|Hidden By Comms Menu:]] (Optional)

====+Training Messages:====
Adds a text box, like the ones seen in the FS1 and FS2 training missions.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}

====+Support:====
Adds a text box that shows the Support ship's status and ETA

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Text Y-offset:|Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Dock Status X-offset:|Dock Status X-offset:]] (Optional)
:[[Hud_gauges.tbl#Dock Time X-offset:|Dock Time X-offset:]] (Optional)

====+Damage:====
Adds a gauge that shows how much damage a target (or the player?) has.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Hull Integrity Offsets:|Hull Integrity Offsets]] (Optional)
:[[Hud_gauges.tbl#Hull Integrity Value X-offset:|Hull Integrity Value X-offset]] (Optional)
:[[Hud_gauges.tbl#Top Background Height:|Top Background Height:]] (Optional)
:[[Hud_gauges.tbl#Subsystem Entry Height:|Subsystem Entry Height:]] (Optional)
:[[Hud_gauges.tbl#Subsystem List Start Offsets:|Subsystem List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Subsystem Entry Value X-offset:|Subsystem Entry Value X-offset:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Offset:|Bottom Background Offset:]] (Optional)

====+Wingman Status:====
Adds a gauge that monitors the status of your wing and squadron.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Left Background Filename:|Left Background Filename:]] (Optional) (needs an animation with one frame)
{{table3615|
:[[Hud_gauges.tbl#First Background Filename:|First Background Filename:]] (Optional) (needs an animation with one frame)}}
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional) (needs an animation with one frame)
:[[Hud_gauges.tbl#Right Background Filename:|Right Background Filename:]] (Optional) (needs an animation with one frame)
{{table3615|
:[[Hud_gauges.tbl#Last Background Filename:|Last Background Filename:]] (Optional) (needs an animation with one frame)}}
:[[Hud_gauges.tbl#Dot Filename:|Dot Filename:]] (Optional) (needs an animation with two frames, 1st is for alive wingmen, 2nd is for dead or missing wingmen)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
{{table373|
[[Hud_gauges.tbl#Fixed Header Position:|Fixed Header Position:]] (Optional)}}
:[[Hud_gauges.tbl#Left Background Width:|Left Background Width:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#First Background Size:|First Background Size:]] (Optional)}}
:[[Hud_gauges.tbl#Entry Width:|Entry Width:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Entry Size:|Entry Size:]] (Optional)
:[[Hud_gauges.tbl#Right Background Offset:|Right Background Offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Offset:|Last Background Offset:]] (Optional)}}
:[[Hud_gauges.tbl#Single Wing Offsets:|Single Wing Offsets:]] (Optional)
:[[Hud_gauges.tbl#Multiple Wing Start Offsets:|Multiple Wing Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Wing Name Offsets:|Wing Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Dot Offsets:|Dot Offsets:]] (Optional)
:[[Hud_gauges.tbl#Expansion Mode:|Expansion Mode:]] (Optional)

====+Auto Speed:====
Adds the Auto-Speed mode gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (needs animation with 4 frames, 3rd is without auto-match-speed enabled, 4th is with... and frames 0 & 1 are not used, done this way because retail fs2 uses the same animation file for the auto speed & auto targeting gauges)
:[[Hud_gauges.tbl#Auto Offsets:|Auto Offsets:]] (Optional)
:[[Hud_gauges.tbl#Speed Offsets:|Speed Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#On Text Color:|On Text Color:]] (Optional)
:[[Hud_gauges.tbl#On Text Color:|Off Text Color:]] (Optional)}}

====+Auto Target:====
Adds the Auto-target mode gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (needs animation with 2 frames, 1st is without auto-targeting enabled, 2nd is with)
:[[Hud_gauges.tbl#Auto Offsets:|Auto Offsets:]] (Optional)
:[[Hud_gauges.tbl#Target Offsets:|Target Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#On Text Color:|On Text Color:]] (Optional)
:[[Hud_gauges.tbl#On Text Color:|Off Text Color:]] (Optional)}}

====+Countermeasures:====
Adds a gauge that monitors the amount of remaining countermeasures the player's ship currently has.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (needs an animation with a single frame)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
:[[Hud_gauges.tbl#Value Offsets:|Value Offsets:]] (Optional)

====+Talking Head:====
Adds a video window to display pilot message videos (a.k.a talking heads).

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Animation Offsets:|Animation Offsets:]] (Optional)
:[[Hud_gauges.tbl#Animation Background Size:|Animation Background Size:]] (Deprecated)
{{table373|
:[[Hud_gauges.tbl#Animation Size:|Animation Size:]] (Optional)
}}

====+Directives:====
Adds a gauge that displays all currently active directives (includes current , completed, and failed)

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional) (needs animation with one frame)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional) (needs animation with one frame)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional) (needs animation with one frame)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Background Height:|Top Background Height:]] (Optional)
:[[Hud_gauges.tbl#List Start Offsets:|List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Bottom Background Offset:|Bottom Background Offset:]] (Optional)
:[[Hud_gauges.tbl#Max Line Width:|Max Line Width:]] (Optional)
}}

====+Weapons:====
Adds a weapon status and ammunition gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Primary List Top Background Filename:|Primary List Top Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Primary List Middle Background Filename:|Primary List Middle Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Primary List Bottom Background Filename:|Primary List Bottom Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Secondary List Top Background Filename:|Secondary List Top Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Secondary List Entry Background Filename:|Secondary List Entry Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Secondary List Bottom Background Filename:|Secondary List Bottom Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
::[[Hud_gauges.tbl#Alt Ballistic Offsets:|Alt Ballistic Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Primary Background X-offset:|Top Primary BackgroundX-offset:]] (Optional)
::[[Hud_gauges.tbl#Alt Ballistic X-offset:|Alt Ballistic X-offset:]] (Optional)
:[[Hud_gauges.tbl#Text X-offset:|Text X-offset:]] (Optional)
::[[Hud_gauges.tbl#Alt Ballistic X-offset:|Alt Ballistic X-offset:]] (Optional)
:[[Hud_gauges.tbl#Top Primary Frame Height:|Top Primary Frame Height:]] (Optional)
:[[Hud_gauges.tbl#Top Secondary Frame Height:|Top Secondary Frame Height:]] (Optional)
:[[Hud_gauges.tbl#Primary List Start Y-offset:|Primary List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary List Start Y-offset:|Secondary List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Ammo X-offset:|Primary Weapon Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Link X-offset:|Primary Weapon Link X-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Name X-offset:|Primary Weapon Name X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Ammo X-offset:|Secondary Weapon Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Linked X-offset:|Secondary Weapon Linked X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Name X-offset:|Secondary Weapon Name X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Reload X-offset:|Secondary Weapon Reload X-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Entry Height:|Primary Weapon Entry Height:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Entry Height:|Secondary Weapon Entry Height:]] (Optional)

====+Objective notify:====
Adds a Objective notifier gauge. This gauge alerts the player when receiving a new objective, or when an objective has been completed or failed. Additionally, this gauge alerts the player when entering subspace, and when a Red Alert mission orders are being received (prior to a forced subspace jump).

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Objective Text Y-offset:|Objective Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Objective Value Y-offset:|Objective Value Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Subspace Text Y-offset:|Subspace Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Subspace Value Y-offset:|Subspace Value Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Red Alert Text Y-offset:|Red Alert Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Red Alert Value Y-offset:|Red Alert Value Y-offset:]] (Optional)

====+Squad Message====
Adds the squad message gauge. In FS1 and FS2, this gauge is used to send commands to your squad. (?)

*Valid sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#List Start Offsets:|List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Background Height:|Top Background Height:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Bottom Background Offset|Bottom Background Offset]] (Optional)}}
:[[Hud_gauges.tbl#Command X-offset:|Command X-offset:]] (Optional)
:[[Hud_gauges.tbl#Page Up Offsets:|Page Up Offsets:]] (Optional)
:[[Hud_gauges.tbl#Page Down Offsets:|Page Down Offsets:]] (Optional)

====+Lag:====
Adds a Lag gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]

====+Mini Target Shields:====
Adds a mini Target shields gauge. In FS1 and FS2, the Mini Target Shield gauge is the one right below the center reticle, and shows the hull damage in %

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (animation needs 8 frames; 0->3 are the top, right, bottom & left shield quads; 4->7 are the same except brighter for when the quad is flashing from being hit)
:[[Hud_gauges.tbl#3 Digit Hull Offsets:|3 Digit Hull Offsets:]] (Optional)
:[[Hud_gauges.tbl#2 Digit Hull Offsets:|2 Digit Hull Offsets:]] (Optional)
:[[Hud_gauges.tbl#1 Digit Hull Offsets:|1 Digit Hull Offsets:]] (Optional)

====+Player Shields:====
Adds a gauge that shows the shield and hull status icon of the player's craft or ship.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)

====+Target Shields:====
Adds a gauge that shows the shield and hull status icon of the targeted craft or ship.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)

====+Escort View:====
Adds an escort monitor/view gauge. This gauge monitors the status of all ships assigned to the player to escort.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height]] (Optional)
:[[Hud_gauges.tbl#Entry Stagger Width:|Entry Stagger Width:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Bottom Background Offset:|Bottom Background Offset:]] (Optional)}}
:[[Hud_gauges.tbl#Header Text:|Header Text]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#List Start Offsets:|List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Hull X-offset:|Hull X-offset]] (Optional)
:[[Hud_gauges.tbl#Name X-offset:|Name X-offset]] (Optional)
:[[Hud_gauges.tbl#Status X-offset:|Status X-offset]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Ship Name Max Width:|Ship Name Max Width:]] (Optional)}}
{{table373|
:[[Hud_gauges.tbl#Right-Align Ship Names:|Right-Align Ship Names:]] (Optional)}}

====+Mission Time:====
Adds a gauge that displays the current mission time.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
:[[Hud_gauges.tbl#Value Offsets:|Value Offsets:]] (Optional)

====+ETS Retail:====
{{Table3613|
Draws the three other ETS gauges as a single gauge. Will automatically rearrange itself (like retail) if shields or other systems are missing.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
{{Table3613|
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)
:[[Hud_gauges.tbl#Gauge Offset:|Gauge Offset:]] (Optional)

}}

====+ETS Weapons:====
Adds a gauge that displays the energy transfer rate for the energy weapons.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)

====+ETS Engines:====
Adds a gauge that displays the energy transfer rate for the afterburner/engines.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)

====+ETS Shields:====
Adds a gauge that displays the energy transfer rate for the shields.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)

====+Target Monitor:====
Adds a target monitor gauge that shows the targeted ship's relative orientation and hull strength, among other things.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Monitor Filename:|Monitor Filename:]] (Optional) (needs animation with 2 frames, 1st is the background for the target, 2nd is the border; rendered last)
{{table3615|
:[[Hud_gauges.tbl#Monitor Alpha Mask Filename:|Monitor Alpha Mask Filename:]] (Optional) (needs animation with a single frame)}}
:[[Hud_gauges.tbl#Integrity Bar Filename:|Integrity Bar Filename:]] (Optional) (needs animation with 2 frames, 1st is a zero/dark filled bar, 2nd is a max/bright filled bar)
:[[Hud_gauges.tbl#Viewport Offsets:|Viewport Offsets:]] (Optional)
:[[Hud_gauges.tbl#Viewport Size:|Viewport Size:]] (Optional)
:[[Hud_gauges.tbl#Integrity Bar Offsets:|Integrity Bar Offsets:]] (Optional)
:[[Hud_gauges.tbl#Integrity Bar Foreground Clip Height:|Integrity Bar Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Status Offsets:|Status Offsets:]] (Optional)
:[[Hud_gauges.tbl#Name Offsets:|Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Class Offsets:|Class Offsets:]] (Optional)
:[[Hud_gauges.tbl#Distance Offsets:|Distance Offsets:]] (Optional)
:[[Hud_gauges.tbl#Speed Offsets:|Speed Offsets:]] (Optional)
:[[Hud_gauges.tbl#Hull Offsets:|Hull Offsets:]] (Optional)
:[[Hud_gauges.tbl#Cargo Contents Offsets:|Cargo Contents Offsets:]] (Optional)
:[[Hud_gauges.tbl#Cargo Scan Start Offsets:|Cargo Scan Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Cargo Scan Size:|Cargo Scan Size:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Subsystem Name Offsets:|Subsystem Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Subsystem Integrity Offsets:|Subsystem Integrity Offsets:]] (Optional)
:[[Hud_gauges.tbl#Disabled Status Offsets:|Disabled Status Offsets:]] (Optional)
:[[Hud_gauges.tbl#Desaturate:|Desaturate:]] (Optional)
}}

====+Extra Target Data:====
Adds a gauge that displays "extra" target data, such as its current orders and docking status.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs an animation with 1 frame)
:[[Hud_gauges.tbl#Bracket Offsets:|Bracket Offsets:]] (Optional)
:[[Hud_gauges.tbl#Dock Offsets:|Dock Offsets:]] (Optional)
{{table373|
:[[Hud_gauges.tbl#Dock Max Width:|Dock Max Width:]] (Optional)}}
:[[Hud_gauges.tbl#Order Offsets:|Order Offsets:]] (Optional)
{{table373|
:[[Hud_gauges.tbl#Order Max Width:|Order Max Width:]] (Optional)}}
:[[Hud_gauges.tbl#Time Offsets:|Time Offsets:]] (Optional)

====+Radar:====
Adds a standard radar gauge

*Valid Sub-entries:
{{table190|
:[[Hud_gauges.tbl#N-gon Sides:|N-gon Sides:]] (Optional)
:[[Hud_gauges.tbl#N-gon Sides:|N-gon Offset:]] (Optional)
}}
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs animation with 2 frames, only the 2nd frame is used)
{{table373|
:[[Hud_gauges.tbl#Radar Center Offsets:|Radar Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Radar Size:|Radar Size:]] (Optional)
}}
:[[Hud_gauges.tbl#Infinity Distance Offsets:|Infinity Distance Offsets]] (Optional)
:[[Hud_gauges.tbl#Long Distance Offsets:|Long Distance Offsets:]] (Optional)
:[[Hud_gauges.tbl#Short Distance Offsets:|Short Distance Offsets:]] (Optional)

====+Radar Orb:====
Adds a 3D orb radar gauge

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs animation with 2 frames, only the 2nd frame is used)
{{table373|
:[[Hud_gauges.tbl#Radar Center Offsets:|Radar Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Radar Size:|Radar Size:]] (Optional)
}}
:[[Hud_gauges.tbl#Infinity Distance Offsets:|Infinity Distance Offsets]] (Optional)
:[[Hud_gauges.tbl#Long Distance Offsets:|Long Distance Offsets:]] (Optional)
:[[Hud_gauges.tbl#Short Distance Offsets:|Short Distance Offsets:]] (Optional)

====+Radar BSG:====
Adds a BSG style radar (a.k.a DRADIS).

:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Size:|Size:]] (Optional)
:[[Hud_gauges.tbl#XY Disc Filename:|XY Disc Filename:]] (Optional)
:[[Hud_gauges.tbl#XZ YZ Disc Filename:|XZ YZ Disc Filename:]] (Optional)
:[[Hud_gauges.tbl#Sweep Disc Filename:|Sweep Disc Filename:]] (Optional)
:[[Hud_gauges.tbl#Default Contact Filename:|Default Contact Filename:]] (Optional)
:[[Hud_gauges.tbl#Unknown Contact Filename:|Unknown Contact Filename:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]]
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]]
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Loop Volume:|Loop Volume:]] (Optional)
:[[Hud_gauges.tbl#Minimum Beep Delay:|Minimum Beep Delay]] (Optional)

====+Afterburner Energy:====
Adds a gauge that shows the remaining afterburner energy. Note that it only supports a vertical fill.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs animation with 2 frames, the 1st is the bar lit for zero energy, the 2nd is the bar lit for max energy)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)

====+Weapon Energy:====
Adds a gauge that shows the remaining weapon energy. Note that it only supports a vertical fill.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs an animation with 4 frames, the 3rd is the bar lit for zero energy, the 2nd is the bar lit for max energy, frames 1 & 2 are not used)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Text Alignment:|Text Alignment:]] (Optional)
:[[Hud_gauges.tbl#Always Show Text:|Always Show Text:]] (Optional)
:[[Hud_gauges.tbl#Text Follows:|Text Follows:]] (Optional)
:[[Hud_gauges.tbl#Show Ballistic Ammo:|Show Ballistic Ammo:]] (Optional)
:[[Hud_gauges.tbl#Armed Guns List Offsets:|Armed Guns List Offsets:]] (Optional)
:[[Hud_gauges.tbl#Armed Guns List Alignment:|Armed Guns List Alignment:]] (Optional)
:[[Hud_gauges.tbl#Armed Guns List Entry Height:|Armed Guns List Entry Height:]] (Optional)
}}

====+Text Warnings:====
Adds a gauge that warns the player (current warnings are EMP, Launch, Evaded, Collision, Blast & Engine Wash).

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)

====+Center Reticle:====
Adds a "custom" center reticle.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Firepoint display:|Firepoint display:]] (Optional)
:[[Hud_gauges.tbl#Firepoint size:|Firepoint size:]] (Optional)
:[[Hud_gauges.tbl#Firepoint X coordinate multiplier:|Firepoint X coordinate multiplier:]] (Optional)
:[[Hud_gauges.tbl#Firepoint Y coordinate multiplier:|Firepoint Y coordinate multiplier:]] (Optional)

====+Throttle:====
Adds a gauge that shows the current throttle position.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Bottom Y-offset:|Foreground Clip Bottom Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Width:|Foreground Clip Width:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Afterburner Clip Height:|Afterburner Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Show Background:|Show Background:]] (Optional)
:[[Hud_gauges.tbl#Max Speed Label Offsets:|Max Speed Label Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Show Max Speed Label:|Show Max Speed Label:]] (Optional)}}
:[[Hud_gauges.tbl#Min Speed Label Offsets:|Min Speed Label Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Show Min Speed Label:|Show Min Speed Label:]] (Optional)}}
:[[Hud_gauges.tbl#Orbit Center Offsets:|Orbit Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Orbit Radius:|Orbit Radius:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Current Speed Offsets:|Current Speed Offsets:]] (Optional)
:[[Hud_gauges.tbl#Target Speed Offsets:|Target Speed Offsets:]] (Optional)
:[[Hud_gauges.tbl#Show Percentage:|Show Percentage:]] (Optional)
:[[Hud_gauges.tbl#Glide Status Offsets:|Glide Status Offsets:]] (Optional)
:[[Hud_gauges.tbl#Match Speed Status Offsets:|Match Speed Status Offsets:]] (Optional)
}}

====+Threat Indicator:====
Adds a gauge that indicates when a lock-on has been achieved by an attacker, and if the player is being shot at.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Arc Filename:|Arc Filename:]] (Optional)
:[[Hud_gauges.tbl#Dumbfire Filename:|Dumbfire Filename:]] (Optional)
:[[Hud_gauges.tbl#Lock Filename:|Lock Filename:]] (Optional)
:[[Hud_gauges.tbl#Dumbfire Offsets:|Dumbfire Offsets:]] (Optional)
:[[Hud_gauges.tbl#Lock Offsets:|Lock Offsets:]] (Optional)

====+Multiplayer Messages:====
Adds a gauge that displays the multiplayer messages.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}

====+Voice Status:====
Adds a gauge that displays the voice status.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}

====+Ping:====
Adds a gauge that the ping time to the multiplayer server.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}

====+Supernova:====
Adds a gauge that warns the player of an impending supernova shock wave.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}

====+Lock Indicator:====
Adds a Lock Indicator gauge.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Lock Filename:|Lock Filename:]] (Optional)
:[[Hud_gauges.tbl#Locked Filename:|Locked Filename:]] (Optional)
:[[Hud_gauges.tbl#Lock Center Offsets:|Lock Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Locked Center Offsets:|Locked Center Offsets:]] (Optional)

====+Offscreen Indicator:====
Adds an Offscreen Indicator.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}

====+Target Brackets:====
Adds a Target Bracket gauge. This is drawn around current target(s) and talkers.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Dot Filename:|Dot Filename:]] (Optional)

====+Hostile Triangle:====
Adds a gauge that points to the nearest attacker, if it is off-screen and is not currently targeted.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)
:[[Hud_gauges.tbl#Triangle Base:|Triangle Base:]] (Optional)
:[[Hud_gauges.tbl#Triangle Height:|Triangle Height:]] (Optional)

====+Target Triangle:====
Adds a gauge that points to the targeted craft, if it is currently off-screen.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)
:[[Hud_gauges.tbl#Triangle Base:|Triangle Base:]] (Optional)
:[[Hud_gauges.tbl#Triangle Height:|Triangle Height:]] (Optional)

====+Missile Triangles:====
Adds a gauge that is used during attempting to lock onto a target when using an aspect seeking missile.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)
:[[Hud_gauges.tbl#Triangle Base:|Triangle Base:]] (Optional)
:[[Hud_gauges.tbl#Triangle Height:|Triangle Height:]] (Optional)

====+Lead Indicator:====
Adds a gauge that leads (is in front) of the target. Aim your crosshairs at this indicator to increase probability of hitting the target.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
::Frame #0: Secondaries lead indicator (Dumbfire)
::Frame #1: Secondaries lead indicator (Homing)
::Frame #2: Primaries lead indicator
:[[Hud_gauges.tbl#Center Offsets:|Center Offsets:]] (Optional)

====+Orientation Tee:====
Adds a gauge that indicates the targeted craft's orientation in relation to the player's craft.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)

====+Lead Sight:====
Adds a gauge that lags (is behind) the target. Indicates where your shots will end up relative to the target's position. To score a hit, this gauge should be over the target. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
::Frame #0 is used for secondaries
::* If only one frame is found in the file, then it is used for primaries instead
::Frame #1 is used for primaries

====+Kills:====
Adds a gauge that keeps track of how many kills the player has scored during a mission.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
:[[Hud_gauges.tbl#Value Offsets:|Value Offsets:]] (Optional)

====+Weapon Linking:====
Adds a gauge that indicates the selected weapons and their firing rates.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Arc Filename:|Arc Filename:]] (Optional)
:[[Hud_gauges.tbl#Single Primary Filename:|Single Primary Filename:]] (Optional)
:[[Hud_gauges.tbl#Double Primary Filename:|Double Primary Filename:]] (Optional)
:[[Hud_gauges.tbl#Single Secondary Filename:|Single Secondary Filename:]] (Optional)
:[[Hud_gauges.tbl#Double Secondary Filename:|Double Secondary Filename:]] (Optional)
:[[Hud_gauges.tbl#Triple Secondary Filename:|Triple Secondary Filename:]] (Optional)
:[[Hud_gauges.tbl#Single Primary Offsets:|Single Primary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Double Primary Offsets:|Double Primary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Single Secondary Offsets:|Single Secondary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Double Secondary Offsets:|Double Secondary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Triple Secondary Offsets:|Triple Secondary Offsets:]] (Optional)

====+Fixed Messages:====

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table375|
:[[Hud_gauges.tbl#Center Text On Gauge X-Position:|Center Text On Gauge X-Position:]] (Optional)
}}

====+Flight Path Marker:====
{{table3615|
Adds a gauge that indicates the direction where your ship is traveling. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Center Offsets:|Center Offsets:]] (Optional)}}

====+Warhead Count:====
{{table3615|
Displays the name of the current secondary weapon. Tallies the ammo left. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs an animation with a single frame)
:[[Hud_gauges.tbl#Name Offsets:|Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Count Offsets:|Count Offsets:]] (Optional)
:[[Hud_gauges.tbl#Icon Width:|Icon Width:]] (Optional)
:[[Hud_gauges.tbl#Icon Height:|Icon Height:]] (Optional)
:[[Hud_gauges.tbl#Max Icons:|Max Icons:]] (Optional)
:[[Hud_gauges.tbl#Max Columns:|Max Columns:]] (Optional)
:[[Hud_gauges.tbl#Name Alignment:|Name Alignment:]] (Optional)
}}

====+Hardpoints:====
{{table3615|
Draws a silhouette of the player's ship and mounted weapons. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Size:|Size:]] (Optional)
:[[Hud_gauges.tbl#Line Width:|Line Width:]] (Optional)
:[[Hud_gauges.tbl#View Direction:|View Direction:]] (Optional)
:[[Hud_gauges.tbl#Show Primary Weapons:|Show Primary Weapons:]] (Optional)
:[[Hud_gauges.tbl#Show Secondary Weapons:|Show Secondary Weapons:]] (Optional)
}}

====+Primary Weapons:====
{{table3615|
Like the Weapons gauge but simpler. Only displays primary weapons. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Header Text:|Header Text:]] (Optional)
:[[Hud_gauges.tbl#First Background Filename:|First Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#First Background Height:|First Background Height:]] (Optional)
:[[Hud_gauges.tbl#First Background X-offset:|First Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Entry Background Height:|Entry Background Height:]] (Optional)
:[[Hud_gauges.tbl#Entry Background X-offset:|Entry Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Filename:|Last Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Last Background X-offset:|Last Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Y-offset:|Last Background Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
:[[Hud_gauges.tbl#List Start Y-offset:|List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Ammo X-offset:|Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Link X-offset:|Link X-offset:]] (Optional)
:[[Hud_gauges.tbl#Name X-offset:|Name X-offset:]] (Optional)
}}

====+Secondary Weapons:====
{{table3615|
Like the Weapons gauge but simpler. Only displays secondary weapons. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Header Text:|Header Text:]] (Optional)
:[[Hud_gauges.tbl#First Background Filename:|First Background Filename:]] (Optional)
:[[Hud_gauges.tbl#First Background Height:|First Background Height:]] (Optional)
:[[Hud_gauges.tbl#First Background X-offset:|First Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Height:|Entry Background Height:]] (Optional)
:[[Hud_gauges.tbl#Entry Background X-offset:|Entry Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Filename:|Last Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Last Background X-offset:|Last Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Y-offset:|Last Background Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
:[[Hud_gauges.tbl#List Start Y-offset:|List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Ammo X-offset:|Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Link X-offset:|Link X-offset:]] (Optional)
:[[Hud_gauges.tbl#Name X-offset:|Name X-offset:]] (Optional)
:[[Hud_gauges.tbl#Unlink X-offset:|Unlink X-offset:]] (Optional)
:[[Hud_gauges.tbl#Reload X-offset:|Reload X-offset:]] (Optional)
}}

===$End Gauges===
The Gauges section must end with $End Gauges. No Exceptions.

==#End==
The very last entry in the Hud_gauges.tbl must be #End. No Exceptions.

----
----

==Gauge Configuration Options==
Since a vast majority of gauges share the same entries, the configuration options for each gauge have been grouped here for formatting consistency.

====Position:====
Defines the screen coordinates for the upper left corner of this gauge.

*Syntax: '''Integer''' horizontal pixel, '''Integer''' vertical pixel position

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Training Messages:|+Training Messages:]], [[Hud_gauges.tbl#+Support:|+Support]] (and many others)

====Scale Gauge:====

{{table371|
Define if a gauge size will scale or not.

If false then gauge bitmaps will always show at their original size which may result in gauges being very small at high resolutions.

If true then gauge bitmaps will scale in proportion to the current resolution vs the base HUD resolution in use. This may result in gauges becoming blurry at non-base resolutions.

Defaults to yes/true.

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: '''Boolean''' scale_this_gauge

Used by: most gauges
}}

====Force Scaling Above:====

{{Table373|
Optional. If scaling is disabled for this gauge, then it will be scaled as though the base resolution were this resolution or the real base resolution, whichever is greater.

Use this to disable scaling at lower resolutions while preventing gauges from getting too small at higher resolutions.

To disable this feature, use '''(-1, -1)'''.

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: ('''Integer''' width, '''Integer''' height)

Used by: most gauges
}}

====Origin:====

{{table371|
Define gauge position as a ratio of the screen size (base or current, it doesn't matter).

Requires [[Hud_gauges.tbl#Offset:|Offset:]]

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: '''Float''' horizontal ratio 0.0 - 1.0, '''Float''' vertical ratio 0.0 - 1.0

Used by: most gauges
}}

====Offset:====

{{table371|
Define gauge offset from [[Hud_gauges.tbl#Origin:|Origin:]] in base resolution pixels

Requires [[Hud_gauges.tbl#Origin:|Origin:]]

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: '''Integer''' horizontal pixel offset from Origin:, '''Integer''' vertical pixel offset from Origin:

Used by: most gauges
}}

====Cockpit Target:====
The cockpit display that this gauge will be rendered to. Refers to the +Display Name: defined in [[ships.tbl#$Cockpit Display:|$Cockpit Display:]].

*Syntax: '''String''' String defined in +Display Name: in [[ships.tbl#$Cockpit Display:|$Cockpit Display:]]

=====Canvas Size:=====
The off-screen canvas this gauge will be rendered to before being interpolated into the actual cockpit display. The smaller this number is, the larger the gauge will appear on the cockpit display.

*Syntax: '''Integer''' width, '''Integer''' height

=====Display Offset:=====
The position of the canvas on the cockpit display texture

*Syntax: '''Integer''' width, '''Integer''' height

=====Display Size:=====
The interpolated size on the cockpit display texture that the canvas will be rendered to.

*Syntax: '''Integer''' width, '''Integer''' height

====Color:====
Optional. Overrides both previous color settings ([[Hud_gauges.tbl#$Color: 1|$Color]] HUD option and [[Hud_gauges#$Color: 2|$Color]] ship class option) for this particular gauge.

*Syntax: See [[Hud_gauges.tbl#$Color: 1|$Color:]]

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Font:====
Optional. Overrides both previous font settings ([[Hud_gauges.tbl#$Font: 1|$Font]] HUD option and [[Hud_gauges#$Font: 2|$Font]] ship class option) for this particular gauge.

*Syntax: See [[Hud_gauges.tbl#$Font: 1|$Font:]]

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Training Messages:|+Training Messages:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Name:====
Defines the name of this custom gauge.

*Syntax: '''String'''
*Max Length: 32 characters

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Text:====
Default text to be displayed. Can be altered using the hud-set-message, hud-set-text and hud-set-directive sexps.

*Syntax: '''String'''
*Max Length: 32 characters

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====X Offset:====
Optional. Defines the horizontal pixel offset (from the gauge's origin as defined by [[Hud_gauges.tbl#Position:|Position:]]) that the Text will be displayed.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Y Offset:====
Optional. Defines the vertical pixel offset (from the gauge's origin defined by [[Hud_gauges.tbl#Position:|Position:]]) that the Text will be displayed.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Gauge Type:====
Defines the type of gauge this is.

*Syntax: '''String'''
*Valid Values: Any one of the possible [[gauge types]].

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Slew:====
Optional. Determines whether or not this gauge is affected by afterburner shaking or similar effects. If set to "true", the gauge will not follow the player's head movements when using TrackIR/padlock. i.e. should be used for gauges like the gunsight/leadsight.

*Syntax: '''Boolean'''

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Max Lines:====
Optional. Specifies the maximum number of message lines that are displayed.

*Syntax: '''Integer'''
*Default Value: 3

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Max Width:====
Optional. Determines how long each message line may be.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Line Height:====
Optional. Determines the distance between line origins. (i.g. for a 12pt Font, there are needs to be at least 12 pixels between the bottom of one line and the next, otherwise the text will overlap each)

*Syntax: '''Integer'''
*Units: Pixels
*Default Value: 9

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Total Lifetime:====
Optional. Determines the maximum time the message gauge will be displayed from the time a new message is received.

*Syntax: '''Integer'''
*Units: milliseconds
*Default Value: 14000 (14 seconds)

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Scroll Time:====
Optional. Determines the time for the messages to scroll up one step.( See [[Hud_gauges.tbl#Step Size:|Step Size:]] )

*Syntax: '''Integer'''
*Units: milliseconds
*Default Value: 30

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Step Size:====
Optional. Determines how many pixels to shift message lines during scrolling. Messages will be shifted up by this amount until they are on the next line (as defined by [[Hud_gauges.tbl#Line Height:|Line Height:]])

*Syntax: '''Integer'''
*Units: Pixels
*Default Value: 3

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Active by default:====
Optional. Determines whether or not this gauge is always active, or only available after being activated via sexp.

*Syntax: '''Boolean'''

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Filename:====
Designates the [[Multimedia_Files#ANI|.ANI]] or [[Multimedia_Files#EFF|.EFF]] used for this gauge's background graphic.
{{Note| All HUD .ANI's must have the same color palette as the retail .ANI's in order to render properly. (.EFF's do not have this restriction)}}

*Syntax: '''Filename'''
**No filename extension is needed.

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Top Background Filename:====
Optional. Designates which file to use for the top background. (?)

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Damage|+Damage]]

====Bottom Background Filename:====
Optional. Designates which file to use for the Bottom background (?)

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Damage|+Damage]]

====Left Background Filename:====
Optional. Designates which file to use for the Left side of gauge.

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====First Background Filename:====
Optional. Alias for [[Hud_gauges.tbl#Left Background Filename:|Left Background Filename:]]

====Right Background Filename:====
Optional. Designates which file to use for the Right side of the gauge.

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Last Background Filename:====
Optional. Alias for [[Hud_gauges.tbl#Right Background Filename:|Right Background Filename:]]

====Entry Background Filename:====
Optional. Designates which file to use for the (Wing) Entry section of the gauge (aka the middle sections).

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Damage|+Damage]], [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Primary List Top Background Filename:====
Optional. Designates which file to use for the Primary List Top Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary List Middle Background Filename:====
Optional. Designates which file to use for the Primary List Middle Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary List Bottom Background Filename:====
Optional. Designates which file to use for the Primary List Bottom Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Top Background Filename:====
Optional. Designates which file to use for the Secondary List Top Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Entry Background Filename:====
Optional. Designates which file to use for the Secondary List Entry Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Bottom Background Filename:====
Optional. Designates which file to use for the Secondary List Bottom Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Alt Ballistic Filename:====
Optional. Designates an alternate file to be used for ballistic weapons.

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#Primary List Top Background Filename:|Primary List Top Background Filename]], [[Hud_gauges.tbl#Primary List Middle Background Filename:|Primary List Middle Background Filename]], [[Hud_gauges.tbl#Primary List Bottom Background Filename:|Primary List Bottom Background Filename]], [[Hud_gauges.tbl#Secondary List Top Background Filename:|Secondary List Top Background Filename]], [[Hud_gauges.tbl#Secondary List Entry Background Filename:|Secondary List Entry Background Filename]], [[Hud_gauges.tbl#Secondary List Bottom Background Filename:|Secondary List Bottom Background Filename]]

====Dot Filename:====
Optional. Designates which file to use for the wingman graphic (a.k.a. the Dot)

*Syntax: '''Filename'''

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Header Offsets:====
Optional. Designates the offset from the gauge's upper left corner for headers of various gauges

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels
*Valid Sub-entries:
:Weapons:
::[[Hud_gauges.tbl#Alt Ballistic Offsets:|Alt Ballistic Offsets:]]

Used by: [[Hud_gauges.tbl#+Support:|+Support:]], [[Hud_gauges.tbl#+Damage|+Damage:]], [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Fixed Header Position:====
Optional. If set, the header text will not change position when the gauge changes size.

*Syntax: '''Boolean'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Text Y-offset:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship Text. (?)

*Syntax: '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]]

====Text Offsets:====
Optional. Defines the screen position offsets for the text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: :[[Hud_gauges.tbl#+Countermeasures:|+Countermeasures:]]

====Value Offsets:====
Optional. Defines the screen position offsets for the value label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: :[[Hud_gauges.tbl#+Countermeasures:|+Countermeasures:]]

====Dock Status X-offset:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship's dock status. (?)

*Syntax: '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]]

====Dock Time X-offset:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship's dock time. (?)

*Syntax: '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]]

====Hull Integrity Offsets:====
Optional. Designates the offsets from the gauge's upper left corner for the for the Damage gauge Hull integrity textbox(?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Hull Integrity Value X-offset:====
Optional. Designates the offsets from the hull integrity textbox's upper left corner for the hull integrity value. (?)

*Syntax: '''Integer''' horizontal offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Top Background Height:====
Optional. Designates the height of the Top background (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Left Background Width:====
Optional. Defines the width of the Left Background.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Entry Width:====
Optional. Defines the width of the Entry Background (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Subsystem Entry Height:====
Optional. Designates the height of the Subsystem entry (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Subsystem List Start Offsets:====
Optional. Designates the offsets from the gauge's upper left corner for the for the start of the Subsytem List (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Subsystem Entry Value X-offset:====
Optional. Designates the horizontal offset from the Subsystem List's position (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Single Wing Offsets:====
Optional. Designates the offset from the gauge's upper left corner for a single wing (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Multiple Wing Start Offsets:====
Optional. Designates the offset from the gauge's upper left corner for multiple wings (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Wing Name Offsets:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship header (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Dot Offsets:====
Optional. Designates the offset from the gauge's upper left corner for the All wingman status icons.
*Syntax:
:'''Integer''' x, '''Integer''' y ;; Wingman 1
:'''Integer''' x, '''Integer''' y ;; Wingman 2
:'''Integer''' x, '''Integer''' y ;; Wingman 3
:'''Integer''' x, '''Integer''' y ;; Wingman 4
:'''Integer''' x, '''Integer''' y ;; Wingman 5
:'''Integer''' x, '''Integer''' y ;; Wingman 6
*Units: Pixels

{{Warning|
All 6 wingman positions must be defined}}

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Expansion Mode:====
Optional. Denotes which direction (in relation to the player's wing) that the other wings should be appended to the gauge

*Syntax: '''String'''
*Valid Values:
:*Right ;; Wings are added to the right of the previous wing

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Auto Offsets:====
Optional. Defines the screen coordinates for the "Auto" text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Auto Speed:|+Auto Speed:]], [[Hud_gagues.tbl#+Auto Target:|+Auto Target:]]

====Speed Offsets:====
Optional. Defines the screen coordinates for the "Speed" text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Auto Speed:|+Auto Speed:]]

====Target Offsets:====
Optional. Defines the screen coordinates for the "Target" text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Auto Target:|+Auto Target:]]

====Animation Offsets:====
Optional. Defines the offsets for the animation graphics.

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Talking Head:|+Talking Head:]]

====Animation Background Size:====
Deprecated. Originally, this set the size of the black box that's drawn behind the animation. Since Git revision 556e9a4 (2015-11-01), it has the same effect as [[Hud_gauges.tbl#Animation Size:|Animation Size:]].

*Syntax: '''Integer''' horizontal size, '''Integer''' vertical size
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Talking Head:|+Talking Head:]]

====Animation Size:====
{{table373|
Optional. Defines the size of the animation. All animations will be scaled to match this size.

*Syntax: '''Integer''' horizontal size, '''Integer''' vertical size
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Talking Head:|+Talking Head:]]
}}

====List Start Offsets:====
Optional. Defines the screen coordinate offsets for the start of the Directives list.

*Syntax: '''Integer''' x, '''Integer''' y
*Units: Pixels

Used by: [[Hud_guages.tbl#+Directives:|+Directives:]]

====Entry Height:====
Optional. Defines the height of each Directive

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_guages.tbl#+Directives:|+Directives:]]

====Alt Ballistic Offsets:====
Opetional. Defines the screen coordinate offsets for headers of ballistic weapons

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Header Offset:|+Header Offset:]]

====Top Primary Background X-offset:====
Optional. Defines the screen coordinate offset for the Top Primary Background

*Syntax: '''Integer'''
*Units: Pixels
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic X-offset:|Alt Ballistic X-offset:]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Text X-offset:====
(Optional) Defines the screen coordinate X-offset for weapon labels

*Syntax: '''Integer'''
*Units: Pixels
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic X-offset:|Alt Ballistic X-offset:]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Alt Ballistic X-offset:====
Optional. Defines the screen coordinate X-offset for ballistic weapons

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#Top Primary Background X-offset:|Top Primary Background X-offset:]], [[Hud_gauges.tbl#Text X-offset:|Text X-offset:]]

====Top Primary Frame Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Top Secondary Frame Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary List Start Y-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Start Y-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Ammo X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Link X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Name X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Ammo X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Linked X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Name X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Reload X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Entry Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Entry Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====3 Digit Hull Offsets:====
Designates the screen position offsets for the hull damage % when it is the 3 digit range (i.e. >= 100%)

*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Mini Target Shields:|+Mini Target Shields:]]

====2 Digit Hull Offsets:====
Designates the screen position offsets for the hull damage % when it is the 2 digit range (i.e. 100% > hull damage% >= 10%)

*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Mini Target Shields:|+Mini Target Shields:]]

====1 Digit Hull Offsets:====
Designates the screen position offsets for the hull damage % when it is the 1 digit range (i.e. 10% > hull damage% >= 0%)

*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Mini Target Shields:|+Mini Target Shields:]]

====Objective Text Y-offset:====
Designates the screen position offset for the Objective label

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Objective Value Y-offset====
Designates the screen position offset for the Objective value

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Subspace Text Y-offset:====
Designates the screen position offset for the Subspace label

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Subspace Value Y-offset====
Designates the screen position offset for the Subspace value (?)

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Red Alert Text Y-offset====
Designates the screen position offset for the Red Alert label

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Red Alert Value Y-offset====
Designates the screen position offset for the Red Alert value (?)

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Command X-offset:====
*Syntax: '''Integer''' x offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Squad Message:|+Squad Message:]]

====Page Up Offsets:====
*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Squad Message:|+Squad Message:]]

====Page Down Offsets:====
*Syntax: '''Integer''' x offset, ''' Integer y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Squad Message:|+Squad Message:]]

====Entry Height:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Entry Stagger Width:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Header Text:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Header Offsets:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====List Start Offsets:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Hull X-offset:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Name X-offset:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Status X-offset:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Ship Name Max Width:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Right-Align Ship Names:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Foreground Clip Height:====

* Sets the height, in pixels, of the gauge.
** For the [[Hud_gauges.tbl#+Throttle|Throttle]], sets the height of the gauge that represents 0% to 100% throttle. The total height of the gauge is the sum of this value and the [[Hud_gauges.tbl#Afterburner Clip Height:|Afterburner Clip Height]] value.
* Syntax: '''Integer'''

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]], [[Hud_gauges.tbl#+ETS Weapons:|+ETS Weapons]], [[Hud_gauges.tbl#+ETS Engines:|+ETS Engines]], [[Hud_gauges.tbl#+ETS Shields:|+ETS Shields]], [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor]], [[Hud_gauges.tbl#+Afterburner Energy|+Afterburner Energy]], [[Hud_gauges.tbl#+Weapon Energy|+Weapon Energy]], [[Hud_gauges.tbl#+Throttle:|+Throttle]]

====Letter Offsets:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Top Offsets:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Bottom Offsets:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Gauge Offset:====
*Distance between the individual weapon/shield/engine ETS gauges that comprise this gauge
*Syntax: '''Integer'''

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Monitor Filename:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Integrity Bar Filename:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Viewport Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Viewport Size:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Integrity Bar Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Integrity Bar Foreground Clip Height:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Status Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Name Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Class Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Speed Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Hull Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Cargo Contents Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Cargo Scan Start Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Cargo Scan Size:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Bracket Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Dock Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Dock Max Width:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Order Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Order Max Width:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Time Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Radar Center Offsets:====
Defines the radar's plot origin as an offset, in pixels, from this gauge's [[Hud_gauges.tbl#Position|Position]] coordinates
*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

====Radar Size:====
Size, in pixels, of the radar plot area.

Syntax: '''Integer''' horizontal size, '''Integer''' vertical size

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

====Infinity Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

Offset to draw the infinity radar range symbol.

====Long Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

Offset to draw the long range radar text (i.e. 10k).

====Short Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

Offset to draw the short range radar text (i.e. 2k).

====Size:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====XY Disc Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====XZ YZ Disc Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Sweep Disc Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Default Contact Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Unknown Contact Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Loop Volume:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG]]

====Minimum Beep Delay:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG]]

====Firepoint display:====
Displays the positions of the gun firepoints on your ship
*Syntax: '''Boolean''', YES or NO

NOTE: The position of the firepoints is calculated from the Eye Point position in the POF. You may encounter weird results if you have no Eye Point defined, but no debug warnings will be raised.

Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Firepoint size:====
Diameter of the gunpoint circles. '''Must be 4 or greater''' in order to work properly.
*Syntax: '''Integer'''

Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Firepoint X coordinate multiplier:====
Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Firepoint Y coordinate multiplier:====
Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Foreground Clip Bottom Y-offset:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Foreground Clip Width:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Afterburner Clip Height:====
* Sets the area of the throttle gauge that represents the Afterburner segment (which is on top of the 0% to 100% area). The total height of the gauge is determined by the sum of this value and [[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]]

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Show Background:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Max Speed Label Offsets:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Min Speed Label Offsets:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Orbit Center Offsets:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Orbit Radius:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Arc Filename:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Needs to be an [[Multimedia_Files#ANI|ani]] with a least 2 frames (but only the 2nd frame is used ?!?!? for threat & weapon linking so far)

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Dumbfire Filename:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Needs to be an [[Multimedia_Files#ANI|ani]] with a least 2 frames. The 1st frame is "no warning", the rest of the frames are cycled through when a warning is active.

Internally FSO also refers to this as the "laser threat warning".

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Lock Filename:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Needs to be an [[Multimedia_Files#ANI|ani]] with a least 2 frames. The 1st frame is "no warning", the rest of the frames are cycled through when a warning is active. Frames cycle twice as fast when a lock has been acquired, compared to when a lock is being acquired.

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Dumbfire Offsets:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Lock Offsets:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Lock Filename:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Locked Filename:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Lock Center Offsets:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Locked Center Offsets:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Radius:====
Defines the distance from the center of the screen to the base of the Hostile Triangle gauge.

*Syntax: '''Integer'''
*Default value:
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Hostile Triangle:|+Hostile Triangle:]]

====Triangle Base:====
Defines the width of the Hostile Triangle's base.

*Syntax: '''Float'''
*Default value:
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Hostile Triangle:|+Hostile Triangle:]]

====Triangle Height:====
Defines the height of the Hostile Triangle.

*Syntax: '''Float'''
Default value:
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Hostile Triangle:|+Hostile Triangle:]]

====Center Offsets:====

Used by: [[Hud_gauges.tbl#+Lead Indicator:|+Lead Indicator:]]

====Single Primary Filename:====
Designates the file to use for primary linking for ships with a single primary bank.

Needs to be an [[Multimedia_Files#ANI|ani]] with 2 frames; 1st is bank 1 not selected (not that this should ever be able to happen), 2nd is bank 1 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Primary Filename:====

Designates the file to use for primary linking for ships with two primary banks.

Needs to be an [[Multimedia_Files#ANI|ani]] with 4 frames:
* Frame 0 is no banks selected
* Frame 1 is 1st bank selected
* Frame 2 is 2nd bank selected
* Frame 3 is both banks selected/linked

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Single Secondary Filename:====

Designates the file to use for selected secondary bank for ships with a single secondary bank.

Needs to be an [[Multimedia_Files#ANI|ani]] with 2 frames; 1st is bank 1 not selected, 2nd is bank 1 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Secondary Filename:====

Designates the file to use for selected secondary bank for ships with two secondary banks.

Needs to be an [[Multimedia_Files#ANI|ani]] with 3 frames; 1st is no banks selected, 2nd is bank 1 selected, 3rd is bank 2 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Triple Secondary Filename:====

Designates the file to use for selected secondary bank for ships with two secondary banks.

Needs to be an [[Multimedia_Files#ANI|ani]] with 4 frames; 1st is no banks selected, 2nd is bank 1 selected, 3rd is bank 2 selected, 4th is bank 3 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Single Primary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Primary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Single Secondary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Secondary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Triple Secondary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Hidden By Comms Menu:====
{{Table3615|
Defines whether the messages gauge may be drawn at the same time as the wingman comms menu.
*Syntax: '''Boolean'''
*Default Value: '''false''' (messages are not visible while the comms menu is open)
Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]}}

====Bottom Background Offset:====
{{Table3615|
Defines the vertical pixel offset added to the position of the bottom background frame.
*Syntax: '''Integer''' vertical offset
*Units: Pixels
Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]}}

====Center Text On Gauge X-Position:====
{{Table375|
Sets whether to position the center of the text to the gauge's X-position.
*Syntax '''Boolean'''
*Default Value: '''false''' if the gauge is explicitly given a position, '''true''' otherwise
Used by: [[Hud_gauges.tbl#+Fixed Messages:|+Fixed Messages:]]}}

====N-gon Sides:====
{{Table190|
Defines the number of sides an N-gon radar has. If defined, the standard radar's edge is drawn as an N-gon, instead of the standard ellipsoid. Blips that are projected outside of the N-gon are snapped to the edge: the blip's angle stays the same but the blip's radius to the center of the plot area is reduced.
*Syntax '''Integer'''
*Default Value: '''0''' A value of 0 means to use the standard ellipsoid radar
*Minimum value: '''3''' (which is a triangle)
Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]}}

====N-gon Offset:====
{{Table190|
Defines the angular offset to apply to the N-gon perimeter. The first vertex is at the 3 o'clock position, positive offsets spin this vertex counter-clockwise, negative offsets spin this clockwise.
*Syntax '''Float''' (radians)
*Default Value: '''0'''
Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]}}

[[Category:Tables]]

Hud gauges.tbl

2020-12-18T00:33:05Z

Z64555: /* Gauge Configuration Options */ Add `N-gon Sides` and `N-gon offset`

{{SCP table}}
{{TableVersionGit|2016-09-14|f9bc01c}}
{{Tables}}
The '''hud_gauges.tbl''' is used for modifying the elements of the HUD. Not all gauges can be modified. However, custom gauges may be added to mimic their behavior (such as the wingman status display).

HUD Elements in FS2 are called Gauges, and each gauge has various options to customize appearance and, in some cases, their behavior as well.

This table is one of the [[Modular Tables]] and can be extended with xxx-hdg.tbm

==HUD Configurations==
The following entries are used on the HUD system, but have not been grouped with any particular gauge.

===$Load Retail Configuration:===
Optional. If yes, any gauge missing from the HUD gauge definitions below will be loaded using the retail defaults.

If no, any missing (default) gauge will prompt an error.

*Syntax: '''Boolean'''

===$Color:===
Optional. Sets the default HUD color for all gauges.

*Syntax: ('''Integer''' Red, '''Integer''' Green, '''Integer''' Blue)
*Valid Values: all values from 0 to 255

===$Font:===
Optional. Sets the font type to use for the HUD. This can either be a string or a number. A string references a font with a specific name while a number references a font with a specific index in the fonts table. The number option is deprecated and is only there for backwards-compatibility. Use the name if possible.

*Syntax: '''String''' or '''Integer''' font index number
*Valid Values: Any name or font index as defined in [[Fonts.tbl]]

===$Chase View Only:===
{{Table381|
Optional. Sets gauges to be displayed only in Chase View.

*Syntax: '''Boolean'''
*Default Value: '''False'''
}}

===$Max Directives:===
Optional. Sets the default maximum number of directives displayed simultaneously.

*Syntax: '''Integer''' maximum number of directives
*Valid Values: Any positive number
*Default Value: '''5'''

===$Max Escort Ships:===
Optional. Sets the default maximum number of escort ships to be shown in the escort list.

*Syntax: '''Integer'''
*Valid Values: Any positive number
{{Warning|
Entries more than 16 will cause the list to overflow into the weapons list for resolutions lower than 1024x768.}}

===$Length Unit Multiplier:===
Optional. Sets the multiplier to applied to the reported distances. For example, if the multiplier is 0.5, then the distance reported to the player will (or at least should) be 0.5 x actual distance.

*Syntax: '''Float'''
*Valid Values: Any positive number

===$Speed Unit Multiplier:===
Optional. Analogous to [[Hud_gauges.tbl#$Length Unit Multiplier:|$Length Unit Multiplier]], this sets the multiplier to be applied to all speeds reported to the player. For example, if the multiplier is 0.5, the the speed reported to the player will (or at least should) be 0.5 x actual speed.

*Syntax: '''Float'''
*Valid Values: Any positive number
*Default Values:
:'''The value used in $Length Unit Multiplier''', or
:'''1''', if $Length Unit Multiplier is undefined

===$Wireframe Targetbox:===
Optional. Defines the default draw method for the target viewer (a.k.a. targetbox).

*Syntax: '''Integer''' Draw method ID
*Valid Values:
::'''0''' - Standard with full, bright lighting
::'''1''' - Wireframe
::'''2''' - Standard with proper lighting (i.e. lit the same as the actual target)
{{Table3615|
::'''3''' - Untextured with full bright lighting (i.e. drawn with a single flat color)}}

===$Targetbox Shader Effect:===
{{Table3615|
Optional. If set, defines a unique ID for a shader effect to be used when rendering a ship for the targeting box. The ID will be passed to the main shader as in [[Post_processing.tbl##Ship_Effects|#Ship_Effects]], but a table entry for the effect is not needed.

*Syntax: '''Integer'''
*Valid Values: Any positive number
}}

===$Lock Wireframe Mode:===
Optional. If set, prevents targetbox draw method from being changed during the gaming session.
*Syntax: '''Boolean'''

===$Scale Gauges:===
{{Table371|
Optional. If set, all gauges will use this value as the default for scaling individual gauge sizes (i.e. doesn't affect gauges that use Position:, and doesn't affect the values of Offset:. In addition, if "$Load Retail Configuration:" is true then all unspecified retail gauges will use this value.

If not set, defaults to yes.

*Syntax: '''Boolean'''
}}

===$Force Scaling Above:===
{{Table373|
Optional. If gauge scaling is disabled, then gauges will be scaled as though the base resolution were this resolution or the real base resolution, whichever is greater.

Use this to disable scaling at lower resolutions while preventing gauges from getting too small at higher resolutions.

To disable this feature, use '''(-1, -1)'''.

*Syntax: ('''Integer''' width, '''Integer''' height)
}}

===$Reticle Style:===
Optional. Defines which aiming reticle to use.
*Syntax: '''String'''
*Valid Values:
:'''FS1''' - uses '''''reticle1_fs1.ani'''''
:'''FS2''' - uses '''''reticle1.ani'''''

==#Gauge Config==
The following entries define default gauge appearance and behavior. Each gauge has the option of overriding these options.

===$Ship:===
Deprecated and superceded by $Ships in FSO revision 9208. If defined, the following config data will only be used if the player ship is of the supplied ship class. Can be defined multiple times within a #Gauge config group to allow unique HUD configurations per ship class.

If not defined, all following config data will be applied to all ships.

*Syntax: '''String''', ship class name

===$Ships:===
Optional. Can be used to define a list of ships the hud definition that follows will be applied to. Can be defined multiple times within a #Gauge config group to allow unique HUD configurations per ship class.

If not defined, all following config data will be applied to all ships.

*`Syntax: '''( "Class name 1" "Class name 2" )''', ship class names formatted like a flag list.

====$Load Retail Configuration:====
Optional. Overrides the [[Hud_gauges.tbl#$Load Retail Configuration: 1|$Load Retail Configuration]] global option for this ship class.

*Syntax: '''Boolean'''

====$Color:====
Optional. Overrides the [[Hud_gauges.tbl#$Color: 1|$Color]] global option for this ship class.

*Syntax: See [[Hud_gauges.tbl#$Color: 1|$Color]]

====$Font:====
Optional. Overrides the [[Hud_gauges.tbl#$Font: 1|$Font]] global option for this ship class.

*Syntax: See [[Hud_gauges.tbl#$Font: 1|$Font]]

====$Chase View Only:====
{{Table381|
Optional. Overrides the [[Hud_gauges.tbl#$Chase View Only: 1|$Chase View Only]] global option for this ship class.

*Syntax: See [[Hud_gauges.tbl#$Chase View Only: 1|$Chase View Only]]
}}

===$Base:===
Required. Defines the base resolution for this HUD configuration, upon which other gauge options (such as [[Hud_gauges.tbl#Position:|Position:]] / [[Hud_gauges.tbl#Origin:|Origin:]] / [[Hud_gauges.tbl#Offset:|Offset:]]) will use as its coordinate system.

*Syntax: ('''Integer''' width, '''Integer''' height)
*Valid Values: All supported resolutions (?)

===$Scale Gauges:===
{{Table371|
Optional. If set, will configure gauges Scaling behaviour for gauges in this #Gauge Config section. i.e. overriding the default, or the value specified at the top of the file. Individual gauges can override this setting.

*Syntax: '''Boolean'''
}}

===$Force Scaling Above:===
{{Table373|
Optional. If gauge scaling is disabled, then gauges will be scaled as though the base resolution were this resolution or the real base resolution, whichever is greater.

Use this to disable scaling at lower resolutions while preventing gauges from getting too small at higher resolutions.

To disable this feature, use '''(-1, -1)'''.

*Syntax: ('''Integer''' width, '''Integer''' height)
}}

===$Required Aspect:===
Optional. If set, this configuration will only be loaded for the specified aspect ratios.

Used as a filter when there are multiple $Base: resolutions in the table

*Syntax: '''String'''
*Valid Values:
:"Full Screen" (4:3, aspect ratio < 1.5)
:"Wide Screen" (16:9, 16:10, or similar, aspect ratio >= 1.5)

===$Min:===
Optional. Minimum resolution for this config. Any resolution lower than specified will not use this configuration.

Used as a filter when there are multiple $Base: resolutions in the table

*Syntax: ('''Integer''' width, '''Integer''' height)
*Valid Values: All supported resolutions (?)

===$Max:===
Optional. Maximum resolution for this config. Any resolution higher than specified will not use this configuration.

Used as a filter when there are multiple $Base: resolutions in the table

*Syntax: ('''Integer''' width, '''Integer''' height)
*Valid Values: All supported resolutions (?)

===$Gauges:===
Following entries define gauge-specific behavior. For the most part, each gauge has its own overrides that, if not defined, would otherwise use the global values.

Since many gauges have the same configuration options, each gauge entry has a list of valid sub-entries. Unless stated otherwise, these options must be defined in the same order as they are shown, starting from the top and ending at the bottom.

====+Custom:====
Adds a custom gauge type.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Name:|Name:]]
:[[Hud_gauges.tbl#Text:|Text:]]
:[[Hud_gauges.tbl#X Offset:|X Offset:]] (Optional)
:[[Hud_gauges.tbl#Y Offset:|Y Offset:]] (Optional)
:[[Hud_gauges.tbl#Gauge Type:|Gauge Type:]]
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Active by default:|Active by default:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]

{{table381|
====+Scripted Gauge:====
Adds a scripted gauge type.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Name:|Name:]]
}}

====+Messages:====
Adds a gauge that display mission messages.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Max Lines:|Max Lines:]] (Optional)
:[[Hud_gauges.tbl#Max Width:|Max Width:]] (Optional)
:[[Hud_gauges.tbl#Line Height:|Line Height]] (Optional)
:[[Hud_gauges.tbl#Total Lifetime:|Total Lifetime:]] (Optional)
:[[Hud_gauges.tbl#Scroll Time:|Scroll Time]] (Optional)
:[[Hud_gauges.tbl#Step Size:|Step Size:]] (Optional)
:[[Hud_gauges.tbl#Hidden By Comms Menu:|Hidden By Comms Menu:]] (Optional)

====+Training Messages:====
Adds a text box, like the ones seen in the FS1 and FS2 training missions.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}

====+Support:====
Adds a text box that shows the Support ship's status and ETA

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Text Y-offset:|Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Dock Status X-offset:|Dock Status X-offset:]] (Optional)
:[[Hud_gauges.tbl#Dock Time X-offset:|Dock Time X-offset:]] (Optional)

====+Damage:====
Adds a gauge that shows how much damage a target (or the player?) has.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Hull Integrity Offsets:|Hull Integrity Offsets]] (Optional)
:[[Hud_gauges.tbl#Hull Integrity Value X-offset:|Hull Integrity Value X-offset]] (Optional)
:[[Hud_gauges.tbl#Top Background Height:|Top Background Height:]] (Optional)
:[[Hud_gauges.tbl#Subsystem Entry Height:|Subsystem Entry Height:]] (Optional)
:[[Hud_gauges.tbl#Subsystem List Start Offsets:|Subsystem List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Subsystem Entry Value X-offset:|Subsystem Entry Value X-offset:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Offset:|Bottom Background Offset:]] (Optional)

====+Wingman Status:====
Adds a gauge that monitors the status of your wing and squadron.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Left Background Filename:|Left Background Filename:]] (Optional) (needs an animation with one frame)
{{table3615|
:[[Hud_gauges.tbl#First Background Filename:|First Background Filename:]] (Optional) (needs an animation with one frame)}}
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional) (needs an animation with one frame)
:[[Hud_gauges.tbl#Right Background Filename:|Right Background Filename:]] (Optional) (needs an animation with one frame)
{{table3615|
:[[Hud_gauges.tbl#Last Background Filename:|Last Background Filename:]] (Optional) (needs an animation with one frame)}}
:[[Hud_gauges.tbl#Dot Filename:|Dot Filename:]] (Optional) (needs an animation with two frames, 1st is for alive wingmen, 2nd is for dead or missing wingmen)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
{{table373|
[[Hud_gauges.tbl#Fixed Header Position:|Fixed Header Position:]] (Optional)}}
:[[Hud_gauges.tbl#Left Background Width:|Left Background Width:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#First Background Size:|First Background Size:]] (Optional)}}
:[[Hud_gauges.tbl#Entry Width:|Entry Width:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Entry Size:|Entry Size:]] (Optional)
:[[Hud_gauges.tbl#Right Background Offset:|Right Background Offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Offset:|Last Background Offset:]] (Optional)}}
:[[Hud_gauges.tbl#Single Wing Offsets:|Single Wing Offsets:]] (Optional)
:[[Hud_gauges.tbl#Multiple Wing Start Offsets:|Multiple Wing Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Wing Name Offsets:|Wing Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Dot Offsets:|Dot Offsets:]] (Optional)
:[[Hud_gauges.tbl#Expansion Mode:|Expansion Mode:]] (Optional)

====+Auto Speed:====
Adds the Auto-Speed mode gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (needs animation with 4 frames, 3rd is without auto-match-speed enabled, 4th is with... and frames 0 & 1 are not used, done this way because retail fs2 uses the same animation file for the auto speed & auto targeting gauges)
:[[Hud_gauges.tbl#Auto Offsets:|Auto Offsets:]] (Optional)
:[[Hud_gauges.tbl#Speed Offsets:|Speed Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#On Text Color:|On Text Color:]] (Optional)
:[[Hud_gauges.tbl#On Text Color:|Off Text Color:]] (Optional)}}

====+Auto Target:====
Adds the Auto-target mode gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (needs animation with 2 frames, 1st is without auto-targeting enabled, 2nd is with)
:[[Hud_gauges.tbl#Auto Offsets:|Auto Offsets:]] (Optional)
:[[Hud_gauges.tbl#Target Offsets:|Target Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#On Text Color:|On Text Color:]] (Optional)
:[[Hud_gauges.tbl#On Text Color:|Off Text Color:]] (Optional)}}

====+Countermeasures:====
Adds a gauge that monitors the amount of remaining countermeasures the player's ship currently has.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (needs an animation with a single frame)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
:[[Hud_gauges.tbl#Value Offsets:|Value Offsets:]] (Optional)

====+Talking Head:====
Adds a video window to display pilot message videos (a.k.a talking heads).

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Animation Offsets:|Animation Offsets:]] (Optional)
:[[Hud_gauges.tbl#Animation Background Size:|Animation Background Size:]] (Deprecated)
{{table373|
:[[Hud_gauges.tbl#Animation Size:|Animation Size:]] (Optional)
}}

====+Directives:====
Adds a gauge that displays all currently active directives (includes current , completed, and failed)

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional) (needs animation with one frame)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional) (needs animation with one frame)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional) (needs animation with one frame)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Background Height:|Top Background Height:]] (Optional)
:[[Hud_gauges.tbl#List Start Offsets:|List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Bottom Background Offset:|Bottom Background Offset:]] (Optional)
:[[Hud_gauges.tbl#Max Line Width:|Max Line Width:]] (Optional)
}}

====+Weapons:====
Adds a weapon status and ammunition gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Primary List Top Background Filename:|Primary List Top Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Primary List Middle Background Filename:|Primary List Middle Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Primary List Bottom Background Filename:|Primary List Bottom Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Secondary List Top Background Filename:|Secondary List Top Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Secondary List Entry Background Filename:|Secondary List Entry Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Secondary List Bottom Background Filename:|Secondary List Bottom Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
::[[Hud_gauges.tbl#Alt Ballistic Offsets:|Alt Ballistic Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Primary Background X-offset:|Top Primary BackgroundX-offset:]] (Optional)
::[[Hud_gauges.tbl#Alt Ballistic X-offset:|Alt Ballistic X-offset:]] (Optional)
:[[Hud_gauges.tbl#Text X-offset:|Text X-offset:]] (Optional)
::[[Hud_gauges.tbl#Alt Ballistic X-offset:|Alt Ballistic X-offset:]] (Optional)
:[[Hud_gauges.tbl#Top Primary Frame Height:|Top Primary Frame Height:]] (Optional)
:[[Hud_gauges.tbl#Top Secondary Frame Height:|Top Secondary Frame Height:]] (Optional)
:[[Hud_gauges.tbl#Primary List Start Y-offset:|Primary List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary List Start Y-offset:|Secondary List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Ammo X-offset:|Primary Weapon Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Link X-offset:|Primary Weapon Link X-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Name X-offset:|Primary Weapon Name X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Ammo X-offset:|Secondary Weapon Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Linked X-offset:|Secondary Weapon Linked X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Name X-offset:|Secondary Weapon Name X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Reload X-offset:|Secondary Weapon Reload X-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Entry Height:|Primary Weapon Entry Height:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Entry Height:|Secondary Weapon Entry Height:]] (Optional)

====+Objective notify:====
Adds a Objective notifier gauge. This gauge alerts the player when receiving a new objective, or when an objective has been completed or failed. Additionally, this gauge alerts the player when entering subspace, and when a Red Alert mission orders are being received (prior to a forced subspace jump).

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Objective Text Y-offset:|Objective Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Objective Value Y-offset:|Objective Value Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Subspace Text Y-offset:|Subspace Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Subspace Value Y-offset:|Subspace Value Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Red Alert Text Y-offset:|Red Alert Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Red Alert Value Y-offset:|Red Alert Value Y-offset:]] (Optional)

====+Squad Message====
Adds the squad message gauge. In FS1 and FS2, this gauge is used to send commands to your squad. (?)

*Valid sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#List Start Offsets:|List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Background Height:|Top Background Height:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Bottom Background Offset|Bottom Background Offset]] (Optional)}}
:[[Hud_gauges.tbl#Command X-offset:|Command X-offset:]] (Optional)
:[[Hud_gauges.tbl#Page Up Offsets:|Page Up Offsets:]] (Optional)
:[[Hud_gauges.tbl#Page Down Offsets:|Page Down Offsets:]] (Optional)

====+Lag:====
Adds a Lag gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]

====+Mini Target Shields:====
Adds a mini Target shields gauge. In FS1 and FS2, the Mini Target Shield gauge is the one right below the center reticle, and shows the hull damage in %

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (animation needs 8 frames; 0->3 are the top, right, bottom & left shield quads; 4->7 are the same except brighter for when the quad is flashing from being hit)
:[[Hud_gauges.tbl#3 Digit Hull Offsets:|3 Digit Hull Offsets:]] (Optional)
:[[Hud_gauges.tbl#2 Digit Hull Offsets:|2 Digit Hull Offsets:]] (Optional)
:[[Hud_gauges.tbl#1 Digit Hull Offsets:|1 Digit Hull Offsets:]] (Optional)

====+Player Shields:====
Adds a gauge that shows the shield and hull status icon of the player's craft or ship.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)

====+Target Shields:====
Adds a gauge that shows the shield and hull status icon of the targeted craft or ship.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)

====+Escort View:====
Adds an escort monitor/view gauge. This gauge monitors the status of all ships assigned to the player to escort.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height]] (Optional)
:[[Hud_gauges.tbl#Entry Stagger Width:|Entry Stagger Width:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Bottom Background Offset:|Bottom Background Offset:]] (Optional)}}
:[[Hud_gauges.tbl#Header Text:|Header Text]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#List Start Offsets:|List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Hull X-offset:|Hull X-offset]] (Optional)
:[[Hud_gauges.tbl#Name X-offset:|Name X-offset]] (Optional)
:[[Hud_gauges.tbl#Status X-offset:|Status X-offset]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Ship Name Max Width:|Ship Name Max Width:]] (Optional)}}
{{table373|
:[[Hud_gauges.tbl#Right-Align Ship Names:|Right-Align Ship Names:]] (Optional)}}

====+Mission Time:====
Adds a gauge that displays the current mission time.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
:[[Hud_gauges.tbl#Value Offsets:|Value Offsets:]] (Optional)

====+ETS Retail:====
{{Table3613|
Draws the three other ETS gauges as a single gauge. Will automatically rearrange itself (like retail) if shields or other systems are missing.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
{{Table3613|
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)
:[[Hud_gauges.tbl#Gauge Offset:|Gauge Offset:]] (Optional)

}}

====+ETS Weapons:====
Adds a gauge that displays the energy transfer rate for the energy weapons.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)

====+ETS Engines:====
Adds a gauge that displays the energy transfer rate for the afterburner/engines.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)

====+ETS Shields:====
Adds a gauge that displays the energy transfer rate for the shields.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)

====+Target Monitor:====
Adds a target monitor gauge that shows the targeted ship's relative orientation and hull strength, among other things.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Monitor Filename:|Monitor Filename:]] (Optional) (needs animation with 2 frames, 1st is the background for the target, 2nd is the border; rendered last)
{{table3615|
:[[Hud_gauges.tbl#Monitor Alpha Mask Filename:|Monitor Alpha Mask Filename:]] (Optional) (needs animation with a single frame)}}
:[[Hud_gauges.tbl#Integrity Bar Filename:|Integrity Bar Filename:]] (Optional) (needs animation with 2 frames, 1st is a zero/dark filled bar, 2nd is a max/bright filled bar)
:[[Hud_gauges.tbl#Viewport Offsets:|Viewport Offsets:]] (Optional)
:[[Hud_gauges.tbl#Viewport Size:|Viewport Size:]] (Optional)
:[[Hud_gauges.tbl#Integrity Bar Offsets:|Integrity Bar Offsets:]] (Optional)
:[[Hud_gauges.tbl#Integrity Bar Foreground Clip Height:|Integrity Bar Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Status Offsets:|Status Offsets:]] (Optional)
:[[Hud_gauges.tbl#Name Offsets:|Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Class Offsets:|Class Offsets:]] (Optional)
:[[Hud_gauges.tbl#Distance Offsets:|Distance Offsets:]] (Optional)
:[[Hud_gauges.tbl#Speed Offsets:|Speed Offsets:]] (Optional)
:[[Hud_gauges.tbl#Hull Offsets:|Hull Offsets:]] (Optional)
:[[Hud_gauges.tbl#Cargo Contents Offsets:|Cargo Contents Offsets:]] (Optional)
:[[Hud_gauges.tbl#Cargo Scan Start Offsets:|Cargo Scan Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Cargo Scan Size:|Cargo Scan Size:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Subsystem Name Offsets:|Subsystem Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Subsystem Integrity Offsets:|Subsystem Integrity Offsets:]] (Optional)
:[[Hud_gauges.tbl#Disabled Status Offsets:|Disabled Status Offsets:]] (Optional)
:[[Hud_gauges.tbl#Desaturate:|Desaturate:]] (Optional)
}}

====+Extra Target Data:====
Adds a gauge that displays "extra" target data, such as its current orders and docking status.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs an animation with 1 frame)
:[[Hud_gauges.tbl#Bracket Offsets:|Bracket Offsets:]] (Optional)
:[[Hud_gauges.tbl#Dock Offsets:|Dock Offsets:]] (Optional)
{{table373|
:[[Hud_gauges.tbl#Dock Max Width:|Dock Max Width:]] (Optional)}}
:[[Hud_gauges.tbl#Order Offsets:|Order Offsets:]] (Optional)
{{table373|
:[[Hud_gauges.tbl#Order Max Width:|Order Max Width:]] (Optional)}}
:[[Hud_gauges.tbl#Time Offsets:|Time Offsets:]] (Optional)

====+Radar:====
Adds a standard radar gauge

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs animation with 2 frames, only the 2nd frame is used)
{{table373|
:[[Hud_gauges.tbl#Radar Center Offsets:|Radar Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Radar Size:|Radar Size:]] (Optional)
}}
:[[Hud_gauges.tbl#Infinity Distance Offsets:|Infinity Distance Offsets]] (Optional)
:[[Hud_gauges.tbl#Long Distance Offsets:|Long Distance Offsets:]] (Optional)
:[[Hud_gauges.tbl#Short Distance Offsets:|Short Distance Offsets:]] (Optional)

====+Radar Orb:====
Adds a 3D orb radar gauge

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs animation with 2 frames, only the 2nd frame is used)
{{table373|
:[[Hud_gauges.tbl#Radar Center Offsets:|Radar Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Radar Size:|Radar Size:]] (Optional)
}}
:[[Hud_gauges.tbl#Infinity Distance Offsets:|Infinity Distance Offsets]] (Optional)
:[[Hud_gauges.tbl#Long Distance Offsets:|Long Distance Offsets:]] (Optional)
:[[Hud_gauges.tbl#Short Distance Offsets:|Short Distance Offsets:]] (Optional)

====+Radar BSG:====
Adds a BSG style radar (a.k.a DRADIS).

:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Size:|Size:]] (Optional)
:[[Hud_gauges.tbl#XY Disc Filename:|XY Disc Filename:]] (Optional)
:[[Hud_gauges.tbl#XZ YZ Disc Filename:|XZ YZ Disc Filename:]] (Optional)
:[[Hud_gauges.tbl#Sweep Disc Filename:|Sweep Disc Filename:]] (Optional)
:[[Hud_gauges.tbl#Default Contact Filename:|Default Contact Filename:]] (Optional)
:[[Hud_gauges.tbl#Unknown Contact Filename:|Unknown Contact Filename:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]]
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]]
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Loop Volume:|Loop Volume:]] (Optional)
:[[Hud_gauges.tbl#Minimum Beep Delay:|Minimum Beep Delay]] (Optional)

====+Afterburner Energy:====
Adds a gauge that shows the remaining afterburner energy. Note that it only supports a vertical fill.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs animation with 2 frames, the 1st is the bar lit for zero energy, the 2nd is the bar lit for max energy)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)

====+Weapon Energy:====
Adds a gauge that shows the remaining weapon energy. Note that it only supports a vertical fill.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs an animation with 4 frames, the 3rd is the bar lit for zero energy, the 2nd is the bar lit for max energy, frames 1 & 2 are not used)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Text Alignment:|Text Alignment:]] (Optional)
:[[Hud_gauges.tbl#Always Show Text:|Always Show Text:]] (Optional)
:[[Hud_gauges.tbl#Text Follows:|Text Follows:]] (Optional)
:[[Hud_gauges.tbl#Show Ballistic Ammo:|Show Ballistic Ammo:]] (Optional)
:[[Hud_gauges.tbl#Armed Guns List Offsets:|Armed Guns List Offsets:]] (Optional)
:[[Hud_gauges.tbl#Armed Guns List Alignment:|Armed Guns List Alignment:]] (Optional)
:[[Hud_gauges.tbl#Armed Guns List Entry Height:|Armed Guns List Entry Height:]] (Optional)
}}

====+Text Warnings:====
Adds a gauge that warns the player (current warnings are EMP, Launch, Evaded, Collision, Blast & Engine Wash).

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)

====+Center Reticle:====
Adds a "custom" center reticle.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Firepoint display:|Firepoint display:]] (Optional)
:[[Hud_gauges.tbl#Firepoint size:|Firepoint size:]] (Optional)
:[[Hud_gauges.tbl#Firepoint X coordinate multiplier:|Firepoint X coordinate multiplier:]] (Optional)
:[[Hud_gauges.tbl#Firepoint Y coordinate multiplier:|Firepoint Y coordinate multiplier:]] (Optional)

====+Throttle:====
Adds a gauge that shows the current throttle position.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Bottom Y-offset:|Foreground Clip Bottom Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Width:|Foreground Clip Width:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Afterburner Clip Height:|Afterburner Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Show Background:|Show Background:]] (Optional)
:[[Hud_gauges.tbl#Max Speed Label Offsets:|Max Speed Label Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Show Max Speed Label:|Show Max Speed Label:]] (Optional)}}
:[[Hud_gauges.tbl#Min Speed Label Offsets:|Min Speed Label Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Show Min Speed Label:|Show Min Speed Label:]] (Optional)}}
:[[Hud_gauges.tbl#Orbit Center Offsets:|Orbit Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Orbit Radius:|Orbit Radius:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Current Speed Offsets:|Current Speed Offsets:]] (Optional)
:[[Hud_gauges.tbl#Target Speed Offsets:|Target Speed Offsets:]] (Optional)
:[[Hud_gauges.tbl#Show Percentage:|Show Percentage:]] (Optional)
:[[Hud_gauges.tbl#Glide Status Offsets:|Glide Status Offsets:]] (Optional)
:[[Hud_gauges.tbl#Match Speed Status Offsets:|Match Speed Status Offsets:]] (Optional)
}}

====+Threat Indicator:====
Adds a gauge that indicates when a lock-on has been achieved by an attacker, and if the player is being shot at.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Arc Filename:|Arc Filename:]] (Optional)
:[[Hud_gauges.tbl#Dumbfire Filename:|Dumbfire Filename:]] (Optional)
:[[Hud_gauges.tbl#Lock Filename:|Lock Filename:]] (Optional)
:[[Hud_gauges.tbl#Dumbfire Offsets:|Dumbfire Offsets:]] (Optional)
:[[Hud_gauges.tbl#Lock Offsets:|Lock Offsets:]] (Optional)

====+Multiplayer Messages:====
Adds a gauge that displays the multiplayer messages.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}

====+Voice Status:====
Adds a gauge that displays the voice status.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}

====+Ping:====
Adds a gauge that the ping time to the multiplayer server.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}

====+Supernova:====
Adds a gauge that warns the player of an impending supernova shock wave.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}

====+Lock Indicator:====
Adds a Lock Indicator gauge.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Lock Filename:|Lock Filename:]] (Optional)
:[[Hud_gauges.tbl#Locked Filename:|Locked Filename:]] (Optional)
:[[Hud_gauges.tbl#Lock Center Offsets:|Lock Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Locked Center Offsets:|Locked Center Offsets:]] (Optional)

====+Offscreen Indicator:====
Adds an Offscreen Indicator.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}

====+Target Brackets:====
Adds a Target Bracket gauge. This is drawn around current target(s) and talkers.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Dot Filename:|Dot Filename:]] (Optional)

====+Hostile Triangle:====
Adds a gauge that points to the nearest attacker, if it is off-screen and is not currently targeted.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)
:[[Hud_gauges.tbl#Triangle Base:|Triangle Base:]] (Optional)
:[[Hud_gauges.tbl#Triangle Height:|Triangle Height:]] (Optional)

====+Target Triangle:====
Adds a gauge that points to the targeted craft, if it is currently off-screen.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)
:[[Hud_gauges.tbl#Triangle Base:|Triangle Base:]] (Optional)
:[[Hud_gauges.tbl#Triangle Height:|Triangle Height:]] (Optional)

====+Missile Triangles:====
Adds a gauge that is used during attempting to lock onto a target when using an aspect seeking missile.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)
:[[Hud_gauges.tbl#Triangle Base:|Triangle Base:]] (Optional)
:[[Hud_gauges.tbl#Triangle Height:|Triangle Height:]] (Optional)

====+Lead Indicator:====
Adds a gauge that leads (is in front) of the target. Aim your crosshairs at this indicator to increase probability of hitting the target.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
::Frame #0: Secondaries lead indicator (Dumbfire)
::Frame #1: Secondaries lead indicator (Homing)
::Frame #2: Primaries lead indicator
:[[Hud_gauges.tbl#Center Offsets:|Center Offsets:]] (Optional)

====+Orientation Tee:====
Adds a gauge that indicates the targeted craft's orientation in relation to the player's craft.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)

====+Lead Sight:====
Adds a gauge that lags (is behind) the target. Indicates where your shots will end up relative to the target's position. To score a hit, this gauge should be over the target. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
::Frame #0 is used for secondaries
::* If only one frame is found in the file, then it is used for primaries instead
::Frame #1 is used for primaries

====+Kills:====
Adds a gauge that keeps track of how many kills the player has scored during a mission.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
:[[Hud_gauges.tbl#Value Offsets:|Value Offsets:]] (Optional)

====+Weapon Linking:====
Adds a gauge that indicates the selected weapons and their firing rates.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Arc Filename:|Arc Filename:]] (Optional)
:[[Hud_gauges.tbl#Single Primary Filename:|Single Primary Filename:]] (Optional)
:[[Hud_gauges.tbl#Double Primary Filename:|Double Primary Filename:]] (Optional)
:[[Hud_gauges.tbl#Single Secondary Filename:|Single Secondary Filename:]] (Optional)
:[[Hud_gauges.tbl#Double Secondary Filename:|Double Secondary Filename:]] (Optional)
:[[Hud_gauges.tbl#Triple Secondary Filename:|Triple Secondary Filename:]] (Optional)
:[[Hud_gauges.tbl#Single Primary Offsets:|Single Primary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Double Primary Offsets:|Double Primary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Single Secondary Offsets:|Single Secondary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Double Secondary Offsets:|Double Secondary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Triple Secondary Offsets:|Triple Secondary Offsets:]] (Optional)

====+Fixed Messages:====

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table375|
:[[Hud_gauges.tbl#Center Text On Gauge X-Position:|Center Text On Gauge X-Position:]] (Optional)
}}

====+Flight Path Marker:====
{{table3615|
Adds a gauge that indicates the direction where your ship is traveling. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Center Offsets:|Center Offsets:]] (Optional)}}

====+Warhead Count:====
{{table3615|
Displays the name of the current secondary weapon. Tallies the ammo left. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs an animation with a single frame)
:[[Hud_gauges.tbl#Name Offsets:|Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Count Offsets:|Count Offsets:]] (Optional)
:[[Hud_gauges.tbl#Icon Width:|Icon Width:]] (Optional)
:[[Hud_gauges.tbl#Icon Height:|Icon Height:]] (Optional)
:[[Hud_gauges.tbl#Max Icons:|Max Icons:]] (Optional)
:[[Hud_gauges.tbl#Max Columns:|Max Columns:]] (Optional)
:[[Hud_gauges.tbl#Name Alignment:|Name Alignment:]] (Optional)
}}

====+Hardpoints:====
{{table3615|
Draws a silhouette of the player's ship and mounted weapons. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Size:|Size:]] (Optional)
:[[Hud_gauges.tbl#Line Width:|Line Width:]] (Optional)
:[[Hud_gauges.tbl#View Direction:|View Direction:]] (Optional)
:[[Hud_gauges.tbl#Show Primary Weapons:|Show Primary Weapons:]] (Optional)
:[[Hud_gauges.tbl#Show Secondary Weapons:|Show Secondary Weapons:]] (Optional)
}}

====+Primary Weapons:====
{{table3615|
Like the Weapons gauge but simpler. Only displays primary weapons. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Header Text:|Header Text:]] (Optional)
:[[Hud_gauges.tbl#First Background Filename:|First Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#First Background Height:|First Background Height:]] (Optional)
:[[Hud_gauges.tbl#First Background X-offset:|First Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Entry Background Height:|Entry Background Height:]] (Optional)
:[[Hud_gauges.tbl#Entry Background X-offset:|Entry Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Filename:|Last Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Last Background X-offset:|Last Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Y-offset:|Last Background Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
:[[Hud_gauges.tbl#List Start Y-offset:|List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Ammo X-offset:|Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Link X-offset:|Link X-offset:]] (Optional)
:[[Hud_gauges.tbl#Name X-offset:|Name X-offset:]] (Optional)
}}

====+Secondary Weapons:====
{{table3615|
Like the Weapons gauge but simpler. Only displays secondary weapons. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Header Text:|Header Text:]] (Optional)
:[[Hud_gauges.tbl#First Background Filename:|First Background Filename:]] (Optional)
:[[Hud_gauges.tbl#First Background Height:|First Background Height:]] (Optional)
:[[Hud_gauges.tbl#First Background X-offset:|First Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Height:|Entry Background Height:]] (Optional)
:[[Hud_gauges.tbl#Entry Background X-offset:|Entry Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Filename:|Last Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Last Background X-offset:|Last Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Y-offset:|Last Background Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
:[[Hud_gauges.tbl#List Start Y-offset:|List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Ammo X-offset:|Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Link X-offset:|Link X-offset:]] (Optional)
:[[Hud_gauges.tbl#Name X-offset:|Name X-offset:]] (Optional)
:[[Hud_gauges.tbl#Unlink X-offset:|Unlink X-offset:]] (Optional)
:[[Hud_gauges.tbl#Reload X-offset:|Reload X-offset:]] (Optional)
}}

===$End Gauges===
The Gauges section must end with $End Gauges. No Exceptions.

==#End==
The very last entry in the Hud_gauges.tbl must be #End. No Exceptions.

----
----

==Gauge Configuration Options==
Since a vast majority of gauges share the same entries, the configuration options for each gauge have been grouped here for formatting consistency.

====Position:====
Defines the screen coordinates for the upper left corner of this gauge.

*Syntax: '''Integer''' horizontal pixel, '''Integer''' vertical pixel position

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Training Messages:|+Training Messages:]], [[Hud_gauges.tbl#+Support:|+Support]] (and many others)

====Scale Gauge:====

{{table371|
Define if a gauge size will scale or not.

If false then gauge bitmaps will always show at their original size which may result in gauges being very small at high resolutions.

If true then gauge bitmaps will scale in proportion to the current resolution vs the base HUD resolution in use. This may result in gauges becoming blurry at non-base resolutions.

Defaults to yes/true.

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: '''Boolean''' scale_this_gauge

Used by: most gauges
}}

====Force Scaling Above:====

{{Table373|
Optional. If scaling is disabled for this gauge, then it will be scaled as though the base resolution were this resolution or the real base resolution, whichever is greater.

Use this to disable scaling at lower resolutions while preventing gauges from getting too small at higher resolutions.

To disable this feature, use '''(-1, -1)'''.

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: ('''Integer''' width, '''Integer''' height)

Used by: most gauges
}}

====Origin:====

{{table371|
Define gauge position as a ratio of the screen size (base or current, it doesn't matter).

Requires [[Hud_gauges.tbl#Offset:|Offset:]]

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: '''Float''' horizontal ratio 0.0 - 1.0, '''Float''' vertical ratio 0.0 - 1.0

Used by: most gauges
}}

====Offset:====

{{table371|
Define gauge offset from [[Hud_gauges.tbl#Origin:|Origin:]] in base resolution pixels

Requires [[Hud_gauges.tbl#Origin:|Origin:]]

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: '''Integer''' horizontal pixel offset from Origin:, '''Integer''' vertical pixel offset from Origin:

Used by: most gauges
}}

====Cockpit Target:====
The cockpit display that this gauge will be rendered to. Refers to the +Display Name: defined in [[ships.tbl#$Cockpit Display:|$Cockpit Display:]].

*Syntax: '''String''' String defined in +Display Name: in [[ships.tbl#$Cockpit Display:|$Cockpit Display:]]

=====Canvas Size:=====
The off-screen canvas this gauge will be rendered to before being interpolated into the actual cockpit display. The smaller this number is, the larger the gauge will appear on the cockpit display.

*Syntax: '''Integer''' width, '''Integer''' height

=====Display Offset:=====
The position of the canvas on the cockpit display texture

*Syntax: '''Integer''' width, '''Integer''' height

=====Display Size:=====
The interpolated size on the cockpit display texture that the canvas will be rendered to.

*Syntax: '''Integer''' width, '''Integer''' height

====Color:====
Optional. Overrides both previous color settings ([[Hud_gauges.tbl#$Color: 1|$Color]] HUD option and [[Hud_gauges#$Color: 2|$Color]] ship class option) for this particular gauge.

*Syntax: See [[Hud_gauges.tbl#$Color: 1|$Color:]]

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Font:====
Optional. Overrides both previous font settings ([[Hud_gauges.tbl#$Font: 1|$Font]] HUD option and [[Hud_gauges#$Font: 2|$Font]] ship class option) for this particular gauge.

*Syntax: See [[Hud_gauges.tbl#$Font: 1|$Font:]]

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Training Messages:|+Training Messages:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Name:====
Defines the name of this custom gauge.

*Syntax: '''String'''
*Max Length: 32 characters

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Text:====
Default text to be displayed. Can be altered using the hud-set-message, hud-set-text and hud-set-directive sexps.

*Syntax: '''String'''
*Max Length: 32 characters

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====X Offset:====
Optional. Defines the horizontal pixel offset (from the gauge's origin as defined by [[Hud_gauges.tbl#Position:|Position:]]) that the Text will be displayed.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Y Offset:====
Optional. Defines the vertical pixel offset (from the gauge's origin defined by [[Hud_gauges.tbl#Position:|Position:]]) that the Text will be displayed.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Gauge Type:====
Defines the type of gauge this is.

*Syntax: '''String'''
*Valid Values: Any one of the possible [[gauge types]].

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Slew:====
Optional. Determines whether or not this gauge is affected by afterburner shaking or similar effects. If set to "true", the gauge will not follow the player's head movements when using TrackIR/padlock. i.e. should be used for gauges like the gunsight/leadsight.

*Syntax: '''Boolean'''

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Max Lines:====
Optional. Specifies the maximum number of message lines that are displayed.

*Syntax: '''Integer'''
*Default Value: 3

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Max Width:====
Optional. Determines how long each message line may be.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Line Height:====
Optional. Determines the distance between line origins. (i.g. for a 12pt Font, there are needs to be at least 12 pixels between the bottom of one line and the next, otherwise the text will overlap each)

*Syntax: '''Integer'''
*Units: Pixels
*Default Value: 9

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Total Lifetime:====
Optional. Determines the maximum time the message gauge will be displayed from the time a new message is received.

*Syntax: '''Integer'''
*Units: milliseconds
*Default Value: 14000 (14 seconds)

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Scroll Time:====
Optional. Determines the time for the messages to scroll up one step.( See [[Hud_gauges.tbl#Step Size:|Step Size:]] )

*Syntax: '''Integer'''
*Units: milliseconds
*Default Value: 30

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Step Size:====
Optional. Determines how many pixels to shift message lines during scrolling. Messages will be shifted up by this amount until they are on the next line (as defined by [[Hud_gauges.tbl#Line Height:|Line Height:]])

*Syntax: '''Integer'''
*Units: Pixels
*Default Value: 3

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Active by default:====
Optional. Determines whether or not this gauge is always active, or only available after being activated via sexp.

*Syntax: '''Boolean'''

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Filename:====
Designates the [[Multimedia_Files#ANI|.ANI]] or [[Multimedia_Files#EFF|.EFF]] used for this gauge's background graphic.
{{Note| All HUD .ANI's must have the same color palette as the retail .ANI's in order to render properly. (.EFF's do not have this restriction)}}

*Syntax: '''Filename'''
**No filename extension is needed.

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Top Background Filename:====
Optional. Designates which file to use for the top background. (?)

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Damage|+Damage]]

====Bottom Background Filename:====
Optional. Designates which file to use for the Bottom background (?)

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Damage|+Damage]]

====Left Background Filename:====
Optional. Designates which file to use for the Left side of gauge.

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====First Background Filename:====
Optional. Alias for [[Hud_gauges.tbl#Left Background Filename:|Left Background Filename:]]

====Right Background Filename:====
Optional. Designates which file to use for the Right side of the gauge.

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Last Background Filename:====
Optional. Alias for [[Hud_gauges.tbl#Right Background Filename:|Right Background Filename:]]

====Entry Background Filename:====
Optional. Designates which file to use for the (Wing) Entry section of the gauge (aka the middle sections).

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Damage|+Damage]], [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Primary List Top Background Filename:====
Optional. Designates which file to use for the Primary List Top Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary List Middle Background Filename:====
Optional. Designates which file to use for the Primary List Middle Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary List Bottom Background Filename:====
Optional. Designates which file to use for the Primary List Bottom Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Top Background Filename:====
Optional. Designates which file to use for the Secondary List Top Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Entry Background Filename:====
Optional. Designates which file to use for the Secondary List Entry Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Bottom Background Filename:====
Optional. Designates which file to use for the Secondary List Bottom Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Alt Ballistic Filename:====
Optional. Designates an alternate file to be used for ballistic weapons.

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#Primary List Top Background Filename:|Primary List Top Background Filename]], [[Hud_gauges.tbl#Primary List Middle Background Filename:|Primary List Middle Background Filename]], [[Hud_gauges.tbl#Primary List Bottom Background Filename:|Primary List Bottom Background Filename]], [[Hud_gauges.tbl#Secondary List Top Background Filename:|Secondary List Top Background Filename]], [[Hud_gauges.tbl#Secondary List Entry Background Filename:|Secondary List Entry Background Filename]], [[Hud_gauges.tbl#Secondary List Bottom Background Filename:|Secondary List Bottom Background Filename]]

====Dot Filename:====
Optional. Designates which file to use for the wingman graphic (a.k.a. the Dot)

*Syntax: '''Filename'''

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Header Offsets:====
Optional. Designates the offset from the gauge's upper left corner for headers of various gauges

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels
*Valid Sub-entries:
:Weapons:
::[[Hud_gauges.tbl#Alt Ballistic Offsets:|Alt Ballistic Offsets:]]

Used by: [[Hud_gauges.tbl#+Support:|+Support:]], [[Hud_gauges.tbl#+Damage|+Damage:]], [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Fixed Header Position:====
Optional. If set, the header text will not change position when the gauge changes size.

*Syntax: '''Boolean'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Text Y-offset:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship Text. (?)

*Syntax: '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]]

====Text Offsets:====
Optional. Defines the screen position offsets for the text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: :[[Hud_gauges.tbl#+Countermeasures:|+Countermeasures:]]

====Value Offsets:====
Optional. Defines the screen position offsets for the value label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: :[[Hud_gauges.tbl#+Countermeasures:|+Countermeasures:]]

====Dock Status X-offset:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship's dock status. (?)

*Syntax: '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]]

====Dock Time X-offset:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship's dock time. (?)

*Syntax: '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]]

====Hull Integrity Offsets:====
Optional. Designates the offsets from the gauge's upper left corner for the for the Damage gauge Hull integrity textbox(?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Hull Integrity Value X-offset:====
Optional. Designates the offsets from the hull integrity textbox's upper left corner for the hull integrity value. (?)

*Syntax: '''Integer''' horizontal offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Top Background Height:====
Optional. Designates the height of the Top background (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Left Background Width:====
Optional. Defines the width of the Left Background.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Entry Width:====
Optional. Defines the width of the Entry Background (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Subsystem Entry Height:====
Optional. Designates the height of the Subsystem entry (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Subsystem List Start Offsets:====
Optional. Designates the offsets from the gauge's upper left corner for the for the start of the Subsytem List (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Subsystem Entry Value X-offset:====
Optional. Designates the horizontal offset from the Subsystem List's position (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Single Wing Offsets:====
Optional. Designates the offset from the gauge's upper left corner for a single wing (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Multiple Wing Start Offsets:====
Optional. Designates the offset from the gauge's upper left corner for multiple wings (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Wing Name Offsets:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship header (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Dot Offsets:====
Optional. Designates the offset from the gauge's upper left corner for the All wingman status icons.
*Syntax:
:'''Integer''' x, '''Integer''' y ;; Wingman 1
:'''Integer''' x, '''Integer''' y ;; Wingman 2
:'''Integer''' x, '''Integer''' y ;; Wingman 3
:'''Integer''' x, '''Integer''' y ;; Wingman 4
:'''Integer''' x, '''Integer''' y ;; Wingman 5
:'''Integer''' x, '''Integer''' y ;; Wingman 6
*Units: Pixels

{{Warning|
All 6 wingman positions must be defined}}

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Expansion Mode:====
Optional. Denotes which direction (in relation to the player's wing) that the other wings should be appended to the gauge

*Syntax: '''String'''
*Valid Values:
:*Right ;; Wings are added to the right of the previous wing

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Auto Offsets:====
Optional. Defines the screen coordinates for the "Auto" text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Auto Speed:|+Auto Speed:]], [[Hud_gagues.tbl#+Auto Target:|+Auto Target:]]

====Speed Offsets:====
Optional. Defines the screen coordinates for the "Speed" text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Auto Speed:|+Auto Speed:]]

====Target Offsets:====
Optional. Defines the screen coordinates for the "Target" text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Auto Target:|+Auto Target:]]

====Animation Offsets:====
Optional. Defines the offsets for the animation graphics.

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Talking Head:|+Talking Head:]]

====Animation Background Size:====
Deprecated. Originally, this set the size of the black box that's drawn behind the animation. Since Git revision 556e9a4 (2015-11-01), it has the same effect as [[Hud_gauges.tbl#Animation Size:|Animation Size:]].

*Syntax: '''Integer''' horizontal size, '''Integer''' vertical size
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Talking Head:|+Talking Head:]]

====Animation Size:====
{{table373|
Optional. Defines the size of the animation. All animations will be scaled to match this size.

*Syntax: '''Integer''' horizontal size, '''Integer''' vertical size
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Talking Head:|+Talking Head:]]
}}

====List Start Offsets:====
Optional. Defines the screen coordinate offsets for the start of the Directives list.

*Syntax: '''Integer''' x, '''Integer''' y
*Units: Pixels

Used by: [[Hud_guages.tbl#+Directives:|+Directives:]]

====Entry Height:====
Optional. Defines the height of each Directive

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_guages.tbl#+Directives:|+Directives:]]

====Alt Ballistic Offsets:====
Opetional. Defines the screen coordinate offsets for headers of ballistic weapons

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Header Offset:|+Header Offset:]]

====Top Primary Background X-offset:====
Optional. Defines the screen coordinate offset for the Top Primary Background

*Syntax: '''Integer'''
*Units: Pixels
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic X-offset:|Alt Ballistic X-offset:]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Text X-offset:====
(Optional) Defines the screen coordinate X-offset for weapon labels

*Syntax: '''Integer'''
*Units: Pixels
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic X-offset:|Alt Ballistic X-offset:]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Alt Ballistic X-offset:====
Optional. Defines the screen coordinate X-offset for ballistic weapons

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#Top Primary Background X-offset:|Top Primary Background X-offset:]], [[Hud_gauges.tbl#Text X-offset:|Text X-offset:]]

====Top Primary Frame Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Top Secondary Frame Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary List Start Y-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Start Y-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Ammo X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Link X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Name X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Ammo X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Linked X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Name X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Reload X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Entry Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Entry Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====3 Digit Hull Offsets:====
Designates the screen position offsets for the hull damage % when it is the 3 digit range (i.e. >= 100%)

*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Mini Target Shields:|+Mini Target Shields:]]

====2 Digit Hull Offsets:====
Designates the screen position offsets for the hull damage % when it is the 2 digit range (i.e. 100% > hull damage% >= 10%)

*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Mini Target Shields:|+Mini Target Shields:]]

====1 Digit Hull Offsets:====
Designates the screen position offsets for the hull damage % when it is the 1 digit range (i.e. 10% > hull damage% >= 0%)

*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Mini Target Shields:|+Mini Target Shields:]]

====Objective Text Y-offset:====
Designates the screen position offset for the Objective label

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Objective Value Y-offset====
Designates the screen position offset for the Objective value

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Subspace Text Y-offset:====
Designates the screen position offset for the Subspace label

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Subspace Value Y-offset====
Designates the screen position offset for the Subspace value (?)

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Red Alert Text Y-offset====
Designates the screen position offset for the Red Alert label

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Red Alert Value Y-offset====
Designates the screen position offset for the Red Alert value (?)

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Command X-offset:====
*Syntax: '''Integer''' x offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Squad Message:|+Squad Message:]]

====Page Up Offsets:====
*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Squad Message:|+Squad Message:]]

====Page Down Offsets:====
*Syntax: '''Integer''' x offset, ''' Integer y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Squad Message:|+Squad Message:]]

====Entry Height:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Entry Stagger Width:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Header Text:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Header Offsets:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====List Start Offsets:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Hull X-offset:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Name X-offset:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Status X-offset:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Ship Name Max Width:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Right-Align Ship Names:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Foreground Clip Height:====

* Sets the height, in pixels, of the gauge.
** For the [[Hud_gauges.tbl#+Throttle|Throttle]], sets the height of the gauge that represents 0% to 100% throttle. The total height of the gauge is the sum of this value and the [[Hud_gauges.tbl#Afterburner Clip Height:|Afterburner Clip Height]] value.
* Syntax: '''Integer'''

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]], [[Hud_gauges.tbl#+ETS Weapons:|+ETS Weapons]], [[Hud_gauges.tbl#+ETS Engines:|+ETS Engines]], [[Hud_gauges.tbl#+ETS Shields:|+ETS Shields]], [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor]], [[Hud_gauges.tbl#+Afterburner Energy|+Afterburner Energy]], [[Hud_gauges.tbl#+Weapon Energy|+Weapon Energy]], [[Hud_gauges.tbl#+Throttle:|+Throttle]]

====Letter Offsets:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Top Offsets:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Bottom Offsets:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Gauge Offset:====
*Distance between the individual weapon/shield/engine ETS gauges that comprise this gauge
*Syntax: '''Integer'''

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Monitor Filename:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Integrity Bar Filename:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Viewport Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Viewport Size:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Integrity Bar Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Integrity Bar Foreground Clip Height:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Status Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Name Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Class Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Speed Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Hull Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Cargo Contents Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Cargo Scan Start Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Cargo Scan Size:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Bracket Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Dock Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Dock Max Width:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Order Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Order Max Width:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Time Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Radar Center Offsets:====
Defines the radar's plot origin as an offset, in pixels, from this gauge's [[Hud_gauges.tbl#Position|Position]] coordinates
*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

====Radar Size:====
Size, in pixels, of the radar plot area.

Syntax: '''Integer''' horizontal size, '''Integer''' vertical size

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

====Infinity Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

Offset to draw the infinity radar range symbol.

====Long Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

Offset to draw the long range radar text (i.e. 10k).

====Short Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

Offset to draw the short range radar text (i.e. 2k).

====Size:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====XY Disc Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====XZ YZ Disc Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Sweep Disc Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Default Contact Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Unknown Contact Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Loop Volume:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG]]

====Minimum Beep Delay:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG]]

====Firepoint display:====
Displays the positions of the gun firepoints on your ship
*Syntax: '''Boolean''', YES or NO

NOTE: The position of the firepoints is calculated from the Eye Point position in the POF. You may encounter weird results if you have no Eye Point defined, but no debug warnings will be raised.

Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Firepoint size:====
Diameter of the gunpoint circles. '''Must be 4 or greater''' in order to work properly.
*Syntax: '''Integer'''

Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Firepoint X coordinate multiplier:====
Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Firepoint Y coordinate multiplier:====
Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Foreground Clip Bottom Y-offset:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Foreground Clip Width:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Afterburner Clip Height:====
* Sets the area of the throttle gauge that represents the Afterburner segment (which is on top of the 0% to 100% area). The total height of the gauge is determined by the sum of this value and [[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]]

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Show Background:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Max Speed Label Offsets:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Min Speed Label Offsets:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Orbit Center Offsets:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Orbit Radius:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Arc Filename:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Needs to be an [[Multimedia_Files#ANI|ani]] with a least 2 frames (but only the 2nd frame is used ?!?!? for threat & weapon linking so far)

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Dumbfire Filename:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Needs to be an [[Multimedia_Files#ANI|ani]] with a least 2 frames. The 1st frame is "no warning", the rest of the frames are cycled through when a warning is active.

Internally FSO also refers to this as the "laser threat warning".

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Lock Filename:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Needs to be an [[Multimedia_Files#ANI|ani]] with a least 2 frames. The 1st frame is "no warning", the rest of the frames are cycled through when a warning is active. Frames cycle twice as fast when a lock has been acquired, compared to when a lock is being acquired.

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Dumbfire Offsets:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Lock Offsets:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Lock Filename:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Locked Filename:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Lock Center Offsets:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Locked Center Offsets:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Radius:====
Defines the distance from the center of the screen to the base of the Hostile Triangle gauge.

*Syntax: '''Integer'''
*Default value:
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Hostile Triangle:|+Hostile Triangle:]]

====Triangle Base:====
Defines the width of the Hostile Triangle's base.

*Syntax: '''Float'''
*Default value:
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Hostile Triangle:|+Hostile Triangle:]]

====Triangle Height:====
Defines the height of the Hostile Triangle.

*Syntax: '''Float'''
Default value:
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Hostile Triangle:|+Hostile Triangle:]]

====Center Offsets:====

Used by: [[Hud_gauges.tbl#+Lead Indicator:|+Lead Indicator:]]

====Single Primary Filename:====
Designates the file to use for primary linking for ships with a single primary bank.

Needs to be an [[Multimedia_Files#ANI|ani]] with 2 frames; 1st is bank 1 not selected (not that this should ever be able to happen), 2nd is bank 1 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Primary Filename:====

Designates the file to use for primary linking for ships with two primary banks.

Needs to be an [[Multimedia_Files#ANI|ani]] with 4 frames:
* Frame 0 is no banks selected
* Frame 1 is 1st bank selected
* Frame 2 is 2nd bank selected
* Frame 3 is both banks selected/linked

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Single Secondary Filename:====

Designates the file to use for selected secondary bank for ships with a single secondary bank.

Needs to be an [[Multimedia_Files#ANI|ani]] with 2 frames; 1st is bank 1 not selected, 2nd is bank 1 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Secondary Filename:====

Designates the file to use for selected secondary bank for ships with two secondary banks.

Needs to be an [[Multimedia_Files#ANI|ani]] with 3 frames; 1st is no banks selected, 2nd is bank 1 selected, 3rd is bank 2 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Triple Secondary Filename:====

Designates the file to use for selected secondary bank for ships with two secondary banks.

Needs to be an [[Multimedia_Files#ANI|ani]] with 4 frames; 1st is no banks selected, 2nd is bank 1 selected, 3rd is bank 2 selected, 4th is bank 3 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Single Primary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Primary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Single Secondary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Secondary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Triple Secondary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Hidden By Comms Menu:====
{{Table3615|
Defines whether the messages gauge may be drawn at the same time as the wingman comms menu.
*Syntax: '''Boolean'''
*Default Value: '''false''' (messages are not visible while the comms menu is open)
Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]}}

====Bottom Background Offset:====
{{Table3615|
Defines the vertical pixel offset added to the position of the bottom background frame.
*Syntax: '''Integer''' vertical offset
*Units: Pixels
Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]}}

====Center Text On Gauge X-Position:====
{{Table375|
Sets whether to position the center of the text to the gauge's X-position.
*Syntax '''Boolean'''
*Default Value: '''false''' if the gauge is explicitly given a position, '''true''' otherwise
Used by: [[Hud_gauges.tbl#+Fixed Messages:|+Fixed Messages:]]}}

====N-gon Sides:====
{{Table190|
Defines the number of sides an N-gon radar has. If defined, the standard radar's edge is drawn as an N-gon, instead of the standard ellipsoid. Blips that are projected outside of the N-gon are snapped to the edge: the blip's angle stays the same but the blip's radius to the center of the plot area is reduced.
*Syntax '''Integer'''
*Default Value: '''0''' A value of 0 means to use the standard ellipsoid radar
*Minimum value: '''3''' (which is a triangle)
Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]}}

====N-gon Offset:====
{{Table190|
Defines the angular offset to apply to the N-gon perimeter. The first vertex is at the 3 o'clock position, positive offsets spin this vertex counter-clockwise, negative offsets spin this clockwise.
*Syntax '''Float''' (radians)
*Default Value: '''0'''
Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]}}

[[Category:Tables]]

Command-Line Reference

2020-11-24T13:30:38Z

Z64555: /* Launcher */ Document "-get_flags" option

{{TableVersionGit|2020-02-01|93f71ec20}}

Command-Line Flags (also called Command-Line Parameters) are optional flags passed to the FSO executable, and generally enables one or more features added to the FS2 Open engine. These flags are accessed conveniently through an [[FSO Launcher]]. To have FSO list all available flags, use any one of the following: [[Command-Line_Reference#-help|-help]], [[Command-Line_Reference#-help|--help]], [[Command-Line_Reference#-help|-h]], or [[Command-Line_Reference#-help|-?]].

===Graphics===

====-nospec====
{{Table37|
'''"Disable Specular"'''

Disables support for specular mapping.
}}

====-noglow====
{{Table37|
'''"Disable glow maps"'''

Disables support for glowmapping.
}}

====-noenv====
{{Table37|
'''"Disable environment maps"'''

Disables support for environment mapping.
}}

====-nonormal====
{{Table37|
'''"Disable normal maps"'''

Disables support for normal mapping.
}}

====-emissive_light====
{{Table190|
'''"Enable emissive light from ships"'''

In retail FS2, ships had a pseudo light source applied to them to make them stand out against the background. Due to the changes in the render pipeline associated with HDR, this behaviour has been disabled by default; this cmdline option restores it.
}}

====-noheight====
{{Table37|
'''"Disable height maps"'''

Disables support for height mapping.
}}

====-3dshockwave====
'''"Enable 3D Shockwaves"'''

This only has any effect when both a 2D and 3D shockwave effect are present, otherwise the only available effect is used (2D shockwave is defined by effects/shockwave01.eff or .ani, and 3D shockwave by models/shockwave.pof)

Note that 3D shockwaves are usually flat discs that FSO scales up. The animated 2D billboards used by 2D shockwaves with the addition of [[Command-Line Reference#-soft_particles|soft particles]], may look better when intersecting with models (which shockwaves often do). Use at your discretion.

====-no_post_process====
{{Table190|
'''"Disable Post Processing"'''

Disables the use of post-processing effects as defined by the post_process.tbl. Bloom usage has an additional cmdline option for setting its value, most post processing effects are achieved in mission per the mission designer or can be enabled globally in the table. Since post-processing is required for nebula effects post-3.8, it has been enabled by default as of Release 19.
}}

====-soft_particles====
'''"Enable soft particles"'''

Applies a blending factor to particles depending on their proximity to geometry

====-aa====
{{Table202|
'''"Enable post-processing antialiasing"'''
This flag enables antialiasing. Because FSO uses a deferred renderer, hardware-driven AA methods like MSAA cannot be used; the engine includes the well-established FXAA and SMAA post-processing shaders to get antialiasing instead.
By default, the "Low" preset of the SMAA shader will be used. If that is insufficient, or if it is to taxing on the GPU, the -aa_preset commandline parameter can be used to choose a different preset; this parameter takes a numeric argument ranging from 0 to 6. 0-2 correspond to the Low, Medium and High FXAA presets, 3-6 to the Low, Medium, High and Ultra SMAA presets respectively. The impact of these presets, both in terms of performance and in terms of visuals, can be observed in the F3 lab: The number keys 0-6 can be used to switch through the various AA presets on the fly there.
}}

====-fxaa====
'''"Enable FXAA antialiasing"'''

Enables the FXAA anti-aliasing. Further information can be found here: http://www.hard-light.net/forums/index.php?topic=76145.0
There is an associated parameter -fxaa_preset, which takes a number from 0 to 7; these can be used to set the effect's quality. Note that, while there are up to 7 possible values for this parameter, there are only 3 presets available: a value of 0-3 corresponds to the "Low" preset, 4-6 gets you the "medium" preset, and 7 and up switches to the "High" preset.

This antialiasing mode should only be used on very old (read: 2005-2010 era) hardware. For all other systems, the -smaa flag (detailed below) should be used.
{{Table202|
This parameter has been deprecated in favour of the -aa parameter, as seen above
}}

====-smaa====
'''"Enable SMAA anti-aliasing"'''

Enables the SMAA anti-aliasing method. Like FXAA, this is a post-processing effect that provides an AA stage; It is a more advanced and therefore more resource-intensive effect, but generally produces higher-quality images.
Like -fxaa, there is a configurable flag -smaa_preset, which takes a number from 0 to 3; these correspond directly to the Low, Medium, High and Ultra presets of the SMAA shader.

It is possible to compare the effectiveness of the different AA shaders by using the F3 lab: Load up any ship model and a background, then use the number keys 0 to x to switch through the various AA methods. 0-2 correspond to FXAA Low, Medium and High, 3-6 correspond to SMAA Low, Medium, High and Ultra.
{{Table202|
This parameter has been deprecated in favour of the -aa parameter, as seen above
}}

====-nolightshafts====
'''"Disable lightshafts"'''

Disables Lightshafts even if a mission designer enables them via SEXP in a mission. This was previously documented as -flightshaftsoff but appears to have been changed to -nolightshafts for consistency before -flightshaftsoff was ever used in a released build.

====-fb_explosions====
'''"Enable Framebuffer Shockwaves"'''

Applies a framebuffer distortion effect to shockwaves

====-fb_thrusters====
'''"Enable Framebuffer Thrusters"'''

Applies a framebuffer distortion effect to Thrusters. NOTE: Only "point" thrusters are affected by this; modelled thrusters (as used on most retail models) are not affected by this.

====-no_deferred====
'''"Disable Deferred Lighting"'''

DESCRIPTION NEEDED

====-enable_shadows====
{{table373|
'''"Enable shadows"'''

Enables shadows where supported by the OpenGL version provided by the user's GPU. -shadow_quality can be used to control the quality level.
{{note|Currently doesn't support shadows for cockpits and show ship.}}
}}

===Game Speed===

====-no_vsync====
'''"Disable vertical sync"'''

===HUD===

====-fps====
'''"Show frames per second on HUD"'''

Displays current frames per second.

====-dualscanlines====
'''"Another Pair of Scanning Lines"'''

Adds a second pair of scanning lines to the target window when scanning an object.

====-targetinfo====
'''"Enable Info next to Target"'''

Displays target info, such as name and class, beside the targeted object.

====-orbradar====
'''"Enables 3D radar"'''

An Orb style 3D radar will replace the standard 2D version.

====-rearm_timer====
'''"Enable Rearm/Repair Completion Timer"'''

Displays time remaining until rearm and repair from a support ship is complete.

====-ballistic_gauge====
'''"Enable the analog Ballistic Ammo gauge"'''

Adds an ammo gauge to the HUD when armed with a ballistic weapon.

===Gameplay===

====-window====
'''"Run in Window"'''

Runs the game in a window. No check to make sure that resolution is no higher than your desktop resolution, so be careful.

====-fullscreen_window====
'''"Run in Fullscreen Window"'''

Runs the game in a borderless window.

====-stretch_menu====
'''"Stretch interface to fill screen"'''

Scales the interface to fill the screen without preserving the aspect ratio. Omit this to keep the aspect ratio, adding black bars where appropriate.

====-noscalevid====
"Disable scale-to-window for Movies"

Disables fullscreen scaling of video clips.

====-nomotiondebris====
'''"Disable motion debris"'''

====-ship_choice_3d====
'''"Use Models for Ship Selection"'''

Uses ship models in ship selection window. It completely disables the standard ANI interface in this screen. 
If a mod does not supply the required interface art for a ship, this mode will be used instead.

====-weapon_choice_3d====
'''"Use Models for Weapon Selection"'''

Uses weapon models in weapon loadout window for secondary weapons (missiles and bombs). It completely disables the standard ANI interface in this screen. 
If a mod does not supply the required interface art for a weapon, this mode will be used instead.

====-3dwarp====
'''"Enable 3D Warp"'''

Use full geometry for the subspace warp effect.

====-warp_flash====
'''"Enable Flash upon Warp"'''

Enable a flash at warp in and warp out.

====-no_ap_interrupt====
'''"Disable Interrupting of AutoPilot"'''

Tells the game to not allow players to interrupt an autopilot already-in-progress.

===Audio===

====-nosound====
'''"Disable Sound and Music"'''

====-nomusic====
'''"Disables Music"'''

====-no_enhanced_sound====
'''"Disable enhanced sound"'''

Disables the enhanced sound rendering functions enabled by OpenAL Soft.

===Launcher===

====-portable_mode====
'''"Store config in portable location"'''

Uses the root directory of FSO for storing pilot and config files. The current launcher does not have proper support for this yet so you need to manually copy the fs2_open.ini from the original config directory to your FreeSpace Root directory.

====-parse_cmdline_only====
'''"Parse Command Line Only"'''

Parse only the application command line settings, and ignore any that may have been set in the on-disk data/cmdline_fso.cfg or per-user cmdline_fso.cfg (on Linux/Mac)

====-get_flags====
{{Table38|'''"Output the launcher flags file"'''
Used by launchers to get certain information from FSO via binary file or stdout.
*Syntax: '''''String''''', either '''binary''' or '''json_v1'''

'''binary''' will output info to a binary file in the root directory (probably within AppData)
'''json_v1''' will output via stdout on the console a .json object as a string}}

===Multiplayer===

====-standalone====
'''"Run as Stand Alone Server"'''

Creates a standalone multi-player server.

====-startgame====
'''"Skip Mainhall and Start Hosting"'''

Once you launch and choose a pilot within the game, you will immediately have begun to host a game. This can be used in conjunction with several options to customize the game you create: -closed, -restricted, -password, -gamename, -allowabove, and -allowbelow. -startgame has no effect when -standalone is used.

See related: [[Command-Line_Reference#-closed|-closed]] [[Command-Line_Reference#-restricted|-restricted]] [[Command-Line_Reference#-password|-password]] [[Command-Line_Reference#-gamename|-gamename]] [[Command-Line_Reference#-allowabove|-allowabove]] [[Command-Line_Reference#-allowbelow|-allowbelow]]

====-closed====
'''"Start Hosted Server as Closed"'''

Hosts a new game in a closed state, where no one can join until the in-game "Close" button is cleared. This only works when used in conjunction with -startgame. Cannot be used in conjunction with -restricted or -password.

See related: [[Command-Line_Reference#-startgame|-startgame]] [[Command-Line_Reference#-restricted|-restricted]] [[Command-Line_Reference#-password|-password]]

====-restricted====
'''"Host Confirms Join requests"'''

Hosts a new game in a restricted state. The host is presented with option to accept or deny each client's request to join the game. This only works when used in conjunction with -startgame. Cannot be used in conjunction with -closed or -password.

See related: [[Command-Line_Reference#-startgame|-startgame]] [[Command-Line_Reference#-closed|-closed]] [[Command-Line_Reference#-password|-password]]

====-multilog====
Creates a log file with a summary of packets sent and received in multiplayer games. The file is saved as \data\multi.log within the active mod folder—or with main data folder if no mod is active.

====-clientdamage====
{{Note| This feature is not available in current builds.}}

====-mpnoreturn====
'''"Disables Flight Deck option"'''

Disables return to the flight deck screen after a mission completes.

====-gateway_ip====
'''"Set gateway IP address"'''

===Troubleshooting===

====-no_set_gamma====
'''"Disable Setting of Gamma"'''

Disables the gamma settings in the options screen.

====-nomovies====
'''"Disable Video Playback"'''

Disables all video playback.

====-noparseerrors====
'''"Disable Parsing Errors"'''

Disables some parsing warnings and makes other parse errors non-fatal. Do not rely on this when creating new tables. The errors are there for a reason.

====-loadallweps====
'''"Load all weapons, even those not used"'''

====-disable_fbo====
'''"Disable OpenGL RenderTargets"'''

====-disable_pbo====
'''"Disable OpenGL Pixel Buffer Objects"'''

Disables the use of Pixel Buffer Objects (PBO) which may cause certain OpenGL operations to perform slower. Note PBO's were only used at three places in FSO anyway so it's *probably* not going to have a noticeable effect.

May be required to workaround issues in certain versions of Linux's Mesa drivers for Intel integrated graphics cards where crashes occur in the mainhall (i.e. whenever a popup occurs). Distros that seem to have this problem presently include Ubuntu 13.10 and openSUSE 13.1.
{{Table371|
*This feature is present to work around a bug in Linux's Mesa drivers for Intel integrated graphics cards}}

====-ati_swap====
'''"Fix Color issues on some ATI cards"'''

[http://scp.indiegames.us/mantis/view.php?id=1669 Mantis #1669] is what led to this flag's creation.

====-no_3d_sound====
'''"Use only 2D/stereo for sound effects"'''

====-mipmap====
'''"Enable mipmapping"'''

Causes for non-mipmapped textures to have mipmaps generated within the GPU on certain kind of texture formats, (IIRC, DDS formatted textures with a power of 2 size in both width and height). 
Since the use of already mipmapped DDS textures has become common, it has become deprecated.
The quality of the generated mipmaps depends on each GPU and used driver. It is normally used with [[Command-Line_Reference#-img2dds|-img2dds]] flag.

====-use_gldrawelements====
'''"Use glDrawElements instead of glDrawRangeElements"'''

Introduced as a means of switching to the slower OpenGL call glDrawElements, instead of glDrawRangeElements.
{{Table3614|
*This feature may resolve certain rendering problems where parts of models are not drawn on Linux drivers}}

====-gl_finish====
'''"Fix input lag on AMD+Linux"'''
{{Table371|
This option adds a "glFinish()" call just prior to swapping buffers. It works around an issue with "recent" (HD 6000 & newer?) AMD cards using proprietary drivers on Linux. Be warned that enabling this may reduce framerate.
}}

Refer to [http://www.hard-light.net/forums/index.php?topic=88102.0 this thread] and [https://github.com/ValveSoftware/Source-1-Games/issues/765 Valve's bugtracker] for more details).

====-no_geo_effects====
'''"Disable geometry shader for effects"'''

Particle rendering uses geometry shaders for high performance, this flag disables that behaviour.

====-set_cpu_affinity====
'''"Sets processor affinity to config value"'''

Use this to force FSO to run on the specified core. CPU cores are numbered starting with 0 for the first core.

====-nograb====
Disables focus grabbing in a window.
{{Note| This feature is not available on Windows.}}

====-noshadercache====
'''"Disables the shader cache"'''

On GPUs with support for OpenGL 4 and higher, FSO caches the compiled shaders for increased performance.

====-fix_registry====
'''"Use a different registry path"''''

DESCRIPTION NEEDED

===Experimental===

====-ingame_join====
'''"Allows Ingame Joining"'''

Enables ingame joining in multiplayer. FIXME: Host option?

====-voicer====
'''"Voice Recognition"'''

Windows-only. Enables voice-recognition for wingmen commands. Must be specifically compiled into a build in order for it to be available; 3.6.10 final includes the feature. See [[Voice Recognition]] for more details.

===Development Tools===

====-bmpmanusage====
'''"Show how many BMPMAN slots are in use"'''

Adds a BMPMAN slot usage display near where the FPS display is (or would be, if it's not enabled). Can be used by mod makers to see if they need to increase their [[Game_settings.tbl#$BMPMAN Slot Limit:|BMPMAN slot limit]].

====-pos====
'''"Show Position of Camera"'''

Displays current position coordinates of camera.

====-stats====
'''"Show Statistics"'''

Shows total and free physical memory, virtual memory and system pagefile.

====-coords====
'''"Show Coordinates"'''

Shows coordinates of the mouse cursor.

====-pofspew====
Loads all POF files in the current mod and prints out information on their LODs and mesh faces. In previous version of FSO this command also generated IBX cache files for each object in the data/cache folder for that mod, but IBX cache files are no longer used. 
Nowadays, this command is most useful for quickly checking all models in a mod for any debug errors.

====-weaponspew====
{{table202|
Outputs information about player-allowed weapons (and child munitions) to the log file. This includes a CSV with comparative stats on all weapons, as well as MediaVP-style descriptions for the loadout screen. 
The command '-weaponspew all' will print all weapons, not just player-allowed weapons.}}

====-tablecrcs====
Is actually now (or should be) a typed reference rather than as a selection item. Takes 1 argument, usually a descriptive name.
Example usage: "-table_crcs MediaVPs" will create a table_crcs.csv file in the running mod (name can be separate of the mod selected) that allows for the validation of the tables used by that mod while on-line. The descriptive parameter given helps "allocate" that .csv file to the mod in question, and as such should closely or exactly match that mods name if possible.

====-missioncrcs====
Is actually now (or should be) a typed reference rather than as a selection item. Takes 1 argument, usually a descriptive name.
Example usage: "-mission_crcs MediaVPs" will create a mission_crcs.csv file in the running mod (name can be separate of the mod selected) that allows for the validation of the missions used by that mod while on-line. The descriptive parameter given helps "allocate" that .csv file to the mod in question, and as such should closely or exactly match that mods name if possible.

====-dis_collisions====
'''"Disable Collisions"'''

Disables all collisions.

====-dis_weapons====
'''"Disable Weapon Rendering"'''

Disables weapons rendering.

====-output_sexps====
This will make the FSO build spit out an html file that documents the supported SEXP's.

Just double click on sexps.html and it should open in your default web browser.

====-output_scripting====
This will make the FSO build spit out an html file that documents the supported scripting hooks and LUA libraries.

Just double click on scripting.html and it should open in your default web browser.

====-save_render_target====
'''"Save Render Targets to file"'''

====-verify_vps====
'''"Spew VP crcs to vp_crcs.txt"'''

Exports the CRC values of the VP files being loaded into a vp_crcs.txt file.

====-reparse_mainhall====
'''"Reparse mainhall.tbl when loading halls"'''

Mainhall.tbl will be reparsed every time a mainhall is loaded, as opposed to just once at game startup.

====-noninteractive====
'''"Disables interactive dialogs"'''
Disables all dialogs and chooses the default option when one would be displayed. Very useful for a standalone server on a headless system.

====-no_unfocused_pause====
'''"Don't pause if the window isn't focused"'''

When the FSO window looses focus it will not pause the game, useful for doing non-interactive test runs.

====-benchmark_mode====
'''"Puts the game into benchmark mode"'''
See [[Benchmarking]] for more information.

====-profile_frame_time====
'''"Profile frame time"'''

Activates the frame profiling code. This presents a readout showing the current, minimum, maximum and average percentages of frametime a given section of code has taken up; this can be used to identify particular bottlenecks or measure the effectiveness of certain optimizations.

====-profile_write_file====
'''"Write profiling information to file"'''

This will write the frame times of each gameplay frame to the file 'profiling.csv' where each line is ''<time>;<frametime>''. Both times are measured in microseconds. ''time'' is measured from an arbitrary time in the past. To get consistent results the first ''time'' value should be substracted from all ''time'' values. The first two frames are usually very long because the timer is set at engine startup so you might want to exclude those from your data.

====-json_profiling====
'''"Generate JSON profiling output"'''

Gathers information from the built-in profiling tools and writes them out to a .json file readable by the Google Chrome tracer or TraceCompass/SpaceCompass.
NOTE: This will create fairly massive data sets (several hundred megabytes per minute of gameplay). The files will be written to the subdirectory "tracing" in the FreeSpace data folder; FreeSpace will not create that folder automatically, however.

====-debug_window====
'''"Display Debug Window"'''

Lists the fs2_open.log in (nearly)real-time generation.

====-gr_debug====
'''"Output graphics debug information"'''

==Other==

The following options are not available as checkboxes in the launcher and must be entered into the "Custom flags" field. Many require parameters, which follow the flag separated by a space. The prototype for use in this case is "-option argument"

===Lighting===
These factors can dramatically alter the atmosphere of the game. [[Sample Lighting Settings|This page]] has some sample lighting settings with screenshots. Largely sourced from [https://www.hard-light.net/forums/index.php?topic=94875.msg1870215#msg1870215 this thread].

====-ambient_factor====
This is a multiplier applied to the intensity of ambient lighting. Ambient light is lighting applied to all parts of a ship. The way this works is a bit weird. (ambient factor * 2) - 255 is "added" to mission ambient, but since this will almost always be a negative value it's actually removed from mission ambient. Because of how light values are clamped it cannot go below 5.1, ambient_factor 70 will result in -115 to mission ambient which is 120 by default. 70 is essentially the lowest ambient for missions with default ambient settings which are all retail missions and the vast majority of mod missions. FS2's standard value is 120. 70 is basically no ambient, 80 is a bit of ambient, and 90 is quite a bit of ambient(ships will look bright from all sides). Anything above that will make ships look incredibly "flat". This is a relative value.

====-spec_point====
This is a multiplier that adjusts how much laser weapons contribute to specular highlights. Higher number mean greater contributions. If you want lasers to light up more set this to around 2. If you want less lighting, set it to around 0.5. Default is 1.0. This is a relative value.

====-spec_static====
This is a multiplier that adjusts how much suns contribute to specular highlights. Higher numbers mean a greater contribution. For non-PBR models it will make their sun-lit side very shiny and reflective; for PBR models it will make the sun-lit side a lot brighter. There's no flag to control diffuse static lighting so non-PBR models will always have the same amount of light come from suns. Default is 1.0. This is a relative value.

====-spec_tube====
This is a multiplier that adjusts how much beam weapons contribute to specular highlights. Higher numbers mean a greater contribution. If you want lasers to light up more set this to around 2. If you want less lighting, set it to around 0.5. Default is 1.0. This is a relative value.

====-ogl_spec====
*'''''This feature is now deprecated, it will have no effect on rendering.'''''
Takes a numerical argument. This value changes the basic shininess of the specular light in OpenGL. A lower value reduces the overall intensity of the light making it broader and less powerful. A higher value makes it more focused and brighter. The default value is 80, and the usable range is 0 to 128 (clamped). The original default value was 60, but it was raised to behave more D3D like.

====-spec_exp====
*'''''This feature is now deprecated, it will have no effect on rendering.'''''
This must be used with the -spec command line parameter and must be entered into the "Custom flags" field. Adjusts the size of the shiny spot on ships. Higher number mean smaller spots. Default is 16. This is a relative value.

===Graphics===

====-bloom_intensity====
Requires -post_processing ("Enable Post Processing") command.
Default value is 25. Range is 0-200.

====-shadow_quality====
{{table373|
'''"Set shadows quality"'''

This sets the resolution for the shadow maps the engine uses for real-time shadowing.
Note that higher resolutions require more processing power and VRAM; this feature is only recommended for users with a decently powerful dedicated GPU.
Valid ranges are 0 to 4 with 2 being the default.

* 0 disables shadows (so there's no point in setting it!)
* 1 uses 512x512 resolution (lower quality)
* 2 uses 1024x1024 resolution (medium quality)
* 3 uses 2048x2048 resolution (high quality)
* 4 uses 4096x4096 resolution (ultra quality)

Currently this requires -enable_shadows to be set, or it has no effect.
}}
{{table38|No longer requires -enable_shadows to be set.}}

====-anisotropic_filter====
{{table382|
'''"Set anisotropic filtering level"'''
Valid ranges are 1 to whatever maximum the GPU supports (which should be 16 for most currently available GPUs)
By default, the GPUs' max supported level is used; set this to 1 if you want the minimum level available.}}

====-clipdist====
Changes the distance from the viewpoint for the near-clipping plane.

Takes one argument decimal specifying the distance to the near-clipping plane.

====-res====
Allows you to specify a resolution if the desired one cannot be set in the Launcher.
For example, -res 1920x1080 would run the game in 1920 x 1080 resolution. Since it requires an argument, it needs to be entered as a custom flag when using the Launcher. The "Run at specified resolution" option the Launcher gives is essentially this, but without being able to actually specify a resolution, it doesn't work.

====-center_res====
Specifies how much of the screen area should be utilized by menus, movies, the HUD, and various other 2D graphics. Intended for use with configurations with an extremely wide field of view, such as triple-monitor setups.

By default, if the screen resolution's aspect ratio is wider than 7:2, most 2D elements utilize only the center 3/10 of the screen area. This setting allows users to override this behavior to make better use of the center monitor. (The reason for using 3/10 rather than 1/3 is that many triple-monitor setups use bezel correction, which reduces the fraction of the screen area that the center monitor displays.)

For example, if the screen resolution is 6000x1080, then -center_res 1920x1080 will keep most 2D graphics in the center 1920x1080 area. This setting is automatically scaled to fit the screen resolution, so (assuming the resolution is still 6000x1080) -center_res 1280x720 is given, then that resolution is enlarged to 1920x1080.

====-aa_preset====
{{table202|
This parameter can be used to select the AA solution the engine is using. Valid values are 0 to 6 inclusive:
* 0: FXAA Low
* 1: FXAA Medium
* 2: FXAA High
* 3: SMAA Low
* 4: SMAA Medium
* 5: SMAA High
* 6: SMAA Ultra

The various AA presets can be tested in the F3 lab; the number keys from 0-6 switch between the various presets as described above.
}}

====-fxaa_preset====
Requires both -post_processing and -fxaa. Can be used to adjust the FXAA quality and speed, 0 is fastest, 9 is highest quality. Default setting is 6.
{{table202|Has been superceded by the -aa_preset cmdline argument}}

====-smaa_preset====
Requires both -post_processing and -smaa. Can be used to adjust the SMAA quality and speed, 0 is low, 1 is medium, 2 is high, and 3 is ultra (highest quality). Default setting is 1.
{{table202|Has been superceded by the -aa_preset cmdline argument}}

===Game Speed===

====-no_fps_capping====
'''"Don't limit frames-per-second"'''

===Gameplay===

====-keyboard_layout====
'''"Manually sets a keyboard layout"'''

A commandline parameter to set the keyboard layout as a string parameter.
{{Table3614|
*Currently the only valid string is "qwertz" (German) but French azerty may be added in future.}}

====-start_mission====
'''"Skip the mainhall in jump right into the specified mission"'''

Jump into the mission specified by the filename. Only in effect on the first run. This will skip load of the mainhall and its other related things altogether.

====-mod====
Specifies in which folders inside FreeSpace 2 directory, the game looks for all the game data (models, missions, textures, tables, ...). Retail version only looks inside ''Freespace2/data/'' structure and ''Freespace2/vp archives''.

This flag allows installing several different mods that modify retail behavior, and switching between them without needing to erase files or having undesired cross effects. Each mod should be installed in its own folder.

It takes one argument string: the chain of names of the used directories. Comma (''',''') must be used as separator. In this way, '''-mod dir1,dir2,dir3,...,dirx''' causes the game to use the following directory precedence:

#Freespace2/dir1/
#Freespace2/dir2/
#Freespace2/dir3/
# ... (the rest of the typed directories) ...
#Freespace2/dirx/
#Freespace2/

This flag can be indirectly set, (and it is normally set), through Launcher MOD tab and [[mod.ini]] file.

Within the Launcher's MOD tab you can select one directory, (let's call it ''moddir''), so the flag is at least set to '''-mod moddir'''.
If ''Freespace2/moddir/[[mod.ini]]'' exists it will be used to modify the -mod flag, too.

For further details, see '''[[mod.ini]]'''

'''Data precedence'''

As already said, within the different directories, the data precedence is set by the specified order in the -mod flag. The lowest priority goes to the Freespace2 installation directory.

Inside each directory, data precedence is the following:

#Individual files located in ''Current_dir/data/'' subdir structure. See [[FS2_Data_Structure|FS2 Data Structure topic]] for deeper info about the different folders and contents this structure has.
#Files located inside vp archives. (These vp archives are "similar" to zip archives. They just contain other files and folders. Moreover, files have to be stored using the same ''data/'' structure used outside it). Vp archives are read in alphabetical order, so aaa.vp files have higher priority than aab.vp files and so on.

The highest priority file overrides the rest of them. In this way, if you have a ''Mission.fs2'' inside ''Freespace2/Pri1/data/missions/'' it doesn't matter that this ''Mission.fs2'' is also inside ''Freespace2/Pri1/aaa.vp'', ''Freespace2/Pri1/aab.vp'', ... or ''Freespace2/data/missions/''. This data precedence allows the user to quickly replace old files by corrected or enhanced ones adding them in a higher priority place.

'''Additional notes'''
# As derived from the explanation, the exact names for directories or vp archives are actually irrelevant. It only matters the directory order inside -mod flag argument and the alphabetical order for vp archives inside each used directory.
# This flag is also used by [[Portal:FRED|FRED]]. So if there is special mod info, (like backgrounds maps, ship models or whatever), it must be typed, (''Fred2_Open_r.exe -MOD whatever''), or FRED won't be able to use it. A special build of wxLauncher is able to configure FRED so that the -mod doesn't have to be done manually see [http://www.hard-light.net/forums/index.php?topic=67950.msg1387911#msg1387911 the forum post] for more details.
{{Table3612|As of 3.6.12 FRED now loads cmdline_fso.cfg just like FS does so FRED will use the same settings as FS including the -mod settings}}
# Be careful while typing the directory names in the flag argument or inside mod.ini files. The program doesn't check if the typed directories exist. If they do not exist, they are just ignored. No warnings, no errors, no messages at all.

{{Warning| '''Priority and Texture Formats'''

''Obsolete behavior - Until FS2_open v3.6.9.:''

FS2_Open can use several file formats in textures: [http://en.wikipedia.org/wiki/PCX PCX], [http://en.wikipedia.org/wiki/DirectDraw_Surface DDS], [http://en.wikipedia.org/wiki/JPG JPG] and [http://en.wikipedia.org/wiki/TGA TGA]. Make sure you keep the format when you update your texture. For example if you update the old ''TextureOfMyFighter.tga'', do not save it as ''TextureOfMyFighter.dds'' in a higher priority place, because there is a chance of the game loading the old one despite of all.

The reason to do this is that, loading process (including priorities) is applied firstly for a kind of textures (TGAs), then for another kind (JPGs), and so on. This behavior can lead to situation where your new, updated and higher priority placed texture is not read because the format of the older one.

''New behavior - From FS2_open v3.6.10. (including previous beta testing releases):''

The former issue has been fixed. Now texture format priority is only applied within the same location. In this ''strange'' situation it goes DDS -> TGA -> JPG -> PCX. Examples:
* ''/Freespace2/MyVp.vp>>>data/maps/MyTexture.dds'' is loaded instead of ''/Freespace2/MyVp.vp>>>data/maps/MyTexture.tga''.
* But your improved ''/Freespace2/data/maps/MyTexture.xxx'' will override them both despite of its format.
In this way, when you update any texture, you don't have to pay attention to its original format. Just place it in a higher priority place.

Nevertheless, global priority is kept between animated and static textures. Because of their management, animated textures (ANIs and EFFs) are looked for BEFORE static ones. In this way there's no way to update an animated texture with a static one (an obsolete ANI is always going to be loaded before the newer DDS version). The solution: use an updated EFF with just one frame.

}}

====-fov====
This flag allows the player to specify the ''vertical'' Field of View (FoV) angle, in radians, for the player eyepoint. The angle is measured across the full height of the viewing cone. The FoV angle is technically known as the Angle of View (AoV)

*Syntax: '''''float''''' Angle
*Valid Values: 0 to 2*Pi radians
*Default Value: 0.75 radians

{{Note|For peculiar reasons, the actual FoV/AoV used by the game will be the supplied value multiplied by 1.39626348.}}

The the FoV angle/AoV is what determines the relative zoom level of the main game camera. Smaller angles generally equal to higher zoom levels, while larger angles equal to lower zoom levels (down to the theoretical x0 magnification).

However, too small of an angle will have a squashed look on the edges of your screen, and too high of an angle will greatly stretch edges. It is recommended to change the AoV, as FS2's default AoV has some perspective distortion at the screen edges (the default AoV is too high).

A natural looking (as if you where physically in the cockpit) AoV depends on the distance the player's actual eyes are away from the screen: the further away from the screen, the smaller the AoV should be, and vice versa. "Ergonomic" distances generally yield a '''''diagonal''''' AoV of 0.523 radians (30 degrees), but you can easily find the natural AoV by the following formula:

AoV (radians) = 2 * atan( H / ( 2*D ))

where:

Height of screen = H

Distance between head/eye and the screen = D

Generally, gamers like to increase the AoV in order to increase their peripheral vision on the screen, so as to gain a better situational awareness around their craft. An AoV of 0.39 radians seems to be a good start, but feel free to experiment and use whatever AoV you are most comfortable with.

===Launcher===

====-query_speech====
'''"Does this build have Speech?"'''

Determines if the current build includes text-to-speech.

===Multiplayer===

====-gamename====
Specifies the name of the game to be created by the host. This only works when used in conjunction with -startgame.

Takes one argument string, the name to be assigned to the game being created.

This argument does nothing when used with -standalone. To set the name for a standalone server, see [[Multiplayer(Main)#Standalone Servers|Standalone Servers]].

See related:   [[Command-Line_Reference#-startgame|-startgame]]   [[Multiplayer(Main)#Standalone Servers|Standalone Servers]]

====-password====
Specifies the password for a standalone server. This only works when used in conjunction with -startgame. Cannot be used in conjunction with -closed or -restricted.

Takes one argument string, the required password for the game being created.

See related: [[Command-Line_Reference#-startgame|-startgame]] [[Command-Line_Reference#-closed|-closed]] [[Command-Line_Reference#-restricted|-restricted]]

====-allowabove====
Specifies a player's minimum rank for joining a game. This only works when used in conjunction with -startgame.

Takes one argument integer, the points ranking above which a player must be to enter the game.

See related: [[Command-Line_Reference#-startgame|-startgame]]

====-allowbelow====
Specifies a player's maximum rank for joining a game on a standalone server. This only works when used in conjunction with -startgame.

Takes one argument integer, the points ranking below which a player must be to enter the game.

See related: [[Command-Line_Reference#-startgame|-startgame]]

====-port====
Specifies the port on which to host a game or serve a standalone game.

Takes one argument integer, the port on which the host will listen for clients.

====-connect====
Automatically connect to multiplayer IP:PORT.

Takes one string value, such as 192.168.0.1:

====-timeout====
Multiplayer network timeout (secs).

Takes one integer argument, the timeout value in seconds. Default is 30.

====-cap_object_update====
Caps the maximum object update the server will respond to regardless of what the client has set. If the client is set to request high object updates but the server is capped to low, then that's all the client will get.

Takes one argument integer (0 to 3) which corresponds to the object update cap (With 0 being low and 3 being LAN).

===Help===

====-help====
Instructs FSO to print out all supported parameters. Some launchers can use these options to automatically populate the available command line options, even if the version of FSO is far newer than the launcher itself. NOTE: This option only works in Linux builds...

====--help====
See [[Command-Line_Reference#-help|-help]]

====-h====
See [[Command-Line_Reference#-help|-help]]

====-?====
See [[Command-Line_Reference#-help|-help]]

===Deprecated Options===
These options were present in the executable for some time, but have since been removed and deprecated. The engine will throw a non-fatal error when they are found in the commandline. Some of these functions have been removed entirely, others are now part of the standard operation of the engine.

====-spec====

====-env====

====-glow====

====-normal====

====-height====

====-missile_lighting====

====-img2dds====

====-snd_preload====

====-nohtl====

====-safeloading====

====-timerbar====

====-old_collision====

====-json_pilot====
'''"Dump pilot files in JSON format"'''

Writes the information stored in savefiles to JSON files.

====-novbo====
'''"Disable OpenGL VBO"'''

====-noibx====
'''"Don't use cached index buffers (IBX)"'''

Disables IBX caching of model geometry data. This will dramatically increase load times, but will help troubleshoot a model if one is working incorrectly.

====-no_glsl====
'''"Disable GLSL (shader) Support"'''

Disables the use of GLSL rendering (OpenGL shaders). The game will revert to legacy fixed render pipeline. Please note that Normal and Height map effects will be unavailable.

====-disable_glsl_model====
'''"Don't use shaders for model rendering"'''

====-disable_di_mouse====
'''"Disables the DirectInput mouse code for FSO on windows."'''

'''Windows Only''' Can make mouse movement smoother on certain machines.

====-cache_bitmaps====
'''"Cache bitmaps between missions"'''

====-no_emissive_lighting====
See -emissive_lighting.

====-post_process====
See -no_post_process.

===Completely Removed Options===
Using one of these is the same as using a random string.

====-show_mem_usage====

[[Category:Lists]]
[[Category:Source Code Project]]

Weapons.tbl

2020-04-15T16:18:20Z

Z64555: /* +Weapon Range: */

{{TableVersionGit|2017-08-25|2039815}}

The '''weapons.tbl''' defines all of the weapon classes used in FSO.

This table is one of the [[Modular Tables]] and can be extended with xxx-wep.tbm

[[Tables|List of Tables]]

==Introduction==
The weapons.tbl is responsible for defining the behavior of the numerous weapon effects used in FSO, including the amount of damage dealt, the firing rate, and graphical effects.

This wiki page goes over all of the entries used exclusively in the weapons.tbl file. Hyperlinks to individual weapon creation/editing tutorials are provided when appropriate.

==Special Case Weapons==
===Beam Cannons===
'''REQUIRES:'''
*'''"beam"''' flag
*'''[[weapons.tbl#$BeamInfo:|$BeamInfo:]]'''

See also: [http://www.hard-light.net/wiki/index.php/Tutorial_-_Beam_Weapons Tutorial - Beam Weapons]

===Flak Guns===
'''REQUIRES:'''
*'''"flak"''' flag
*'''"particle spew"''' flag
*Must have inner and outer radius defined to have any effect.
*A '''.pof''' model must be defined ( usually '''Hornet.pof''' )
**Note: the model is not actually used... Instead, it uses [[Weapons.tbl#$Pspew:|particle spew]]. Trails may also be added.

==General Format==
*The weapons table consist of several sections
*All sections beginning with <nowiki>#</nowiki> need <nowiki>#</nowiki>'''End''' before the next section.
**<nowiki>#</nowiki>'''Primary Weapons'''
***Defines all '''standard primaries weapons''' as well as '''beam cannons''' and '''flak cannons'''.
**<nowiki>#</nowiki>'''Secondary Weapons'''
***Defines all '''secondary weapons'''.
**<nowiki>#</nowiki>'''Beam Weapons'''
***I haven't got any ideas for this one.
**<nowiki>#</nowiki>'''[[Weapons.tbl#Countermeasures|Countermeasures]]'''
***Defines the used countermeasure.
**'''$Player Weapon Precedence'''
***Player Weapon Precedence is used in weapon selection when a default specified by the mission designer is not available to the player. The next weapon on the list is used in its place (assuming that weapon is allowed for the player).

==Core Table==

===$Name:===
*This is the name of the weapon. If it's going to be used by the player, keep it under 12 characters so it doesn't spill over the HUD box. Two special characters can be used in the name: '''#''' and '''@'''. Their usage details are the very same than inside the [[Ships.tbl#.24Name:_2|$Name field from Ships.tbl]].
*Syntax: '''''String'''''

====+nocreate====
{{Table3610|
*In [[Modular Tables]] name can be followed by line '''+nocreate''' that prevent game from creating an incomplete entry by leaving the entry unread unless it already exists (either in Weapons.tbl or in earlier parsed *-wep.tbm files) by the time the *-wep.tbm is read.}}

===$Alt Name:===
{{Table3611|
*An alternative name that can be referenced instead of $Name:
*Syntax: '''''String'''''}}

===$Subtype:===
{{Table3610|
Specifies the weapon 's subtype. Overrides the default subtype as specified by the #-section it is in (#Primary, #Secondary, #Beam Weapon, etc.).

{{Note|
:Since the weapon subtype is already specified by the #-section it is in, this option is not particularly useful when the weapon is inside a #Primary or #Secondary section. However, it may be used to specify the weapon slot it uses on fighters/bombers for weapons that are normally capship only (such as beam cannons).}}

*Syntax: '''''String'''''
*Valid Entries:
:Primary
:Secondary}}

===+Title:===
*This is the title of the weapon in the Weapons loadout screen. Only needed for player allowed weapons. Title may be anything. Numerical value is a reference to translations in [[Tstrings.tbl]]
*Syntax: XSTR('''''"String"''''', -1)

===+Description:===
*This is the description you see in the weapons loadout screen. Again, these aren't based on any hard numbers, just approximations. Only needed for player allowed weapons. Numerical value is a reference to translations in [[Tstrings.tbl]]
*Must be followed by '''$end_multi_text'''

'''Example'''

<pre>
XSTR(
"''Standard Issue
''Level 3 Hull Damage
''Level 2 Shield Damage''", -1)
$end_multi_text
</pre>

===+Tech Title:===
*Title of the weapon in the Tech room. Only needed for player allowed weapons.
*Syntax: XSTR('''''"String"''''', -1)

===+Tech Anim:===
*Animation used for the weapon in the Tech room. Only needed for player allowed weapons.
*Syntax: '''''String''''', animation filename
**Example: ''Tech_Subach_HL-7''

===+Tech Description:===
*Descriptive text you see in the tech room. Only needed for player allowed weapons. Numerical value is a reference to translations in [[Tstrings.tbl]]
*Must be followed by '''$end_multi_text'''

'''Example'''

<pre>
XSTR(
"''The Subach-Innes HL-7...''", 3245)
$end_multi_text
</pre>

===$Tech Model:===
{{Table3610|
*Defines model used in wing loadout screen for the weapon. 3D weapon models in the tech room have not yet been implemented.
*Syntax: '''''String.pof''''', model filename}}

====+Closeup_Pos:====
{{Table3613|
*How the model will show on the Loadout Screen. The position of the camera relative to the model center.
*Syntax: '''''Vector''''', three '''floats''', x, y and z values respectively}}

====+Closeup_Zoom:====
{{Table3613|
*How the model will show on the Loadout Screen. How far the camera's zoomed in, defines camera's FOV.
*Syntax: '''''Float''''', radians}}

===$Selection Effect:===
{{Table3613|
*Defines which selection effect to use when the -weapon_choice_3d commandline flag is enabled or no ani can be found for the selected weapon.
*Syntax: '''''String''''', either "FS1", or "Off". This defaults to the FS2 effect.
}}

===$HUD Image:===
{{Table3610|
*Defines the picture used to represent the weapon in HUD loadout list
*Syntax: '''''String''''', filename}}

===$Model File:===
*Filename of the model file (.pof) at data/models folder. Additional fields beginning from '''''@Laser Bitmap:''''' and ending to '''''@Laser Tail Radius:''''' are not needed if a model has been defined for the weapon.
*Standard primaries and beam cannons do not use specific models so for those the name is 'none'.
*Flak weapons and secondaries use models, though the exact model is not important with the flak weapons.
*Syntax: '''''String.pof''''' or ''none'', model filename
**Example: ''none''

===$POF target LOD:===
{{Table3610|
*Defines the LOD (Level-Of-Detail) of the model used in HUD targeting view
*Syntax: '''''Integer'''''}}

===$Detail Distance:===
{{Table3613|
*Defines the distance where the change between different Levels-Of-Details (LODs) occurs
*Take notice that these are base values. Model detail in Detail options, (within game press F2), applies a multiplier to these values. These multipliers are (from left to right): 1/8, 1/4, 1, 4, 8
*Optional. If not defined the game uses the formula ((radius * 20.0 + 20.0) * LOD)
*Syntax: '''''(Detail Distances)''''' , list of '''integers''' (same amount as LODs), distances from the model in meters
**Example: ''(0, 80, 300, 900)''}}

===$External Model File:===
{{Table3610|
*Defines the models shown on the gunpoint, used with Bobb's external-visible-weapon code.
*Syntax: '''''String.pof''''', model filename}}

===$Submodel Rotation Speed:===
{{Table3610|
*Defines the rotation speed of the subobject, with the $gun_rotation property defined, in the external weapon model.
*Syntax: '''''Float'''''
*Note: weapon fire will be delayed by the time it takes for the weapon to spin up to this speed (using $Submodel Rotation Acceleration or its default value), regardless of whether an external model is used or not.
}}
{{Table38|
*Note: It's no longer required that the ship actually have external models enabled (whether or not this weapon has one defined) for the spin up delay to occur.
}}

===$Submodel Rotation Acceleration:===
{{Table3610|
*Defines the rotation acceleration of the external weapon model.
*Syntax: '''''Float'''''
*Default value: 10}}

===@Laser===
In the event a 3D model is not defined for the weapon, FSO creates an object similar to a glowpoint. Essentially, it is a 2D plane that always faces the player's camera with an additive texture applied to it, and may or may not have an omnilight follow it.

As suggested by its name, this option group is normally used for lasers and similar primaries, but it may also be used for other weapon types as well.

Unless said otherwise, the graphic files used within this group may be of any compatible type (.DDS, .PCX, .TGA, etc.), however a .DDS is recommended.

====@Laser Bitmap:====
Defines the graphic file to be used as the weapon effect.

Blending type: additive

Syntax: '''''String''''', filename

'''Example:'''
<pre>
@Laser Bitmap: my_laser_bitmap
</pre>

====@Laser Glow:====
Defines the graphic file to be used for the glowmap of the weapon effect.

Blending type: additive

*This file is 'multiplied' by a value between Color and Color2.
*The physical dimensions of the glowmap in-game is 2x the size of the bitmap.

Syntax: '''''String''''', filename

'''Example:'''
<pre>
@Laser Glow: my_laser_glowmap
</pre>

====@Laser Color:====
The RGB color of the glow effect.

*The color is applied both to the glowmap and the omnilight that follows the effect.

Syntax: '''''Color''''', red, green, blue respectively, 8-bit value from 0 to 255

'''Example:'''
<pre>
@Laser Color: 255, 0, 0 ; Red glow effect at the start of the effect's lifetime
</pre>

====@Laser Color2:====
The RGB color of the glow effect at the end of the effect's lifetime (at its maximum range).

*The color is applied both to the glowmap and the omnilight that follows the effect.
*The actual color of the glow effect is somewhere in between the values defined by Color and Color2. Essentially, the actual color "fades" from Color to Color2 over its lifetime.
**If Color is not defined, then a default value of 255, 255, 255 is assumed for its initial color.

Syntax: '''''Color''''', red, green, blue respectively, 8-bit value from 0 to 255

'''Example:'''
<pre>
@Laser Color2: 0, 0, 255 ; Blue glow effect at the end of the effect's lifetime.
</pre>

'''Example:'''
<pre>
@Laser Color: 255, 0, 0 ; Start with a Red glow effect, and fade into...
@Laser Color2: 0, 0, 255 ; a Blue glow effect over the lifetime of the effect.
</pre>

====@Laser Length:====
Defines the length of the weapon effect.
*This option stretches the 2D plane "away" from its origin.
Syntax: '''''Float''''', meters

'''Example:'''
<pre>
@Laser Length: 1.0
</pre>

====@Laser Head Radius:====
Defines the width of the leading edge, or "head," of the weapon effect.
*The edge of the 2D plane farthest away from its origin is the leading edge.
Syntax: '''''Float''''', meters

'''Example:'''
<pre>
@Laser Head Radius: 0.75
</pre>

====@Laser Tail Radius:====
Defines the width of the trailing edge, or "tail" of the weapon effect.
*The edge of the 2D plane that is closest to its origin is the trailing edge.
Syntax: '''''Float''''', meters

'''Example:'''
<pre>
@Laser Tail Radius: 0.75
</pre>

===$Mass:===
*How much of a kinetic effect this weapon has on its target. 3+ gives you the Flail effect. Set it to 10 and you can knock cruisers around.
*This is somehow multiplied by the speed. ie ''$Mass: 3'' and ''$Velocity: 200'' has much weaker kinetic effect than ''$Mass: 3'' and ''$Velocity: 1000''. Also $Mass is used to calculate intensity of "shudder" effect if flagged.
*Syntax: '''''Float''''', blast effect

===$Velocity:===
*How fast the weapon travels. Is also used to define the weapon range, '''''$Velocity x $Lifetime = range'''''.
*Beams travel instantly so this field has effect only on weapon range and AI beam targeting with certain beam types. $Velocity of beam also applies to its kinetic effect along with $Mass.
*Syntax: '''''Float''''', meters per second

===$Fire Wait:===
*Time in seconds between firings
*Note that Fire wait will be reset to 1 if it is set over 5 for non turreted primary weapons (doesn't apply to 3.6.14+)
*Syntax: '''''Float''''', seconds

====+Max Delay:====
{{Table373|
*Defines the maximum amount of time it takes to refire a weapon in a random fire delay range.
**This must be used with +Min Delay: to have any effect.
*Syntax: '''''Float''''', seconds}}

====+Min Delay:====
{{Table373|
*Defines the minimum amount of time it takes to refire a weapon in a random fire delay range.
**This must be used with +Max Delay: to have any effect.
*Syntax: '''''Float''''', seconds}}

===$Damage:===
*Base damage this weapon does. The actual damage is this number multiplied by the factors below.
*Base damage this beam does is continuous damage, damage is 5.5 times the damage value per second. The actual damage is this number multiplied by one of the factors below.
*Syntax: '''''Float''''', damage
*Note: adding a shockwave to a weapon doubles its effective damage to the target (i.e. 1x impact, 1x shockwave)

===$Damage Time:===
{{Table373|
*This sets a time from the end of the weapons lifetime that damage will start to attenuate at. '''''Example: Weapon lifetime is 2.0 seconds and the desired effect is to attenuate after 0.5 seconds have passed, set this to 1.5 seconds.'''''
*Syntax: '''''Float''''', seconds. Defaults to 0.0.
**Note: If neither +Min Damage: nor +Max Damage: is set, the damage will always attenuate to zero at max range.
***If both +Min Damage: and +Max Damage: are set, both are defaulted to 0.0 and damage will be attenuated to zero.}}

====+Attenuation Damage:====
{{Table373|
*This sets the damage a weapon will attenuate to after reaching $Damage Time:.
*Syntax: '''''Float''''', damage.}}

====+Min Damage:====
{{Table373|
*This sets the lowest amount of damage possible assuming damage attenuation is taking place. '''''This has been deprecated, please use +Attenuation Damage: instead.'''''
*Syntax: '''''Float''''', damage. Defaults to 0.0.}}

====+Max Damage:====
{{Table373|
*This sets the highest amount of damage possible assuming damage attenuation is taking place. '''''This has been deprecated, please use +Attenuation Damage: instead.'''''
*Syntax: '''''Float''''', damage. Defaults to 0.0.}}

===$Damage Type:===
{{Table3610|
Defines the damage type that this weapon uses. All armor effects are applied after shield and have no function against shockwave or subsystem damage.

'''REQUIRES:''' [[armor.tbl]]

*Syntax: '''''String''''', name of the damage type ( as defined by [[armor.tbl#$Damage Type:|$Damage Type]] )}}

===$Arm time:===
{{Table3610|
*Defines the time after the launch that is required before the weapon comes hot
*If the time has not been reached when the weapon detonates the Dinky explosion is used
*Syntax: '''''Float''''', seconds}}

===$Arm distance:===
{{Table3610|
*Defines the distance from the firing ships that is required before the weapon comes hot
*If the distance has not been reached when the weapon detonates the Dinky explosion is used
*Syntax: '''''Float''''', meters}}
{{Table3615|
*This parameter is also applied to flak weapons. Previous behaviour was to arm weapons after 10 meters of travel.}}

===$Arm radius:===
{{Table3610|
*Defines the distance from the target where the weapon will arm itself
*Syntax: '''''Float''''', meters}}

===$Detonation Range:===
{{Table3610|
*Defines the distance from the point in space that the weapon was launched where the weapon will detonate
*Syntax: '''''Float''''', meters}}

===$Detonation Radius:===
{{Table3610|
*Defines the distance between the target center point point and the weapon which detonates the weapon.
*Syntax: '''''Float''''', meters}}

===$Shockwave damage:===
{{Table3610|
*Override for the damage caused by shockwaves (default is [[#$Damage:]])
*Syntax: '''''Float''''', damage
*Note: adding a shockwave to a weapon doubles its effective damage to the target (i.e. 1x impact, 1x shockwave)
}}

===$Shockwave Damage Type:===
{{Table3610|
*'''REQUIRES ADDITIONAL TABLE'''. Defines the damage type used for the weapon explosions
*Syntax: '''''String''''', name as defined in [[armor.tbl]]}}

===$Flak Detonation Accuracy:===
{{Table3615|
*Normally, flak weapons detonate at a range of 65 to 99 meters from their intended target, depending on the firing ships' weapon subsystem health. This parameter can be used to adjust this behaviour, as it defines the base range used to determine this detonation range. Standard value is 65.
*Syntax: '''''Float''''', range in meters}}

===$Flak Targeting Accuracy:===
{{Table3615|
*Turret-fired flak weapons are normally firing in a cone around the target's predicted position. This parameter can be used to adjust the size of this cones' base radius. Standard is 60 meters.
*Syntax: '''''Float''''', radius in meters}}

===$Untargeted Flak Range Penalty:===
{{Table3615|
*If a flak weapon is fired without a target selected, this parameter defines the range penalty applied to that weapon. Standard is 20 meters, meaning an untargeted flak weapon will detonate after travelling its max range - 20 meters.
*Syntax: '''''Float''''', penalty in meters.}}

===$Blast Force:===
*The intensity of the kinetic blast effect when ship is within the outer radius of the explosion. Comes in effect only if inner and outer radius are defined.
*Syntax: '''''Float''''', blast effect

===$Inner Radius:===
*Radius at which the full explosion damage is done. Marks the line where damage attenuation begins. Damage is reduced by the square of the distance between the inner radius and outer radius. i.e. half way between inner and outer results in 1/4 damage
*Syntax: '''''Float''''', meters

===$Outer Radius:===
*Maximum radius at which any damage is done. See $Inner Radius for the attenuation formula.
*Also defines the size of the shockwave (if shockwave speed is > 0)
*Syntax: '''''Float''''', meters

===$Shockwave Speed:===
*Speed shockwave expands at. Zero means no shockwave and that damage is applied immediately
*Syntax: '''''Float''''', meters per second

===$Shockwave rotation:===
{{Table3610|
*Defines how the 3D shockwave is rotated.
*Syntax: '''''Angle''''', three values, pitch, bank, heading respectively, in degrees}}

===$Shockwave model:===
{{Table3610|
*Defines the model file (.pof) used as a shockwave for the 3D shockwaves.
*Syntax: '''''String.pof''''', model filename}}

===$Shockwave name:===
{{Table3610|
*Defines the name of the animation used for the 2D shockwave
*Syntax: '''''String''''', filename}}

===$Dinky shockwave:===
{{Table3610|
*Dinky shockwave are used if the weapon is shot down before arming or if the conditions marked at '''Arm time''' and '''Arm distance''' are not reached before impact
*It uses exactly same entries as the standard shockwaves
*'''''+Shockwave damage:'''''
*'''''+Shockwave damage type:'''''
*'''''+Blast Force:'''''
*'''''+Inner Radius:'''''
*'''''+Outer Radius:'''''
*'''''+Shockwave Speed:'''''
*'''''+Shockwave Rotation:'''''
*'''''+Shockwave Model:'''''
*'''''+Shockwave Name:'''''}}

===$Armor Factor:===
*Multiplier for the damage done to armor
*Syntax: '''''Float''''', damage multiplier

===$Shield Factor:===
*Multiplier for the damage done to shields
*Syntax: '''''Float''''', damage multiplier

===$Subsystem Factor:===
*Multiplier for the damage done to subsystems
*Syntax: '''''Float''''', damage multiplier

===$Lifetime Min:===
{{Table3610|
*Defines the minimum lifetime of the weapon
*Syntax: '''''Float''''', seconds}}

===$Lifetime Max:===
{{Table3610|
*Defines the maximum lifetime of the weapon
*Syntax: '''''Float''''', seconds}}

===$Lifetime:===
*Time before the standard primaries fizzle out and secondaries self destruct. Multiply this by the speed to get the range. If values are too low (below framerate) then the collision detection and graphic effects may suffer.
*This field has no effect for the beams apart from weapon range and AI beam targeting with certain beam types
*Syntax: '''''Float''''', seconds

===$Energy Consumed:===
*The amount of energy each bolt drains firing ship. Has no effect on turretted weapons.
*Syntax: '''''Float'''''

===$Cargo Size:===
*Cargo size, is not used with non-ballistic primaries.
*Amount of missiles available = Bank capacity / Cargo Size.
*Syntax: '''''Float'''''

===$Homing:===
'''This option is exclusive to secondaries.'''

Defines if the bolts/missiles in question is homing
*The bolts of primaries will turn to face their target if this option is set to YES... but is otherwise the same as a normal bolt ( when the option is set to NO ).

If set to NO, then following fields are not required in the table.

*Syntax: '''''Boolean''''', yes or no

===='''+Type:'''====
Defines the homing method
*Syntax: '''''String''''', ''ASPECT'' or ''HEAT''
{{Table3610| An additional option, ''JAVELIN'', has been added. This behaves like an aspect missile but automatically only locks onto the engines of a target, and only if the engines are in sight.}}

===='''+Turn Time:'''====
Determines how well the missile maneuvers. Is defined as the number of seconds it takes the missile to do a 360 degree circle
**Syntax: '''''Float''''', seconds

===='''+View Cone:'''====
'''Heat-seeking missiles only'''

This is the width of the weapon's viewing cone, given in degrees. Objects outside this cone are effectively invisible to the missile. The value / 2 gives the angle from the missile's centerline to the edge of the viewing cone.
*Syntax: '''''Float''''', degrees
{{Table3610| Has been enabled also to aspect seekers as an option.}}

===='''+Min Lock Time:'''====
'''For aspect/javelin missiles only'''

The minimum number of seconds to gain a target lock.
*Syntax: '''''Float''''', seconds

===='''+Lock Pixels/Sec:'''====
'''For aspect/javelin missiles only'''
The number of pixels the aspect triangle moves per second while attempting lock-on.

*Syntax: '''''Integer''''', pixels per second

===='''+Catch-up Pixels/Sec:'''====
'''For aspect/javelin missiles only'''

The number of pixels moved per second while attempting to catch up to the target.
*Syntax: '''''Integer''''', pixels per second

===='''+Catch-up Penalty:'''====
'''For aspect/javelin missiles only'''

Extra pixels to move after catching up. (Needs verification )
**Syntax: '''''Integer''''', pixels

===='''+Seeker Strength:'''====
{{Table3610|
Defines the seeking ability of the homing system. Default of heat seekers is 3.0 and for aspect seekers 2.0. Spoofing chance is defined as '''[[#$Countermeasure:|cm type effectiveness]]'''/'''seeker strength''' (missile must be within the countermeasures '''[[#$Countermeasure:|+Effective Radius:]]'''
*Syntax: '''''Float''''', seeker strength}}

===='''+Target Lead Scaler:'''====
{{Table3611|
Defines the type of pursuit course the missile tries to obtain.
*Values < 0 give lag pursuit, values ~ 0 give pure pursuit, values > 0 give lead pursuit.
*Syntax: '''''Float''''', default for heat seekers: 0, default for aspect or javelin seekers: 1.}}

===$Swarm:===
*The number of missiles to fire per volley if it's a swarm missile
*Can be issued to Standard primaries also. Causes single part turrets to malfunction but causes multi part turrets to fire only on their barrel line. Can be used for 'burst fire weapons'. Does not work with player weapons.
*Is incompatible with "Corkscrew" option.
*Swarm will negatively affect the missile's ability to hit its target. Especially when fired off-bore.
*Syntax: '''''Integer''''', number of shots in a swarm
{{Table3610|
*'''+SwarmWait:'''
**Defines the time between weapons fired in a swarm
**Syntax: '''''Float''''', seconds
***Default: 0.150
***Max: 0.5 (Resets to default if set over 0.5)}}

===$Acceleration Time:===
{{Table371|
*Defines how long it takes for a secondary weapon to attain full speed. Takes precedence over $Free Flight Time (see below) in terms of the weapon's velocity, and affects both locked-on and dumbfired secondaries.
*Syntax: '''''Float''''', seconds
**Default: 0.0}}

===$Velocity Inherit:===
{{Table371|
*Defines how much of the parent ship's velocity to inherit, if [[Ai_profiles.tbl#.24use_additive_weapon_velocity:]] is used.
*Syntax: '''''Float''''', percents
**Default: 100.0}}

===$Free Flight Time:===
{{Table3610|
*Defines the free flight time of homing weapons. During this time weapon flies at 1/4 of its velocity + firing ships velocity in a straight line.
*Syntax: '''''Float''''', seconds
**Default: 0.25}}

'''Note:''' due to dumbfires never changing their speed, using this on a dumbfire missile will have it stuck at freeflight speed even after the end of the freeflight time.

===$Free Flight Speed:===
{{Table3613|
*Defines the speed that the weapon will be travelling at during the free flight segment (see above).
*Syntax: '''''Float''''', Multiplier for the actual speed, minimum 0.01.
**Default: 0.25
{{Note| This feature was never implemented correctly and was removed in r8867. FSO currently parses but doesn't use the value, and prints a warning in the log saying that the value will not be used.}}
}}

===$PreLaunchSnd:===
{{Table3613|
*Defines the one-shot sound effect to play at the beginning of a firing stream. Currently only has an effect on primary weapons.
*Syntax: '''''Integer''''' or '''''String''''', name or identification number of the sound as defined in [[sounds.tbl]]
**Default: No Sound}}

===+PreLaunchSnd Min Interval:===
{{Table3613|
*Defines Minimum interval between when the player stops firing and the next time the pre-launch sound can play, as a limiter in case the player is pumping the trigger.
*Syntax: '''''Integer''''', Minimum delay in milliseconds between the end of the previous firing sequence and the next time the pre-launch sound effect will be played.
**Default: 0 (play pre-launch sound at the beginning of every firing sequence, if present)}}

===$LaunchSnd:===
*Corresponding sound effect when the weapon is launched.
*Syntax: '''''Integer''''' or '''''String''''', name or identification number of the sound as defined in [[sounds.tbl]]

===$ImpactSnd:===
*Sound the weapon makes when it hits a hull.
*Syntax: '''''Integer''''' or '''''String''''', name or identification number of the sound as defined in [[sounds.tbl]]

===$Disarmed ImpactSnd:===
{{Table3610|
*Sound the weapon makes when it hits a hull before being armed.
*Syntax: '''''Integer''''' or '''''String''''', name or identification number of the sound as defined in [[sounds.tbl]]}}

===$FlyBySnd:===
*The sound this weapon makes if it narrowly misses you. -1 is no sound.
*Syntax: '''''Integer''''' or '''''String''''', name or identification number of the sound as defined in [[sounds.tbl]], usually -1

===$TrackingSnd===
{{Table3615|
*The looping sound played when this weapon tracks a target.
*Syntax: '''''Integer''''' or '''''String''''', name or identification number of the sound as defined in [[sounds.tbl]]}}

===$LockedSnd===
{{Table3615|
*The sound played when this weapon has locked onto its target.
*Syntax: '''''Integer''''' or '''''String''''', name or identification number of the sound as defined in [[sounds.tbl]]}}

===$InFlightSnd===
{{Table3615|
*The looping sound played when the missile is currently flying.
*Syntax: '''''Integer''''' or '''''String''''', name or identification number of the sound as defined in [[sounds.tbl]]
*'''+Inflight sound type'''
**Specifies when the in flight sound is played.
**The value can be one of the following values which are matched case-insensitively:
***''''''TARGETED'''''': The sound is played when the missile tracks a target
***''''''UNTARGETED'''''': The sound is played when the missile is currently not tracking a target
***''''''ALWAYS'''''': The sound is played always}}

===$Model:===
{{Table3610|
*Defines used model file. Included for compatibility with countermeasures as they have been merged with weapons in the code.
*Syntax: '''''String.pof''''', model filename}}

===$Rearm Rate:===
*Defines the frequency that weapons are loaded to the ship
*Syntax: '''''Float''''', How many times per second the weapons are loaded.
**Example: 2.0 will reload every half second. 0.1 will load every ten seconds.

===$Rearm Ammo Increment:===
{{Table38|
*Defines how many missiles or how much ballistic ammo is loaded per load sound.
*Syntax: '''''Integer''''', how many bullets or missiles are loaded.}}

===+Weapon Range:===
*Defines the range to the target where the weapons under AI will start firing. This also affects the [[Hud_gauges.tbl#Lead_Indicator|Lead Indicator]]
*Syntax: '''''Float''''', meters

===+Weapon Min Range:===
{{Table3610|
*Defines the minimum range to the target where the weapons under AI will still fire.
*Implemented before FS_Open 3.6.5
*Syntax: '''''Float''''', meters}}

===$Flags:===
*See [[Weapons.tbl#Weapons.tbl_Flags|below]]
*Syntax: '''''( "String" "String" )''''', names of the flags assigned to the weapon
**Example: ( "Player allowed" "in tech database" )

{{Table3610|
*Can be followed by '''+override''' option in order to reset the weapon flags before parsing in the new ones
*Using this option will erase all '''homing'''-related flags as well as '''swarm''', '''variable lead''', '''trail''', '''TAG''', and '''transparent''' settings in addition to the listed flags. All these should be set again - if they are required - when this option is used.

**Syntax: '''''+override'''''}}

===$Trail:===
*This is used if you want your weapon to have a trail. Trail is often used only with secondaries though it works with standard primaries as well.
*'''+Start Width:'''
**How wide the head of the trail is.
**Syntax: '''''Float''''', meters
*'''+End Width:'''
**How wide the tail of the trail is.
**Syntax: '''''Float''''', meters
*'''+Start Alpha:'''
**The opacity of the trail head.
**Syntax: '''''Float''''', value between 0 and 1
*'''+End Alpha:'''
**The opacity of the trail tail.
**Syntax: '''''Float''''', value between 0 and 1
*'''+Max Life:'''
**How long the trail lasts.
**Syntax: '''''Float''''', seconds
*'''+Bitmap:'''
**The graphic file to use for the trail.
**Syntax: '''''String''''', filename
{{Table3611|
*'''+Faded Out Sections:'''
**Defines the number of the trail sections (counting from the leading edge) which are gradually faded out.
**Syntax: '''''Integer''''', number of trail sections}}

===$Icon:===
*Loadout icon used in the weapons selection screen.
*Syntax: '''''String''''', filename

===$Anim:===
*Green grid animation used on the weapons screen.
*Syntax: '''''String''''', filename

===$Collide Ship:===
{{Table3610|
*Has been replaced with '''#Conditional Hooks''', see [[Scripting.tbl]]}}

===$Collide Weapon:===
{{Table3610|
*Has been replaced with '''#Conditional Hooks''', see [[Scripting.tbl]]}}

===$Impact Effect:===
{{Table38|
*Specifies the [[Particle Effects|particle effect]] which will be used for impacts of this weapon.
*Syntax: '''String''', the particle effect name
*If this option is specified then ''$Impact Explosion'' and ''$Impact Explosion Radius'' are not valid options!
}}

===$Impact Explosion:===
*Impact explosion used. Must be defined in weapon_expl.tbl,
*Syntax: '''''String''''', filename or ''none''

===$Impact Explosion Radius:===
*Radius of the defined impact explosion.
*Syntax: '''''Float''''', meters, default 1.0

===$Shield Impact Explosion Radius:===
{{Table373|
*Radius of the shield impact explosion, see [[Ships.tbl#.24Shield_Impact_Explosion:]].
*Syntax: '''''Float''''', meters, defaults to value of $Impact Explosion Radius}}

===$Dinky Impact Effect:===
{{Table38|
*Specifies the [[Particle Effects|particle effect]] which will be used for Dinky (not armed) explosions of this weapon.
*Syntax: '''String''', the particle effect name
*If this option is specified then ''$Dinky Impact Explosion'' and ''$Dinky Impact Explosion Radius'' are not valid options!
}}

===$Dinky Impact Explosion:===
{{Table3610|
*Same as Impact Explosion but for Dinky (not armed) explosions
*Syntax: '''''String''''', filename or ''none''}}

===$Dinky Impact Explosion Radius:===
{{Table3610|
*Same as Impact Explosion Radius but for Dinky explosions
*Syntax: '''''Float''''', meters}}

===$Piercing Impact Effect:===
{{Table38|
*Specifies the [[Particle Effects|particle effect]] which will be used for piercing impacts.
*Syntax: '''String''', the particle effect name
*If this option is specified then piercing impact options below are not valid!
}}

===$Piercing Impact Explosion:===
{{Table3611|
*Defines the effect used for events when weapon pierces the target
*Syntax: '''''String''''', filename or ''none''}}

===$Piercing Impact Radius:===
{{Table3611|
*Defines the base radius of the effect used for piercing weapon impacts
*Syntax: '''''Float'''''}}

===$Piercing Impact Velocity:===
{{Table3611|
*Defines the base velocity for the particles piercing the target
*Syntax: '''''Float'''''}}

===$Piercing Impact Splash Velocity:===
{{Table3611|
*Defines the base velocity for the particles splashing from the target (secondary piercing effects
*Negative value causes the second batch or particles to splash to opposite direction
*Syntax: '''''Float'''''}}

===$Piercing Impact Variance:===
{{Table3611|
*Defines the variance added to the particles
*Values near 0 cause very little variance and values close to 1 cause extreme dispersal.
*Syntax: '''''Float'''''}}

===$Piercing Impact Life:===
{{Table3611|
*Defines the lifetime of the effect for single frame effects
*For multiple frame effects the lifetime is the lifetime of the animation used
*Syntax: '''''Float'''''}}

===$Piercing Impact Particles:===
{{Table3611|
*Defines the number of particles released per impact
*Syntax: '''''Integer'''''}}

===$Piercing Impact Draw Modifier:===
{{Table3611|
*Defines the multiplier applied to the ships piercing effect limit percentage
*Syntax: '''''Float'''''}}
*Option removed in 3.6.12. Use [[armor.tbl]] to finetune piercing effects.

===$Inflight Effect:===
{{Table38|
*Sets the inflight [[Particle Effects|particle effect]] which is used when the laser is active. This is only used by laser weapons.
*Syntax: '''''String''''', the particle effect name
}}
===$Freeflight Effect:===
{{Table38|
*Sets the [[Particle Effects|particle effect]] which is used when the missile is in the free flight phase. See [[#$Free Flight Time:|$Free Flight Time]] for more information.
*Syntax: '''''String''''', the particle effect name
*This option is only valid for missile weapons
}}
===$Ignition Effect:===
{{Table38|
*Sets the ignition [[Particle Effects|particle effect]] which is used when the missile is transitioning from free flight to homed or unhomed flight.
*Syntax: '''''String''''', the particle effect name
*This option is only valid for missile weapons
}}
===$Homed Flight Effect:===
{{Table38|
*Sets the ignition [[Particle Effects|particle effect]] which is used when the missile is in homed flight mode.
*Syntax: '''''String''''', the particle effect name
*This option is only valid for missile weapons
}}
===$Unhomed Flight Effect:===
{{Table38|
*Sets the ignition [[Particle Effects|particle effect]] which is used when the missile is in unhomed flight mode.
*Syntax: '''''String''''', the particle effect name
*This option is only valid for missile weapons
}}

===$Muzzleflash:===
*Normally only with flak cannons.
*Defines the muzzle flash the weapon uses
*Syntax: '''''String''''', muzzleflash name, as defined in [[mflash.tbl]]

===$EMP Intensity:===
*If it has an EMP effect, how deeply it scrambles your electronics
*Basically a percentage, a value of 250 results in a 25% chance of something getting scrambled each frame.
*Maximum value of 500
**Syntax: '''''Float'''''

===$EMP Time:===
**Duration of the EMP effect
**Syntax: '''''Float''''', seconds

===$Recoil Modifier:===
{{Table373|
*Multiplies the recoil force of a weapon by this value, use a value greater than 1.0 to increase the force, use a value between 1.0 and 0.0 to decrease.
**Syntax: '''''Float''''' (defaults to 1.0)
{{Note| The "apply recoil" weapon flag must be set for this to be valid. If the flag is not set, FSO will throw a warning and automatically set it at runtime.}}
}}

===$Leech Weapon:===
**The amount of weapon energy to drain with each hit (a flat value, not a percentage)
**Needs the [[#Esuck|Esuck]] flag set to have any effect
**Syntax: '''''Float''''' (defaults to 10.0)

===$Leech Afterburner:===
**The amount of afterburner fuel to drain with each hit (a flat value, not a percentage)
**Needs the [[#Esuck|Esuck]] flag set to have any effect
**Syntax: '''''Float''''' (defaults to 10.0)

===$Corkscrew:===
{{Table3610|
*Allow corkscrew parameters to be defined
*'''+Num Fired:'''
**Defines the number of weapons fired in sequence. Same as the standard swarm entry but for corkscrew missiles
**Syntax: '''''Integer''''', number of missiles
*'''+Radius:'''
**Defines the radius used in the corkscrew motion
**Syntax: '''''Float''''', meters
*'''+Fire Delay:'''
**Defines the delay between missile firings
**Syntax: '''''Integer''''', milliseconds
*'''+Counter rotate:'''
**Defines if every other missile rotates to a different direction (clockwise / anticlockwise)
**Syntax: '''''Boolean''''', ''0'' or ''1'', no or yes
*'''+Twist:'''
**Defines the speed of rotation movement on the radius of corkscrew motion.
**Syntax: '''''Float''''', radians per second}}

===$Electronics:===
{{Table3610|
*Defines the weapons effect against electronics. Requires [[weapons.tbl#"Electronics"|"electronics"]] flag. '''+New Style:''' and '''+Old Style:''' options are mutually exclusive.
*'''+New Style:'''
**Defines that the electronics use the new style which enables more options.
*'''+Old Style:'''
**Defines that the electronics use the old style. The old style was the way the D-Missile worked in Descent: FreeSpace.
}}
{{Table371|
*'''+Area Of Effect'''
**If specified, allows the electronics effect to apply to every ship hit by this weapon's blast or shockwave (the "Electronics" flag isn't necessary with this option).
}}
{{Table3610|
*'''+Intensity:'''
**May only be used with '''+New Style:''' electronics. '''''Has been deprecated'''''.
**Syntax: '''''Float'''''
*'''+Lifetime:'''
**Syntax: '''''Integer''''', milliseconds
*'''+Engine Multiplier:'''
**May only be used with '''+New Style:''' electronics. Defines how much longer the disruption effect lasts for engine subsystems.
**Syntax: '''''Float'''''
*'''+Weapon Multiplier:'''
**May only be used with '''+New Style:''' electronics. Defines how much longer the disruption effect lasts for non-beam turrets.
**Syntax: '''''Float'''''
*'''+Beam Turret Multiplier:'''
**May only be used with '''+New Style:''' electronics. Defines how much longer the disruption effect lasts for beam turrets.
**Syntax: '''''Float'''''
*'''+Sensors Multiplier:'''
**May only be used with '''+New Style:''' electronics. Defines how much longer the disruption effect lasts for sensor subsystems.
**Syntax: '''''Float'''''
*'''+Randomness Time:'''
**Defines the randomness of duration target suffers from the electronics hit. A random number between 0 and this time will be added or subtracted from the disruption time.
**Syntax: '''''Integer''''', milliseconds

* Without any electronics parameters, a weapon with the "electronics" flag will default to the ''Old Style'' mode with a lifetime of 6000 milliseconds and a randomness of 4000 milliseconds. Thus any ship that gets hit can get disrupted for anywhere between 2 to 10 seconds.

}}

===$Spawn Angle:===
{{Table3610|
*Defines the cone (with an angle) where the spawned weapons appear. ''Value'' gives the angle from the missiles centerline. The maximum possible angle between any two child weapons would be ''Value*2''.
*Spawn angle can be defined as many times as the carrier missile has child weapons defined for it (up to 5).
*Syntax: '''''Float''''', degrees}}

===$Local SSM:===
{{Table3610|
*Defines the local SSM (Subspace Missile). In effect missile moves via subspace to a position close to the target and starts homing.
*Weapon must be '''''aspect seeking missile''''' and must have '''''[[Weapons.tbl#"local ssm"|local ssm]]''''' flag.
*'''+Warpout Delay:'''
**Defines the time between the missile launch and the subspace jump.
**Syntax: '''''Integer''''', milliseconds
*'''+Warpin Delay:'''
**Defines the time missile stays in subspace before exiting.
**Syntax: '''''Integer''''', milliseconds
*'''+Stage 5 Velocity:'''
**Defines the velocity of the missile after the subspace jump.
**Syntax: '''''Float''''', meters per second
*'''+Warpin Radius:'''
**Defines how far from the SSM will appear from the outer radius of the target.
**Syntax: '''''Float''''', meters
*'''+Lock Range:'''
**Defines the maximum range where SSM can achieve target lock
**Syntax: '''''Float''''', meters}}

===$Countermeasure:===

*Defines the countermeasure effectiveness, radius, etc
{{note|
*Spoofing chance is defined as '''cm type effectiveness'''/'''[[#+Seeker Strength:|seeker strength]]''' (missile must be within the countermeasures '''+Effective Radius:''').
*All countermeasures in the mission perform tests to spoof missiles for two frames after '''any countermeasure''' is created in the mission. No, this doesn't seem to make much sense.
{{Table382|The global frame counter can be bypassed by using '''[[#+Pulse Interval:|pulse interval]]'''.}}
*'''Provisional'''; Countermeasures are only given one chance to spoof any individual missile. This makes tuning seeker strength/effectiveness meaningful.
**Previously some record of which countermeasures had been seen by each missile was kept, but it broke when multiple countermeasures were involved. A good chance of breaking with two countermeasures, and a guaranteed chance of breaking with three or more. This reduced the impact of the seeker strength/effectiveness ratio, but was partly cancelled out by the 2 frames thing.
}}

{{Table3610|
===='''+Heat Effectiveness:'''====
*Defines the countermeasures effectiveness against heat seeking missiles
*Syntax: '''''Float''''', cm effectiveness
**Default: 1.0

===='''+Aspect Effectiveness:'''====
*Defines the countermeasures effectiveness against aspect seeking missiles
*Syntax: '''''Float''''', cm effectiveness
*Default: 1.0

===='''+Effective Radius:'''====
*Defines the countermeasures effective radius
*Syntax: '''''Float''''', meters
**Default: 300.0
}}

{{Table373|
====+Missile Detonation Radius:====
*Defines the radius within which a missile homing on this countermeasure will trigger a detonation (see '''+Single Missile Kill:''')
*Syntax: '''''Float''''', meters
**Default: 40.0
{{note| only affects missiles homing on countermeasures, i.e. heat or aspect with "pulls aspect seekers" flag}}

====+Single Missile Kill:====
*Defines if countermeasures will detonate only the missile homing on this countermeasure, or every missile within '''+Missile Detonation Radius:'''
*Syntax: '''''Boolean'''''
**Default: false
{{note| only affects missiles homing on countermeasures, i.e. heat or aspect with "pulls aspect seekers" flag}}
}}

{{Table382|
====+Pulse Interval:====
*Defines how much time passes between each pulse of this countermeasure.
*Syntax: '''''Float''''', milliseconds
**Default: 0
{{note| any value less than or equal to 0 means the countermeasure doesn't pulse, and uses the global 2-frame counter after any countermeasure is fired.}}
}}

===$BeamInfo:===
*'''+Type:'''
**Defines the type of beam in question. Beam types: 0 is a standard non-slashing type beam. 1 is a slashing type beam. 2 is a targeting beam that is used to trigger SSMs. 3 is a beam type that fires pulses in anti-fighter role and acts like type 0 beam in other roles. 4 is a beam that is restricted to what is directly in front of it, along turrets firepoints normal.
**Syntax: '''''Integer''''',, only values from 0 to 4 are legal
*'''+Life:'''
**How long it lasts once the beam is actually firing.
**Syntax: '''''Float''''', seconds
*'''+Warmup:'''
**Warmup time
**Syntax: '''''Integer''''', milliseconds
*'''+Warmdown:'''
**Warmdown time
**Syntax: '''''Integer''''', milliseconds
*'''+Radius:'''
**Muzzle glow radius
**Syntax: '''''Float''''', meters
*'''+PCount:'''
**Particles spewed every interval. ??
**Syntax: '''''Integer'''''
*'''+PRadius:'''
**Particle radius
**Syntax: '''''Float''''', meters
*'''+PAngle:'''
**Defines the random "cone" where the particles are generated
**Syntax: '''''Float''''', angle of the cone
*'''+PAni:'''
**Animation used to represent the particles
**Syntax: '''''String''''', filename
*'''+Miss Factor:'''
**The higher the numbers, the more likely that this beam will miss. One value for every difficulty level
**Syntax: '''''Miss Factor''''', five '''floats''', very easy, easy, moderate, hard, insane, respectively.
***Example: 0.5 0.975 1.35 1.875 2.5
{{Table3613|
*'''IFF specific miss factors'''
**Identical to the preceding entry but IFF specific. Replace the <IFF> with the name of the IFF from [[iff_defs.tbl]]
**Syntax: '''''+<IFF> Miss Factor:''''', five '''floats''', very easy, easy, moderate, hard, insane, respectively.
***Example: 0.5 0.975 1.35 1.875 2.5}}
*'''+BeamSound:'''
**Corresponding looping sound effect when the beam is firing.
**Syntax: '''''Integer''''' or '''''String''''', name or identification number of the sound as defined in [[sounds.tbl]]
*'''+WarmupSound:'''
**Corresponding sound effect when the beam is beam warmed up.
**Syntax: '''''Integer''''' or '''''String''''', name or identification number of the sound as defined in [[sounds.tbl]]
*'''+WarmdownSound:'''
**Corresponding sound effect when the beam is warming down.
**Syntax: '''''Integer''''' or '''''String''''', name or identification number of the sound as defined in [[sounds.tbl]]
*'''+Muzzleglow:'''
**Defines the bitmap used to create the muzzle glow
**Syntax: '''''String''''', filename
{{Table372|
*'''+Directional Glow:'''
**Defines the length to stretch the muzzleglow along the beam.
**Syntax: '''''Float''''', length in meters, the muzzleglow is rendered along (in the same plane) as the beam instead of perpendicular to the camera.}}
*'''+Shots:'''
**Defines into how may invidual shots the type 3 (AAA) beams are divided. Note total firing is the same as the +Life:
**Syntax: '''''Integer'''''
*'''+ShrinkFactor:'''
**What percentage of lifetime where beam starts shrinking (0.1 == 10% life left)
**Syntax: '''''Float'''''
*'''+ShrinkPct:'''
**What percentage of max width we subtract per second
**Syntax: '''''Float'''''
{{Table3610|
*'''+Range:'''
**Defines the maximum range where the beam still has any effect.
**Syntax: '''''Float''''', meters
*'''+Attenuation:'''
**Defines the point where the damage caused by the beam starts to attenuate. At maximum range damage is zero.
**Syntax: '''''Float''''', from 0 - firing point to 1 - no effect
***Default: 1}}
{{Table3611|
*'''+BeamWidth:'''
**Defines the width of the beam for collision test purposes instead of using widest beam section.
**Syntax: '''''Float''''
{{Table38|
*'''+Beam Flash Particle Effect:'''
**Specifies the beam flash [[Particle Effects|particle effect]].
**Syntax: '''''String''''', particle effect name
**If this is specified then '''+Beam Flash Effect''' and '''+Beam Flash Radius''' are not valid options!
}}
*'''+Beam Flash Effect:'''
**Defines the additional impact flash effect for the beam.
**Syntax: '''''String''''', filename
*'''+Beam Flash Radius:'''
**Defines the radius for the additional impact flash effect.
**Syntax: '''''Float'''''
*'''+Beam Piercing Effect:'''
**Defines the beam piercing (bursting flames) effect for the beam.
**Syntax: '''''String''''', filename
*'''+Beam Piercing Radius:'''
**Defines the average radius used for the beam piercing effects.
**Syntax: '''''Float'''''
*'''+Beam Piercing Effect Velocity:'''
**Defines the base velocity for the piercing effects
**Syntax: '''''Float'''''
*'''+Beam Piercing Splash Effect Velocity:'''
**Defines the base velocity for the secondary piercing effects
**Negative velocity causes the particles to move to opposite direction
**Syntax: '''''Float'''''
*'''+Beam Piercing Effect Variance:'''
**Defines the variances of the particles from the main path
**Values close to 0 cause minimum variance, higher values cause higher variances
**Syntax: '''''Float'''''}}

*'''$Section:'''
**Beams are made up of up to five sections layered atop one another to create the effect. Each section has its own parameters.
{{Table3610|
:*'''+Index:'''
:**Field used to define with [[Modular Tables]] the beam section which is edited.
:**Only needed when editing beams that already exist in other tables.
:**Syntax: '''''Integer''''', index number legal values are from 0 to 5
:*'''+remove'''
:**Removes the set beam section.
:*'''+nocreate'''
:**Does not create new section for the beam}}

:*'''+Width:'''
:**Width of the section
:**Syntax: '''''Float''''', meters
:*'''+Texture:'''
:**Texture for the section
:**Syntax: '''''String''''', filename
:*'''+RGBA Inner:'''
:**Defines the color and transparency of the center of the section
{{Table3613|:**Not used in current builds. Settings entered here will have no effect.}}
:**Syntax: '''''Color''''', red, green, blue, alpha, respectively, value from 0 to 255
:***Example: 255 255 255 255
:*'''+RGBA Outer:'''
:**Defines the color and transparency of the edges of the section
{{Table3613|:**Not used in current builds. Settings entered here will have no effect.}}
:**Syntax: '''''Color''''', red, green, blue, alpha, respectively, value from 0 to 255
:***Example: 150 150 150 10
:*'''+Flicker:'''
:**Defines how much the section flickers
:**Syntax: '''''Float''''', value from 0 to 1
:*'''+Zadd:'''
:**Defines the 'thickness' of the section. The higher the Zadd, the closer the section appears to be. (Zadd can be safely ignored; it actually does nothing.)
:**Syntax: '''''Float'''''
{{Table3610|
:*'''+Tile Factor:'''
:**Defines the beam texture tiling factor. Second number defines the tiling type. Type 0 tiles the graphic in the beam as many times as defined by the 1st number. Type 1 uses the 1st value as the lenght of the tile.
:**Syntax: '''''Float''''', '''''Integer'''''
:*'''+Translation:'''
:**Defines the speed of translation of the beam, a positive value moves from the impact point to the firing point, while a negative value moves away from the firing point towards the impact point. Measured in tiles per second, where the tile count is defined in the "+Tile Factor:" field above.
:**Syntax: '''''Float'''''}}

===$Pspew:===
{{Table3610|
*Defines a particle spew effect for the given weapon
}}{{Table3613|
*'''+Index:'''
**indicates which spewer to add/edit/delete. may be 0-3. used for xmt compatibility.
**Syntax: '''''Integer'''''
*'''+Remove'''
**removes spewer at +Index: (requires +index:)
*'''+Type:'''
**type of particle spew
**Syntax: '''''String'', Default, Helix, Sparkler, Ring, or Plume '''
}}{{Table3610|
*'''+Count:'''
**Defines how many particles are spawn when they are ready to be created (at each +Time: interval)
**Syntax: '''''Integer'''''
*'''+Time:'''
**Defines the time in milliseconds between next particle(s) spewed
**Syntax: '''''Integer''''', milliseconds
*'''+Vel:'''
**Defines the created particles velocity as percentage of the weapons velocity
**Syntax: '''''Float'''''
*'''+Radius:'''
**Defines the size of the created particles
**Syntax: '''''Float''''', meters
*'''+Life:'''
**Defines how long the particles last.
**Syntax: '''''Float''''', seconds
*'''+Scale:'''
**Defines the particle spread. Small value will make particles group together
**typically controls how big the effect is or how fast it moves away from the weapon path on a perpendicular (or sometimes arbitrary) axis.
**helical spews and rings use this value to control how fast the particle helix moves away from the central axis.
**sparklers use this to control how fast particles move away from the spawn point, in any direction
**plumes use this to set the diameter of the disk across which particles are spawned
**Syntax: '''''Float'''''
}}{{Table3613|
*'''+Z Scale:'''
**for sparklers, allows you to elongate the effect to surround other effects, like lasers. essentially a length multiplier
**for plume, it multiplies against +scale to set the plume to spread or converge, zero would be full convergence, 1 would be straight flight, and bigger numbers would cause particles to diverge from the disk.
**Syntax: '''''Float'''''
*'''+Rotation Rate:'''
**used only by helical spews, controls how many rotations per second the helix makes
**Syntax: '''''Float'', may be negative, useful for setting up 2 spews that spin in opposite directions'''
*'''+Offset:'''
**position of effect with regards to the weapon center
**Syntax: '''''Vector'''''
*'''+Initial Velocity:'''
**to indicate both direction and speed of particle effects regards to the weapon velocity and +scale:
**Syntax: '''''Vector'''''
}}{{Table3610|
*'''+Bitmap:
**Defines the animation used to create the particle spew effect
**Syntax: '''''String''''', filename}}

===$Tag:===
*Allowed for secondary weapons
{{Table3610|
*Allowed for primary weapons and secondary weapons}}

*Sets this weapon as a TAG missile, level 1, 2, or 3. The second number is the duration in seconds.
*TAG Level 1 will illuminate hidden targets such as stealth fighters or ships normally obscured by nebula conditions.
*TAG Level 2 illiminates targets much like TAG Level 1, but turrets will prefer to shoot at them over other ships.
*TAG Level 3 has no effect in retail.
{{Table3610|
*TAG Level 3 allows the weapon to trigger [[Weapon.tbl#$SSM:|SSMs]]}}

*Syntax: '''''Integer''''' '''''Float''''', TAG level and seconds respectively
*'''Note''': TAG will not trigger unless the weapon in question has a non-zero damage value.

===$SSM:===
{{Table3610|
*Defines the weapons SSM index number.
*Requires [[Weapons.tbl#$Tag:|TAG level 3]] or a targeting beam.
*Syntax: '''''Integer'''''}}
{{Table373|
*Now also accepts SSM strike names.
*Syntax: '''''String'''''}}

===$FOF:===
{{Table3610|
*Defines the field of fire for the weapon. Causes weapon to fire into a firing cone instead of direct firing line thus causing light inaccuracy
*Syntax: '''''Float''''', degrees}}

====+FOF Spread Rate:====
{{Table37|
*Defines the spread rate of the field of fire. This controls how the FOF increases over time while the weapon is firing.
*Syntax: ''''''Float'''''', rate}}

====+FOF Reset Rate:====
{{Table37|
*Rate at which the spread decreases if the weapon isn't firing.
*Syntax: ''''''Float'''''', rate
*This is required if '''+FOF Spread Rate:''' is present}}

====+Max FOF:====
{{Table37|
*The maximum FOF. After the FOF reaches this value it will not increase any further.
*Syntax: ''''''Float'''''', degrees. Must be greater than or equal to zero.
*This is required if '''+FOF Spread Rate:''' is present}}

===$Shots:===
{{Table3610|
*Defines the number of shots every time the weapon is fired.
*Works only for primary weapons
*Syntax: '''''Integer''''', number of shots}}

===$decal:===
{{Table3610|
*Defines impact decals if they are in use
*'''+texture:'''
**Defines the texture used for impact decals (can use '''''-burn''''' and '''''-glow''''' textures)
**Syntax: '''''String''''', filename
*'''+backface texture:'''
**Defines ???
**Syntax: '''''String''''', filename
*'''+radius:'''
**Defines the size of the impact decals on target
**Syntax: '''''Float''''', meters
*'''+burn time:'''
**Defines the time the '''''-burn''''' texture appears on the target
**Syntax: '''''Integer''''', milliseconds}}
{{Table3613|
*Feature removed - table parsing retained to maintain compatibility}}

===$Transparent:===
{{Table3610|
*Defines weapon effect as transparent. Enables optional fields for 'alpha animations'
*'''+Alpha:'''
**Defines the strenght of the alpha (transparency). And also the maximum value for the alpha cycle option
**Syntax: '''''Float''''', from 0 to 1
*'''+Alpha Min:'''
**Defines the minimum alpha value for alpha cycle option
**Syntax: '''''Float''''', from 0 to 1
*'''+Alpha Cycle:'''
**Defines the change in alpha per frame, between '''Alpha''' and '''Alpha Min''' values
**Syntax: '''''Float'''''}}

===$Weapon Hitpoints:===
{{Table3611|
*Defines the amount of hitpoints a weapon has.
*Weapons with '''"bomb"''' flag have 50 hitpoints by default
*Giving weapon hitpoints makes it possible for the weapon to be shot down or be destroyed by EMP.
**Syntax: '''''Integer'''''
}}

===$Armor Type:===
{{Table3613|
*REQUIRES ADDITIONAL TABLE. Defines the armor type for the weapon. This works exactly like ship armor types.
**Syntax: '''''String''''', name of the armor as defined in [[armor.tbl]]
}}

===$Burst Shots:===
{{Table3611|
*Defines the number of shots in a burst
*Shots in a burst use shorter ( '''$Burst Delay:''' ) delay than usually
**Syntax: '''''Integer'''''}}

===$Burst Delay:===
{{Table3611|
*Defines the time in milliseconds between the shots in a burst
**Syntax: '''''Integer'''''}}

===$Burst Flags:===
{{Table3611|
*Defines the flags used to define the burst firing behaviour
**Syntax: ( '''''String''''' '''''String''''' ), list of flags
**Available burst flags:
***'''"fast firing"''', acts as if '''same turret cooldown''' flag would be used between the shots in the burst.
***'''"random length"''', makes AI to fire burst of random length (from 1 to burst shots).}}

===$Thruster Flame Effect:===
{{Table3611|
*Defines the filename of the effect used on the modeled thruster of the missile
**Syntax: '''''String''''', filename}}

===$Thruster Glow Effect:===
{{Table3611|
*Defines the filename of the effect used on the glow type effect of the missile
**Syntax: '''''String''''', filename}}

===$Thruster Glow Radius Factor:===
{{Table3611|
*Defines the radius multiplier for the thruster's glow type effect
**Syntax: '''''Float'''''}}

===$Substitute:===
{{Table3613|
Defines a pattern of ammo to substitute for primary or secondary weapons. '''$Substitute:''' can be repeated any number of times (so you could make something like a rainbow laser with several ammo substitutions, for example). If neither ''+period'' or ''+index'' is specified, it is assumed to be equivalent to ''+index: '''0'''''.

*Syntax: '''''Weapon Name'''''
*'''Swarm missiles act in a strange way when used with $Substitute, use at your own risk.'''}}

{{Table3615|
Turrets can use $Substitute as well.
}}
====+period:====
{{Table3613|
FSO will substitute '''Weapon Name''' every ''period'' shots.

*Syntax: '''''Positive Integer'''''
*'''You may not define both +period and +index for the same $Substitute entry'''}}
=====+offset:=====
{{Table3613|
A suboption of +period, offsets the substitute pattern according to the launched ammo. For example, an offset of 3 and a period of 4 will substitute on the 3rd ammo launched, and then every 4th ammo after that.

*Syntax: '''''Positive Integer'''''}}

====+index:====
{{Table3613|
FSO will substitute the '''Weapon Name''' at firepoint ''index'' in the shot pattern. Similar to carefully using both +period and +offset, but is not affected by ships with different firepoint numbers. i.e. Firepoint ''index'' will always have the substitution, while +period and +offset will cycle at different rates dependant on the number of firepoints.'''

*Syntax: '''''Positive Integer'''''

*'''You may not define both +period and +index for the same $Substitute entry'''}}

==Weapons.tbl Flags==

==="Electronics"===
*Will seize up the weapons and engines systems of any ship for a short period of time.

==="Spawn ''Name'',''Value''"===
*Will spawn the specified number of defined missiles upon detonation.
{{Table3610|
*Multiple spawn types can be defined for a single 'carrier' weapon up to maximum of 5 different weapons}}

==="Remote Detonate"===
*Can be triggered remotely via a second press on the trigger

==="Big Ship"===
*These weapons cannot be mounted on small ships like fighters, bombers, sentry guns etc.

==="Huge"===
*Allows this weapon to do the final 10% damage to a ship with the "Big Damage" flag. Also the AI will not try to hit fighters with it, but only if the weapon is in a turret or is a secondary. If the weapon is a primary in a fighter then there are no targeting restrictions. See [[Weapons.tbl#.22capital.2B.22|capital+]] instead.

==="Supercap"===
*Allows this weapon to do the final 75% damage to a ship with the "supercap" flag.

==="Bomber+"===
*The AI will prefer to use this weapon against bombers

==="child"===
*Cannot be set as a weapon on any ship, but is instead a child of a weapon. Usually defined with "Spawn ''Name'',''Value''"

==="Bomb"===
*Makes this weapon targetable with the B key, and the AI prefers to use it against large ships

==="No Dumbfire"===
*Missile will not fire without a lock

==="in tech database"===
*Has the weapon in the tech database at the start of the campaign

==="Player allowed"===
*Allows this weapon as a player weapon.
{{Table3610|
*'''EXTREMELY IMPORTANT NOTE:'''
**Whenever you plan to use a weapon as a player one in your campaign or missions, '''USE THIS FLAG'''.
**Not using it can cause problems within fs_open and it's a BAD MOD DESIGN.
**In the future, fs_open will maybe be able to avoid these problems but, nevertheless, it's still a BAD DESIGN.
**As another possible example: be careful to update "retail" tables if you plan to use Shivan weapons in player fighters.}}

==="Particle Spew"===
*Makes the weapon projectile spew out particles
{{Table3610|
*Can be defined with [[Weapons.tbl#$Pspew:|Particle Spew parameters]]}}

==="EMP"===
*This weapon will have an EMP effect on any ship within the blast radius
*Can be defined with [[Weapons.tbl#$EMP_Intensity:|EMP Intensity]] and [[Weapons.tbl#$EMP_Time:|EMP Time]]

==="Esuck"===
*Drains the target's energy banks
*Can be defined with [[Weapons.tbl#$Leech_Weapon:|Leech Weapon]] and [[Weapons.tbl#$Leech_Afterburner:|Leech Afterburner]]

==="Flak"===
*Makes this weapon a [[weapons.tbl#Flak_Guns|flak gun]]

==="Corkscrew"===
*Makes this weapon spiral AND swarm 4.
{{Table3610|
*Can be defined with [[Weapons.tbl#$Corkscrew:|Corkscrew parameters]]}}

==="Shudder"===
*Makes your ship shudder while you're firing the weapon

==="lockarm"===
*Requires a target lock in order to arm its warhead. In other words weapon causes less damage if it hits the target without target lock.

==="beam"===
*Makes this weapon a [[weapons.tbl#Beam Cannons|beam cannon]]

==="stream"===
* Does nothing

==="puncture"===
*Reduces hull damage by 75%
The AI will prefer these weapons for anti-subsystem use

==="countermeasure"===
{{Table3610|
*Defines the weapon as a countermeasure}}

==="Ballistic"===
{{Table3610|
*Defines the weapon as a ballistic weapon that needs ammunition.
*Make sure you define the size and reload rate for ballistic weapons}}

==="pierce shields"===
{{Table3610|
*Causes weapons to penetrate shield without causing damage to it.}}

==="no pierce shields"===
{{Table3610|
*Prevents weapons (beams) from piercing shields causing shields to be damaged by weapons first.}}

==="local ssm"===
{{Table3610| }}

==="tagged only"===
{{Table3610|
*Weapon can only be fired at tagged targets}}

==="beam no whack"===
{{Table3610|
*Disables beam whacking (push). Practically same as setting beam mass to zero.}}

==="cycle"===
{{Table3610|
*Causes weapon to alternate between firing points}}

==="small only"===
{{Table3610|
*Causes AI to use the weapon only on small targets (fighters, bombers etc.)}}

==="same turret cooldown"===
{{Table3610|
*Forces the turrets to fire on the designated rate of fire on all difficulty levels and all AI levels}}

==="apply no light"===
{{Table3610|
*Prevents light from being applied to the weapon model.}}

==="training"===
{{Table3610|
*Sets weapon to be of training weapon type. ?}}

==="smart spawn"===
{{Table3611|
*Forces turret fired spawn weapon of this type to be fired like normal weapons.}}

==="inherit parent target"===
{{Table3611|
*Sets spawned 'child' weapons to use parent weapon's target.}}

==="no emp kill"===
{{Table3611|
*Defines the weapon (with hitpoints) to be immune to automatic EMP destruction.}}

==="untargeted heat seeker"===
{{Table3611|
*Defines the weapon as a heatseeker type missile which acquires its target by itself.}}

==="no radius doubling"===
{{Table3611|
*Prevents weapon radius from being doubled when doing collision test. Makes bombs harder to intercept.}}

==="no subsystem homing"===
{{Table3611|
*Prevents weapon from acquiring a subsystem as its target. Missile homing points are spread over the target ship.}}

==="no lifeleft penalty"===
{{Table3611|
*Prevents weapon lifetime from being penalized if the angle to the target is too big.}}

==="can be targeted"===
{{Table3611|
*Allows weapon to be targeted by player. Does not influence AI}}

==="show on radar"===
{{Table3611|
*Allows weapon to be visible on the radar}}

==="show friendly on radar"===
{{Table3611|
*Allows friendly, otherwise visible to radar weapon, to be visible on player radar}}

==="capital+"===
{{Table3613|
*Tells AI to use this weapon only on capital ships}}

==="chain external model fps"===
{{Table3613|
*Tells game to keep switching external model firingpoints when firing}}

==="external model launcher"===
{{Table3613|
*Tells game that the external model is a launcher so that it would be kept static without loading motion}}

==="takes blast damage"===
{{Table3613|
*Weapon takes damage from weapon blasts}}

==="takes shockwave damage"===
{{Table3613|
*Weapon takes damage from shockwaves}}

==="ciws"===
{{Table3615|
*Weapon can deal shockwave/blast damage to bombs, regardless of whether the target weapons have the "take blast/shockwave damage" flags.}}

==="render flak"===
{{Table3615|
*Normally, flak shells are not rendered. This flag switches rendering on for those weapons.}}

==="anti-subsystem beam"===
{{Table3615|
*Beam weapons with this flag can target subsystems on enemy ships, just like normal weapons.}}

==="no primary linking"===
{{Table3615|
*Primary weapons with this flag can not be linked with other weapons.}}

==="same emp time for capships"===
{{Table37|
*capships affected by this weapon will use the tabled EMP time rather than the fixed retail value (7.5 secs)}}

==="no primary linked penalty"===
{{Table371|
*Primary weapons with this flag do not incur the retail linked fire penalty}}

==="no homing speed ramp"===
{{Table371|
*Locked homing weapons will not perform the standard 1 second long acceleration when fired. Note that use of $Acceleration Time is '''not''' affected by this flag.}}

==="pulls aspect seekers"===
{{Table371|
*If an aspect seeker is grabbed by this countermeasure the missile will follow the countermeasure instead of going into dumbfire mode.
'''Only valid for countermeasures!'''}}

==="turret interceptable"===
==="fighter interceptable"===
==="interceptable"===
{{Table371|
*Allows turrets/fighters/both (respectively) to shoot at this weapon without requiring it to be a bomb. If this is the first time this weapon has been defined, it also gives it a default of 25 hitpoints so that it can be shot down.
'''If you use a TBM to give this flag to an existing weapon, you'll need to specify hitpoints manually (unless you want it to be unkillable but still draw defensive fire).'''}}

==="apply recoil"===
{{Table373|
*A ship that fires a weapon with this flag will experience a recoil effect, slowing the ship down and, with lighter strikecraft, inducing some rotation if the firing points are offset from the center of mass.
'''Do not use this with MVPs or retail ships unless you increase their density to 10 or use either $Recoil Modifier: in weapons.tbl or $Ship Recoil Modifier in ships.tbl. This is to avoid exaggerated effects due to retail models having manually defined masses.'''}}

==="don't spawn if shot"===
{{Table373|
*Prevents parent weapons from spawning children in the even of the parent weapon being shot down.}}

==="die on lost lock"===
{{Table373|
*Aspect seeking missiles (only, not heat seekers) will detonate upon losing their lock. Currently they only lose lock if decoyed by a countermeasure, AND "pulls aspect seekers" or similar is not set. The detonation will use their "dinky" explosion (i.e. same as if ran out of lifetime).}}

==Countermeasures==
*Usually not altered. Only one can exist
{{Table3610|
*More than one can exist}}

===$Name:===
*Name of the countermeasure
*Syntax: '''''String''''', name

===$Velocity:===
*Defines the speed of the countermeasure, relative to the ship.
*Syntax: '''''Float''''', meter per second

===$Fire Wait:===
*Definies the minumum time between the countermeasure launches
*Syntax: '''''Float''''', seconds

===Lifetime===
*Countermeasure's life time is defined between with minimum and maximum lifetime
*'''$Lifetime Min:'''
**Syntax: '''''Float''''', seconds
*'''$Lifetime Max:'''
**Syntax: '''''Float''''', seconds

===$LaunchSnd:===
*Defines the sound for the countermeasure launch
*Syntax: '''''Integer''''' or '''''String''''', name or identification number of the sound as defined in [[sounds.tbl]]

===$Model:===
*Defines the used model file (.pof)
*Syntax: '''''String.pof''''', model filename

==Player Weapon Precedence==
*First the primary weapons are defined, from most powerful to least powerful, and then the same for secondaries
*Syntax: ( '''''"String" "String"'''''), names of the weapons
*Example:

<pre>
$Player Weapon Precedence: (
"UD-8 Kayser"
"Prometheus R"
"Subach HL-7"
"Harpoon"
"Tempest"
"Rockeye" )
</pre>

==Sample==

<pre>
#Primary Weapons

$Name: @Subach HL-7
+Title: XSTR("GTW Subach HL-7", 3243)
+Description:
XSTR( "Standard Issue
Level 3 Hull Damage
Level 2 Shield Damage", 3244)
$end_multi_text
+Tech Title: XSTR("Subach HL-7", 146)
+Tech Anim: Tech_Subach_HL-7
+Tech Description:
XSTR(
"Descriptive text...", -1)
$end_multi_text
$Model File: none
@Laser Bitmap: newglo9
@Laser Glow: 2_laserglow03
@Laser Color: 250, 0, 0
@Laser Color2: 0, 0, 250
@Laser Length: 10.0
@Laser Head Radius: 0.90
@Laser Tail Radius: 0.90
$Mass: 0.2
$Velocity: 450.0
$Fire Wait: 0.2
$Damage: 15
$Armor Factor: 0.9
$Shield Factor: 0.7
$Subsystem Factor: 0.3
$Lifetime: 2.0
$Energy Consumed: 0.20
$Cargo Size: 0.0
$Homing: NO
$LaunchSnd: 76
$ImpactSnd: 85
$Flags: ( "in tech database"
"player allowed"
"stream")
$Icon: iconSD4
$Anim: SD4
$Impact Explosion: none

#End

#Secondary Weapons

$Name: EMP Adv.
+Title: XSTR("GTM-14 EMP Adv.", 3396)
+Description:
XSTR( "Advanced Missile
Electromagnetic Pulse Weapon
General Purpose Suppression", 3397)
$end_multi_text
+Tech Title: XSTR("GTM-14 EM Pulse Adv.", 3398)
+Tech Anim: Tech_EMP
+Tech Description:
XSTR(
"Descriptive text...", -1)
$end_multi_text
$Model File: EMPulse2.pof
$Mass: 15.0
$Velocity: 275.0
$Fire Wait: 2.0
$Damage: 45
$Blast Force: 20.0
$Inner Radius: 80.0
$Outer Radius: 300.0
$Shockwave Speed: 120.0
$Armor Factor: 1.0
$Shield Factor: 0.8
$Subsystem Factor: 0.5
$Lifetime: 5.0
$Energy Consumed: 0.0
$Cargo Size: 4.0
$Homing: YES
+Type: ASPECT
+Turn Time: 1.0
+Min Lock Time: 2.0
+Lock Pixels/Sec: 70
+Catch-up Pixels/Sec: 100
+Catch-up Penalty: 30
$LaunchSnd: 118
$ImpactSnd: 88
$FlyBySnd: -1
$Rearm Rate: 2.0
$Flags: ( "player allowed"
"EMP")
$Trail:
+Start Width: 0.25
+End Width: 0.75
+Start Alpha: 1.0
+End Alpha: 0.0
+Max Life: 1.5
+Bitmap: MissileTrail04
$Icon: iconEMPulse
$Anim: ecm
$Impact Explosion: ExpMissileHit1
$Impact Explosion Radius: 10.0
$EMP Intensity: 375.0
$EMP Time: 20.0

#End

$Player Weapon Precedence: (
"Subach HL-7"
"EMP Adv." )
</pre>

[[Category:Tables]]

Hud gauges.tbl

2020-04-15T16:00:40Z

Z64555: /* +Lead Sight: */ Changed description to make it more distinct from +Lead Indicator

{{SCP table}}

{{TableVersionGit|2016-09-14|f9bc01c}}

The '''hud_gauges.tbl''' is used for modifying the elements of the HUD. Not all gauges can be modified. However, custom gauges may be added to mimic their behavior (such as the wingman status display).

HUD Elements in FS2 are called Gauges, and each gauge has various options to customize appearance and, in some cases, their behavior as well.

This table is one of the [[Modular Tables]] and can be extended with xxx-hdg.tbm

[[Tables|List of Tables]]

==HUD Configurations==
The following entries are used on the HUD system, but have not been grouped with any particular gauge.

===$Load Retail Configuration:===
Optional. If yes, any gauge missing from the HUD gauge definitions below will be loaded using the retail defaults.

If no, any missing (default) gauge will prompt an error.

*Syntax: '''Boolean'''

===$Color:===
Optional. Sets the default HUD color for all gauges.

*Syntax: ('''Integer''' Red, '''Integer''' Green, '''Integer''' Blue)
*Valid Values: all values from 0 to 255

===$Font:===
Optional. Sets the font type to use for the HUD. This can either be a string or a number. A string references a font with a specific name while a number references a font with a specific index in the fonts table. The number option is deprecated and is only there for backwards-compatibility. Use the name if possible.

*Syntax: '''String''' or '''Integer''' font index number
*Valid Values: Any name or font index as defined in [[Fonts.tbl]]

===$Chase View Only:===
{{Table381|
Optional. Sets gauges to be displayed only in Chase View.

*Syntax: '''Boolean'''
*Default Value: '''False'''
}}

===$Max Directives:===
Optional. Sets the default maximum number of directives displayed simultaneously.

*Syntax: '''Integer''' maximum number of directives
*Valid Values: Any positive number
*Default Value: '''5'''

===$Max Escort Ships:===
Optional. Sets the default maximum number of escort ships to be shown in the escort list.

*Syntax: '''Integer'''
*Valid Values: Any positive number
{{Warning|
Entries more than 16 will cause the list to overflow into the weapons list for resolutions lower than 1024x768.}}

===$Length Unit Multiplier:===
Optional. Sets the multiplier to applied to the reported distances. For example, if the multiplier is 0.5, then the distance reported to the player will (or at least should) be 0.5 x actual distance.

*Syntax: '''Float'''
*Valid Values: Any positive number

===$Speed Unit Multiplier:===
Optional. Analogous to [[Hud_gauges.tbl#$Length Unit Multiplier:|$Length Unit Multiplier]], this sets the multiplier to be applied to all speeds reported to the player. For example, if the multiplier is 0.5, the the speed reported to the player will (or at least should) be 0.5 x actual speed.

*Syntax: '''Float'''
*Valid Values: Any positive number
*Default Values:
:'''The value used in $Length Unit Multiplier''', or
:'''1''', if $Length Unit Multiplier is undefined

===$Wireframe Targetbox:===
Optional. Defines the default draw method for the target viewer (a.k.a. targetbox).

*Syntax: '''Integer''' Draw method ID
*Valid Values:
::'''0''' - Standard with full, bright lighting
::'''1''' - Wireframe
::'''2''' - Standard with proper lighting (i.e. lit the same as the actual target)
{{Table3615|
::'''3''' - Untextured with full bright lighting (i.e. drawn with a single flat color)}}

===$Targetbox Shader Effect:===
{{Table3615|
Optional. If set, defines a unique ID for a shader effect to be used when rendering a ship for the targeting box. The ID will be passed to the main shader as in [[Post_processing.tbl##Ship_Effects|#Ship_Effects]], but a table entry for the effect is not needed.

*Syntax: '''Integer'''
*Valid Values: Any positive number
}}

===$Lock Wireframe Mode:===
Optional. If set, prevents targetbox draw method from being changed during the gaming session.
*Syntax: '''Boolean'''

===$Scale Gauges:===
{{Table371|
Optional. If set, all gauges will use this value as the default for scaling individual gauge sizes (i.e. doesn't affect gauges that use Position:, and doesn't affect the values of Offset:. In addition, if "$Load Retail Configuration:" is true then all unspecified retail gauges will use this value.

If not set, defaults to yes.

*Syntax: '''Boolean'''
}}

===$Force Scaling Above:===
{{Table373|
Optional. If gauge scaling is disabled, then gauges will be scaled as though the base resolution were this resolution or the real base resolution, whichever is greater.

Use this to disable scaling at lower resolutions while preventing gauges from getting too small at higher resolutions.

To disable this feature, use '''(-1, -1)'''.

*Syntax: ('''Integer''' width, '''Integer''' height)
}}

===$Reticle Style:===
Optional. Defines which aiming reticle to use.
*Syntax: '''String'''
*Valid Values:
:'''FS1''' - uses '''''reticle1_fs1.ani'''''
:'''FS2''' - uses '''''reticle1.ani'''''

==#Gauge Config==
The following entries define default gauge appearance and behavior. Each gauge has the option of overriding these options.

===$Ship:===
Deprecated and superceded by $Ships in FSO revision 9208. If defined, the following config data will only be used if the player ship is of the supplied ship class. Can be defined multiple times within a #Gauge config group to allow unique HUD configurations per ship class.

If not defined, all following config data will be applied to all ships.

*Syntax: '''String''', ship class name

===$Ships:===
Optional. Can be used to define a list of ships the hud definition that follows will be applied to. Can be defined multiple times within a #Gauge config group to allow unique HUD configurations per ship class.

If not defined, all following config data will be applied to all ships.

*`Syntax: '''( "Class name 1" "Class name 2" )''', ship class names formatted like a flag list.

====$Load Retail Configuration:====
Optional. Overrides the [[Hud_gauges.tbl#$Load Retail Configuration: 1|$Load Retail Configuration]] global option for this ship class.

*Syntax: '''Boolean'''

====$Color:====
Optional. Overrides the [[Hud_gauges.tbl#$Color: 1|$Color]] global option for this ship class.

*Syntax: See [[Hud_gauges.tbl#$Color: 1|$Color]]

====$Font:====
Optional. Overrides the [[Hud_gauges.tbl#$Font: 1|$Font]] global option for this ship class.

*Syntax: See [[Hud_gauges.tbl#$Font: 1|$Font]]

====$Chase View Only:====
{{Table381|
Optional. Overrides the [[Hud_gauges.tbl#$Chase View Only: 1|$Chase View Only]] global option for this ship class.

*Syntax: See [[Hud_gauges.tbl#$Chase View Only: 1|$Chase View Only]]
}}

===$Base:===
Required. Defines the base resolution for this HUD configuration, upon which other gauge options (such as [[Hud_gauges.tbl#Position:|Position:]] / [[Hud_gauges.tbl#Origin:|Origin:]] / [[Hud_gauges.tbl#Offset:|Offset:]]) will use as its coordinate system.

*Syntax: ('''Integer''' width, '''Integer''' height)
*Valid Values: All supported resolutions (?)

===$Scale Gauges:===
{{Table371|
Optional. If set, will configure gauges Scaling behaviour for gauges in this #Gauge Config section. i.e. overriding the default, or the value specified at the top of the file. Individual gauges can override this setting.

*Syntax: '''Boolean'''
}}

===$Force Scaling Above:===
{{Table373|
Optional. If gauge scaling is disabled, then gauges will be scaled as though the base resolution were this resolution or the real base resolution, whichever is greater.

Use this to disable scaling at lower resolutions while preventing gauges from getting too small at higher resolutions.

To disable this feature, use '''(-1, -1)'''.

*Syntax: ('''Integer''' width, '''Integer''' height)
}}

===$Required Aspect:===
Optional. If set, this configuration will only be loaded for the specified aspect ratios.

Used as a filter when there are multiple $Base: resolutions in the table

*Syntax: '''String'''
*Valid Values:
:"Full Screen" (4:3, aspect ratio < 1.5)
:"Wide Screen" (16:9, 16:10, or similar, aspect ratio >= 1.5)

===$Min:===
Optional. Minimum resolution for this config. Any resolution lower than specified will not use this configuration.

Used as a filter when there are multiple $Base: resolutions in the table

*Syntax: ('''Integer''' width, '''Integer''' height)
*Valid Values: All supported resolutions (?)

===$Max:===
Optional. Maximum resolution for this config. Any resolution higher than specified will not use this configuration.

Used as a filter when there are multiple $Base: resolutions in the table

*Syntax: ('''Integer''' width, '''Integer''' height)
*Valid Values: All supported resolutions (?)

===$Gauges:===
Following entries define gauge-specific behavior. For the most part, each gauge has its own overrides that, if not defined, would otherwise use the global values.

Since many gauges have the same configuration options, each gauge entry has a list of valid sub-entries. Unless stated otherwise, these options must be defined in the same order as they are shown, starting from the top and ending at the bottom.

====+Custom:====
Adds a custom gauge type.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Name:|Name:]]
:[[Hud_gauges.tbl#Text:|Text:]]
:[[Hud_gauges.tbl#X Offset:|X Offset:]] (Optional)
:[[Hud_gauges.tbl#Y Offset:|Y Offset:]] (Optional)
:[[Hud_gauges.tbl#Gauge Type:|Gauge Type:]]
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Active by default:|Active by default:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]

{{table381|
====+Scripted Gauge:====
Adds a scripted gauge type.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Name:|Name:]]
}}

====+Messages:====
Adds a gauge that display mission messages.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Max Lines:|Max Lines:]] (Optional)
:[[Hud_gauges.tbl#Max Width:|Max Width:]] (Optional)
:[[Hud_gauges.tbl#Line Height:|Line Height]] (Optional)
:[[Hud_gauges.tbl#Total Lifetime:|Total Lifetime:]] (Optional)
:[[Hud_gauges.tbl#Scroll Time:|Scroll Time]] (Optional)
:[[Hud_gauges.tbl#Step Size:|Step Size:]] (Optional)
:[[Hud_gauges.tbl#Hidden By Comms Menu:|Hidden By Comms Menu:]] (Optional)

====+Training Messages:====
Adds a text box, like the ones seen in the FS1 and FS2 training missions.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}

====+Support:====
Adds a text box that shows the Support ship's status and ETA

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Text Y-offset:|Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Dock Status X-offset:|Dock Status X-offset:]] (Optional)
:[[Hud_gauges.tbl#Dock Time X-offset:|Dock Time X-offset:]] (Optional)

====+Damage:====
Adds a gauge that shows how much damage a target (or the player?) has.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Hull Integrity Offsets:|Hull Integrity Offsets]] (Optional)
:[[Hud_gauges.tbl#Hull Integrity Value X-offset:|Hull Integrity Value X-offset]] (Optional)
:[[Hud_gauges.tbl#Top Background Height:|Top Background Height:]] (Optional)
:[[Hud_gauges.tbl#Subsystem Entry Height:|Subsystem Entry Height:]] (Optional)
:[[Hud_gauges.tbl#Subsystem List Start Offsets:|Subsystem List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Subsystem Entry Value X-offset:|Subsystem Entry Value X-offset:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Offset:|Bottom Background Offset:]] (Optional)

====+Wingman Status:====
Adds a gauge that monitors the status of your wing and squadron.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Left Background Filename:|Left Background Filename:]] (Optional) (needs an animation with one frame)
{{table3615|
:[[Hud_gauges.tbl#First Background Filename:|First Background Filename:]] (Optional) (needs an animation with one frame)}}
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional) (needs an animation with one frame)
:[[Hud_gauges.tbl#Right Background Filename:|Right Background Filename:]] (Optional) (needs an animation with one frame)
{{table3615|
:[[Hud_gauges.tbl#Last Background Filename:|Last Background Filename:]] (Optional) (needs an animation with one frame)}}
:[[Hud_gauges.tbl#Dot Filename:|Dot Filename:]] (Optional) (needs an animation with two frames, 1st is for alive wingmen, 2nd is for dead or missing wingmen)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
{{table373|
[[Hud_gauges.tbl#Fixed Header Position:|Fixed Header Position:]] (Optional)}}
:[[Hud_gauges.tbl#Left Background Width:|Left Background Width:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#First Background Size:|First Background Size:]] (Optional)}}
:[[Hud_gauges.tbl#Entry Width:|Entry Width:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Entry Size:|Entry Size:]] (Optional)
:[[Hud_gauges.tbl#Right Background Offset:|Right Background Offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Offset:|Last Background Offset:]] (Optional)}}
:[[Hud_gauges.tbl#Single Wing Offsets:|Single Wing Offsets:]] (Optional)
:[[Hud_gauges.tbl#Multiple Wing Start Offsets:|Multiple Wing Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Wing Name Offsets:|Wing Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Dot Offsets:|Dot Offsets:]] (Optional)
:[[Hud_gauges.tbl#Expansion Mode:|Expansion Mode:]] (Optional)

====+Auto Speed:====
Adds the Auto-Speed mode gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (needs animation with 4 frames, 3rd is without auto-match-speed enabled, 4th is with... and frames 0 & 1 are not used, done this way because retail fs2 uses the same animation file for the auto speed & auto targeting gauges)
:[[Hud_gauges.tbl#Auto Offsets:|Auto Offsets:]] (Optional)
:[[Hud_gauges.tbl#Speed Offsets:|Speed Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#On Text Color:|On Text Color:]] (Optional)
:[[Hud_gauges.tbl#On Text Color:|Off Text Color:]] (Optional)}}

====+Auto Target:====
Adds the Auto-target mode gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (needs animation with 2 frames, 1st is without auto-targeting enabled, 2nd is with)
:[[Hud_gauges.tbl#Auto Offsets:|Auto Offsets:]] (Optional)
:[[Hud_gauges.tbl#Target Offsets:|Target Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#On Text Color:|On Text Color:]] (Optional)
:[[Hud_gauges.tbl#On Text Color:|Off Text Color:]] (Optional)}}

====+Countermeasures:====
Adds a gauge that monitors the amount of remaining countermeasures the player's ship currently has.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (needs an animation with a single frame)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
:[[Hud_gauges.tbl#Value Offsets:|Value Offsets:]] (Optional)

====+Talking Head:====
Adds a video window to display pilot message videos (a.k.a talking heads).

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Animation Offsets:|Animation Offsets:]] (Optional)
:[[Hud_gauges.tbl#Animation Background Size:|Animation Background Size:]] (Deprecated)
{{table373|
:[[Hud_gauges.tbl#Animation Size:|Animation Size:]] (Optional)
}}

====+Directives:====
Adds a gauge that displays all currently active directives (includes current , completed, and failed)

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional) (needs animation with one frame)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional) (needs animation with one frame)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional) (needs animation with one frame)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Background Height:|Top Background Height:]] (Optional)
:[[Hud_gauges.tbl#List Start Offsets:|List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Bottom Background Offset:|Bottom Background Offset:]] (Optional)
:[[Hud_gauges.tbl#Max Line Width:|Max Line Width:]] (Optional)
}}

====+Weapons:====
Adds a weapon status and ammunition gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Primary List Top Background Filename:|Primary List Top Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Primary List Middle Background Filename:|Primary List Middle Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Primary List Bottom Background Filename:|Primary List Bottom Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Secondary List Top Background Filename:|Secondary List Top Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Secondary List Entry Background Filename:|Secondary List Entry Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Secondary List Bottom Background Filename:|Secondary List Bottom Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
::[[Hud_gauges.tbl#Alt Ballistic Offsets:|Alt Ballistic Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Primary Background X-offset:|Top Primary BackgroundX-offset:]] (Optional)
::[[Hud_gauges.tbl#Alt Ballistic X-offset:|Alt Ballistic X-offset:]] (Optional)
:[[Hud_gauges.tbl#Text X-offset:|Text X-offset:]] (Optional)
::[[Hud_gauges.tbl#Alt Ballistic X-offset:|Alt Ballistic X-offset:]] (Optional)
:[[Hud_gauges.tbl#Top Primary Frame Height:|Top Primary Frame Height:]] (Optional)
:[[Hud_gauges.tbl#Top Secondary Frame Height:|Top Secondary Frame Height:]] (Optional)
:[[Hud_gauges.tbl#Primary List Start Y-offset:|Primary List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary List Start Y-offset:|Secondary List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Ammo X-offset:|Primary Weapon Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Link X-offset:|Primary Weapon Link X-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Name X-offset:|Primary Weapon Name X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Ammo X-offset:|Secondary Weapon Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Linked X-offset:|Secondary Weapon Linked X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Name X-offset:|Secondary Weapon Name X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Reload X-offset:|Secondary Weapon Reload X-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Entry Height:|Primary Weapon Entry Height:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Entry Height:|Secondary Weapon Entry Height:]] (Optional)

====+Objective notify:====
Adds a Objective notifier gauge. This gauge alerts the player when receiving a new objective, or when an objective has been completed or failed. Additionally, this gauge alerts the player when entering subspace, and when a Red Alert mission orders are being received (prior to a forced subspace jump).

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Objective Text Y-offset:|Objective Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Objective Value Y-offset:|Objective Value Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Subspace Text Y-offset:|Subspace Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Subspace Value Y-offset:|Subspace Value Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Red Alert Text Y-offset:|Red Alert Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Red Alert Value Y-offset:|Red Alert Value Y-offset:]] (Optional)

====+Squad Message====
Adds the squad message gauge. In FS1 and FS2, this gauge is used to send commands to your squad. (?)

*Valid sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#List Start Offsets:|List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Background Height:|Top Background Height:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Bottom Background Offset|Bottom Background Offset]] (Optional)}}
:[[Hud_gauges.tbl#Command X-offset:|Command X-offset:]] (Optional)
:[[Hud_gauges.tbl#Page Up Offsets:|Page Up Offsets:]] (Optional)
:[[Hud_gauges.tbl#Page Down Offsets:|Page Down Offsets:]] (Optional)

====+Lag:====
Adds a Lag gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]

====+Mini Target Shields:====
Adds a mini Target shields gauge. In FS1 and FS2, the Mini Target Shield gauge is the one right below the center reticle, and shows the hull damage in %

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (animation needs 8 frames; 0->3 are the top, right, bottom & left shield quads; 4->7 are the same except brighter for when the quad is flashing from being hit)
:[[Hud_gauges.tbl#3 Digit Hull Offsets:|3 Digit Hull Offsets:]] (Optional)
:[[Hud_gauges.tbl#2 Digit Hull Offsets:|2 Digit Hull Offsets:]] (Optional)
:[[Hud_gauges.tbl#1 Digit Hull Offsets:|1 Digit Hull Offsets:]] (Optional)

====+Player Shields:====
Adds a gauge that shows the shield and hull status icon of the player's craft or ship.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)

====+Target Shields:====
Adds a gauge that shows the shield and hull status icon of the targeted craft or ship.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)

====+Escort View:====
Adds an escort monitor/view gauge. This gauge monitors the status of all ships assigned to the player to escort.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height]] (Optional)
:[[Hud_gauges.tbl#Entry Stagger Width:|Entry Stagger Width:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Bottom Background Offset:|Bottom Background Offset:]] (Optional)}}
:[[Hud_gauges.tbl#Header Text:|Header Text]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#List Start Offsets:|List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Hull X-offset:|Hull X-offset]] (Optional)
:[[Hud_gauges.tbl#Name X-offset:|Name X-offset]] (Optional)
:[[Hud_gauges.tbl#Status X-offset:|Status X-offset]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Ship Name Max Width:|Ship Name Max Width:]] (Optional)}}
{{table373|
:[[Hud_gauges.tbl#Right-Align Ship Names:|Right-Align Ship Names:]] (Optional)}}

====+Mission Time:====
Adds a gauge that displays the current mission time.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
:[[Hud_gauges.tbl#Value Offsets:|Value Offsets:]] (Optional)

====+ETS Retail:====
{{Table3613|
Draws the three other ETS gauges as a single gauge. Will automatically rearrange itself (like retail) if shields or other systems are missing.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
{{Table3613|
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)
:[[Hud_gauges.tbl#Gauge Offset:|Gauge Offset:]] (Optional)

}}

====+ETS Weapons:====
Adds a gauge that displays the energy transfer rate for the energy weapons.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)

====+ETS Engines:====
Adds a gauge that displays the energy transfer rate for the afterburner/engines.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)

====+ETS Shields:====
Adds a gauge that displays the energy transfer rate for the shields.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)

====+Target Monitor:====
Adds a target monitor gauge that shows the targeted ship's relative orientation and hull strength, among other things.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Monitor Filename:|Monitor Filename:]] (Optional) (needs animation with 2 frames, 1st is the background for the target, 2nd is the border; rendered last)
{{table3615|
:[[Hud_gauges.tbl#Monitor Alpha Mask Filename:|Monitor Alpha Mask Filename:]] (Optional) (needs animation with a single frame)}}
:[[Hud_gauges.tbl#Integrity Bar Filename:|Integrity Bar Filename:]] (Optional) (needs animation with 2 frames, 1st is a zero/dark filled bar, 2nd is a max/bright filled bar)
:[[Hud_gauges.tbl#Viewport Offsets:|Viewport Offsets:]] (Optional)
:[[Hud_gauges.tbl#Viewport Size:|Viewport Size:]] (Optional)
:[[Hud_gauges.tbl#Integrity Bar Offsets:|Integrity Bar Offsets:]] (Optional)
:[[Hud_gauges.tbl#Integrity Bar Foreground Clip Height:|Integrity Bar Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Status Offsets:|Status Offsets:]] (Optional)
:[[Hud_gauges.tbl#Name Offsets:|Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Class Offsets:|Class Offsets:]] (Optional)
:[[Hud_gauges.tbl#Distance Offsets:|Distance Offsets:]] (Optional)
:[[Hud_gauges.tbl#Speed Offsets:|Speed Offsets:]] (Optional)
:[[Hud_gauges.tbl#Hull Offsets:|Hull Offsets:]] (Optional)
:[[Hud_gauges.tbl#Cargo Contents Offsets:|Cargo Contents Offsets:]] (Optional)
:[[Hud_gauges.tbl#Cargo Scan Start Offsets:|Cargo Scan Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Cargo Scan Size:|Cargo Scan Size:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Subsystem Name Offsets:|Subsystem Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Subsystem Integrity Offsets:|Subsystem Integrity Offsets:]] (Optional)
:[[Hud_gauges.tbl#Disabled Status Offsets:|Disabled Status Offsets:]] (Optional)
:[[Hud_gauges.tbl#Desaturate:|Desaturate:]] (Optional)
}}

====+Extra Target Data:====
Adds a gauge that displays "extra" target data, such as its current orders and docking status.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs an animation with 1 frame)
:[[Hud_gauges.tbl#Bracket Offsets:|Bracket Offsets:]] (Optional)
:[[Hud_gauges.tbl#Dock Offsets:|Dock Offsets:]] (Optional)
{{table373|
:[[Hud_gauges.tbl#Dock Max Width:|Dock Max Width:]] (Optional)}}
:[[Hud_gauges.tbl#Order Offsets:|Order Offsets:]] (Optional)
{{table373|
:[[Hud_gauges.tbl#Order Max Width:|Order Max Width:]] (Optional)}}
:[[Hud_gauges.tbl#Time Offsets:|Time Offsets:]] (Optional)

====+Radar:====
Adds a standard radar gauge

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs animation with 2 frames, only the 2nd frame is used)
{{table373|
:[[Hud_gauges.tbl#Radar Center Offsets:|Radar Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Radar Size:|Radar Size:]] (Optional)
}}
:[[Hud_gauges.tbl#Infinity Distance Offsets:|Infinity Distance Offsets]] (Optional)
:[[Hud_gauges.tbl#Long Distance Offsets:|Long Distance Offsets:]] (Optional)
:[[Hud_gauges.tbl#Short Distance Offsets:|Short Distance Offsets:]] (Optional)

====+Radar Orb:====
Adds a 3D orb radar gauge

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs animation with 2 frames, only the 2nd frame is used)
{{table373|
:[[Hud_gauges.tbl#Radar Center Offsets:|Radar Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Radar Size:|Radar Size:]] (Optional)
}}
:[[Hud_gauges.tbl#Infinity Distance Offsets:|Infinity Distance Offsets]] (Optional)
:[[Hud_gauges.tbl#Long Distance Offsets:|Long Distance Offsets:]] (Optional)
:[[Hud_gauges.tbl#Short Distance Offsets:|Short Distance Offsets:]] (Optional)

====+Radar BSG:====
Adds a BSG style radar (a.k.a DRADIS).

:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Size:|Size:]] (Optional)
:[[Hud_gauges.tbl#XY Disc Filename:|XY Disc Filename:]] (Optional)
:[[Hud_gauges.tbl#XZ YZ Disc Filename:|XZ YZ Disc Filename:]] (Optional)
:[[Hud_gauges.tbl#Sweep Disc Filename:|Sweep Disc Filename:]] (Optional)
:[[Hud_gauges.tbl#Default Contact Filename:|Default Contact Filename:]] (Optional)
:[[Hud_gauges.tbl#Unknown Contact Filename:|Unknown Contact Filename:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]]
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]]
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Loop Volume:|Loop Volume:]] (Optional)
:[[Hud_gauges.tbl#Minimum Beep Delay:|Minimum Beep Delay]] (Optional)

====+Afterburner Energy:====
Adds a gauge that shows the remaining afterburner energy. Note that it only supports a vertical fill.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs animation with 2 frames, the 1st is the bar lit for zero energy, the 2nd is the bar lit for max energy)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)

====+Weapon Energy:====
Adds a gauge that shows the remaining weapon energy. Note that it only supports a vertical fill.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs an animation with 4 frames, the 3rd is the bar lit for zero energy, the 2nd is the bar lit for max energy, frames 1 & 2 are not used)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Text Alignment:|Text Alignment:]] (Optional)
:[[Hud_gauges.tbl#Always Show Text:|Always Show Text:]] (Optional)
:[[Hud_gauges.tbl#Text Follows:|Text Follows:]] (Optional)
:[[Hud_gauges.tbl#Show Ballistic Ammo:|Show Ballistic Ammo:]] (Optional)
:[[Hud_gauges.tbl#Armed Guns List Offsets:|Armed Guns List Offsets:]] (Optional)
:[[Hud_gauges.tbl#Armed Guns List Alignment:|Armed Guns List Alignment:]] (Optional)
:[[Hud_gauges.tbl#Armed Guns List Entry Height:|Armed Guns List Entry Height:]] (Optional)
}}

====+Text Warnings:====
Adds a gauge that warns the player (current warnings are EMP, Launch, Evaded, Collision, Blast & Engine Wash).

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)

====+Center Reticle:====
Adds a "custom" center reticle.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Firepoint display:|Firepoint display:]] (Optional)
:[[Hud_gauges.tbl#Firepoint size:|Firepoint size:]] (Optional)
:[[Hud_gauges.tbl#Firepoint X coordinate multiplier:|Firepoint X coordinate multiplier:]] (Optional)
:[[Hud_gauges.tbl#Firepoint Y coordinate multiplier:|Firepoint Y coordinate multiplier:]] (Optional)

====+Throttle:====
Adds a gauge that shows the current throttle position.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Bottom Y-offset:|Foreground Clip Bottom Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Width:|Foreground Clip Width:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Afterburner Clip Height:|Afterburner Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Show Background:|Show Background:]] (Optional)
:[[Hud_gauges.tbl#Max Speed Label Offsets:|Max Speed Label Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Show Max Speed Label:|Show Max Speed Label:]] (Optional)}}
:[[Hud_gauges.tbl#Min Speed Label Offsets:|Min Speed Label Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Show Min Speed Label:|Show Min Speed Label:]] (Optional)}}
:[[Hud_gauges.tbl#Orbit Center Offsets:|Orbit Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Orbit Radius:|Orbit Radius:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Current Speed Offsets:|Current Speed Offsets:]] (Optional)
:[[Hud_gauges.tbl#Target Speed Offsets:|Target Speed Offsets:]] (Optional)
:[[Hud_gauges.tbl#Show Percentage:|Show Percentage:]] (Optional)
:[[Hud_gauges.tbl#Glide Status Offsets:|Glide Status Offsets:]] (Optional)
:[[Hud_gauges.tbl#Match Speed Status Offsets:|Match Speed Status Offsets:]] (Optional)
}}

====+Threat Indicator:====
Adds a gauge that indicates when a lock-on has been achieved by an attacker, and if the player is being shot at.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Arc Filename:|Arc Filename:]] (Optional)
:[[Hud_gauges.tbl#Dumbfire Filename:|Dumbfire Filename:]] (Optional)
:[[Hud_gauges.tbl#Lock Filename:|Lock Filename:]] (Optional)
:[[Hud_gauges.tbl#Dumbfire Offsets:|Dumbfire Offsets:]] (Optional)
:[[Hud_gauges.tbl#Lock Offsets:|Lock Offsets:]] (Optional)

====+Multiplayer Messages:====
Adds a gauge that displays the multiplayer messages.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}

====+Voice Status:====
Adds a gauge that displays the voice status.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}

====+Ping:====
Adds a gauge that the ping time to the multiplayer server.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}

====+Supernova:====
Adds a gauge that warns the player of an impending supernova shock wave.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}

====+Lock Indicator:====
Adds a Lock Indicator gauge.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Lock Filename:|Lock Filename:]] (Optional)
:[[Hud_gauges.tbl#Locked Filename:|Locked Filename:]] (Optional)
:[[Hud_gauges.tbl#Lock Center Offsets:|Lock Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Locked Center Offsets:|Locked Center Offsets:]] (Optional)

====+Offscreen Indicator:====
Adds an Offscreen Indicator.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}

====+Target Brackets:====
Adds a Target Bracket gauge. This is drawn around current target(s) and talkers.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Dot Filename:|Dot Filename:]] (Optional)

====+Hostile Triangle:====
Adds a gauge that points to the nearest attacker, if it is off-screen and is not currently targeted.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)
:[[Hud_gauges.tbl#Triangle Base:|Triangle Base:]] (Optional)
:[[Hud_gauges.tbl#Triangle Height:|Triangle Height:]] (Optional)

====+Target Triangle:====
Adds a gauge that points to the targeted craft, if it is currently off-screen.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)
:[[Hud_gauges.tbl#Triangle Base:|Triangle Base:]] (Optional)
:[[Hud_gauges.tbl#Triangle Height:|Triangle Height:]] (Optional)

====+Missile Triangles:====
Adds a gauge that is used during attempting to lock onto a target when using an aspect seeking missile.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)
:[[Hud_gauges.tbl#Triangle Base:|Triangle Base:]] (Optional)
:[[Hud_gauges.tbl#Triangle Height:|Triangle Height:]] (Optional)

====+Lead Indicator:====
Adds a gauge that leads (is in front) of the target. Aim your crosshairs at this indicator to increase probability of hitting the target.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
::Frame #0: Secondaries lead indicator (Dumbfire)
::Frame #1: Secondaries lead indicator (Homing)
::Frame #2: Primaries lead indicator
:[[Hud_gauges.tbl#Center Offsets:|Center Offsets:]] (Optional)

====+Orientation Tee:====
Adds a gauge that indicates the targeted craft's orientation in relation to the player's craft.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)

====+Lead Sight:====
Adds a gauge that lags (is behind) the target. Indicates where your shots will end up relative to the target's position. To score a hit, this gauge should be over the target. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
::Frame #0 is used for secondaries
::* If only one frame is found in the file, then it is used for primaries instead
::Frame #1 is used for primaries

====+Kills:====
Adds a gauge that keeps track of how many kills the player has scored during a mission.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
:[[Hud_gauges.tbl#Value Offsets:|Value Offsets:]] (Optional)

====+Weapon Linking:====
Adds a gauge that indicates the selected weapons and their firing rates.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Arc Filename:|Arc Filename:]] (Optional)
:[[Hud_gauges.tbl#Single Primary Filename:|Single Primary Filename:]] (Optional)
:[[Hud_gauges.tbl#Double Primary Filename:|Double Primary Filename:]] (Optional)
:[[Hud_gauges.tbl#Single Secondary Filename:|Single Secondary Filename:]] (Optional)
:[[Hud_gauges.tbl#Double Secondary Filename:|Double Secondary Filename:]] (Optional)
:[[Hud_gauges.tbl#Triple Secondary Filename:|Triple Secondary Filename:]] (Optional)
:[[Hud_gauges.tbl#Single Primary Offsets:|Single Primary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Double Primary Offsets:|Double Primary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Single Secondary Offsets:|Single Secondary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Double Secondary Offsets:|Double Secondary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Triple Secondary Offsets:|Triple Secondary Offsets:]] (Optional)

====+Fixed Messages:====

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table375|
:[[Hud_gauges.tbl#Center Text On Gauge X-Position:|Center Text On Gauge X-Position:]] (Optional)
}}

====+Flight Path Marker:====
{{table3615|
Adds a gauge that indicates the direction where your ship is traveling. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Center Offsets:|Center Offsets:]] (Optional)}}

====+Warhead Count:====
{{table3615|
Displays the name of the current secondary weapon. Tallies the ammo left. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs an animation with a single frame)
:[[Hud_gauges.tbl#Name Offsets:|Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Count Offsets:|Count Offsets:]] (Optional)
:[[Hud_gauges.tbl#Icon Width:|Icon Width:]] (Optional)
:[[Hud_gauges.tbl#Icon Height:|Icon Height:]] (Optional)
:[[Hud_gauges.tbl#Max Icons:|Max Icons:]] (Optional)
:[[Hud_gauges.tbl#Max Columns:|Max Columns:]] (Optional)
:[[Hud_gauges.tbl#Name Alignment:|Name Alignment:]] (Optional)
}}

====+Hardpoints:====
{{table3615|
Draws a silhouette of the player's ship and mounted weapons. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Size:|Size:]] (Optional)
:[[Hud_gauges.tbl#Line Width:|Line Width:]] (Optional)
:[[Hud_gauges.tbl#View Direction:|View Direction:]] (Optional)
:[[Hud_gauges.tbl#Show Primary Weapons:|Show Primary Weapons:]] (Optional)
:[[Hud_gauges.tbl#Show Secondary Weapons:|Show Secondary Weapons:]] (Optional)
}}

====+Primary Weapons:====
{{table3615|
Like the Weapons gauge but simpler. Only displays primary weapons. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Header Text:|Header Text:]] (Optional)
:[[Hud_gauges.tbl#First Background Filename:|First Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#First Background Height:|First Background Height:]] (Optional)
:[[Hud_gauges.tbl#First Background X-offset:|First Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Entry Background Height:|Entry Background Height:]] (Optional)
:[[Hud_gauges.tbl#Entry Background X-offset:|Entry Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Filename:|Last Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Last Background X-offset:|Last Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Y-offset:|Last Background Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
:[[Hud_gauges.tbl#List Start Y-offset:|List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Ammo X-offset:|Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Link X-offset:|Link X-offset:]] (Optional)
:[[Hud_gauges.tbl#Name X-offset:|Name X-offset:]] (Optional)
}}

====+Secondary Weapons:====
{{table3615|
Like the Weapons gauge but simpler. Only displays secondary weapons. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Header Text:|Header Text:]] (Optional)
:[[Hud_gauges.tbl#First Background Filename:|First Background Filename:]] (Optional)
:[[Hud_gauges.tbl#First Background Height:|First Background Height:]] (Optional)
:[[Hud_gauges.tbl#First Background X-offset:|First Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Height:|Entry Background Height:]] (Optional)
:[[Hud_gauges.tbl#Entry Background X-offset:|Entry Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Filename:|Last Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Last Background X-offset:|Last Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Y-offset:|Last Background Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
:[[Hud_gauges.tbl#List Start Y-offset:|List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Ammo X-offset:|Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Link X-offset:|Link X-offset:]] (Optional)
:[[Hud_gauges.tbl#Name X-offset:|Name X-offset:]] (Optional)
:[[Hud_gauges.tbl#Unlink X-offset:|Unlink X-offset:]] (Optional)
:[[Hud_gauges.tbl#Reload X-offset:|Reload X-offset:]] (Optional)
}}

===$End Gauges===
The Gauges section must end with $End Gauges. No Exceptions.

==#End==
The very last entry in the Hud_gauges.tbl must be #End. No Exceptions.

----
----

==Gauge Configuration Options==
Since a vast majority of gauges share the same entries, the configuration options for each gauge have been grouped here for formatting consistency.

====Position:====
Defines the screen coordinates for the upper left corner of this gauge.

*Syntax: '''Integer''' horizontal pixel, '''Integer''' vertical pixel position

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Training Messages:|+Training Messages:]], [[Hud_gauges.tbl#+Support:|+Support]] (and many others)

====Scale Gauge:====

{{table371|
Define if a gauge size will scale or not.

If false then gauge bitmaps will always show at their original size which may result in gauges being very small at high resolutions.

If true then gauge bitmaps will scale in proportion to the current resolution vs the base HUD resolution in use. This may result in gauges becoming blurry at non-base resolutions.

Defaults to yes/true.

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: '''Boolean''' scale_this_gauge

Used by: most gauges
}}

====Force Scaling Above:====

{{Table373|
Optional. If scaling is disabled for this gauge, then it will be scaled as though the base resolution were this resolution or the real base resolution, whichever is greater.

Use this to disable scaling at lower resolutions while preventing gauges from getting too small at higher resolutions.

To disable this feature, use '''(-1, -1)'''.

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: ('''Integer''' width, '''Integer''' height)

Used by: most gauges
}}

====Origin:====

{{table371|
Define gauge position as a ratio of the screen size (base or current, it doesn't matter).

Requires [[Hud_gauges.tbl#Offset:|Offset:]]

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: '''Float''' horizontal ratio 0.0 - 1.0, '''Float''' vertical ratio 0.0 - 1.0

Used by: most gauges
}}

====Offset:====

{{table371|
Define gauge offset from [[Hud_gauges.tbl#Origin:|Origin:]] in base resolution pixels

Requires [[Hud_gauges.tbl#Origin:|Origin:]]

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: '''Integer''' horizontal pixel offset from Origin:, '''Integer''' vertical pixel offset from Origin:

Used by: most gauges
}}

====Cockpit Target:====
The cockpit display that this gauge will be rendered to. Refers to the +Display Name: defined in [[ships.tbl#$Cockpit Display:|$Cockpit Display:]].

*Syntax: '''String''' String defined in +Display Name: in [[ships.tbl#$Cockpit Display:|$Cockpit Display:]]

=====Canvas Size:=====
The off-screen canvas this gauge will be rendered to before being interpolated into the actual cockpit display. The smaller this number is, the larger the gauge will appear on the cockpit display.

*Syntax: '''Integer''' width, '''Integer''' height

=====Display Offset:=====
The position of the canvas on the cockpit display texture

*Syntax: '''Integer''' width, '''Integer''' height

=====Display Size:=====
The interpolated size on the cockpit display texture that the canvas will be rendered to.

*Syntax: '''Integer''' width, '''Integer''' height

====Color:====
Optional. Overrides both previous color settings ([[Hud_gauges.tbl#$Color: 1|$Color]] HUD option and [[Hud_gauges#$Color: 2|$Color]] ship class option) for this particular gauge.

*Syntax: See [[Hud_gauges.tbl#$Color: 1|$Color:]]

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Font:====
Optional. Overrides both previous font settings ([[Hud_gauges.tbl#$Font: 1|$Font]] HUD option and [[Hud_gauges#$Font: 2|$Font]] ship class option) for this particular gauge.

*Syntax: See [[Hud_gauges.tbl#$Font: 1|$Font:]]

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Training Messages:|+Training Messages:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Name:====
Defines the name of this custom gauge.

*Syntax: '''String'''
*Max Length: 32 characters

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Text:====
Default text to be displayed. Can be altered using the hud-set-message, hud-set-text and hud-set-directive sexps.

*Syntax: '''String'''
*Max Length: 32 characters

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====X Offset:====
Optional. Defines the horizontal pixel offset (from the gauge's origin as defined by [[Hud_gauges.tbl#Position:|Position:]]) that the Text will be displayed.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Y Offset:====
Optional. Defines the vertical pixel offset (from the gauge's origin defined by [[Hud_gauges.tbl#Position:|Position:]]) that the Text will be displayed.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Gauge Type:====
Defines the type of gauge this is.

*Syntax: '''String'''
*Valid Values: Any one of the possible [[gauge types]].

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Slew:====
Optional. Determines whether or not this gauge is affected by afterburner shaking or similar effects. If set to "true", the gauge will not follow the player's head movements when using TrackIR/padlock. i.e. should be used for gauges like the gunsight/leadsight.

*Syntax: '''Boolean'''

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Max Lines:====
Optional. Specifies the maximum number of message lines that are displayed.

*Syntax: '''Integer'''
*Default Value: 3

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Max Width:====
Optional. Determines how long each message line may be.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Line Height:====
Optional. Determines the distance between line origins. (i.g. for a 12pt Font, there are needs to be at least 12 pixels between the bottom of one line and the next, otherwise the text will overlap each)

*Syntax: '''Integer'''
*Units: Pixels
*Default Value: 9

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Total Lifetime:====
Optional. Determines the maximum time the message gauge will be displayed from the time a new message is received.

*Syntax: '''Integer'''
*Units: milliseconds
*Default Value: 14000 (14 seconds)

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Scroll Time:====
Optional. Determines the time for the messages to scroll up one step.( See [[Hud_gauges.tbl#Step Size:|Step Size:]] )

*Syntax: '''Integer'''
*Units: milliseconds
*Default Value: 30

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Step Size:====
Optional. Determines how many pixels to shift message lines during scrolling. Messages will be shifted up by this amount until they are on the next line (as defined by [[Hud_gauges.tbl#Line Height:|Line Height:]])

*Syntax: '''Integer'''
*Units: Pixels
*Default Value: 3

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Active by default:====
Optional. Determines whether or not this gauge is always active, or only available after being activated via sexp.

*Syntax: '''Boolean'''

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Filename:====
Designates the [[Multimedia_Files#ANI|.ANI]] or [[Multimedia_Files#EFF|.EFF]] used for this gauge's background graphic.
{{Note| All HUD .ANI's must have the same color palette as the retail .ANI's in order to render properly. (.EFF's do not have this restriction)}}

*Syntax: '''Filename'''
**No filename extension is needed.

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Top Background Filename:====
Optional. Designates which file to use for the top background. (?)

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Damage|+Damage]]

====Bottom Background Filename:====
Optional. Designates which file to use for the Bottom background (?)

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Damage|+Damage]]

====Left Background Filename:====
Optional. Designates which file to use for the Left side of gauge.

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====First Background Filename:====
Optional. Alias for [[Hud_gauges.tbl#Left Background Filename:|Left Background Filename:]]

====Right Background Filename:====
Optional. Designates which file to use for the Right side of the gauge.

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Last Background Filename:====
Optional. Alias for [[Hud_gauges.tbl#Right Background Filename:|Right Background Filename:]]

====Entry Background Filename:====
Optional. Designates which file to use for the (Wing) Entry section of the gauge (aka the middle sections).

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Damage|+Damage]], [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Primary List Top Background Filename:====
Optional. Designates which file to use for the Primary List Top Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary List Middle Background Filename:====
Optional. Designates which file to use for the Primary List Middle Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary List Bottom Background Filename:====
Optional. Designates which file to use for the Primary List Bottom Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Top Background Filename:====
Optional. Designates which file to use for the Secondary List Top Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Entry Background Filename:====
Optional. Designates which file to use for the Secondary List Entry Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Bottom Background Filename:====
Optional. Designates which file to use for the Secondary List Bottom Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Alt Ballistic Filename:====
Optional. Designates an alternate file to be used for ballistic weapons.

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#Primary List Top Background Filename:|Primary List Top Background Filename]], [[Hud_gauges.tbl#Primary List Middle Background Filename:|Primary List Middle Background Filename]], [[Hud_gauges.tbl#Primary List Bottom Background Filename:|Primary List Bottom Background Filename]], [[Hud_gauges.tbl#Secondary List Top Background Filename:|Secondary List Top Background Filename]], [[Hud_gauges.tbl#Secondary List Entry Background Filename:|Secondary List Entry Background Filename]], [[Hud_gauges.tbl#Secondary List Bottom Background Filename:|Secondary List Bottom Background Filename]]

====Dot Filename:====
Optional. Designates which file to use for the wingman graphic (a.k.a. the Dot)

*Syntax: '''Filename'''

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Header Offsets:====
Optional. Designates the offset from the gauge's upper left corner for headers of various gauges

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels
*Valid Sub-entries:
:Weapons:
::[[Hud_gauges.tbl#Alt Ballistic Offsets:|Alt Ballistic Offsets:]]

Used by: [[Hud_gauges.tbl#+Support:|+Support:]], [[Hud_gauges.tbl#+Damage|+Damage:]], [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Fixed Header Position:====
Optional. If set, the header text will not change position when the gauge changes size.

*Syntax: '''Boolean'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Text Y-offset:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship Text. (?)

*Syntax: '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]]

====Text Offsets:====
Optional. Defines the screen position offsets for the text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: :[[Hud_gauges.tbl#+Countermeasures:|+Countermeasures:]]

====Value Offsets:====
Optional. Defines the screen position offsets for the value label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: :[[Hud_gauges.tbl#+Countermeasures:|+Countermeasures:]]

====Dock Status X-offset:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship's dock status. (?)

*Syntax: '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]]

====Dock Time X-offset:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship's dock time. (?)

*Syntax: '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]]

====Hull Integrity Offsets:====
Optional. Designates the offsets from the gauge's upper left corner for the for the Damage gauge Hull integrity textbox(?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Hull Integrity Value X-offset:====
Optional. Designates the offsets from the hull integrity textbox's upper left corner for the hull integrity value. (?)

*Syntax: '''Integer''' horizontal offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Top Background Height:====
Optional. Designates the height of the Top background (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Left Background Width:====
Optional. Defines the width of the Left Background.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Entry Width:====
Optional. Defines the width of the Entry Background (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Subsystem Entry Height:====
Optional. Designates the height of the Subsystem entry (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Subsystem List Start Offsets:====
Optional. Designates the offsets from the gauge's upper left corner for the for the start of the Subsytem List (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Subsystem Entry Value X-offset:====
Optional. Designates the horizontal offset from the Subsystem List's position (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Single Wing Offsets:====
Optional. Designates the offset from the gauge's upper left corner for a single wing (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Multiple Wing Start Offsets:====
Optional. Designates the offset from the gauge's upper left corner for multiple wings (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Wing Name Offsets:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship header (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Dot Offsets:====
Optional. Designates the offset from the gauge's upper left corner for the All wingman status icons.
*Syntax:
:'''Integer''' x, '''Integer''' y ;; Wingman 1
:'''Integer''' x, '''Integer''' y ;; Wingman 2
:'''Integer''' x, '''Integer''' y ;; Wingman 3
:'''Integer''' x, '''Integer''' y ;; Wingman 4
:'''Integer''' x, '''Integer''' y ;; Wingman 5
:'''Integer''' x, '''Integer''' y ;; Wingman 6
*Units: Pixels

{{Warning|
All 6 wingman positions must be defined}}

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Expansion Mode:====
Optional. Denotes which direction (in relation to the player's wing) that the other wings should be appended to the gauge

*Syntax: '''String'''
*Valid Values:
:*Right ;; Wings are added to the right of the previous wing

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Auto Offsets:====
Optional. Defines the screen coordinates for the "Auto" text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Auto Speed:|+Auto Speed:]], [[Hud_gagues.tbl#+Auto Target:|+Auto Target:]]

====Speed Offsets:====
Optional. Defines the screen coordinates for the "Speed" text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Auto Speed:|+Auto Speed:]]

====Target Offsets:====
Optional. Defines the screen coordinates for the "Target" text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Auto Target:|+Auto Target:]]

====Animation Offsets:====
Optional. Defines the offsets for the animation graphics.

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Talking Head:|+Talking Head:]]

====Animation Background Size:====
Deprecated. Originally, this set the size of the black box that's drawn behind the animation. Since Git revision 556e9a4 (2015-11-01), it has the same effect as [[Hud_gauges.tbl#Animation Size:|Animation Size:]].

*Syntax: '''Integer''' horizontal size, '''Integer''' vertical size
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Talking Head:|+Talking Head:]]

====Animation Size:====
{{table373|
Optional. Defines the size of the animation. All animations will be scaled to match this size.

*Syntax: '''Integer''' horizontal size, '''Integer''' vertical size
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Talking Head:|+Talking Head:]]
}}

====List Start Offsets:====
Optional. Defines the screen coordinate offsets for the start of the Directives list.

*Syntax: '''Integer''' x, '''Integer''' y
*Units: Pixels

Used by: [[Hud_guages.tbl#+Directives:|+Directives:]]

====Entry Height:====
Optional. Defines the height of each Directive

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_guages.tbl#+Directives:|+Directives:]]

====Alt Ballistic Offsets:====
Opetional. Defines the screen coordinate offsets for headers of ballistic weapons

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Header Offset:|+Header Offset:]]

====Top Primary Background X-offset:====
Optional. Defines the screen coordinate offset for the Top Primary Background

*Syntax: '''Integer'''
*Units: Pixels
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic X-offset:|Alt Ballistic X-offset:]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Text X-offset:====
(Optional) Defines the screen coordinate X-offset for weapon labels

*Syntax: '''Integer'''
*Units: Pixels
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic X-offset:|Alt Ballistic X-offset:]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Alt Ballistic X-offset:====
Optional. Defines the screen coordinate X-offset for ballistic weapons

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#Top Primary Background X-offset:|Top Primary Background X-offset:]], [[Hud_gauges.tbl#Text X-offset:|Text X-offset:]]

====Top Primary Frame Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Top Secondary Frame Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary List Start Y-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Start Y-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Ammo X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Link X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Name X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Ammo X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Linked X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Name X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Reload X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Entry Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Entry Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====3 Digit Hull Offsets:====
Designates the screen position offsets for the hull damage % when it is the 3 digit range (i.e. >= 100%)

*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Mini Target Shields:|+Mini Target Shields:]]

====2 Digit Hull Offsets:====
Designates the screen position offsets for the hull damage % when it is the 2 digit range (i.e. 100% > hull damage% >= 10%)

*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Mini Target Shields:|+Mini Target Shields:]]

====1 Digit Hull Offsets:====
Designates the screen position offsets for the hull damage % when it is the 1 digit range (i.e. 10% > hull damage% >= 0%)

*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Mini Target Shields:|+Mini Target Shields:]]

====Objective Text Y-offset:====
Designates the screen position offset for the Objective label

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Objective Value Y-offset====
Designates the screen position offset for the Objective value

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Subspace Text Y-offset:====
Designates the screen position offset for the Subspace label

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Subspace Value Y-offset====
Designates the screen position offset for the Subspace value (?)

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Red Alert Text Y-offset====
Designates the screen position offset for the Red Alert label

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Red Alert Value Y-offset====
Designates the screen position offset for the Red Alert value (?)

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Command X-offset:====
*Syntax: '''Integer''' x offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Squad Message:|+Squad Message:]]

====Page Up Offsets:====
*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Squad Message:|+Squad Message:]]

====Page Down Offsets:====
*Syntax: '''Integer''' x offset, ''' Integer y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Squad Message:|+Squad Message:]]

====Entry Height:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Entry Stagger Width:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Header Text:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Header Offsets:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====List Start Offsets:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Hull X-offset:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Name X-offset:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Status X-offset:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Ship Name Max Width:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Right-Align Ship Names:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Foreground Clip Height:====

* Sets the height, in pixels, of the gauge.
** For the [[Hud_gauges.tbl#+Throttle|Throttle]], sets the height of the gauge that represents 0% to 100% throttle. The total height of the gauge is the sum of this value and the [[Hud_gauges.tbl#Afterburner Clip Height:|Afterburner Clip Height]] value.
* Syntax: '''Integer'''

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]], [[Hud_gauges.tbl#+ETS Weapons:|+ETS Weapons]], [[Hud_gauges.tbl#+ETS Engines:|+ETS Engines]], [[Hud_gauges.tbl#+ETS Shields:|+ETS Shields]], [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor]], [[Hud_gauges.tbl#+Afterburner Energy|+Afterburner Energy]], [[Hud_gauges.tbl#+Weapon Energy|+Weapon Energy]], [[Hud_gauges.tbl#+Throttle:|+Throttle]]

====Letter Offsets:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Top Offsets:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Bottom Offsets:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Gauge Offset:====
*Distance between the individual weapon/shield/engine ETS gauges that comprise this gauge
*Syntax: '''Integer'''

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Monitor Filename:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Integrity Bar Filename:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Viewport Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Viewport Size:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Integrity Bar Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Integrity Bar Foreground Clip Height:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Status Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Name Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Class Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Speed Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Hull Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Cargo Contents Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Cargo Scan Start Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Cargo Scan Size:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Bracket Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Dock Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Dock Max Width:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Order Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Order Max Width:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Time Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Radar Center Offsets:====
Defines the radar's plot origin as an offset, in pixels, from this gauge's [[Hud_gauges.tbl#Position|Position]] coordinates
*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

====Radar Size:====
Size, in pixels, of the radar plot area.

Syntax: '''Integer''' horizontal size, '''Integer''' vertical size

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

====Infinity Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

Offset to draw the infinity radar range symbol.

====Long Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

Offset to draw the long range radar text (i.e. 10k).

====Short Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

Offset to draw the short range radar text (i.e. 2k).

====Size:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====XY Disc Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====XZ YZ Disc Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Sweep Disc Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Default Contact Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Unknown Contact Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Loop Volume:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG]]

====Minimum Beep Delay:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG]]

====Firepoint display:====
Displays the positions of the gun firepoints on your ship
*Syntax: '''Boolean''', YES or NO

NOTE: The position of the firepoints is calculated from the Eye Point position in the POF. You may encounter weird results if you have no Eye Point defined, but no debug warnings will be raised.

Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Firepoint size:====
Diameter of the gunpoint circles. '''Must be 4 or greater''' in order to work properly.
*Syntax: '''Integer'''

Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Firepoint X coordinate multiplier:====
Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Firepoint Y coordinate multiplier:====
Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Foreground Clip Bottom Y-offset:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Foreground Clip Width:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Afterburner Clip Height:====
* Sets the area of the throttle gauge that represents the Afterburner segment (which is on top of the 0% to 100% area). The total height of the gauge is determined by the sum of this value and [[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]]

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Show Background:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Max Speed Label Offsets:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Min Speed Label Offsets:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Orbit Center Offsets:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Orbit Radius:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Arc Filename:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Needs to be an [[Multimedia_Files#ANI|ani]] with a least 2 frames (but only the 2nd frame is used ?!?!? for threat & weapon linking so far)

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Dumbfire Filename:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Needs to be an [[Multimedia_Files#ANI|ani]] with a least 2 frames. The 1st frame is "no warning", the rest of the frames are cycled through when a warning is active.

Internally FSO also refers to this as the "laser threat warning".

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Lock Filename:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Needs to be an [[Multimedia_Files#ANI|ani]] with a least 2 frames. The 1st frame is "no warning", the rest of the frames are cycled through when a warning is active. Frames cycle twice as fast when a lock has been acquired, compared to when a lock is being acquired.

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Dumbfire Offsets:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Lock Offsets:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Lock Filename:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Locked Filename:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Lock Center Offsets:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Locked Center Offsets:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Radius:====
Defines the distance from the center of the screen to the base of the Hostile Triangle gauge.

*Syntax: '''Integer'''
*Default value:
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Hostile Triangle:|+Hostile Triangle:]]

====Triangle Base:====
Defines the width of the Hostile Triangle's base.

*Syntax: '''Float'''
*Default value:
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Hostile Triangle:|+Hostile Triangle:]]

====Triangle Height:====
Defines the height of the Hostile Triangle.

*Syntax: '''Float'''
Default value:
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Hostile Triangle:|+Hostile Triangle:]]

====Center Offsets:====

Used by: [[Hud_gauges.tbl#+Lead Indicator:|+Lead Indicator:]]

====Single Primary Filename:====
Designates the file to use for primary linking for ships with a single primary bank.

Needs to be an [[Multimedia_Files#ANI|ani]] with 2 frames; 1st is bank 1 not selected (not that this should ever be able to happen), 2nd is bank 1 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Primary Filename:====

Designates the file to use for primary linking for ships with two primary banks.

Needs to be an [[Multimedia_Files#ANI|ani]] with 4 frames:
* Frame 0 is no banks selected
* Frame 1 is 1st bank selected
* Frame 2 is 2nd bank selected
* Frame 3 is both banks selected/linked

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Single Secondary Filename:====

Designates the file to use for selected secondary bank for ships with a single secondary bank.

Needs to be an [[Multimedia_Files#ANI|ani]] with 2 frames; 1st is bank 1 not selected, 2nd is bank 1 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Secondary Filename:====

Designates the file to use for selected secondary bank for ships with two secondary banks.

Needs to be an [[Multimedia_Files#ANI|ani]] with 3 frames; 1st is no banks selected, 2nd is bank 1 selected, 3rd is bank 2 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Triple Secondary Filename:====

Designates the file to use for selected secondary bank for ships with two secondary banks.

Needs to be an [[Multimedia_Files#ANI|ani]] with 4 frames; 1st is no banks selected, 2nd is bank 1 selected, 3rd is bank 2 selected, 4th is bank 3 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Single Primary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Primary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Single Secondary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Secondary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Triple Secondary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Hidden By Comms Menu:====
{{Table3615|
Defines whether the messages gauge may be drawn at the same time as the wingman comms menu.
*Syntax: '''Boolean'''
*Default Value: '''false''' (messages are not visible while the comms menu is open)
Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]}}

====Bottom Background Offset:====
{{Table3615|
Defines the vertical pixel offset added to the position of the bottom background frame.
*Syntax: '''Integer''' vertical offset
*Units: Pixels
Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]}}

====Center Text On Gauge X-Position:====
{{Table375|
Sets whether to position the center of the text to the gauge's X-position.
*Syntax '''Boolean'''
*Default Value: '''false''' if the gauge is explicitly given a position, '''true''' otherwise
Used by: [[Hud_gauges.tbl#+Fixed Messages:|+Fixed Messages:]]}}

[[Category:Tables]]

Hud gauges.tbl

2020-04-15T15:57:40Z

Z64555: /* +Lead Indicator: */ Changed description to make it more distinct from the +Lead Sight

{{SCP table}}

{{TableVersionGit|2016-09-14|f9bc01c}}

The '''hud_gauges.tbl''' is used for modifying the elements of the HUD. Not all gauges can be modified. However, custom gauges may be added to mimic their behavior (such as the wingman status display).

HUD Elements in FS2 are called Gauges, and each gauge has various options to customize appearance and, in some cases, their behavior as well.

This table is one of the [[Modular Tables]] and can be extended with xxx-hdg.tbm

[[Tables|List of Tables]]

==HUD Configurations==
The following entries are used on the HUD system, but have not been grouped with any particular gauge.

===$Load Retail Configuration:===
Optional. If yes, any gauge missing from the HUD gauge definitions below will be loaded using the retail defaults.

If no, any missing (default) gauge will prompt an error.

*Syntax: '''Boolean'''

===$Color:===
Optional. Sets the default HUD color for all gauges.

*Syntax: ('''Integer''' Red, '''Integer''' Green, '''Integer''' Blue)
*Valid Values: all values from 0 to 255

===$Font:===
Optional. Sets the font type to use for the HUD. This can either be a string or a number. A string references a font with a specific name while a number references a font with a specific index in the fonts table. The number option is deprecated and is only there for backwards-compatibility. Use the name if possible.

*Syntax: '''String''' or '''Integer''' font index number
*Valid Values: Any name or font index as defined in [[Fonts.tbl]]

===$Chase View Only:===
{{Table381|
Optional. Sets gauges to be displayed only in Chase View.

*Syntax: '''Boolean'''
*Default Value: '''False'''
}}

===$Max Directives:===
Optional. Sets the default maximum number of directives displayed simultaneously.

*Syntax: '''Integer''' maximum number of directives
*Valid Values: Any positive number
*Default Value: '''5'''

===$Max Escort Ships:===
Optional. Sets the default maximum number of escort ships to be shown in the escort list.

*Syntax: '''Integer'''
*Valid Values: Any positive number
{{Warning|
Entries more than 16 will cause the list to overflow into the weapons list for resolutions lower than 1024x768.}}

===$Length Unit Multiplier:===
Optional. Sets the multiplier to applied to the reported distances. For example, if the multiplier is 0.5, then the distance reported to the player will (or at least should) be 0.5 x actual distance.

*Syntax: '''Float'''
*Valid Values: Any positive number

===$Speed Unit Multiplier:===
Optional. Analogous to [[Hud_gauges.tbl#$Length Unit Multiplier:|$Length Unit Multiplier]], this sets the multiplier to be applied to all speeds reported to the player. For example, if the multiplier is 0.5, the the speed reported to the player will (or at least should) be 0.5 x actual speed.

*Syntax: '''Float'''
*Valid Values: Any positive number
*Default Values:
:'''The value used in $Length Unit Multiplier''', or
:'''1''', if $Length Unit Multiplier is undefined

===$Wireframe Targetbox:===
Optional. Defines the default draw method for the target viewer (a.k.a. targetbox).

*Syntax: '''Integer''' Draw method ID
*Valid Values:
::'''0''' - Standard with full, bright lighting
::'''1''' - Wireframe
::'''2''' - Standard with proper lighting (i.e. lit the same as the actual target)
{{Table3615|
::'''3''' - Untextured with full bright lighting (i.e. drawn with a single flat color)}}

===$Targetbox Shader Effect:===
{{Table3615|
Optional. If set, defines a unique ID for a shader effect to be used when rendering a ship for the targeting box. The ID will be passed to the main shader as in [[Post_processing.tbl##Ship_Effects|#Ship_Effects]], but a table entry for the effect is not needed.

*Syntax: '''Integer'''
*Valid Values: Any positive number
}}

===$Lock Wireframe Mode:===
Optional. If set, prevents targetbox draw method from being changed during the gaming session.
*Syntax: '''Boolean'''

===$Scale Gauges:===
{{Table371|
Optional. If set, all gauges will use this value as the default for scaling individual gauge sizes (i.e. doesn't affect gauges that use Position:, and doesn't affect the values of Offset:. In addition, if "$Load Retail Configuration:" is true then all unspecified retail gauges will use this value.

If not set, defaults to yes.

*Syntax: '''Boolean'''
}}

===$Force Scaling Above:===
{{Table373|
Optional. If gauge scaling is disabled, then gauges will be scaled as though the base resolution were this resolution or the real base resolution, whichever is greater.

Use this to disable scaling at lower resolutions while preventing gauges from getting too small at higher resolutions.

To disable this feature, use '''(-1, -1)'''.

*Syntax: ('''Integer''' width, '''Integer''' height)
}}

===$Reticle Style:===
Optional. Defines which aiming reticle to use.
*Syntax: '''String'''
*Valid Values:
:'''FS1''' - uses '''''reticle1_fs1.ani'''''
:'''FS2''' - uses '''''reticle1.ani'''''

==#Gauge Config==
The following entries define default gauge appearance and behavior. Each gauge has the option of overriding these options.

===$Ship:===
Deprecated and superceded by $Ships in FSO revision 9208. If defined, the following config data will only be used if the player ship is of the supplied ship class. Can be defined multiple times within a #Gauge config group to allow unique HUD configurations per ship class.

If not defined, all following config data will be applied to all ships.

*Syntax: '''String''', ship class name

===$Ships:===
Optional. Can be used to define a list of ships the hud definition that follows will be applied to. Can be defined multiple times within a #Gauge config group to allow unique HUD configurations per ship class.

If not defined, all following config data will be applied to all ships.

*`Syntax: '''( "Class name 1" "Class name 2" )''', ship class names formatted like a flag list.

====$Load Retail Configuration:====
Optional. Overrides the [[Hud_gauges.tbl#$Load Retail Configuration: 1|$Load Retail Configuration]] global option for this ship class.

*Syntax: '''Boolean'''

====$Color:====
Optional. Overrides the [[Hud_gauges.tbl#$Color: 1|$Color]] global option for this ship class.

*Syntax: See [[Hud_gauges.tbl#$Color: 1|$Color]]

====$Font:====
Optional. Overrides the [[Hud_gauges.tbl#$Font: 1|$Font]] global option for this ship class.

*Syntax: See [[Hud_gauges.tbl#$Font: 1|$Font]]

====$Chase View Only:====
{{Table381|
Optional. Overrides the [[Hud_gauges.tbl#$Chase View Only: 1|$Chase View Only]] global option for this ship class.

*Syntax: See [[Hud_gauges.tbl#$Chase View Only: 1|$Chase View Only]]
}}

===$Base:===
Required. Defines the base resolution for this HUD configuration, upon which other gauge options (such as [[Hud_gauges.tbl#Position:|Position:]] / [[Hud_gauges.tbl#Origin:|Origin:]] / [[Hud_gauges.tbl#Offset:|Offset:]]) will use as its coordinate system.

*Syntax: ('''Integer''' width, '''Integer''' height)
*Valid Values: All supported resolutions (?)

===$Scale Gauges:===
{{Table371|
Optional. If set, will configure gauges Scaling behaviour for gauges in this #Gauge Config section. i.e. overriding the default, or the value specified at the top of the file. Individual gauges can override this setting.

*Syntax: '''Boolean'''
}}

===$Force Scaling Above:===
{{Table373|
Optional. If gauge scaling is disabled, then gauges will be scaled as though the base resolution were this resolution or the real base resolution, whichever is greater.

Use this to disable scaling at lower resolutions while preventing gauges from getting too small at higher resolutions.

To disable this feature, use '''(-1, -1)'''.

*Syntax: ('''Integer''' width, '''Integer''' height)
}}

===$Required Aspect:===
Optional. If set, this configuration will only be loaded for the specified aspect ratios.

Used as a filter when there are multiple $Base: resolutions in the table

*Syntax: '''String'''
*Valid Values:
:"Full Screen" (4:3, aspect ratio < 1.5)
:"Wide Screen" (16:9, 16:10, or similar, aspect ratio >= 1.5)

===$Min:===
Optional. Minimum resolution for this config. Any resolution lower than specified will not use this configuration.

Used as a filter when there are multiple $Base: resolutions in the table

*Syntax: ('''Integer''' width, '''Integer''' height)
*Valid Values: All supported resolutions (?)

===$Max:===
Optional. Maximum resolution for this config. Any resolution higher than specified will not use this configuration.

Used as a filter when there are multiple $Base: resolutions in the table

*Syntax: ('''Integer''' width, '''Integer''' height)
*Valid Values: All supported resolutions (?)

===$Gauges:===
Following entries define gauge-specific behavior. For the most part, each gauge has its own overrides that, if not defined, would otherwise use the global values.

Since many gauges have the same configuration options, each gauge entry has a list of valid sub-entries. Unless stated otherwise, these options must be defined in the same order as they are shown, starting from the top and ending at the bottom.

====+Custom:====
Adds a custom gauge type.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Name:|Name:]]
:[[Hud_gauges.tbl#Text:|Text:]]
:[[Hud_gauges.tbl#X Offset:|X Offset:]] (Optional)
:[[Hud_gauges.tbl#Y Offset:|Y Offset:]] (Optional)
:[[Hud_gauges.tbl#Gauge Type:|Gauge Type:]]
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Active by default:|Active by default:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]

{{table381|
====+Scripted Gauge:====
Adds a scripted gauge type.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Name:|Name:]]
}}

====+Messages:====
Adds a gauge that display mission messages.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Max Lines:|Max Lines:]] (Optional)
:[[Hud_gauges.tbl#Max Width:|Max Width:]] (Optional)
:[[Hud_gauges.tbl#Line Height:|Line Height]] (Optional)
:[[Hud_gauges.tbl#Total Lifetime:|Total Lifetime:]] (Optional)
:[[Hud_gauges.tbl#Scroll Time:|Scroll Time]] (Optional)
:[[Hud_gauges.tbl#Step Size:|Step Size:]] (Optional)
:[[Hud_gauges.tbl#Hidden By Comms Menu:|Hidden By Comms Menu:]] (Optional)

====+Training Messages:====
Adds a text box, like the ones seen in the FS1 and FS2 training missions.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}

====+Support:====
Adds a text box that shows the Support ship's status and ETA

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Text Y-offset:|Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Dock Status X-offset:|Dock Status X-offset:]] (Optional)
:[[Hud_gauges.tbl#Dock Time X-offset:|Dock Time X-offset:]] (Optional)

====+Damage:====
Adds a gauge that shows how much damage a target (or the player?) has.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Hull Integrity Offsets:|Hull Integrity Offsets]] (Optional)
:[[Hud_gauges.tbl#Hull Integrity Value X-offset:|Hull Integrity Value X-offset]] (Optional)
:[[Hud_gauges.tbl#Top Background Height:|Top Background Height:]] (Optional)
:[[Hud_gauges.tbl#Subsystem Entry Height:|Subsystem Entry Height:]] (Optional)
:[[Hud_gauges.tbl#Subsystem List Start Offsets:|Subsystem List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Subsystem Entry Value X-offset:|Subsystem Entry Value X-offset:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Offset:|Bottom Background Offset:]] (Optional)

====+Wingman Status:====
Adds a gauge that monitors the status of your wing and squadron.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Left Background Filename:|Left Background Filename:]] (Optional) (needs an animation with one frame)
{{table3615|
:[[Hud_gauges.tbl#First Background Filename:|First Background Filename:]] (Optional) (needs an animation with one frame)}}
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional) (needs an animation with one frame)
:[[Hud_gauges.tbl#Right Background Filename:|Right Background Filename:]] (Optional) (needs an animation with one frame)
{{table3615|
:[[Hud_gauges.tbl#Last Background Filename:|Last Background Filename:]] (Optional) (needs an animation with one frame)}}
:[[Hud_gauges.tbl#Dot Filename:|Dot Filename:]] (Optional) (needs an animation with two frames, 1st is for alive wingmen, 2nd is for dead or missing wingmen)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
{{table373|
[[Hud_gauges.tbl#Fixed Header Position:|Fixed Header Position:]] (Optional)}}
:[[Hud_gauges.tbl#Left Background Width:|Left Background Width:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#First Background Size:|First Background Size:]] (Optional)}}
:[[Hud_gauges.tbl#Entry Width:|Entry Width:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Entry Size:|Entry Size:]] (Optional)
:[[Hud_gauges.tbl#Right Background Offset:|Right Background Offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Offset:|Last Background Offset:]] (Optional)}}
:[[Hud_gauges.tbl#Single Wing Offsets:|Single Wing Offsets:]] (Optional)
:[[Hud_gauges.tbl#Multiple Wing Start Offsets:|Multiple Wing Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Wing Name Offsets:|Wing Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Dot Offsets:|Dot Offsets:]] (Optional)
:[[Hud_gauges.tbl#Expansion Mode:|Expansion Mode:]] (Optional)

====+Auto Speed:====
Adds the Auto-Speed mode gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (needs animation with 4 frames, 3rd is without auto-match-speed enabled, 4th is with... and frames 0 & 1 are not used, done this way because retail fs2 uses the same animation file for the auto speed & auto targeting gauges)
:[[Hud_gauges.tbl#Auto Offsets:|Auto Offsets:]] (Optional)
:[[Hud_gauges.tbl#Speed Offsets:|Speed Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#On Text Color:|On Text Color:]] (Optional)
:[[Hud_gauges.tbl#On Text Color:|Off Text Color:]] (Optional)}}

====+Auto Target:====
Adds the Auto-target mode gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (needs animation with 2 frames, 1st is without auto-targeting enabled, 2nd is with)
:[[Hud_gauges.tbl#Auto Offsets:|Auto Offsets:]] (Optional)
:[[Hud_gauges.tbl#Target Offsets:|Target Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#On Text Color:|On Text Color:]] (Optional)
:[[Hud_gauges.tbl#On Text Color:|Off Text Color:]] (Optional)}}

====+Countermeasures:====
Adds a gauge that monitors the amount of remaining countermeasures the player's ship currently has.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (needs an animation with a single frame)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
:[[Hud_gauges.tbl#Value Offsets:|Value Offsets:]] (Optional)

====+Talking Head:====
Adds a video window to display pilot message videos (a.k.a talking heads).

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Animation Offsets:|Animation Offsets:]] (Optional)
:[[Hud_gauges.tbl#Animation Background Size:|Animation Background Size:]] (Deprecated)
{{table373|
:[[Hud_gauges.tbl#Animation Size:|Animation Size:]] (Optional)
}}

====+Directives:====
Adds a gauge that displays all currently active directives (includes current , completed, and failed)

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional) (needs animation with one frame)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional) (needs animation with one frame)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional) (needs animation with one frame)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Background Height:|Top Background Height:]] (Optional)
:[[Hud_gauges.tbl#List Start Offsets:|List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Bottom Background Offset:|Bottom Background Offset:]] (Optional)
:[[Hud_gauges.tbl#Max Line Width:|Max Line Width:]] (Optional)
}}

====+Weapons:====
Adds a weapon status and ammunition gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Primary List Top Background Filename:|Primary List Top Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Primary List Middle Background Filename:|Primary List Middle Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Primary List Bottom Background Filename:|Primary List Bottom Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Secondary List Top Background Filename:|Secondary List Top Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Secondary List Entry Background Filename:|Secondary List Entry Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Secondary List Bottom Background Filename:|Secondary List Bottom Background Filename:]] (Optional) (needs animation with a single frame)
::[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
::[[Hud_gauges.tbl#Alt Ballistic Offsets:|Alt Ballistic Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Primary Background X-offset:|Top Primary BackgroundX-offset:]] (Optional)
::[[Hud_gauges.tbl#Alt Ballistic X-offset:|Alt Ballistic X-offset:]] (Optional)
:[[Hud_gauges.tbl#Text X-offset:|Text X-offset:]] (Optional)
::[[Hud_gauges.tbl#Alt Ballistic X-offset:|Alt Ballistic X-offset:]] (Optional)
:[[Hud_gauges.tbl#Top Primary Frame Height:|Top Primary Frame Height:]] (Optional)
:[[Hud_gauges.tbl#Top Secondary Frame Height:|Top Secondary Frame Height:]] (Optional)
:[[Hud_gauges.tbl#Primary List Start Y-offset:|Primary List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary List Start Y-offset:|Secondary List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Ammo X-offset:|Primary Weapon Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Link X-offset:|Primary Weapon Link X-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Name X-offset:|Primary Weapon Name X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Ammo X-offset:|Secondary Weapon Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Linked X-offset:|Secondary Weapon Linked X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Name X-offset:|Secondary Weapon Name X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Reload X-offset:|Secondary Weapon Reload X-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Entry Height:|Primary Weapon Entry Height:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Entry Height:|Secondary Weapon Entry Height:]] (Optional)

====+Objective notify:====
Adds a Objective notifier gauge. This gauge alerts the player when receiving a new objective, or when an objective has been completed or failed. Additionally, this gauge alerts the player when entering subspace, and when a Red Alert mission orders are being received (prior to a forced subspace jump).

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Objective Text Y-offset:|Objective Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Objective Value Y-offset:|Objective Value Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Subspace Text Y-offset:|Subspace Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Subspace Value Y-offset:|Subspace Value Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Red Alert Text Y-offset:|Red Alert Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Red Alert Value Y-offset:|Red Alert Value Y-offset:]] (Optional)

====+Squad Message====
Adds the squad message gauge. In FS1 and FS2, this gauge is used to send commands to your squad. (?)

*Valid sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#List Start Offsets:|List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Background Height:|Top Background Height:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Bottom Background Offset|Bottom Background Offset]] (Optional)}}
:[[Hud_gauges.tbl#Command X-offset:|Command X-offset:]] (Optional)
:[[Hud_gauges.tbl#Page Up Offsets:|Page Up Offsets:]] (Optional)
:[[Hud_gauges.tbl#Page Down Offsets:|Page Down Offsets:]] (Optional)

====+Lag:====
Adds a Lag gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]

====+Mini Target Shields:====
Adds a mini Target shields gauge. In FS1 and FS2, the Mini Target Shield gauge is the one right below the center reticle, and shows the hull damage in %

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (animation needs 8 frames; 0->3 are the top, right, bottom & left shield quads; 4->7 are the same except brighter for when the quad is flashing from being hit)
:[[Hud_gauges.tbl#3 Digit Hull Offsets:|3 Digit Hull Offsets:]] (Optional)
:[[Hud_gauges.tbl#2 Digit Hull Offsets:|2 Digit Hull Offsets:]] (Optional)
:[[Hud_gauges.tbl#1 Digit Hull Offsets:|1 Digit Hull Offsets:]] (Optional)

====+Player Shields:====
Adds a gauge that shows the shield and hull status icon of the player's craft or ship.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)

====+Target Shields:====
Adds a gauge that shows the shield and hull status icon of the targeted craft or ship.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)

====+Escort View:====
Adds an escort monitor/view gauge. This gauge monitors the status of all ships assigned to the player to escort.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height]] (Optional)
:[[Hud_gauges.tbl#Entry Stagger Width:|Entry Stagger Width:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Bottom Background Offset:|Bottom Background Offset:]] (Optional)}}
:[[Hud_gauges.tbl#Header Text:|Header Text]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#List Start Offsets:|List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Hull X-offset:|Hull X-offset]] (Optional)
:[[Hud_gauges.tbl#Name X-offset:|Name X-offset]] (Optional)
:[[Hud_gauges.tbl#Status X-offset:|Status X-offset]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Ship Name Max Width:|Ship Name Max Width:]] (Optional)}}
{{table373|
:[[Hud_gauges.tbl#Right-Align Ship Names:|Right-Align Ship Names:]] (Optional)}}

====+Mission Time:====
Adds a gauge that displays the current mission time.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
:[[Hud_gauges.tbl#Value Offsets:|Value Offsets:]] (Optional)

====+ETS Retail:====
{{Table3613|
Draws the three other ETS gauges as a single gauge. Will automatically rearrange itself (like retail) if shields or other systems are missing.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
{{Table3613|
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)
:[[Hud_gauges.tbl#Gauge Offset:|Gauge Offset:]] (Optional)

}}

====+ETS Weapons:====
Adds a gauge that displays the energy transfer rate for the energy weapons.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)

====+ETS Engines:====
Adds a gauge that displays the energy transfer rate for the afterburner/engines.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)

====+ETS Shields:====
Adds a gauge that displays the energy transfer rate for the shields.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)

====+Target Monitor:====
Adds a target monitor gauge that shows the targeted ship's relative orientation and hull strength, among other things.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Monitor Filename:|Monitor Filename:]] (Optional) (needs animation with 2 frames, 1st is the background for the target, 2nd is the border; rendered last)
{{table3615|
:[[Hud_gauges.tbl#Monitor Alpha Mask Filename:|Monitor Alpha Mask Filename:]] (Optional) (needs animation with a single frame)}}
:[[Hud_gauges.tbl#Integrity Bar Filename:|Integrity Bar Filename:]] (Optional) (needs animation with 2 frames, 1st is a zero/dark filled bar, 2nd is a max/bright filled bar)
:[[Hud_gauges.tbl#Viewport Offsets:|Viewport Offsets:]] (Optional)
:[[Hud_gauges.tbl#Viewport Size:|Viewport Size:]] (Optional)
:[[Hud_gauges.tbl#Integrity Bar Offsets:|Integrity Bar Offsets:]] (Optional)
:[[Hud_gauges.tbl#Integrity Bar Foreground Clip Height:|Integrity Bar Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Status Offsets:|Status Offsets:]] (Optional)
:[[Hud_gauges.tbl#Name Offsets:|Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Class Offsets:|Class Offsets:]] (Optional)
:[[Hud_gauges.tbl#Distance Offsets:|Distance Offsets:]] (Optional)
:[[Hud_gauges.tbl#Speed Offsets:|Speed Offsets:]] (Optional)
:[[Hud_gauges.tbl#Hull Offsets:|Hull Offsets:]] (Optional)
:[[Hud_gauges.tbl#Cargo Contents Offsets:|Cargo Contents Offsets:]] (Optional)
:[[Hud_gauges.tbl#Cargo Scan Start Offsets:|Cargo Scan Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Cargo Scan Size:|Cargo Scan Size:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Subsystem Name Offsets:|Subsystem Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Subsystem Integrity Offsets:|Subsystem Integrity Offsets:]] (Optional)
:[[Hud_gauges.tbl#Disabled Status Offsets:|Disabled Status Offsets:]] (Optional)
:[[Hud_gauges.tbl#Desaturate:|Desaturate:]] (Optional)
}}

====+Extra Target Data:====
Adds a gauge that displays "extra" target data, such as its current orders and docking status.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs an animation with 1 frame)
:[[Hud_gauges.tbl#Bracket Offsets:|Bracket Offsets:]] (Optional)
:[[Hud_gauges.tbl#Dock Offsets:|Dock Offsets:]] (Optional)
{{table373|
:[[Hud_gauges.tbl#Dock Max Width:|Dock Max Width:]] (Optional)}}
:[[Hud_gauges.tbl#Order Offsets:|Order Offsets:]] (Optional)
{{table373|
:[[Hud_gauges.tbl#Order Max Width:|Order Max Width:]] (Optional)}}
:[[Hud_gauges.tbl#Time Offsets:|Time Offsets:]] (Optional)

====+Radar:====
Adds a standard radar gauge

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs animation with 2 frames, only the 2nd frame is used)
{{table373|
:[[Hud_gauges.tbl#Radar Center Offsets:|Radar Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Radar Size:|Radar Size:]] (Optional)
}}
:[[Hud_gauges.tbl#Infinity Distance Offsets:|Infinity Distance Offsets]] (Optional)
:[[Hud_gauges.tbl#Long Distance Offsets:|Long Distance Offsets:]] (Optional)
:[[Hud_gauges.tbl#Short Distance Offsets:|Short Distance Offsets:]] (Optional)

====+Radar Orb:====
Adds a 3D orb radar gauge

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs animation with 2 frames, only the 2nd frame is used)
{{table373|
:[[Hud_gauges.tbl#Radar Center Offsets:|Radar Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Radar Size:|Radar Size:]] (Optional)
}}
:[[Hud_gauges.tbl#Infinity Distance Offsets:|Infinity Distance Offsets]] (Optional)
:[[Hud_gauges.tbl#Long Distance Offsets:|Long Distance Offsets:]] (Optional)
:[[Hud_gauges.tbl#Short Distance Offsets:|Short Distance Offsets:]] (Optional)

====+Radar BSG:====
Adds a BSG style radar (a.k.a DRADIS).

:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Size:|Size:]] (Optional)
:[[Hud_gauges.tbl#XY Disc Filename:|XY Disc Filename:]] (Optional)
:[[Hud_gauges.tbl#XZ YZ Disc Filename:|XZ YZ Disc Filename:]] (Optional)
:[[Hud_gauges.tbl#Sweep Disc Filename:|Sweep Disc Filename:]] (Optional)
:[[Hud_gauges.tbl#Default Contact Filename:|Default Contact Filename:]] (Optional)
:[[Hud_gauges.tbl#Unknown Contact Filename:|Unknown Contact Filename:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]]
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]]
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Loop Volume:|Loop Volume:]] (Optional)
:[[Hud_gauges.tbl#Minimum Beep Delay:|Minimum Beep Delay]] (Optional)

====+Afterburner Energy:====
Adds a gauge that shows the remaining afterburner energy. Note that it only supports a vertical fill.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs animation with 2 frames, the 1st is the bar lit for zero energy, the 2nd is the bar lit for max energy)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)

====+Weapon Energy:====
Adds a gauge that shows the remaining weapon energy. Note that it only supports a vertical fill.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs an animation with 4 frames, the 3rd is the bar lit for zero energy, the 2nd is the bar lit for max energy, frames 1 & 2 are not used)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Text Alignment:|Text Alignment:]] (Optional)
:[[Hud_gauges.tbl#Always Show Text:|Always Show Text:]] (Optional)
:[[Hud_gauges.tbl#Text Follows:|Text Follows:]] (Optional)
:[[Hud_gauges.tbl#Show Ballistic Ammo:|Show Ballistic Ammo:]] (Optional)
:[[Hud_gauges.tbl#Armed Guns List Offsets:|Armed Guns List Offsets:]] (Optional)
:[[Hud_gauges.tbl#Armed Guns List Alignment:|Armed Guns List Alignment:]] (Optional)
:[[Hud_gauges.tbl#Armed Guns List Entry Height:|Armed Guns List Entry Height:]] (Optional)
}}

====+Text Warnings:====
Adds a gauge that warns the player (current warnings are EMP, Launch, Evaded, Collision, Blast & Engine Wash).

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)

====+Center Reticle:====
Adds a "custom" center reticle.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Firepoint display:|Firepoint display:]] (Optional)
:[[Hud_gauges.tbl#Firepoint size:|Firepoint size:]] (Optional)
:[[Hud_gauges.tbl#Firepoint X coordinate multiplier:|Firepoint X coordinate multiplier:]] (Optional)
:[[Hud_gauges.tbl#Firepoint Y coordinate multiplier:|Firepoint Y coordinate multiplier:]] (Optional)

====+Throttle:====
Adds a gauge that shows the current throttle position.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Bottom Y-offset:|Foreground Clip Bottom Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Width:|Foreground Clip Width:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Afterburner Clip Height:|Afterburner Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Show Background:|Show Background:]] (Optional)
:[[Hud_gauges.tbl#Max Speed Label Offsets:|Max Speed Label Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Show Max Speed Label:|Show Max Speed Label:]] (Optional)}}
:[[Hud_gauges.tbl#Min Speed Label Offsets:|Min Speed Label Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Show Min Speed Label:|Show Min Speed Label:]] (Optional)}}
:[[Hud_gauges.tbl#Orbit Center Offsets:|Orbit Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Orbit Radius:|Orbit Radius:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Current Speed Offsets:|Current Speed Offsets:]] (Optional)
:[[Hud_gauges.tbl#Target Speed Offsets:|Target Speed Offsets:]] (Optional)
:[[Hud_gauges.tbl#Show Percentage:|Show Percentage:]] (Optional)
:[[Hud_gauges.tbl#Glide Status Offsets:|Glide Status Offsets:]] (Optional)
:[[Hud_gauges.tbl#Match Speed Status Offsets:|Match Speed Status Offsets:]] (Optional)
}}

====+Threat Indicator:====
Adds a gauge that indicates when a lock-on has been achieved by an attacker, and if the player is being shot at.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Arc Filename:|Arc Filename:]] (Optional)
:[[Hud_gauges.tbl#Dumbfire Filename:|Dumbfire Filename:]] (Optional)
:[[Hud_gauges.tbl#Lock Filename:|Lock Filename:]] (Optional)
:[[Hud_gauges.tbl#Dumbfire Offsets:|Dumbfire Offsets:]] (Optional)
:[[Hud_gauges.tbl#Lock Offsets:|Lock Offsets:]] (Optional)

====+Multiplayer Messages:====
Adds a gauge that displays the multiplayer messages.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}

====+Voice Status:====
Adds a gauge that displays the voice status.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}

====+Ping:====
Adds a gauge that the ping time to the multiplayer server.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}

====+Supernova:====
Adds a gauge that warns the player of an impending supernova shock wave.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}

====+Lock Indicator:====
Adds a Lock Indicator gauge.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Lock Filename:|Lock Filename:]] (Optional)
:[[Hud_gauges.tbl#Locked Filename:|Locked Filename:]] (Optional)
:[[Hud_gauges.tbl#Lock Center Offsets:|Lock Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Locked Center Offsets:|Locked Center Offsets:]] (Optional)

====+Offscreen Indicator:====
Adds an Offscreen Indicator.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}

====+Target Brackets:====
Adds a Target Bracket gauge. This is drawn around current target(s) and talkers.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Dot Filename:|Dot Filename:]] (Optional)

====+Hostile Triangle:====
Adds a gauge that points to the nearest attacker, if it is off-screen and is not currently targeted.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)
:[[Hud_gauges.tbl#Triangle Base:|Triangle Base:]] (Optional)
:[[Hud_gauges.tbl#Triangle Height:|Triangle Height:]] (Optional)

====+Target Triangle:====
Adds a gauge that points to the targeted craft, if it is currently off-screen.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)
:[[Hud_gauges.tbl#Triangle Base:|Triangle Base:]] (Optional)
:[[Hud_gauges.tbl#Triangle Height:|Triangle Height:]] (Optional)

====+Missile Triangles:====
Adds a gauge that is used during attempting to lock onto a target when using an aspect seeking missile.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)
:[[Hud_gauges.tbl#Triangle Base:|Triangle Base:]] (Optional)
:[[Hud_gauges.tbl#Triangle Height:|Triangle Height:]] (Optional)

====+Lead Indicator:====
Adds a gauge that leads (is in front) of the target. Aim your crosshairs at this indicator to increase probability of hitting the target.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
::Frame #0: Secondaries lead indicator (Dumbfire)
::Frame #1: Secondaries lead indicator (Homing)
::Frame #2: Primaries lead indicator
:[[Hud_gauges.tbl#Center Offsets:|Center Offsets:]] (Optional)

====+Orientation Tee:====
Adds a gauge that indicates the targeted craft's orientation in relation to the player's craft.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)

====+Lead Sight:====
Adds a gauge that indicates where your shots will end up, as opposed to Lead Indicator that indicates where you have to shoot at to hit your target. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
::Frame #0 is used for secondaries
::* If only one frame is found in the file, then it is used for primaries instead
::Frame #1 is used for primaries

====+Kills:====
Adds a gauge that keeps track of how many kills the player has scored during a mission.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
:[[Hud_gauges.tbl#Value Offsets:|Value Offsets:]] (Optional)

====+Weapon Linking:====
Adds a gauge that indicates the selected weapons and their firing rates.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Arc Filename:|Arc Filename:]] (Optional)
:[[Hud_gauges.tbl#Single Primary Filename:|Single Primary Filename:]] (Optional)
:[[Hud_gauges.tbl#Double Primary Filename:|Double Primary Filename:]] (Optional)
:[[Hud_gauges.tbl#Single Secondary Filename:|Single Secondary Filename:]] (Optional)
:[[Hud_gauges.tbl#Double Secondary Filename:|Double Secondary Filename:]] (Optional)
:[[Hud_gauges.tbl#Triple Secondary Filename:|Triple Secondary Filename:]] (Optional)
:[[Hud_gauges.tbl#Single Primary Offsets:|Single Primary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Double Primary Offsets:|Double Primary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Single Secondary Offsets:|Single Secondary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Double Secondary Offsets:|Double Secondary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Triple Secondary Offsets:|Triple Secondary Offsets:]] (Optional)

====+Fixed Messages:====

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
{{table375|
:[[Hud_gauges.tbl#Center Text On Gauge X-Position:|Center Text On Gauge X-Position:]] (Optional)
}}

====+Flight Path Marker:====
{{table3615|
Adds a gauge that indicates the direction where your ship is traveling. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Center Offsets:|Center Offsets:]] (Optional)}}

====+Warhead Count:====
{{table3615|
Displays the name of the current secondary weapon. Tallies the ammo left. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs an animation with a single frame)
:[[Hud_gauges.tbl#Name Offsets:|Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Count Offsets:|Count Offsets:]] (Optional)
:[[Hud_gauges.tbl#Icon Width:|Icon Width:]] (Optional)
:[[Hud_gauges.tbl#Icon Height:|Icon Height:]] (Optional)
:[[Hud_gauges.tbl#Max Icons:|Max Icons:]] (Optional)
:[[Hud_gauges.tbl#Max Columns:|Max Columns:]] (Optional)
:[[Hud_gauges.tbl#Name Alignment:|Name Alignment:]] (Optional)
}}

====+Hardpoints:====
{{table3615|
Draws a silhouette of the player's ship and mounted weapons. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Size:|Size:]] (Optional)
:[[Hud_gauges.tbl#Line Width:|Line Width:]] (Optional)
:[[Hud_gauges.tbl#View Direction:|View Direction:]] (Optional)
:[[Hud_gauges.tbl#Show Primary Weapons:|Show Primary Weapons:]] (Optional)
:[[Hud_gauges.tbl#Show Secondary Weapons:|Show Secondary Weapons:]] (Optional)
}}

====+Primary Weapons:====
{{table3615|
Like the Weapons gauge but simpler. Only displays primary weapons. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Header Text:|Header Text:]] (Optional)
:[[Hud_gauges.tbl#First Background Filename:|First Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#First Background Height:|First Background Height:]] (Optional)
:[[Hud_gauges.tbl#First Background X-offset:|First Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Entry Background Height:|Entry Background Height:]] (Optional)
:[[Hud_gauges.tbl#Entry Background X-offset:|Entry Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Filename:|Last Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Last Background X-offset:|Last Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Y-offset:|Last Background Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
:[[Hud_gauges.tbl#List Start Y-offset:|List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Ammo X-offset:|Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Link X-offset:|Link X-offset:]] (Optional)
:[[Hud_gauges.tbl#Name X-offset:|Name X-offset:]] (Optional)
}}

====+Secondary Weapons:====
{{table3615|
Like the Weapons gauge but simpler. Only displays secondary weapons. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table381|
:[[Hud_gauges.tbl#Chase View Only:|Chase View Only:]] (Optional)}}
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Header Text:|Header Text:]] (Optional)
:[[Hud_gauges.tbl#First Background Filename:|First Background Filename:]] (Optional)
:[[Hud_gauges.tbl#First Background Height:|First Background Height:]] (Optional)
:[[Hud_gauges.tbl#First Background X-offset:|First Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Height:|Entry Background Height:]] (Optional)
:[[Hud_gauges.tbl#Entry Background X-offset:|Entry Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Filename:|Last Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Last Background X-offset:|Last Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Y-offset:|Last Background Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
:[[Hud_gauges.tbl#List Start Y-offset:|List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Ammo X-offset:|Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Link X-offset:|Link X-offset:]] (Optional)
:[[Hud_gauges.tbl#Name X-offset:|Name X-offset:]] (Optional)
:[[Hud_gauges.tbl#Unlink X-offset:|Unlink X-offset:]] (Optional)
:[[Hud_gauges.tbl#Reload X-offset:|Reload X-offset:]] (Optional)
}}

===$End Gauges===
The Gauges section must end with $End Gauges. No Exceptions.

==#End==
The very last entry in the Hud_gauges.tbl must be #End. No Exceptions.

----
----

==Gauge Configuration Options==
Since a vast majority of gauges share the same entries, the configuration options for each gauge have been grouped here for formatting consistency.

====Position:====
Defines the screen coordinates for the upper left corner of this gauge.

*Syntax: '''Integer''' horizontal pixel, '''Integer''' vertical pixel position

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Training Messages:|+Training Messages:]], [[Hud_gauges.tbl#+Support:|+Support]] (and many others)

====Scale Gauge:====

{{table371|
Define if a gauge size will scale or not.

If false then gauge bitmaps will always show at their original size which may result in gauges being very small at high resolutions.

If true then gauge bitmaps will scale in proportion to the current resolution vs the base HUD resolution in use. This may result in gauges becoming blurry at non-base resolutions.

Defaults to yes/true.

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: '''Boolean''' scale_this_gauge

Used by: most gauges
}}

====Force Scaling Above:====

{{Table373|
Optional. If scaling is disabled for this gauge, then it will be scaled as though the base resolution were this resolution or the real base resolution, whichever is greater.

Use this to disable scaling at lower resolutions while preventing gauges from getting too small at higher resolutions.

To disable this feature, use '''(-1, -1)'''.

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: ('''Integer''' width, '''Integer''' height)

Used by: most gauges
}}

====Origin:====

{{table371|
Define gauge position as a ratio of the screen size (base or current, it doesn't matter).

Requires [[Hud_gauges.tbl#Offset:|Offset:]]

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: '''Float''' horizontal ratio 0.0 - 1.0, '''Float''' vertical ratio 0.0 - 1.0

Used by: most gauges
}}

====Offset:====

{{table371|
Define gauge offset from [[Hud_gauges.tbl#Origin:|Origin:]] in base resolution pixels

Requires [[Hud_gauges.tbl#Origin:|Origin:]]

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: '''Integer''' horizontal pixel offset from Origin:, '''Integer''' vertical pixel offset from Origin:

Used by: most gauges
}}

====Cockpit Target:====
The cockpit display that this gauge will be rendered to. Refers to the +Display Name: defined in [[ships.tbl#$Cockpit Display:|$Cockpit Display:]].

*Syntax: '''String''' String defined in +Display Name: in [[ships.tbl#$Cockpit Display:|$Cockpit Display:]]

=====Canvas Size:=====
The off-screen canvas this gauge will be rendered to before being interpolated into the actual cockpit display. The smaller this number is, the larger the gauge will appear on the cockpit display.

*Syntax: '''Integer''' width, '''Integer''' height

=====Display Offset:=====
The position of the canvas on the cockpit display texture

*Syntax: '''Integer''' width, '''Integer''' height

=====Display Size:=====
The interpolated size on the cockpit display texture that the canvas will be rendered to.

*Syntax: '''Integer''' width, '''Integer''' height

====Color:====
Optional. Overrides both previous color settings ([[Hud_gauges.tbl#$Color: 1|$Color]] HUD option and [[Hud_gauges#$Color: 2|$Color]] ship class option) for this particular gauge.

*Syntax: See [[Hud_gauges.tbl#$Color: 1|$Color:]]

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Font:====
Optional. Overrides both previous font settings ([[Hud_gauges.tbl#$Font: 1|$Font]] HUD option and [[Hud_gauges#$Font: 2|$Font]] ship class option) for this particular gauge.

*Syntax: See [[Hud_gauges.tbl#$Font: 1|$Font:]]

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Training Messages:|+Training Messages:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Name:====
Defines the name of this custom gauge.

*Syntax: '''String'''
*Max Length: 32 characters

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Text:====
Default text to be displayed. Can be altered using the hud-set-message, hud-set-text and hud-set-directive sexps.

*Syntax: '''String'''
*Max Length: 32 characters

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====X Offset:====
Optional. Defines the horizontal pixel offset (from the gauge's origin as defined by [[Hud_gauges.tbl#Position:|Position:]]) that the Text will be displayed.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Y Offset:====
Optional. Defines the vertical pixel offset (from the gauge's origin defined by [[Hud_gauges.tbl#Position:|Position:]]) that the Text will be displayed.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Gauge Type:====
Defines the type of gauge this is.

*Syntax: '''String'''
*Valid Values: Any one of the possible [[gauge types]].

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Slew:====
Optional. Determines whether or not this gauge is affected by afterburner shaking or similar effects. If set to "true", the gauge will not follow the player's head movements when using TrackIR/padlock. i.e. should be used for gauges like the gunsight/leadsight.

*Syntax: '''Boolean'''

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Max Lines:====
Optional. Specifies the maximum number of message lines that are displayed.

*Syntax: '''Integer'''
*Default Value: 3

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Max Width:====
Optional. Determines how long each message line may be.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Line Height:====
Optional. Determines the distance between line origins. (i.g. for a 12pt Font, there are needs to be at least 12 pixels between the bottom of one line and the next, otherwise the text will overlap each)

*Syntax: '''Integer'''
*Units: Pixels
*Default Value: 9

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Total Lifetime:====
Optional. Determines the maximum time the message gauge will be displayed from the time a new message is received.

*Syntax: '''Integer'''
*Units: milliseconds
*Default Value: 14000 (14 seconds)

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Scroll Time:====
Optional. Determines the time for the messages to scroll up one step.( See [[Hud_gauges.tbl#Step Size:|Step Size:]] )

*Syntax: '''Integer'''
*Units: milliseconds
*Default Value: 30

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Step Size:====
Optional. Determines how many pixels to shift message lines during scrolling. Messages will be shifted up by this amount until they are on the next line (as defined by [[Hud_gauges.tbl#Line Height:|Line Height:]])

*Syntax: '''Integer'''
*Units: Pixels
*Default Value: 3

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Active by default:====
Optional. Determines whether or not this gauge is always active, or only available after being activated via sexp.

*Syntax: '''Boolean'''

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Filename:====
Designates the [[Multimedia_Files#ANI|.ANI]] or [[Multimedia_Files#EFF|.EFF]] used for this gauge's background graphic.
{{Note| All HUD .ANI's must have the same color palette as the retail .ANI's in order to render properly. (.EFF's do not have this restriction)}}

*Syntax: '''Filename'''
**No filename extension is needed.

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Top Background Filename:====
Optional. Designates which file to use for the top background. (?)

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Damage|+Damage]]

====Bottom Background Filename:====
Optional. Designates which file to use for the Bottom background (?)

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Damage|+Damage]]

====Left Background Filename:====
Optional. Designates which file to use for the Left side of gauge.

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====First Background Filename:====
Optional. Alias for [[Hud_gauges.tbl#Left Background Filename:|Left Background Filename:]]

====Right Background Filename:====
Optional. Designates which file to use for the Right side of the gauge.

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Last Background Filename:====
Optional. Alias for [[Hud_gauges.tbl#Right Background Filename:|Right Background Filename:]]

====Entry Background Filename:====
Optional. Designates which file to use for the (Wing) Entry section of the gauge (aka the middle sections).

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Damage|+Damage]], [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Primary List Top Background Filename:====
Optional. Designates which file to use for the Primary List Top Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary List Middle Background Filename:====
Optional. Designates which file to use for the Primary List Middle Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary List Bottom Background Filename:====
Optional. Designates which file to use for the Primary List Bottom Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Top Background Filename:====
Optional. Designates which file to use for the Secondary List Top Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Entry Background Filename:====
Optional. Designates which file to use for the Secondary List Entry Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Bottom Background Filename:====
Optional. Designates which file to use for the Secondary List Bottom Background

*Syntax: '''Filename'''
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Alt Ballistic Filename:====
Optional. Designates an alternate file to be used for ballistic weapons.

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#Primary List Top Background Filename:|Primary List Top Background Filename]], [[Hud_gauges.tbl#Primary List Middle Background Filename:|Primary List Middle Background Filename]], [[Hud_gauges.tbl#Primary List Bottom Background Filename:|Primary List Bottom Background Filename]], [[Hud_gauges.tbl#Secondary List Top Background Filename:|Secondary List Top Background Filename]], [[Hud_gauges.tbl#Secondary List Entry Background Filename:|Secondary List Entry Background Filename]], [[Hud_gauges.tbl#Secondary List Bottom Background Filename:|Secondary List Bottom Background Filename]]

====Dot Filename:====
Optional. Designates which file to use for the wingman graphic (a.k.a. the Dot)

*Syntax: '''Filename'''

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Header Offsets:====
Optional. Designates the offset from the gauge's upper left corner for headers of various gauges

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels
*Valid Sub-entries:
:Weapons:
::[[Hud_gauges.tbl#Alt Ballistic Offsets:|Alt Ballistic Offsets:]]

Used by: [[Hud_gauges.tbl#+Support:|+Support:]], [[Hud_gauges.tbl#+Damage|+Damage:]], [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Fixed Header Position:====
Optional. If set, the header text will not change position when the gauge changes size.

*Syntax: '''Boolean'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Text Y-offset:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship Text. (?)

*Syntax: '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]]

====Text Offsets:====
Optional. Defines the screen position offsets for the text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: :[[Hud_gauges.tbl#+Countermeasures:|+Countermeasures:]]

====Value Offsets:====
Optional. Defines the screen position offsets for the value label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: :[[Hud_gauges.tbl#+Countermeasures:|+Countermeasures:]]

====Dock Status X-offset:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship's dock status. (?)

*Syntax: '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]]

====Dock Time X-offset:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship's dock time. (?)

*Syntax: '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]]

====Hull Integrity Offsets:====
Optional. Designates the offsets from the gauge's upper left corner for the for the Damage gauge Hull integrity textbox(?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Hull Integrity Value X-offset:====
Optional. Designates the offsets from the hull integrity textbox's upper left corner for the hull integrity value. (?)

*Syntax: '''Integer''' horizontal offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Top Background Height:====
Optional. Designates the height of the Top background (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Left Background Width:====
Optional. Defines the width of the Left Background.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Entry Width:====
Optional. Defines the width of the Entry Background (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Subsystem Entry Height:====
Optional. Designates the height of the Subsystem entry (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Subsystem List Start Offsets:====
Optional. Designates the offsets from the gauge's upper left corner for the for the start of the Subsytem List (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Subsystem Entry Value X-offset:====
Optional. Designates the horizontal offset from the Subsystem List's position (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Single Wing Offsets:====
Optional. Designates the offset from the gauge's upper left corner for a single wing (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Multiple Wing Start Offsets:====
Optional. Designates the offset from the gauge's upper left corner for multiple wings (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Wing Name Offsets:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship header (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Dot Offsets:====
Optional. Designates the offset from the gauge's upper left corner for the All wingman status icons.
*Syntax:
:'''Integer''' x, '''Integer''' y ;; Wingman 1
:'''Integer''' x, '''Integer''' y ;; Wingman 2
:'''Integer''' x, '''Integer''' y ;; Wingman 3
:'''Integer''' x, '''Integer''' y ;; Wingman 4
:'''Integer''' x, '''Integer''' y ;; Wingman 5
:'''Integer''' x, '''Integer''' y ;; Wingman 6
*Units: Pixels

{{Warning|
All 6 wingman positions must be defined}}

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Expansion Mode:====
Optional. Denotes which direction (in relation to the player's wing) that the other wings should be appended to the gauge

*Syntax: '''String'''
*Valid Values:
:*Right ;; Wings are added to the right of the previous wing

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Auto Offsets:====
Optional. Defines the screen coordinates for the "Auto" text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Auto Speed:|+Auto Speed:]], [[Hud_gagues.tbl#+Auto Target:|+Auto Target:]]

====Speed Offsets:====
Optional. Defines the screen coordinates for the "Speed" text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Auto Speed:|+Auto Speed:]]

====Target Offsets:====
Optional. Defines the screen coordinates for the "Target" text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Auto Target:|+Auto Target:]]

====Animation Offsets:====
Optional. Defines the offsets for the animation graphics.

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Talking Head:|+Talking Head:]]

====Animation Background Size:====
Deprecated. Originally, this set the size of the black box that's drawn behind the animation. Since Git revision 556e9a4 (2015-11-01), it has the same effect as [[Hud_gauges.tbl#Animation Size:|Animation Size:]].

*Syntax: '''Integer''' horizontal size, '''Integer''' vertical size
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Talking Head:|+Talking Head:]]

====Animation Size:====
{{table373|
Optional. Defines the size of the animation. All animations will be scaled to match this size.

*Syntax: '''Integer''' horizontal size, '''Integer''' vertical size
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Talking Head:|+Talking Head:]]
}}

====List Start Offsets:====
Optional. Defines the screen coordinate offsets for the start of the Directives list.

*Syntax: '''Integer''' x, '''Integer''' y
*Units: Pixels

Used by: [[Hud_guages.tbl#+Directives:|+Directives:]]

====Entry Height:====
Optional. Defines the height of each Directive

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_guages.tbl#+Directives:|+Directives:]]

====Alt Ballistic Offsets:====
Opetional. Defines the screen coordinate offsets for headers of ballistic weapons

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Header Offset:|+Header Offset:]]

====Top Primary Background X-offset:====
Optional. Defines the screen coordinate offset for the Top Primary Background

*Syntax: '''Integer'''
*Units: Pixels
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic X-offset:|Alt Ballistic X-offset:]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Text X-offset:====
(Optional) Defines the screen coordinate X-offset for weapon labels

*Syntax: '''Integer'''
*Units: Pixels
*Valid Sub-entries:
:[[Hud_gauges.tbl#Alt Ballistic X-offset:|Alt Ballistic X-offset:]]

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Alt Ballistic X-offset:====
Optional. Defines the screen coordinate X-offset for ballistic weapons

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#Top Primary Background X-offset:|Top Primary Background X-offset:]], [[Hud_gauges.tbl#Text X-offset:|Text X-offset:]]

====Top Primary Frame Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Top Secondary Frame Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary List Start Y-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Start Y-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Ammo X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Link X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Name X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Ammo X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Linked X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Name X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Reload X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Entry Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Entry Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====3 Digit Hull Offsets:====
Designates the screen position offsets for the hull damage % when it is the 3 digit range (i.e. >= 100%)

*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Mini Target Shields:|+Mini Target Shields:]]

====2 Digit Hull Offsets:====
Designates the screen position offsets for the hull damage % when it is the 2 digit range (i.e. 100% > hull damage% >= 10%)

*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Mini Target Shields:|+Mini Target Shields:]]

====1 Digit Hull Offsets:====
Designates the screen position offsets for the hull damage % when it is the 1 digit range (i.e. 10% > hull damage% >= 0%)

*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Mini Target Shields:|+Mini Target Shields:]]

====Objective Text Y-offset:====
Designates the screen position offset for the Objective label

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Objective Value Y-offset====
Designates the screen position offset for the Objective value

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Subspace Text Y-offset:====
Designates the screen position offset for the Subspace label

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Subspace Value Y-offset====
Designates the screen position offset for the Subspace value (?)

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Red Alert Text Y-offset====
Designates the screen position offset for the Red Alert label

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Red Alert Value Y-offset====
Designates the screen position offset for the Red Alert value (?)

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Command X-offset:====
*Syntax: '''Integer''' x offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Squad Message:|+Squad Message:]]

====Page Up Offsets:====
*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Squad Message:|+Squad Message:]]

====Page Down Offsets:====
*Syntax: '''Integer''' x offset, ''' Integer y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Squad Message:|+Squad Message:]]

====Entry Height:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Entry Stagger Width:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Header Text:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Header Offsets:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====List Start Offsets:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Hull X-offset:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Name X-offset:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Status X-offset:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Ship Name Max Width:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Right-Align Ship Names:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Foreground Clip Height:====

* Sets the height, in pixels, of the gauge.
** For the [[Hud_gauges.tbl#+Throttle|Throttle]], sets the height of the gauge that represents 0% to 100% throttle. The total height of the gauge is the sum of this value and the [[Hud_gauges.tbl#Afterburner Clip Height:|Afterburner Clip Height]] value.
* Syntax: '''Integer'''

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]], [[Hud_gauges.tbl#+ETS Weapons:|+ETS Weapons]], [[Hud_gauges.tbl#+ETS Engines:|+ETS Engines]], [[Hud_gauges.tbl#+ETS Shields:|+ETS Shields]], [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor]], [[Hud_gauges.tbl#+Afterburner Energy|+Afterburner Energy]], [[Hud_gauges.tbl#+Weapon Energy|+Weapon Energy]], [[Hud_gauges.tbl#+Throttle:|+Throttle]]

====Letter Offsets:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Top Offsets:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Bottom Offsets:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Gauge Offset:====
*Distance between the individual weapon/shield/engine ETS gauges that comprise this gauge
*Syntax: '''Integer'''

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Monitor Filename:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Integrity Bar Filename:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Viewport Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Viewport Size:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Integrity Bar Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Integrity Bar Foreground Clip Height:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Status Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Name Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Class Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Speed Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Hull Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Cargo Contents Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Cargo Scan Start Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Cargo Scan Size:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Bracket Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Dock Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Dock Max Width:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Order Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Order Max Width:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Time Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Radar Center Offsets:====
Defines the radar's plot origin as an offset, in pixels, from this gauge's [[Hud_gauges.tbl#Position|Position]] coordinates
*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

====Radar Size:====
Size, in pixels, of the radar plot area.

Syntax: '''Integer''' horizontal size, '''Integer''' vertical size

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

====Infinity Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

Offset to draw the infinity radar range symbol.

====Long Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

Offset to draw the long range radar text (i.e. 10k).

====Short Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

Offset to draw the short range radar text (i.e. 2k).

====Size:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====XY Disc Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====XZ YZ Disc Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Sweep Disc Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Default Contact Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Unknown Contact Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Loop Volume:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG]]

====Minimum Beep Delay:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG]]

====Firepoint display:====
Displays the positions of the gun firepoints on your ship
*Syntax: '''Boolean''', YES or NO

NOTE: The position of the firepoints is calculated from the Eye Point position in the POF. You may encounter weird results if you have no Eye Point defined, but no debug warnings will be raised.

Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Firepoint size:====
Diameter of the gunpoint circles. '''Must be 4 or greater''' in order to work properly.
*Syntax: '''Integer'''

Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Firepoint X coordinate multiplier:====
Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Firepoint Y coordinate multiplier:====
Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Foreground Clip Bottom Y-offset:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Foreground Clip Width:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Afterburner Clip Height:====
* Sets the area of the throttle gauge that represents the Afterburner segment (which is on top of the 0% to 100% area). The total height of the gauge is determined by the sum of this value and [[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]]

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Show Background:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Max Speed Label Offsets:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Min Speed Label Offsets:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Orbit Center Offsets:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Orbit Radius:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Arc Filename:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Needs to be an [[Multimedia_Files#ANI|ani]] with a least 2 frames (but only the 2nd frame is used ?!?!? for threat & weapon linking so far)

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Dumbfire Filename:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Needs to be an [[Multimedia_Files#ANI|ani]] with a least 2 frames. The 1st frame is "no warning", the rest of the frames are cycled through when a warning is active.

Internally FSO also refers to this as the "laser threat warning".

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Lock Filename:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Needs to be an [[Multimedia_Files#ANI|ani]] with a least 2 frames. The 1st frame is "no warning", the rest of the frames are cycled through when a warning is active. Frames cycle twice as fast when a lock has been acquired, compared to when a lock is being acquired.

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Dumbfire Offsets:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Lock Offsets:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Lock Filename:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Locked Filename:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Lock Center Offsets:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Locked Center Offsets:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Radius:====
Defines the distance from the center of the screen to the base of the Hostile Triangle gauge.

*Syntax: '''Integer'''
*Default value:
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Hostile Triangle:|+Hostile Triangle:]]

====Triangle Base:====
Defines the width of the Hostile Triangle's base.

*Syntax: '''Float'''
*Default value:
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Hostile Triangle:|+Hostile Triangle:]]

====Triangle Height:====
Defines the height of the Hostile Triangle.

*Syntax: '''Float'''
Default value:
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Hostile Triangle:|+Hostile Triangle:]]

====Center Offsets:====

Used by: [[Hud_gauges.tbl#+Lead Indicator:|+Lead Indicator:]]

====Single Primary Filename:====
Designates the file to use for primary linking for ships with a single primary bank.

Needs to be an [[Multimedia_Files#ANI|ani]] with 2 frames; 1st is bank 1 not selected (not that this should ever be able to happen), 2nd is bank 1 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Primary Filename:====

Designates the file to use for primary linking for ships with two primary banks.

Needs to be an [[Multimedia_Files#ANI|ani]] with 4 frames:
* Frame 0 is no banks selected
* Frame 1 is 1st bank selected
* Frame 2 is 2nd bank selected
* Frame 3 is both banks selected/linked

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Single Secondary Filename:====

Designates the file to use for selected secondary bank for ships with a single secondary bank.

Needs to be an [[Multimedia_Files#ANI|ani]] with 2 frames; 1st is bank 1 not selected, 2nd is bank 1 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Secondary Filename:====

Designates the file to use for selected secondary bank for ships with two secondary banks.

Needs to be an [[Multimedia_Files#ANI|ani]] with 3 frames; 1st is no banks selected, 2nd is bank 1 selected, 3rd is bank 2 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Triple Secondary Filename:====

Designates the file to use for selected secondary bank for ships with two secondary banks.

Needs to be an [[Multimedia_Files#ANI|ani]] with 4 frames; 1st is no banks selected, 2nd is bank 1 selected, 3rd is bank 2 selected, 4th is bank 3 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Single Primary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Primary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Single Secondary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Secondary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Triple Secondary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Hidden By Comms Menu:====
{{Table3615|
Defines whether the messages gauge may be drawn at the same time as the wingman comms menu.
*Syntax: '''Boolean'''
*Default Value: '''false''' (messages are not visible while the comms menu is open)
Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]}}

====Bottom Background Offset:====
{{Table3615|
Defines the vertical pixel offset added to the position of the bottom background frame.
*Syntax: '''Integer''' vertical offset
*Units: Pixels
Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]}}

====Center Text On Gauge X-Position:====
{{Table375|
Sets whether to position the center of the text to the gauge's X-position.
*Syntax '''Boolean'''
*Default Value: '''false''' if the gauge is explicitly given a position, '''true''' otherwise
Used by: [[Hud_gauges.tbl#+Fixed Messages:|+Fixed Messages:]]}}

[[Category:Tables]]