Styling > Customizing Groups > Customizing the Group Information Cluster

All the structural and state information on a group--that is, its label, icon, plinth, secondary state modifiers, and alarm balloon--are gathered into what is called the information cluster of the group.

This cluster is positioned by placing a reference decoration at the center of the group. The reference decoration is listed below and is applied in the given order:

The center of the group is the center of the rectangle for a rectangular group, the gravity center for polygonal groups, and the midpoint of the middle segment for linear groups.

You can modify the default positioning of the group information cluster by setting its relative position as an offset.

When a transformer is applied to the group, that is, when it is moved or scaled, the same transformer is applied to the offset of the group information cluster. In other words, the cluster follows the group. This is true regardless of whether the cluster position was specified with absolute or relative coordinates.

However, when the shape of the group is changed or the group is moved, the transformation of the group shape is not guaranteed to be affine. As a result, this change in the group shape is likely to change the default position of the group information cluster. You can specify whether such a shape change will affect the cluster position or whether the cluster will keep the same absolute coordinates. The property pinDecorations determines whether the position of the group information cluster is considered relative to the default position and will thus change if the default value changes.

You can define the above characteristics using CSS, with the following properties:

Table 6.10 CSS Properties for the Group Information Cluster
Property Name 
Type  
Default Value 
Description 
decorationsOffset 
IlpPoint 
null 
Denotes the offset used to attach the group information cluster to the group base. 
decorationsOffsetZoomable 
boolean 
false 
Denotes whether the offset used to attach the group information cluster to the base can be zoomed or not. 
pinDecorations 
boolean 
false 
Denotes whether the group information cluster remains unchanged even if the group has its shape changed. 

The characteristics of the plinth decoration that is added to the group graphic representation can also be customized, using the following properties:

Table 6.11 CSS Properties for the Plinth Decoration
Property Name 
Type 
Set 
Default Value 
Description 
plinthColor 
Color 
Yes 
67% grey 
Denotes the color of the plinth. 
plinthBrightColor 
Color 
Yes 
87% grey 
Denotes the brighter color of the plinth. 
plinthDarkColor 
Color 
Yes 
33% grey 
Denotes the darker color of the plinth. 
plinthVisible 
boolean 
No 
true 
Denotes whether the plinth is visible or not. 
plinthVerticalMargin 
int 
No 
1 
Defines the vertical margin between the plinth and its contents. 
plinthHorizontalMargin 
int 
No 
4 
Defines the horizontal margin between the plinth and its contents.