aven - sophisticated cave viewer for Unix and MS Windows
] [ --print
] .3d file
Aven displays processed cave surveys in a window and allows you to manipulate
Note that there is no perspective in the view. This means that it is impossible
to tell which way round a cave is rotating, or whether you are viewing
something from behind, or in front. So if you think the direction of rotation
in wrong, or changes as you watch, this is just your brain being confused, not
The best way to move the cave is with the mouse. We suggest you try each of
these out after reading this section to get a feel for how they work.
If you hold down the right button then the cave is dragged when you move the
If you hold down the left button, then the cave is rotated if you move left or
right, and zoomed if you move up and down. If you hold down Ctrl
dragging with the left mouse button, then the cave rotates and tilts at the
same time instead.
If your mouse has a middle button then holding it down and moving the mouse up
and down tilts the cave. Moving the mouse left and right has no effect.
And if you have a scrollwheel, this can be used to zoom in/out.
By default the mouse moves the cave, but if you press Ctrl-R
, then the
mouse will move the viewpoint instead (i.e. everything will go in the opposite
direction). Apparently this feels more natural to some people.
select Plan and eLevation respectively. Changing between
plan to elevation is animated to help you see where you are and how things
relate. This animation is automatically disabled on slow machines to avoid
, and Slash /
tilt up and down respectively. Tilt goes 180
degrees from plan view to a view from directly below (upside down plan).
toggles automatic rotation about a vertical axis on and off. The
speed of rotation for this, and animated transitions between plan and
elevation, is controlled by Z
Crosses and/or labels can be displayed at survey stations. Ctrl-X
crosses and Ctrl-N
station names. Ctrl-L
toggles the display of
is useful if you get lost - it resets the scale, position, and
rotation speed, so that the cave returns to the centre of the screen. There
are also keyboard controls to use instead of the mouse - Shift
here as it accelerates all movements:
Z, X : Faster/Slower Rotation
R: Reverse direction of rotation
Enter, Space: Start and stop auto-rotation
Ctrl-Cursor Left, Ctrl-Cursor Right: Rotate cave one step clockwise/anti-clockwise (also: C, V)
Ctrl-Cursor Up , Ctrl-Cursor Down: Higher/Lower Viewpoint (also: ' , /)
] , [: Zoom in/Out
U, D: Set view to Up/Down
N, S, E, W: Set view to North, South, East, West
Delete: Reset to default scale, rotation rate, etc
P, L: Plan, Elevation
Cursor Left, Cursor Right: Pan survey Left/Right (on screen)
Cursor Up, Cursor Down: Pan survey Up/Down (on screen)
Ctrl-N: Toggle display of station names
Ctrl-X: Toggle display of crosses at stations
Ctrl-L: Toggle display of survey legs
Ctrl-F: Toggle display of surface legs
Ctrl-G: Toggle display of grid
Ctrl-B: Toggle display of bounding box
O: Toggle display of non-overlapping/all names
Ctrl-R: reverse sense of controls
Shift: accelerates all movement keys
A little experimentation should give a better understanding of how this works.
There is an auto-resizing scale bar along the bottom of the screen which varies
in length as you zoom in or out. In the lower right corner is a compass
pointer showing which way is North, and a clino pointer showing the angle of
tilt. And in the upper right is a colour key showing the correspondence
between colour and depth (by default - you can also colour by date or by
- -p, --print
- Print the specified file and exit.
- -s, --survey=SURVEY
- Only load the sub-survey 'SURVEY'.