Get and install the Trolltech QT Framework. Download it from [http://www.qtsoftware.com/downloads QTsoftware]. Select the "LGPL / Free" version. Select the "Download Qt 4.x libraries for Mac" and download the default Carbon set if you want to build for Tiger 10.4 and Leopard 10.5 (I didn't test the Cocoa version yet).

Get and install the Trolltech QT Framework. Download it from [http://www.qtsoftware.com/downloads QTsoftware]. Select the "LGPL / Free" version. Select the "Download Qt 4.x libraries for Mac" and download the default Carbon set if you want to build for Tiger 10.4 and Leopard 10.5 (I didn't test the Cocoa version yet).

−

===Install Macports===

+

===Install Macports (*)===

''Note: If you don't want to install MacPorts you can also download the binary svn version from [http://www.open.collab.net/downloads/community/ collab.net]. This enables you to skip this step (Install MacPorts) and the following step (install subversion). You don't need subversion anyway if you download a "release source package".''<br>

''Note: If you don't want to install MacPorts you can also download the binary svn version from [http://www.open.collab.net/downloads/community/ collab.net]. This enables you to skip this step (Install MacPorts) and the following step (install subversion). You don't need subversion anyway if you download a "release source package".''<br>

If you don't have it already, install MacPorts, which provides the <tt>port</tt> command, from [http://www.macports.org MacPorts], giving you compilable package access to thousands of pieces of open source software. If you already have macports (formerly darwinports) installed, update it: <blockquote><pre>$ sudo port selfupdate</pre>Make sure you have synced the latest port files:<pre>$ sudo port -d sync</pre></blockquote>

If you don't have it already, install MacPorts, which provides the <tt>port</tt> command, from [http://www.macports.org MacPorts], giving you compilable package access to thousands of pieces of open source software. If you already have macports (formerly darwinports) installed, update it: <blockquote><pre>$ sudo port selfupdate</pre>Make sure you have synced the latest port files:<pre>$ sudo port -d sync</pre></blockquote>

Introduction

Panini is a visual tool for creating perspective views from panoramic and wide angle photographs. More than a pano viewer, more than a view camera, with features of both. For Linux/Unix, Win32, and Mac systems with OpenGL 2.0.
You can find Panini on Panini's project area on Sourceforge.net.

This wiki page explains how to build Panini on MacOSX and it contains two "build" sections.

Build Panini straightforward for your system only.

Build a complete portable Universal Panini (for distribution).

Note: The steps with an asterix between brackets (*) behind it are only neccessary if you build from svn source. If you download the "panini-0.63.94R-src.zip" source package, you don't need MacPorts or svn.

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 and Xcode 3.1.x for 10.5.x (Leopard).

Install QT

Get and install the Trolltech QT Framework. Download it from QTsoftware. Select the "LGPL / Free" version. Select the "Download Qt 4.x libraries for Mac" and download the default Carbon set if you want to build for Tiger 10.4 and Leopard 10.5 (I didn't test the Cocoa version yet).

Install Macports (*)

Note: If you don't want to install MacPorts you can also download the binary svn version from collab.net. This enables you to skip this step (Install MacPorts) and the following step (install subversion). You don't need subversion anyway if you download a "release source package".

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:

$ sudo port selfupdate

Make sure you have synced the latest port files:

$ sudo port -d sync

Subversion (SVN)

You need to get and install Subversion from MacPorts as Tiger comes without subversion and Leopard has a way too old version of subversion.

$ sudo port install subversion

General "pre-build" steps

Get Panini from SVN

Check out the Panini sources from SVN and download them into your home directory (for example), like:

$cd ~
$ svn co https://pvqt.svn.sourceforge.net/svnroot/pvqt Panini

This will create a Panini directory with the Panini source inside.
If you are asked to accept the ssl key from the sourceforge svn server, you need to accept it: either temorarily (p) or permanently (p).

Make XCode project

Cd into the Panini directory. Open the "panini.pro" file in a text editor.
The first four lines are

Change the "Panini-d" also to "Panini". The Xcode project will always start in debug mode. Therefore, your application will always be called "Panini-d" even if you change your project to "Release".

Now run the following command inside the Panini source code directory:

$ qmake panini.pro

This will create your Panini.xcodeproj project.

Build Panini straightforward for your system only

As mentioned: You can build Panini straightforward with the generated XCode project. This will generate an application that will run perfectly on your system, but on your system only.
You can also build it as a complete portable Universal application which will run on any 10.4.x Tiger or 10.5.y Leopard Mac. See the next section of this wiki for that build type.

Once your project has opened you see the the long rectangular "Project" button. Click it and set your project to "Release" and to your Mac's architecture: "PPC" or "i386" (it will default to the correct one).

Navigate to "Targets" and open it so that you can see the "Panini" target. Select the Panini target and right-click (or ctrl-click) it and select "build Panini".

Close this popup window. You will see a new "Run Script" build phase added.

Right-click (or Ctrl-click) the "Run Script" phase and rename it to "Complete bundle".

Build Panini

Now you can right-click (or Ctrl-click) the Panini target. Select the "Build Panini" option and wait untill it's finished building.Note: The Panini.app in your source-directory/build/Release directory is the correct Universal one, not the one in your root source directory.

Once this build has finished successfully, you can copy it to any location but "/Applications" would be the most appropriate location.

Distributing the Universal Panini

Create a directory "Panini-<version>-mac" where version is your Panini version, like 0.63.90

Copy the Panini.app from your "<Panini_source_directory>/build/Release" into this newly created "Panini-<version>-mac" directory.

Copy the "GPLversion3.txt", the "panini-<version>-release.txt", the "panini-build.txt" and the "panini-usage.txt" from the source directory also into this Panini-<version>-mac directory.

With Finder go to "/Applications/Utilities" and start the "Disk Utility.app".

From the menu select "File -> New -> Disk Image from Folder"

Select the created "Panini-<version>-mac" directory.

Make a standard compressed dmg image and share the resulting "Panini-<version>-mac.dmg" with the world.