viewpoint {rgl}R Documentation

Set up viewpoint

Description

Set the viewpoint orientation.

Usage

view3d( theta = 0, phi = 15, ...)
rgl.viewpoint( theta = 0, phi = 15, fov = 60, zoom = 1, scale = par3d("scale"), 
               interactive = TRUE, userMatrix )

Arguments

theta,phi

polar coordinates

...

additional parameters to pass to rgl.viewpoint

fov

field-of-view angle in degrees

zoom

zoom factor

scale

real length 3 vector specifying the rescaling to apply to each axis

interactive

logical, specifying if interactive navigation is allowed

userMatrix

4x4 matrix specifying user point of view

Details

The viewpoint can be set in an orbit around the data model, using the polar coordinates theta and phi. Alternatively, it can be set in a completely general way using the 4x4 matrix userMatrix. If userMatrix is specified, theta and phi are ignored.

The pointing device of your graphics user-interface can also be used to set the viewpoint interactively. With the pointing device the buttons are by default set as follows:

left

adjust viewpoint position

middle

adjust field of view angle

right or wheel

adjust zoom factor

If the fov angle is set to 0, a parallel or orthogonal projection is used. Small non-zero values (e.g. 0.01 or less, but not 0.0) are likely to lead to rendering errors due to OpenGL limitations.

See Also

par3d

Examples

## Not run: 
# animated round trip tour for 10 seconds

rgl.open()
shade3d(oh3d(), color="red")

start <- proc.time()[3]
while ((i <- 36*(proc.time()[3]-start)) < 360) {
  rgl.viewpoint(i,i/4); 
}

## End(Not run)

[Package rgl version 0.92.798 Index]