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

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