com.openinventor.ldm

Class SoLDMTopoOctree

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.ldm.SoLDMTopoOctree

public class SoLDMTopoOctree
extends Inventor

Octree topology queries. The SoLDMTopoOctree class provides information about the hierarchy of LDM tiles used for a given dataset, based on the dataset dimensions.

For example you can query the total number of LDM tiles in the data set. You can also query the ID of the tile that contains a specified voxel/cell in the data set and conversely you can query the extent of a specified tile in voxel/cell coordinates.

In VolumeViz LDM every tile has both a tileID and a fileID. The tileID is the unique identifier of a tile in the (conceptual) complete, symmetrical hierarchy. The fileID is the index of a tile in a sequential numbering of all the tiles that actually contain data. The tileID is normally used to identify tiles in an application, but the fileID is used, for example, when calling the readTile method in an SoVolumeReader class. In a cubical volume (all three dimensions the same), there are equal numbers of tileIDs and fileIDs, but in most volumes there are many fewer fileIDs than tileIDs.

See also:

SoLDMTileID

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

Constructor Summary

Constructors

Constructor and Description
SoLDMTopoOctree() Constructor.

Method Summary

Modifier and Type	Method and Description
int	getFileID(SoLDMTileID tileID) Given a tileID, returns the corresponding fileID.
int	getLevelMax() Return the level max of the Octree.
int	getNumFileIDs() Returns the number of fileIDs in the volume.
SoLDMTileID	getTileID(int fileID) Given a fileID, returns the corresponding tileID.
SoLDMTileID	getTileID(SbVec3i32 cellPos, int resolution) Given the position of a voxel/cell (i,j,k) and the resolution level, returns the tile ID of the corresponding tile.
SbBox3i32	getTilePos(SoLDMTileID tileID) Returns the bounding box, in voxel/cell coordinates, of the specified tile.
SbVec3i32	getTileSize() Return the tilesize used to setup this octree.
void	init(SbVec3i32 dimension, int tileDim) Calls init(dimension, tileDim, (int)0).
void	init(SbVec3i32 dimension, int tileDim, int border) Initialize with the properties of the data set.
boolean	isEmpty() Returns false if the octree is empty.
int	level(long index) Returns the resolution level of the given tile Id Note: Octree must be initialized.
int	level(SoLDMTileID id) Returns the resolution level of the given tile Id Note: Octree must be initialized.

Methods inherited from class com.openinventor.inventor.Inventor

dispose, getAddress, getNativeResourceHandle, startInternalThreads, stopInternalThreads

Methods inherited from class java.lang.Object

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

Constructor Detail

SoLDMTopoOctree

public SoLDMTopoOctree()

Constructor.

Method Detail

init

public void init(SbVec3i32 dimension,
                 int tileDim)

Calls init(dimension, tileDim, (int)0).

init

public void init(SbVec3i32 dimension,
                 int tileDim,
                 int border)

Initialize with the properties of the data set. Note: Since OIV 9.0, the border parameter is no longer used.

getTilePos

public SbBox3i32 getTilePos(SoLDMTileID tileID)

Returns the bounding box, in voxel/cell coordinates, of the specified tile.

getLevelMax

public int getLevelMax()

Return the level max of the Octree. Note: Octree must be initialized

getTileID

public SoLDMTileID getTileID(SbVec3i32 cellPos,
                             int resolution)

Given the position of a voxel/cell (i,j,k) and the resolution level, returns the tile ID of the corresponding tile.

level

public int level(long index)

Returns the resolution level of the given tile Id Note: Octree must be initialized.

getTileSize

public SbVec3i32 getTileSize()

Return the tilesize used to setup this octree.

getNumFileIDs

public int getNumFileIDs()

Returns the number of fileIDs in the volume. Effectively this is the total number of tiles, including both full resolution and low resolution, required to store the data set.

getFileID

public int getFileID(SoLDMTileID tileID)

Given a tileID, returns the corresponding fileID.

isEmpty

public boolean isEmpty()

Returns false if the octree is empty. Note: Octree must be initialized.

level

public int level(SoLDMTileID id)

Returns the resolution level of the given tile Id Note: Octree must be initialized.

getTileID

public SoLDMTileID getTileID(int fileID)

Given a fileID, returns the corresponding tileID.