ACSUtils Wiki

An ACS library for ZDoom-based ports

User Tools

Site Tools


HUD coordinate system

ZDoom uses a special coordinate system for HudMessages. In 4:3 resolutions, the coordinate system's rectangle matches that of the screen. In aspect ratios other than that, a 4:3 rectangle is put at the center of the screen and the remaining screen space is out of its boundaries.

The HUD coordinate system's rectangle width and height are specified in SetHudSize.

ACSUtils provides functions to correctly work with the HUD coordinate system.

All functions here work with fixed-point numbers. The restriction on integers in ZDoom is completely arbitrary.

Retrieve aspect ratio

GetAspectRatio returns the aspect ratio that ZDoom assumes the screen is. ZDoom uses tricky code for that.

Actual screen boundaries

HudLeftFor, HudRightFor, HudTopFor and HudBottomFor return actual screen boundaries in the HUD coordinate system for the specified width and height of the HUD coordinate system, taking the current aspect ratio into account.

To avoid specifying a width or height every time, you can call HudSetVirtualSize once and then call HudLeft, HudRight, HudTop and HudBottom.

HUD borders

Borders are the areas of the screen that are not covered by the aforementioned rectangle. Horizontal and vertical border width can be retrieved using HudBorderXFor and HudBorderYFor.

As with screen boundaries, you can just call HudSetVirtualSize once and then use HudBorderX and HudBorderY without specifying the size of the HUD coordinate system every time.


Put a message in the top left corner of the screen:

HudSetVirtualSize(640.0, 480.0);
x = HudLeft(); // This will be negative in widescreen.
y = 0.0;
hud_coordinate_system.txt · Last modified: 2017/04/18 16:39 by korshun