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

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