[http://developer.apple.com/tools/download/ Download] and install the XCode Tools version for your MacOSX version: Xcode 2.5.x for MacOSX 10.4.x or below and Xcode 3.1.x for 10.5.x (Leopard). You will not use the Xcode development environment itself, but the MacOSX system comes without the GNU compiler, builder, linker and so on.

+

[http://developer.apple.com/tools/download/ Download] and install the XCode Tools version for your MacOSX version: Xcode 2.5.x for MacOSX 10.4.x or below, Xcode 3.1.x for 10.5.x (Leopard) and Xcode 3.2.x for 10.6.x (Snow Leopard). You will not use the Xcode development environment itself, but the MacOSX system comes without the GNU compiler, builder, linker and so on.

−

===Install CMake===

+

===Fink commander===

−

Get and install the build system CMake, version 2.4.8, from [http://www.cmake.org/HTML/Download.html CMake].

+

''Note: This tutorial describes how to build Hugin with MacPorts. This should more or less be the same for Fink. All references to <tt>/opt/local</tt> that are mentioned here for MacPorts should be changed with <tt>/sw</tt> for Fink.''

''Note: This tutorial describes how to build Hugin with MacPorts. This should more or less be the same for Fink. All references to <tt>/opt/local</tt> that are mentioned here for MacPorts should be changed with <tt>/sw</tt> for Fink.''

+

- edit your "/opt/local/etc/macports/macports.conf" and set "universal_archs" to "x86_64 i386" (off course without the double quotes).

You may find [http://porticus.alittledrop.com/ Porticus] helpful with [http://www.macports.org/ MacPorts]

+

You may find the GUI frontend [http://porticus.alittledrop.com/ Porticus] helpful with [http://www.macports.org/ MacPorts]

+

+

===Install CMake===

+

Install cmake from MacPorts:

+

<pre>

+

sudo port install cmake

+

</pre>

+

+

Alternatively, you can download a prepackaged installer from [http://www.cmake.org/HTML/Download.html CMake].

+

+

===Mercurial (HG)===

+

You need to get and install Mercurial from MacPorts as the Hugin development trunk is in a Mercurial repository.<br>

+

''Note: Hugin used to be in an SVN repository but in mid May 2010 it was moved to Mercurial''

+

===Subversion (SVN)===

===Subversion (SVN)===

You need to get and install Subversion from MacPorts. If you fancy a nice GUI you can download the Open-Source [http://www.lachoseinteractive.net/en/community/subversion/svnx/features/?sid=b42441f308810ad0d36b779f90319391 SVNX]. You still need svn installed as it is only a graphical shell and I won't explain SVNX here (I only used it once, I still like the terminal).

You need to get and install Subversion from MacPorts. If you fancy a nice GUI you can download the Open-Source [http://www.lachoseinteractive.net/en/community/subversion/svnx/features/?sid=b42441f308810ad0d36b779f90319391 SVNX]. You still need svn installed as it is only a graphical shell and I won't explain SVNX here (I only used it once, I still like the terminal).

−

''Note: A previous version of this wiki mentioned that you don't need to install SVN on Leopard as it comes pre-installed. however, this pre-installed version is (way) too old so you need the newer version from MacPorts anyway.''

+

''Note: Subversion comes preinstalled in Leopard and Snow Leopard. In Leopard, it is quite old, so you'll want to compile the newer version from MacPorts. In Snow Leopard, the pre-installed version is the quite current 1.6.5, and should be fine.''

Wait as all of these source packages (and it's dependencies) are downloaded and compiled, and installed into /opt/local. Go get a frappe, walk the dog, and total the first 1000 prime numbers in binary.

+

Wait as all of these source packages (and its dependencies) are downloaded and compiled, and installed into /opt/local. Go get a frappe, walk the dog, and total the first 1000 prime numbers in binary.

Open the "libtool" file with an editor and change all occurrences of "-dynamiclib" to "-dynamiclib -arch i386" (2 occurrences).<br>

+

''Note:'' If you want to build universal on Snow Leopard for both i386 and x86_64, change the "-dynamiclib" to "-dynamiclib -arch i386 -arch x86_64" (2 occurrences).

+

<pre>

+

make

+

sudo make install

+

</pre>

+

+

By default the library is installed into <tt>/usr/local/lib</tt>.

+

+

====Build libpano13 from a release version tar.gz====

+

To build libpano from a .tar.gz file, CD into the source directory of the unpacked .tar.gz. This will normally be "libpano13-2.9.xy" where "xy" is the version number. Note that the current Hugin version needs 2.9.18 or newer.

+

Then do the following on Tiger and Leopard:

+

<pre>

+

export CFLAGS="-I/opt/local/include -L/opt/local/lib"

+

export CXXFLAGS="-I/opt/local/include -L/opt/local/lib"

+

./configure --without-java

+

make

+

sudo make install

+

</pre>

+

On Snow Leopard do the following:

+

<pre>

+

export CFLAGS="-arch i386 -I/opt/local/include -L/opt/local/lib"

+

export CXXFLAGS="-arch i386 -I/opt/local/include -L/opt/local/lib"

+

./configure --without-java

+

</pre>

+

Open the "libtool" file with an editor and change all occurrences of "-dynamiclib" to "-dynamiclib -arch i386" (4 occurrences).<br>

+

''Note:'' If you want to build universal on Snow Leopard for both i386 and x86_64, change the "-dynamiclib" to "-dynamiclib -arch i386 -arch x86_64" (4 occurrences).

+

<pre>

+

make

+

sudo make install

</pre>

</pre>

Line 89:

Line 151:

===WxWidgets===

===WxWidgets===

−

Hugin requires wxWidgets, the GUI toolkit currently employed by Hugin, to be at version >= 2.8.7. The current version of wxWidgets at MacPorts is 2.8.8.

+

Hugin requires wxWidgets, which is called wxMac for MacOSX, the GUI toolkit currently employed by Hugin, to be at version >= 2.8.7. The current version of wxWidgets at MacPorts is 2.8.12.

+

Note: Hugin can recently be configured to use WxWidgets 2.9. Note though that this is a development version and Mac OS X is always running a few steps behind.

====Tiger (10.4.x) ====

====Tiger (10.4.x) ====

Line 110:

Line 173:

====Snow Leopard (10.6.x)====

====Snow Leopard (10.6.x)====

−

Snow Leopard comes with WxWindows 2.8.8 so no changes are required.

+

Snow Leopard comes with WxWindows 2.8.8 so no changes are required. An alternative is to build WxWidgets from MacPorts (currently 2.8.12):

If you are asked to accept the ssl key from the sourceforge svn server, do accept it permanently (p). Otherwise the configuring process using cmake will fail.

+

===Create hugin build directory===

===Create hugin build directory===

Create another directory alongside the newly created <tt>hugin/</tt> for the build files (a cool feature of CMake: it doesn't need to pollute your source directory with build files!):

Create another directory alongside the newly created <tt>hugin/</tt> for the build files (a cool feature of CMake: it doesn't need to pollute your source directory with build files!):

Line 139:

Line 201:

</pre>

</pre>

</blockquote>

</blockquote>

−

''Note: You can give this directory any name you want, but hugin_build is chosen for it's clarity.''

+

''Note: You can give this directory any name you want, but hugin_build is chosen for its clarity.''

===Configure build===

===Configure build===

Before we configure hugin we need to set the build environment:

Before we configure hugin we need to set the build environment:

<blockquote>

<blockquote>

<pre>

<pre>

−

export PKG_CONFIG_PATH=/opt/local/lib/pkgconfig

export CFLAGS="-I/opt/local/include -L/opt/local/lib"

export CFLAGS="-I/opt/local/include -L/opt/local/lib"

export CXXFLAGS=$CFLAGS

export CXXFLAGS=$CFLAGS

</pre>

</pre>

</blockquote>

</blockquote>

+

+

''Snow Leopard:''

+

If you are on Snow Leopard you need to use the following C/CXX FLAGS:

+

<blockquote>

+

<pre>

+

export CFLAGS="-arch i386 -I/opt/local/include -L/opt/local/lib"

+

export CXXFLAGS=$CFLAGS

+

</pre>

+

</blockquote>

+

''Note: On Snow Leopard, gcc builds for 64-bit architecture by default. However, some libraries that Hugin depends upon are not yet compilable as 64-bit libraries (such as wxWindows-2.8). Thus, the i386 flag is necessary to force a 32-bit build.''

Configure hugin using cmake from inside the build directory you created:

Configure hugin using cmake from inside the build directory you created:

Line 156:

Line 227:

</pre>

</pre>

</blockquote>

</blockquote>

+

''Note: If you are rebuilding hugin after an svn upgrade or other (system) change, the savest way to proceed is to first remove the "CMakeCache.txt" from your build directory. It contains the build settings for your previous build.''

===Compile Hugin===

===Compile Hugin===

Line 166:

Line 238:

</blockquote>

</blockquote>

Watch the pretty colors go by. Give the dog another quick spin around the block; you're finished. Look for the new bundle <tt>Hugin.app</tt> in <tt>usr/local/Applications/</tt> or in <tt>usr/local/bin/</tt>. Copy or link it to <tt>/Applications</tt>, or your preferred location, and commence testing.

Watch the pretty colors go by. Give the dog another quick spin around the block; you're finished. Look for the new bundle <tt>Hugin.app</tt> in <tt>usr/local/Applications/</tt> or in <tt>usr/local/bin/</tt>. Copy or link it to <tt>/Applications</tt>, or your preferred location, and commence testing.

+

+

If your build fails on Snow Leopard with this error (might happen only after upgrade from Leopard):

Building environment

Download and install XCode

Download and install the XCode Tools version for your MacOSX version: Xcode 2.5.x for MacOSX 10.4.x or below, Xcode 3.1.x for 10.5.x (Leopard) and Xcode 3.2.x for 10.6.x (Snow Leopard). You will not use the Xcode development environment itself, but the MacOSX system comes without the GNU compiler, builder, linker and so on.

Fink commander

Note: This tutorial describes how to build Hugin with MacPorts. This should more or less be the same for Fink. All references to /opt/local that are mentioned here for MacPorts should be changed with /sw for Fink.
You may find Fink Commander helpful. Unfortunately it seems unsupported / unmaintained. The Fink FAQ may help. Can somebody please describe here how to install Fink and Fink Commander?

Install Macports

If you don't have it already, install MacPorts, which provides the port command, from MacPorts, giving you compilable package access to thousands of pieces of open source software. If you already have macports (formerly darwinports) installed, update it to at least version 1.7.0:

Porticus

Install CMake

Mercurial (HG)

You need to get and install Mercurial from MacPorts as the Hugin development trunk is in a Mercurial repository.Note: Hugin used to be in an SVN repository but in mid May 2010 it was moved to Mercurial

Subversion (SVN)

You need to get and install Subversion from MacPorts. If you fancy a nice GUI you can download the Open-Source SVNX. You still need svn installed as it is only a graphical shell and I won't explain SVNX here (I only used it once, I still like the terminal).
Note: Subversion comes preinstalled in Leopard and Snow Leopard. In Leopard, it is quite old, so you'll want to compile the newer version from MacPorts. In Snow Leopard, the pre-installed version is the quite current 1.6.5, and should be fine.

Open the "libtool" file with an editor and change all occurrences of "-dynamiclib" to "-dynamiclib -arch i386" (2 occurrences).Note: If you want to build universal on Snow Leopard for both i386 and x86_64, change the "-dynamiclib" to "-dynamiclib -arch i386 -arch x86_64" (2 occurrences).

make
sudo make install

By default the library is installed into /usr/local/lib.

Build libpano13 from a release version tar.gz

To build libpano from a .tar.gz file, CD into the source directory of the unpacked .tar.gz. This will normally be "libpano13-2.9.xy" where "xy" is the version number. Note that the current Hugin version needs 2.9.18 or newer.
Then do the following on Tiger and Leopard:

Open the "libtool" file with an editor and change all occurrences of "-dynamiclib" to "-dynamiclib -arch i386" (4 occurrences).Note: If you want to build universal on Snow Leopard for both i386 and x86_64, change the "-dynamiclib" to "-dynamiclib -arch i386 -arch x86_64" (4 occurrences).

make
sudo make install

By default the library is installed into /usr/local/lib.

WxWidgets

Hugin requires wxWidgets, which is called wxMac for MacOSX, the GUI toolkit currently employed by Hugin, to be at version >= 2.8.7. The current version of wxWidgets at MacPorts is 2.8.12.
Note: Hugin can recently be configured to use WxWidgets 2.9. Note though that this is a development version and Mac OS X is always running a few steps behind.

Tiger (10.4.x)

Fix a problem on Tiger (10.4.x): Tiger comes with WxWindows version 2.5. The Hugin cmake will search OS paths first and will find Tiger's own version 2.5 instead of your freshly compiled 2.8. You need to get Tiger's 2.5 version out of the way as you won't be able to build Hugin succesfully as long as it is in place.

Leopard (10.5.x)

Fix a problem on Leopard (10.5.x): Leopard comes with WxWindows version 2.8.4. The Hugin cmake will search OS paths first and will find Leopard's own version 2.8.4 instead of your freshly compiled 2.8.8 or above. You need to get Tiger's 2.8.4 version out of the way. Hugin will build succesfully with 2.8.4 and will run. However version 2.8.4 still contains some bugs that will cause "bleeding through" in the graphical CP windows. This means that when things change in wxwidgets objects, sometimes (most of the times) the CP window displays through your current GUI screen.

Note: On Snow Leopard, gcc builds for 64-bit architecture by default. However, some libraries that Hugin depends upon are not yet compilable as 64-bit libraries (such as wxWindows-2.8). Thus, the i386 flag is necessary to force a 32-bit build.

Configure hugin using cmake from inside the build directory you created:

cmake ../hugin

Note: If you are rebuilding hugin after an svn upgrade or other (system) change, the savest way to proceed is to first remove the "CMakeCache.txt" from your build directory. It contains the build settings for your previous build.

Compile Hugin

Compile Hugin and friends:

make
sudo make install

Watch the pretty colors go by. Give the dog another quick spin around the block; you're finished. Look for the new bundle Hugin.app in usr/local/Applications/ or in usr/local/bin/. Copy or link it to /Applications, or your preferred location, and commence testing.

If your build fails on Snow Leopard with this error (might happen only after upgrade from Leopard):

Linking CXX executable celeste_standalone
ld: library not found for -lcrt1.10.6.o

try this before make:

export MACOSX_DEPLOYMENT_TARGET=10.5

Important Note on the produced Bundle

Since the produced Hugin.app bundle links dynamically to libraries outside of the bundle, it is not yet portable, i.e. cannot be copied or shared unless the other machine has the same collection of libraries available in the same places. This is to facilitate development and testing (re-compile external libraries and test without re-building). Building a fully portable universal binary version at the command line is planned.
You can use the Build a MacOSX Universal Hugin bundle with Xcode to build a universal portable bundle.