View source for Install Panotools-Script on Windows

'''Panotools::Script''' is a framework for scripting various panorama
operations using the command-line tools shipped with [[hugin]], it has some
[http://search.cpan.org/dist/Panotools-Script/ Documentation on CPAN].

== Perl ==

'''Panotools::Script''' is a ''Perl module'', so for Windows you need to
[http://www.activestate.com/store/activeperl/download/ download and install ActiveState Perl]
first, I got the MSI installer for ActivePerl-5.8.8.822.

For some reason, the installer doesn't set the PATH correctly for manually
built modules, so go to '''Explorer''' -> '''My Computer''' -> '''right-click'''
-> '''Properties''' -> '''Advanced''' -> '''Environment Variables''' ->
'''System variables'''. Scroll to '''Path''', click '''edit''', and add this path
to the front of the existing list of paths:

  C:\Perl\site\bin; 

=== Math::Matrix and Module::Build ===

You need two extra ''modules'' that are not installed by default. So in the Activestate
part of the ''Start menu'', run the Perl Package Manager (PPM).  This can be used to
install pre-built add-on modules, in this case you want to install ''Math-Matrix''
and ''Module-Build''.  Reboot after installing Module-Build, remember this ''is'' windows.

== ImageMagick ==

[[ImageMagick]] is a general purpose command-line image manipulation suite,
'''Panotools::Script''' uses it for various purposes such as resizing and playing
with alpha channels. I downloaded the ''Win32 dynamic at 16 bits-per-pixel'' version
[http://www.imagemagick.org/script/binary-releases.php#windows from the ImageMagick site].
Make sure that you select ''Install perlMagick for ActiveState Perl'' when you run the
installer.

== hugin ==

Install [[hugin]] from the
[http://sourceforge.net/project/showfiles.php?group_id=77506 sourceforge download area]
if you haven't already. You need to fix the PATH again, add the hugin installation
location the same as you did for ''Perl'' above:
  
  C:\Program Files\hugin;

== autotrace ==

Autotrace is a tool for converting bitmap images to vector graphics, only
install this if you plan on editing enblend masks in [http://inkscape.org/ Inkscape].

[http://autotrace.sourceforge.net/index.html#download Download autotrace from here].
You need to manually extract and install this one, put the folder containing
the various DLLs and EXE files somewhere like '''C:\Program Files\autotrace''' and
add this to your PATH as you did for Perl and hugin.

== Panotools::Script ==

[http://search.cpan.org/dist/Panotools-Script/ Download the latest source-code for Panotools::Script].
This is a ''gzipped tar archive'', so you will need something like
[http://www.7-zip.org/ 7-zip] to extract it.

=== Download nmake ===

''make'' is required to build and install Perl modules, [http://download.microsoft.com/download/vc15/patch/1.52/w95/en-us/nmake15.exe download nmake from Microsoft]
and double-click it to extract. Copy NMAKE.EXE and NMAKE.ERR to the directory where you extracted the
'''Panotools::Script''' sources.

=== Test and install ===

Open a ''command window'': Click '''Start''' -> '''Run...''' -> '''cmd''' -> '''OK'''.

Change to the directory where you extracted the sources:

  cd Desktop\Panotools-Script-0.09

Then run the tests:

  perl Makefile.PL
  nmake test

The tests will produce lots of output and warnings, but at the end it should
report 100% success.  Finally install everything:

  nmake install

[[Category:Tutorial:Nice to know]]