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

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