The manager allows you to highlight objects
when the pointer hovers on top of them.
To display highlighted objects within a
manager, the manager creates specific images that are drawn on top
of the selected objects as a highlighting effect. By default, hover
highlighting is not enabled. If you want to activate it, you need
first to decide what highlighting effect you want to use.
The images used as highlighting effects are transient Java 2D™ artifacts, they are internally managed
and cannot be manipulated.
Each effect is applied through a Java 2D
image operation on the regular object representation, and then
displayed on top of all the objects with a set opacity.
The manager provides 5 predefined effects:
- Invert colors: This changes the intensity of each color component (red, green, blue). For example, a red object will be highlighted with a yellow color.
- Blur: The highlighted object becomes blurred.
- Brighten: Every color used when drawing the object becomes brighter. This may have no effect on objects that are already very bright.
- Gray scale: The colors of the object are converted into tones of grays.
- Sharpen: the borders of the object are accentuated.
- None: to remove the hover highlight effect.
A sixth effect (Custom) is detailed in Creating your own highlighting effect.
To select your hover highlight effect, call setHoverHighlightingMode.
Note
- The hover highlighting effect will only be used when set on a top-level manager (See Nested managers and nested graphers for more information on nested managers).
- The hover highlighting mode and the operation - see Creating your own highlighting effect are not persistent. This means that the information is not stored in .ivl files.