GUI to control plotting of display structure elements
mlayers will be removed in a future release.
Session > Layers
mlayers('filename') associates all display structures, which in
this context are also called map layers, in the MAT-file
with the current map axes. The display structure variables are accessible only through
mlayers tool, and not through the base workspace.
filename must be a character vector.
mlayers('filename',h) assigns the layers found in
filename to the map axes indicated by the handle
mlayers(cellarray) associates the layers specified by
cellarray with the current map axes.
must be of size n by 2. Each row of
cellarray represents a map layer.
The first column of
cellarray contains the layer structure, and the
second column contains the name of the layer structure. Such a cell array can be
generated from data in the current workspace with the function
rootlayr. In this case, the calling sequence would be
mlayers(cellarray,h) assigns the layers specified by
cellarray to the map axes specified by the handle
The scrollable list box displays all of the map layers currently associated with the
map axes. An asterisk next to the layer name indicates that the layer is currently
h next to the layer name indicates a layer that is
plotted, but currently hidden.
The Plot button plots the selected map layer. Once
the selected layer is plotted, the button toggles between Hide and Show, to turn the
Visible property of the plotted objects to
The Zdata button activates the Specify Zdata dialog
box, which is used to enter the workspace variable containing the
ZData for the selected map layer. Pressing the List button produces a list of all current workspace
variables, from which the
ZData variable can be selected. This entry
can also be a scalar.
The Highlight button is used to toggle the selected map layer between highlighted and normal display.
The Members button brings up a list of members of the
selected map layer. Members of a layer are defined by their
The Delete button deletes the selected map layer from the map.
The Property button activates the Define Layer Properties dialog box, which is used to specify or change properties of all objects in the selected map layer. Character vector entries must be enclosed in single quotes.
The Purge button deletes the selected map layer from the
mlayers tool. Selecting Yes from
the Confirm Purge dialog box deletes the map layer from both the
mlayers tool and the map display. Selecting Data Only from the Confirm Purge dialog box deletes the map layer from
mlayers tool, while retaining the plotted object on the map