com.openinventor.imageviz

Class SbImageDataAdapterHelper

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.imageviz.SbImageDataAdapterHelper

public class SbImageDataAdapterHelper
extends Inventor

Helper class for SoImageDataAdapter. Contains various utility methods.

See also:

SoImageDataAdapter, SoFileDataAdapter, SoMemoryDataAdapter, SoVolumeReaderAdapter

Nested Class Summary

Nested classes/interfaces inherited from class com.openinventor.inventor.Inventor

Inventor.ConstructorCommand

Field Summary

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Method Summary

Modifier and Type	Method and Description
static SoImageDataAdapter	getAppropriateAdapter(java.lang.String filename) Calls getAppropriateAdapter(filename, (long)0).
static SoImageDataAdapter	getAppropriateAdapter(java.lang.String filename, long maxMemory) Loads data and returns a preconfigured SoImageDataAdapter instance based on the given filename extension.
static void	saveToFile(SoImageDataAdapter image, java.lang.String filename) Save given image to a file.
void	setValue(SbImageDataAdapterHelper copyFrom)

Methods inherited from class com.openinventor.inventor.Inventor

dispose, getNativeResourceHandle

Methods inherited from class java.lang.Object

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

Method Detail

getAppropriateAdapter

public static SoImageDataAdapter getAppropriateAdapter(java.lang.String filename)

Calls getAppropriateAdapter(filename, (long)0).

saveToFile

public static void saveToFile(SoImageDataAdapter image,
                              java.lang.String filename)

Save given image to a file. Filetype is determined by filename extension.

Supported formats are:

• .ldm: Supports 2D or 3D image. Note: A VolumeVizLDM or LDMWriter license is required.
• .tif: Supports only 2D images. To save a volume as a stack of tiff files, please use the .lst extension. If given image depth is > 1, an SbException is thrown.
• .lst: If depth is >1, the volume is saved as a sequentially numbered set of TIFF files plus a “.lst” file. This collection of files can be reloaded as a volume by ImageViz or VolumeViz using SoVRRasterStackReader.

Any other file extension will result in throwing an exception. A time series (getSize()[3] > 1) will result in throwing an exception.

This is just a convenience method. Other formats may be written using subclasses of SoRasterImageRW or by accessing the data (see SbImageDataAccessor) and writing explicitly.

setValue

public void setValue(SbImageDataAdapterHelper copyFrom)

getAppropriateAdapter

public static SoImageDataAdapter getAppropriateAdapter(java.lang.String filename,
                                                       long maxMemory)

Loads data and returns a preconfigured SoImageDataAdapter instance based on the given filename extension. If no SoImageDataAdapter is available for this extension or an error occurs, then NULL is returned.

Parameters:

filename - File (or directory) to load

maxMemory - If the data is smaller than the specified maximum memory in MB (default 500 MB), getAppropriateAdapter() will load the data in memory and return an SoMemoryDataAdapter. Access to data will be faster using an SoMemoryDataAdapter than a file based adapter. Returns: If possible (depending on memory limit), returns an SoMemoryDataAdapter object.
If this is not possible, returns an SoFileDataAdapter for simple image formats like JPEG or an SoVolumeReader for complex formats like DICOM (note that this requires initializing the VolumeViz extension!).

Important:

• 'filename' should be a valid filename or pattern.
• A volume dataset can be loaded using a pattern like a simple regular expression.
  e.g.: "/dataset/motor3d/motor_*.jpg"). This implies all images in the generated list should be a part of the same volume.
• The file extension is mandatory except for a DICOM directory.
  Therefore "/dataset/motor3d/*.jpg" is valid but "/dataset/motor3d/*" or "/dataset/motor3d/*.*" isn't.
• Special case for DICOM: "/dataset/head3d/*" is valid, but only if it's a valid DICOM directory and the generated files contain only DICOM parts of the volume.
• If 'maxMemory' is not set, the value of the environment variable IMAGEVIZ_MAX_MEMORY_ADAPTER is used, which is set to 500 MB by default.