<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN"> <HTML> <HEAD> <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=ibm437"> <TITLE>Installing Magick++</TITLE> <META NAME="GENERATOR" CONTENT="StarOffice 6.0 (Solaris Sparc)"> <META NAME="AUTHOR" CONTENT="Bob Friesenhahn"> <META NAME="CREATED" CONTENT="20020805;17455123"> <META NAME="CHANGEDBY" CONTENT="Bob Friesenhahn"> <META NAME="CHANGED" CONTENT="20030528;11273200"> <META NAME="DESCRIPTION" CONTENT="C++ API for GraphicsMagick"> <STYLE> <!-- TD P { color: #000000 } H1 { color: #000000 } P { color: #000000 } H3 { color: #000000 } H4 { color: #000000 } BLOCKQUOTE { color: #000000 } A:link { color: #0000ee } A:visited { color: #551a8b } --> </STYLE> </HEAD> <BODY LANG="en-US" TEXT="#000000" LINK="#0000ee" VLINK="#551a8b" BGCOLOR="#ffffff"> <H1 ALIGN=CENTER>Installing Magick++</H1> <H3>General</H3> <P>In order to compile Magick++ you must have access to a standard C++ implementation. The author uses <A HREF="http://gcc.gnu.org/index.html">gcc 3.3 (GNU C++)</A> which is available under UNIX and under the <A HREF="http://www.cygwin.com/">Cygwin UNIX-emulation environment</A>, and <A HREF="http://www.mingw.org/">MinGW</A> compilation toolset, for Windows. Standards compliant commercial C++ compilers should also work fine. Most modern C++ compilers for Microsoft Windows or the Mac should work. A project file generation tool is provided as part of VisualMagick which generates Workspace/Solution files for Microsoft Visual C++ 6.0 and 7.0. </P> <P>It was decided that Magick++ will be around for the long-haul, so its API definition depends on valuable C++ features which should be common in all current and future C++ compilers. The compiler must support the following C++ standard features: </P> <UL> <LI><P STYLE="margin-bottom: 0in">templates </P> <LI><P STYLE="margin-bottom: 0in">static constructors </P> <LI><P STYLE="margin-bottom: 0in">C++-style casts (e.g. static_cast) </P> <LI><P STYLE="margin-bottom: 0in">bool type </P> <LI><P STYLE="margin-bottom: 0in">string class (<TT><string></TT>) </P> <LI><P STYLE="margin-bottom: 0in">exceptions (<TT><exception></TT>) </P> <LI><P STYLE="margin-bottom: 0in">namespaces </P> <LI><P>Standard Template Library (STL) (e.g. <TT><list></TT>, <TT><vector></TT>) </P> </UL> <P STYLE="margin-bottom: 0in">The author has personally verified that Magick++ compiles and runs using the following compiler/platform combinations: </P> <P ALIGN=CENTER STYLE="margin-bottom: 0in"><B>Tested Configurations</B></P> <TABLE WIDTH=100% BORDER=1 CELLPADDING=2 CELLSPACING=3> <COL WIDTH=108*> <COL WIDTH=38*> <COL WIDTH=109*> <TR> <TD WIDTH=42%> <P ALIGN=CENTER><B>Operating System</B></P> </TD> <TD WIDTH=15%> <P ALIGN=CENTER><B>Architecture</B></P> </TD> <TD WIDTH=43%> <P ALIGN=CENTER><B>Compiler</B></P> </TD> </TR> <TR> <TD WIDTH=42%> <P><FONT SIZE=2>SunOS 5.6, 5.7, 5.8, 5.9 ("Solaris 2.6, 7, 8, & 9)</FONT></P> </TD> <TD WIDTH=15%> <P><FONT SIZE=2>SPARC</FONT></P> </TD> <TD WIDTH=43%> <P><FONT SIZE=2>GCC 3.0.4, GCC 3.3</FONT></P> </TD> </TR> <TR> <TD WIDTH=42%> <P><FONT SIZE=2>SunOS 5.7 ("Solaris 7")</FONT></P> </TD> <TD WIDTH=15%> <P><FONT SIZE=2>SPARC</FONT></P> </TD> <TD WIDTH=43%> <P><FONT SIZE=2>Sun Workshop 5.0 C++</FONT></P> </TD> </TR> <TR> <TD WIDTH=42%> <P><FONT SIZE=2>SunOS 5.8 ("Solaris 8")</FONT></P> </TD> <TD WIDTH=15%> <P><FONT SIZE=2>SPARC</FONT></P> </TD> <TD WIDTH=43%> <P><FONT SIZE=2>Sun WorkShop 6 update 2 C++ 5.3</FONT></P> </TD> </TR> <TR> <TD WIDTH=42%> <P><FONT SIZE=2>FreeBSD 4.0</FONT></P> </TD> <TD WIDTH=15%> <P><FONT SIZE=2>Intel Pentium II</FONT></P> </TD> <TD WIDTH=43%> <P><FONT SIZE=2>GCC 2.95</FONT></P> </TD> </TR> <TR> <TD WIDTH=42%> <P><FONT SIZE=2>Windows NT 4.0 SP6a</FONT></P> </TD> <TD WIDTH=15%> <P><FONT SIZE=2>Intel Pentium II</FONT></P> </TD> <TD WIDTH=43%> <P><FONT SIZE=2>Visual C++ 6.0 Standard Edition</FONT></P> </TD> </TR> <TR> <TD WIDTH=42%> <P><FONT SIZE=2>Windows XP</FONT></P> </TD> <TD WIDTH=15%> <P><FONT SIZE=2>Intel Pentium IV</FONT></P> </TD> <TD WIDTH=43%> <P><FONT SIZE=2>Visual C++ 6.0 Standard Edition Service Pack 5</FONT></P> </TD> </TR> <TR> <TD WIDTH=42%> <P><FONT SIZE=2>Windows XP</FONT></P> </TD> <TD WIDTH=15%> <P><FONT SIZE=2>Intel Pentium IV</FONT></P> </TD> <TD WIDTH=43%> <P><FONT SIZE=2>Visual Studio .net Professional (Visual C++ 7.0)</FONT></P> </TD> </TR> <TR> <TD WIDTH=42%> <P><FONT SIZE=2>Windows '98 + <A HREF="http://www.cygwin.com/">Cygwin</A> 1.3.10</FONT></P> </TD> <TD WIDTH=15%> <P><FONT SIZE=2>Intel Pentium III</FONT></P> </TD> <TD WIDTH=43%> <P><FONT SIZE=2>GCC 2.95.3-5</FONT></P> </TD> </TR> <TR> <TD WIDTH=42%> <P><FONT SIZE=2>Windows NT 4.0 SP6a</FONT></P> </TD> <TD WIDTH=15%> <P><FONT SIZE=2>Intel Pentium II</FONT></P> </TD> <TD WIDTH=43%> <P><FONT SIZE=2>GCC 2.95.3-5</FONT></P> </TD> </TR> <TR> <TD WIDTH=42%> <P><FONT SIZE=2>Windows XP + <A HREF="http://www.cygwin.com/">Cygwin</A> 1.3.10</FONT></P> </TD> <TD WIDTH=15%> <P><FONT SIZE=2>Intel Pentium IV</FONT></P> </TD> <TD WIDTH=43%> <P><FONT SIZE=2>GCC 2.95.3-5</FONT></P> </TD> </TR> </TABLE> <P STYLE="margin-bottom: 0in">Users of Magick++ have reported that the following configurations work with Magick++: </P> <P ALIGN=CENTER STYLE="margin-bottom: 0in"><B>Other Known Working Configurations</B></P> <TABLE WIDTH=100% BORDER=1 CELLPADDING=2 CELLSPACING=2> <TR> <TD> <P ALIGN=CENTER><B>Operating System</B></P> </TD> <TD> <P ALIGN=CENTER><B>Architecture</B></P> </TD> <TD> <P ALIGN=CENTER><B>Compiler</B></P> </TD> <TD> <P><B>Reported By</B></P> </TD> </TR> <TR VALIGN=TOP> <TD> <P><FONT SIZE=2>Red Hat Linux 6.0</FONT></P> </TD> <TD> <P><FONT SIZE=2>i386 & alpha</FONT></P> </TD> <TD> <P><FONT SIZE=2>EGCS 1.1.2</FONT></P> </TD> <TD> <P><FONT SIZE=2>Dr. Alexander Zimmermann <Alexander.Zimmermann@fmi.uni-passau.de></FONT></P> </TD> </TR> <TR VALIGN=TOP> <TD> <P><FONT SIZE=2>Red Hat Linux 7.0</FONT></P> </TD> <TD> <P><FONT SIZE=2>i386</FONT></P> </TD> <TD> <P><FONT SIZE=2>GCC 2.95.2</FONT></P> </TD> <TD> <P><FONT SIZE=2>Dr. Alexander Zimmermann <Alexander.Zimmermann@fmi.uni-passau.de></FONT></P> </TD> </TR> <TR VALIGN=TOP> <TD> <P><FONT SIZE=2>Red Hat Linux 7.0</FONT></P> </TD> <TD> <P><FONT SIZE=2>i386</FONT></P> </TD> <TD> <P><FONT SIZE=2>GCC "2.96" snapshot</FONT></P> </TD> <TD> <P><FONT SIZE=2>???</FONT></P> </TD> </TR> <TR> <TD> <P><FONT SIZE=2>Red Hat Linux 7.X</FONT></P> </TD> <TD> <P><FONT SIZE=2>i386 & alpha</FONT></P> </TD> <TD> <P><FONT SIZE=2>GCC 3.0</FONT></P> </TD> <TD> <P><FONT SIZE=2>Dr. Alexander Zimmermann <Alexander.Zimmermann@fmi.uni-passau.de></FONT></P> </TD> </TR> <TR VALIGN=TOP> <TD> <P><FONT SIZE=2>SGI IRIX 6.2, 6.5</FONT></P> </TD> <TD> <P><FONT SIZE=2>MIPS</FONT></P> </TD> <TD> <P><FONT SIZE=2>IRIX C++ 7.3.1.2m</FONT></P> </TD> <TD> <P><FONT SIZE=2>Albert Chin-A-Young <china@thewrittenword.com></FONT></P> </TD> </TR> <TR> <TD> <P><FONT SIZE=2>SunOS 5.5.1</FONT></P> </TD> <TD> <P><FONT SIZE=2>SPARC</FONT></P> </TD> <TD> <P><FONT SIZE=2>Sun WorkShop CC 5.0</FONT></P> </TD> <TD> <P><FONT SIZE=2>Albert Chin-A-Young <china@thewrittenword.com></FONT></P> </TD> </TR> <TR> <TD> <P><FONT SIZE=2>SunOS 5.6, 5.7, 5.8</FONT></P> </TD> <TD> <P><FONT SIZE=2>SPARC</FONT></P> </TD> <TD> <P><FONT SIZE=2>Sun Forte CC 5.3</FONT></P> </TD> <TD> <P><FONT SIZE=2>Albert Chin-A-Young <china@thewrittenword.com></FONT></P> </TD> </TR> <TR VALIGN=TOP> <TD> <P><FONT SIZE=2>HP-UX 11.00</FONT></P> </TD> <TD> <P><FONT SIZE=2>PA-RISC</FONT></P> </TD> <TD> <P><FONT SIZE=2>HP-UX aCC A.03.30</FONT></P> </TD> <TD> <P><FONT SIZE=2>Albert Chin-A-Young <china@thewrittenword.com></FONT></P> </TD> </TR> <TR VALIGN=TOP> <TD> <P><FONT SIZE=2>Mac OS 9</FONT></P> </TD> <TD> <P><FONT SIZE=2>PowerPC</FONT></P> </TD> <TD> <P><FONT SIZE=2>CodeWarrior Professional Release 6</FONT></P> </TD> <TD> <P><FONT SIZE=2>Leonard Rosenthol <leonardr@digapp.com></FONT></P> </TD> </TR> <TR> <TD> <P><FONT SIZE=2>Mac OS X 10.1 "Darwin"</FONT></P> </TD> <TD> <P><FONT SIZE=2>PowerPC</FONT></P> </TD> <TD> <P><FONT SIZE=2>GCC 2.95.2 (apple gcc -926)</FONT></P> </TD> <TD> <P><FONT SIZE=2>John Cristy</FONT></P> </TD> </TR> </TABLE> <P>Please let me know if you have successfully built and executed Magick++ using a different configuration so that I can add to the table of verified configurations. </P> <HR> <H3 ALIGN=CENTER>Unix/Linux</H3> <H4>Building From Source</H4> <P>Magick++ is built using the GraphicsMagick configure script and Makefiles. Please follow the installation instructions provided by its README.txt file. The following instructions pertain to the Magick++ specific configuration and build options. </P> <P>To install GraphicsMagick plus Magick++ under Unix, installation should be similar to </P> <P><TT>./configure [ --prefix=/prefix ]</TT> <BR><TT>make</TT> <BR><TT>make install</TT> </P> <P>The library is currently named similar to 'libGraphicsMagick++.a' (and/or libGraphicsMagick++.so.0.0.2) and is installed under prefix/lib while the headers are installed with Magick++.h being installed in prefix/include and the remaining headers in prefix/include/Magick++. </P> <P>To influence the options the configure script chooses, you may specify 'make' option variables when running the configure script. For example, the command <BR><BR><BR> </P> <BLOCKQUOTE><TT>./configure CXX=CC CXXFLAGS=-O2 LIBS=-lposix</TT></BLOCKQUOTE> <P STYLE="margin-bottom: 0in"><BR>specifies additional options to the configure script. The following table shows the available options. </P> <P ALIGN=CENTER STYLE="margin-bottom: 0in">Environment Variables That Effect Configure</P> <TABLE WIDTH=100% BORDER=1 CELLPADDING=2 CELLSPACING=3> <COL WIDTH=40*> <COL WIDTH=216*> <TR> <TD WIDTH=16%> <P ALIGN=CENTER><B>Make Option Variable</B></P> </TD> <TD WIDTH=84%> <P ALIGN=CENTER><B>Description</B></P> </TD> </TR> <TR> <TD WIDTH=16%> <P ALIGN=CENTER>CXX</P> </TD> <TD WIDTH=84%> <P>Name of C++ compiler (e.g. 'CC -Xa') to use compiler 'CC -Xa'</P> </TD> </TR> <TR> <TD WIDTH=16%> <P ALIGN=CENTER>CXXFLAGS</P> </TD> <TD WIDTH=84%> <P>Compiler flags (e.g. '-g -O2') to compile with</P> </TD> </TR> <TR> <TD WIDTH=16%> <P ALIGN=CENTER>CPPFLAGS</P> </TD> <TD WIDTH=84%> <P>Include paths (-I/somedir) to look for header files</P> </TD> </TR> <TR> <TD WIDTH=16%> <P ALIGN=CENTER>LDFLAGS</P> </TD> <TD WIDTH=84%> <P>Library paths (-L/somedir) to look for libraries. Systems that support the notion of a library run-path may additionally require -R/somedir or '-rpath /somedir' in order to find shared libraries at run time.</P> </TD> </TR> <TR> <TD WIDTH=16%> <P ALIGN=CENTER>LIBS</P> </TD> <TD WIDTH=84%> <P>Extra libraries (-lsomelib) required to link</P> </TD> </TR> </TABLE> <H4><BR><BR> </H4> <HR> <H3 ALIGN=CENTER>Windows '9X, NT, 2000, ME, & XP</H3> <H4>Visual C++</H4> <P>Windows '95 through Windows XP are supported by the GraphicsMagick source package for NT available in the 'windows' subdirectory of the GraphicsMagick ftp site (and mirrors). The GraphicsMagick source package for NT provides sources to GraphicsMagick, Magick++, add-on libraries (e.g. JPEG), and a ready-made Visual C++ 6.0 & 7.0 build environments. Please read the configuration and build instructions in INSTALL-windows.txt (under the heading "Windows Win2K/95 VISUAL C++ 7.0 COMPILATION") in order to build Magick++. </P> <H4>Cygwin & GCC</H4> <P>It is possible to build both GraphicsMagick and Magick++ under the Cygwin Unix-emulation environment for Windows NT. Obtain and install Cgywin from <A HREF="http://www.cygwin.com/">http://www.cygwin.com/</A> . An X11R6 environment for Cygwin is available from <A HREF="http://www.cygwin.com/xfree/">http://www.cygwin.com/xfree/</A> .To build using Cygwin and GCC, follow the instructions for building under Unix. </P> </BODY> </HTML>