=== Using The Interface ===

This file was last updated for ZAngbandTk 2.2.1r1.

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 "Other" 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.

    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.

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.

Inventory Window
----------------
The Inventory Window display the inventory and equipment your character
has. When the game is asking you to choose and item, simply double-click
the item to choose it. When an item is selected, the item memory is
displayed in the Recall Window. The icons in the inventory and store
lists can be turned off via the "Show icons in inventory/store list"
option under the "Other" options page. See the "Options (=)" command.

Recall Window
----------------
The Recall Window displays your character's memory about artifacts,
monsters and objects. When the game is asking you to choose an item
a list of allowable items are displayed here. When the game is asking
you to choose a spell the spells are displayed here. When the pointer
passes over an item or spell 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.

Misc Window
----------------
The Misc Window displays a few of the more important attributes for
your character. Click the character icon to see the Character Info
Window. Control-click the character icon to see the Character Flags
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..

Character Info Window
---------------------
The Character Info Window diplays all the important attributes for
your character, including your character's family history. To change
your character's name (why would you want to do that?) type the
letter 'c', enter a new name (max 15 characters), and type ENTER.
Type 'h' to bring up the Character Flags Window.

Character Flags Window
---------------------
Along the top of the Character Flags Window is an 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 on 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
red/green button beside the description of each one.

    Note: Some of the options may be obsolete, since the Term code is
    no longer used. For example, the "disturb_panel" option. In this
	case the 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.


=== 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.

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.

