EVOLUTION-MANAGER
Edit File: grid.record.html
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><title>R: Encapsulate calculations and drawing</title> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <link rel="stylesheet" type="text/css" href="R.css" /> </head><body> <table width="100%" summary="page for grid.record {grid}"><tr><td>grid.record {grid}</td><td style="text-align: right;">R Documentation</td></tr></table> <h2> Encapsulate calculations and drawing </h2> <h3>Description</h3> <p>Evaluates an expression that includes both calculations and drawing that depends on the calculations so that both the calculations and the drawing will be rerun when the scene is redrawn (e.g., device resize or editing). </p> <p>Intended <em>only</em> for expert use. </p> <h3>Usage</h3> <pre> recordGrob(expr, list, name=NULL, gp=NULL, vp=NULL) grid.record(expr, list, name=NULL, gp=NULL, vp=NULL) </pre> <h3>Arguments</h3> <table summary="R argblock"> <tr valign="top"><td><code>expr</code></td> <td> <p>object of mode <code><a href="../../base/html/expression.html">expression</a></code> or <code>call</code> or an unevaluated expression.</p> </td></tr> <tr valign="top"><td><code>list</code></td> <td> <p>a list defining the environment in which <code>expr</code> is to be evaluated.</p> </td></tr> <tr valign="top"><td><code>name</code></td> <td> <p> A character identifier. </p> </td></tr> <tr valign="top"><td><code>gp</code></td> <td> <p>An object of class <code>gpar</code>, typically the output from a call to the function <code>gpar</code>. This is basically a list of graphical parameter settings.</p> </td></tr> <tr valign="top"><td><code>vp</code></td> <td> <p>A Grid viewport object (or NULL).</p> </td></tr> </table> <h3>Details</h3> <p>A grob is created of special class <code>"recordedGrob"</code> (and drawn, in the case of <code>grid.record</code>). The <code>drawDetails</code> method for this class evaluates the expression with the list as the evaluation environment (and the grid Namespace as the parent of that environment). </p> <h3>Note</h3> <p> This function <em>must</em> be used instead of the function <code>recordGraphics</code>; all of the dire warnings about using <code>recordGraphics</code> responsibly also apply here. </p> <h3>Author(s)</h3> <p> Paul Murrell </p> <h3>See Also</h3> <p><code><a href="../../grDevices/html/recordGraphics.html">recordGraphics</a></code> </p> <h3>Examples</h3> <pre> grid.record({ w <- convertWidth(unit(1, "inches"), "npc") grid.rect(width=w) }, list()) </pre> <hr /><div style="text-align: center;">[Package <em>grid</em> version 3.6.0 <a href="00Index.html">Index</a>]</div> </body></html>