Provided by: survex-aven_1.2.5-1_i386 bug

NAME

       aven -- sophisticated cave viewer for Unix and MS Windows

SYNOPSIS

       aven [options]  .3d file

Description

       Aven  displays  processed  cave  surveys  in a window and allows you to
       manipulate the view.

       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 a bug!

   Mouse Control
       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 mouse.

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

   Keyboard Control
       <P>  and  <L> 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 user frustration.

       Comma <'>, and Slash </> tilt up and down respectively. Tilt  goes  180
       degrees  from  plan  view  to  a  view from directly below (upside down
       plan).

       <Space> 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> and <X>.

       Crosses and/or labels can be displayed at  survey  stations.   <Ctrl-X>
       toggles  crosses  and  <Ctrl-N>  station  names.   <Ctrl-L> toggles the
       display of survey legs.

       <Delete> 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>
       helps here as it accelerates all movements:

       <Z>, <X> : Faster/Slower Rotation
       <R>: Reverse direction of rotation
       <Enter>, <Space>: Start and stop auto-rotation
       <C>, <V>: Rotate cave one step clockwise/anti-clockwise
       <'> , </>: Higher/Lower Viewpoint
       <]> , <[>: 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 error).

See Also

       3dtopos(1),  cad3d(1),  cavern(1),  diffpos(1),  extend(1), sorterr(1),
       svxedit(1)

                                                                       aven(1)