\HeaderA{grid.move.to}{Move or Draw to a Specified Position}{grid.move.to}
\aliasA{grid.line.to}{grid.move.to}{grid.line.to}
\aliasA{lineToGrob}{grid.move.to}{lineToGrob}
\aliasA{moveToGrob}{grid.move.to}{moveToGrob}
\keyword{dplot}{grid.move.to}
\begin{Description}\relax
Grid has the notion of a current location.  These functions
sets that location.
\end{Description}
\begin{Usage}
\begin{verbatim}
grid.move.to(x = 0, y = 0, default.units = "npc", name = NULL,
             draw = TRUE, vp = NULL)

moveToGrob(x = 0, y = 0, default.units = "npc", name = NULL, vp = NULL)

grid.line.to(x = 1, y = 1, default.units = "npc",
             arrow = NULL, name = NULL,
             gp = gpar(), draw = TRUE, vp = NULL)

lineToGrob(x = 1, y = 1, default.units = "npc", arrow = NULL,
           name = NULL, gp = gpar(), vp = NULL)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{x}] A numeric value or a unit object specifying an x-value.
\item[\code{y}] A numeric value or a unit object specifying a y-value.
\item[\code{default.units}] A string indicating the default units to use
if \code{x} or \code{y} are only given as numeric values.
\item[\code{arrow}] A list describing arrow heads to place at either end
of the line, as produced by the \code{arrow} function.
\item[\code{name}] A character identifier. 
\item[\code{draw}] A logical value indicating whether graphics output
should be produced.
\item[\code{gp}] An object of class \code{gpar}, typically the output
from a call to the function \code{gpar}.  This is basically
a list of graphical parameter settings.
\item[\code{vp}] A Grid viewport object (or NULL).
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
Both functions create a move.to/line.to grob (a graphical object describing a
move-to/line-to), but only \code{grid.move.to/line.to()}
draws the move.to/line.to (and then only if \code{draw} is \code{TRUE}).
\end{Details}
\begin{Value}
A move.to/line.to grob.
\code{grid.move.to/line.to()} returns the value invisibly.
\end{Value}
\begin{Author}\relax
Paul Murrell
\end{Author}
\begin{SeeAlso}\relax
\LinkA{Grid}{Grid},
\code{\LinkA{viewport}{viewport}},
\code{\LinkA{arrow}{arrow}}
\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
grid.newpage()
grid.move.to(0.5, 0.5)
grid.line.to(1, 1)
grid.line.to(0.5, 0)
pushViewport(viewport(x=0, y=0, w=0.25, h=0.25, just=c("left", "bottom")))
grid.rect()
grid.grill()
grid.line.to(0.5, 0.5)
popViewport()
\end{ExampleCode}
\end{Examples}

