Creating network element types from images and customizing them

Create a new type of network element with the following code:

IltNetworkElement.Type myNewType =
          new IltNetworkElement.Type(YOUR_NEW_TYPE_NAME); 

Create the image corresponding to the base style Carrying Traffic without any alarm and instantiate an IltNEImageBaseRendererFactory using this image:

IltNEImageBaseRendererFactory factory = new 
IltNEImageBaseRendererFactory(image, YOUR_IMAGE_PARAMETERS); 

Map the factory with the new type using SetValue:

IltSettings.SetValue("NetworkElement.Type.YOUR_NEW_TYPE_NAME.Renderer",facto
ry); 

The first constructor has four arguments and enables you to customize the way the different representations are computed.

The first parameter is of type java.awt.Image . It is the original image used to compute all other representations.

The first and the second int are thresholds indicating which part of the original image should be considered as details and drawn in the dark color. The third int is the gray level that should be mapped to the normal alarm color.

The second constructor has the same parameters as the first one and an additional boolean parameter that indicates whether an additional dotted border should be drawn around the base.

The third constructor has only one argument, which is the java.awt.Image that should be used to compute the different representations of the new type. It calls the constructor with four arguments, with the image and 200 as the threshold for bright colors, 50 as the threshold for dark colors, and 128 as the gray level to be mapped to the normal alarm color.

Create a new type of network element

Using the API:

IltNetworkElement.Type myNewType = new 
IltNetworkElement.Type(YOUR_NEW_TYPE_NAME); 

or, using global CSS settings:

setting."ilog.tgo.model.IltNetworkElement" {
   types[0]: @+neType0;
}

Subobject#neType0 {
   class: 'ilog.tgo.model.IltNetworkElement.Type';
   name: YOUR_NEW_TYPE_NAME;
}

Map an IltNEDirectImageBaseRendererFactory to the new type

Using the API SetValue:

IltSettings.SetValue("NetworkElement.Type.YOUR_NEW_TYPE_NAME.Renderer", new 
IltNEDirectImageBaseRendererFactory()); 

or, using global CSS settings:

setting."ilog.tgo.model.IltNetworkElement.Type"[name=YOUR_NEW_TYPE_NAME] {
   renderer: @+neRendererFactory;
}

Subobject#neRendererFactory {
   class: 'ilog.tgo.graphic.renderer.IltNEDirectImageBaseRendererFactory';
}

Define an image and an alarm color or gray-level parameter in CSS for each required base style

object."ilog.tgo.model.IltNetworkElement"["type"=YOUR_NEW_TYPE_NAME]["object
State.Bellcore.State"=EnabledActive] {
  sourceImage: '@|image("newType_enabledActive.png")';
  alarmColorLevel: 128;
}
object."ilog.tgo.model.IltNetworkElement"["type"=YOUR_NEW_TYPE_NAME]["object
State.Bellcore.State"=DisabledActive] {
  sourceImage: '@|image("newType_disabledActive.png")';
  alarmColorLevel: 140;
}

Carrying Traffic with alarms: A color scale corresponding to the alarm color is applied to the original image. This color scale uses three colors: a bright alarm color, a normal alarm color, and a dark alarm color.

For example, for a major alarm JViews TGO uses the colors bright red, red, and dark red. The color scale is applied to the original image by first converting it to a normalized gray-scale image (that is, gray levels in the range 0..255). Then, the normalized gray-scale image is colored by mapping each gray level to a color level. The brighter gray is mapped to the bright alarm color, the darker gray is mapped to the dark alarm color, and the gray level corresponding to the third integer in the factory constructor is mapped to the normal alarm color (if this integer is not explicitly given, the default value used is 128). Any other gray level different from the brighter one, the darker one, or the one given in the factory constructor is mapped to the appropriate color in a continuous manner.

No Traffic (with or without alarms): The original image, which is supposed to be a relief image (according to the JViews TGO look-and-feel), is transformed to a flat image. The flat image is composed of only two colors: in the absence of alarms, one gray and one darker gray, otherwise one alarm color and one dark alarm color. Using only two colors ensures a flat visual aspect. To follow the JViews TGO look-and-feel, the whole object should be represented in the normal color with its border in the dark color, plus possibly some details of the inside of the object also in the dark color. For example, the figure shows that the border is in the dark color as well as the outline of the small screen and the receiver of the telephone. To indicate which details of the original image you want in the dark color and which you do not, you must use the first two integers of the factory constructor. The first integer indicates a threshold above which the bright colors of the original image should be considered as details and drawn in the dark color; if this integer is not explicitly given, the default value used will be 200. For example, Sample Dark and Light Colors shows examples where the threshold assumed is 200 (in the range 0..255). In this way, the left border of the receiver and the lower right border of the screen are drawn in the dark color. The second integer is a threshold indicating which of the dark colors of the original image should be considered as details and also drawn in the dark color; if this integer is not explicitly provided, the default value will be 50. For example, in Sample Dark and Light Colors we indicate that this threshold is 11 (in the range 0..255). This causes the lower right border of the receiver and the upper left border of the screen to be drawn in the dark color.

Out of Service and Not Installed (with or without alarms): According to the Rogue Wave® JViews TGO look-and-feel, the object should be represented with only two colors, a dashed border and a pattern inside, but no other details. JViews TGO uses the transparency, if any, to determine the border of the image. When there is no transparency, the rectangle of the image is considered to be the border. Then, the interior is filled with the appropriate pattern and the border is drawn as a dashed line. JViews TGO does not need any extra parameters (threshold or gray level as mentioned above) to compute these representations correctly.