ursa (version 3.11.2)

panel_new: Start plotting on the new image panel

Description

panel_new finishes plotting on previuos image panel and starts plotting on next image panel.

Usage

panel_new(...)
# non-public
.panel_new(col = "chessboard", alpha = NA, density = NA, angle = NA,
           lwd = 1, lty = 1, asp = NA, mar = rep(0, 4), grid = NULL, verbose = FALSE)

Value

Function returns NULL value.

Arguments

...

Set of arguments, which are recognized via their names (using regular expressions) and classes. Passed to non-public .panel_new. Optional prefix "blank" is used for indirect use. Separated by a dot ".", e.g., blank.fill="transparent".

Pattern (panel_new)	Argument (.panel_new)	Description
(blank\\.)*(^$|bg|fill)	col	See below. Keyword "chessboard" is used by default to produce original background texture. However argument col has other default value.
(blank\\.)*aphpa	alpha	See below.
(blank\\.)*density	density	See below.
(blank\\.)*angle	angle	See below.
(blank\\.)*lwd	lwd	See below.
(blank\\.)*lty	lty	See below.
(blank\\.)*asp	asp	See below.
(blank\\.)*mar	mar	See below.
(blank\\.)*grid	grid	See below.
(blank\\.)*verb(ose)*	verbose	See below.

col

Character. Color code/name for panel filling/shadowing. Default is "chessboard" (lightened background for controlling transparency) for georeferenced images, and "grey90" for non-projected images.

alpha

Numeric, 0 <= alpha <= 1. Level of transparency. Default is 1, without transparency.

density

Numeric. The density of shading lines for fill/shadowing. If NA then no shading lines are drawn. Default is NA. See density in rect.

angle

Numeric. The slope of shading lines, given as an angle in degrees (counter-clockwise). If NA then no shading lines are drawn. Default is NA. See angle in rect.

lwd

Positive numeric. Width of coastline. Default is 1. See lwd in rect.

lty

Character or positive integer. Type (pattern) of coastline. Default is 1L (solid). See lty in rect.

asp

Positive numeric. The y/x aspect ration. Default is 1. See asp in plot.window.

mar

Positive numeric of length 4. Plot margins. Default is rep(0,4L). See mar in par.

grid

Object of class ursaGrid or converted to it, to define spatial extent and projection for this panel. Default is NULL, which repeats previous state.

verbose

Logical. Value TRUE may provide some additional information on console. Default is FALSE.

Author

Nikita Platonov

Details

Prefix blank is introduced for manipulations with panel_new inside of high-level functions (e.g., display). Prefix skipping is the subject for confict with functions, which use the same name of arguments.

It is required to call panel_new for every image panel. First calling starts plotting on the first panel. Second and next callings change image panels.

The panel sequence is set in function compose_design, which is called directly or indirectly from compose_open, and keeps in the options (access via getOption("ursaPngLayout")$layout).

Image background is formed via consecutive call of functions plot(...,type="n"), and rect(...).

Examples

session_grid(NULL)
# example no.1 -- direct use
compose_open(layout=c(1,3),legend=NULL)
panel_new()
panel_annotation(label="Default + Empty")
panel_new(col="#0000FF3F",density=15,angle=45,lwd=3)
panel_decor()
panel_annotation(label="Settings + Grid")
panel_new("#FFFF0040",grid=regrid(expand=0.5))
panel_decor()
panel_annotation(label="Another spatial extent")
compose_close()

# example no.2 -- indirect use
a <- pixelsize()
a <- a[a>560]
display(a,blank.col="#0000FF3F",blank.density=15,blank.angle=45,blank.lwd=3
       ,coast.fill="#007F005F",coast.density=20,coast.angle=c(-30,60))