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

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