rgl.useNULL: Report default use of null device

Description Usage Value Note Author(s) See Also Examples

View source: R/device.R


This function checks the "rgl.useNULL" option if present, or the RGL_USE_NULL environment variable if it is not. If the value is TRUE or a string which matches “yes” or “true” in a case-insensitive test, TRUE is returned.




A logical value indicating the current default for use of the null device.


This function is checked by the initialization code when the rgl package is loaded. Thus if you want to run RGL on a system where there is no graphics support, you should run options(rgl.useNULL = TRUE) or set the environment variable RGL_USE_NULL=TRUE *before* calling library(rgl) (or other code that loads rgl), and it will not fail in its attempt at initialization.


Duncan Murdoch

See Also

open3d and rgl.open.



Example output

Warning messages:
1: In rgl.init(initValue, onlyNULL) : RGL: unable to open X11 display
2: 'rgl.init' failed, running with 'rgl.useNULL = TRUE'. 
[1] TRUE

rgl documentation built on Aug. 21, 2021, 5:08 p.m.