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

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