Notes from when I installed the ImageMagick on jasper on 9-3-2003.

  I wanted another image conversion tool besides Tom's any2any, and Tom 
recommended either xv or the "PBM Toolkit".  I was loading all those
old, US images and wanted to correct some poorly-formed TIF images.
The bad images were giving decompression errors, yet the images appeared
to be ok enough to use.  I wanted a programatic way to remove the errors.

  I got xv, but it didn't have a command line mechanism to convert
image files.

  The "PBM Toolkit" evidently has been renamed to first, "PBM Plus",
then to ImageMagick and is available from www.imagemagick.org.  I got
   -rwxrwxrwx  jasper  staff  6107198 Sep 02 14:38 ImageMagick-5.5.7-10.zip
which created a ImageMagick-5.5.7 directory when unzip'd.

  I had to install X11.adt, especially X11.adt.ext in order to get
/usr/lpp/X11/include/X11/extensions/shape.h and XShm.h.

Then the make bombed with the message
    ld:accessx(): A file or directory in the path name does not exist.
due to a bad line in the ImageMagick-5.5.7/PerlMagick/Makefile.aperl file.
This file is generated, but I didn't understand how, so I manually fixed
the "MAP_LINKCMD=" line from .../aix/CORE/$(PERL_INC)/perl.exp
                          to .../aix/CORE/perl.exp

Then everything compiled cleanly.

  What I got was lots of stuff in
    /usr/local/lib/ImageMagick-5.5.7
    /usr/local/include/magick
    /usr/local/man
    /usr/local/bin
    /usr/local/share/ImageMagick and ImageMagick-5.5.7
The /usr/local/bin files included 
    Magick-config
    PerlMagick
    animate
    composite
    convert
    display
    identify
    import
    mogrify
    montage
Now to figure out what these are and how to use them.  Time to RTFM.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  Hey!  I found some HTML documentation in /usr/local/share/ImageMagick-5.5.7/www,
so a quick cd ~jasper/public_html
     and a cp -pR /usr/local/share/ImageMagick-5.5.7/www ImageMagick
allowed me to see it at http://w3/~jasper/ImageMagick.

A good place to start is http://w3/~jasper/ImageMagick/tools.html.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Other interesting commands are  mogrify to transform an image,
                           and identify to describe  an image.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

The convert command looks interesting, but from patimg1, after I
   cp -p /cdrom/usp001/usp001/00/000/00000013.tif ~jasper
I tried a
   convert 00000013.tif 13.tif
command, but it gave me
   convert: TIFF library is not available (00000013.tif)
                 [A system call received a parameter that is not valid.].

There was something about the TIF libraries when I built this.  Time to do
more RTFM-ing.

Ah, here it is, in the README.txt ...
      ImageMagick requires Sam Leffler's TIFF software available via
      anonymous FTP at

         ftp://ftp.remotesensing.org/pub/libtiff/

      or via HTTP at

         http://www.libtiff.org/ (which no longer exists evidently)

      to read the TIFF image format. It in turn optionally requires the
      JPEG and ZLIB libraries. Support for JPEG, ZIP, and LZW compression
      must be explicitly enabled by editing libtiff Makefiles. The TIFF
      library no longer includes support for LZW compression due to patent
      issues. If you need to use LZW compression, support is available via
      a seperate LZW compression kit (a patch) at the sites listed above.

I downloaded tiff-v3.5.7.tar.gz from the FTP site, which when 
   gzip -d <tiff-v3.5.7.tar.gz | tar xf -
created a tiff-v3.5.7 directory.

The README had me do the standard
   configure
   make
   su
   make install

Now back to the ImageMagick-5.5.7 directory to remake that,
   cd ~/ImageMagick-5.5.7
   make distclean
   configure
   make
Fix the same "MAP_LINKCMD=" line in that PerlMagick/Makefile.aperl file
since I'm still too ignorant on how to properly fix it.
In the file PerlMagick/Makefile.PL.in, is a subroutine named MY::makeaperl
that has $inherited =~ s:MAP_LINKCMD\s.*\s*\$\(CC\):MAP_LINKCMD   = \$(PERLMAINCC) -L@MAGICKLIBDIR@: ;

What is that $inherited variable before & after?

It's the configure step that reads that PerlMagick/Makefile.PL.in file,
to generate the PerlMagick/Makefile.aperl file.  But how to modify that
original PerlMagick/Makefile.PL.in file, requires me to know more about
Perl OO programming.

   su
   make install

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Starting over.

Rebuild tiff-v3.5.7, this time with
  configure --prefix=/local

Still had to change "Directory for manual pages:" from /usr/local/man
                                                    to /local/man
  make
  make install

Still get errors when running tiffinfo, e.g.
  tiffinfo 00000013.tif
produces
exec(): 0509-036 Cannot load program tiffinfo because of the following errors:
        0509-150   Dependent module libtiff.a(shr.o) could not be loaded.
        0509-022 Cannot load module libtiff.a(shr.o).
        0509-026 System error: A file or directory in the path name does not exist.

until I do a
  export LIBPATH=/local/lib
and now a
  tiffinfo 00000013.tif
produces the right output, namely
TIFF Directory at offset 0x8
  Subfile Type: multi-page document (2 = 0x2)
  Image Width: 2320 Image Length: 3408
  Resolution: 300, 300 pixels/inch
  Bits/Sample: 1
  Compression Scheme: CCITT Group 4
  Photometric Interpretation: min-is-white
  FillOrder: msb-to-lsb
  Artist: "1996-98 AccuSoft Inc., All rights reserved"
  Date & Time: "2000: 1:12 09:47:24"
  Software: "[1]0;1;0;1;1;META-63021;.002"
  Orientation: row 0 top, col 0 lhs
  Samples/Pixel: 1
  Rows/Strip: 3408
  Planar Configuration: single image plane
  Page Number: 0-1


I changed my .kshrc to add LIBPATH=/local/lib and /local/man to my MANPATH
so at least for me, tiffinfo works.  Hmmmmm.  Not the best solution, but I
don't know what else I can do to fix this.  Unless you put the libtiff.a
shared library in a well-known place (i.e /usr/lib), tiffinfo will fail.

Brrzzztt!!!  Putting LIBPATH things in my .kshrc was the WRONG thing to do!
             Subsequent configure's & make's failed.  I removed it.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

I'm going to try rebuilding tiff-v3.5.7 with --prefix=/usr
  cd
  rm -rf tiff-v3.5.7
  gzip -d <tiff*gz | tar xf -
  cd tiff-v3.5.7
  configure --prefix=/usr

Adjusting the default target directories to
  TIFF configuration parameters are:

  [ 1] Directory for tools:               /usr/bin
  [ 2] Directory for libraries:           /usr/lib
  [ 3] Directory for include files:       /usr/include
  [ 4] Directory for manual pages:        /usr/man
  [ 5] Directory for HTML documents:      /u/jasper/public_html/libtiff
  [ 6] Manual page installation scheme:   sysv-source-strip

  su
  make install
  exit

That's better in that tiffinfo now works without needing one to modify their
LIBPATH environment variable.  And the tiff*.h files are in /usr/include.

Note where I tried to put the HTML docs, but the make install didn't install
any there.  Hmmmm.  I had to
  cp -pR html ~/public_html/libtiff
and now http://w3/~jasper/libtiff give you the HTML-based help.

Now to try rebuilding ImageMagick-5.5.7.
  cd
  rm -rf ImageMagick-5.5.7
  unzip -x ImageMagick-5.5.7-10.zip
  cd ImageMagick-5.5.7
  configure
  
Yay!  Now ImageMagick's configure easily finds the tiff package
  checking for TIFF support ... 
  checking tiff.h usability... yes
  checking tiff.h presence... yes
  checking for tiff.h... yes
  checking tiffio.h usability... yes
  checking tiffio.h presence... yes
  checking for tiffio.h... yes
  checking for TIFFOpen in -ltiff... yes
  checking for TIFFClientOpen in -ltiff... yes
  checking for TIFFIsByteSwapped in -ltiff... yes
  checking for TIFFReadRGBATile in -ltiff... yes
  checking for TIFFReadRGBAStrip in -ltiff... yes
  checking if TIFF package is complete... yes
  checking tiffconf.h usability... yes
  checking tiffconf.h presence... yes
and all is well.

Now for the
  make
Ooops.  Still gotta fix the same "MAP_LINKCMD=" line in that
PerlMagick/Makefile.aperl file.  Then the
  make
finishes ok.

But after playing with just the tiff-v3.5.7 package, especially
  tiffinfo (similar to anyinfo)
and tiffcp (similar to any2any), I'm not convinced I need this
ImageMagick-5.5.7 package.

And, can I build tiffinfo & tiffcp without the need for libtiff.a?
Why, YES, I can!!  Just say 
  configure --with-DSO=no
then do the
  make
as normal.

The result is 600K executables instead of 30-80K, but they ARE
self-contained.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -