Package gov.nih.mipav.view.renderer.WildMagic.Interface

Class SurfaceExtractor

  • All Implemented Interfaces:
    java.io.Serializable
    public class SurfaceExtractor
extends WildMagic.LibImagics.Extraction.ExtractSurfaceTetra
    A level surface extractor that is based on decomposing voxels into tetrahedra, assuming a linear interpolation on the tetrahedra, and extracting triangular level sets for those tetrahedra. The resulting level surface is a triangle mesh. A detailed discussion of the algorithm is found in Level Set Extraction
    See Also:
    Serialized Form

    • Nested Class Summary

      • Nested classes/interfaces inherited from class WildMagic.LibImagics.Extraction.ExtractSurfaceTetra

        WildMagic.LibImagics.Extraction.ExtractSurfaceTetra.Triangle, WildMagic.LibImagics.Extraction.ExtractSurfaceTetra.Vertex

    • Field Summary

      Fields 
      Modifier and Type Field Description
      private TransMatrix dicomMatrix
      Dicom Matrix
      private int[] direction
      Surface direction
      private float m_fXDelta
      Relative voxel size.
      private float m_fYDelta
      Relative voxel size.
      private float m_fZDelta
      Relative voxel size.
      private float[] startLocation
      Surface 3D location

      • Fields inherited from class WildMagic.LibImagics.Extraction.ExtractSurfaceTetra

        m_aiData, m_iNextIndex, m_iXBound, m_iXYProduct, m_iXYZProduct, m_iYBound, m_iZBound, m_kCentroid, m_kE0, m_kE1, m_kGradient, m_kN, m_kTSet, m_kV0, m_kV1, m_kV2, m_kVMap

    • Constructor Summary

      Constructors 
      Constructor Description
      SurfaceExtractor​(int iXBound, int iYBound, int iZBound, int[] aiData, float fXDelta, float fYDelta, float fZDelta, int[] direction, float[] startLocation, TransMatrix dicomMatrix)
      Create a level surface extractor for a 3D image.

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      WildMagic.LibGraphics.SceneGraph.TriMesh get​(float iLevel)
      Construct a level surface from the 3D image managed by the extractor.
      WildMagic.LibGraphics.SceneGraph.TriMesh getLevelSurface​(int iLevel, java.util.Vector<int[]> kTriTable)  

      • Methods inherited from class WildMagic.LibImagics.Extraction.ExtractSurfaceTetra

        addTriangle, addVertex, ExtractContour, ExtractContour, getFunction, getGradient, processTetrahedron

      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • Field Detail

      • dicomMatrix

        private TransMatrix dicomMatrix
        Dicom Matrix

      • direction

        private int[] direction
        Surface direction

      • m_fXDelta

        private float m_fXDelta
        Relative voxel size.

      • m_fYDelta

        private float m_fYDelta
        Relative voxel size.

      • m_fZDelta

        private float m_fZDelta
        Relative voxel size.

      • startLocation

        private float[] startLocation
        Surface 3D location

    • Constructor Detail

      • SurfaceExtractor

        public SurfaceExtractor​(int iXBound,
                        int iYBound,
                        int iZBound,
                        int[] aiData,
                        float fXDelta,
                        float fYDelta,
                        float fZDelta,
                        int[] direction,
                        float[] startLocation,
                        TransMatrix dicomMatrix)
        Create a level surface extractor for a 3D image. The delta input values are important when the voxels are not cubic. For example, a typical MRI might have z-slice spacing about 5 times that of the x and y spacing. In this case, dx = 1, dy = 1, and dz = 5. The idea is that 1 is a 'voxel unit' and the z-slices are spaced by 5 voxel units.
        Parameters:
        iXBound - the number of columns in the 3D image
        iYBound - the number of rows in the 3D image
        iZBound - the number of slices in the 3D image
        aiData - The image data stored in order of slice indices, each slice stored in row-major order. That is, slice z=0 is stored first, slice z=1 is stored next, and so on. In slice z=0, the y=0 row is stored first, the y=1 row is stored next, and so on.
        fXDelta - the relative voxel x-size (in voxel units)
        fYDelta - the relative voxel y-size (in voxel units)
        fZDelta - the relative voxel z-size (in voxel units)
        direction - array of direction factors == 1 or -1.
        startLocation - array of startLocation
        dicomMatrix - DOCUMENT ME!

    • Method Detail

      • get

        public WildMagic.LibGraphics.SceneGraph.TriMesh get​(float iLevel)
        Construct a level surface from the 3D image managed by the extractor.
        Parameters:
        iLevel - the desired level value, in [min(image),max(image)]
        Returns:
        a triangle mesh that represents the level surface

      • getLevelSurface

        public WildMagic.LibGraphics.SceneGraph.TriMesh getLevelSurface​(int iLevel,
                                                                java.util.Vector<int[]> kTriTable)