]> granicus.if.org Git - imagemagick/blobdiff - Install-mac.txt
https://github.com/ImageMagick/ImageMagick/issues/1285
[imagemagick] / Install-mac.txt
index f3e26ec7b1ab2fa2e091b8719d20c944b028af7e..b752ceb83dce83476cf9ce95c6f8aab50dcca80f 100644 (file)
@@ -1,55 +1,98 @@
 Mac OS X-specific Build instructions
 
-Perform these steps as an administrator or with the sudo command:
-
-    * Install Fink. The default setup creates a /sw folder on your main hard
-    * drive. Make sure /sw/bin is in your path.
-    * Install the latest Xcode from Apple.
-    * Create a symbolic link in /Developer/SDKs/MacOSX10.4u.sdk/ to /sw:
+In order to install ImageMagick on OSX, you will first need Apple's "Xcode", 
+which you can get by going to the AppStore and searching for "Xcode" and 
+installing it.
 
-        cd /Developer/SDKs/MacOSX10.4u.sdk
-        ln -s sw /sw
+Next, you will need to install the "Xcode Command Line Tools" which includes 
+the compiler. You can install those by running the following command in the
+Terminal:
 
-    * Use Fink, or FinkCommander to install any delegate libraries you
-    * require, for example:
+    xcode-select --install
 
-        fink install libjpeg
+Now that you have the necessary tools, you have a choice of how to install 
+ImageMagick. The simplest method is to use "homebrew", and that method is shown 
+first below. The alternative method is to install from source, which is shown
+afterwards.
 
-As a regular user or administrator:
+################################################################################
+Method 1: Using "homebrew"
+################################################################################
 
-    * Download the ImageMagick source distribution.
-    * Unpack and change into the top-level ImageMagick directory:
+Go to http://brew.sh and copy the one-liner that installs "homebrew".
 
-        tar xvfz ImageMagick-6.3.3-0.tar.gz
-        cd ImageMagick-6.3.3
+Paste that into the Terminal and run it.
 
-    * Choose an architecture and set your CFLAGS environment variable. Here we
-    * set CFLAGS for an Intel build:
+For the very simplest, fastest, most basic ImageMagick installation, run:
 
-        export CFLAGS="-O -g -isysroot /Developer/SDKs/MacOSX10.4u.sdk/ -arch i386 -I/sw/include/"
+    brew install imagemagick
 
-    * Set your LDFLAGS environment variable to:
+Test your installation by running:
 
-        export
-LDFLAGS="-Wl,-syslibroot,/Developer/SDKs/MacOSX10.4u.sdk/,-L/sw/lib/"
+    identify -version
 
-    * Configure ImageMagick:
+If you want to add support for extra features, such as HDRI, Perl, JPEG2000, 
+pango,fftw, TIFF or rsvg etc. you can find the necessary switches by running:
 
-        ./configure --prefix=/sw --with-quantum-depth=16 \
-          --disable-dependency-tracking --with-x=yes \
-          --x-includes=/usr/X11R6/include --x-libraries=/usr/X11R6/lib \
-          --without-perl
+    brew options imagemagick
 
-    * Build ImageMagick:
+then find the options you need and apply them like this:
 
-        make
+    brew reinstall imagemagick --with-jp2 --with-librsvg --with-quantum-depth-16 --with-pango
+If you have any problems with "homebrew", simply run:
 
-    * Install ImageMagick:
+    brew doctor
 
-        sudo make install
+and follow the doctor's advice.
 
-    * To test the ImageMagick GUI, start X11 and in a new shell and type:
 
-        display -display :0
+################################################################################
+Method 2: Compile from source - not necessary if you used "homebrew" method
+################################################################################
 
 
+Perform these steps as an administrator or with the sudo command:
+  
+Install MacPorts. Download and install http://www.macports.org/ and type the
+following commands:
+  
+    $magick> sudo port -v install freetype +bytecode
+    $magick> sudo port -v install librsvg
+    $magick> sudo port -v install graphviz +gs +wmf +jbig +jpeg2 +lcms
+  
+This installs many of the delegate libraries ImageMagick will utilize such as
+JPEG and FreeType.
+  
+Use the port command to install any delegate libraries you require, for example:
+  
+    $magick> sudo port install jpeg
+  
+Now let's build ImageMagick:
+  
+Download the ImageMagick source distribution and verify the distribution
+against its message digest.
+  
+Unpack and change into the top-level ImageMagick directory:
+  
+    $magick> tar xvfz ImageMagick-7.0.7-0.tar.gz 
+    $magick> cd ImageMagick-7.0.7
+  
+Configure ImageMagick:
+  
+    $magick> ./configure --prefix=/opt --with-quantum-depth=16 \
+      --disable-dependency-tracking --without-perl
+  
+Build ImageMagick:
+  
+    $magick> make
+  
+Install ImageMagick:
+  
+    $magick> sudo make install
+  
+To verify your install, type
+  
+    $magick> /opt/local/bin/identify -list font
+  
+to list all the fonts ImageMagick knows about.