Eagle Mode -
General User Guide
Copyright © 2008,2010-2011,2014,2016 Oliver Hamann.
Homepage: http://eaglemode.sourceforge.net/
Contents
1 Introduction
1.1 Windows, views and panels
1.2 Content view and control view
1.3 Popup-zoom
2 Mouse control
2.1 Zooming by mouse wheel
2.2 Zooming by mouse movement
2.3 Scrolling by mouse movement
2.4 Showing a panel full-sized, by mouse
3 Keyboard control
3.1 Keyboard focus
3.2 General keyboard functions
3.3 About hotkeys
4 Finding more help
5 When Eagle Mode hangs
1 Introduction
Eagle Mode is a zoomable user interface with many plugin applications. This
documents describes its general usage and gives hints where to find further
help.
1.1 Windows, views and panels
In Eagle Mode, the user interface is made of windows, views and panels. A window
is such a thing on the desktop that has a title bar, a border and a content
area. The content area of a window is made of one or more views. Such a view
shows something like a two-dimensional virtual world which can be zoomed and
scrolled. That "world" consists of panels. A panel can be a simple thing like a
button or an input field, or it can be a more complex thing like a group or a
plugin application. Each panel can have child panels which are making up more
details. This relationship of parents and children is also called a tree of
panels. Thus, each view shows a tree of panels.
1.2 Content view and control view
The main window of Eagle Mode has two views: a large content view at the bottom
and a small control view at the top. The content view is for the things you are
working on, and the control view is for commands, status information, settings
and similar things. One could say the control view is a replacement for classic
menu bars, tool bars and status bars. It has the popup-zoom feature (described
more below).
There is a slider for sizing the control view. You can drag it up and down with
the left mouse button. A double click on it minimizes or unminimizes the control
view.
The control view itself is divided into two parts. On the left is a general
control panel which always stays the same. And on the right is a
context-sensitive control panel. This means, the right control panel depends on
what is activated (focused) in the content view. Just navigate around in the
content view and see how the right part of the control view changes. Note that
some content panels do not provide any control panel, and so they leave the
right side of the control view empty.
1.3 Popup-zoom
Some views have the popup-zoom feature. It means that when you zoom in, the view
pops up and gets larger so that it is clipped by the screen bounds only. This
makes small views much more comfortable, but it is suitable only for certain
views like the control view and dialog windows.
Similar to a classic popup menu, a popup-zoomed view automatically pops down
when you click outside, or when you trigger a button in it. Not all buttons have
that effect, but most of them. If you want to trigger a button without popping
the view down, hold the Shift key while triggering the button.
2 Mouse control
This chapter describes how you can navigate through the panels of a view, using
the mouse.
2.1 Zooming by mouse wheel
For zooming in, move the mouse pointer to the location where you want to zoom
in, and then push the mouse wheel upwards. For zooming out, push the wheel
downwards.
Tips:
- For a slower zooming, hold the Shift key or the middle mouse button
while pushing the wheel.
- By zooming in and out with different mouse positions, you can
simulate a scrolling.
- If you want to zoom into a panel which is, for example, on the right
side of the view, then you should position the mouse pointer near the
right edge of that panel. Thereby, and with some practice, you can get
the panel somewhat centered when you zoom in.
2.2 Zooming by mouse movement
For zooming by mouse movement, press and hold the Ctrl key and the middle mouse
button, and move the mouse vertically. (With most mice, wheel and middle button
are the same unit)
Tips:
- The initial mouse position is like with zooming by wheel.
- Hold the Shift key for a slower zooming.
2.3 Scrolling by mouse movement
For scrolling, press and hold the middle mouse button, and move the mouse into
the desired scroll direction.
Tips:
- Hold the Shift key for a slower scrolling.
- After scrolling (or zooming) with the mouse, a "magnetism" may get
active, which scrolls and zooms automatically to show the nearest panel
full-sized. You can prohibit that magnetism by holding the mouse still
for about one second before releasing the middle mouse button.
- The preferences provide an option for reversing the direction of
scrolling in relation to the direction of moving the mouse. (The
preferences are in the general control panel near the upper left corner
of the Eagle Mode window)
2.4 Showing a panel full-sized, by mouse
For showing a panel full-sized so that it fits into the view, double-click with
the middle mouse button on the panel. And for showing a panel full-sized so that
the view is completely utilized, triple-click or shift-double-click with the
middle mouse button on the panel.
With some panel types, this function depends on the size and layout of the panel
contents. Then it is a good idea to repeat the function after the panel has
loaded or changed.
3 Keyboard control
3.1 Keyboard focus
There is always at most one panel on the screen which has the (keyboard) focus.
Any keyboard input goes to that focused panel. The focus is shown by small
arrows which surround the panel and point to it. There are several ways to move
the focus to another panel. One is to zoom into the desired panel, another is to
click with the mouse on it. Further ways are described more below.
Views and windows can also be focused: The focused panel is always in the
focused view, and the focused view is always in the focused window.
The focused panel is even called the active panel of a view. It remains active
even when the view and the panel are losing the focus. In that state, the active
panel is still indicated by arrows, but more pale. As soon as the view is
focused again, its active panel is automatically focused too.
3.2 General keyboard functions
The following table describes the keyboard functions for zooming and scrolling,
as well as for moving the focus.
Key |
Effect |
Alt+Cursor-Key |
Scroll into the desired direction. |
Shift+Alt+Cursor-Key |
Slowly scroll into the desired direction. |
Alt+Page-Up/Down |
Zoom in or out. |
Shift+Alt+Page-Up/Down |
Slowly zoom in or out. |
Alt+Home |
Show the focused panel full-sized so that it fits into the view. |
Shift+Alt+Home |
Show the focused panel full-sized so that the view is completely utilized. |
Cursor-Key |
Move focus to a sister panel in the desired direction. |
Page-Up |
Move focus to first child panel (but if there is no child, the panel is shown full-sized instead). |
Page-Down |
Move focus to parent panel. |
Tab or Shift+Tab |
Move focus to next or previous panel. |
Home or End |
Move focus to first or last panel. |
Escape |
Switch focus between content view and control view, and pop
the control view up or down, respectively. This function is
useful especially when having the control view minimized by the
slider. |
3.3 About hotkeys
Many buttons of the control panels can be triggered by entering hotkeys. They
are documented in the button descriptions - just zoom into the buttons to see
those descriptions.
Important to know is that the hotkeys are functioning only when a panel in the
content view is focused. For technical reasons they are not functioning when
something in the control view is focused.
4 Finding more help
Many help texts can be found directly in the panels they are describing - just
zoom in! Toolkit panels like buttons, input fields and groups often have a
description right below their caption. In addition, interactive toolkit panels
like buttons and input fields have general help texts ("How to use this panel")
very small in the center of the left edge of the border. For example, a text
input field describes all its functions there.
The file manager is described in another document: emFileMan User Guide
The games SilChess, emMines, and emNetwalk are showing help texts in their
control panels.
5 When Eagle Mode hangs
Sometimes Eagle Mode may hang for a short time. This could happen when zooming
into a slow medium like a floppy disk, or when zooming into a disk that has to
be woken up from a sleep state. Another reason could be that the operating
system is busy in executing disk write operations which have been cached some
time before.
If it actually happens that Eagle Mode hangs and you feel that it does not
respond to input, do not give wild input. Just wait - Eagle Mode will respond to
the last input as soon as it gets active again.
If you think Eagle Mode hangs forever and you are in a fullscreen mode and you
don't know how to come out, then you could try the following key combinations in
that order: Alt+F4 (close window), Alt+Tab (switch to another window),
Ctrl+Alt+Backspace twice (kill the X-Server and all windows), Ctrl+Alt+Del (soft
reset or reboot - kills everything). If all that does not help, you may have to
hard reset the computer, but note that this could mean some damage to the file
system (don't do it before there is no disk activity for a long time).