Get information on subscenes

This function retrieves information about the tree of subscenes shown in the active window.

subsceneInfo(id = NA, embeddings, recursive = FALSE)

Arguments

id

Which subscene to report on; NA is the current subscene. Set to "root" for the root.

embeddings

Optional new setting for the embeddings for this subscene.

recursive

Whether to report on children recursively.

Details

In RGL, each window contains a tree of “subscenes”, each containing views of a subset of the objects defined in the window.

Rendering in each subscene depends on the viewport, the projection, and the model transformation. Each of these characteristics may be inherited from the parent (embedding[i] = "inherit"), may modify the parent (embedding[i] = "modify"), or may replace the parent (embedding[i] == "replace"). All three must be specified if embeddings is used.

Value

id

The object id of the subscene

parent

The object id of the parent subscene, if any

children

If recursive, a list of the information for the children, otherwise just their object ids.

embedding

A vector of 3 components describing how this subscene is embedded in its parent.

Author

Duncan Murdoch

See also

newSubscene3d

Examples

example(plot3d)
#> 
#> plot3d>   open3d()
#> glX 
#> 165 
#> 
#> plot3d>   x <- sort(rnorm(1000))
#> 
#> plot3d>   y <- rnorm(1000)
#> 
#> plot3d>   z <- rnorm(1000) + atan2(x, y)
#> 
#> plot3d>   plot3d(x, y, z, col = rainbow(1000))
subsceneInfo()
#> $id
#> [1] 3257
#> 
#> $embeddings
#>   viewport projection      model      mouse 
#>  "replace"  "replace"  "replace"  "replace" 
#>