Main Content

show

Display 3-D signed distance map

Since R2024b

collapse all in page

    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

    collapse all

    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 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.

    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 for the voxel distance values, specified as either "on" or "off". For more information about colorbars, see ColorBar Properties.

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

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

    Output Arguments

    collapse all

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

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

    Version History

    Introduced in R2024b

    See Also

    | | | |