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

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