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

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

===== Description =====
Saves current [[:HUD library state]] to [[:HUD Library#state_stack|state stack]]. 

If the stack is full, a [[LimitError]] is emitted.

<note warning>Do not forget to call [[HudPopState]]. Otherwise the stack may fill up.</note>


===== 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>