bg: Set up Background

Description Usage Arguments Details Note See Also Examples

Description

Set up the background of the scene.

Usage

1
2
3
bg3d(...) 
rgl.bg( sphere = FALSE, fogtype = "none", color = c("black", "white"), 
	back = "lines", ...)

Arguments

fogtype

fog type:

"none"

no fog

"linear"

linear fog function

"exp"

exponential fog function

"exp2"

squared exponential fog function

sphere

logical, if true, an environmental sphere geometry is used for the background decoration.

color

Primary color is used for background clearing and as fog color. Secondary color is used for background sphere geometry. See material3d for details.

back

Specifies the fill style of the sphere geometry. See material3d for details.

...

Material properties. See material3d for details.

Details

If sphere is set to TRUE, an environmental sphere enclosing the whole scene is drawn.

If not, but the material properties include a bitmap as a texture, the bitmap is drawn in the background of the scene. (The bitmap colors modify the general color setting.)

If neither a sphere nor a bitmap background is drawn, the background is filled with a solid color.

Note

The writeWebGL function only supports solid color backgrounds.

See Also

material3d, bgplot3d to add a 2D plot as background.

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
  open3d()
  
  # a simple white background
  
  bg3d("white")

  # the holo-globe (inspired by star trek):

  bg3d(sphere = TRUE, color = c("black", "green"), lit = FALSE, back = "lines" )

  # an environmental sphere with a nice texture.

  bg3d(sphere = TRUE, texture = system.file("textures/sunsleep.png", package = "rgl"), 
         back = "filled" )
         
  # The same texture as a fixed background
  
  open3d()
  bg3d(texture = system.file("textures/sunsleep.png", package = "rgl"), col = "white")

trestletech/rgl documentation built on May 31, 2019, 7:49 p.m.