next, previous Section / Table of Contents / Index If a mouse pointer is working in your PC or Unix/X.11 Windows system you can use it for selecting options in option menus, for pointing at atoms in the graphic analysis, and for changing plot views quasi-continuously. Mouse input to BALSAC uses two buttons for the input selection. The PC version assumes a fully Microsoft compatible two button mouse (left/right buttons). The Unix/X.11 version assumes a three button mouse (left/central/ right) of which only the left and central (equivalent to left/right of the PC mouse) buttons are used. In the following, any mention of the "right button" will refer to the central button of a Unix mouse. Further, we will use short a notation where "L-click" means "press the left mouse button, "R-click" means "press the right mouse button, "B-click" means "press both left and right mouse buttons simultaneously, "L-drag" means "press the left mouse button, move the mouse with the button pressed". Mouse handling is somewhat different between the DOS and Unix versions of BALSAC and will be discussed separately if needed. In particular, for Unix versions of BALSAC mouse use is restricted to graphics and menu windows and may lead to strange results in the text window depending on the installed X.11 window manager and your own C.11 settings. (A) Selecting menu options The mouse mode for selecting menu options is by default enabled in the DOS version (if a mouse is available) and disabled in the Unix version of BALSAC. In Unix BALSAC you can turn mouse mode on/off in various ways - Including the option parameter "m" in the initial call to BALSAC, for example in the command "balsac -lrm", see Sec. 6.1, turns mouse mode on (needed only for Unix version). - Pressing [M] in the initial BALSAC startup menu, see Sec. 3.2. (For help text the default on-line help file 'balsac2.hlp' is used.), turns mouse mode on (Unix/DOS) or off (DOS only). - Pressing [@] ("at" character) in any of the option menus turns mouse mode on (Unix/DOS) or off (DOS only). - Mouse mode can be turned on or off in the basic parameter option menu by selecting [M]. Its present state shows in the menu as "[M]ouse(on) ..." or "[M]ouse(off) ...", see also Sec. 6.2.15. - In the Unix version of BALSAC mouse mode is turned off by L-clicking the button to the right of the entry "Menu off" in any menu window. With mouse mode turned on you can select all options with the mouse pointer where the actual handling differs between DOS and Unix versions of BALSAC. (a) DOS/VGA version: Mouse mode displays the mouse pointer in DOS or DOS full screen mode of Windows 9x/NT by a white rectangle (covering one character, while the mouse pointer remains unchanged in DOS windows of Windows 9x/NT. To select an option, say [x], from a menu you move the pointer over the character x enclosed by the brackets [ ] and click the left mouse button (L-click). Alternatively, you can always select the option by pressing [x] from the keyboard. With the on-line help option active you get help by L-clicking the "?" in "[?,]esc" (or pressing [x]) and then L-clicking or pressing any of the option characters. In teach mode, see Sec. 3.3.9, all option menus show a modified escape prompt "[%,]esc" which allows you to turn off teach mode by L-clicking "%" in "[%,]esc" (or pressing [%]). (b) Unix/X.11 version: Here selecting mouse mode for option menus opens a separate menu window which remains open until you turn off mouse mode or finish BALSAC. The menu windows contain all entries of a menu separated by black lines where the entries are given as " X: Option text " with X denoting the option key in keyboard mode and the option text being in most cases more explanatory than that of the keyboard menu. (A list of all available BALSAC option menus is given in Sec. 10.) As an example we show the menu window to modify radii/charges in a BALSAC/CLUSTER session +--+-------------------------+ |__| A: All radii changed | |__| D: Display analysis txt | |__| E: Selected charges | |__| I: Info lattice/atoms | |__| L: All charges changed | |__| R: Rescale all radii | |__| S: Selected radii | |__| T: Table of el. radii | |__| X: Plot/list structure | |__| Z: Element radii __| |__| ,: Escape / Menu off |__| | | ?: CLUSTER Menu | +--+-------------------------+ | | | | +----------------------------+ To select any of the options you simply move the mouse pointer into the left blue field (option field) of the appropriate line and press the left button ("L-click the option"). As long as the option is active the respective option field is painted red while a menu window with all option fields in blue is waiting for your input. The escape line comes with two option fields where L-clicking the left field refers to "escape" while L-clicking the right field turns off mouse mode closing the menu window and you continue with keyboard input for all options. You can get help on each of the options of a menu window if on-line help is available which is indicated by the "?" character showing in the bottom entry |__| ?: CLUSTER Menu | of the menu. After you L-click this line and then any of the menu option lines you obtain a help text in the text window. In teach mode, see Sec. 3.3.9, the bottom entry of each menu reads |__| %: CLUSTER Menu | and selecting an option from the menu window shows you the respective help text in the text window while the menu window asks you to confirm the selection or to skip. If you L-click at the bottom entry teach mode will be turned off. This is confirmed by the "%" character being replaced by "?" in the bottom entry and on-line help becoming available, see above. Note that BALSAC interprets R-clicking inside the menu window always as "escape" which allows you to quickly move to another menu without having to point at the escape line. Further, L-clicking inside the red bottom area of the menu window refreshes the window. This becomes particularly convenient if the window content is demolished (for example by overlapping windows on a X-terminal without backing store) and you want to continue with option input. If you have selected an option which needs alphanumeric input (e.g. radii values) the menu window is closed until you have typed all necessary numbers or text after which the window shows again. (B) Pointing and selecting in graphics After a plot has been finished you can enter the graphical analysis menu by pressing [Q] (Unix: without an open menu window!) or selecting __ |__| Q: Analyze/change | in the respective menu window (Unix only). After you have chosen an option from the analysis menu you must, in most cases, select atoms for the analysis. You can select any of the visible atoms on the graphics screen by moving the mouse pointer (mouse "hot" spot) to the surface of that atom (not necessarily to the exact center position) followed by L-clicking. The respective analysis is then carried out by R-clicking if you have selected enough atoms. R-clicking will also get you out of the present analysis and return to the graphical analysis menu if you have not selected enough atoms needed for the present analysis option. (C) Changing plot views quasi-continuously After a plot has been finished you can change the view parameters theta, phi (view directions), rot (screen rotation), magnf (plot size), persp (perspective factor), and sx, sy (plot shift) also quasi-continuously by mouse dragging inside the plot screen or window. Note that this feature requires the mouse menu option (see part (A) above) to be - ACTIVE for the BALSAC DOS version (if needed press [@] to toggle mouse option key), - INACTIVE for the BALSAC Unix version (if needed L-click "Menu off" button inside menu window). Pointing the mouse inside the plot window, pressing the left mouse button, and moving the mouse with the button pressed (L-drag) changes any of the view parameters theta, phi, rot, magnf, or persp, depending on the setting you have chosen with your latest fast option key press, see below and Secs. 6.2.9, 6.3.7. The view changes are indicated by the wire frame about the lattice section or cluster moving quasi-continuously without showing any atom centers. After the left mouse button is released the plot is refreshed including all atom centers with the latest view parameter values. If the fast plot key that you have used most recently was [up/down/left/right] (changing view angles theta, phi) the mouse drag option changes angles theta, phi where L-drag up/down in/decreases theta and L-drag left/right in/decreases phi. Both angle change variations can be combined. This mouse drag setting is the default setting when you start BALSAC. [m/M] (changing the plot size) the mouse drag option changes the plot size where L-drag up/down in/decreases the magnification factor. [r/R] (changing the screen rotation) the mouse drag option changes the screen rotation angle where L-drag up/down in/decreases the angle. [p/P] (changing the plot perspective) the mouse drag option changes the perspective parameter where L-drag up/down de/increases the perspective factor. Thus, to switch between the above mouse drag settings you just have to press the respective fast plot key. In addition, there is a fast drag option which is independent of the previous setting. It is started by pressing the left mouse button followed by pressing the [alt], [ctrl], or [shift] key and L-dragging the mouse. If the L-drag action is combined with pressing key [alt] the mouse drag changes angles theta, phi as decribed above, [ctrl] the mouse drag changes the plot size as decribed above, [shift] the mouse drag moves the plot on the screen. next, previous Section / Table of Contents / Index