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

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