← Back to branch summary

~ubuntu-branches/ubuntu/oneiric/imagemagick/oneiric-updates

« back to all changes in this revision

Viewing changes to www/command-line-tools.html

  • Committer: Bazaar Package Importer
  • Author(s): Colin Watson
  • Date: 2011-06-15 11:05:28 UTC
  • mfrom: (6.2.11 sid)
  • Revision ID: james.westby@ubuntu.com-20110615110528-08jgo07a4846xh8d
Tags: 8:6.6.0.4-3ubuntu1
https://launchpad.net/bugs/797595
* Resynchronise with Debian (LP: #797595).  Remaining changes:
  - Make ufraw-batch (universe) a suggestion instead of a recommendation.
  - Make debian/rules install target depend on check; they cannot reliably
    be run in parallel.
  - Don't set MAKEFLAGS in debian/rules; just pass it to the build.

Show diffs side-by-side

added added

removed removed

Lines of Context:
www/command-line-tools.html
1
1
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
2
2
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3
 
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr">
 
3
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
4
4
<head>
5
 
  <meta http-equiv="content-type" content="text/html; charset=utf-8"/>
 
5
  <meta http-equiv="Content-Type" value="application/xhtml+xml" />
6
6
  <meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U=" />
7
7
  <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf" />
8
 
  <style type="text/css" media="all">
 
8
  <style type="text/css" media="screen,projection"><!--
9
9
    @import url("../www/magick.css");
10
 
  </style>
 
10
  --></style>
11
11
  <link rel="shortcut icon" href="../images/wand.ico"  type="images/vnd.microsoft.icon"/>
12
12
  <title>ImageMagick: Command-line Tools</title>
13
13
  <meta http-equiv="Content-Language" content="en-US"/>
45
45
<div class="eastbar">
46
46
 
47
47
<div class="menu">
48
 
  <a title="About ImageMagick" href="../index.html">About ImageMagick</a>
49
 
</div>
50
 
<div class="sep"></div>
51
 
<div class="menu">
52
 
  <a title="Binary Releases" href="../www/binary-releases.html">Binary Releases</a>
53
 
</div>
54
 
<div class="sub">
55
 
    <a title="Binary Release: Unix" href="../www/binary-releases.html#unix">Unix</a>
56
 
</div>
57
 
<div class="sub">
58
 
    <a title="Binary Release: MacOS X" href="../www/binary-releases.html#macosx">Mac OS X</a>
59
 
</div>
60
 
<div class="sub">
61
 
    <a title="Binary Release: Windows" href="../www/binary-releases.html#windows">Windows</a>
62
 
</div>
63
 
<div class="sep"></div>
64
 
<div class="menu">
65
 
  <a title="Command-line Tools" href="../www/command-line-tools.html">Command-line Tools</a>
66
 
</div>
67
 
<div class="sub">
68
 
    <a title="Command-line Tools: Processing" href="../www/command-line-processing.html">Processing</a>
69
 
</div>
70
 
<div class="sub">
71
 
    <a title="Command-line Tools: Options" href="../www/command-line-options.html">Options</a>
72
 
</div>
73
 
<div class="sub">
74
 
    <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
75
 
</div>
76
 
<div class="menu">
77
 
  <a title="Program Interfaces" href="../www/api.html">Program Interfaces</a>
78
 
</div>
79
 
<div class="sub">
80
 
    <a title="Program Interface: MagickWand" href="../www/magick-wand.html">MagickWand</a>
81
 
</div>
82
 
<div class="sub">
83
 
    <a title="Program Interface: MagickCore" href="../www/magick-core.html">MagickCore</a>
84
 
</div>
85
 
<div class="sub">
86
 
    <a title="Program Interface: PerlMagick" href="../www/perl-magick.html">PerlMagick</a>
87
 
</div>
88
 
<div class="sub">
89
 
    <a title="Program Interface: Magick++" href="../Magick++/">Magick++</a>
 
48
  <a href="../index.html">About ImageMagick</a>
 
49
</div>
 
50
<div class="sep"></div>
 
51
<div class="menu">
 
52
  <a href="../www/command-line-tools.html">Command-line Tools</a>
 
53
</div>
 
54
<div class="sub">
 
55
    <a href="../www/command-line-processing.html">Processing</a>
 
56
</div>
 
57
<div class="sub">
 
58
    <a href="../www/command-line-options.html">Options</a>
 
59
</div>
 
60
<div class="sub">
 
61
    <a href="http://www.imagemagick.org/Usage/">Usage</a>
 
62
</div>
 
63
<div class="menu">
 
64
  <a href="../www/api.html">Program Interfaces</a>
 
65
</div>
 
66
<div class="sub">
 
67
    <a href="../www/magick-wand.html">MagickWand</a>
 
68
</div>
 
69
<div class="sub">
 
70
    <a href="../www/magick-core.html">MagickCore</a>
 
71
</div>
 
72
<div class="sub">
 
73
    <a href="../www/perl-magick.html">PerlMagick</a>
 
74
</div>
 
75
<div class="sub">
 
76
    <a href="../Magick++/">Magick++</a>
 
77
</div>
 
78
<div class="menu">
 
79
  <a href="../www/architecture.html">Architecture</a>
90
80
</div>
91
81
<div class="sep"></div>
92
82
<div  class="menu">
93
 
   <a title="Install from Source" href="../www/install-source.html">Install from Source</a>
94
 
</div>
95
 
<div class="sub">
96
 
    <a title="Install from Source: Unix" href="../www/install-source.html#unix">Unix</a>
97
 
</div>
98
 
<div class="sub">
99
 
    <a title="Install from Source: Windows" href="../www/install-source.html#windows">Windows</a>
 
83
   <a href="../www/install-source.html">Install from Source</a>
 
84
</div>
 
85
<div class="sub">
 
86
    <a href="../www/install-source.html#unix">Unix</a>
 
87
</div>
 
88
<div class="sub">
 
89
    <a href="../www/install-source.html#windows">Windows</a>
100
90
 </div>
101
91
<div class="menu">
102
 
  <a title="Resources" href="../www/resources.html">Resources</a>
103
 
</div>
104
 
<div class="menu">
105
 
  <a title="Architecture" href="../www/architecture.html">Architecture</a>
106
 
</div>
107
 
<div class="menu">
108
 
  <a title="Download" href="../www/download.html">Download</a>
109
 
</div>
110
 
<div class="sep"></div>
111
 
<div class="menu">
112
 
  <a title="Search" href="http://www.imagemagick.org/script/search.php">Search</a>
113
 
</div>
114
 
<div class="sep"></div>
115
 
<div class="menu">
116
 
  <a title="Site Map"href="../www/sitemap.html">Site Map</a>
 
92
  <a href="../www/binary-releases.html">Binary Releases</a>
 
93
</div>
 
94
<div class="sub">
 
95
    <a href="../www/binary-releases.html#unix">Unix</a>
 
96
</div>
 
97
<div class="sub">
 
98
    <a href="../www/binary-releases.html#macosx">Mac OS X</a>
 
99
</div>
 
100
<div class="sub">
 
101
    <a href="../www/binary-releases.html#windows">Windows</a>
 
102
</div>
 
103
<div class="menu">
 
104
  <a href="../www/resources.html">Resources</a>
 
105
</div>
 
106
<div class="sep"></div>
 
107
<div class="menu">
 
108
  <a href="../www/download.html">Download</a>
 
109
</div>
 
110
<div class="sep"></div>
 
111
<div class="menu">
 
112
  <a href="http://www.imagemagick.org/script/search.php">Search</a>
 
113
</div>
 
114
<div class="sep"></div>
 
115
<div class="menu">
 
116
  <a href="../www/sitemap.html">Site Map</a>
117
117
</div>
118
118
<div  class="sub">
119
 
    <a title="Site Map: Links"href="../www/links.html">Links</a>
 
119
    <a href="../www/links.html">Links</a>
120
120
</div>
121
121
<div class="sep"></div>
122
122
<div  class="menu">
123
 
  <a title="Sponsors" href="../www/sponsors.html">Sponsors:</a>
 
123
  <a href="../www/sponsors.html">Sponsors:</a>
124
124
 
125
125
<div class="sponsbox">
126
126
<div  class="sponsor">
127
 
  <a title="Sponsor: Webdesign Agentur" href="http://www.ventzke-partner.de">Webdesign Agentur</a><!-- 201101010480 invendio.de-->
128
 
</div>
129
 
<div  class="sponsor">
130
 
  <a title="Sponsor: LVM Versicherung" href="http://www.neu-reich.de">LVM Versicherung</a><!-- 201101010480 -->
131
 
</div>
132
 
<div  class="sponsor">
133
 
  <a title="Sponsor: Deko.net" href="http://www.deko.net">Deko.net</a><!-- 201101010600 Peterssen-->
134
 
</div>
135
 
<div  class="sponsor">
136
 
  <a title="Sponsor: Kredit" href="http://www.online-kredit-index.de">Kredit</a><!-- 201007010120 Buchhorn -->
137
 
</div>
138
 
<div  class="sponsor">
139
 
  <a title="Sponsor: Druckerei" href="http://www.print24.de/">Druckerei</a><!-- 201009010720 -->
140
 
</div>
141
 
<div  class="sponsor">
142
 
   <a title="Sponsor: Druckerei Online" href="http://www.allesdruck.de">Druckerei Online</a><!-- 201012011200 allesdruck.de-->
143
 
</div>
144
 
<div  class="sponsor">
145
 
   <a title="Sponsor: Webdesign" href="http://www.renehornig.com/" title="Webdesign">Webdesign</a><!-- 20110901000240 -->
 
127
   <a href="http://www.geschenke-elsen.de/" title="Lampe Berger">Lampe Berger</a><!-- 20106101000040 -->
 
128
</div>
 
129
<div  class="sponsor">
 
130
  <a href="http://www.deko.net">Deko.net</a><!-- 201101010600 Peterssen-->
 
131
</div>
 
132
<div  class="sponsor">
 
133
  <a href="http://www.tomsgutscheine.de">Tom's Gutscheine</a><!-- 201005010360 invendio.de-->
 
134
</div>
 
135
<div  class="sponsor">
 
136
  <a href="http://www.online-kredit-index.de">Kredit</a><!-- 201007010120 Buchhorn -->
 
137
</div>
 
138
<div  class="sponsor">
 
139
  <a href="http://www.blumenversender.com">Blumenversand</a><!-- 201005010120 -->
 
140
</div>
 
141
<div  class="sponsor">
 
142
  <a href="http://www.print24.de/">Druckerei</a><!-- 201009010720 -->
 
143
</div>
 
144
<div  class="sponsor">
 
145
   <a href="http://www.goyax.de">Börse</a><!-- 201004010240 Gewiese digital-finance.de -->
 
146
</div>
 
147
<div  class="sponsor">
 
148
   <a href="http://www.allesdruck.de">Druckerei Online</a><!-- 201012011200 allesdruck.de-->
146
149
</div>
147
150
</div>
148
151
</div>
154
157
 
155
158
<p class="navigation-index">[<a href="#animate">animate</a> &bull; <a href="#compare">compare</a> &bull; <a href="#composite">composite</a> &bull; <a href="#conjure">conjure</a> &bull; <a href="#convert">convert</a> &bull; <a href="#display">display</a> &bull; <a href="#identify">identify</a> &bull; <a href="#import">import</a> &bull; <a href="#mogrify">mogrify</a> &bull; <a href="#montage">montage</a> &bull; <a href="#stream">stream</a>]</p>
156
159
 
157
 
<p>ImageMagick includes a number of command-line utilities for manipulating images.  Most of you are probably accustomed to editing images one at a time with a graphical user interface (GUI) with such programs as <a href="http://www.gimp.org" target="336648835">gimp</a> or <a href="http://www.adobe.com" target="1070358796">Photoshop</a>.  However, a GUI is not always convenient.  Suppose you want to process an image dynamically from a web script or you want to apply the same operations to many images or repeat a specific operation at different times to the same or different image.  For these types of operations, the command-line image processing utility is appropriate.</p>
 
160
<p>ImageMagick includes a number of command-line utilities for manipulating images.  Most of you are probably accustomed to editing images one at a time with a graphical user interface (GUI) with such programs as <a href="http://www.gimp.org" target="1756929260">gimp</a> or <a href="http://www.adobe.com" target="145372426">Photoshop</a>.  However, a GUI is not always convenient.  Suppose you want to process an image dynamically from a web script or you want to apply the same operations to many images or repeat a specific operation at different times to the same or different image.  For these types of operations, the command-line image processing utility is appropriate.</p>
158
161
 
159
162
<p>The ImageMagick command-line tools exit with a status of 0 if the command line arguments have a proper syntax and no problems are encountered.  Expect a descriptive message and an exit status of 1 if any exception occurs such as improper syntax, a problem reading or writing an image, or any other problem that prevents the command from completing successfully.</p>
160
163
 
161
 
<p>In the paragraphs below, find a short description for each command-line tool. Click on the program name to get details about the program usage and a list of command-line options that alters how the program behaves.  If you are just getting acquainted with ImageMagick, start with the <a href="#convert">convert</a> program.  Be sure to peruse Anthony Thyssen's tutorial on how to use ImageMagick utilities to <a href="http://www.imagemagick.org/Usage/" target="1099774621">convert, compose, or edit</a> images from the command-line.</p>
 
164
<p>In the paragraphs below, find a short description for each command-line tool. Click on the program name to get details about the program usage and a list of command-line options that alters how the program behaves.  If you are just getting acquainted with ImageMagick, start with the <a href="#convert">convert</a> program.  Be sure to peruse Anthony Thyssen's tutorial on how to use ImageMagick utilities to <a href="http://www.imagemagick.org/Usage/" target="1629140001">convert, compose, or edit</a> images from the command-line.</p>
162
165
 
163
166
<div style="margin: auto;">
164
167
  <h2><a name="animate"></a><a href="../www/animate.html">animate</a></h2>