CPMA Super Hud

SuperHUD

Since the release of CPMA 1.34 we have had extremely configurable HUDs. This document explains some of the Client HUD settings for CPMA.

Note: cvars such as cg_drawfps, cg_drawtimer plus many others have been removed and their functions moved to the custom hud.

Creating a HUD .cfg

• ALL hud configs go in Quake3/cpma/hud. CPMA's sample HUDs 1-7 are also in that directory.
• You can select a config using \ch_file hud where 'hud' is the file you would like to use (without .cfg).
• You do NOT exec hud.
• Use \reloadHUD to reload your HUD if you have changed it. Must also be used after ch_file change.
• The default HUD is in the PK3: if you want to customise it, pull it out of there with the unzip utility of your choice, RENAME it, and put the copy in cpma/hud/. Remember to point ch_file at the new version.
• The default HUD references (nearly) everything that can be drawn. Hud7 has nice examples of decoration use.

Syntax

The syntax for CPMA's SuperHud is fairly easy to comprehend, and supports both multi-line and single-line arguments.

ELEMENT
{
    ELEMENT_COMMAND VALUE
    ELEMENT_COMMAND VALUE
}

ELEMENT { ELEMENT_COMMAND VALUE; ELEMENT_COMMAND VALUE; }

You can comment using # but // cannot be used.
Some Element Commands have optional "," separators.

Elements

Each piece of the HUD is called an ELEMENT. Elements are sorted z-layer-wise alphabetically.

The first element in the hudfile MUST be !DEFAULT, and every other element inherits from that default: this gives you an easy way to change fonts/colors/etc for a whole bunch of elements at once.

!DEFAULT can be reused later in the document affecting every following element but it will not overwrite the parameters set by previous !DEFAULT(s). It is advisable to place Team1-8 and Chat1-8 at the bottom of your hud config so that !DEFAULTs can be used without interfering with other elements.

Colors

CPMA HUD uses r g b a, which is red green blue alpha. Each channel can have values from 0-1.

Color 1 1 1 1 is white, full alpha
Color 0 0 0 0.5 is black, half transparent
Color 0.25 0.25 1 0.75 is blue, somewhat transparent

Note that colors set in SuperHUD do not override colors set elsewhere.
For example if your nick or name is "^3hello" it will be yellow regardless.

Special Colors

color T and color E for elements to use red/blue according to your current team.
Useful for flag modes, but not necessesary for tdm/1v1. Set bgcolor for these, even for images. See hud/old.cfg.

Element Commands

The commands you can use within an element are:

HUD Related CVars

These cvars do not directly influence the SuperHud but are still related to the HUD in some way.

Example for mvwTDM:

seta mvw_TDM1 "480 65 160 120"
seta mvw_TDM2 "480 190 160 120"
seta mvw_TDM3 "480 315 160 120"

Crosshair Cvars

Known Issues

• Color fails on elements with color codes embedded in their strings (StatusBar_HealthCount, StatusBar_ArmorCount, NetGraphPing, etc).
• Alpha fails on some elements containing images (StatusBar_AmmoIcon, StatusBar_ArmorIcon, etc).
• Fade fails on some elements containing images without alpha channels (ItemPickupIcon, etc).
• If a !DEFAULT sets MONOSPACE, FILL or DOUBLEBAR, there is no method to remove it again (so don't do it unless it's at the end of the file).
• color T and color E act funny when in non-teamplay modes such as 1v1.
• FILL plus bgcolor when used on elements that disappear without having TIME makes bgcolor remain indefinitely.
• Not implemented: cg_drawRewards element not included in SuperHUD.