\HeaderA{grid.points}{Draw Data Symbols}{grid.points}
\aliasA{pointsGrob}{grid.points}{pointsGrob}
\keyword{dplot}{grid.points}
\begin{Description}\relax
These functions create and draw data symbols.
\end{Description}
\begin{Usage}
\begin{verbatim}
grid.points(x = stats::runif(10),
            y = stats::runif(10),
            pch = 1, size = unit(1, "char"),
            default.units = "native", name = NULL,
            gp = gpar(), draw = TRUE, vp = NULL)
pointsGrob(x = stats::runif(10),
           y = stats::runif(10),
           pch = 1, size = unit(1, "char"),
           default.units = "native", name = NULL,
           gp = gpar(), vp = NULL)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{x}] A numeric vector or unit object specifying x-values.
\item[\code{y}] A numeric vector or unit object specifying y-values.
\item[\code{pch}] A numeric or character vector indicating what sort of
plotting symbol to use.  See \code{\LinkA{points}{points}} for the
interpretation of these values.
\item[\code{size}] A unit object specifying the size of the plotting symbols.
\item[\code{default.units}] A string indicating the default units to use
if \code{x} or \code{y} are only given as numeric vectors.
\item[\code{name}] A character identifier. 
\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{draw}] A logical value indicating whether graphics output
should be produced.
\item[\code{vp}] A Grid viewport object (or NULL).
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
Both functions create a points grob (a graphical object describing
points), but only \code{grid.points} draws the points (and then only
if \code{draw} is \code{TRUE}).
\end{Details}
\begin{Value}
A points grob.  \code{grid.points} returns the value invisibly.
\end{Value}
\begin{Author}\relax
Paul Murrell
\end{Author}
\begin{SeeAlso}\relax
\LinkA{Grid}{Grid},
\code{\LinkA{viewport}{viewport}}
\end{SeeAlso}

