readme.jon

游戏高空视野引擎源代码

 Height Field Engine Port V1.0              Jonathan Griffiths 25 Oct 1995
 =========================================================================

Hello there djgpp users!

This package is a port of a height field engine written for watcom using the 
wordup graphics toolkit version 5.1.  I have changed the source to use 
JLib V1.0 so it will now run under linux too.  JLib can be found at:

x2ftp.oulu.fi /pub/msdos/programming/djgpp2/jlib_1-0.zip

The original engine came with an order form for wgt and a list of the authors
other productions.  I have left this information intact in the directory
"original".  You can get the original package from:

x2ftp.oulu.fi /pub/msdos/programming/wgt/wgten1.zip

First let me say thanks to Chris Egerter for putting the source in the 
public domain.  Thanks Chris!

I have made a couple of changes to the original code,  mostly a couple of
simplifications and optimisations.  I think you will find the results quite
impressive.  To compile the engine,  assuming you have JLib installed for
a 320 x 200 target,  change to this directory and type the following:

DOS Users:
          gcc hfield.c -lj -lpc -lm -O3 <enter>
          strip a.out <enter>
          stubify a.out <enter>

          Now you can run it by typing:  a.exe <enter>
          A pre-compiled DOS binary (hfield.exe) is provided.

Linux Users:
          gcc hfield.c -lj -lvga -lvgagl -lm -O3 <enter>
          
          Now you can run it by typing:  a.out <enter> 
          Remember that you have to be setuid root to run svgalib programs.

If you are using JLib version 1.0 (which is the latest release version as I
write this) then you can make the menus better by copying the file popup.c
to your jlib/source/misc/ directory,  overwriting the existing version.  If
you remake the library before compiling the engine your popup menus will 
look much nicer.  The new version of popup.c formats strings containing 
newlines correctly.  The precompiled binary is built from the new popup.c.

Notes on running the precompiled executable:
     You must have cwsdpmi.exe in the path for the program to run,  or
be running under a DPMI host such as windows.  The program will auto-detect
whether DPMI is present and load cwsdpmi.exe if needed.  If you experience
problems running under Windows (for example,  the demo freezes at the first
menu),  you will need to create a .PIF for the executable (using the PIF 
editor in Windows),  and specify more memory for the program (around 300k low
minimum and 1 meg extended minimum should do it).  Of course,  if you are
running djgpp you know all about this!

Copyright Stuff:
     cwsdpmi is copyrighted free software.  You can get its source code from
http://www.delorie.com or ftp.delorie.com and its mirrors.  The stub program
attached to the executable is also copyrighted free software.  You can get
source code for the stub,  the program used to compile it,  and the whole
djgpp C/C++ development system from the same address.  cwsdpmi and djgpp are
brought to you by the hard work of great people like D J Delorie and Charles
Sandmann.  Thanks guys!


Enjoy yourselves,
             Jon Griffiths ([e-mail] untill jan '96)

p.s Please report your success or failure running the demo under OS/2,
    and whether you needed to do anything special to get it to run. Also
    if you failed to run the demo on a machine without a math coprocessor
    I would like to hear about it (I haven't figured out the v2 approach
    to fp emulation yet). Cheers!