screen                 package:base                 R Documentation

_C_r_e_a_t_i_n_g _a_n_d _C_o_n_t_r_o_l_l_i_n_g _M_u_l_t_i_p_l_e _S_c_r_e_e_n_s _o_n _a _S_i_n_g_l_e _D_e_v_i_c_e

_D_e_s_c_r_i_p_t_i_o_n:

     `split.screen' defines a number of regions within the current
     device which can, to some extent, be treated as separate graphics
     devices.  It is useful for generating multiple plots on a single
     device.  Screens can themselves be split, allowing for quite
     complex arrangements of plots.

     `screen' is used to select which screen to draw in.

     `erase.screen' is used to clear a single screen.

     `close.screen' removes the specified screen definition(s).

_U_s_a_g_e:

     split.screen(figs, screen = <<see below>>, erase = TRUE)
     screen(n = <<see below>>, new = TRUE)
     erase.screen(n = <<see below>>)
     close.screen(n = <<see below>>, all = TRUE)

_A_r_g_u_m_e_n_t_s:

    figs: A two-element vector describing the number of rows and the
          number of columns in a screen matrix or a matrix with 4
          columns. If a matrix, then each row describes a screen with
          values for the left, right, bottom, and top of the screen (in
          that order) in NDC units.

       n: A number indicating which screen to prepare for drawing
          (`screen'), erase (`erase.screen'), or close
          (`close.screen').

     new: A logical value indicating whether the screen should be
          erased as part of the preparation for drawing in the screen.

     all: A logical value indicating whether all of the screens should
          be closed.

_D_e_t_a_i_l_s:

     The first call to `split.screen' places R into split-screen mode. 
     The other split-screen functions only work within this mode. While
     in this mode, certain other commands should be avoided (see
     WARNINGS below).  Split-screen mode is exited by the command 
     `close.screen(all = TRUE)'

_V_a_l_u_e:

     `split.screen' returns a vector of screen numbers for the
     newly-created screens.  With no arguments, `split.screen' returns
     a vector of valid screen numbers.

     `screen' invisibly returns the number of the selected screen. With
     no arguments, `screen' returns the number of the current screen.

     `close.screen' returns a vector of valid screen numbers.

     `screen', `erase.screen', and `close.screen' all return `FALSE' if
     R is not in split-screen mode.

_W_a_r_n_i_n_g:

     These functions are totally incompatible with the other mechanisms
     for arranging plots on a device:  `par(mfrow)', `par(mfcol)', and
     `layout()'.  

     The functions are also incompatible with some plotting functions, 
     such as `coplot', which make use of these other mechanisms.

     The functions should not be used with multiple devices.

_S_e_e _A_l_s_o:

     `par', `layout', `Devices', `dev.*'

_E_x_a_m_p_l_e_s:

     if (interactive()) {
     split.screen(c(2,1))             # split display into two screens
     split.screen(c(1,3), screen = 2) # now split the bottom half into 3
     screen(1) # prepare screen 1 for output
     plot(10:1)
     screen(4) # prepare screen 4 for output
     plot(10:1)
     close.screen(all = T) # exit split-screen mode

     split.screen(c(2,1))        # split display into two screens
     split.screen(c(1,2),2)      # split bottom half in two
     plot(1:10)                  # screen 3 is active, draw plot
     erase.screen()              #forgot label, erase and redraw
     plot(1:10, ylab= "ylab 3")
     screen(1)                 # prepare screen 1 for output
     plot(1:10)
     screen(4)                 # prepare screen 4 for output
     plot(1:10, ylab="ylab 4")
     screen(1, F)              #return to screen 1, but do not clear
     plot(10:1, axes=F, lty=2, ylab="")  # overlay second plot
     axis(4)                   # add tic marks to right-hand axis
     title("Plot 1")
     close.screen(all = T) # exit split-screen mode
     }

