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.
OPC3d(
OPC_Output_Object,
binColors = hsv(h = (seq(10, 290, 40)/360), s = 0.9, v = 0.85),
patchOutline = FALSE,
outlineColor = "black",
maskDiscard = FALSE,
legend = TRUE,
legendScale = 1,
legendTextCol = "black",
legendLineCol = "black",
leftOffset = 1,
fieldofview = 0,
fileName = NA,
binary = FALSE
)An object that stores the output of the OPC function
Allows the user to define the fill colors for each directional bin
Logical whether or not to outline the patches
Parameter defining the patch outline color
Logical indicating whether or not to mask (in black) the patches excluded from the OPC value
Logical indicating whether or not a legend should be displayed
numeric value setting the relative size of the legend, similar in function to cex
Parameter defining color for the legend text
Parameter defining the color for the legend lines
numeric value between -1 and 1 setting the degree of offset for the plotted surface to the left; larger values set further to left while 0 is centered
Passes an argument to par3d changing the field of view in degrees of the resulting surface plot
String indicating a name to save the plotted surface to as a *.ply file; default of 'NA' will not save a file
Logical indicating whether or not the saved surface plot should be binary, passed to vcgPlyWrite
This function will assign a uniform color to all faces on the mesh surface that share one of the orientation bins identified by the OPC function. The function returns a colored mesh so that patches can be visually inspected.
binColors will support any vector of colors, in any coloration scheme. Default draws from the HSV color space to evenly space color information, however the user can supply a list of RGB values or character strings in place. If there are fewer colors than directional bins, remaining bins will default to white.
Several legend plotting options are availble, including customizing the line and text colors with legendTextCol and legendLineCol, which both default to black.
The leftOffset value sets how far to the left the surface will appear, intended to help avoid overlap with the legend. A value of 0 for this argument will center the surface in the plotting window and negative values will shift it to the right.
legendScale sets the relative size of the legend, analogous to the cex argument of par graphics.
fieldofview is set to a default of 0, which is an isometric parallel projection. Raising it corresondingly increases the amount of obliquity used to render the surface in the plotting window, up to a maximum of 179 degrees.
The plotted, colorized surface can be saved as a *.ply to the working directory by changing the fileName argument from NA to a string (e.g., "OPCPlot"). The resultant ply file can be opened and manipulated in other 3D visualizing programs, such as MeshLab, but will NOT retain its legend (a background of the plotting window). To retain the legend, the user is encouraged to utilize the snapshot3d function. Patch outlines are currently not retained with surface saving. The binary argument saves a file in ascii format by default, which is supported by more 3D visualization software than is binary. However, binary files will be considerably smaller.
# NOT RUN {
OPC_output <- OPC(Tooth)
OPC3d(OPC_output)
# }
Run the code above in your browser using DataLab