git.mutantstargoat.com Git - dosdemo/blob - README.md

   1 Building and running on DOS
   2 ---------------------------
   3 Make sure you have Watcom or OpenWatcom installed, and the appropriate env-vars
   4 set (the watcom installer automatically adds them to autoexec.bat by default).
   5
   6 Run wmake to build. Needs dos4gw.exe in current dir.
   7
   8 The demo requires VESA Bios Extensions (VBE) 2.0. If your graphics card doesn't
   9 support VBE 2.0 or greater, then make sure to run the `univbe` TSR first, or
  10 the demo will fail to find a usable LFB video mode.
  11
  12
  13 Cross-compile on GNU/Linux
  14 --------------------------
  15 source owdev script with contents (change WATCOM var as necessary):
  16
  17   export WATCOM=$HOME/devel/ow
  18   export PATH=$WATCOM/binl:$PATH
  19   export INCLUDE=$WATCOM/h:$INCLUDE
  20
  21 Run wmake to build. Needs dos4gw.exe and wstub.exe in current dir or PATH
  22
  23 Simply running ./demo.exe might invoke magic of the ancients to start wine,
  24 which will in turn start dosbox, which will execute the DOS binary! If the gods
  25 are slumbering in valhalla, just typing `dosbox demo.exe` should do the trick.
  26
  27
  28 SDL backend
  29 -----------
  30 Run make to build (assuming make on your system is GNU make).
  31
  32 The SDL backend will scale the framebuffer up, by the factor specified in the
  33 `FBSCALE` environment variable. So run the demo as: `FBSCALE=3 ./demo` for
  34 a 3x scale factor, or just export the `FBSCALE` env var in the shell you are
  35 going to use for running the demo. The default scale factor is 2x.