rgl.bbox {rgl}R Documentation

setup Bounding Box decoration

Description

Setup the bounding box decoration.

Usage

rgl.bbox( 
  xat=NULL, xlab=NULL, xunit=0, xlen=5, 
  yat=NULL, ylab=NULL, yunit=0, ylen=5,
  zat=NULL, zlab=NULL, zunit=0, zlen=5,
  marklen=15.0, marklen.rel=TRUE, expand=1, ...)
bbox3d(xat, yat, zat, expand=1.03, ...)  

Arguments

xat,yat,zat vector specifying the tickmark positions
xlab,ylab,zlab character vector specifying the tickmark labeling
xunit,yunit,zunit value specifying the tick mark base for uniform tick mark layout
xlen,ylen,zlen value specifying the number of tickmarks
marklen value specifying the length of the tickmarks
marklen.rel logical, if TRUE tick mark length is calculated using 1/marklen * axis length, otherwise tick mark length is marklen in coordinate space
expand value specifying how much to expand the bounding box around the data
... Material properties (or other rgl.bbox parameters in the case of bbox3d). See rgl.material for details.

Details

Three different types of tick mark layouts are possible. If at is not NULL, the ticks are setup at custom positions. If unit is not zero, it defines the tick mark base. If length is not zero, it specifies the number of ticks that are automatically specified. The first colour specifies the bounding box, while the second one specifies the tick mark and font colour.

bbox3d defaults to pretty locations for the axis labels and a slightly larger box, whereas rgl.bbox covers the exact range.

axes3d offers more flexibility in the specification of the axes, but they are static, unlike those drawn by rgl.bbox and bbox3d.

See Also

rgl.material, \code{axes3d}

Examples

  rgl.open()
  rgl.points(rnorm(100), rnorm(100), rnorm(100))
  rgl.bbox(color=c("#333377","white"), emission="#333377", specular="#3333FF", shininess=5, alpha=0.8 )
  
  open3d()
  points3d(rnorm(100), rnorm(100), rnorm(100))
  bbox3d(color=c("#333377","white"), emission="#333377", specular="#3333FF", shininess=5, alpha=0.8)

[Package rgl version 0.67 Index]