@ Necklace of the Eye

• Just display the roguelike like it would be displayed in DOS (like my previous utility, cons2tcod). This is especially useful in Vista and newer, since these systems don't even allow viewing console applications in full screen. However, even on older Windows systems, this utility should be useful, because it uses the correct colors, the correct font, and the correct codepage (if a roguelike uses extended IBM characters, like Crawl, it should look better).
• However, if you want, you can change the font and colors (theoretically; no fonts other than the DOS font are supplied now with NotEye, but you could try to use fonts from libtcod).
• Provide a tile display for the roguelike. NotEye includes the tile set drawn by David Gervais (published under the Creative Commons licence), downloaded from here, and can render basic roguelike stuff using it. You can add more tiles od use a different tileset by (hopefully) simply editing a configuration file. Note that NotEye is designed to work somewhat with all roguelikes, rather than work well with one, so often it won't understand everything and the tile display won't be perfect. (For example, sometimes it won't be sure whether what is shown on the screen is the roguelike ASCII map, or just some normal text, which should not be rendered. It also does not know what other things—for example, what type of floor—are in the same location as the "main thing" which is represented by the ASCII character.)
• Using the same tiles, it can draw a First Person Perspective display. (DoomRL looks somewhat appropriate in this mode.) The same problems as before apply here. To navigate in the FPP mode, press "Home" and "PgUp" on numpad to rotate the vision by 45 degrees, "End" and "PageDn" to rotate by 90 degrees, "Up" and "Down" to move forward/backward, "Left" and "Right" to strafe.
• Some other minor features are also available. If you want to play a roguelike using the rogue keyset (yubnhjkl), but you are not accustomed to that layout, NotEye can simulate it with the numpad. It is also possible to create HTML and PhpBB-coded screenshots.

Screenshots

ADOM: Terinyo with tiles	ADOM: Terinyo in 3D
ADOM: Tension room with tiles	ADOM: Tension room in 3D
DoomRL: aiming	DoomRL: barrel explosion
DoomRL: junk	DoomRL: tiles
Crawl with 3d window	DOS output

• Alt+Enter switches full screen or windowed mode.
• Alt+F switches graphical mode (either First Person Perspective or normal tiles).
• Alt+A disables graphical display (although it will still be shown in the background). Press again to clear the background too.
• Alt+S, Alt+D, Alt+R changes the way NotEye checks whether we are currently displaying a map, and where is the PC (i.e., center of vision). S (Search) just looks for the @ character in the map area. R (Render) just checks whether the cursor is in the map area, and assumes the PC to be in this location. D (Decide) checks whether the @ is in the cursor position. (Note: characters thought to represent the player can be changed in the config file.)
• Alt+Y, Alt+H, Alt+B, Alt+N changes the way NotEye tries to transfer directional keypresses to the roguelike. Y is the rogue keyset (yubnhjkl). H is just keypad. N is numpad (like keypad with NumLock on). B is arrow keys.
• Alt+V turns the mini-map on and off.
• Alt+M creates a BMP screenshot.
• Alt+L creates a HTML screenshot of the underlying ASCII display.
• Alt+P creates a PhpBB-coded screenshot of the ASCII display.

c:
cd \games\crawl\
crawl

How to edit the config file

• WINDOW xsize ysize - specifies the size of window which will contain our display.
• FULLSCREEN xsize ysize - like WINDOW, but will start in fullscreen.
• FONT fontfile - reads the specified font file. (Has to be used after screen is initialized.)
• ROWFONT fw fh - should appear before FONT. Specifies that the fontfile has fw columns and fh rows, and characters are ordered by rows.
• COLFONT fw fh - just like ROWFONT, but characters are ordered by columns.
• COLOR n rrggbb - changes the RGB value of the color number n. (Colors are numbered like in DOS: 0=black, 1=blue, 2=green, 3=cyan, 4=red, 5=purple, 6=brown, 7=gray, 8=dark, 9=light blue, 10=light green, 11=light cyan, 12=light red, 13=light pu5rple, 14=yellow, 15=white.)
• PATH path - tells NotEye to change the path before running. For example, PATH C:\games\crawl will change the current folder to C:\games\crawl.
• CMD cmd - runs cmd after initializing (you can do this to start the roguelike automatically, normally the command prompt (cmd.exe) is ran).
• CONSOLE columns rows - tells NotEye to change the size of the console before running.
• TESTMODE - run in a diagnostic mode to test whether keys are read correctly. Press the key while the small window is active and note numbers shown on the screen; then press the key in the original console and note numbers again. Ideally, the numbers should be the same for a key to work. (vsc is probably not necessary)
• MODE ... - changes NotEye's mode when it starts. Type the same keys you would press with Alt while NotEye were running. For example, MODE sfh tells NotEye to start in FPP mode, search for @, and simulate numpad to send directions.

• TILE x y - sets the size of tiles. (All tiles use the same dimensions.)
• MAP x1 y1 x2 y2 - specifies which part of the screen generated by the roguelike contains the map. For example, ADOM, which cuts 2 top lines and 3 bottom lines from a 80x25 screen, and uses the rest for the map, will have "MAP 0 2 80 22".
• VIEW x1 y1 x2 y2 - tells NotEye to render its graphics in only a part of the screen.
• ZOOM size - changes the scale used to draw in the FPP mode. Normally, size is (y2-y1)/2. Smaller size means smaller pictures, but wider angle.
  
  
• FILE filename - load filename to take tiles from it. (Has to be used after screen is initialized.)
• TRANSAT x y - tells that the following TILEs will be transparent, and the pixel which contains the transparent color is at position (x,y) in the tile.
• TILE name x y - the tile named name is located in the last loaded file at position (x,y).
  
  
• DRAW char color tiles - tells what tiles should be used to draw character char of color color.
  char can be a character, a character range (e.g. A-Z), ANY (set the default for all characters), SPACE, or NUL (character 0). Color can be a color number (explained previously) or * (modify all colors of this character). Thus, DRAW @ 7 will modify the gray @. tiles can contain the following words.
  • You can type the name given while loading the tile using TILE command. (All tiles given will be drawn, using the transparency.)
  • :fgswbi is used to specify the spatial location used to draw the following tiles in the 3D mode (f=flat mode only, g=ground, s=sky, w=walls, b=big monster, i=small item). For example, :fgs GROUND will draw the GROUND tile on the floor and on the ceiling, and in the 2D mode.
  • rec: will automatically recolor (one) next tile using the color taken from the ASCII display (so, DRAW . * :fsg rec: GROUND will map various color versions of "." to appropriate color versions of the GROUND tile).
  • $zbo will use the original ASCII character as the tile. (z means that the character will be zoomed, b means that a background will be provided (darker version of the character color — otherwise the character will be transparent), and o means that an outline will be added.) You can use 'o' several times to add a larger outline. You can also use 'x', 'y', 'X', and 'Y' to shift the character.
  • player will tell that the current character means the player (used to detect the PC position).