\name{grid.element}
\alias{grid.element}
\alias{elementGrob}
\alias{grid.textNode}
\alias{textNodeGrob}
\title{ Create a grid grob representing an SVG element }
\description{
  Creates a \code{element.grob} object which is a grid
  \code{\link{gTree}}, representing an SVG element. Useful in
  conjunction with \code{grid.export}, to produce an SVG document with
  elements inserted at particular points. The element (and its children)
  are inserted at the point where the grob is \dQuote{drawn}. Text can
  be inserted in a similar manner with \code{grid.textNode}.
}
\usage{
grid.element(el, name = NULL, attrs = NULL,
             namespace = NULL, namespaceDefinitions = NULL,
             children = NULL, vp = NULL,
             childrenvp = NULL, asis = FALSE)
elementGrob(el, name = NULL, attrs = NULL,
            namespace = NULL, namespaceDefinitions = NULL,
            children = NULL, vp = NULL,
            childrenvp = NULL, asis = FALSE)
grid.textNode(text, name = NULL, vp = NULL)
textNodeGrob(text, name = NULL, vp = NULL)
}
\arguments{
  \item{el}{
    The name of the SVG element to create, e.g. "rect".
  }
  \item{text}{
    A single element character vector of text directly into insert into
    the SVG image.
  }
  \item{name}{
    A character identifier.
  }
  \item{attrs}{
    A list, where the names are SVG attribute names, and values are the
    values given to the SVG attributes.
  }
  \item{namespace}{
    A character vector specifying the namespace for this new element.
  }
  \item{namespaceDefinitions}{
    A character vector or a list with each element being a string.

    These give the URIs identifying the namespaces uniquely. The
    elements should have names which are used as prefixes. A default
    namespace has "" as the name. The values here are used only for
    defining new namespaces and not for determining the namespace to use
    for this particular element.
  }
  \item{children}{
    A gList object containing children of this element (if any).
  }
  \item{vp}{ A viewport object to draw within. }
  \item{childrenvp}{
    A viewport object to use for the children of the element grob.
  }
  \item{asis}{
    If \code{TRUE}, SVG id attributes will be generated from the
    \code{name} with no modification so that we can easily refer to the
    generated elements.
  }
}
\value{
  An \code{element.grob} object. For \code{grid.textNode} a
  \code{textnode.grob} object.
}
\author{ Simon Potter }
\seealso{ \code{\link{grid.export}} }
\keyword{ dplot }