"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">\r
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">\r
<head>\r
+ <meta http-equiv="Content-Type" value="application/xhtml+xml" />\r
<meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U=" />\r
<link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf" />\r
<style type="text/css" media="screen,projection"><!--\r
<meta name="Author" content="ImageMagick Studio LLC"/>
<meta name="Revisit-after" content="2 DAYS"/>
<meta name="Resource-type" content="document"/>
- <meta name="Copyright" content="Copyright (c) 1999-2009 ImageMagick Studio LLC"/>
+ <meta name="Copyright" content="Copyright (c) 1999-2010 ImageMagick Studio LLC"/>
<meta name="Distribution" content="Global"/>
</head>\r
\r
<div class="sponsbox">
<div class="sponsor">
- <a href="http://www.buerodruck.de/stempel-service/index.html">Stempel bestellen</a><!-- 200910000035+ -->
+ <a href="http://www.hygi.de">Reinigungsmittel</a><!-- 201002000400+ -->
</div>
<div class="sponsor">
- <a href="http://www.print24.de/">Druckerei</a><!-- 201009010720 -->
+ <a href="http://www.tomsgutscheine.de">Tom's Gutscheine</a><!-- 201005010360 invendio.de-->
</div>
<div class="sponsor">
- <a href="http://www.goyax.de">Börse</a><!-- 201001000240 Gewiese digital-finance.de -->
+ <a href="http://www.online-kredit-index.de">Kredit</a><!-- 201006010120 Buchhorn -->
</div>
<div class="sponsor">
- <a href="http://www.allesdruck.de">Druckerei Online</a><!-- 201012001200 allesdruck.de-->
+ <a href="http://www.blumenversender.com">Blumenversand</a><!-- 201005010120 -->
</div>
<div class="sponsor">
- <a href="http://www.blumenversender.com">Blumenversand</a><!-- 200911010120 -->
+ <a href="http://www.print24.de/">Druckerei</a><!-- 201009010720 -->
</div>
<div class="sponsor">
- <a href="http://www.who-sells-it.com/">Free Catalogs</a><!-- 201002010000 -->
+ <a href="http://www.goyax.de">Börse</a><!-- 201004010240 Gewiese digital-finance.de -->
</div>
<div class="sponsor">
- <a href="http://www.online-kredit-index.de">Kredit</a><!-- 201002010120 Buchhorn -->
+ <a href="http://www.allesdruck.de">Druckerei Online</a><!-- 201012011200 allesdruck.de-->
+</div>
+<div class="sponsor">
+ <a href="http://www.who-sells-it.com/">Free Catalogs</a><!-- 201002010000 -->
</div>
</div>
</div>
<p>ImageMagick must already be installed on your system. Next, get
the <a href="../www/download.html">PerlMagick</a> distribution corresponding to the installed ImageMagick distribution
-(e.g., PerlMagick 6.56 for
-ImageMagick 6.5.6) and unpack it as shown below:</p>
+(e.g., PerlMagick 6.59 for
+ImageMagick 6.5.9) and unpack it as shown below:</p>
-<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>tar xvfz PerlMagick-6.56.tar.gz</span><span class='crtout'></span><span class="crtprompt"> $magick> </span><span class='crtin'>cd PerlMagick</span></p>
+<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>tar xvfz PerlMagick-6.59.tar.gz</span><span class='crtout'></span><span class="crtprompt"> $magick> </span><span class='crtin'>cd PerlMagick</span></p>
<p>Next, edit <kbd>Makefile.PL</kbd> and change LIBS and INC to include the appropriate path information to the required <kbd>MagickCore</kbd> library. You may need paths to JPEG, PNG, TIFF, etc. delegates if they were included with your installed version of ImageMagick. Build and install it like this:</p>
<p class='crt'><span class="crtprompt"> $magick> </span><span class='crtin'>perl Makefile.PL</span><span class='crtout'></span><span class="crtprompt"> $magick> </span><span class='crtin'>make</span><span class='crtout'></span><span class="crtprompt"> $magick> </span><span class='crtin'>make install</span></p>
<p>Next you will want to read an image or image sequence, manipulate it, and then display or write it. The input and output methods for PerlMagick are defined in <a href="#read">Read or Write an Image</a>. See <a href="#set-attribute">Set an Image Attribute</a> for methods that affect the way an image is read or written. Refer to <a href="#manipulate">Manipulate an Image</a> for a list of methods to transform an image. <a href="#get-attribute">Get an Image Attribute</a> describes how to retrieve an attribute for an image. Refer to <a href="#montage">Create an Image Montage</a> for details about tiling your images as thumbnails on a background. Finally, some methods do not neatly fit into any of the categories just mentioned. Review <a href="#misc">Miscellaneous Methods</a> for a list of these methods.</p>
-<p>Once you are finished with a PerlMagick object you should consider destroying it. Each image in an image sequence is stored in virtual memory. This can potentially add up to mega-bytes of memory. Upon destroying a PerlMagick object, the memory is returned for use by other Perl methods. The recommended way to destroy an object is with <kbd>undef</kbd>:</p>
+<p>Once you are finished with a PerlMagick object you should consider destroying it. Each image in an image sequence is stored in virtual memory. This can potentially add up to mebibytes of memory. Upon destroying a PerlMagick object, the memory is returned for use by other Perl methods. The recommended way to destroy an object is with <kbd>undef</kbd>:</p>
<pre class="code">
undef $image;
close(IMAGE);
</pre>
+<p>Note, reading from or writing to a Perl filehandle may fail under Windows due to different versions of the C-runtime libraries between ImageMagick and the ActiveState Perl distributions or if one of the DLL's is linked with the /MT option. See <a href="http://msdn.microsoft.com/en-us/library/ms235460.aspx">Potential Errors Passing CRT Objects Across DLL Boundaries</a> for an explanation.</p>
+
<p>If <kbd>%0Nd, %0No, or %0Nx</kbd> appears in the filename, it is interpreted as a printf format specification and the specification is replaced with the specified decimal, octal, or hexadecimal encoding of the scene number. For example,</p>
<pre class="text">
<tr>
<td valign="top">BlackThreshold</td>
- <td valign="top">threshold=><i>string</i></td>
+ <td valign="top">threshold=><i>string</i>, , channel=>{All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow}</td>
<td valign="top">force all pixels below the threshold intensity into black</td>
</tr>
<tr>
<td valign="top">Convolve</td>
- <td valign="top">coefficients=><i>array of float values</i>, channel=>{All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow}, bias=>;<i>double</i></td>
+ <td valign="top">coefficients=><i>array of float values</i>, channel=>{All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow}, bias=><i>double</i></td>
<td valign="top">apply a convolution kernel to the image. Given a kernel <i>order</i> , you would supply <i>order*order</i> float values (e.g. 3x3 implies 9 values).</td>
</tr>
<tr>
<td valign="top">Crop</td>
- <td valign="top">geometry=><i>geometry</i>, width=><i>integer</i>, height=><i>integer</i>, x=><i>integer</i>, y=><i>integer</i>, fuzz=><i>double</i></td>
+ <td valign="top">geometry=><i>geometry</i>, width=><i>integer</i>, height=><i>integer</i>, x=><i>integer</i>, y=><i>integer</i>, fuzz=><i>double</i>, gravity=>{NorthWest, North, NorthEast, West, Center, East, SouthWest, South, SouthEast}</td>
<td valign="top">crop an image</td>
</tr>
<td valign="top">apply an arithmetic, relational, or logical expression to the image</td>
</tr>
+ <tr>
+ <td valign="top">Filter</td>
+ <td valign="top">kernel=><i>string</i>, channel=>{All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow}, bias=><i>double</i></td>
+ <td valign="top">apply a convolution kernel to the image.</td>
+ </tr>
+
<tr>
<td valign="top">Flip</td>
<td valign="top"><br /></td>
<tr>
<td valign="top">Identify</td>
- <td valign="top">file=><i>file</i></td>
+ <td valign="top">file=><i>file</i>, features=><i>distance</i>, unique=>{True, False}</td>
<td valign="top">identify the attributes of an image</td>
</tr>
<td valign="top">vary the brightness, saturation, and hue of an image by the specified percentage</td>
</tr>
+ <tr>
+ <td valign="top">Morphology</td>
+ <td valign="top">kernel=><i>string</i>, channel=>{All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow}, iterations=><i>integer</i></td>
+ <td valign="top">apply a morphology method to the image.</td>
+ </tr>
+
<tr>
<td valign="top">MotionBlur</td>
<td valign="top">geometry=><i>geometry</i>, radius=><i>double</i>, sigma=><i>double</i>, angle=><i>double</i>, channel=>{All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow}</td>
<tr>
<td valign="top">Negate</td>
<td valign="top">gray=>{True, False}, channel=>{All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow}</td>
- <td valign="top">replace every pixel with its complementary color (white becomes black, yellow becomes blue, etc.)</td>
+ <td valign="top">replace each pixel with its complementary color (white becomes black, yellow becomes blue, etc.)</td>
</tr>
<tr>
<tr>
<td valign="top">Remap</td>
- <td valign="top">image=><i>image-handle</i>, dither-method=>{Riemersma, Floyd-Steinberg}</td>
+ <td valign="top">image=><i>image-handle</i>, dither=>{true, false}, dither-method=>{Riemersma, Floyd-Steinberg}</td>
<td valign="top">replace the colors of an image with the closest color from a reference image.</td>
</tr>
<tr>
<td valign="top">WhiteThreshold</td>
- <td valign="top">threshold=><i>string</i></td>
+ <td valign="top">threshold=><i>string</i>, , channel=>{All, Default, Alpha, Black, Blue, CMYK, Cyan, Gray, Green, Index, Magenta, Opacity, Red, RGB, Yellow}</td>
<td valign="top">force all pixels above the threshold intensity into white</td>
</tr>
</tbody>
<tr>
<td valign="top">area-limit</td>
<td valign="top"><i>integer</i></td>
- <td valign="top">set pixel area resource limit in megabytes.</td>
+ <td valign="top">set pixel area resource limit.</td>
</tr>
<tr>
<tr>
<td valign="top">disk-limit</td>
<td valign="top"><i>integer</i></td>
- <td valign="top">set disk resource limit in megabytes</td>
+ <td valign="top">set disk resource limit</td>
</tr>
<tr>
<tr>
<td valign="top">map-limit</td>
<td valign="top"><i>integer</i></td>
- <td valign="top">set map resource limit in megabytes</td>
+ <td valign="top">set map resource limit</td>
</tr>
<tr>
<tr>
<td valign="top">memory-limit</td>
<td valign="top"><i>integer</i></td>
- <td valign="top">set memory resource limit in megabytes</td>
+ <td valign="top">set memory resource limit</td>
</tr>
<tr>
<tr>
<td valign="top">GetAuthenticIndexQueue</td>
+ <td valign="top"></td>
<td valign="top">return image indexes as a C pointer</td>
</tr>
<tr>
<td valign="top">GetVirtualIndexQueue</td>
+ <td valign="top"></td>
<td valign="top">return image indexes as a const C pointer</td>
</tr>
<p>copies all the images from object <kbd>$p</kbd> to <kbd>$q</kbd>. You can use this method for single or multi-image sequences.</p>
+<p>The Features() method returns features for each channel in the image in each of four directions (horizontal, vertical, left and right diagonals) for the specified distance. The features include the angular second momentum, contrast, correlation, sum of squares: variance, inverse difference moment, sum average, sum varience, sum entropy, entropy, difference variance, difference entropy, information measures of correlation 1, information measures of correlation 2, and maximum correlation coefficient. Values in RGB, CMYK, RGBA, or CMYKA order (depending on the image type).</p>
+
+<pre class="code">
+ @features = $image->Features(1);
+</pre>
+
+<p>Finally, the Transform() method accepts a fully-qualified geometry specification for cropping or resizing one or more images. For example,</p>
+
<p>The Flatten() method flattens a set of images and returns it. For example,</p>
<pre class="code">
<!-- <span id="linkbar-west"> </span> -->\r
<span id="linkbar-center">\r
<a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> •\r
- <a href="../www/mailing-list.html">Mailing Lists</a> •\r
- <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>\r
+ <a href="http://studio.webbyland.com/ImageMagick/MagickStudio/scripts/MagickStudio.cgi">Studio</a>\r
</span>\r
<span id="linkbar-east"> </span>\r
</div>\r
<div class="footer">\r
- <span id="footer-west">© 1999-2009 ImageMagick Studio LLC</span>\r
+ <span id="footer-west">© 1999-2010 ImageMagick Studio LLC</span>\r
<span id="footer-east"> <a href="http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>\r
</div>\r
<div style="clear: both; margin: 0; width: 100%; "></div>\r
projects / imagemagick / blobdiff