Installing UPIS

---

---

Preface

UPIS is an image server for UT2004. It uses the Microsoft Detours library to intercept the Direct3D? 8 calls that UT2004 uses to finalize its screen drawing. It then copies the display to an external buffer, and serves the image upon request to any clients.

UPIS can be either compiled directly from source, or installed using precompiled 32-bit binaries available for Windows XP and Vista. Due to restrictions on Microsoft Detours, the current version can only run in 32-bit mode.

If you have problems with installing or running UPIS, please check the FAQ.

Compiling source

Requirements

1. Windows XP or Vista (32-bit)
2. Visual Studio 2008

Directions

1. Download the most recent UPIS source release from here.
2. Unzip the archive to your directory of choice.
3. Open upis.sln using Visual Studio 2008.
4. Select Release from the Configuration list box.
5. Select Build > Build All.
6. After the build, you should find the upis.exe and upisdll.dll in the ./Release directory.
7. Copy FreeImage.dll and detoured.dll to the ./Release directory.
8. To run UPIS, see the instructions on Running the server.

Installing binaries

Requirements

1. Windows XP or Vista (32-bit)

Directions

1. Download the most recent UPIS binary release from here.
2. Unzip the archive to your directory of choice.
3. If not already installed, run the included vcredist08.exe to install the Visual C++ 2008 redistributable package.

Running the server

Requirements

1. Windows XP or Vista (32-bit)
2. Microsoft Visual C++ 2008 Redistrubutable
3. UT2004
4. UPIS binaries (from previous sections)

Directions

Before you run UPIS, please rename or delete any version of FreeImage.dll in the same directory as ut2004.exe. Old copies can override the version packaged with UPIS and cause linker errors.

1. Edit the run.bat in the directory with your UPIS binaries
2. Change the first parameter of upis.exe to the path to the ut2004.exe binary.
3. Change the second parameter of upis.exe to be the desired command-line options for ut2004.exe. Leave a space as the first character.
4. Save and close run.bat.
5. Execute run.bat. UT2004 should launch with the specified options.
6. To switch focus away from UT2004, use Ctrl+Esc. This will switch focus to the Start Menu, from which you can switch to other applications.

Notes

• It is often useful to copy the run.bat script and create variants for different maps/gametypes/options. This way, you can easily launch many different UT2004 configurations.
• To change the resolution of the image server, simply change the screen resolution in UT2004.
  1. Press ~ to open the console in UT2004.
  2. Type setres XRESxYRES to change the resolution (e.g. setres 640x480).
  3. Press ~ again to close the console.
• It is useful to run UT2004 in windowed mode to allow for quick tabbing in and out of the window.
  1. Press Esc to open the UT2004 menu.
  2. Go to Settings>Graphics.
  3. Select the checkbox labeled Windowed.
  4. Select Apply to switch UT2004 to windowed mode.