Added support for Unicode characters in the map display with ncursesw (enabled

by setting UNICODE_GLYPHS=y in makefile.unix).

Removed the (1,1) offset between map and grid. Both map and grid are now in
sync.

Store object indexes instead of raw characters in env.map so that players can
change charsets and have the display update immediately.

git-svn-id: https://crawl-ref.svn.sourceforge.net/svnroot/crawl-ref/trunk@1552 c06c8d41-db1a-0410-9941-cceddc491573

1 files changed, 25 insertions, 0 deletions

diff --git a/crawl-ref/INSTALL b/crawl-ref/INSTALL
index c962fd36c6..4114224a28 100644
--- a/crawl-ref/INSTALL
+++ b/crawl-ref/INSTALL
@@ -32,6 +32,7 @@ Crawl can be built with some optional features:
 * Sounds
 * Regular expressions
 * Lua support
+* Unicode characters for the map (Unix only).
 
 Crawl Stone Soup also uses a level compiler to compile special level
 definitions; to make changes to the level compiler, you'll need the
@@ -76,6 +77,11 @@ on some Unixes.
 flex and bison are optional but highly recommended. Recent versions of
 byacc are also fine (edit your makefile appropriately).
 
+If you have ncursesw and the development headers (usually in the
+/usr/include/ncursesw directory) you can build Crawl with support for
+Unicode display characters in the map by setting UNICODE_GLYPHS = y
+in makefile.unix.
+
 Building:
 
 * cd to the source directory (you can safely ignore the dolinks.sh and
@@ -339,3 +345,22 @@ http://gnuwin32.sourceforge.net/packages/pcre.htm
 On DOS you get the joy of building PCRE yourself. It's a little more
 annoying than building Lua (you have to roll your own makefile), but
 not by much.
+
+
+Unicode
+-------
+
+Modern Unixes may support Unicode terminals (particularly xterms). If
+you have a terminal that can display Unicode characters, and an
+ncurses library that can handle Unicode (libncursesw, and its devel
+headers), you can build Crawl to display Unicode in the map: set
+UNICODE_GLYPHS = y in makefile.unix.
+
+NOTE: You may have libncursesw, but not have the header files; check
+that you have the header files installed as well, or you'll get a lot
+of errors. Crawl expects the ncursesw headers to be in
+/usr/include/ncursesw.
+
+After compiling Crawl with Unicode support, you still need to add the
+line "char_set = unicode" in your .crawlrc to tell Crawl to use
+Unicode.
\ No newline at end of file