\HeaderA{denoise}{Blurring images}{denoise}
\aliasA{blur}{denoise}{blur}
\aliasA{gblur}{denoise}{gblur}
\begin{Description}\relax
Blurs an image with ImageMagick functions.
\end{Description}
\begin{Usage}
\begin{verbatim}
  blur(x, r=0, s=0.5)
  gblur(x, r=0, s=0.5)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{x}] An \code{Image} object or an array.
\item[\code{r}] A numeric value for the radius of the pixel neighbourhood.
The default value 0 enables automatic radius selection.
\item[\code{s}] The standard deviation of the Gaussian filter used for
blurring. For reasonable results, \code{r} must be larger
than \code{s}. 
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
\code{blur} uses an unspecified separable kernel. \code{gblur} uses
a Gaussian kernel. The algorithms used by these ImageMagick functions
are not well defined and hence, the usage of \code{filter2} is preferable
to \code{blur} or \code{gblur}.
\end{Details}
\begin{Value}
An \code{Image} object or an array, containing the blurred version
of \code{x}.
\end{Value}
\begin{Author}\relax
Oleg Sklyar, \email{osklyar@ebi.ac.uk}, 2005-2007
\end{Author}
\begin{References}\relax
\emph{ImageMagick}: \url{http://www.imagemagick.org}.
\end{References}
\begin{SeeAlso}\relax
\code{filter2}
\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
   x = readImage(system.file("images", "lena.gif", package="EBImage"))
   if (interactive()) display(x)

   y = blur(x, r=3, s=2)
   if (interactive()) display(y, title='blur(x, r=3, s=2)')

   y = gblur(x, r=3, s=2)
   if (interactive()) display(y, title='gblur(x, r=3, s=2)')
\end{ExampleCode}
\end{Examples}

