Class Gnomon

All Implemented Interfaces:
SafeDisposable

public class Gnomon extends SoAnnotation
(Preview Feature) Shape node to display a medical gnomon (compass) on the screen.

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.

This node displays a medical specific "gnomon" (compass) on the screen that shows the user the current orientation of the volume in 3D space. Visibility of the gnomon is controlled by the isDisplayed field. Position and size of the gnomon are specified in pixels using the position, width and height fields.

File format/default:

Gnomon {

    isDisplayed TRUE
    position 0 0
    width 100
    height 100
}
See Also:
  • Field Details

    • isDisplayed

      public SoSFBool isDisplayed
      Controls whether the gnomon is visible (default is true).
    • position

      public SoSFVec2i32 position
      Position of the gnomon viewport in pixels (default is 0,0).
    • width

      public SoSFInt32 width
      Specifies the width of the gnomon viewport in pixels (default is 100).
    • height

      public SoSFInt32 height
      Specifies the height of the gnomon viewport in pixels (default is 100).
    • cameraDistance

      public SoSFFloat cameraDistance
      Specifies the distance from the camera to the gnomon geometry. Default is 3.5. Applications should not need to modify this value.
  • Constructor Details

    • Gnomon

      public Gnomon()
      Constructor
  • Method Details

    • getRenderEngineMode

      public SoNode.RenderModes getRenderEngineMode()
      Description copied from class: SoNode
      Returns the supported Render engine mode.

      For custom node, this method returns by default SoNode.RenderModes.OIV_UNKNOWN_RENDERING_MODE, override this method to specify the Render engine mode supported by your custom node.

      Overrides:
      getRenderEngineMode in class SoNode
      Returns:
      the supported Render engine mode for this node.
    • setScale

      public void setScale(SbVec3f scale)
      Scale the size of the gnomon (default is 1,1,1).
    • setGeometry

      public void setGeometry(SoNode geometrySceneGraph)
      Replace the gnomon geometry (default is basic medical gnomon). Gnomon geometry should have a 3D extent of -1 to 1.