\HeaderA{enhance}{Enhancing images and colors}{enhance}
\aliasA{cgamma}{enhance}{cgamma}
\aliasA{cgamma,Image-method}{enhance}{cgamma,Image.Rdash.method}
\aliasA{contrast}{enhance}{contrast}
\aliasA{contrast,Image-method}{enhance}{contrast,Image.Rdash.method}
\aliasA{enhance,Image-method}{enhance}{enhance,Image.Rdash.method}
\aliasA{equalize}{enhance}{equalize}
\aliasA{equalize,Image-method}{enhance}{equalize,Image.Rdash.method}
\aliasA{modulate}{enhance}{modulate}
\aliasA{modulate,Image-method}{enhance}{modulate,Image.Rdash.method}
\keyword{manip}{enhance}
\begin{Description}\relax
Functions to enhance and modify colors in images.
\end{Description}
\begin{Usage}
\begin{verbatim}

  ## S4 method for signature 'Image':
  cgamma(x, level=1, ...)
  ## S4 method for signature 'Image':
  contrast(x, sharpen=TRUE, ...)
  ## S4 method for signature 'Image':
  enhance(x, ...)
  ## S4 method for signature 'Image':
  equalize(x, ...)
  ## S4 method for signature 'Image':
  modulate(x, value=100, ...)

\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{x}] An object of \code{\LinkA{Image}{Image.Rdash.class}}. 
\item[\code{level}] A numeric for the gamma level. 
\item[\code{sharpen}] A logical specifying whether the contrast should
be increased (\code{TRUE}) or decreased (\code{FALSE}). 
\item[\code{value}] A percent change in brightness, saturation, and hue. 
The default value to keep the values unchanged. 
\item[\code{...}] Reserved. 
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
\code{cgamma} gamma-corrects image. The same image viewed on different 
devices will have perceptual differences in the way the image's intensities 
are represented on the screen. Adjust all three channels with the level 
parameter. Values typically range from 0.8 to 2.3.

\code{contrast} enhances the intensity differences between the lighter and 
darker elements of the image.

\code{enhance} applies a digital filter that improves the quality of a 
noisy image.

\code{equalize} applies a histogram equalization to the image.

\code{modulate} lets you control the brightness, saturation, and hue of 
an image. Modulate represents the brightness, saturation, and hue as one 
parameter.
\end{Details}
\begin{Value}
A transformed image in an object of \code{\LinkA{Image}{Image.Rdash.class}}.
\end{Value}
\begin{Author}\relax
Oleg Sklyar, \email{osklyar@ebi.ac.uk}, 2006-2007
\end{Author}
\begin{References}\relax
\emph{ImageMagick}: \url{http://www.imagemagick.org}.
\end{References}
\begin{SeeAlso}\relax
\code{
    \LinkA{Image}{Image.Rdash.class}
  }
\end{SeeAlso}

