\name{grid.animate}
\alias{grid.animate}
\alias{animateGrob}
\title{ Animate a grid grob }
\description{
  Creates an animated.grob object.
  Useful in conjunction with
  \code{grid.export}, to produce an SVG document with
  animated graphical elements.
}
\usage{
animateGrob(grob, ...,
            duration=1,
            rep=FALSE, revert=FALSE,
            begin=0, interpolate="linear", group=FALSE)
grid.animate(path, ..., group=FALSE, redraw = FALSE,
             strict=FALSE, grep=FALSE, global=FALSE)
}
\arguments{
  \item{grob}{ A grob to add animation to. }
  \item{path}{ A grob path specifying a drawn grob. }
  \item{\dots}{ Arguments of the grob to animate. }
  \item{duration}{ The duration in seconds of the animation. }
  \item{rep}{ The number of times the animation should repeat.
    \code{FALSE} means once, \code{TRUE} means indefinitely. }
  \item{revert}{ What should happen when (if) the animation ends;
    \code{TRUE} means revert to the first animated value,
    \code{FALSE} means finish on the last animated value. }
  \item{begin}{ When the animation should begin (seconds). }
  \item{interpolate}{ A character value describing how animation values are
    interpreted. One of \code{linear} or \code{discrete}. }
  \item{group}{ A logical indicating whether the animation values
    should be applied to the overall group element in SVG or
    to individual SVG elements.}
  \item{redraw}{
    A logical value to indicate whether to redraw the grob.
  }
  \item{strict}{
    A boolean indicating whether the \code{path} must be matched
    exactly.
  }
  \item{grep}{
    Whether the \code{path} should be treated as a regular expression.
  }
  \item{global}{
    A boolean indicating whether the function should affect just the
    first match of the \code{path}, or whether all matches should be
    affected.
  }
}
\value{
  An animated.grob object.
}
\author{ Paul Murrell }
\seealso{ \code{\link{grid.export}} }
\keyword{ dplot }