Build pano12 from sourcecode - Revision history

Erik Krause: 1 revision(s)

2007-03-21T18:09:01Z

1 revision(s)

Yuval: reworded first paragraph so that when people search for compile they find this page too

2007-03-21T18:07:00Z

reworded first paragraph so that when people search for compile they find this page too

Yuval: reworded first paragraph so that when people search for compile they find this page too

2006-10-22T19:15:27Z

reworded first paragraph so that when people search for compile they find this page too

Bruno: remove out of date CVS instructions, SVN instructions needed

2006-10-22T18:25:28Z

remove out of date CVS instructions, SVN instructions needed

WikiSysop at 16:37, 15 July 2006

2006-07-15T16:37:17Z

WikiSysop: 13 revision(s)

2006-07-13T20:34:47Z

13 revision(s)

WikiSysop: 1 revision(s)

2006-07-13T19:57:48Z

1 revision(s)

Bruno: update CVS instructions

2006-05-29T17:10:55Z

update CVS instructions

Bruno: update CVS instructions

2006-05-29T17:10:55Z

update CVS instructions

New page

= Building PANO12.DLL for Windows =

I'm no Windows expert, this tutorial is the first time I used these tools to
build software, so if I can do it, so can you.

The purpose of this exercise is to roll your own version of the [[pano12|pano12
Panorama Tools library]]. You might want to do this for fun, to play with
extending the code, fixing bugs or simply to remove the [[Field of View]]
restrictions on [[Fisheyes|fisheye]] input images.

== Set-up the build environment ==

To start you need a Free C compiler and associated tools, so
[http://www.mingw.org/download.shtml Download MinGW and MSYS]. I grabbed the
"Windows Installer" versions: '''MinGW-4.1.1.exe''' and '''MSYS-1.0.10.exe'''.

The first one is the "Minimalist Gnu for Windows", it provides a win32 version
of the GNU compiler and related tools.

The second is a "Minimal SYStem", this provides a
[http://en.wikipedia.org/wiki/POSIX POSIX] environment. Answer yes to the
questions and enter the directory where you installed MinGW when asked:

C:\MinGW

== Download the source-code ==

First you need panorama tools itself, so
[http://sourceforge.net/project/showfiles.php?group_id=96188 download pano12
sourcecode], I downloaded '''libpano12-2.7.0.10.zip'''. You can view the source documentation for pano12.dll [http://www.panotools.info/members/documentation/pano12/index.html HERE].

You also need the sourcecode for the various libraries required by pano12,
these are [http://www.zlib.net/ zlib],
[http://www.libpng.org/pub/png/libpng.html libpng], [http://www.ijg.org/
libjpeg] and [http://www.libtiff.org/ libtiff]. There is no longer any need to
download the Java development kit as MinGW now includes a Free version.

I downloaded '''zlib123.zip''', '''lpng128.zip''', '''jpegsr6.zip''' and
'''tiff-v3.5.7.zip''' (I would normally download the ''.tar.gz'' versions, but
Windows seems to have some kind of ''.zip'' extractor built-in so I thought I'd
try that). Note that I had trouble with a later version of libtiff, tiff-v3.5.7
is the one that worked for me.

Extract the files into directories called '''libpano12''', '''zlib''', '''libpng''',
'''libjpeg''' and '''libtiff'''.

If you want to create LZW compressed [[TIFF]] files with [[PTmender]], then download
'''libtiff-lzw-compression-kit-1.5.tar.gz''', extract the tif_lzw.c file and
overwrite the one supplied in this old version of libtiff.

The default MSYS ''home'' on this system is '''C:\msys\1.0\home\Bruno''',
so I put these directories in there.

== Build everything ==

Double-click ''MSYS'' and you should get a small window with a command-line,
this is a POSIX shell.

The following commands need to be typed into the shell. If you make a mistake,
just type ''cd'' to return to your ''home'' and try again.

Compilation results in lots of text scrolling very fast up the screen, ignore
any warnings, but error messages will give you a clue when things are not
working properly.

=== Build zlib ===

cd zlib
./configure
make
make install
cd

=== Build libpng ===

cd libpng
cp scripts/makefile.gcc Makefile
make
cp png.h /usr/local/include
cp pngconf.h /usr/local/include
cp libpng.a /usr/local/lib
cd

=== Build libjpeg ===

cd libjpeg
./configure
make
make install
make install-lib
make install-headers
cd

=== Build libtiff ===

cd libtiff
./configure
make
cp libtiff/*.h /usr/local/include
cp libtiff/*.a /usr/local/lib
cd

=== Build libpano12 ===

cd libpano12
./configure
make
make install
cd

This final step will create the ''binaries'' in this directory:

C:\msys\1.0\local\bin

Look for '''[[PTOptimizer|PTOptimizer.exe]]''', '''[[pano12|pano12.dll]]''',
'''[[panoinfo|panoinfo.exe]]''', '''[[PTmender|PTmender.exe]]''' and
'''[[PTblender|PTblender.exe]]'''.

== Finishing up ==

The files can be ''stripped'' to remove unused symbols - This isn't necessary,
but it does make them smaller:

strip /usr/local/bin/pano12.dll
strip /usr/local/bin/panoinfo.exe
etc...

Now just copy them to whichever location they are needed to run your
application.

== Further tasks ==

Of course, the reason you are rolling your own is in order to make
modifications or to try out the latest code, so here are some suggestions:

=== Increasing the fisheye field-of-view restriction ===

This is the '''MAX_FISHEYE_FOV''' constant in the filter.h file (which defaults
to 160 degrees), increase it to something larger like 720. Then rebuild the
library:

make
make install

You will need a decent text editor to change sourcecode, Notepad or Word ''will not do''.

=== Getting the latest CVS version ===

CVS is a source-code management system that allows multiple users to share the
same set of files online.

You need a CVS client in order to ''checkout'' the code, so
[http://www.mingw.org/download.shtml Download the MSYS Developers Toolkit] which is part of MinGW
(I grabbed the '''msysDTK-1.0.1.exe''' installer).

Instructions for getting the code are on the [http://panotools.sourceforge.net
panotools sourceforge site], but it is usually as simple as typing this into the shell:

cvs -d:pserver:anonymous@panotools.cvs.sourceforge.net:/cvsroot/panotools login
cvs -z3 -d:pserver:anonymous@panotools.cvs.sourceforge.net:/cvsroot/panotools co libpano

(Hit enter when asked for a password)

This will create a directory containing the latest code called '''libpano''' (which you may rename).

The build system needs to be ''bootstrapped'' before you can run the '''configure''' script, this
is done by running the '''bootstrap''' script:

./bootstrap

In the future, updating this CVS version to the latest code is as simple as running the
''update'' command:

cd libpano
cvs update

[[Category:Tutorial]][[Category:Tutorial:Nice to know]]

Bruno: extra step top enable LZW compression

2006-05-10T15:53:33Z

extra step top enable LZW compression

← Older revision		Revision as of 18:07, 21 March 2007
Line 145:		Line 145:
	You will need a decent text editor to change sourcecode, Notepad or Word ''will not do''.		You will need a decent text editor to change sourcecode, Notepad or Word ''will not do''.

−	~~[[Category:Tutorial]]~~[[Category:Tutorial:Nice to know]]	+	[[Category:Tutorial:Nice to know]]

@@ Line 2: / Line 2: @@
 I'm no Windows expert, this tutorial is the first time I used these tools to
-build software, so if I can do it, so can you.
+build software, so if I can do it, so can you compile the panotools.
 The purpose of this exercise is to roll your own version of the [[pano12|pano12

@@ Line 27: / Line 27: @@
 First you need panorama tools itself, so
-[http://sourceforge.net/project/showfiles.php?group_id=96188 download pano12
+[http://sourceforge.net/project/showfiles.php?group_id=96188 download pano12 sourcecode],
-sourcecode], I downloaded '''libpano12-2.7.0.10.zip'''.
+I downloaded '''libpano12-2.7.0.10.zip'''.
 You also need the sourcecode for the various libraries required by pano12,
 these are [http://www.zlib.net/ zlib],
-[http://www.libpng.org/pub/png/libpng.html libpng], [http://www.ijg.org/
+[http://www.libpng.org/pub/png/libpng.html libpng], [http://www.ijg.org/ libjpeg]
-libjpeg] and [http://www.libtiff.org/ libtiff].  There is no longer any need to
+and [http://www.libtiff.org/ libtiff].  There is no longer any need to
 download the Java development kit as MinGW now includes a Free version.
@@ Line 144: / Line 144: @@
 You will need a decent text editor to change sourcecode, Notepad or Word ''will not do''.
 [[Category:Tutorial]][[Category:Tutorial:Nice to know]]

← Older revision	Revision as of 20:34, 13 July 2006
(One intermediate revision by one user not shown)

@@ Line 157: / Line 157: @@
 panotools sourceforge site], but it is usually as simple as typing this into the shell:
-   cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/panotools login
+   cvs -d:pserver:anonymous@panotools.cvs.sourceforge.net:/cvsroot/panotools login
-   cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/panotools co libpano
+   cvs -z3 -d:pserver:anonymous@panotools.cvs.sourceforge.net:/cvsroot/panotools co libpano
 (Hit enter when asked for a password)

@@ Line 44: / Line 44: @@
 Extract the files into directories called '''libpano12''', '''zlib''', '''libpng''',
 '''libjpeg''' and '''libtiff'''.
 The default MSYS ''home'' on this system is '''C:\msys\1.0\home\Bruno''',