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 in the
form of a single vrml file (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.