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  1648   vertices  100    3
#> 2  1648    normals    0    3
#> 3  1648     colors    1    4
#> 4  1648  texcoords    0    2
#> 5  1648        dim    0    2
#> 6  1648      texts    0    1
#> 7  1648        cex    0    1
#> 8  1648        adj    0    3
#> 9  1648      radii    0    1
#> 10 1648    centers  100    3
#> 11 1648        ids    0    1
#> 12 1648 usermatrix    0    4
#> 13 1648      types    0    1
#> 14 1648      flags    1    1
#> 15 1648    offsets    0    1
#> 16 1648     family    0    1
#> 17 1648       font    0    1
#> 18 1648        pos    0    1
#> 19 1648   fogscale    0    1
#> 20 1648       axes    0    3
#> 21 1648    indices    0    1
#> 22 1648   shapenum    0    1
rgl.attrib.count(id, "vertices")
#> [1] 100

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