The R Project SVN R

Rev

Rev 68948 | Rev 81221 | Go to most recent revision | Show entire file | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 68948 Rev 75103
Line 1... Line 1...
1 
% File src/library/grDevices/man/windows/windows.Rd
 1 
% File src/library/grDevices/man/windows.Rd
2 
% Part of the R package, https://www.R-project.org
 2 
% Part of the R package, https://www.R-project.org
3 
% Copyright 1995-2014 R Core Team
 3 
% Copyright 1995-2018 R Core Team
4 
% Distributed under GPL 2 or later
 4 
% Distributed under GPL 2 or later
5 
 
 5 
 
6 
\name{windows}
 6 
\name{windows}
7 
\alias{windows}
 7 
\alias{windows}
8 
\alias{win.graph}
 8 
\alias{win.graph}
9 
\alias{win.metafile}
 9 
\alias{win.metafile}
10 
\alias{win.print}
 10 
\alias{win.print}
11 
\alias{x11}
 - 
 
12 
\alias{X11}
 - 
 
13 
\alias{print.SavedPlots}
 11 
\alias{print.SavedPlots}
14 
\alias{[.SavedPlots}
 12 
\alias{[.SavedPlots}
15 
 
 13 
 
16 
\title{Windows Graphics Devices}
 14 
\title{Windows Graphics Devices}
17 
 
 15 
 
18 
\description{
 16 
\description{
- 
 
 17 
  Available only on Windows.
19 
  A graphics device is opened.  For \code{windows}, \code{win.graph},
 18 
  A graphics device is opened.  For \code{windows}, \code{win.graph},
20 
  \code{x11} and \code{X11} this is a window on the current
 19 
  \code{x11} and \code{X11} this is a window on the current
21 
  Windows display: the multiple names are for compatibility with other
 20 
  Windows display: the multiple names are for compatibility with other
22 
  systems.  \code{win.metafile} prints to a file and \code{win.print} to
 21 
  systems.  \code{win.metafile} prints to a file and \code{win.print} to
23 
  the Windows print system.
 22 
  the Windows print system.
Line 28... Line 27...
28 
        bg, canvas, gamma, xpos, ypos, buffered, title,
 27 
        bg, canvas, gamma, xpos, ypos, buffered, title,
29 
        restoreConsole, clickToConfirm, fillOddEven,
 28 
        restoreConsole, clickToConfirm, fillOddEven,
30 
        family, antialias)
 29 
        family, antialias)
31 
 
 30 
 
32 
win.graph(width, height, pointsize)
 31 
win.graph(width, height, pointsize)
33 
x11(width, height, pointsize, bg, gamma, xpos, ypos, title)
 - 
 
34 
X11(width, height, pointsize, bg, gamma, xpos, ypos, title)
 - 
 
35 
 
 32 
 
36 
win.metafile(filename = "", width = 7, height = 7, pointsize = 12,
 33 
win.metafile(filename = "", width = 7, height = 7, pointsize = 12,
37 
             family, restoreConsole = TRUE)
 34 
             family, restoreConsole = TRUE)
38 
 
 35 
 
39 
win.print(width = 7, height = 7, pointsize = 12, printer = "",
 36 
win.print(width = 7, height = 7, pointsize = 12, printer = "",
40 
          family, antialias, restoreConsole = TRUE)
 37 
          family, antialias, restoreConsole = TRUE)
41 
}
 38 
}
42 
 
 - 
 
43 
\arguments{
 39 
\arguments{
44 
  \item{width, height}{the (nominal) width and height of the canvas of
 40 
  \item{width, height}{the (nominal) width and height of the canvas of
45 
    the plotting window in inches.  Default \code{7}.}
 41 
    the plotting window in inches.  Default \code{7}.}
46 
  \item{pointsize}{the default pointsize of plotted text, interpreted as
 42 
  \item{pointsize}{the default pointsize of plotted text, interpreted as
47 
    big points (1/72 inch).  Values are rounded to the nearest integer:
 43 
    big points (1/72 inch).  Values are rounded to the nearest integer:
Line 99... Line 95...
99 
    over font antialiasing.  This is partially matched to
 95 
    over font antialiasing.  This is partially matched to
100 
    \code{"default"}, \code{"none"}, \code{"cleartype"} or
 96 
    \code{"default"}, \code{"none"}, \code{"cleartype"} or
101 
    \code{"gray"}.  See the \sQuote{Fonts} section.}
 97 
    \code{"gray"}.  See the \sQuote{Fonts} section.}
102 
}
 98 
}
103 
 
 99 
 
- 
 
 100 
\note{
- 
 
 101 
  \code{x11()}, \code{X11()} and \code{win.graph()} are simple wrappers
- 
 
 102 
  calling \code{windows()}, and mainly exist for compatibility reasons.
- 
 
 103 
 
- 
 
 104 
  Further, \code{\link{x11}()} and \code{X11()} have their own help page
- 
 
 105 
  for Unix-alikes (where they also have more arguments).
- 
 
 106 
}
104 
\details{
 107 
\details{
105 
  All these devices are implemented as variants of the same device.
 108 
  All these devices are implemented as variants of the same device.
106 
 
 109 
 
107 
  All arguments of \code{windows} have defaults set by
 110 
  All arguments of \code{windows} have defaults set by
108 
  \code{\link{windows.options}}: the defaults given in the arguments section
 111 
  \code{\link{windows.options}}: the defaults given in the arguments section
Line 246... Line 249...
246 
}
 249 
}
247 
 
 250 
 
248 
\seealso{
 251 
\seealso{
249 
  \code{\link{windowsFonts}},
 252 
  \code{\link{windowsFonts}},
250 
  \code{\link{savePlot}}, \code{\link{bringToTop}},
 253 
  \code{\link{savePlot}}, \code{\link{bringToTop}},
251 
  \code{\link{Devices}}, \code{\link{postscript}}
 254 
  \code{\link{Devices}}, \code{\link{postscript}},
- 
 
 255 
  \code{\link{x11}} for Unix-alikes.
252 
}
 256 
}
253 
\examples{\dontrun{## A series of plots written to a sequence of metafiles
 257 
\examples{\dontrun{## A series of plots written to a sequence of metafiles
- 
 
 258 
if(.Platform$OS.type == "windows")
254 
win.metafile("Rplot\%02d.wmf", pointsize = 10)
 259 
   win.metafile("Rplot\%02d.wmf", pointsize = 10)
255 
}}
 260 
}}
256 
\keyword{device}
 261 
\keyword{device}