show

Display 3-D signed distance map

Since R2024b

Syntax

show(sdm3D)

show(sdm3D,Name=Value)

[h,hBar] = show(___)

Description

show(sdm3D) displays all active voxels of the 3-D signed distance map as a 3-D scatter plot.

show(sdm3D,Name=Value) specifies options using one or more name-value arguments. For example, IsoRange=[-2 2] specifies to plot only voxels with a distance value from -2 to 2.

[h,hBar] = show(___) returns the scatter plot and color bar handles using any combination of input arguments from previous syntaxes.

Input Arguments

sdm3D — 3-D signed distance map

signedDistanceMap3D object

3-D signed distance map, specified as a signedDistanceMap3D object.

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Example: show(sdm,IsoRange=[-2 2]) plots active voxels containing distance values from -2 to 2.

Parent — Parent axes

gca (default) | Axes object

Parent axes, specified as an Axes object. This argument specifies the axes in which to plot the active voxels of sdm3D. By default, the function plots the active voxels in the active axes. See Axes Properties for more information.

IsoRange — Range of distance values to plot

[-inf inf] (default) | two-element vector

Range of distance values to plot, specified as a two-element vector in the form [MinDistVal MaxDistVal]. The function plots only active voxels with distance values in the range [MinDistVal, MaxDistVal]. The value of MaxDistVal must be greater than the value of MinDistVal.

Example: show(sdm,IsoRange=[-2 2]) plots active voxels containing distance values between -2 and 2.

Colorbar — Colorbar for voxel distance values

"on" (default) | "off"

Colorbar for the voxel distance values, specified as either "on" or "off". For more information about colorbars, see ColorBar Properties.

Example: show(sdm,Colorbar="off")

FastUpdate — Fast updates to existing plot

0 (false) (default) | 1 (true)

Fast updates to existing plot, specified as a logical 0 (false) or 1 (true).

Output Arguments

h — 3-D scatter plot of active voxels

Scatter object handle

3-D scatter plot of active voxels, returned as a Scatter object handle. See Scatter Properties for more details.

hBar — Distance value color bar

ColorBar object handle

Distance value color bar, returned as a ColorBar object handle. See colorbar for more details.

Version History

Introduced in R2024b