Medical/helpers/MedicalHelper.h

Go to the documentation of this file.

// Open Inventor Medical Helper functions

//
// This class is part of the Open Inventor Medical utility library.
//
// The medical utility classes are provided as a prebuilt library named
// "fei_inventor_medical", that can be used directly in an Open Inventor
// application. The classes in the prebuilt library are documented and
// supported by FEI. These classes are also provided as source code.
//
// Please see $OIVHOME/include/Medical/InventorMedical.h for the full text.
//

#ifndef _INVENTOR_MEDICAL_HELPER_H_
#define _INVENTOR_MEDICAL_HELPER_H_

#include <Medical/InventorMedical.h>
#include <Inventor/nodes/SoNode.h>
#include <Inventor/actions/SoSearchPathAction.h>

// SoDialogViz.h must be included before this file in order for
// DialogViz-related functions to be available.
// This is to avoid linking DialogViz with the Medical library
// so that the user code can decide which DialogViz library to use
// with their application.
#if defined(__DIALOGVIZLIB)
#include <DialogViz/dialog/SoTopLevelDialog.h>
#include <DialogViz/dialog/SoDialogCustom.h>
#endif

#include <Inventor/Axis.h>

#include <Inventor/STL/vector>

class SoCamera;
class SoDataRange;
class SoImageBackground;
class SoImageDataAdapter;
class SoMemoryDataAdapter;
class SoOrthoSlice;
class SoTransferFunction;
class SoVolumeData;
class SoVRDicomFileReader;
class SoMatrixTransform;

class INVENTORMEDICAL_API MedicalHelper {
public:

  enum Axis {
    AXIAL      = 2,
    TRANSVERSE = 2,
    CORONAL    = 1,
    SAGITTAL   = 0
  };

  static SbBool orientView( MedicalHelper::Axis axis, SoCamera* camera,
                            const SoVolumeData* volume = NULL, float slack = 1.01 );

  static SbBool dicomAdjustVolume( SoVolumeData* volume, SbBool useImagePosition = TRUE );

  static SbBool dicomAdjustVolume( SoVolumeData* volume, SoMatrixTransform* imgToPatient );

  static SbBool dicomAdjustDataRange( SoDataRange* rangeNode, const SoVolumeData* volume );

  static SbBool dicomCheckMonochrome1( SoTransferFunction* cmapNode, const SoVolumeData* volume,
                                       SbBool forceReverse = FALSE );

  static SbBool dicomGetImagePosition( const SoVolumeData* volume, SbVec3f& imagePos );

  static SbBool dicomGetWindowCenterWidth( const SoVolumeData* volume, SbVec2f& winCW );

  static SbVec2f dicomGetWindowCenterWidth( const SoDataRange* dataRange );

  static SbBool dicomSetWindowCenterWidth( SoDataRange* dataRange, const SbVec2f& winCW );

  static int dicomFindFilesbySeries( const SbString& firstFile, std::vector<SbString>& files );

  static int dicomFindFilesbySeries( const SbString& firstFile, SbStringList& files );

  static void dollyZoom( float value, SoCamera* camera );

  static SbBool setFilenameList( SoVRDicomFileReader& reader, const std::vector<SbString>& list );

  SbVec3f getVoxelSize( const SoVolumeData* volume ) const;

  SbVec3f getPhysicalSize( const SoVolumeData* volume ) const;

  SbVec3f getDicomOrigin( const SoVolumeData* volume ) const;
  
  static SoMemoryDataAdapter* getImageDataAdapter( const SoVolumeData* volume );

  static SoVolumeData* getVolumeData( const SoImageDataAdapter* adapter );

  static SoSeparator* buildSliceOrientationMarkers( const SoOrthoSlice* orthoSlice );

  static SoSeparator* buildSliceScaleBars( const SoCamera* camera );

  static SoSeparator* buildSliceAnnotation( const SoCamera* camera, 
                                            const SoOrthoSlice* sliceNode,
                                            const SbString* dicomFilename );

  static const SbVec2s& exampleWindowSize();

  static SoNode* exampleLogoNode();

  static SoNode* exampleDicomAnnotation( const SbString& filename );

  static Axis MedicalAxisFromViewAxis(openinventor::inventor::Axis::Type viewAxis, const SoVolumeData* volData);

  static Axis MedicalAxisFromViewAxis(openinventor::inventor::Axis::Type viewAxis, const SbMatrix& orientationMatrix);

  static openinventor::inventor::Axis::Type ViewAxisFromMedicalAxis(Axis medicalAxis, const SoVolumeData* volData);

  static openinventor::inventor::Axis::Type ViewAxisFromMedicalAxis(Axis medicalAxis, const SbMatrix& orientationMatrix);

  //------------------------------------------------------------------------------
  template <typename NodeType>
  static NodeType*
    find(SoNode* root, const SbString& nodeName = SbString(), const bool okIfNotFound = false)
  {
    if (root == NULL)
      return NULL;

    SoSearchAction* spa = NULL;
    if (!nodeName.isEmpty())
    {
      spa = new SoSearchPathAction;
      ((SoSearchPathAction*)spa)->setSearchString(nodeName.getString());
    }
    else
    {
      spa = new SoSearchAction;
    }
    spa->setSearchingAll(TRUE);
    spa->setType(NodeType::getClassTypeId());

    // Make sure the action doesn't destroy this node...
    // Do not unref until _after_ the action is destroyed!
    // Apply() will ref and unref, but root will also be ref'd by the resulting SoPath.
    root->ref();
    spa->apply(root);

    if (spa->getPath() == NULL)
    {
      delete spa;
      if (!okIfNotFound)
        std::cerr << "Cannot find \"" << nodeName << "\" of type \"" << NodeType::getClassTypeId().getName() << "\" in scene graph." << std::endl;
      return NULL;
    }

    NodeType* node = dynamic_cast<NodeType*>(spa->getPath()->getTail());
    if (node == NULL)
    {
      delete spa;
      if (!okIfNotFound)
        std::cerr << "Cannot find \"" << nodeName << "\" of type \"" << NodeType::getClassTypeId().getName() << "\" in scene graph." << std::endl;
      return NULL;
    }

    delete spa;             // This will also destroy the SoPath, which will unref 'root'.
    root->unrefNoDelete();  // Finally, remove our safety ref from 'root'
    return node;
  }

  //------------------------------------------------------------------------------
  template <typename NodeType>
  static std::vector<NodeType*>findNodes(SoNode* scene)
  {
    SoSearchAction* sa = new SoSearchAction;
    sa->setType(NodeType::getClassTypeId());
    sa->setInterest(SoSearchAction::ALL);

    scene->ref(); // Make sure action does not destroy this node...
    sa->apply(scene);
    scene->unrefNoDelete();

    std::vector<NodeType*> ret;

    const SoPathList& path = sa->getPaths();
    if (path.getLength() == 0)
    {
      std::cerr << NodeType::getClassTypeId().getName().getString() << " not found" << std::endl;
      return ret;
    }

    for (int i = 0; i < path.getLength(); i++)
      ret.push_back(dynamic_cast<NodeType*>(path[i]->getTail()));

    delete sa;

    return ret;
  }

#if defined(__DIALOGVIZLIB)
  //------------------------------------------------------------------------------
  template <typename NodeType>
  static NodeType*
    find(SoTopLevelDialog* root, const SbString& auditorId = SbString(), bool exitIfNotFound = true)
  {
    if (root == NULL)
      return NULL;

    NodeType* node = dynamic_cast<NodeType*>(root->searchForAuditorId(auditorId));
    if (node == NULL)
    {
      std::cerr << "Cannot find " << auditorId << " of type " << NodeType::getClassTypeId().getName() << " in interface." << std::endl;
      if (exitIfNotFound)
        exit(1);
    }

    return node;
  }
#endif /* __DIALOGVIZLIB */

  //------------------------------------------------------------------------------
  static SbBox3f getBoundingBox(SoNode* node);

  //------------------------------------------------------------------------------
  static SoSeparator* createCube(const SbBox3f& bbox);

  //------------------------------------------------------------------------------
  static SoSeparator* createBoundingBox(const SbBox3f& bbox, SbColor* color = NULL);

  //------------------------------------------------------------------------------
  static SoSeparator* readFile(const char *filename);

#if defined(__DIALOGVIZLIB)
  //------------------------------------------------------------------------------
  template<typename WidgetType>
  static WidgetType
  buildInterface(WidgetType window, const char* filename, const char* viewerName, SoTopLevelDialog** topLevelDialog)
  {
    SoInput myInput;
    if (!myInput.openFile(filename))
      return NULL;

    SoGroup *myGroup = SoDB::readAll(&myInput);
    myInput.closeFile();
    if (!myGroup)
      return NULL;

    *topLevelDialog = (SoTopLevelDialog *)myGroup->getChild(0);

    SoDialogCustom *customNode = (SoDialogCustom *)(*topLevelDialog)->searchForAuditorId(SbString(viewerName));

    (*topLevelDialog)->buildDialog(window, customNode != NULL);
    (*topLevelDialog)->show();

    return customNode ? customNode->getWidget() : window;
  }
#endif /* __DIALOGVIZLIB */
};

#endif

---

Open Inventor Toolkit reference manual, generated on 4 Sep 2023
Copyright © Thermo Fisher Scientific All rights reserved. https://www.openinventor.com/