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

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