Class SoScale2Dragger

All Implemented Interfaces:
SafeDisposable

public class SoScale2Dragger extends SoDragger
Object you can scale in two dimensions by dragging with the mouse. SoScale2Dragger is a simple dragger that scales freely and independently in two dimensions when dragged with the mouse. It moves within the x-y plane of its local space, as determined by its location in the scene graph. Transformation nodes placed before it will affect both the dragger and the plane of motion.

This node has a scaleFactor field which always reflects its size in local space. If you set the field, the dragger will change accordingly. You can also connect fields of other nodes or engines from this one to make them follow the dragger's motion.

This dragger contains four parts, scaler , scalerActive , feedback , and feedbackActive .

Each of these is set by default from a resource described in the Dragger Resources section of the online reference page for this class. You can change the parts in any instance of this dragger using setPart().

You can make your program use different default resources for the parts by copying the file $OIVHOME/data/draggerDefaults/scale2Dragger.iv into your own directory, editing the file, and then setting the environment variable SO_DRAGGER_DIR to be a path to that directory.

See SoDragger for more information about using and customizing draggers, including code examples, using draggers in an immersive VR environment and using WYSIWYG draggers.

File format/default:

Scale2Dragger {

    boundingBoxCaching AUTO
    renderCulling AUTO
    pickCulling AUTO
    isActive false
    scaleFactor 1 1 1
    callbackList NULL
    scaler <scale2Scaler resource>
    scalerActive <scale2ScalerActive resource>
    feedback <scale2Feedback resource>
    feedbackActive <scale2FeedbackActive resource>
}

DRAGGER RESOURCES

    Resource: scale2Scaler
    Part: scaler
    Appearance: white photo-corners at corners of 2-by-2 square in plane of motion
    Description: picking this initiates the scaling

    Resource: scale2ScalerActive
    Part: scalerActive
    Appearance: yellow version of scaler, but with an extra yellow box
    Description: displayed instead of scaler while in motion

    Resource: scale2Feedback
    Part: feedback
    Appearance: thin purple 3-D crosshair
    Description: shows center of scale when still

    Resource: scale2FeedbackActive
    Part: feedbackActive
    Appearance: thin, slightly brighter purple 3-D crosshair
    Description: shows center of scale while in motion

CATALOG PARTS

All Parts

    Part NamePart TypeDefault TypeNULL Default
    callbackList NodeKitListPart yes
    scaler Separator yes
    scalerActive Separator yes
    feedback Separator yes
    feedbackActive Separator yes

Extra Information for List Parts from Above Table

    Part NameContainer TypePossible Types
    callbackList Separator Callback, EventCallback

See Also:
  • Field Details

    • scaleFactor

      public final SoSFVec3f scaleFactor
      Scale factor affecting the dragger.
  • Constructor Details

    • SoScale2Dragger

      public SoScale2Dragger()
      Constructor.
  • Method Details