]> granicus.if.org Git - imagemagick/blob - www/install-source.html
(no commit message)
[imagemagick] / www / install-source.html
1 <!DOCTYPE html>
2 <html lang="en">
3 <head>
4   <meta charset="utf-8">
5   <meta http-equiv="X-UA-Compatible" content="IE=edge">
6   <meta name="viewport" content="width=device-width, initial-scale=1">
7   <title>ImageMagick: Install from Source</title>
8   <meta http-equiv="content-language" content="en-US">
9   <meta http-equiv="content-type" content="text/html; charset=utf-8">
10   <meta http-equiv="reply-to" content="magick-users@imagemagick.org">
11   <meta name="application-name" content="ImageMagick">
12   <meta name="description" content="ImageMagick® is a software suite to create, edit, compose, or convert bitmap images. It can read and write images in a variety of formats (over 200) including PNG, JPEG, JPEG-2000, GIF, WebP, Postscript, PDF, and SVG. Use ImageMagick to resize, flip, mirror, rotate, distort, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and Bézier curves.">
13   <meta name="application-url" content="http://www.imagemagick.org">
14   <meta name="generator" content="PHP">
15   <meta name="keywords" content="install, from, source, ImageMagick, PerlMagick, image processing, image, photo, software, Magick++, OpenMP, convert">
16   <meta name="rating" content="GENERAL">
17   <meta name="robots" content="INDEX, FOLLOW">
18   <meta name="generator" content="ImageMagick Studio LLC">
19   <meta name="author" content="ImageMagick Studio LLC">
20   <meta name="revisit-after" content="2 DAYS">
21   <meta name="resource-type" content="document">
22   <meta name="copyright" content="Copyright (c) 1999-2015 ImageMagick Studio LLC">
23   <meta name="distribution" content="Global">
24   <meta name="magick-serial" content="P131-S030410-R485315270133-P82224-A6668-G1245-1">
25   <link rel="icon" href="../images/wand.png">
26   <link rel="shortcut icon" href="../images/wand.ico" type="images/x-icon">
27   <link rel="stylesheet" href="css/bootstrap.min.css">
28   <link rel="stylesheet" href="css/magick.css">
29 </head>
30
31 <body>
32 <div class="main">
33 <div class="magick-masthead">
34   <div class="container">
35     <script type="text/javascript">
36     <!--
37       google_ad_client = "pub-3129977114552745";
38       google_ad_slot = "5439289906";
39       google_ad_width = 728;
40       google_ad_height = 90;
41     //-->
42     </script>
43     <center><script type="text/javascript" src="http://localhost/pagead/show_ads.js">
44     </script></center>
45     <nav class="magick-nav">
46       <a class="magick-nav-item " href="../index.html">Home</a>
47       <a class="magick-nav-item " href="binary-releases.html">Downloads</a>
48       <a class="magick-nav-item " href="command-line-tools.html">Tools</a>
49       <a class="magick-nav-item " href="command-line-options.html">Options</a>
50       <a class="magick-nav-item " href="api.html">Development</a>
51       <a class="magick-nav-item " href="http://www.imagemagick.org/script/search.php">Search</a>
52       <a class="magick-nav-item pull-right" href="http://www.imagemagick.org/discourse-server/">Community</a>
53     </nav>
54   </div>
55 </div>
56 <div class="container">
57 <div class="magick-header">
58 <p class="text-center"><a href="install-source.html#unix">Install from Unix Source</a> • <a href="install-source.html#windows">Install from Windows Source</a></p>
59
60 <p class="lead magick-description">Chances are, ImageMagick is already installed on your computer if you are using some flavor of Unix, and its likely not installed if you are using some form of Windows.  In either case, you can type the following to find out:</p>
61
62 <pre>
63 identify -version
64 </pre>
65
66 <p>If the <a href="identify.html">identify</a> program executes and identifies itself as ImageMagick, you may not need to install ImageMagick from source unless you want to add support for additional image formats or upgrade to a newer version.  You also have the option of installing a pre-compiled <a href="binary-releases.html">binary release</a>.  However, if you still want to install from source, choose a platform, <a href="install-source.html#unix">Unix</a> or <a href="install-source.html#windows">Windows</a>.  Before installing from source, you may want to review recent <a href="changelog.html">changes</a> to the ImageMagick distribution.</p>
67
68 <h2 class="magick-header"><a id="unix"></a>Install from Unix Source</h2>
69
70 <p>ImageMagick builds on a variety of Unix and Unix-like operating systems including Linux, Solaris, FreeBSD, Mac OS X, and others.  A compiler is required and fortunately almost all modern Unix systems have one.  Download <a href="http://www.imagemagick.org/download/ImageMagick.tar.gz">ImageMagick.tar.gz</a> from <a href="http://www.imagemagick.org/download">www.imagemagick.org</a> or a <a href="download.html">mirrors</a> and verify its <a href="http://www.imagemagick.org/download/digest.rdf">message digest</a>.</p>
71
72 <p>Unpack the distribution with this command:</p>
73
74 <pre>
75 tar xvzf ImageMagick.tar.gz
76 </pre>
77
78 <p>Next configure and compile ImageMagick:</p>
79
80 <pre><span class="crtprompt"> </span><span class="crtin">cd ImageMagick-6.9.1</span><span class="crtout"><br></span><span class="crtprompt"> </span><span class="crtin">./configure</span><span class="crtout"><br></span><span class="crtprompt"> </span><span class="crtin">make</span></pre>
81 <p>If ImageMagick configured and compiled without complaint, you are ready to install it on your system.  Administrator privileges are required to install.  To install, type</p>
82
83 <pre>
84 sudo make install
85 </pre>
86
87 <p>You may need to configure the dynamic linker run-time bindings:</p>
88
89 <pre>
90 sudo ldconfig /usr/local/lib
91 </pre>
92
93 <p>Finally, verify the ImageMagick install worked properly, type</p>
94
95 <pre>
96 /usr/local/bin/convert logo: logo.gif
97 </pre>
98
99 <p>For a more comprehensive test, run the ImageMagick validation suite. Ghostscript is a prerequisite, otherwise the EPS, PS, and PDF tests will fail.</p>
100
101 <pre>
102 make check
103 </pre>
104
105 <p>Congratulations, you have a working ImageMagick distribution and you are ready to use ImageMagick to <a href="http://www.imagemagick.org/Usage/">convert, compose, or edit</a> your images or perhaps you'll want to use one of the <a href="api.html">Application Program Interfaces</a> for C, C++, Perl, and others.</p>
106
107 <p>The above instructions will satisfy a great number of ImageMagick users, but we suspect a few will have additional questions or problems to consider.  For example, what does one do if ImageMagick fails to configure or compile?  Or what if you don't have administrator privileges and what if you don't want to install ImageMagick in the default <code>/../usr/local</code> folder?  You will find the answer to these questions, and more, in <a href="advanced-unix-installation.html">Advanced Unix Source Installation</a>.</p>
108
109 <h2 class="magick-header"><a id="windows"></a>Install from Windows Source</h2>
110
111 <p>Building ImageMagick source for Windows requires a modern version of Microsoft Visual Studio IDE.  Users have reported success with the Borland C++ compiler as well.  If you don't have a compiler you can still install a self-installing <a href="binary-releases.html">binary release</a>.</p>
112
113 <p>Download <a href="http://www.imagemagick.org/download/windows/ImageMagick-windows.zip">ImageMagick-windows.zip</a> from <a href="http://www.imagemagick.org/download/windows">www.imagemagick.org</a> or a <a href="download.html">mirrors</a> and verify its <a href="http://www.imagemagick.org/download/windows/digest.rdf">message digest</a>.</p>
114
115 <p>You can unpack the distribution with <a href="http://www.winzip.com">WinZip</a> or type the following from any MS-DOS Command Prompt window:</p>
116
117 <pre>
118 unzip ImageMagick-windows.zip
119 </pre>
120
121 <p>Next, launch your Visual Studio IDE and choose <kbd>Open-&gt;Project</kbd>.  Select the configure workspace from the <kbd>ImageMagick-6.9.1/VisualMagick/configure</kbd> folder and press Open.  Choose <kbd>Build-&gt;Build Solution</kbd>
122 to compile the program and on completion run the program.</p>
123
124 <p><img class="img-responsive center-block" src="../images/configure.jpg" alt="[configure]"></p>
125
126 <p>Press <kbd>Next</kbd> and click on the multi-threaded static build.  If you are using the Visual Studio 6.0 IDE, make sure no check is next to the <var>Generate Visual Studio 7</var> format option.  Now press, on <kbd>Next</kbd> twice and finally <kbd>Finish</kbd>.  The configuration utility just created a workspace required to build ImageMagick from source.  Choose <kbd>Open-&gt;Project</kbd> and select the VisualStaticMT workspace from the <kbd>ImageMagick-6.9.1/VisualMagick/</kbd>  folder.  Finally, choose <kbd>Build-&gt;Build Solution</kbd> to compile and build the ImageMagick distribution.</p>
127
128 <p>To verify ImageMagick is working properly, launch a MS-DOS Command Prompt window and type</p>
129
130 <pre><span class="crtprompt"> </span><span class="crtin">cd ImageMagick-6.9.1</span><span class="crtout"></span><span class="crtprompt"> </span><span class="crtin">convert logo: image.jpg</span></pre>
131 <p>For a more comprehensive test, run the ImageMagick validation suite:</p>
132
133 <pre>
134 validate
135 </pre>
136
137 <p>Congratulations, you have a working ImageMagick distribution under Windows and you are ready to use ImageMagick to <a href="http://www.imagemagick.org/Usage/">convert, compose, or edit</a> your images or perhaps you'll want to use one of the <a href="api.html">Application Program Interfaces</a> for C, C++, Perl, and others.</p>
138
139 <p>The above instructions will satisfy a great number of ImageMagick users, but we suspect a few will have additional questions or problems to consider.  For example, what does one do if ImageMagick fails to configure or compile?  Or what if you want to install ImageMagick in a place other than the <kbd>ImageMagick-6.9.1/VisualMagick/bin</kbd> folder?  Or perhaps you want to build and install the <a href="ImageMagickObject.html">ImageMagickObject</a> COM+ component.  You will find the answer to these questions, and more, in <a href="advanced-windows-installation.html">Advanced Windows Source Installation</a>.</p>
140
141 </div>
142   <footer class="magick-footer">
143     <div class="magick-nav-item pull-left">
144       <a href="support.html">Donate</a>
145     </div>
146     <p><a href="sitemap.html">Sitemap</a> •
147     <a href="links.html">Related</a> •
148     <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Image Studio</a> •
149     <a href="http://jqmagick.imagemagick.org/">JqMagick</a> •
150     <a href="http://pgp.mit.edu:11371/pks/lookup?op=get&amp;search=0x89AB63D48277377A">Public Key</a>
151 </p>
152     <p><a href="install-source.html#">Back to top</a> •
153     <a href="http://www.imagemagick.org/script/contact.php">Contact Us</a></p>
154     <p><small>©  1999-2015 ImageMagick Studio LLC</small></p>
155   </footer>
156 </div><!-- /.container -->
157
158   <script src="https://localhost/ajax/libs/jquery/1.11.2/jquery.min.js"></script>
159   <script src="../js/bootstrap.min.js"></script>
160   <script type="text/javascript">
161     /* <![CDATA[ */
162     (function() {
163         var s = document.createElement('offline-script'), t = document.getElementsByTagName('offline-script')[0];
164         s.type = 'text/javascript';
165         s.async = true;
166         s.src = 'http://api.flattr.com/js/0.6/load.js?mode=auto';
167         t.parentNode.insertBefore(s, t);
168     })();
169     /* ]]> */
170   </script>
171 </div>
172 </body>
173 </html>