
              Falcon's Eye 1.9.4 -- General information

Falcon's Eye is an enhanced, highly graphical window port (user
interface) for NetHack. Falcon's Eye does not change the content or 
gameplay of NetHack, but adds a lot of 'eye candy' to the game. 
Here's a brief list of features:

o High-res, 256-color isometric graphics with real-time lighting 
o Customizable digitized sound effects 
o Symphonic MIDI soundtrack
o Mouse-driven interface (keyboard play also works)
o Interface aids (including autopilot and mouseover identification)
o Customizable command keys
o HTML manual 

Falcon's Eye is available for DOS, Windows, Linux/Unix and BeOS 
systems. The current release adds BeOS support, fixes some bugs, 
and adds new graphics and features. Please see the Falcon's Eye 
web site at http://www.hut.fi/~jtpelto2/nethack.html for the 
latest news about Falcon's Eye.

                        - - - - - - - - - - -

               Notes specific to version 1.9.4 of Falcon's Eye
                       Jeroen Demeyer, April 12, 2003

Falcon's Eye is a work of Jaakko Peltonen.  But the update from version 1.9.3
to 1.9.4 was done by me (Jeroen Demeyer), as Jaakko didn't have much time to
work on Falcon's Eye lately.

This is a list of the changes I made from 1.9.3 to 1.9.4:
- Updated from NetHack 3.3.1 to NetHack 3.4.1
- Major update to logging.  Now all logging is centralized in one function
  jtp_write_log_message in jtp_gen.c.  This function now also has a printf-like
  syntax.  Changed/clarified/fixed/enabled most of the logging messages.
- Falcon's Eye now uses NetHack's travel command, instead of an own autopilot
  routine.  This also simplifies keyboard/mouse handling code quite a bit.
- Changed some tiles assignments.  Also used 2 new tiles for Level Teleporters
  and Magic traps, these tiles were already present in the PCX files version
  1.9.3, but they were not used.
- In general, tried to make NetHack a bit more independent from Falcon's Eye.
  With this distribution, you should also be able to compile any other NetHack
  window port, as well as Falcon's Eye.  tty support is no longer compiled in
  with Falcon's Eye, it wasn't working anyway.  Also moved the jtp-specific
  header files from include to win/jtp.
- Implemented new NetHack option vary_msgcount to change the number of message
  lines displayed on the screen.
- Some minor adjustments to gamedata/config/jtp_snds.txt and
  gamedata/defaults.nh
- Probably more smaller changes.

Note that I tested and built Falcon's Eye mainly on a Windows machine.  I also
tried it for DOS and Linux, but I did not test it much on those platforms.
I have NOT done anything with BeOS, so that probably won't work.  Anyone who
wants to try it on BeOS, should probably just change the Makefiles.

  Windows specific:
As I had trouble getting NetHack compiled under Windows, I decided to compile
it under MinGW with MSYS.  MSYS is a Unix-like environment, using bash as
shell.  For that purpose I made a new Makefile in sys/winnt/Makefile.msys.
This is the only Windows Makefile updated for Falcon's Eye.  People who wish
to compile it with any other Makefile, will first have to change it for
Falcon's Eye.  I do not recommend re-using Makefiles from Falcon's Eye 1.9.3,
as quite a bit of the Windows build process was changed in NetHack 3.4.
						
                        - - - - - - - - - - -

Please read the README file for general information about NetHack, and
compilation instructions.

In general, you should follow the instructions from the NetHack README file
to compile Falcon's Eye.  For Windows, you will need DirectX 3.0 or later.
For Linux, you need at least version 1.2 of the SDL libraries.  You can get
these from http://www.libsdl.org/

Falcon's Eye adds these directories to the standard NetHack distribution:

    a.  A 'win/jtp' subdirectory, which contains files specific to Falcon's Eye.
    b.  A 'win/jtp/gamedata' subdirectory, which contains data files specific 
        to Falcon's Eye.
    c.  A 'win/jtp/gamedata/config' subdirectory, which contains config files 
        specific to Falcon's Eye.
    d.  A 'win/jtp/gamedata/graphics' subdirectory, which contains graphics 
        files for Falcon's Eye.
    e.  A 'win/jtp/gamedata/sound' subdirectory, which contains sound and
        music files for Falcon's Eye.
    f.  A 'win/jtp/gamedata/manual' subdirectory, which contains the game 
        manual files for Falcon's Eye.
						
                        - - - - - - - - - - -

If you have problems building a version of NetHack with the Falcon's Eye
window port, or you find bugs in the window port, its developer 
(Jaakko Peltonen) may be reached at

                     jaakko.peltonen@hut.fi

In your correspondence, try to include as much information about the 
problem as you can find: for example, your system configuration, 
where and how exactly the problem occurred, what the game's log files 
contain, etc. The more I know about the problem, the more likely I am 
to find a solution. However, please do not send binary files unless
requested (they fill up a mailbox very quickly).

I also welcome suggestions, critique and questions about the window 
port: if you have ideas, send them in.

If you still have problems building the game, or you find bugs in the 
actual game (instead of Falcon's Eye), the NetHack development team may 
be reached at

                    nethack-bugs@nethack.org

