Hilite.Settings Class

Describes how the hilite effect is applied to elements within a Viewport. The hilite effect is applied to elements contained in the IModelConnection's SelectionSet. It is designed to draw attention to those elements. The effect is produced as follows:

  1. All hilited elements are drawn as normal, except that their element color is mixed with the hilite color.
  2. The union of the regions of the screen corresponding to hilited elements is computed.
  3. A silhouette is drawn using the hilite color around the boundaries of the hilited region. This silhouette is visible behind other geometry.
  4. The hilite color is mixed with the color of each pixel within the hilited region. This enables surfaces of hilited geometry to be visible behind other geometry.

The Settings allow an application to customize how this effect is applied.

@see Viewport.hilite

Methods

Name Description
constructor(color: ColorDef = ..., visibleRatio: number = 0.25, hiddenRatio: number = 0.0, silhouette: Hilite.Silhouette = Silhouette.Thin): Hilite.Settings    

Properties

Name Type Description
color Readonly ColorDef The color that is used to draw the outline and which is mixed with element color.  
hiddenRatio Readonly number The ratio of hilite color to screen color used when drawing the hilited region overtop of the screen contents, in the range [0, 1].  
silhouette Hilite.Silhouette The type of outline to be drawn around the boundaries of the hilited region.  
visibleRatio Readonly number The ratio of hilite color to element color used when drawing unobscured portions of hilited geometry, in the range [0, 1].  

Defined in

Last Updated: 29 March, 2024