====== HudPopState ======
{{tag>hud_library}}
''void HudPopState()''

[[:HUD Library|This is a HUD Library function.]]

===== Description =====
Restores saved [[:HUD library state]] from the [[:HUD Library#state_stack|state stack]] and removes it from the stack.

If the stack is empty, a [[ProgramError]] is emitted.

===== Examples =====
<code>
HudPushState();
// Change state
HudPopState(); // Back to saved state.
</code>

This function is not affected by current HUD Library state and doesn't overwrite it:
<code>
function DrawSomething(void)
{
    HudPushState();
    HudResetState();
    ...
    HudPopState();
}
</code>