Cluttering/Decluttering

This function makes sense if you want to show detailed parts of plants not till the right zoom factor passes a specific value. (i.e. if the panel is large enough). By default all layers are visible.

The function Cluttering/Decluttering in WinCC OA sets specific layers visible respectively invisible in a panel (see also module GEDI - The Layers Sheet) in addiction to the zoom factor. The configuration of this setting will be made in a panel, which can be reached via the button Cluttering settings on the Settings tab in the System management panel.

"Left-click" opens the following panel for configuring the visibility of specific layers:

For each layer you have the opportunity to choose one of three selections from the combo box:

• (Always) - Layer is always visible.
   

• (Never) - Layer is never visible.
   

• if factor in range - Layer is visible, while the actual zoom factor lies in a specific range. Following this range must be defined.

The button OK applies any changes and the (De)Cluttering settings are valid for all panels opened with the user interface under Windows or under Linux. Cancel closes the panel without saving any changes and the button Help opens the online help.

Panels in the version path are not affected by the Cluttering settings. You will find more information on the zoom factor in the chapter Zooming/Panning.

Cluttering settings are not only available via the (De)cluttering panel, but also with the CTRL function setClutteringLimits(). With this function you can define cluttering settings for individual panels in the Initialize script. Opening the panel executes this function, the central settings of the cluttering panel for cluttering/decluttering are ignored.

In order to reduce the opening times of large panels with many objects the initialization is executed in the

cluttering/decluttering as follows:

• When opening a panel only the objects, which are located within the display and on a visible layer, are displayed.

• The further panel area with its objects is built first at runtime via scrolling to left/right/up/down. The area is built having regard to the cluttering settings for the different layers.

• The "Initialize" scripts configured for different objects are executed first when the object is located within the display and on a visible layer.

Note

If an object is configured invisible (settings in the GEDI) although it is located on a visible layer an "Initialize" is likewise executed!

For compatibility reasons each panel contains  a further property "startInitScriptMode" in the GEDI. How the panel is handled at cluttering/decluttering is defined via this property. The following settings are possible:

1. All objects: all "Initialize" scripts are started when opening. Whether the object is located within the display or on a visible layer is not considered. Choose this option in order to consider all dependencies and references for older panels (for example, an event, which has an effect on other objects in the visible area of the panel, was configured on an object. The event has an effect on , for example, color, description etc...).
    

2. Visible objects: If this option is set the big panels are handled as described above. Choose this option for newly created panels or for panels when you know that no object with an "Initialize" script has an effect on another object.

Example