What does the script do

The script extends huds based off of previously extended huds that look similar, but are just re-colored. Here are some examples of it in action. For this example, I will be using the 486x32 extended hud doom_wide.wad from OpenRift's Google Drive link: https://www.doomworld.com/forum/topic/121385-widescreen-assets-pack-and-appreciation-thread/

From this one extended hud, here are some examples of huds that the script can extend:

Haste

Fallen Leaves

Not Even Remotely Fair

Mayan Mishap

NOTE: This script works well for STBARs that copy a pre-existing STBAR with an extended hud made for it, such as the original DOOM STBAR. However, this is not the only use of this script, nor is this the exhaustive list of STBARs this script can work on. The output quality of the script heavily relies on the quality of the extended hud template (STBAR_doom.wad). For example, the usage of this different extended HUD for Ultimate DOOM will affect the output of the program: https://github.com/bangstk/doom-wad-autoloads/blob/main/autoload/doom-all/doom-all_bar_uwide21.wad

Example of this different 576x32 statusbar being used as a different input on Mayan Mishap

Different output than above example of Mayan Mishap

Installation

This Python script requires Python to run, download here: https://www.python.org/downloads/

Installing pip

After installing Python, you need to install pip. Open Command Prompt or PowerShell and run the following command:

python -m ensurepip --upgrade

If that fails to install pip, try this command:

py -m ensurepip --upgrade

If that fails too, download get-pip.py from https://pip.pypa.io/en/stable/installation/. Open Command Prompt or PowerShell and change directory to where get-pip.py is located, then run either command in Command Prompt or PowerShell:

python get-pip.py

py get-pip.py

This Python script also requires two external Python libraries - opencv and numpy.

Installing numpy

To install numpy, open Command Prompt or PowerShell and run the following command: If you use macOS or Linux, just run it in Terminal pip install numpy

Installing opencv

To install opencv, open Command Prompt or PowerShell and run the following command: If you use macOS or Linux, just run it in Terminal pip install opencv-python

How to use the script

Once Python and the required libraries are installed, simply run stbar_converter.py in Python. The script REQUIRES two files in the same directory as the script:

1. An image named "STBAR.png". Case sensitive, and must be png. Must be 32 pixels in height. STBAR.png is the original STBAR from PWADs that is to be extended.
2. An image named "STBAR_doom.png". Case sensitive, and must be png. Must be 32 pixels in height and have a width greater than STBAR.png. STBAR_doom.png is the extended hud used to extend STBAR.

If everything runs correctly, the script will overwrite "STBAR.PNG" with the extended STBAR.