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

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