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

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