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

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