A function that produces a three-dimensional rendering of face
orientation on a surface. The OPC function will identify the
orientations of mesh faces and assign them to patches. It must be
performed prior to using the OPC3d function.
An object that stores the output of
the OPC function
binColors
Allows the user to change the colors filled in for
each directional bin
patchOutline
logical whether or not to outline the patches
outlineColor
parameter designating which color to outline the patches in
maskDiscard
logical indicating whether to discard the unused patches
legend
Logical indicating whether or not a legend should
be displayed
legendScale
cex style scaling factor for the legend
legendTextCol
parameter designating color for the legend text
legendLineCol
parameter designating the color for the legend lines
leftOffset
numeric parameters disginating how far to offset the surface
fieldofview
Passes an argument to par3d changing the
field of view in dregrees of the resulting rgl window
Details
This function will assign a uniform color to all faces on the mesh
surface that share one of the 8 orientations identified by the OPC function. The
function returns a colored shade3d of the mesh so that patches can be visually
inspected. Future versions will include the option to black out patches not
included in the orientation patch count.
Several legend plotting options are availble including customizing the line and
text colors using color names with legendTextCol and legendLineCol, both default
to black. legendScale works like cex for setting the size of the relative size
of the legend.
leftOffset will determine how far the plotted surface is moved to the left to
avoid obstructing the legend. Users shold choose between -1 and 1.
fieldofview is set to a default of 0, which is an isometric projection.
Increasing it alters the degree of parallax in the perspective view, up to a
maximum of 179 degrees.
colors will support any vector of 8 colors, in any coloration scheme. Default
draws from the hsv color space to evenly space color information, however user
can supply a list of RGB values, character strings, or integers in place.