<!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>Adjusts the levels of an image</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="gmagick.labelimage.html">Gmagick::labelimage</a></div>
<div class="next" style="text-align: right; float: right;"><a href="gmagick.magnifyimage.html">Gmagick::magnifyimage</a></div>
<div class="up"><a href="class.gmagick.html">Gmagick</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="gmagick.levelimage" class="refentry">
<div class="refnamediv">
<h1 class="refname">Gmagick::levelimage</h1>
<p class="verinfo">(PECL gmagick >= Unknown)</p><p class="refpurpose"><span class="refname">Gmagick::levelimage</span> — <span class="dc-title">Adjusts the levels of an image</span></p>
</div>
<div class="refsect1 description" id="refsect1-gmagick.levelimage-description">
<h3 class="title">Description</h3>
<div class="methodsynopsis dc-description">
<span class="modifier">public</span> <span class="type"><a href="language.pseudo-types.html#language.types.mixed" class="type mixed">mixed</a></span> <span class="methodname"><strong>Gmagick::levelimage</strong></span>
( <span class="methodparam"><span class="type">float</span> <code class="parameter">$blackPoint</code></span>
, <span class="methodparam"><span class="type">float</span> <code class="parameter">$gamma</code></span>
, <span class="methodparam"><span class="type">float</span> <code class="parameter">$whitePoint</code></span>
[, <span class="methodparam"><span class="type">int</span> <code class="parameter">$channel</code><span class="initializer"> = Gmagick::CHANNEL_DEFAULT</span></span>
] )</div>
<p class="para rdfs-comment">
Adjusts the levels of an image by scaling the colors falling between specified white and black
points to the full available quantum range. The parameters provided represent the black, mid, and
white points. The black point specifies the darkest color in the image. Colors darker than the black
point are set to zero. Mid point specifies a gamma correction to apply to the image. White point
specifies the lightest color in the image. Colors brighter than the white point are set to the
maximum quantum value.
</p>
</div>
<div class="refsect1 parameters" id="refsect1-gmagick.levelimage-parameters">
<h3 class="title">Parameters</h3>
<p class="para">
<dl>
<dt>
<span class="term"><em><code class="parameter">blackPoint</code></em></span>
<dd>
<p class="para">
The image black point
</p>
</dd>
</dt>
<dt>
<span class="term"><em><code class="parameter">gamma</code></em></span>
<dd>
<p class="para">
The gamma value
</p>
</dd>
</dt>
<dt>
<span class="term"><em><code class="parameter">whitePoint</code></em></span>
<dd>
<p class="para">
The image white point
</p>
</dd>
</dt>
<dt>
<span class="term"><em><code class="parameter">channel</code></em></span>
<dd>
<p class="para">
Provide any channel constant that is valid for your channel mode.
To apply to more than one channel, combine channeltype constants using bitwise
operators. Refer to this list of <a href="gmagick.constants.html#gmagick.constants.channel" class="link">channel constants</a>.
</p>
</dd>
</dt>
</dl>
</p>
</div>
<div class="refsect1 returnvalues" id="refsect1-gmagick.levelimage-returnvalues">
<h3 class="title">Return Values</h3>
<p class="para">
Gmagick object with image levelled.
</p>
</div>
<div class="refsect1 errors" id="refsect1-gmagick.levelimage-errors">
<h3 class="title">Errors/Exceptions</h3>
<p class="para">
Throws an
<strong class="classname">GmagickException</strong> on error.
</p>
</div>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="gmagick.labelimage.html">Gmagick::labelimage</a></div>
<div class="next" style="text-align: right; float: right;"><a href="gmagick.magnifyimage.html">Gmagick::magnifyimage</a></div>
<div class="up"><a href="class.gmagick.html">Gmagick</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
