Class SoOutlineEffect

All Implemented Interfaces:
SafeDisposable

public class SoOutlineEffect extends SoNode
(Preview Feature).

Preview Feature means this class is fully supported and can be used in Open Inventor applications. Being tagged as a Preview Feature just means that the implementation is still subject to API changes and adjustments based on feedback from early adopters. Please be also aware that source compatibility might be broken regardless of the Open Inventor compatibility changes policy due to our commitment to bring needed changes to be sure the specifications of this Preview Feature match the expectations of our customers.

Apply an outline effect (the suggestive contours of shapes) to the entire scene, without considering shapes present in the SoAnnotation nodes. All opaque objects are compatible with the different transparency modes. For semi-transparent objects, SoOutlineEffect only supports the NO_SORT transparency mode.

Adjustable fields include the color, thickness, and sensitivity of the outline, with default values respectively set to black (0.f, 0.f, 0.f), 0.0f, and 0.0f.

File format/default:

OutlineEffect {

    color 0.0 0.0 0.0
    thickness 0.0
    sensitivity 0.0
}

Action behavior:

SoGLRenderAction
In addition to the standard rendering, draw the contours of scene objects in screen space (excluding objects in SoAnnotation nodes).

Since:
Open Inventor 2025.2

See Also:
  • Field Details

    • color

      public final SoSFColor color
      The color of the outline. Default is black (0.0f, 0.0f, 0.0f).
    • thickness

      public final SoSFFloat thickness
      Specifies the thickness of the contours. A higher value makes the outlines thicker, while a lower value makes them thinner. The value ranges from 0.0f to 1.0f. Default is 0.0f.
    • sensitivity

      public final SoSFFloat sensitivity
      Specifies the sensitivity to detect contours. A higher value allows for the detection of fine details, while a lower value only highlights marked variations. The value ranges from 0.0f to 1.0f. Default is 0.0f.
  • Constructor Details

    • SoOutlineEffect

      public SoOutlineEffect()