<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>Removes repeated portions of images to optimize</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="imagick.opaquepaintimage.html">Imagick::opaquePaintImage</a></div>
<div class="next" style="text-align: right; float: right;"><a href="imagick.orderedposterizeimage.html">Imagick::orderedPosterizeImage</a></div>
<div class="up"><a href="class.imagick.html">Imagick</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="imagick.optimizeimagelayers" class="refentry">
<div class="refnamediv">
<h1 class="refname">Imagick::optimizeImageLayers</h1>
<p class="verinfo">(PECL imagick 2.0.0)</p><p class="refpurpose"><span class="refname">Imagick::optimizeImageLayers</span> — <span class="dc-title">Removes repeated portions of images to optimize</span></p>
</div>
<div class="refsect1 description" id="refsect1-imagick.optimizeimagelayers-description">
<h3 class="title">Description</h3>
<div class="methodsynopsis dc-description">
<span class="type">bool</span> <span class="methodname"><strong>Imagick::optimizeImageLayers</strong></span>
( <span class="methodparam">void</span>
)</div>
<p class="para rdfs-comment">
Compares each image the GIF disposed forms of the previous image
in the sequence. From this it attempts to select the smallest
cropped image to replace each frame, while preserving the results
of the animation.
This method is available if Imagick has been compiled against ImageMagick version 6.2.9 or newer.
</p>
</div>
<div class="refsect1 returnvalues" id="refsect1-imagick.optimizeimagelayers-returnvalues">
<h3 class="title">Return Values</h3>
<p class="para">
Returns <strong><code>TRUE</code></strong> on success.
</p>
</div>
<div class="refsect1 errors" id="refsect1-imagick.optimizeimagelayers-errors">
<h3 class="title">Errors/Exceptions</h3>
<p class="para">
Throws ImagickException on error.
</p>
</div>
<div class="refsect1 examples" id="refsect1-imagick.optimizeimagelayers-examples">
<h3 class="title">Examples</h3>
<p class="para">
<div class="example" id="example-3329">
<p><strong>Example #1 Using <span class="function"><strong>Imagick::optimizeImageLayers()</strong></span></strong></p>
<div class="example-contents"><p>
Reading, optimizing and writing a GIF image
</p></div>
<div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB"><?php<br /></span><span style="color: #FF8000">/* create new imagick object */<br /></span><span style="color: #0000BB">$im </span><span style="color: #007700">= new </span><span style="color: #0000BB">Imagick</span><span style="color: #007700">(</span><span style="color: #DD0000">"test.gif"</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">/* optimize the image layers */<br /></span><span style="color: #0000BB">$im</span><span style="color: #007700">-></span><span style="color: #0000BB">optimizeImageLayers</span><span style="color: #007700">();<br /><br /></span><span style="color: #FF8000">/* write the image back */<br /></span><span style="color: #0000BB">$im</span><span style="color: #007700">-></span><span style="color: #0000BB">writeImages</span><span style="color: #007700">(</span><span style="color: #DD0000">"test_optimized.gif"</span><span style="color: #007700">, </span><span style="color: #0000BB">true</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?></span>
</span>
</code></div>
</div>
</div>
</p>
</div>
<div class="refsect1 seealso" id="refsect1-imagick.optimizeimagelayers-seealso">
<h3 class="title">See Also</h3>
<p class="para">
<ul class="simplelist">
<li class="member"> <span class="function"><a href="imagick.compareimagelayers.html" class="function" rel="rdfs-seeAlso">Imagick::compareImageLayers()</a> - Returns the maximum bounding region between images</span></li>
<li class="member"> <span class="function"><a href="imagick.writeimages.html" class="function" rel="rdfs-seeAlso">Imagick::writeImages()</a> - Writes an image or image sequence</span></li>
<li class="member"> <span class="function"><a href="imagick.writeimage.html" class="function" rel="rdfs-seeAlso">Imagick::writeImage()</a> - Writes an image to the specified filename</span></li>
</ul>
</p>
</div>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="imagick.opaquepaintimage.html">Imagick::opaquePaintImage</a></div>
<div class="next" style="text-align: right; float: right;"><a href="imagick.orderedposterizeimage.html">Imagick::orderedPosterizeImage</a></div>
<div class="up"><a href="class.imagick.html">Imagick</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
