panel_new: Start plotting on the new image panel

In nplatonov/ursa: Non-Interactive Spatial Tools for Raster Processing and Visualization

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)

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.

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(...).

Value

Function returns NULL value.

Author(s)

Nikita Platonov [e-mail]

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))

nplatonov/ursa documentation built on May 8, 2024, 6:02 p.m.