VAXMaster - Dungeon Master for OpenVMS VAX =========================================== CSBwin 15.7 ported to OpenVMS 7.3 VAX with pure DECWindows/Xlib. No SDL dependency. CSBwin is Paul R. Stevens' re-implementation of the Atari ST Dungeon Master and Chaos Strikes Back game engines. This port replaces the SDL platform layer with direct Xlib calls, making it run natively on any VAX with DECWindows Motif installed. Tested on MicroVAX 3900 (SIMH) running OpenVMS 7.3 with DECWindows Motif 1.2-6. PREREQUISITES ------------- o OpenVMS 7.3 (or earlier) on VAX hardware or emulator o DEC C++ V5.6 (CXX) or later o MMK or MMS build utility o DECWindows Motif (standard with OpenVMS 7.3) - SYS$SHARE:DECW$XLIBSHR.EXE - DECW$INCLUDE: (X11 headers) o An X11 display server (local DECWindows console, or a remote X server such as XQuartz, Xming, or VcXsrv) Not required: SDL, GLib, GTK, or any third-party libraries. GAME DATA FILES --------------- You need the original Dungeon Master data files: DUNGEON.DAT The dungeon definition GRAPHICS.DAT Tile graphics and sprites These are included - Arrrrrrrr! maties. These files must be transferred in BINARY mode (FTP TYPE I) and placed in the same directory as CSBWIN.EXE, or in a directory specified with the --directory option. For Chaos Strikes Back, substitute the CSB data files instead. BUILDING -------- Transfer all source files to a VMS directory in TEXT mode (FTP TYPE A). The data files (*.DAT) must be transferred separately in BINARY mode. The recommended build procedure: $ SET DEFAULT device:[directory] ! where the sources are $ @CONFIGURE.COM $ @BUILD.COM CONFIGURE.COM checks the environment (compiler, build utility, DECWindows, line endings) and writes BUILD.COM. Alternatively, if you know MMK is available: $ MMK/IGNORE=WARNING /IGNORE=WARNING is required, not cosmetic. The 1990s C++ engine code generates many warnings under DEC CXX V5.6 that are harmless but would otherwise stop the build. A clean build compiles approximately 42 source files and takes several minutes on a simulated MicroVAX. The MD5C.cpp module compiles with /NOOPTIMIZE because the VAX optimiser can run for hours on its unrolled bitwise operations. The output is CSBWIN.EXE. RUNNING ------- First, set up the X11 display. If using a remote X server: $ SET DISPLAY/CREATE/NODE=your.ip.address/TRANSPORT=TCPIP/SERVER=0 If using the local DECWindows console, the display is already set. Then run the game: $ RUN CSBWIN Or define a foreign command: $ CSBWIN :== $device:[directory]CSBWIN.EXE $ CSBWIN To use game data files from a different directory: $ CSBWIN "--directory" "DKA0:[GAMES.DM]" Note the double quotes around the option and its argument - DCL uppercases unquoted tokens. The game window is 640x400 pixels (320x200 doubled). KEYBOARD CONTROLS ----------------- Arrow keys Move / turn Mouse Interact with objects and the game interface Enter Confirm selections Escape Cancel / back qweasd Movement keys m Auto mapper AUDIO ----- Sound is not available on this port. VAX VMS 7.3 has no standard PCM audio output facility. FILES SPECIFIC TO THIS PORT --------------------------- These files were created or significantly modified for VAXMaster. All other .cpp and .h files are the original CSBwin 15.7 engine sources with only minimal changes for DEC CXX V5.6 compatibility. CSBvax.cpp Main program, X11 window/event/timer, blitter. Replaces CSBlinux.cpp. VAXLinCSBUI.cpp UI callbacks (UI_SetDIBitsToDevice, message boxes, command-line parsing). Replaces LinCSBUI.cpp. VAXAudio.cpp Audio stubs (Mix_OpenAudio, Mix_LoadWAV, etc.). VAXAudio.h Replaces SoundMixer.cpp/SoundMixer.h. stdafx.h Modified: X11 include ordering, uppercase Xlib function macros for DECW$XLIBSHR, CursorShape and NoValue #undef after X11 headers. csbglib.h GLib replacement providing typedefs (gint8, etc.), G_BYTE_ORDER, logging functions. Shared with the Alpha port but with VAX-specific additions: typedef int bool, #define inline to nothing. vmsglib.h One-line include of csbglib.h (VMS alias). CSBTypes.h Modified: i64/ui64 are 32-bit on VAX (no long long). LE16() made static. CSB.h Modified: forward struct declarations added before RESTARTABLE block; struct keyword added to bare TEXT * parameters; RoomType() made static. DESCRIP.MMS MMK/MMS build file. Tailored for VAX CXX V5.6. CSBWIN.OPT Linker options: DECW$XLIBSHR and CXXL$011_SHR. CONFIGURE.COM Environment probe and BUILD.COM generator. BUILD.COM Generated by CONFIGURE.COM. Simple MMK wrapper. TECHNICAL NOTES --------------- DEC CXX V5.6 Compatibility This compiler predates the C++98 standard. Key workarounds: o "inline" is #defined to nothing on VAX. Functions that must be in headers (logging, LE16) are declared "static" to avoid DUPGLOBAL errors when the same inline function appears in multiple translation units. o "bool" is typedef'd to int, with true=1 and false=0. o Variadic macros are not supported. Mix_SetError is implemented as a static function instead. o The /NAME=(AS_IS,SHORTENED) flag preserves mixed-case external names. SHORTENED hashes long C++ mangled names that would otherwise be truncated. DECWindows / Xlib Symbol Names DECW$XLIBSHR.EXE exports all public symbols in UPPERCASE (XOPENDISPLAY, XCREATEWINDOW, etc.). With /NAME=(AS_IS), the compiler generates mixed-case references (XOpenDisplay) that the linker cannot resolve. stdafx.h contains #define macros that map each X11 function name to its uppercase form BEFORE the X11 headers are included, so both the declarations and the call sites use the uppercase names. Rendering Pipeline The engine renders into a 320x200 four-bit-per-pixel Atari ST framebuffer. WinScreen.cpp unpacks this into 16-bit RGB565 pixels and scales by screenSize (2) using its BLT functions, producing a 640x400 bitmap. CSBvax.cpp's VAX_BlitToWindow() converts each RGB565 pixel to the X visual's format via a 65536-entry lookup table and copies it 1:1 into the XImage. XPutImage pushes the result to the window. X11 Macro Conflicts The X11 headers define macros that collide with CSBwin engine identifiers: - CursorShape (X11 extension opcode = 0) - NoValue (X parsing flag = 0x0000) Both are #undef'd after the X11 includes in stdafx.h. Structure Packing The engine uses #pragma nomember_alignment in several files to overlay C structures onto the Atari ST's little-endian disk format. The command-line flags do NOT include /NOMEMBER_ALIGNMENT - packing is controlled per-file. 64-bit Integers VAX has no 64-bit integer type. i64 and ui64 are typedef'd to 32-bit (i32 / ui32). The engine uses these only for statistics counters and checksums where the truncation is acceptable. MD5 Optimisation md5C.cpp contains heavily unrolled bitwise rotation operations that cause the VAX code generator to run for hours. It is compiled with /NOOPTIMIZE. MD5 performance is not critical to gameplay. KNOWN ISSUES ------------ o CXXL$THROW_IMMEDIATE appears as an unresolved symbol at link time. This does not affect runtime because the engine does not throw C++ exceptions. o No audio output. Sound effects and music are silently discarded. CREDITS ------- Original Dungeon Master and Chaos Strikes Back FTL Games (Doug Bell, Andy Jaros, Wayne Holder), 1987-1989 CSBwin engine (re-implementation from Atari ST disassembly) Paul R. Stevens, 2000-2015 http://dmweb.free.fr/ VAXMaster port (DECWindows/Xlib, VAX CXX V5.6 adaptation) astr0baby, 2026 The Dungeon Master community at dmweb.free.fr has been invaluable for documentation, data files, and discussion of the game's internals.