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.

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

See also

rgl.attrib to obtain the attribute values.

Examples

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

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