Doxygen Awesome (original) (raw)

SIM Voleon is a software development system for aiding in writing 3D graphics application containing so-called "volumetric data", as is often used in applications targeted at analysis tasks within the oil & gas industry (e.g. from seismic measurements), in medical imaging (for data generated by e.g. Nuclear Magnetic Resonance, Computer Tomography, or ultrasound equipment), and for many other purposes.

SIM Voleon is an add-on library to Systems in Motion's visualization platform technology, known as "Coin". Coin is a high-level 3D graphics library with a C++ Application Programming Interface. Its target audience is developers of 3D graphics applications worldwide.

The library has the following major features:

It is fully portable over the full range of platforms also supported by the Coin library, including all versions of Microsoft Windows, Mac OS X, Linux, Sun Solaris, SGI IRIX, and most other UNIX variants.
Integrates smoothly with traditional polygonal 3D data visualization from the Coin library, in a manner which is effortless for the application programmer.
Provides interaction possibilities for direct queries in the 3D scene on the volumetric data through picking support.
Volumes are visualized by using functionality which is assisted by dedicated 3D hardware on most modern graphics cards, namely 2D texture mapping.
Higher quality and better performance visualization is automatically done on graphics card which supports hardware assisted 3D texture mapping.
Color transfer functions can be manipulated in real time using either the EXT_paletted_texture or the ARB_fragment_program OpenGL extensions.
Maximum Intensity Projection and Sum Intensity Projection is supported through hardware if available.

Rendering of volumetric data of a spine

Here's a simple usage example, which sets up a complete environment for voxel visualization with the SIM Voleon library:

#include <Inventor/Qt/SoQt.h>

#include <Inventor/Qt/viewers/SoQtExaminerViewer.h>

#include <Inventor/nodes/SoSeparator.h>

#include <VolumeViz/nodes/SoTransferFunction.h>

#include <VolumeViz/nodes/SoVolumeData.h>

#include <VolumeViz/nodes/SoVolumeRender.h>

#include <VolumeViz/nodes/SoVolumeRendering.h>

static uint8_t *

generate8bitVoxelSet(SbVec3s & dim)

{

const size_t blocksize = dim[0] * dim[1] * dim[2];

uint8_t * voxels = new uint8_t[blocksize];

(void)memset(voxels, 0, blocksize);

float t = 0;

while (t < 50) {

SbVec3f v(sin((t + 1.4234) * 1.9) * sin(t) * 0.45 + 0.5,

cos((t * 2.5) - 10) * 0.45 + 0.5,

cos((t - 0.23123) * 3) * sin(t + 0.5) * cos(t) * 0.45 + 0.5);

assert(v[0] < 1.0f && v[1] < 1.0f && v[2] < 1.0f);

const int nx = int(dim[0] * v[0]);

const int ny = int(dim[1] * v[1]);

const int nz = int(dim[2] * v[2]);

const int memposition = nz*dim[0]*dim[1] + ny*dim[0] + nx;

voxels[memposition] = (uint8_t)(255.0 * cos(t));

t += 0.001;

}

return voxels;

}

int

main(int argc, char ** argv)

{

QWidget * window = SoQt::init(argv[0]);

SoSeparator * root = new SoSeparator;

root->ref();

SbVec3s dim = SbVec3s(64, 64, 64);

uint8_t * voxeldata = generate8bitVoxelSet(dim);

volumedata->setVolumeData(dim, voxeldata, SoVolumeData::UNSIGNED_BYTE);

root->addChild(volumedata);

root->addChild(transfunc);

root->addChild(volrend);

SoQtExaminerViewer * viewer = new SoQtExaminerViewer(window);

viewer->setBackgroundColor(SbColor(0.1f, 0.3f, 0.5f));

viewer->setSceneGraph(root);

viewer->show();

SoQt::show(window);

SoQt::mainLoop();

delete viewer;

root->unref();

delete[] voxeldata;

return 0;

}

Contains the transfer function definition.

Definition SoTransferFunction.h:44

The main interface for setting up volume data sets.

Definition SoVolumeData.h:54

void setVolumeData(const SbVec3s &dimension, void *data, SoVolumeData::DataType type=SoVolumeData::UNSIGNED_BYTE, int significantbits=0)

Definition VolumeData.cpp:410

Render the full volume.

Definition SoVolumeRender.h:47

static void init(void)

Definition VolumeRendering.cpp:327

Hardware requirements:

SIM Voleon can render volumes using both 2D and 3D textures. The former will demand three times more texture memory than the latter, due to the static axis alignment for the volume slices. 3D textures provide the best rendering quality.
SIM Voleon will do a performance test of the host system's graphics card at startup to determine whether the 3D texture support, if present, is hardware accelerated or not. If the support is not hardware accelerated (which is the case with many older cards), SIM Voleon will fall back to regular 2D texture rendering.
Beware that certain nodes requires 3D texture support in the OpenGL driver to function properly (e.g. SoObliqueSlice), but does not demand hardware acceleration of 3D-texturing to be present. Required 3D-texture support was included in the OpenGL specification starting with version 1.2, and it had additionally been present in the form of vendor and ARB extensions for some time before that. At the present day, the chances of running on a system without 3D texture support should therefore be small.
Due to the fact that volume data sets are usually quite large, memory is an important factor for volume rendering. It is also important to remember that 2D texture rendering requires three times more memory than 3D texture rendering. For large datasets, available graphics card memory is currently the main bottleneck for SIM Voleon.
SIM Voleon will take advantage of the EXT_paletted_texture or the ARB_fragment_program OpenGL extension if available for paletted rendering. If neither of these extensions are present, all data sets will be converted into RGBA textures before uploaded by OpenGL, multiplying the memory usage by four.

SIMVoleon

SIM Voleon does currently support loading of VOL files, which is a format introduced by the book "Introduction To Volume Rendering", by Lichtenbelt, Crane and Naqvi (Hewlett-Packard / Prentice Hall), ISBN 0-13-861683-3. (See the SoVRVolFileReader class doc for info). Support for more file formats can be added by extending the SoVolumeReader class.

Beware that large voxel sets are divided into sub cubes. The largest default sub cube size is by default set to 128x128x128, to match the TGS VolumeViz API. Current graphics cards can do much larger textures than this, achieving a higher frame rate due to the reduced overhead of sub cube switching and slicing. A graphics card with 128+ MB and true hardware 3D texture support can easily handle voxel sets of size 256x256x256. Increasing the maximum sub cube size can really boost the performance if your graphics card can handle it. Call SoVolumeData::setPageSize(const SbVec3s & size) to adjust the maximum sub cube size. Keep in mind that allowing really large 3D textures might cause other textures to be swapped out of graphics memory, leading to reduced performance.