Get information about attributes of objects

These functions give information about the attributes of RGL objects. rgl.attrib.info is the more “user-friendly” function; rgl.attrib.count is a lower-level function more likely to be used in programming.

Usage

rgl.attrib.info(id = ids3d("all", 0)$id, attribs = NULL, showAll = FALSE)
rgl.attrib.count(id, attrib)

Arguments

id: One or more RGL object ids.
attribs: A character vector of one or more attribute names.
showAll: Should attributes with zero entries be shown?
attrib: A single attribute name.

Details

See the first example below to get the full list of attribute names.

Value

A dataframe containing the following columns:

id: The id of the object.
attrib: The full name of the attribute.
nrow, ncol: The size of matrix that would be returned by rgl.attrib for this attribute.

Author

Duncan Murdoch

Examples

open3d()
id <- points3d(rnorm(100), rnorm(100), rnorm(100), col = "green")
rgl.attrib.info(id, showAll = TRUE)
#>      id     attrib nrow ncol
#> 1  1640   vertices  100    3
#> 2  1640    normals    0    3
#> 3  1640     colors    1    4
#> 4  1640  texcoords    0    2
#> 5  1640        dim    0    2
#> 6  1640      texts    0    1
#> 7  1640        cex    0    1
#> 8  1640        adj    0    3
#> 9  1640      radii    0    1
#> 10 1640    centers  100    3
#> 11 1640        ids    0    1
#> 12 1640 usermatrix    0    4
#> 13 1640      types    0    1
#> 14 1640      flags    1    1
#> 15 1640    offsets    0    1
#> 16 1640     family    0    1
#> 17 1640       font    0    1
#> 18 1640        pos    0    1
#> 19 1640   fogscale    0    1
#> 20 1640       axes    0    3
#> 21 1640    indices    0    1
#> 22 1640   shapenum    0    1
rgl.attrib.count(id, "vertices")
#> [1] 100

merge(rgl.attrib.info(), ids3d("all"))
#>      id   attrib nrow ncol       type
#> 1  1637   colors    3    4      light
#> 2  1637    flags    2    1      light
#> 3  1637 vertices    1    3      light
#> 4  1639    flags    4    1 background
#> 5  1639 fogscale    1    1 background
#> 6  1639   colors    1    4 background
#> 7  1639  centers    1    3 background
#> 8  1640   colors    1    4     points
#> 9  1640  centers  100    3     points
#> 10 1640 vertices  100    3     points
#> 11 1640    flags    1    1     points