From: nethack.allison Date: Sun, 10 Mar 2002 19:07:17 +0000 (+0000) Subject: Some win32 updates X-Git-Tag: MOVE2GIT~3009 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=2960dc93c0bd508f333d48ff227fca9411befc08;p=nethack Some win32 updates (There will be a couple more patches to follow in a bit) --- diff --git a/Files b/Files index 17e403a49..76fac0b50 100644 --- a/Files +++ b/Files @@ -174,7 +174,7 @@ sys/winnt: (files for Windows 9x, NT and Windows2000 version) console.rc defaults.nh Install.nt Makefile.bcc Makefile.gcc Makefile.msc mapimail.c nethack.def nhico.uu nhsetup.bat -ntsound.c nttty.c win32api.h winnt.c +ntsound.c nttty.c porthelp win32api.h winnt.c util: (files for all versions) diff --git a/sys/winnt/porthelp b/sys/winnt/porthelp new file mode 100644 index 000000000..332753f71 --- /dev/null +++ b/sys/winnt/porthelp @@ -0,0 +1,221 @@ + Microsoft Windows specific help file for NetHack 3.4.0 + Copyright (c) NetHack PC Development Team 1993-2002. + NetHack may be freely distributed. See license for details. + (Last Revision: March 10, 2002) + +This file details specifics for NetHack built for Windows 95, 98, NT, +Me, 2000, and XP. Users of really early 16-bit Windows versions should +use the MSDOS NetHack. + +Please note that "NetHack for Windows - Graphical Interface" requires +an installation of Internet Explorer 4 or an installation of +version 4.71 of the common controls. See the following internet page: + http://www.nethack.org/v340/ports/download-win.html#cc +for more information. If the game runs for you, you are not affected. + +New players should be sure to read GuideBook.txt which contains +essential information about playing NetHack. It can be found in the +same directory as your NetHack executable. + +The Windows port of NetHack supports some additional or enhanced +commands as well as some defaults.nh file options specific to +configuration choices used during the building of NetHack for +Windows. Listed below are those commands and defaults.nh file +options. + +Some options are applicable only to the graphical port. +These are discussed separately in their own section. + +Contents +1. Boolean options +2. Graphical Port Complex options +3. Graphical Port Additional/Enhanced Commands +4. Available ALT Key Combinations +5. Graphical Port Menus + +1. Boolean Options +------------------ + +Listed here are any options not discussed in the main help, options +which may be slightly different from the main help file, and options +which may need a slightly more explanatory note: + + color Use color when displaying non-tiled maps. Tiled + maps (available in the graphical port) are always + rendered in color. Default: [TRUE] + + IBMgraphics Use IBM extended characters for the dungeon + Default: [TRUE] + + use_inverse Use inverse color for detection (similar to hilite_pet). + Default: [FALSE] + + msg_window When ^P is pressed, it shows menu in a full window. + Default: [FALSE] + + +2. Graphical Port Complex Options +--------------------------------- + +"NetHack for Windows - Graphical Interface" recognizes the following +additional options, which the non-graphical (tty) version will +silently ignore: + +Window Alignment options: + + | + align_message Specifies at which side of the NetHack screen the + message window is aligned. This option can be used + to align the window to "top" or "bottom". "left" + or "right" are possible, but not properly supported + in the Microsoft Windows port. Default: [TOP] + + align_status Specifies at which side of the NetHack screen the + status window is aligned. This option can be used + to align the window to "top" or "bottom". "left" + or "right" are possible, but not properly supported + in the Microsoft Windows port. Default: [BOTTOM] + +Other Window options: + +These are options that specify attributes of various windows. +These include the menu windows (such as the inventory list), +the text windows (such as "It is written in the book of ..." +screens), the message window (where events of the game are +displayed), and the status window (where your character name +and attributes are displayed). + + font_menu Specifies the name of the menu font. + font_message Specifies the name of the message font. + font_status Specifies the name of the status font. + font_text Specifies the name of the text font. + + font_size_menu Specifies the size of the menu font. + font_size_message + Specifies the size of the message font. + font_size_status + Specifies the size of the status font. + font_size_text + Specifies the size of the text font. + +Map Window options: + + map_mode Specifies which map mode to use. + The following map modes are available: + tiles (uses tiles to display things on the map), + ascii4x6ascii6x8, ascii8x8, ascii16x8, ascii7x12 + ascii8x12, ascii16x12, ascii12x16, ascii10x18 + (which use that size font to display things on + the map), or fit_to_screen (which forces things + to fit on a single screen display whether tiled + or ascii). Default: [tiles] + + scroll_margin Specifies the margin of scrolling the map. + Recommended to be set to 1 or greater. If set to + 80, this will keep your character centered on the map. + Default: [5] + + tile_file An alternative file containing bitmap to use for + tiles. This file should be a .bmp file and should + be organized as 40 rectangular tiles wide. It is + beyond the scope of this document to describe the + exact contents of each tile in the .bmp which may + even be dependent on the options that your version + of NetHack was built with. + + If you are interested in creating a tile file of + your own, create a regular build of NetHack using + the graphical version and examine the file tiles.bmp + in the src or build directory. This option may + only be specified in the defaults.nh config file. + Default: [default] + + tile_height Used with tile_file to specify the width of each + tile in pixels. This option may only be specified + in the defaults.nh config file. + Default: [16] + + tile_width Used with tile_file to specify the height of each + tile in pixels. This option may only be specified + in the defaults.nh config file. + Default: [16] + +Miscellaneous options: + + vary_msgcount Number of lines to display in message window. + + +3. Graphical Port Additional/Enhanced Commands +---------------------------------------------- + +The following function keys are active in +the "NetHack for Windows - Graphical Interface": + + F4 Toggle level overview mode on/off + This key will toggle the map between a view that + is mapped to fit exactly to the window, and the + view that shows the various symbols in their + normal size. This is useful for getting an idea + of where you are in a level. + + F5 Toggle tiled display on/off. + This key switches between the tiled and the + traditional ASCII display. This is equivalent to + using the "map_mode" option. + + F10 Activate menu bar. + This key will activate the menu bar, allowing you + to select between the menus: File, Map, + Window Settings, and Help. + +4. Available ALT Key Combinations +--------------------------------- + +While playing NetHack under Windows you can press the ALT key in +combination with another key to execute an extended command as an +alternative method to pressing a # key sequence. (The non-graphical +(tty) version is always running in NetHack mode, but +"NetHack for Windows - Graphical Interface" can be toggled): + + Alt-a adjust - adjust inventory letters. + Alt-c chat - talk to someone or something. + Alt-d dip - dip an object into something. + Alt-e enhance - enhance your skill with a weapon. + Alt-f force - force a lock. [works in NetHack mode only] + Alt-i invoke - invoke an object's powers. + Alt-j jump - jump to a location. + Alt-l loot - loot a box on the floor. + Alt-m monster - use a monster's special ability. + [works in NetHack mode only] + Alt-n name - name an item or type of object. + Alt-o offer - offer a sacrifice to the gods. + Alt-p pray - pray to the gods for help. + Alt-q quit - quit the game. (Same as #quit) + Alt-r rub - rub a lamp. + Alt-s sit - sit down. [works in NetHack mode only] + Alt-t turn - turn undead. + Alt-u untrap - untrap something. + Alt-v version - list compile time options for this version of + NetHack. + Alt-w wipe - wipe off your face. + +5. Graphical Port Menus +----------------------- + +File + Save - Allows you to save and exit the game + Quit - Allows you to quit the game + +Map - Provides for selection of map mode. Equivalent to using +the map_mode option. + +Window Settings - Changes your logged-on user's settings for +NetHack. In 3.4.0, only one setting is available: NetHack +mode (or not). NetHack mode allows you to use ALT-f, ALT-m, and ALT-s +for game key commands [see list above]. You can use F10 to +access the menu bar while in NetHack mode. You can also +clear your logged-on user's settings for NetHack. Settings +in this window are saved in your logged-on user's registry. + +Help - Provides help about various portions of NetHack. + diff --git a/win/win32/winhack.rc b/win/win32/winhack.rc index b842434b1..6d90a745c 100644 --- a/win/win32/winhack.rc +++ b/win/win32/winhack.rc @@ -310,7 +310,7 @@ END STRINGTABLE DISCARDABLE BEGIN - IDS_APP_TITLE "NetHack for Windows - Graphical Port" + IDS_APP_TITLE "NetHack for Windows - Graphical Interface" IDC_NETHACKW "NETHACKW" END