]> granicus.if.org Git - imagemagick/blob - www/install-source.html
Update to the latests docs
[imagemagick] / www / install-source.html
1
2
3
4
5 <!DOCTYPE html>
6 <html lang="en">
7 <head>
8   <meta name="google-site-verification" content="_bMOCDpkx9ZAzBwb2kF3PRHbfUUdFj2uO8Jd1AXArz4" />
9     <title>ImageMagick: Install from Source</title>
10   <meta http-equiv="content-type" content="text/html; charset=utf-8"/>
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"/>
27   <link rel="stylesheet" href="css/magick.css"/>
28 </head>
29 <body>
30 <div class="main">
31 <div class="magick-masthead">
32   <div class="container">
33     <script async="async" src="http://localhost/pagead/js/adsbygoogle.js"></script>    <ins class="adsbygoogle"
34          style="display:block"
35          data-ad-client="ca-pub-3129977114552745"
36          data-ad-slot="6345125851"
37          data-ad-format="auto"></ins>
38     <script>
39       (adsbygoogle = window.adsbygoogle || []).push({});
40     </script>
41     <nav class="magick-nav">
42       <a class="magick-nav-item " href="../index.html">Home</a>
43       <a class="magick-nav-item " href="binary-releases.html">Download</a>
44       <a class="magick-nav-item " href="command-line-tools.html">Tools</a>
45       <a class="magick-nav-item " href="command-line-processing.html">Command-line</a>
46       <a class="magick-nav-item " href="resources.html">Resources</a>
47       <a class="magick-nav-item " href="api.html">Develop</a>
48       <a class="magick-nav-item " href="http://nextgen.imagemagick.org/script/search.php">Search</a>
49       <a class="magick-nav-item pull-right" href="http://www.imagemagick.org/discourse-server/">Community</a>
50     </nav>
51   </div>
52 </div>
53 <div class="container">
54 <div class="magick-header">
55 <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>
56
57 <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>
58
59 <pre>
60 identify -version
61 </pre>
62
63 <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>
64
65 <p>The authoritative source code repository is <a href="http://git.imagemagick.org/repos/ImageMagick">http://git.imagemagick.org/repos/ImageMagick</a>.  We maintain a source code mirror at <a href="https://github.com/ImageMagick/ImageMagick">GitHub</a>.  We test and deploy ImageMagick with <a href="https://travis-ci.org/ImageMagick">Travis CI</a>.</p>
66
67 <h2 class="magick-header"><a id="unix"></a>Install from Unix Source</h2>
68
69 <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>
70
71 <p>Unpack the distribution with this command:</p>
72
73 <pre>
74 tar xvzf ImageMagick.tar.gz
75 </pre>
76
77 <p>Next configure and compile ImageMagick:</p>
78
79 <pre><span class="crtprompt"> </span><span class='crtin'>cd ImageMagick-7.0.0</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>
80 <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>
81
82 <pre>
83 sudo make install
84 </pre>
85
86 <p>You may need to configure the dynamic linker run-time bindings:</p>
87
88 <pre>
89 sudo ldconfig /usr/local/lib
90 </pre>
91
92 <p>Finally, verify the ImageMagick install worked properly, type</p>
93
94 <pre>
95 /usr/local/bin/convert logo: logo.gif
96 </pre>
97
98 <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>
99
100 <pre>
101 make check
102 </pre>
103
104 <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>
105
106 <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>
107
108 <h2 class="magick-header"><a id="windows"></a>Install from Windows Source</h2>
109
110 <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>
111
112 <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>
113
114 <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>
115
116 <pre>
117 unzip ImageMagick-windows.zip
118 </pre>
119
120 <p>Next, launch your Visual Studio IDE and choose <kbd>Open->Project</kbd>.  Select the configure workspace from the <kbd>ImageMagick-7.0.0/VisualMagick/configure</kbd> folder and press Open.  Choose <kbd>Build->Build Solution</kbd>
121 to compile the program and on completion run the program.</p>
122
123 <p><img class="img-responsive center-block" src="../images/configure.jpg" alt="[configure]" /></p>
124
125 <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->Project</kbd> and select the VisualStaticMT workspace from the <kbd>ImageMagick-7.0.0/VisualMagick/</kbd>  folder.  Finally, choose <kbd>Build->Build Solution</kbd> to compile and build the ImageMagick distribution.</p>
126
127 <p>To verify ImageMagick is working properly, launch a MS-DOS Command Prompt window and type</p>
128
129 <pre><span class="crtprompt"> </span><span class='crtin'>cd ImageMagick-7.0.0</span><span class='crtout'><br/></span><span class="crtprompt"> </span><span class='crtin'>convert logo: image.jpg</span></pre>
130 <p>For a more comprehensive test, run the ImageMagick validation suite:</p>
131
132 <pre>
133 validate
134 </pre>
135
136 <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>
137
138 <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-7.0.0/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>
139
140 </div>
141   <footer class="magick-footer">
142     <p><a href="support.html">Donate</a> •
143      <a href="sitemap.html">Sitemap</a> •
144     <a href="links.html">Related</a> •
145     <a href="architecture.html">Architecture</a>
146 </p>
147     <p><a href="install-source.html#">Back to top</a> •
148     <a href="http://pgp.mit.edu:11371/pks/lookup?op=get&amp;search=0x89AB63D48277377A">Public Key</a> •
149     <a href="http://nextgen.imagemagick.org/script/contact.php">Contact Us</a></p>
150         <p><small>©  1999-2016 ImageMagick Studio LLC</small></p>
151   </footer>
152 </div><!-- /.container -->
153
154   <script src="https://localhost/ajax/libs/jquery/1.11.3/jquery.min.js"></script>
155   <script src="http://nextgen.imagemagick.org/js/magick.html"></script>
156 </div>
157 </body>
158 </html>