\HeaderA{gEdit}{Create and Apply Edit Objects}{gEdit}
\aliasA{applyEdit}{gEdit}{applyEdit}
\aliasA{applyEdits}{gEdit}{applyEdits}
\aliasA{gEditList}{gEdit}{gEditList}
\keyword{dplot}{gEdit}
\begin{Description}\relax
The functions \code{gEdit} and \code{gEditList} create
objects representing an edit operation (essentially a list
of arguments to \code{editGrob}).

The functions \code{applyEdit} and \code{applyEdits} apply
one or more edit operations to a graphical object.

These functions are most useful for developers creating new
graphical functions and objects.
\end{Description}
\begin{Usage}
\begin{verbatim}
gEdit(...)
gEditList(...)
applyEdit(x, edit)
applyEdits(x, edits)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{...}] one or more arguments to the \code{editGrob} function
(for \code{gEdit}) or one or more \code{"gEdit"} objects
(for \code{gEditList}).
\item[\code{x}] a grob (grid graphical object).
\item[\code{edit}] a \code{"gEdit"} object.
\item[\code{edits}] either a \code{"gEdit"} object or a \code{"gEditList"}
object.
\end{ldescription}
\end{Arguments}
\begin{Value}
\code{gEdit} returns an object of class \code{"gEdit"}.

\code{gEditList} returns an object of class \code{"gEditList"}.

\code{applyEdit} and \code{applyEditList} return the modified grob.
\end{Value}
\begin{Author}\relax
Paul Murrell
\end{Author}
\begin{SeeAlso}\relax
\code{\LinkA{grob}{grob}}
\code{\LinkA{editGrob}{editGrob}}
\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
grid.rect(gp=gpar(col="red"))
# same thing, but more verbose
grid.draw(applyEdit(rectGrob(), gEdit(gp=gpar(col="red"))))
\end{ExampleCode}
\end{Examples}

