Enum SoGLRenderAction.FastEditSavePolicies

  • All Implemented Interfaces:
    IntegerValuedEnum, java.io.Serializable, java.lang.Comparable<SoGLRenderAction.FastEditSavePolicies>
    Enclosing class:
    SoGLRenderAction

    public static enum SoGLRenderAction.FastEditSavePolicies
    extends java.lang.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 Detail

      • 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 Detail

      • values

        public static SoGLRenderAction.FastEditSavePolicies[] values()
        Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:
        for (SoGLRenderAction.FastEditSavePolicies c : SoGLRenderAction.FastEditSavePolicies.values())
            System.out.println(c);
        
        Returns:
        an array containing the constants of this enum type, in the order they are declared
      • valueOf

        public static SoGLRenderAction.FastEditSavePolicies valueOf​(java.lang.String name)
        Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (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:
        java.lang.IllegalArgumentException - if this enum type has no constant with the specified name
        java.lang.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.