Slope3d: Plot results of a Slope analysis of a surface (HTML widget)

In molaR: Dental Surface Complexity Measurement Tools

Plot results of a Slope analysis of a surface (HTML widget)

Description

A function that produces a three-dimensional HTML-based rendering of surface slope. The Slope() function must be performed prior to using Slope3d().

Usage

Slope3d(
  Slope_File,
  colors = c("blue", "cornflowerblue", "green", "yellowgreen", "yellow", "orangered",
    "red"),
  maskNegatives = TRUE,
  legend = TRUE,
  main = "",
  cex = 1,
  widget_size_px = 768,
  scene_zoom = 1.5,
  leftOffset = 0,
  fieldofview = 0,
  title_font_size_px = 30,
  legend_magnify = 1,
  fileName = NA,
  binary = FALSE
)

Arguments

Slope_File	An object that stores the output of the Slope function
colors	Character vector of colors to build a continuous color gradient
maskNegatives	Logical; if TRUE, negative slopes are masked in black. If FALSE, negatives are reflected into the positive range (original behavior).
legend	Logical; draw a legend (right side of the widget)
main	Plot title
cex	Base scaling for legend/ticks (relative multiplier)
widget_size_px	Square widget size in pixels (default 768)
scene_zoom	Initial zoom for the 3d scene (default 1.5)
leftOffset	Horizontal camera nudge (-1..1 recommended)
fieldofview	Field of view in degrees (0 = isometric)
title_font_size_px	Title font size in pixels (default 30)
legend_magnify	Additional scale factor for the legend/tick text
fileName	Optional file base name to save a colored *.ply (no legend)
binary	Binary PLY if TRUE (smaller files)

Details

Colors represent face slope magnitudes. With maskNegatives = TRUE, negative slopes are shown in black. With maskNegatives = FALSE, negative magnitudes are reflected into the positive range for coloring continuity (original behavior).

The plotting window is an HTML widget (no Quartz/rgl window). The legend is rendered in HTML/CSS and aligned vertically at the right of the scene.

Examples

s <- Slope(Tooth)
if(interactive()){Slope3d(s)}

molaR documentation built on Nov. 8, 2025, 9:06 a.m.