Index of /VAX/OpenVMS_7.3/VAXMaster/

NameLast ModifiedSizeType
../ -  Directory
VAXMaster/2026-Nov-10 23:36:26-  Directory
CSBWIN.EXE2026-Nov-10 23:39:25905.5Kapplication/x-msdos-program
README.txt2026-Nov-11 22:24:228.6Ktext/plain; charset=utf-8
VAXMaster.zip2026-Nov-10 23:39:041.1Mapplication/zip
    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.

Webserver 1.0