[7bb8184] | 1 | <refmeta> |
---|
| 2 | <refentrytitle>aven</refentrytitle> |
---|
| 3 | <manvolnum>1</manvolnum> |
---|
| 4 | </refmeta> |
---|
| 5 | |
---|
| 6 | <refnamediv> |
---|
| 7 | <refname>aven</refname> |
---|
| 8 | <refpurpose>sophisticated cave viewer for Unix and MS Windows |
---|
| 9 | </refpurpose> |
---|
| 10 | </refnamediv> |
---|
| 11 | |
---|
| 12 | <refsynopsisdiv> |
---|
| 13 | <cmdsynopsis> |
---|
| 14 | <command>aven</command> |
---|
| 15 | <arg choice="opt">options</arg> |
---|
| 16 | <arg choice="req">.3d file</arg> <!--FIXME rep="repeat"--> |
---|
| 17 | </cmdsynopsis> |
---|
| 18 | </refsynopsisdiv> |
---|
| 19 | |
---|
| 20 | <refsect1><title>Description</title> |
---|
| 21 | |
---|
| 22 | <Para> |
---|
| 23 | Aven displays processed cave surveys in a window and allows you to |
---|
| 24 | manipulate the view. |
---|
| 25 | </Para> |
---|
| 26 | |
---|
| 27 | <Para>Note that there is no perspective in the view. This means that |
---|
| 28 | it is impossible to tell which way round a cave is rotating, or |
---|
| 29 | whether you are viewing something from behind, or in front. So |
---|
| 30 | if you think the direction of rotation in wrong, or changes as |
---|
| 31 | you watch, this is just your brain being confused, not a bug! |
---|
| 32 | </Para> |
---|
| 33 | |
---|
| 34 | <refsect2><Title>Mouse Control</Title> |
---|
| 35 | |
---|
| 36 | <Para> |
---|
| 37 | The best way to move the cave is with the mouse. We suggest you |
---|
| 38 | try each of these out after reading this section to get a feel |
---|
| 39 | for how they work. |
---|
| 40 | </Para> |
---|
| 41 | |
---|
| 42 | <Para> |
---|
| 43 | If you hold down the right button then the cave is dragged when you move the |
---|
| 44 | mouse. |
---|
| 45 | </Para> |
---|
| 46 | |
---|
| 47 | <Para> |
---|
| 48 | If you hold down the left button, then the cave is rotated if you move |
---|
| 49 | left or right, and zoomed if you move up and down. |
---|
| 50 | If you hold down <keycap>Ctrl</keycap> while dragging with the left |
---|
| 51 | mouse button, then the cave rotates and tilts at the same time instead. |
---|
| 52 | </Para> |
---|
| 53 | |
---|
| 54 | <Para> |
---|
| 55 | If your mouse has a middle button then holding it down and moving the |
---|
| 56 | mouse up and down tilts the cave. Moving the mouse left and right has |
---|
| 57 | no effect. |
---|
| 58 | </Para> |
---|
| 59 | |
---|
| 60 | <Para> |
---|
| 61 | And if you have a scrollwheel, this can be used to zoom in/out. |
---|
| 62 | </Para> |
---|
| 63 | |
---|
| 64 | <Para> |
---|
| 65 | By default the mouse moves the cave, but if you press <keycap/Ctrl-R/, |
---|
| 66 | then the mouse will move the viewpoint instead (i.e. everything will |
---|
| 67 | go in the opposite direction). Apparently this feels more natural to some |
---|
| 68 | people. |
---|
| 69 | </Para> |
---|
| 70 | |
---|
| 71 | </refsect2> |
---|
| 72 | |
---|
| 73 | <refsect2><Title>Keyboard Control</Title> |
---|
| 74 | |
---|
| 75 | <Para><keycap/P/ and <keycap/L/ select Plan and eLevation |
---|
| 76 | respectively. Changing between plan to elevation is animated to help |
---|
| 77 | you see where you are and how things relate. This animation is |
---|
| 78 | automatically disabled on slow machines to avoid user frustration. |
---|
| 79 | </Para> |
---|
| 80 | |
---|
| 81 | <Para> |
---|
| 82 | Comma <keycap/'/, and Slash <keycap>/</keycap> tilt up |
---|
| 83 | and down respectively. Tilt goes 180 degrees from plan view to a view |
---|
| 84 | from directly below (upside down plan). |
---|
| 85 | </Para> |
---|
| 86 | |
---|
| 87 | <Para> |
---|
| 88 | <keycap>Space</keycap> toggles automatic rotation about a vertical |
---|
| 89 | axis on and off. The speed of rotation for this, and animated transitions |
---|
| 90 | between plan and elevation, is controlled by <keycap/Z/ and <keycap/X/. |
---|
| 91 | </Para> |
---|
| 92 | |
---|
| 93 | <Para>Crosses and/or labels can be displayed at survey stations. |
---|
| 94 | <keycap/Ctrl-X/ toggles crosses and <keycap/Ctrl-N/ station names. |
---|
| 95 | <keycap/Ctrl-L/ toggles the display of survey legs. |
---|
| 96 | </Para> |
---|
| 97 | |
---|
| 98 | <!-- |
---|
| 99 | <para>By default, labels and crosses are not redrawn during |
---|
| 100 | movement, to improve responsiveness. With a small cave, or a fast |
---|
| 101 | computer, you can enable redraw of everything during movement with |
---|
| 102 | <keycap/Ctrl-A/. <keycap/Ctrl-O/ toggles whether all names are |
---|
| 103 | displayed, or only non-overlapping ones. |
---|
| 104 | </para> |
---|
| 105 | --> |
---|
| 106 | |
---|
| 107 | <para><keycap/Delete/ is useful if you get lost - it resets the scale, |
---|
| 108 | position, and rotation speed, so that the cave returns to the centre |
---|
| 109 | of the screen. There are also keyboard controls to use instead of the |
---|
| 110 | mouse - <keycap/Shift/ helps here as it accelerates all |
---|
| 111 | movements: |
---|
| 112 | </para> |
---|
| 113 | |
---|
| 114 | <screen> |
---|
| 115 | <keycap/Z/, <keycap/X/ : Faster/Slower Rotation |
---|
| 116 | <keycap/R/: Reverse direction of rotation |
---|
| 117 | <keycap/Enter/, <keycap/Space/: Start and stop auto-rotation |
---|
| 118 | <keycap/C/, <keycap/V/: Rotate cave one step clockwise/anti-clockwise |
---|
| 119 | <keycap/'/ , <keycap>/</keycap>: Higher/Lower Viewpoint |
---|
| 120 | <keycap/]/ , <keycap/[/: Zoom in/Out |
---|
| 121 | <keycap/U/, <keycap/D/: Set view to Up/Down |
---|
| 122 | <keycap/N/, <keycap/S/, <keycap/E/, <keycap/W/: Set view to North, South, East, West |
---|
| 123 | <keycap/Delete/: Reset to default scale, rotation rate, etc |
---|
| 124 | <keycap/P/, <keycap/L/: Plan, Elevation |
---|
| 125 | <keycap/Cursor Left/, <keycap/Cursor Right/: Pan survey Left/Right (on screen) |
---|
| 126 | <keycap/Cursor Up/, <keycap/Cursor Down/: Pan survey Up/Down (on screen) |
---|
| 127 | <keycap/Ctrl-N/: Toggle display of station names |
---|
| 128 | <keycap/Ctrl-X/: Toggle display of crosses at stations |
---|
| 129 | <keycap/Ctrl-L/: Toggle display of survey legs |
---|
| 130 | <keycap/Ctrl-F/: Toggle display of surface legs |
---|
| 131 | <!--<keycap/Ctrl-A/: Toggle display of All/skeleton when moving--> |
---|
| 132 | <keycap/Ctrl-G/: Toggle display of grid |
---|
| 133 | <keycap/Ctrl-B/: Toggle display of bounding box |
---|
| 134 | <keycap/O/: Toggle display of non-overlapping/all names |
---|
| 135 | <keycap/Ctrl-R/: reverse sense of controls |
---|
| 136 | <keycap/Shift/: accelerates all movement keys |
---|
| 137 | </screen> |
---|
| 138 | |
---|
| 139 | <Para>A little experimentation should give a better understanding of how |
---|
| 140 | this works. |
---|
| 141 | </Para> |
---|
| 142 | |
---|
| 143 | <Para>There is an auto-resizing scale bar along the bottom of the screen |
---|
| 144 | which varies in length as you zoom in or out. |
---|
| 145 | In the lower right corner is a compass pointer showing which way |
---|
| 146 | is North, and a clino pointer showing the angle of tilt. |
---|
| 147 | And in the upper right is a depth bar showing the correspondence between |
---|
| 148 | colour and depth. |
---|
| 149 | </Para> |
---|
| 150 | |
---|
| 151 | </refsect2> |
---|
| 152 | |
---|
| 153 | </refsect1> |
---|