1f6c1d0f42
The walls for the mines, gehennom, knox, and sokoban had been changed at the "tile"-level, with no awareness of the core game, or non-tile interfaces. - Expand the glyphs to include a set of walls for the main level as well as each of those mentioned above. Altars had been adjusted at the map_glyphinfo() level to substitute some color variations on-the-fly for unaligned, chaotic, neutral, lawful altars, and shrines. The tile interface had no awareness of the feature. - Expand the glyphs to include each of the altar variations that had been implemented in the display code for tty-only. This required the addition of four placeholder tiles in other.txt. Someone with artistic skill will hopefully alter the additional tiles to better reflect their intended purpose. Explosions had unique tiles in the tile window port, and the display code for tty tinkered with the colors, but the game had very little awareness of the different types of explosions. - Expand the glyphs to include each of the explosion types: dark, noxious, muddy, wet, magical, fiery and frosty. Pile-markers to represent a pile had been introduced at the display-level, without little to no awareness by the core game. - Expand the glyphs to include piletops, including objects, bodys, and statues. Recently male and female variations of tiles and monsters had been had been introduced, but the mechanics had been mostly done at the display-level through a marker flag. The window port interface then had to increment the tile mapped to the glyph to get the female version of the tile. - Expand the glyphs to include the male and female versions of the monsters, and their corresponding pet versions, ridden, detected versions and statues of them. Direct references to GLYPH_BODY_OFF and GLYPH_STATUE_OFF in object_from_map() in pager.c were getting incomplete results. - Add macros glyph_to_body_corpsenm(glyph) and glyph_to_statue_corpsenm(glyph) macros for obtaining the corpsenm value after passing the glyph_is_body() or glyph_is_statue() test. Other relevant notes: - The tile ordering in the win/share/*.txt tile files has been altered, other.txt in particular. - tilemap.c has had a lot of alterations to accommodate the expanded glyphs. Output that is useful for troubleshooting will end up in tilemappings.lst if OBTAIN_TILEMAP is defined during build. It lists all of the glyphs and which tile it gets mapped to, and also lists each tile and some of the references to it by various glyphs. - An array glyphmap[MAXGLYPH] is now used. It has an entry for each glyph, ordered by glyph, and once reset_glyphs(glyph) has been run, it contains the mapped symindex, default color, glyphflags, and tile index. If USE_TILES is defined during build, the tile.c produced from the tilemap utility populates the tileidx field of each array element with a glyph-to-tile mapping for the glyph. Later on, when reset_glyphmap() is run, the other fields of each element will get populated. - The glyph-to-tile mapping is an added field available to a window port via the glyphinfo struct passed in the documented interface. The old glyph2tile[] array is gone. The various active window ports that had been using glyph2tile[] have been updated to use the new interface mechanism. Disclaimer: There may be some bug fixing or tidying required in the window port code. - reset_glyphmap() is called after config file options parsing has finished, because some config file settings can impact the results produced by reset_glyphmap(). - Everything that passes the glyph_is_cmap(glyph) test must return a valid cmap value from glyph_to_cmap(glyph). - An 'extern glyph_info glyphmap[MAX_GLYPH];' is inserted into the top of only the files which need awareness of it, not inserted into display.h. Presently, the only files that actually need to directly reference the glyphmap[] array are display.c, o_init.c (for shuffling the tiles), and the generated tile.c (if USE_TILES is defined). - Added an MG_MALE glyphflag to complement the MG_FEMALE glyphflag. - Provide an array for wall colorizations. reset_glyphmap() will draw the colors from this array: int array wallcolors[sokoban_walls + 1]; The indices of the wallcolors array are main_walls (0), mines_walls (1), gehennom_walls (2), knox_walls (3), and sokoban_walls (4). In future, a config file option for adjusting the wall colors and/or an 'O' option menu to do the same could be added. Right now, the initializaton of the wallcolors[] array entries in display.c leaves the walls at CLR_GRAY, matching the defsym color. - Most of the display-level kludges for some of the on-the-fly interface features have been removed from map_glyphinfo() as they aren't needed any longer. These glyph expansions adhere more closely to the original glyph mechanics of the game. - Because the glyphs are re-ordered and expanded, an update to editlevel will be required upon merge of these changes.
INTRO ===== The "curses" windowport is a new text-based interface for NetHack, using high-level curses routines to control the display. Currently, it has been compiled and tested on Linux and Windows, but it should also be portable to a number of other systems, such as other forms of UNIX, Mac OS X, MSDOS, and OS/2. Some features of this interface compared to the traditional tty interface include: * Dynamic window resizing (e.g. maximizing a terminal window) * Dynamic configurable placement of status and message windows, relative to the map * Makes better use of larger terminal windows * Fancier display (e.g. window borders, optional popup dialogs) * "cursesgraphics" option for fancier line-drawing characters for drawing the dungeon - this should work on most terminals/platforms BUILDING ======== As of this writing code has been compiled on Linux and Windows. UNIX/Linux build instructions: Follow the instructions in sys/unix/Install.unx. By default, the Makefile is setup to compile against ncurses. Edit Makefile.src if you wish to compile against a different curses library, such as PDCurses for SDL. Windows build instructions: If you are using Mingw32 as your compiler, then follow the instructions in sys/windows/Install.windows with the following changes: * After running nhsetup, manually copy the file cursmake.gcc to the src/ subdirectory * Instead of typing "mingw32-make -f Makefile.gcc install" you will type "mingw32-make -f cursmake.gcc install" If you are using a different compiler, you will have to manually modify the appropriate Makefile to include the curses windowport files. GAMEPLAY ======== Gameplay should be similar to the tty interface for NetHack; the differences are primarily visual. This windowport supports dymanic resizing of the terminal window, so you can play with it to see how it looks best to you during a game. Also, the align_status and align_message options may be set during the game, so you can experiment to see what arraingement looks best to you. For menus, in addition to the normal configurable keybindings for menu navigation descrived in the Guidebook, you can use the right and left arrows to to forward or backward one page, respectively, and the home and end keys to go to the first and last pages, respectively. Some configuration options that are specific to or relevant to the curses windowport are shown below. Copy any of these that you like to your nethack configuration file (e.g. .nethackrc for UNIX or NetHack.cnf for Windows): # # Use this if the binary was compiled with multiple window interfaces, # and curses is not the default OPTIONS=windowtype:curses # # Set this for Windows systems, or for PDCurses for SDL on any system. # The latter uses a cp437 font, which works with this option #OPTIONS=IBMgraphics # # Set this if IBMgraphics above won't work for your system. Mutually # exclusive with the above option, and should work on nearly any # system. OPTIONS=cursesgraphics # # Optionally specify the alignment of the message and status windows # relative to the map window. If not specified, the code will default # to the locations used in the tty interface: message window on top, # and status window on bottom. Placing either of these on the right or # left really only works well for winder terminal windows. OPTIONS=align_message:bottom,align_status:right # # Use a small popup "window" for short prompts, e.g. "Really save?". # If this is not set, the message window will be used for these as is # done for the tty interface. OPTIONS=popup_dialog # # Specify the initial window size for NetHack in units of characters. # This is supported on PDCurses for SDL as well as PDCurses for # Windows. OPTIONS=term_cols:110,term_rows:32 # # Controls the usage of window borders for the main NetHack windows # (message, map, and status windows). A value of 1 forces the borders # to be drawn, a value of 2 forces them to be off, and a value of 3 # allows the code to decide if they should be drawn based on the size # of the terminal window. OPTIONS=windowborders:3 CONTACT ======= Please send any bug reports, suggestions, patches, or miscellaneous feedback to me (Karl Garrison) at: kgarrison@pobox.com. Note that as of this writing, I only have sporatic Internet access, so I may not get back to you right away. Happy Hacking! Karl Garrison March, 2009