VIEWLC/['view name']{,RESET|[,VSBL{,REST|[,layer list][,CAT,cat list]}][,INVSBL{,REST|[,layer list][,CAT,cat list]}]}[,IFERR,label:]
Allows you to define an individual layer visibility mask for a view or to reset the layer visibility mask for the view to the global layer visibility mask.
The individual layer visibility mask is set using the minor words VSBL and INVSBL. VSBL sets any specified layers or categories visible. INVSBL sets any specified layers or categories invisible.
When you use one of these minor words, you can either specify a list of layers and/or categories, or use the minor word REST. REST indicates that the status of all layers and categories not specified assumes the status of the preceding minor word. The visibility status of layers and categories not specified either in a list or by REST remains unchanged.
If you want to save the layer visibility status for an active view so that the view may be retrieved with that visibility status, you must save the view.
The minor word RESET allows you to reset the layer visibility mask for the view back to the global layer visibility mask. If you use RESET, the view no longer has an individual layer visibility mask.
You can set the global layer visibility mask in one of two ways: by setting options 2 and 3 of the Layer Control menu in Unigraphics, or by using the GRIP LAYER statement described earlier in this section.
You can also verify/change layer visibility in a view with the EDA &LYRVVW. For more information on these EDAs, see the EDA Symbol List.
Parameter |
Description |
'view name' |
An optional name of the view whose visibility status you wish to change. If not specified, the system defaults to the work view. Note that the view name that corresponds to a drawing is the drawing name with an "@0" appended to it. |
RESET |
Minor word which resets the layer visibility mask for the view to the global layer visibility mask. |
VSBL |
Minor word which makes the specified layers visible in the view. |
INVSBL |
Minor word which makes the specified layers invisible in the view. |
layer list |
A list of layer numbers. |
REST |
Minor word which indicates that the status of all layers and categories not specified assumes the status of the preceding minor word (VSBL or INVSBL). REST can be specified only once in each statement. |
CAT |
Minor word which indicates that an existing category name is to be specified. |
cat list |
A list of categories. |
IFERR,LABEL: |
A label to which program execution jumps if an error occurs. Errors can include an invalid layer number or view name, or an undefined category or view. |
Several examples of setting and resetting view layer visibility masks are shown in the following table.
Statement |
Result |
VIEWLC/'TOP',VSBL,10..20 |
Layers 10 through 20 are visible in the 'TOP' view. The status of the other layers remains unchanged. |
VIEWLC/VSBL,100,INVSBL,10,18 |
In the work view, layer 100 is visible, while layers 10 and 18 are set invisible. The status of all other layers remains unchanged. |
VIEWLC/'TFR-ISO',VSBL,25, |
In the 'TFR-ISO' view, layer 25 is set to visible and all other layers are set to invisible. |
VIEWLC/RESET |
The work view layer visibility mask is reset to the global layer visibility mask. |