This file is the original description of the Tk port by Tim Baker. It
is now fairly out of date.
Using The Tk Port Interface
This file is meant to be a very quick summary of the major features of
the interface. Make sure you read "The Mouse" section at least.
Game Windows
Note: Currently the game recognizes two screen sizes: (1) width
greater or equal to 800, and (2) anything less than 800. Some of
the windows support dynamic resizing and some don't. If you want
to move the windows around, be sure to choose the "Save Window
Positions" option from the "Window" menu.
Note: In general, clicking the close box on a window has the same
effect as typing Escape. Windows that shouldn't be closed in this
way just beep at you.
Message Window
The Message Window displays messages to you. You can click the Message
Window once to display the previous message. Double-click it to see a
list of previous messages. If the "-more-" prompt is displayed then
clicking clears the prompt.
Note: The Message Window is used throughout the game. You should
ensure that it does not become obscurred or you may get confused.
Main Window
The Main Window displays the cave, status messages, the Monster Health Bar,
player depth, and an information line. Click the depth display to toggle
the "depth_in_feet" option. The "Map (M)" command displays a small-scale
map in the Main Window, with scroll bars. Pointing to a location in the
dungeon map shows what is at that location, displaying the surrounding
grids in the Micro Map Window. Click the dungeon map to hide it again.
Right-Click the dungeon map to bring up a popup menu that allows you to
change the map's scale. Click-drag to scroll the map. Click the "C" in the
status bar to recenter the display at the character location.
Micro Map Window
The Micro Map Window displays a miniature version of the cave. Pointing
to a location displays (in the Main Window) what is at that location, and
displays a description of the location, as is done in the Main Window.
Click the Micro Map Window to display the full cave map. Right-Click the
Micro Map Window to bring up a popup menu of resolutions. Click-drag to
scroll the map. Shift-click to fix the Main Window at the location.
Inventory Window
The Inventory Window displays the inventory and equipment your character
has. When the game is asking you to choose an item, simply double-click
the item to choose it. When an item is highlighted, the item memory is
displayed in the Recall Window. Right-click on an item to pop up a
menu of commands. To change some options related to the display of
the inventory, click the down-arrow button in the toolbar.
Recall Window
The Recall Window displays your character's memory about artifacts,
monsters and objects. When the game is asking the user to select
something, such as an inventory item or spell, a list of choices is
displayed. When the pointer is over a row it is highlighted:
click the item or spell to choose it. When the pointer is inside the
Recall Window, the window automatically grows to reveal all of its content.
When the pointer leaves the Recall Window, the window shrinks back to its
regular size. When the Choice Window is visible, then all choices are
displayed in the Choice Window instead.
Misc Window
The Misc Window displays a few of the more important attributes for
your character. Click the character icon to see the Character
Window. The 9 buttons at the top of the Misc Window give you quick
access to various functions. Click the "EXP" label to toggle between
total experience points and points needed to advance. Click the "AC"
label to toggle between total armor class and base,bonus. Right-click
to pop up a menu to choose Text Labels versus graphical labels.
Character Window
The Character Window displays information about the character. Menu
commands allow the user to change the character icon, character name,
and to write a character record to a text file.
Character Window (Flags)
The Flags page of the Character Window displays a table of properties
affecting the current character.
Along the top of the table is one icon for each
equipment item and one icon for the character. Each row in the
table displays, under each icon, what properties the item gives
the character, or what the character's intrinsic abilities are.
Pointing to one of the icons displays a description of the item,
(or the character's name, race and class) and the item memory is
displayed in the Recall Window.
Book Window
The Book Window shows the spells in a given book. You can double-click a
spell to select it when prompted.
Store Window
When the game is waiting for a command, double-click an item to initiate
a purchase (or take an item in the Home). Or, when the game is asking you to
select an item to purchase double-click one. When an item is selected the
memory is displayed in the Recall Window, and the quantity field is reset
to 1. To buy a number of items, type in a number type ENTER.
Options Window
The options window allows you to change the multitude of options
available to you. There are a couple of slider controls, but most of the
options are boolean on/off options that you can toggle by clicking the
checkbox beside the description of each option. Options from the non-Tk
version of the game can be displayed, but these options have no effect.
Knowledge Window
The "Knowledge (~)" command brings up this window. On the left is a list
of groups of related monsters. Click a group to see a list of monsters
in that group. Click a monster on the right and the monster memory is
displayed. The menu allows you to see groups of artifacts as well. You can
search for known artifacts and monsters by name.
Macros Window
The Macros Window displays a list of all currently defined macros. On the
left is a string representing the trigger keypress. On the right is
the associated action for the macro.
Type 'n' to create a new macro. Point the mouse over the Trigger Entry
and then type a new keypress to invoke the selected macro.
Type an encoded action into the Action Entry and hit Enter. Keep in mind the
following representations:
\e -- Escape
\s -- Space
\\ -- Backslash
Macros are not the same as in the original Angband. They use X Windows
symbols for keypress names, which are human-readable. This means most of your
old macros won't work with AngbandTk.
You can read an existing preferences file by choosing "Load Pref File" from
the menu. You can append all the currently defined macros to a new or
exising file by choosing "Dump Macros" from the menu. Even though the
system asks you to confirm replacing an existing file, the macros are
actually appended to the file you choose.
Keymap Window
The Keymap Window displays a keyboard and shows you which keys have
keymaps assigned to them. A keymap is just like a macro only it applies
to "normal" keys. Click the left mouse button in the displayed keyboard
to select a key, enter an action in the Action entry, and hit Enter.
Entering an empty string deletes the keymap for the selected key.
Progress Window
The Progress Window displays the character's hitpoints (HP), spell points
(also called mana) (SP), and food level (FD). The appearance of the window
can be changed using a context menu (right-click to access the menu).
Choice Window
The Choice Window displays a list of choices whenever the game is asking
the user to select something, such as an inventory item or spell. A single
click chooses the item or spell. When the game is not asking the user to
choose, the character's
inventory or equipment is displayed (type / to toggle). A context menu of
actions is available by right-clicking in a row. The default action is
invoked by double-clicking an item. The Choice Window can be
closed by clicking the close box in the title bar, and can be shown by
selecting the menu entry in the Window Menu. When the Choice Window is
not visible, then all choices are displayed in the Recall Window instead.
Clicking outside any item pops up a menu of options which control the
appearance and behaviour of the Choice Window.
Messages Window
The Messages Window displays the most recent messages. The Messages Window
can be closed by clicking the close box in the title bar, and can be
displayed by selecting the menu entry in the Window Menu.
The Mouse
These notes apply to mouse events in the Main Window.
1. Click the left mouse button (ButtonPress-1) to move the character
one step in the corresponding direction. Pressing and holding the
left mouse button moves the character continuously, but is not the
same as running (see below).
Note: No game turns are consumed by moving the character
into a wall or on-the-spot, except for the initial mouse click.
2. Click the right mouse button (ButtonPress-3) to make the character
run in the corresponding direction. Alternatively, shift-click the
left mouse button (Shift-ButtonPress-1) to make the character run.
3. Control-click the left mouse button (Control-ButtonPress-1) to invoke
the "Alter (+)" command. See "commands.txt" for what that does.
4. Simply pointing the cursor at a given cave location provides a
description of what is seen, similar to the "Look (l)" command. When
the cursor is over a visible monster, the monster health bar is shown
and monster memory is displayed.
5. When the game is asking you to choose an inventory item, press the
right mouse button (ButtonPress-3) and a popup menu pops up. Select an
item from this menu to choose it; otherwise type ESACPE twice. You can
also choose spells to cast and study in this way.
6. When the game is asking you to enter a direction (as when firing an
arrow or aiming a wand), simply click the mouse in the desired direction.
Or right-click to target the monster or location under the mouse.
7. When the "-more-" prompt is displayed, and the "quick_messages" option
is set, click the mouse to skip past the message. It also works if the
mouse button is held down (as when fighting a monster).
8. When a repeated command is in progress (running, resting, tunneling,
etc), simply click the left mouse button (ButtonPress-1) to interrupt
the command.
9. Control-right-click (Control-ButtonPress-3) pops up a cascading menu
of items in the character's inventory. Seleting an item uses the item.
10. When the game is asking you to target a monster or location,
left-click to set the target. If a targettable monster
is at the location, it is targetted. Otherwise the location is targetted.
Performance Issues
From a fast, portable, terminal-based game to a single-system multimedia
monster, the performance of AngbandTk may leave you wanting more. Here are
some tips for a faster gaming experience.
- Set your monitor to High Color (16-bit) instead of True Color (24 bit).
- Keep the Main Window and Micro Map Window sizes to a minimum.
- Play with 32x32 icons instead of 16x16.
- Turn off the music.
- Close any programs which are running in the background.
- Don't assign a sound to the "Walk a step" event.
- Buy a faster computer. :-)