logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

SoTabPlaneDragger — object you can translate or scale within a plane by dragging with the mouse

Catalog Parts

       ┌─────────────────────────────────────────────────────────────┐
       │                          Allparts                          │
       │                                                     NULLby │
       │ PartNamePartTypeDefaultTypeDefault │
       │                                                             │
       │ callbackList       NodeKitListPart   --               yes   │
       │ translator         Separator         --               yes   │
       │ scaleTabMaterial   Material          --               yes   │
       │ scaleTabHints      ShapeHints        --               yes   │
       │                                                             │
       └─────────────────────────────────────────────────────────────┘
       ┌────────────────────────────────────────────────────────────────┐
       │       Extrainformationforlistpartsfromabovetable        │
       │                                                                │
       │ PartNameContainerTypePermissibleTypes              │
       │                                                                │
       │ callbackList   Separator        Callback, EventCallback        │
       │                                                                │
       └────────────────────────────────────────────────────────────────┘

Description

SoTabPlaneDragger is a dragger which allows the user to interactively translate and scale in a plane.  It
       looks  like  a square white outline with smaller green squares (or tabs) set in the corners and along the
       center of each edge. Dragging a cornertab scales the dragger in 2D by scaling about the opposite corner.
       Dragging an edgetab performs 1D scaling about the opposite edge. The rest of the  dragger  is  invisible
       but pickable; selecting it initiates translation within the plane.

       The  dragger  tries  to  keep the small tabs a constant size in screen space. Every time a drag begins or
       ends, the size is recalculated based on the viewing and modeling matrix.

       When dragging the translator part, press the <Shift> key and you can constrain motion to either the local
       xaxis or the yaxis. The direction is determined by your initial mouse gesture after pressing  the  key.
       Releasing the key removes the constraint.

       When  the  translator  part  drags,  the dragger updates its translation field. The various scaling parts
       cause changes to both the scaleFactor and translation field, since scaling about a point other  than  the
       center  adds  translation  to  the  center  of  the  dragger. If you set the field, the dragger will move
       accordingly. You can also connect fields of other nodes or engines from this one to make them follow  the
       dragger's motion.

       You  can  not change the shape used to draw the tabs. This part is kept privately and may not be changed;
       the coordinates for the tabs are edited during adjustScaleTabSize().

       The  SoTabPlaneDragger  class  does  contain  three  other  parts  you  can  change:  tabPlaneTranslator,
       tabPlaneScaleTabMaterial and tabPlaneScaleTabHints.

       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
       /usr/share/data/draggerDefaults/tabPlaneDragger.iv  into  your  own directory, editing the file, and then
       setting the environment variable SO_DRAGGER_DIR to be a path to that directory.

Dragger Resources

       .in 0n+.5i
     Resource:         tabPlaneTranslator
       .in 0n+.5i
     Part:             translator
     Appearance:       Outline of a Square. The region within it is pickable
     Description:      Begins translation within the plane

                         .in 0n+.5i
     Resource:         tabPlaneScaleTabMaterial
                         .in 0n+.5i
     Part:             scaleTabMaterial
     Appearance:       Green - half diffuse, half emissive.
     Description:      Used as material for scaling tabs.

                         .in 0n+.5i
     Resource:         tabPlaneScaleTabHints
                         .in 0n+.5i
     Part:             scaleTabHints
     Appearance:       shapeHints node:COUNTERCLOCKWISE/SOLID/CONVEX
     Description:      Property for the tab nodes.

Fields

SoSFVec3fscaleFactor
          Scale factor affecting the dragger.

     SoSFVec3ftranslation
          Position of the dragger.

File Format/Defaults

TabPlaneDragger{renderCachingAUTOboundingBoxCachingAUTOrenderCullingAUTOpickCullingAUTOisActiveFALSEtranslation000scaleFactor111callbackListNULLtranslator<tabPlaneTranslatorresource>scaleTabMaterial<tabPlaneScaleTabMaterialresource>scaleTabHints<tabPlaneScaleTabHintsresource>}

Inherits From

       SoBase > SoFieldContainer > SoNode > SoBaseKit > SoInteractionKit > SoDragger > SoTabPlaneDragger

Methods

SoTabPlaneDragger()
          Constructor.

     voidadjustScaleTabSize()
          Cause the scale tab sizes to be re-adjusted so that they remain a near  constant  screen  space  size.
          This  happens  automatically  upon  dragger  finish.  Call this to adjust the scale tab sizes at other
          times, for instance after the camera has changed in a viewer finish callback.

     staticconstSoNodekitCatalog*getClassNodekitCatalog()const
          Returns an SoNodekitCatalog for this class

     staticSoTypegetClassTypeId()
          Returns type identifier for this class.

Name

       SoTabPlaneDragger — object you can translate or scale within a plane by dragging with the mouse

See Also

SoInteractionKit,SoDragger,SoCenterballDragger,SoDirectionalLightDragger,SoDragPointDragger,SoHandleBoxDragger,SoJackDragger,SoPointLightDragger,SoRotateCylindricalDragger,SoRotateDiscDragger,SoRotateSphericalDragger,SoScale1Dragger,SoScale2Dragger,SoScale2UniformDragger,SoScaleUniformDragger,SoSpotLightDragger,SoTabBoxDragger,SoTrackballDragger,SoTransformBoxDragger,SoTransformerDragger,SoTranslate1Dragger,SoTranslate2DraggerSoTabPlaneDragger(3IV)()

Synopsis

#include<Inventor/draggers/SoTabPlaneDragger.h>

          Fields from class SoTabPlaneDragger:

     SoSFVec3fscaleFactorSoSFVec3ftranslation

          Fields from class SoDragger:

     SoSFBoolisActive

          Fields from class SoInteractionKit:

     SoSFEnumrenderCachingSoSFEnumboundingBoxCachingSoSFEnumrenderCullingSoSFEnumpickCulling

          Parts from class SoBaseKit:

     (SoNodeKitListPart)callbackList

          Methods from class SoTabPlaneDragger:

                         SoTabPlaneDragger()voidadjustScaleTabSize()staticconstSoNodekitCatalog*getClassNodekitCatalog()conststaticSoTypegetClassTypeId()

          Methods from class SoDragger:

     voidaddStartCallback(SoDraggerCB*f,void*userData=NULL)voidremoveStartCallback(SoDraggerCB*f,void*userData=NULL)voidaddMotionCallback(SoDraggerCB*f,void*userData=NULL)voidremoveMotionCallback(SoDraggerCB*f,void*userData=NULL)voidaddFinishCallback(SoDraggerCB*f,void*userData=NULL)voidremoveFinishCallback(SoDraggerCB*f,void*userData=NULL)voidaddValueChangedCallback(SoDraggerCB*f,void*userData=NULL)voidremoveValueChangedCallback(SoDraggerCB*f,void*userData=NULL)SbBoolenableValueChangedCallbacks()voidsetMinGesture(intpixels)intgetMinGesture()conststaticvoidsetMinScale(floatnewMinScale)staticfloatgetMinScale()

          Methods from class SoInteractionKit:

     virtualSbBoolsetPartAsPath(constSbName&partName,SoPath*surrogatePath)

          Methods from class SoBaseKit:

     virtualconstSoNodekitCatalog*getNodekitCatalog()constvirtualSoNode*getPart(constSbName&partName,SbBoolmakeIfNeeded)SbStringgetPartString(constSoBase*part)virtualSoNodeKitPath*createPathToPart(constSbName&partName,SbBoolmakeIfNeeded,constSoPath*pathToExtend=NULL)virtualSbBoolsetPart(constSbName&partName,SoNode*newPart)SbBoolset(char*partName,char*parameters)SbBoolset(char*nameValuePairs)staticSbBoolisSearchingChildren()staticvoidsetSearchingChildren(SbBoolnewVal)

          Methods from class SoNode:

     voidsetOverride(SbBoolstate)SbBoolisOverride()constSoNode*copy(SbBoolcopyConnections=FALSE)constvirtualSbBoolaffectsState()conststaticSoNode*getByName(constSbName&name)staticintgetByName(constSbName&name,SoNodeList&list)

          Methods from class SoFieldContainer:

     voidsetToDefaults()SbBoolhasDefaultValues()constSbBoolfieldsAreEqual(constSoFieldContainer*fc)constvoidcopyFieldValues(constSoFieldContainer*fc,SbBoolcopyConnections=FALSE)voidget(SbString&fieldDataString)virtualintgetFields(SoFieldList&resultList)constvirtualSoField*getField(constSbName&fieldName)constSbBoolgetFieldName(constSoField*field,SbName&fieldName)constSbBoolisNotifyEnabled()constSbBoolenableNotify(SbBoolflag)

          Methods from class SoBase:

     voidref()voidunref()constvoidunrefNoDelete()constvoidtouch()virtualSoTypegetTypeId()constSbBoolisOfType(SoTypetype)constvirtualvoidsetName(constSbName&name)virtualSbNamegetName()const

          Macros from class SoBaseKit:

     SO_GET_PART(kit,partName,partClass)SO_CHECK_PART(kit,partName,partClass)

See Also