Enum Class SoGLRenderAction.FastEditSavePolicies

java.lang.Object
java.lang.Enum<SoGLRenderAction.FastEditSavePolicies>
com.openinventor.inventor.actions.SoGLRenderAction.FastEditSavePolicies
All Implemented Interfaces:
IntegerValuedEnum, Serializable, Comparable<SoGLRenderAction.FastEditSavePolicies>, Constable
Enclosing class:
SoGLRenderAction

public static enum SoGLRenderAction.FastEditSavePolicies extends Enum<SoGLRenderAction.FastEditSavePolicies> implements IntegerValuedEnum
Fast edit traversal types. See SoSeparator for additional info on fast editing.
In the following description, we will call FE the sub-scene graph allowing the fast editing feature,
and NFE the non-fast editing sub-scene graph and consider the following scene graph:
Separator {
  Separator {
    fastEditing # ( != DISABLE to activate )
    Translation {}
    Cube{}
  }
  Separator {
    Translation {} Sphere{}
    Translation {} Sphere{}
    Translation {} Sphere{}
  }
}
  • Enum Constant Details

    • DISABLE

      public static final SoGLRenderAction.FastEditSavePolicies DISABLE
      Fast editing is disabled.

    • EACH_FRAME

      public static final SoGLRenderAction.FastEditSavePolicies EACH_FRAME
      The fast edit feature is available. The image buffer (and possibly the depth buffer, depending on the value of the SoSeparator.fastEditing field) is saved each time the scene graph is redrawn.

      We recommend using the EACH_FRAME flag when manipulating a very large main scene graph. In this case, the time used for saving the buffer(s) is insignificant compared to the time to draw the scene. EACH_FRAME is recommended as well when the fast editing sub-scene graph is frequently modified: the user interactivity is better with the fast edit sub-scene graph even though the global scene frame rate may slow down.

    • WHEN_NEEDED

      public static final SoGLRenderAction.FastEditSavePolicies WHEN_NEEDED
      The fast edit feature is available. No buffer save is made during ordinary scene rendering. When a change to the fast editing sub-scene graph occurs, the entire scene is first rendered and saved, and then the fast edit nodes are drawn. During the next rendering, only the fast edit nodes are drawn. So, using this flag implies you need one more full scene rendering before starting to move your fast edit sub-scene graph interactively. It would be better to use WHEN_NEEDED when the fast editing sub-scene graph changes very rarely. In this case you will be able to render the scene at full speed because extra time will not be spent saving the image buffer.

  • Method Details

    • values

      public static SoGLRenderAction.FastEditSavePolicies[] values()
      Returns an array containing the constants of this enum class, in the order they are declared.
      Returns:
      an array containing the constants of this enum class, in the order they are declared
    • valueOf

      public static SoGLRenderAction.FastEditSavePolicies valueOf(String name)
      Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (Extraneous whitespace characters are not permitted.)
      Parameters:
      name - the name of the enum constant to be returned.
      Returns:
      the enum constant with the specified name
      Throws:
      IllegalArgumentException - if this enum class has no constant with the specified name
      NullPointerException - if the argument is null
    • valueOf

      public static SoGLRenderAction.FastEditSavePolicies valueOf(int val)
      Returns the enum constant of this type with the specified integer value
      Returns:
      the enum constant of this type with the specified integer value.
    • getValue

      public int getValue()
      Description copied from interface: IntegerValuedEnum
      Returns the integer value of the enum constant.
      Specified by:
      getValue in interface IntegerValuedEnum
      Returns:
      the integer value of the enum constant.