Instructions for compiling Snibgo's ImageMagick filters from source

Updated April 2018

It's not hard, but requires a clear head when following the procedures.... (try not to do it at 1 am). You also need to be patient: one of the compiling steps take 20 minutes, another took 3h20m! If you miss removing one of the modules, it's another 4h before you can test. I need to thank snibgo for his generosity in helping me through the versioning issues I came across.

Snibgo's ImageMagick filters (http://im.snibgo.com/index.htm) are cool! Stick with his documentation and the extra pointers here and you might be lucky enough that it will be ready in a day. When dealing with linux-related installs, I have always missed something, had to chase down a library, modify a variable name, remove deprecated functions, update an old function call with a new one, so it is never an evening or two. Double your estimate and increase it by an order of magnitude.

Primary guide: http://im.snibgo.com/customim.htm#dev BUT BEFORE YOU FOLLOW THAT BLINDLY, compare it with what I had to do (in purple font). Snibgo is already modifying his pages/code, so you may not have to do much here after all. Some of the differences arise from ImageMagick 7 being a different version from snibgo's 6, some of it may be updated CygWin modules. I have NOT gone the linux route for running IM. This extra guide is as much for others as it will be to my future self the next time I change computers and have to do this again.

1. The computer is running Windows, with Cygwin. See snibgo's IM with Cygwin page.
   • Make a restore point and backup current stuff [good practice].
   • Download Cygwin and put it in its own folder (I put it in a subfolder called "Cygwin" in the folder "Downloads" so I could find it easily)
   • Install Cygwin. This runs as a conventional Windows installation, but you are given the choice of what packages to install. You probably want "bc" and "gnuplot", which are in "math", and are not installed by default.
   • also in the Cygwin window, look for "make", "automake", "autoconf" [likely these were default installed when snibgo originally did this, but they were not default installed in March 2018, so I had to go back and do it. Also search for libtools (the latter in order to combat the output: "configure: error: libltdl is required for modules and OpenCL builds". After failing to get CygWin to do anything more than download the zip file , I found a solution on the net: https://stackoverflow.com/questions/24466246/how-can-i-install-libtoolize-in-cygwin.. Oddly, automake came into my bin directory as "automake-1.9", so in order for the command "automake" to work, you need to create a symlink (in /usr/bin) "ln -s automake-1.9 automake"
   • Side note for CygWin use - when you need to have it fetch another module, simply double-click the "setup-x86_64.exe" - don't worry, it won't re-install the whole schmear although that's what it looks like it is doing.
2. Download IM source, build, and install as per snibgo's Compiling IM with Cygwin page, keeping the following in mind
   • The IM installation directory is not the same thing as the IM source code directory!
   • start bash before doing the wget command, cd to ~
   • Like snibgo, I chose mkdir ~/iminst [/home/yourname/iminst] for the install directory
   • I chose "Building the Windows Source" section, NOT the "Building the Unix Source" one
   • You will be installing directly IM7, so you have to partially skip the upgrade section
   • once unzipped, cd ImageMagick-7.0.7 (or whatever the newer version happens to be)
   • run the ./configure command except with --prefix=/home/yourname/iminst
   • complete the rest of snibgo's instructions (make, then make install, test) except for the copy of the filters (we'll do that later)
   • NOTE! When testing, you will need to run "magick convert ..." instead of simply "convert" because IM7 has changed
3. Next Compiling the MagickWand demonstration programs page. [very straightforward and 15 minutes to do
   • I followed the compile examples as given on the IM wand and core pages. Interestingly, the wand and core examples worked,
   • but the IM official page's demo compilation:
   • "c++ `Magick++-config --cxxflags --cppflags` -O2 -o demo demo.cpp `Magick++-config --ldflags --libs`" did not. However, snibgo's
   • "c++ `Magick++-config --cxxflags --cppflags` -O3 -march=native -o button.exe button.cpp `Magick++-config --ldflags --libs`" worked.
   • I did not bother with the historical methods, as they are for reference only.

Okay so far I hope. Back to snibgo's http://im.snibgo.com/customim.htm#dev, recognizing that for him, this is the development environment, and for us, it is just the latest IM (which we did in step 2 above).

Once you get down to "Edit imdevsrc/filters/Makefile.am, replicating references to analyze. My current version of Makefile.am is shown below."

Use snibgo's version, but, until he has uploaded the following files into the batZip first edit his Makefile.am to remove references to:

• srchmask.inc
• paintpatch

Uunzip his Zipped BAT files into the filters directory

Modify these .inc files from "magick_threads" to "magick_number_threads":

filters/rmsealpha.inc line 269

filters/calcmnsd.inc: line 59

filters/whatrot.inc: line 253

compiler error: macro "VIRT_NONE" requires 2 arguments, but only 1 given

VIRT_NONE(cln); a few routines I had to add ", exception"

avgconcrings.inc: VIRT_NONE(cln);

virtnone.inc: #define VIRT_NONE(img)

whatrot.c: VIRT_NONE(sub_img);

whatrot.inc: VIRT_NONE(clnA);

whatrotscale.c: VIRT_NONE(main_ing);

whatrotscale.inc: VIRT_NONE(clnSub);

filters/cols2mat.inc:866:17: error: too few arguments to function 'AcquireKernelInfo'

c2m->kernel = AcquireKernelInfo ("6x6:1,0,0,0,0,0,0,1,0,0,0,0,0,0,1,0,0,0,0,0,0,1,0,0,0,0,0,0,1,0,0,0,0,0,0,1");

changed line 866 to read:

c2m->kernel = AcquireKernelInfo ("6x6:1,0,0,0,0,0,0,1,0,0,0,0,0,0,1,0,0,0,0,0,0,1,0,0,0,0,0,0,1,0,0,0,0,0,0,1", exception);

filters/cols2mat.c:247:57: error: 'image' undeclared (first use in this function)

ChannelType channel_mask = SetImageChannelMask (image, RedChannel);

changed lines 247, 253, 259, 265, "image" to "new_img"

Other notes:

automake - took ~5 minutes

autoconf - took ~5 minutes

./configure took ~15 minutes

make took ~ 3h20m !

make install

And.... does it work? YES!!!