hud.setFieldWidth 2

Reserves a fixed width for the field's value text, so a number that changes often does not make the rest of the bar shift around. Creates the field if it does not exist yet.


Return value

Return TypeDescription
voidThis function doesn't return anything

Parameters

ParameterTypeDescription
1stringIdentifier of the field.
2floatWidth reserved for the value text, in canvas units of a 1280x720 reference. Pass a negative value to go back to automatic sizing.

Examples

Custom conquer bar

-- Replace the vanilla conquer bar with two fields of our own.
-- Runs on every client: no network sync needed.

hud.setVanillaBar(false)   -- hide flags, tickets and capture squares
hud.setPhases(false)       -- this mission does not advance through phases

local wave = 1
local left = 12

local function refresh()
    hud.setField("wave", "hud_icon_wave", "Wave " .. wave)
    hud.setField("enemies", "hud_icon_enemy", tostring(left))

    -- keep the counter from making the bar jump as digits change
    hud.setFieldWidth("enemies", 60)

    -- turn the counter red when the position is about to fall
    if left <= 3 then
        hud.setFieldColor("enemies", 1, 0.35, 0.35)
    else
        hud.setFieldColor("enemies", 1, 1, 1)
    end
end

refresh()

Back to Scripting API