source: git/lib/INSTALL.OSX @ 529fa0e

RELEASE/1.2debug-cidebug-ci-sanitisersstereowalls-data
Last change on this file since 529fa0e was c0a3f6a9, checked in by Olly Betts <olly@…>, 8 years ago

OS X: Allow aven to run extend

  • Property mode set to 100644
File size: 2.1 KB
Line 
1Installing Survex on Mac OS X
2=============================
3
4Next to the INSTALL file that you are currently reading is the Survex folder.
5To install, just drag this folder to your Applications folder (you will need to
6be logged in at an Administrator level to do this), or drag it to a folder
7under your home folder.
8
9The programs alongside Aven.app need to be run from the command-line (open
10Terminal.app):
11
12 * extend produces extended elevations - this is probably the most useful of
13   these command line tools.  Since version 1.2.27 you can produce simple
14   extended elevations from Aven using the "Extended Elevation" function.
15   However the command line tool allows you to specify a spec file to control
16   how the survey is extended, which you can't currently do via Aven.
17
18 * cad3d turns .3d files into various formats, but Aven's "Export" function
19   can do almost everything cad3d can, plus some extra formats.  The main
20   benefit of cad3d is that it can be easily used in scripts.
21
22 * cavern processes survey data, but since version 1.2.3 you can process .svx
23   files by simply opening them with Aven.app, so you no longer need to run
24   cavern from the command line.  As with cad3d, the main reason to run cavern
25   directly is for use in scripts.
26
27 * 3dtopos converts a .3d file to a .pos file.  In Survex 1.2.19 and later,
28   aven can export .pos files, so the main benefit of 3dtopos is that it can
29   be easily used in scripts.
30
31 * diffpos compares the positions of stations in two .3d, .pos, etc files.
32
33 * sorterr sorts a .err file by a specified field.
34
35 * dump3d dumps out a list of the items in a .3d file - it's mainly useful for
36   debugging.
37
38Known shortcomings specific to the Mac OS X version of Survex
39=============================================================
40
41These could be reproduced with Survex 1.2.19 when built using wxWidgets 3.0.2:
42
43 * On OS X, usually you can push the mouse pointer against the top of the
44   screen to get the menu bar to appear, but this doesn't seem to work for
45   aven.  As a workaround, aven detects if you're trying to do this and
46   drops out of full-screen mode, which isn't perfect but beats being stuck
47   in full screen mode.
Note: See TracBrowser for help on using the repository browser.