<!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>Description</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="imagickkernel.getmatrix.html">ImagickKernel::getMatrix</a></div>
<div class="next" style="text-align: right; float: right;"><a href="imagickkernel.separate.html">ImagickKernel::separate</a></div>
<div class="up"><a href="class.imagickkernel.html">ImagickKernel</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="imagickkernel.scale" class="refentry">
<div class="refnamediv">
<h1 class="refname">ImagickKernel::scale</h1>
<p class="verinfo">(PECL imagick >= 3.3.0)</p><p class="refpurpose"><span class="refname">ImagickKernel::scale</span> — <span class="dc-title">Description</span></p>
</div>
<div class="refsect1 description" id="refsect1-imagickkernel.scale-description">
<h3 class="title">Description</h3>
<div class="methodsynopsis dc-description">
<span class="modifier">public</span> <span class="type"><span class="type void">void</span></span> <span class="methodname"><strong>ImagickKernel::scale</strong></span>
( <span class="methodparam"><span class="type">float</span> <code class="parameter">$scale</code></span>
[, <span class="methodparam"><span class="type">int</span> <code class="parameter">$normalizeFlag</code></span>
] )</div>
<p class="para rdfs-comment">
ScaleKernelInfo() scales the given kernel list by the given amount, with or without
normalization of the sum of the kernel values (as per given flags).
The exact behaviour of this function depends on the normalization type being used
please see http://www.imagemagick.org/api/morphology.php#ScaleKernelInfo for details.
Flag should be one of Imagick::NORMALIZE_KERNEL_VALUE, Imagick::NORMALIZE_KERNEL_CORRELATE,
Imagick::NORMALIZE_KERNEL_PERCENT or not set.
</p>
</div>
<div class="refsect1 parameters" id="refsect1-imagickkernel.scale-parameters">
<h3 class="title">Parameters</h3>
<p class="para">This function has no parameters.</p>
</div>
<div class="refsect1 returnvalues" id="refsect1-imagickkernel.scale-returnvalues">
<h3 class="title">Return Values</h3>
<p class="para">
</p>
</div>
<div class="refsect1 examples" id="refsect1-imagickkernel.scale-examples">
<h3 class="title">Examples</h3>
<p class="para">
<div class="example" id="example-4138">
<p><strong>Example #1 <span class="function"><strong>ImagickKernel::scale()</strong></span></strong></p>
<div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB"><?php<br /><br /><br /> </span><span style="color: #007700">function </span><span style="color: #0000BB">renderKernelTable</span><span style="color: #007700">(</span><span style="color: #0000BB">$matrix</span><span style="color: #007700">) {<br /> </span><span style="color: #0000BB">$output </span><span style="color: #007700">= </span><span style="color: #DD0000">"<table class='infoTable'>"</span><span style="color: #007700">;<br /> <br /> foreach (</span><span style="color: #0000BB">$matrix </span><span style="color: #007700">as </span><span style="color: #0000BB">$row</span><span style="color: #007700">) {<br /> </span><span style="color: #0000BB">$output </span><span style="color: #007700">.= </span><span style="color: #DD0000">"<tr>"</span><span style="color: #007700">;<br /> foreach (</span><span style="color: #0000BB">$row </span><span style="color: #007700">as </span><span style="color: #0000BB">$cell</span><span style="color: #007700">) {<br /> </span><span style="color: #0000BB">$output </span><span style="color: #007700">.= </span><span style="color: #DD0000">"<td style='text-align:left'>"</span><span style="color: #007700">;<br /> if (</span><span style="color: #0000BB">$cell </span><span style="color: #007700">=== </span><span style="color: #0000BB">false</span><span style="color: #007700">) {<br /> </span><span style="color: #0000BB">$output </span><span style="color: #007700">.= </span><span style="color: #DD0000">"false"</span><span style="color: #007700">;<br /> }<br /> else {<br /> </span><span style="color: #0000BB">$output </span><span style="color: #007700">.= </span><span style="color: #0000BB">round</span><span style="color: #007700">(</span><span style="color: #0000BB">$cell</span><span style="color: #007700">, </span><span style="color: #0000BB">3</span><span style="color: #007700">);<br /> }<br /> </span><span style="color: #0000BB">$output </span><span style="color: #007700">.= </span><span style="color: #DD0000">"</td>"</span><span style="color: #007700">;<br /> }<br /> </span><span style="color: #0000BB">$output </span><span style="color: #007700">.= </span><span style="color: #DD0000">"</tr>"</span><span style="color: #007700">;<br /> }<br /> <br /> </span><span style="color: #0000BB">$output </span><span style="color: #007700">.= </span><span style="color: #DD0000">"</table>"</span><span style="color: #007700">;<br /> <br /> return </span><span style="color: #0000BB">$output</span><span style="color: #007700">;<br /> }<br /><br /><br /> </span><span style="color: #0000BB">$output </span><span style="color: #007700">= </span><span style="color: #DD0000">""</span><span style="color: #007700">;<br /> <br /> </span><span style="color: #0000BB">$matrix </span><span style="color: #007700">= [<br /> [-</span><span style="color: #0000BB">1</span><span style="color: #007700">, </span><span style="color: #0000BB">0</span><span style="color: #007700">, -</span><span style="color: #0000BB">1</span><span style="color: #007700">],<br /> [ </span><span style="color: #0000BB">0</span><span style="color: #007700">, </span><span style="color: #0000BB">4</span><span style="color: #007700">, </span><span style="color: #0000BB">0</span><span style="color: #007700">],<br /> [-</span><span style="color: #0000BB">1</span><span style="color: #007700">, </span><span style="color: #0000BB">0</span><span style="color: #007700">, -</span><span style="color: #0000BB">1</span><span style="color: #007700">],<br /> ];<br /><br /> </span><span style="color: #0000BB">$kernel </span><span style="color: #007700">= \</span><span style="color: #0000BB">ImagickKernel</span><span style="color: #007700">::</span><span style="color: #0000BB">fromMatrix</span><span style="color: #007700">(</span><span style="color: #0000BB">$matrix</span><span style="color: #007700">);<br /> </span><span style="color: #0000BB">$kernelClone </span><span style="color: #007700">= clone </span><span style="color: #0000BB">$kernel</span><span style="color: #007700">;<br /><br /> </span><span style="color: #0000BB">$output </span><span style="color: #007700">.= </span><span style="color: #DD0000">"Start kernel<br/>"</span><span style="color: #007700">;<br /> </span><span style="color: #0000BB">$output </span><span style="color: #007700">.= </span><span style="color: #0000BB">renderKernelTable</span><span style="color: #007700">(</span><span style="color: #0000BB">$kernel</span><span style="color: #007700">-></span><span style="color: #0000BB">getMatrix</span><span style="color: #007700">());<br /> <br /> <br /> </span><span style="color: #0000BB">$output </span><span style="color: #007700">.= </span><span style="color: #DD0000">"Scaling with NORMALIZE_KERNEL_VALUE. The <br/>"</span><span style="color: #007700">;<br /> </span><span style="color: #0000BB">$kernel</span><span style="color: #007700">-></span><span style="color: #0000BB">scale</span><span style="color: #007700">(</span><span style="color: #0000BB">2</span><span style="color: #007700">, \</span><span style="color: #0000BB">Imagick</span><span style="color: #007700">::</span><span style="color: #0000BB">NORMALIZE_KERNEL_VALUE</span><span style="color: #007700">);<br /> </span><span style="color: #0000BB">$output </span><span style="color: #007700">.= </span><span style="color: #0000BB">renderKernelTable</span><span style="color: #007700">(</span><span style="color: #0000BB">$kernel</span><span style="color: #007700">-></span><span style="color: #0000BB">getMatrix</span><span style="color: #007700">());<br /><br /><br /> </span><span style="color: #0000BB">$kernel </span><span style="color: #007700">= clone </span><span style="color: #0000BB">$kernelClone</span><span style="color: #007700">;<br /> </span><span style="color: #0000BB">$output </span><span style="color: #007700">.= </span><span style="color: #DD0000">"Scaling by percent<br/>"</span><span style="color: #007700">;<br /> </span><span style="color: #0000BB">$kernel</span><span style="color: #007700">-></span><span style="color: #0000BB">scale</span><span style="color: #007700">(</span><span style="color: #0000BB">2</span><span style="color: #007700">, \</span><span style="color: #0000BB">Imagick</span><span style="color: #007700">::</span><span style="color: #0000BB">NORMALIZE_KERNEL_PERCENT</span><span style="color: #007700">);<br /> </span><span style="color: #0000BB">$output </span><span style="color: #007700">.= </span><span style="color: #0000BB">renderKernelTable</span><span style="color: #007700">(</span><span style="color: #0000BB">$kernel</span><span style="color: #007700">-></span><span style="color: #0000BB">getMatrix</span><span style="color: #007700">());<br /> <br /> </span><span style="color: #0000BB">$matrix2 </span><span style="color: #007700">= [<br /> [-</span><span style="color: #0000BB">1</span><span style="color: #007700">, -</span><span style="color: #0000BB">1</span><span style="color: #007700">, </span><span style="color: #0000BB">1</span><span style="color: #007700">],<br /> [ -</span><span style="color: #0000BB">1</span><span style="color: #007700">, </span><span style="color: #0000BB">false</span><span style="color: #007700">, </span><span style="color: #0000BB">1</span><span style="color: #007700">],<br /> [</span><span style="color: #0000BB">1</span><span style="color: #007700">, </span><span style="color: #0000BB">1</span><span style="color: #007700">, </span><span style="color: #0000BB">1</span><span style="color: #007700">],<br /> ];<br /> <br /> </span><span style="color: #0000BB">$kernel </span><span style="color: #007700">= \</span><span style="color: #0000BB">ImagickKernel</span><span style="color: #007700">::</span><span style="color: #0000BB">fromMatrix</span><span style="color: #007700">(</span><span style="color: #0000BB">$matrix2</span><span style="color: #007700">);<br /> </span><span style="color: #0000BB">$output </span><span style="color: #007700">.= </span><span style="color: #DD0000">"Scaling by correlate<br/>"</span><span style="color: #007700">;<br /> </span><span style="color: #0000BB">$kernel</span><span style="color: #007700">-></span><span style="color: #0000BB">scale</span><span style="color: #007700">(</span><span style="color: #0000BB">1</span><span style="color: #007700">, \</span><span style="color: #0000BB">Imagick</span><span style="color: #007700">::</span><span style="color: #0000BB">NORMALIZE_KERNEL_CORRELATE</span><span style="color: #007700">);<br /> </span><span style="color: #0000BB">$output </span><span style="color: #007700">.= </span><span style="color: #0000BB">renderKernelTable</span><span style="color: #007700">(</span><span style="color: #0000BB">$kernel</span><span style="color: #007700">-></span><span style="color: #0000BB">getMatrix</span><span style="color: #007700">());<br /><br /> return </span><span style="color: #0000BB">$output</span><span style="color: #007700">; <br /></span><span style="color: #0000BB">?></span>
</span>
</code></div>
</div>
</div>
</p>
</div>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="imagickkernel.getmatrix.html">ImagickKernel::getMatrix</a></div>
<div class="next" style="text-align: right; float: right;"><a href="imagickkernel.separate.html">ImagickKernel::separate</a></div>
<div class="up"><a href="class.imagickkernel.html">ImagickKernel</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
