grid.show.layout.html
3.1 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><title>R: Draw a Diagram of a Grid Layout</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="stylesheet" type="text/css" href="../../R.css">
</head><body>
<table width="100%" summary="page for grid.show.layout {grid}"><tr><td>grid.show.layout {grid}</td><td align="right">R Documentation</td></tr></table>
<h2>Draw a Diagram of a Grid Layout</h2>
<h3>Description</h3>
<p>
This function uses Grid graphics to draw a diagram of a
Grid layout.
</p>
<h3>Usage</h3>
<pre>
grid.show.layout(l, newpage=TRUE, bg = "light grey",
cell.border = "blue", cell.fill = "light blue",
cell.label = TRUE, label.col = "blue",
unit.col = "red", vp = NULL)
</pre>
<h3>Arguments</h3>
<table summary="R argblock">
<tr valign="top"><td><code>l</code></td>
<td>
A Grid layout object.</td></tr>
<tr valign="top"><td><code>newpage</code></td>
<td>
A logical value indicating whether to move on
to a new page before drawing the diagram.</td></tr>
<tr valign="top"><td><code>bg</code></td>
<td>
The colour used for the background.</td></tr>
<tr valign="top"><td><code>cell.border</code></td>
<td>
The colour used to draw the borders of the cells
in the layout.</td></tr>
<tr valign="top"><td><code>cell.fill</code></td>
<td>
The colour used to fill the cells in the layout.</td></tr>
<tr valign="top"><td><code>cell.label</code></td>
<td>
A logical indicating whether the layout cells
should be labelled.</td></tr>
<tr valign="top"><td><code>label.col</code></td>
<td>
The colour used for layout cell labels.</td></tr>
<tr valign="top"><td><code>unit.col</code></td>
<td>
The colour used for labelling the widths/heights of
columns/rows.</td></tr>
<tr valign="top"><td><code>vp</code></td>
<td>
A Grid viewport object (or NULL).</td></tr>
</table>
<h3>Details</h3>
<p>
A viewport is created within <code>vp</code> to provide a margin for
annotation, and the layout is drawn within that new viewport.
The margin is filled with light grey, the new viewport is filled
with white and framed with a black border, and the layout regions
are filled with light blue and framed with a blue border.
The diagram is annotated with the widths and heights (including units)
of the columns and rows of the layout using red text. (All colours
are defaults and may be customised via function arguments.)
</p>
<h3>Value</h3>
<p>
None.</p>
<h3>Author(s)</h3>
<p>
Paul Murrell
</p>
<h3>See Also</h3>
<p>
<a href="Grid.html">Grid</a>,
<code><a href="viewport.html">viewport</a></code>,
<code><a href="grid.layout.html">grid.layout</a></code>
</p>
<h3>Examples</h3>
<pre>
## Diagram of a simple layout
grid.show.layout(grid.layout(4,2,
heights=unit(rep(1, 4),
c("lines", "lines", "lines", "null")),
widths=unit(c(1, 1), "inches")))
</pre>
<hr><div align="center">[Package <em>grid</em> version 2.5.1 <a href="00Index.html">Index]</a></div>
</body></html>