read.vrml: Read landmark data from vrml files
Description
Read vrml files (Virtual Reality Modeling Language) to
obtain landmark coordinates and triangulationsUsage
read.vrml(file, plotspec = TRUE, plottri = TRUE, write.nts = FALSE)
Arguments
file
A .vrml file with coordinates in a
"centralized" format, or in "stitched" format. File names
can be written in manually, including paths, or obtained
using directory/file manipulation functions e.g.,
li plotspec
Logical should object be plotted.
Defaults to TRUE.
plottri
Logical should triangles be plotted.
Defaults to TRUE.
write.nts
Logical should .nts file be created.
Defaults to FALSE.
Value
- Function returns a list with the following components:
- coordsThe x,y,z coordinates of the .vrml surface
- trianglesTriangle facet connections between
coordinate points (if available)
Details
This function reads three-dimensional surface data from
simple vrml files (Virtual Reality Modeling Language). The
landmarks of this surface may then be used to digitize
three-dimensional points, and semilandmarks on curves and
surfaces. .vrml files are stored either as centralized
data, where 3D scanned object information (i.e.,
coordinates, triangles, color, and surface) are stored
within single data blocks for the complete object. This
version of read.vrml will import .wrl files written in
"utf8" and "ascii" format. Mesh triangle facets will be
imported if present as coordinate connections. Argument
plotspec allows users to plot file. This is helpful to help
inspect object for potential errors. Argument plottri plots
triangle facets if present. write.nts provides users with
the option of writing a .nts coordinate file.
NOTE: At present, only simple vrml files containing
vertices and faces is supported.