===== Preface =====

This guide covers Therion installation on OS X from source.

We will need

  * **Xcode** - install from AppStore
  * **Command Line Tools** - install using Install button in Xcode -> Preferences -> Downloads -> Command Line Tools
  * **Terminal** - part of OS X installation
  * Some therion dependecies will be installed using **Homebrew** package manager.


===== Homebrew =====

Homebrew is package manager for OS X - [[http://en.wikipedia.org/wiki/Homebrew_(package_management_software)|Wikipedia]]

In comparison to other package managers like Fink or MacPorts Homebrew works hard to avoid package duplication - Homebrew compiles its packages against libraries built into OS X.

Install Homebrew - see instructions on http://mxcl.github.com/homebrew/

Install MacTeX package from http://www.tug.org/mactex/

Run following commands in Terminal:

<code>
brew update
brew doctor
</code>

follow (if any) instructions in results of "doctor" command

<code>
brew install lcdf-typetools
brew install wxmac
brew install freetype
brew install vtk
brew install --overwrite imagemagick
brew doctor 
</code>

"--overwrite" parameter you may use if problems with linking (there is another installation, not the brew's). ImageMagick is such case, it is installed by MacOSX Xcode installation, but evidently not all necessary files.

In case you want to use Survex for loop-closure or if you want to compile samples install Survex:

<code>
brew tap survex/survex https://git.survex.com/homebrew-survex
brew install survex
</code>

Once you've installed as above, you can upgrade your homebrew packages (including Survex) like so:

<code>
brew update
brew upgrade
</code>
===== Building therion + xtherion + loch from source =====

Download therion source code from http://therion.speleo.sk/download.php

Extract tarball to ~/Downloads or another prefered place.


==== Compilation ====

In Terminal run:

<code>
cd ~/Downloads/therion
make config-macosx
make
cd loch
make
cd ..
make install
</code>

==== The Therion Book ====

This will compile and create sample files and compile Thbook – the refence guide.

<code>
make samples
</code>
===== Preparation for old version 0.3.10 =====

In Terminal run:

<code>
sudo mkdir /usr/X11/include
sudo ln -s /System/Library/Frameworks/OpenGL.framework/Headers /usr/X11/include/GL
</code>

Now we need to customize several files

**Edit ~/Downloads/therion/Makefile**

replace line 65:
<code>
POBJECTS = extern/getopt.o extern/getopt1.o extern/getline.o
</code>
with:
<code>
POBJECTS = extern/getopt.o extern/getopt1.o
</code>

**Edit ~/Downloads/therion/loch/lxFile.cxx**

replace section starting on line 12:

<code>
#if defined LXWIN32 || defined LXMACOSX || defined THWIN32 || defined THMACOSX
#include "getline.h"
#endif
</code>

with:

<code>
#if defined LXWIN32 || defined THWIN32
#include "getline.h"
#endif
</code>

**Edit ~/Downloads/therion/loch/Makefile**

replace section starting on line 9 with:

<code>
VTKVERSION = 5.10
#VTKVERSION = $(shell tclsh getvtkver.tcl version)
VTKPATH = /usr/local/include/vtk-$(VTKVERSION)
#VTKPATH = $(shell tclsh getvtkver.tcl incpath)
VTKLIBPATH = /usr/local/lib/vtk-$(VTKVERSION)
#VTKLIBPATH = $(shell tclsh getvtkver.tcl libpath)
VTKLIBS = -lvtkHybrid -lvtkImaging -lvtkIO -lvtkGraphics -lvtkFiltering -lvtkCommon -lvtkjpeg -lvtkpng -lvtkzlib -lvtksys -lfreetype
POSTMAKE =
STRIPFLAG = -s
</code>

replace section starting on line 54 with:

<code>
# PLATFORM MACOSX
CXX = c++
CC = cc
POBJECTS =
CXXPFLAGS = -W -Wall -DLXMACOSX $(shell wx-config --cxxflags) -I$(VTKPATH) -Wno-deprecated -I/usr/X11R6/include $(shell freetype-config --cflags)
CCPFLAGS = -W -Wall -DLXMACOSX $(shell wx-config --cflags) -I/usr/X11R6/include
LXLIBDIR = 
PLIBS = -lz -L/usr/X11R6/lib $(shell wx-config --libs --gl-libs) -L$(VTKLIBPATH) $(VTKLIBS)
POSTMAKE = cp -f ./loch ./loch.app/Contents/MacOS
STRIPFLAG =
</code>

**Edit ~/Downloads/therion/loch/lxOGLFT.cxx**

Replace line 474:
<code>
bbox = measure( s.GetChar( 0 ) );
</code>
with:
<code>
bbox = measure((const wxChar) s.GetChar( 0 ) );
</code>

Replace line 478:
<code>
BBox char_bbox = measure( s.GetChar( i ) );
</code>
with:
<code>
BBox char_bbox = measure((const wxChar) s.GetChar( i ) );
</code>

Replace line 657:
<code>
compile( s.GetChar( i ) );
</code>
with:
<code>
compile((const wxChar) s.GetChar( i ) );
</code>

Replace line 780:
<code>
draw( s.GetChar( i ) );
</code>
with:
<code>
draw((const wxChar) s.GetChar( i ) );
</code>

**Edit ~/Downloads/therion/loch/lxSTree.cxx**

Replace line 55:
<code>
: wxMiniFrame(parent, wxID_ANY, _(" Selection"),wxDefaultPosition, wxDefaultSize, (wxSYSTEM_MENU | wxCAPTION | wxCLOSE_BOX | wxRESIZE_BOX | wxRESIZE_BORDER) & (~(wxMINIMIZE_BOX | wxMAXIMIZE_BOX)))
</code>
with:
<code>
: wxMiniFrame(parent, wxID_ANY, _(" Selection"),wxDefaultPosition, wxDefaultSize, (wxSYSTEM_MENU | wxCAPTION | wxCLOSE_BOX | wxRESIZE_BORDER) & (~(wxMINIMIZE_BOX | wxMAXIMIZE_BOX)))
</code>