|
virtual SoType | getTypeId (void) const |
|
virtual const SoNodekitCatalog * | getNodekitCatalog (void) const |
|
| SoJackDragger (void) |
|
virtual void | callback (SoCallbackAction *action) |
|
virtual void | GLRender (SoGLRenderAction *action) |
|
virtual void | getMatrix (SoGetMatrixAction *action) |
|
virtual void | rayPick (SoRayPickAction *action) |
|
virtual void | search (SoSearchAction *action) |
|
virtual void | write (SoWriteAction *action) |
|
virtual void | getPrimitiveCount (SoGetPrimitiveCountAction *action) |
|
void | setProjectorEpsilon (const float epsilon) |
|
float | getProjectorEpsilon (void) const |
|
void | addStartCallback (SoDraggerCB *func, void *data=NULL) |
|
void | removeStartCallback (SoDraggerCB *func, void *data=NULL) |
|
void | addMotionCallback (SoDraggerCB *func, void *data=NULL) |
|
void | removeMotionCallback (SoDraggerCB *func, void *data=NULL) |
|
void | addFinishCallback (SoDraggerCB *func, void *data=NULL) |
|
void | removeFinishCallback (SoDraggerCB *func, void *data=NULL) |
|
void | addValueChangedCallback (SoDraggerCB *func, void *data=NULL) |
|
void | removeValueChangedCallback (SoDraggerCB *func, void *data=NULL) |
|
void | setMinGesture (int pixels) |
|
int | getMinGesture (void) const |
|
SbBool | enableValueChangedCallbacks (SbBool newval) |
|
const SbMatrix & | getMotionMatrix (void) |
|
void | addOtherEventCallback (SoDraggerCB *func, void *data=NULL) |
|
void | removeOtherEventCallback (SoDraggerCB *func, void *data=NULL) |
|
void | registerChildDragger (SoDragger *child) |
|
void | unregisterChildDragger (SoDragger *child) |
|
void | registerChildDraggerMovingIndependently (SoDragger *child) |
|
void | unregisterChildDraggerMovingIndependently (SoDragger *child) |
|
SbMatrix | getLocalToWorldMatrix (void) |
|
SbMatrix | getWorldToLocalMatrix (void) |
|
SbVec3f | getLocalStartingPoint (void) |
|
SbVec3f | getWorldStartingPoint (void) |
|
void | getPartToLocalMatrix (const SbName &partname, SbMatrix &parttolocalmatrix, SbMatrix &localtopartmatrix) |
|
void | transformMatrixLocalToWorld (const SbMatrix &frommatrix, SbMatrix &tomatrix) |
|
void | transformMatrixWorldToLocal (const SbMatrix &frommatrix, SbMatrix &tomatrix) |
|
void | transformMatrixToLocalSpace (const SbMatrix &frommatrix, SbMatrix &tomatrix, const SbName &fromspacepartname) |
|
virtual void | setMotionMatrix (const SbMatrix &newmatrix) |
|
void | valueChanged (void) |
|
const SbMatrix & | getStartMotionMatrix (void) |
|
virtual void | saveStartParameters (void) |
|
const SoPath * | getPickPath (void) const |
|
const SoEvent * | getEvent (void) const |
|
SoPath * | createPathToThis (void) |
|
const SoPath * | getSurrogatePartPickedOwner (void) const |
|
const SbName & | getSurrogatePartPickedName (void) const |
|
const SoPath * | getSurrogatePartPickedPath (void) const |
|
void | setStartingPoint (const SoPickedPoint *newpoint) |
|
void | setStartingPoint (const SbVec3f &newpoint) |
|
const SbViewVolume & | getViewVolume (void) |
|
void | setViewVolume (const SbViewVolume &vol) |
|
const SbViewportRegion & | getViewportRegion (void) |
|
void | setViewportRegion (const SbViewportRegion ®) |
|
SoHandleEventAction * | getHandleEventAction (void) const |
|
void | setHandleEventAction (SoHandleEventAction *newAction) |
|
void | setTempPathToThis (const SoPath *somethingclose) |
|
virtual void | grabEventsSetup (void) |
|
virtual void | grabEventsCleanup (void) |
|
void | workFieldsIntoTransform (SbMatrix &mtx) |
|
void | setFrontOnProjector (ProjectorFrontSetting newval) |
|
ProjectorFrontSetting | getFrontOnProjector (void) const |
|
| SoInteractionKit (void) |
|
virtual SbBool | setPartAsPath (const SbName &partname, SoPath *path) |
|
virtual SbBool | setPartAsDefault (const SbName &partname, SoNode *node, SbBool onlyifdefault=TRUE) |
|
virtual SbBool | setPartAsDefault (const SbName &partname, const SbName &nodename, SbBool onlyifdefault=TRUE) |
|
SbBool | isPathSurrogateInMySubgraph (const SoPath *path, SoPath *&pathToOwner, SbName &surrogatename, SoPath *&surrogatepath, SbBool fillargs=TRUE) |
|
SbBool | isPathSurrogateInMySubgraph (const SoPath *path) |
|
virtual SbBool | setPart (const SbName &partname, SoNode *from) |
|
| SoBaseKit (void) |
|
virtual SoNode * | getPart (const SbName &partname, SbBool makeifneeded) |
|
SbString | getPartString (const SoBase *part) |
|
virtual SoNodeKitPath * | createPathToPart (const SbName &partname, SbBool makeifneeded, const SoPath *pathtoextend=NULL) |
|
SbBool | set (const char *namevaluepairliststring) |
|
SbBool | set (const char *partnamestring, const char *parameterstring) |
|
virtual void | doAction (SoAction *action) |
|
virtual SoChildList * | getChildren (void) const |
|
void | printDiagram (void) |
|
void | printSubDiagram (const SbName &rootname, int level) |
|
void | printTable (void) |
|
virtual void | addWriteReference (SoOutput *out, SbBool isfromfield=FALSE) |
|
SbBool | forceChildDrivenWriteRefs (SoOutput *out) |
|
void | setOverride (const SbBool state) |
|
SbBool | isOverride (void) const |
|
void | setNodeType (const NodeType type) |
|
NodeType | getNodeType (void) const |
|
virtual SoNode * | copy (SbBool copyconnections=FALSE) const |
|
virtual SbBool | affectsState (void) const |
|
virtual void | GLRenderBelowPath (SoGLRenderAction *action) |
|
virtual void | GLRenderInPath (SoGLRenderAction *action) |
|
virtual void | GLRenderOffPath (SoGLRenderAction *action) |
|
virtual void | pick (SoPickAction *action) |
|
virtual void | audioRender (SoAudioRenderAction *action) |
|
virtual void | startNotify (void) |
|
virtual void | notify (SoNotList *l) |
|
uint32_t | getNodeId (void) const |
|
virtual void | writeInstance (SoOutput *out) |
|
virtual SoFieldContainer * | copyThroughConnection (void) const |
|
void | setToDefaults (void) |
|
SbBool | hasDefaultValues (void) const |
|
SbBool | fieldsAreEqual (const SoFieldContainer *container) const |
|
void | copyFieldValues (const SoFieldContainer *container, SbBool copyconnections=FALSE) |
|
SbBool | set (const char *const fielddata) |
|
void | get (SbString &fielddata) |
|
virtual int | getFields (SoFieldList &l) const |
|
virtual int | getAllFields (SoFieldList &l) const |
|
virtual SoField * | getField (const SbName &name) const |
|
virtual SoField * | getEventIn (const SbName &name) const |
|
virtual SoField * | getEventOut (const SbName &name) const |
|
SbBool | getFieldName (const SoField *const field, SbName &name) const |
|
SbBool | enableNotify (const SbBool flag) |
|
SbBool | isNotifyEnabled (void) const |
|
SbBool | set (const char *fielddata, SoInput *input) |
|
void | get (SbString &fielddata, SoOutput *out) |
|
virtual SbBool | validateNewFieldValue (SoField *field, void *newval) |
|
SbBool | getIsBuiltIn (void) const |
|
virtual void | getFieldsMemorySize (size_t &managed, size_t &unmanaged) const |
|
void | setUserData (void *userdata) const |
|
void * | getUserData (void) const |
|
void | ref (void) const |
|
void | unref (void) const |
|
void | unrefNoDelete (void) const |
|
int32_t | getRefCount (void) const |
|
void | touch (void) |
|
SbBool | isOfType (SoType type) const |
|
virtual SbName | getName (void) const |
|
virtual void | setName (const SbName &newname) |
|
void | addAuditor (void *const auditor, const SoNotRec::Type type) |
|
void | removeAuditor (void *const auditor, const SoNotRec::Type type) |
|
const SoAuditorList & | getAuditors (void) const |
|
SbBool | shouldWrite (void) |
|
void | assertAlive (void) const |
|
|
static SoType | getClassTypeId (void) |
|
static const SoNodekitCatalog * | getClassNodekitCatalog (void) |
|
static void | initClass (void) |
|
static SoType | getClassTypeId (void) |
|
static const SoNodekitCatalog * | getClassNodekitCatalog (void) |
|
static void | setMinScale (float newminscale) |
|
static float | getMinScale (void) |
|
static void | workValuesIntoTransform (SbMatrix &mtx, const SbVec3f *translationptr, const SbRotation *rotationptr, const SbVec3f *scalefactorptr, const SbRotation *scaleorientationptr, const SbVec3f *centerptr) |
|
static void | getTransformFast (SbMatrix &mtx, SbVec3f &translation, SbRotation &rotation, SbVec3f &scalefactor, SbRotation &scaleorientation, const SbVec3f ¢er) |
|
static void | getTransformFast (SbMatrix &mtx, SbVec3f &translation, SbRotation &rotation, SbVec3f &scalefactor, SbRotation &scaleorientation) |
|
static SbMatrix | appendTranslation (const SbMatrix &mtx, const SbVec3f &translation, const SbMatrix *conversion=NULL) |
|
static SbMatrix | appendScale (const SbMatrix &mtx, const SbVec3f &scale, const SbVec3f &scalecenter, const SbMatrix *conversion=NULL) |
|
static SbMatrix | appendRotation (const SbMatrix &mtx, const SbRotation &rot, const SbVec3f &rotcenter, const SbMatrix *conversion=NULL) |
|
static void | initClass (void) |
|
static void | initClasses (void) |
|
static SoType | getClassTypeId (void) |
|
static const SoNodekitCatalog * | getClassNodekitCatalog (void) |
|
static void | initClass (void) |
|
static void | setSwitchValue (SoNode *node, const int newVal) |
|
static SoType | getClassTypeId (void) |
|
static void | initClass (void) |
|
static const SoNodekitCatalog * | getClassNodekitCatalog (void) |
|
static SbBool | isSearchingChildren (void) |
|
static void | setSearchingChildren (const SbBool newval) |
|
static uint32_t | getCompatibilityTypes (const SoType &nodetype) |
|
static SoType | getClassTypeId (void) |
|
static SoNode * | getByName (const SbName &name) |
|
static int | getByName (const SbName &name, SoNodeList &l) |
|
static void | initClass (void) |
|
static void | initClasses (void) |
|
static uint32_t | getNextNodeId (void) |
|
static int | getActionMethodIndex (const SoType type) |
|
static void | getBoundingBoxS (SoAction *action, SoNode *node) |
|
static void | GLRenderS (SoAction *action, SoNode *node) |
|
static void | callbackS (SoAction *action, SoNode *node) |
|
static void | getMatrixS (SoAction *action, SoNode *node) |
|
static void | handleEventS (SoAction *action, SoNode *node) |
|
static void | pickS (SoAction *action, SoNode *node) |
|
static void | rayPickS (SoAction *action, SoNode *node) |
|
static void | searchS (SoAction *action, SoNode *node) |
|
static void | writeS (SoAction *action, SoNode *node) |
|
static void | audioRenderS (SoAction *action, SoNode *node) |
|
static void | getPrimitiveCountS (SoAction *action, SoNode *node) |
|
static void | initClass (void) |
|
static SoType | getClassTypeId (void) |
|
static void | cleanupClass (void) |
|
static void | initCopyDict (void) |
|
static void | addCopy (const SoFieldContainer *orig, const SoFieldContainer *copy) |
|
static SoFieldContainer * | checkCopy (const SoFieldContainer *orig) |
|
static SoFieldContainer * | findCopy (const SoFieldContainer *orig, const SbBool copyconnections) |
|
static void | copyDone (void) |
|
static void | initClass (void) |
|
static SoType | getClassTypeId (void) |
|
static void | addName (SoBase *const base, const char *const name) |
|
static void | removeName (SoBase *const base, const char *const name) |
|
static void | incrementCurrentWriteCounter (void) |
|
static void | decrementCurrentWriteCounter (void) |
|
static SoBase * | getNamedBase (const SbName &name, SoType type) |
|
static int | getNamedBases (const SbName &name, SoBaseList &baselist, SoType type) |
|
static SbBool | read (SoInput *input, SoBase *&base, SoType expectedtype) |
|
static void | setInstancePrefix (const SbString &c) |
|
static void | setTraceRefs (SbBool trace) |
|
static SbBool | getTraceRefs (void) |
|
static SbBool | connectRoute (SoInput *input, const SbName &fromnodename, const SbName &fromfieldname, const SbName &tonodename, const SbName &tofieldname) |
|
static SbBool | readRoute (SoInput *input) |
|
|
virtual const SoFieldData * | getFieldData (void) const |
|
virtual | ~SoJackDragger (void) |
|
virtual SbBool | setUpConnections (SbBool onoff, SbBool doitalways=FALSE) |
|
virtual void | setDefaultOnNonWritingFields (void) |
|
| SoDragger (void) |
|
virtual | ~SoDragger (void) |
|
SbVec2f | getNormalizedLocaterPosition (void) |
|
SbVec2s | getLocaterPosition (void) |
|
SbVec2s | getStartLocaterPosition (void) const |
|
void | setStartLocaterPosition (SbVec2s p) |
|
SbBool | isAdequateConstraintMotion (void) |
|
virtual SbBool | shouldGrabBasedOnSurrogate (const SoPath *pickpath, const SoPath *surrogatepath) |
|
void | setCameraInfo (SoAction *action) |
|
virtual void | handleEvent (SoHandleEventAction *ha) |
|
void | transferMotion (SoDragger *child) |
|
void | setIgnoreInBbox (SbBool newval) |
|
SbBool | isIgnoreInBbox (void) |
|
virtual void | getBoundingBox (SoGetBoundingBoxAction *action) |
|
void | setActiveChildDragger (SoDragger *newchilddragger) |
|
SoDragger * | getActiveChildDragger (void) const |
|
void | updateDraggerCache (const SoPath *path) |
|
virtual | ~SoInteractionKit () |
|
virtual void | copyContents (const SoFieldContainer *fromFC, SbBool copyConnections) |
|
virtual SbBool | setPart (const int partNum, SoNode *node) |
|
virtual SbBool | readInstance (SoInput *in, unsigned short flags) |
|
virtual SbBool | setAnyPartAsDefault (const SbName &partname, SoNode *node, SbBool anypart=TRUE, SbBool onlyifdefault=TRUE) |
|
virtual SbBool | setAnyPartAsDefault (const SbName &partname, const SbName &nodename, SbBool anypart=TRUE, SbBool onlyifdefault=TRUE) |
|
SbBool | setAnySurrogatePath (const SbName &name, SoPath *path, SbBool leafcheck=FALSE, SbBool publiccheck=FALSE) |
|
void | connectSeparatorFields (SoSeparator *dest, SbBool onOff) |
|
virtual | ~SoBaseKit () |
|
virtual SoNode * | addToCopyDict (void) const |
|
SoGroup * | getContainerNode (const SbName &listname, SbBool makeifneeded=TRUE) |
|
virtual SoNode * | getAnyPart (const SbName &partname, SbBool makeifneeded, SbBool leafcheck=FALSE, SbBool publiccheck=FALSE) |
|
virtual SoNodeKitPath * | createPathToAnyPart (const SbName &partname, SbBool makeifneeded, SbBool leafcheck=FALSE, SbBool publiccheck=FALSE, const SoPath *pathtoextend=NULL) |
|
virtual SbBool | setAnyPart (const SbName &partname, SoNode *from, SbBool anypart=TRUE) |
|
void | createNodekitPartsList (void) |
|
void | createFieldList (void) |
|
virtual void | createDefaultParts (void) |
|
const SoNodekitParts * | getNodekitPartsList (void) const |
|
const SbList< SoSFNode * > & | getCatalogInstances (void) const |
|
void | catalogError (void) |
|
void | countMyFields (SoOutput *out) |
|
| SoNode (void) |
|
virtual | ~SoNode () |
|
| SoFieldContainer (void) |
|
virtual | ~SoFieldContainer () |
|
| SoBase (void) |
|
virtual | ~SoBase () |
|
virtual void | destroy (void) |
|
SbBool | hasMultipleWriteRefs (void) const |
|
SbBool | writeHeader (SoOutput *out, SbBool isgroup, SbBool isengine) const |
|
void | writeFooter (SoOutput *out) const |
|
virtual const char * | getFileFormatName (void) const |
|
|
static const SoFieldData ** | getFieldDataPtr (void) |
|
static const SoNodekitCatalog ** | getClassNodekitCatalogPtr (void) |
|
static void | invalidateSurroundScaleCB (void *f, SoDragger *d) |
|
static void | fieldSensorCB (void *f, SoSensor *s) |
|
static void | valueChangedCB (void *f, SoDragger *d) |
|
static const SoFieldData ** | getFieldDataPtr (void) |
|
static const SoNodekitCatalog ** | getClassNodekitCatalogPtr (void) |
|
static void | childTransferMotionAndValueChangedCB (void *, SoDragger *) |
|
static void | childValueChangedCB (void *, SoDragger *) |
|
static void | childStartCB (void *, SoDragger *) |
|
static void | childMotionCB (void *, SoDragger *) |
|
static void | childFinishCB (void *, SoDragger *) |
|
static void | childOtherEventCB (void *, SoDragger *) |
|
static const SoFieldData ** | getFieldDataPtr (void) |
|
static const SoNodekitCatalog ** | getClassNodekitCatalogPtr (void) |
|
static void | readDefaultParts (const char *fileName, const char defaultBuffer[], int defBufSize) |
|
static void | fieldSensorCB (void *, SoSensor *) |
|
static const SoFieldData ** | getFieldDataPtr (void) |
|
static const SoNodekitCatalog ** | getClassNodekitCatalogPtr (void) |
|
static const SoFieldData ** | getFieldDataPtr (void) |
|
static void | setNextActionMethodIndex (int index) |
|
static int | getNextActionMethodIndex (void) |
|
static void | incNextActionMethodIndex (void) |
|
static void | setCompatibilityTypes (const SoType &nodetype, const uint32_t bitmask) |
|
static uint32_t | getCurrentWriteCounter (void) |
|
static void | staticDataLock (void) |
|
static void | staticDataUnlock (void) |
|
The SoJackDragger class is a dragger you can translate, rotate and scale.
Here's how the dragger looks with its default geometry in the inactive state:
Translation is done with this dragger by picking the flat transparent box ("x-z" translation) or the solid middle part of the axis ("y"-axis translation). Press a SHIFT-key while translating in x-z to constrain to one of the principal axes.
Uniform scale operations can be done by dragging any of the 6 cubes. Non-uniform scale operations can not be done with this dragger.
Rotations are invoked by clicking and dragging the line parts of the 3 principal "axes" of the dragger geometry.
NB: How to rotate the dragger might be abit unintuitive for the end user. If the dragger is to be used 'out of the box', a good documentation should be added to your application. An alternative is to modify the geometry to increase the affordance of the dragger. See the SoDragger documentation on how to change the geometry of a dragger.
An "action shot" of the SoJackDragger used within an SoClipPlaneManip:
The name "Jack dragger" probably stems from this dragger being implemented by SGI for interacting with a "jack-in-the-box" type model way back in the Inventor history.
For programmer convenience, this dragger comes fully wrapped within instances of the SoJackManip class. The SoClipPlaneManip manipulator also uses this dragger, for controlling an SoClipPlane node.
SoJackDragger::SoJackDragger |
( |
void |
| ) |
|
Default constructor, sets up the dragger nodekit catalog with the interaction and feedback geometry.
Node kit structure (new entries versus parent class marked with arrow prefix):
CLASS SoJackDragger
-->"this"
"callbackList"
"topSeparator"
"motionMatrix"
--> "surroundScale"
--> "antiSquish"
--> "scaler"
--> "rotator"
--> "translator"
"geomSeparator"
(See SoBaseKit::printDiagram() for information about the output formatting.)
Detailed information on catalog parts:
CLASS SoJackDragger
PVT "this", SoJackDragger ---
"callbackList", SoNodeKitListPart [ SoCallback, SoEventCallback ]
PVT "topSeparator", SoSeparator ---
PVT "motionMatrix", SoMatrixTransform ---
"surroundScale", SoSurroundScale ---
"antiSquish", SoAntiSquish ---
"scaler", SoScaleUniformDragger ---
"rotator", SoRotateSphericalDragger ---
"translator", SoDragPointDragger ---
PVT "geomSeparator", SoSeparator ---
(See SoBaseKit::printTable() for information about the output formatting.)
Returns the type identification of an object derived from a class inheriting SoBase. This is used for run-time type checking and "downward" casting.
Usage example:
{
if (node->
getTypeId() == SoFile::getClassTypeId()) {
}
}
The SbList class is a template container class for lists.
Definition SbList.h:61
virtual SoType getTypeId(void) const =0
The SoFile class is node container for another model file.
Definition SoFile.h:34
The SoNode class is the base class for nodes used in scene graphs.
Definition SoNode.h:47
For application programmers wanting to extend the library with new nodes, engines, nodekits, draggers or others: this method needs to be overridden in all subclasses. This is typically done as part of setting up the full type system for extension classes, which is usually accomplished by using the pre-defined macros available through for instance Inventor/nodes/SoSubNode.h (SO_NODE_INIT_CLASS and SO_NODE_CONSTRUCTOR for node classes), Inventor/engines/SoSubEngine.h (for engine classes) and so on.
For more information on writing Coin extensions, see the class documentation of the toplevel superclasses for the various class groups.
Reimplemented from SoDragger.
void SoJackDragger::setDefaultOnNonWritingFields |
( |
void |
| ) |
|
|
protectedvirtual |
(Be aware that this method is unlikely to be of interest to the application programmer who does not want to extend the library with new custom nodekits or draggers. If you indeed are writing extensions, see the information in the SoBaseKit class documentation.)
This is a virtual method, and the code in it should call SoField::setDefault() with argument TRUE
on part fields that should not be written upon scenegraph export operations.
This is typically done when:
-
field value is NULL
and part is NULL
by default
-
it is a leaf SoGroup or SoSeparator node with no children
-
it is a leaf listpart with no children and an SoGroup or SoSeparator container
-
it is a non-leaf part and it's of SoGroup type and all fields are at their default values
Subclasses should usually override this to do additional settings for new member fields. From the subclass, do remember to call "upwards" to your superclass' setDefaultOnNonWritingFields() method.
Reimplemented from SoDragger.