IBMgraphics - Revision history

Furey: http -> https for nethack.org. nethack.org emits red-letter warning for http.

2024-06-20T23:41:51Z

http -> https for nethack.org. nethack.org emits red-letter warning for http.

WildPenguin: /* X11 (Legacy) */ linking to #about fonts

2023-12-05T16:47:36Z

‎X11 (Legacy): linking to #about fonts

WildPenguin: /* X11->X.Org */ Changing title to reflect it's called X.Org these days

2023-12-05T16:44:00Z

‎X11->X.Org: Changing title to reflect it's called X.Org these days

WildPenguin: /* About fonts */ A minor error corected (and highlighting xfd as a command inline)

2023-12-05T13:47:28Z

‎About fonts: A minor error corected (and highlighting xfd as a command inline)

WildPenguin: /* Configuring code page 437 */ Refactoring / re-organizing paragraph order and moving old instructions to the end, to make it easier to find relevant information. No information has been removed (and should not; perhaps moved to another page?)

2023-12-05T13:45:51Z

‎Configuring code page 437: Refactoring / re-organizing paragraph order and moving old instructions to the end, to make it easier to find relevant information. No information has been removed (and should not; perhaps moved to another page?)

WildPenguin: /* Configuring code page 437 */ Quite some refactoring, adding horizontal lines for readability (CP437 configuration is a huge paragraph, with many levels of subheadings)

2023-12-05T13:40:59Z

‎Configuring code page 437: Quite some refactoring, adding horizontal lines for readability (CP437 configuration is a huge paragraph, with many levels of subheadings)

WildPenguin: /* luit (general) */ tag tt -> pre

2023-12-05T13:21:21Z

‎luit (general): tag tt -> pre

WildPenguin: /* X11 */ luit general

2023-12-05T13:20:23Z

‎X11: luit general

Qt: cp437 emulation utility

2021-01-22T21:44:30Z

cp437 emulation utility

Ardub23: Minor improvements to section headers

2020-03-13T22:29:36Z

Minor improvements to section headers

@@ Line 214: / Line 214: @@
 You probably could also use luit (or konwert and filterm if you can find / install them for OS X) as in Linux X11 terminal applications, but for me luit didn't work well in Linux nor OS X on a public SSH nethack server.
-There is a packaging bug with the official Mac 3.6.0 package which omits the "symbols" file required for any symset to work. See the bug M360-1 in the [http://nethack.org/v360/bugs.html official Bugs page].  This file can be obtained from another port / source archive and copied into place as follows (in Terminal, you will need to type your superuser password):
+There is a packaging bug with the official Mac 3.6.0 package which omits the "symbols" file required for any symset to work. See the bug M360-1 in the [https://nethack.org/v360/bugs.html official Bugs page].  This file can be obtained from another port / source archive and copied into place as follows (in Terminal, you will need to type your superuser password):
 <code>sudo cp symbols /Library/NetHack/nethackdir/</code>

@@ Line 223: / Line 223: @@
 === X11 (Legacy) ===
 ----
 The following subsections are probably out of date and will <b>not</b> work on most modern distributions (which use UTF8 per default). They are currently left here in case you are using an old distribution.
 ==== Using <code>konwert</code>, <code>filterm</code>, or <code>cp437</code> (any terminal) ====

@@ Line 168: / Line 168: @@
 On the PuTTY Configuration window (this appears when you first start PuTTY), select "Translation" under the "Window" configuration in the pane on the left. Then, in the pulldown menu marked "Received data assumed to be in which character set", select "CP437". You can then log in to the server as usual.  You may also change this setting and then 'save' the session.  The character set (as well as other display settings, e.g., the color blue) will be used in your session from then on.
-=== X11 ===
+=== X.Org ===
 ----

@@ Line 182: / Line 182: @@
 You also need a font that provides the necessary characters. Generally, most fonts on modern distributions already contain the characters, but in case you are missing some, you may need to change your font.
- X11 already provides at least one such font: the "fixed" font. It is already the default font for xterm. To preview it or to check that you have it, use one of these xfd commands:
+X11 already provides at least one such font: the "fixed" font. It is already the default font for xterm. To preview it or to check that you have it, use one of these <tt>xfd</tt> commands:
 <pre>

@@ Line 148: / Line 148: @@
 On many platforms, it is possible to set the display device to display code page 437 instead of the default code page.  This will enable NetHack to display the IBMgraphics as the DevTeam intended.
-Make sure CONFIG.SYS contains a line similar to this:
+=== Windows NT, 2000, XP, and Vista (and newer?) ===
 ----
 ''This section may also apply to Windows 2003 Server, but is untested on this version.''
@@ Line 177: / Line 167: @@
 ----
 On the PuTTY Configuration window (this appears when you first start PuTTY), select "Translation" under the "Window" configuration in the pane on the left. Then, in the pulldown menu marked "Received data assumed to be in which character set", select "CP437". You can then log in to the server as usual.  You may also change this setting and then 'save' the session.  The character set (as well as other display settings, e.g., the color blue) will be used in your session from then on.
- unicode_stop
+=== X11 ===
 ----
 While most terminal programs for [[X11]] readily support [[DECgraphics]], they need additional setup for IBMgraphics. The usual way is to set the encoding to code page 437. The exact procedure to do this depends on the terminal program.
@@ Line 231: / Line 193: @@
 If you choose a font like Bitstream Vera Sans Mono, then X11 may substitute another font for some characters, causing graphical glitches if the two fonts have different monospace metrics.
 === X11 (Legacy) ===
@@ Line 311: / Line 300: @@
 It should be noted that the current default gnome-terminal font in Ubuntu Jaunty fully supports [[DECgraphics]] as long as eight_bit_tty is set to false.
-=== MAC OS X ===
+=== Linux console ===
 ----
-* Which font has all the symbols needed (don't know if Andale Mono has)
+Make sure CONFIG.SYS contains a line similar to this:
-* Is the rogue level corrupted?
+ C:\WINDOWS\COMMAND\display.sys con=(ega,,1)
-You probably could also use luit (or konwert and filterm if you can find / install them for OS X) as in Linux X11 terminal applications, but for me luit didn't work well in Linux nor OS X on a public SSH nethack server.
+and AUTOEXEC.BAT contains lines similar to these:
-There is a packaging bug with the official Mac 3.6.0 package which omits the "symbols" file required for any symset to work. See the bug M360-1 in the [http://nethack.org/v360/bugs.html official Bugs page].  This file can be obtained from another port / source archive and copied into place as follows (in Terminal, you will need to type your superuser password):
+For MS-DOS substitute <tt>C:\DOS</tt> for <tt>C:\WINDOWS\COMMAND</tt> in both places.
 == Custom map symbols ==

@@ Line 148: / Line 148: @@
 On many platforms, it is possible to set the display device to display code page 437 instead of the default code page.  This will enable NetHack to display the IBMgraphics as the DevTeam intended.
 === MS-DOS and Windows 95, 98, and Me ===
 Make sure CONFIG.SYS contains a line similar to this:
@@ Line 159: / Line 159: @@
 For MS-DOS substitute <tt>C:\DOS</tt> for <tt>C:\WINDOWS\COMMAND</tt> in both places.
 === Windows NT, 2000, XP, and Vista ===
+----
 ''This section may also apply to Windows 2003 Server, but is untested on this version.''
@@ Line 175: / Line 174: @@
 and then start NetHack.
 === PuTTY ===
+----
 On the PuTTY Configuration window (this appears when you first start PuTTY), select "Translation" under the "Window" configuration in the pane on the left. Then, in the pulldown menu marked "Received data assumed to be in which character set", select "CP437". You can then log in to the server as usual.  You may also change this setting and then 'save' the session.  The character set (as well as other display settings, e.g., the color blue) will be used in your session from then on.
 === Linux console ===
+----
 If your system uses a Unicode console, disable it (for the current session) with:
@@ Line 201: / Line 198: @@
 If any of these commands fails, try running it as root by preceding each command with "sudo " (e.g., "sudo unicode_stop").
 === FreeBSD console ===
+----
 Load the CP437 console font with:
@@ Line 211: / Line 207: @@
   font8x16="cp437-8x16"
 === X11 ===
 While most terminal programs for [[X11]] readily support [[DECgraphics]], they need additional setup for IBMgraphics. The usual way is to set the encoding to code page 437. The exact procedure to do this depends on the terminal program.
-You also need a font that provides the necessary characters. X11 already provides at least one such font: the "fixed" font. It is already the default font for xterm. To preview it or to check that you have it, use one of these xfd commands:
+==== luit (general) ====
 <pre>
@@ Line 227: / Line 232: @@
 If you choose a font like Bitstream Vera Sans Mono, then X11 may substitute another font for some characters, causing graphical glitches if the two fonts have different monospace metrics.
 ==== Using <code>konwert</code>, <code>filterm</code>, or <code>cp437</code> (any terminal) ====
@@ Line 248: / Line 256: @@
 You will probably need to install these programs before they can be used.
 ==== xterm ====
@@ Line 314: / Line 312: @@
 === MAC OS X ===
 The Terminal application that comes with OS X seems to work well on an external SSH server, if one just sets the right encoding. "US Latin (DOS)" seems to work well (if I've understod correctly this means CP437). Also, you need a good monospace font, "Andale Mono" seems to work well; however, I haven't done any extensive testing, and the following questions remain (please remove / edit if you have tested these):

@@ Line 255: / Line 255: @@
 The following solution should work on most terminal emulators using an UTF8 locale (but please test and update this page! Works at least on konsole and xterm here):
-<tt>
+<pre>
 luit -encoding 'CP437' nethack
-</tt>
+</pre>
 ==== xterm ====

← Older revision		Revision as of 13:20, 5 December 2023
Line 248:		Line 248:

	You will probably need to install these programs before they can be used.		You will probably need to install these programs before they can be used.
		+
		+	==== luit (general) ====
		+
		+	The subsections below seem to be outdated - they seem to be expecting most setups do not use UTF-8 locale per default, which has not been the case for ~10 years. Their solutions will just not work.
		+
		+	The following solution should work on most terminal emulators using an UTF8 locale (but please test and update this page! Works at least on konsole and xterm here):
		+
		+	<tt>
		+	luit -encoding 'CP437' nethack
		+	</tt>

	==== xterm ====		==== xterm ====

@@ Line 227: / Line 227: @@
 If you choose a font like Bitstream Vera Sans Mono, then X11 may substitute another font for some characters, causing graphical glitches if the two fonts have different monospace metrics.
-==== Using <code>konwert</code> or <code>filterm</code> (any terminal) ====
+==== Using <code>konwert</code>, <code>filterm</code>, or <code>cp437</code> (any terminal) ====
-If your terminal supports UTF-8, but not code page 437, you can use <code>konwert</code> or <code>filterm</code> to transcode NetHack's output into something your terminal understands. Invoke one of them as follows:
+If your terminal supports UTF-8, but not code page 437, or you just don't want to have to manually change your terminal's encoding settings whenever you're playing NetHack, you can use <code>konwert</code>, <code>filterm</code>, or <code>[https://github.com/keaston/cp437 cp437]</code> to transcode NetHack's output into something your terminal understands. Invoke one of them as follows:
 <pre>
@@ Line 236: / Line 236: @@
 filterm ascii-ascii cp437-utf8 nethack
 # remote play
@@ Line 241: / Line 243: @@
 filterm ascii-ascii cp437-utf8 telnet nethack.alt.org
 </pre>

@@ Line 5: / Line 5: @@
 To use IBMgraphics, the option must be set to TRUE, either in-game or in the configuration file.
-== The complete symbol list ==
+== Symbol list ==
 === Normal dungeon ===
@@ Line 145: / Line 145: @@
 |}
-== Configuring Code Page 437 ==
+== Configuring code page 437 ==
 On many platforms, it is possible to set the display device to display code page 437 instead of the default code page.  This will enable NetHack to display the IBMgraphics as the DevTeam intended.
@@ Line 180: / Line 180: @@
 On the PuTTY Configuration window (this appears when you first start PuTTY), select "Translation" under the "Window" configuration in the pane on the left. Then, in the pulldown menu marked "Received data assumed to be in which character set", select "CP437". You can then log in to the server as usual.  You may also change this setting and then 'save' the session.  The character set (as well as other display settings, e.g., the color blue) will be used in your session from then on.
-=== Linux Console ===
+=== Linux console ===
-If your system uses a unicode console, disable it (for the current session) with:
+If your system uses a Unicode console, disable it (for the current session) with:
   unicode_stop
@@ Line 202: / Line 202: @@
 If any of these commands fails, try running it as root by preceding each command with "sudo " (e.g., "sudo unicode_stop").
-=== FreeBSD Console ===
+=== FreeBSD console ===
 Load the CP437 console font with:
@@ Line 311: / Line 311: @@
 <code>sudo cp symbols /Library/NetHack/nethackdir/</code>
-== Custom Map Symbols ==
+== Custom map symbols ==
 Some users may prefer to set their own symbols, either because they don't like the existing ones, or because it's easier than setting code page 437 just to play NetHack.  See [[Custom map symbols]] for further details.