Cristian Marchi 7:41pm, 28 November 2009
1) GET PANINI
Head to this address and get the source code of Panini by clicking the green rectangular button visible in the middle of the following screenshot:
Panini tutorial-1.png by Cristian Marchi


When prompted, save the file in your computer and remember were it has been saved.
After the download has finished, locate the Panini zipped package with a file browser and extract it by right-clicking and selecting "extract here" (as illustrated in the following screenshot).
Panini tutorial-2.png by Cristian Marchi


A new folder will be created containing all the Panini source code.


2) GET THE DEPENDENCIES
Now we are going to get the needed packages to successfully build Panini.
Open a terminal window by selecting "Applications->Accessories->Terminal"
In the window that appears, paste (or write) the following command:

sudo apt-get install libqt4-dev libqt4-opengl-dev qt4-dev-tools g++ subversion

Note in Ubuntu natty you will also need to install zlib1g-dev so enter the following command (thanks to BenAndAsho for pointing this out):

sudo apt-get install libqt4-dev libqt4-opengl-dev qt4-dev-tools g++ subversion zlib1g-dev

When the password is entered and the enter command pressed, the terminal will show you a list of all packages that it is going to install. In the following screenshot, taken after issuing the command in a clean install of Ubuntu 9.10 Karmic Koala, you could see that are going to be downloaded more than 200MB of files (that's pretty much but without them you will not be able to install Panini).
Panini tutorial-3.png by Cristian Marchi


Type "Y" when prompted and then press "Enter". After some time, depending on your internet and pc speed, the installation ends and will be the time to proceed to next step.

3) BUILD THE PROGRAM
Again from a terminal window, navigate with the "cd" command to the directory where the Panini source code was extracted in step 1. When in this folder, type the command:

qmake panini.pro

When it has finished, type (this command will take some time to execute):

make

Panini tutorial-4.png by Cristian Marchi


If you didn't get any error message, open a file browser and navigate to the Panini source code folder; here you will find a file named "Panini". That's the executable file! by double-clicking on it Panini should start!

That could be enough to use Panini but if you want to integrate it better with the Desktop environment, read the following last step.


4) CREATE THE FANCY MENU SHORTCUT
To create the menu entry for Panini, we will use the Ubuntu Menu editor. Go to "System->Preferences->Main Menu" as shown below:
Panini tutorial-5.png by Cristian Marchi


On the window that will open, select the "Graphics" entry on the left pane and press "New Item" in the upright corner as shown in the next screenshot:
Panini tutorial-6.png by Cristian Marchi


A dialog will popup in which are present some empty fields that need to be filled up. In particular, set the name as "Panini" and the comment as "Panorama viewer".
After this we need to complete the command field by selecting the Panini executable. Press the "Browse..." button next to the command field and navigate in the file browser window that will appear, to the Panini executable in the main folder where the Panini source code was extracted and compiled (see the following screenshot):
Panini tutorial-7.png by Cristian Marchi


Finally we need to select an icon for the program. So click on the icon button on the left upper corner, navigate (by pressing the "browse button") to the path where panini source code was extracted and select the "/ui" subdirectory. Select the icon with the .jpg extension and press "Ok"
Panini tutorial-8.png by Cristian Marchi

Panini tutorial-9.png by Cristian Marchi


All the fields all now completed; you can press "Ok" in the "Create Launcher" dialog and close the main menu editor window

Close the menu editor and that's it!

Now if you go to Applications->Graphics you will find the Panini entry and, by clicking it, Panini will start!
Panini tutorial-10.png by Cristian Marchi


Now is possible to open in Panini equirectangular images like those and move the view to your liking.
Enjoy your views!
Panini tutorial-11.png by Cristian Marchi
Groups Beta