com.openinventor.ldm

Class SoLDMTileVisitor

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.ldm.SoLDMLargeDataManagement

com.openinventor.ldm.SoLDMTileVisitor

Direct Known Subclasses:

SoLDMProximityVisitor

Deprecated.

As of Open Inventor 9700 See documentation for more details

public class SoLDMTileVisitor
extends SoLDMLargeDataManagement

Tile Visitor. This class is only needed for advanced users who intend to extend or replace internal LDM algorithms.

<font color="#0000FF">NOTE:</font> This class does not exist in Open Inventor 10.0 and later.

The SoLDMTileVisitor allows the user to define a strategy to evaluate what part of the data set is the most important based on viewpoint and geometries. It is responsible for assessing the importance of tiles. This information is used by the node front manager (SoLDMNodeFrontManager) as a predictor to optimally fill the texture memory. When the node front manager evaluates texture node front, it asks the SoLDMTileVisitor for the weight of each tile by calling the getTileWeight function. The SoLDMTileVisitor queries the SoLDMTileManager to find out if the tile is present in main memory. If not, a null weight is returned to ensure the data of all requested textures are in main memory. The SoLDMTileVisitor also queries the SoLDMGeometry node to access geometric information related to the zone of the tile to be weighted.

See also:

SoLDMNodeFrontManager, SoLDMTileManager, SoLDMGeometry, SoLDMResourceManagerDeprecated since Open Inventor 9700
LDM Tile Visitor is no longer used.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SoLDMTileVisitor.NodeStatus Deprecated.

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
SoLDMTileVisitor() Deprecated. Constructor.

Method Summary

Modifier and Type	Method and Description
float	combineParentWeight(float parentWeight, float weight) Deprecated. This function combines the current tile weight with its parent.
float	getCullWeight(float distToScreen) Deprecated. Assigns a weight based on distance to the center of the screen.
float	getROIWeight(int distToROI, float geometryPriority) Deprecated. Assigns a weight based on distance to ROI.
float	getScreenResCullWeight(float voxelsize) Deprecated. Assigns a weight based on voxel size in pixel.
float	getSurfaceGeomWeight(float distToGeom, float geometryPriority) Deprecated. Assigns a weight based on distance to a surface geometry.
float	getVolumeGeomWeight(float distToGeom, float geometryPriority) Deprecated. Assigns a weight based on distance to a data set geometry.
float	isCulled(SbBox3f tileBox) Deprecated. Calls isCulled(tileBox, (int)7).
float	isCulled(SbBox3f tileBox, int cullbits) Deprecated. TODO: doc with graph (default behavior graph) Is the tile culled.
void	valuationChangeNotify() Deprecated. Notify of a change of evaluator (change visitor type).

Methods inherited from class com.openinventor.ldm.SoLDMLargeDataManagement

reset

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

SoLDMTileVisitor

public SoLDMTileVisitor()

Deprecated.

Constructor.

Method Detail

isCulled

public float isCulled(SbBox3f tileBox)

Deprecated.

Calls isCulled(tileBox, (int)7).

isCulled

public float isCulled(SbBox3f tileBox,
                      int cullbits)

Deprecated.

TODO: doc with graph (default behavior graph) Is the tile culled. Takes effect only if SoVolumeRendering.m_viewCulling is true. Returns distance to screen center in screen coordinates if the tile is culled.

valuationChangeNotify

public void valuationChangeNotify()

Deprecated.

Notify of a change of evaluator (change visitor type).

getCullWeight

public float getCullWeight(float distToScreen)

Deprecated.

Assigns a weight based on distance to the center of the screen. May be overridden by the application. distToScreen is the signed distance from the tile considered to the center of the screen in normalized screen coordinate. This functions is called only if the tile is culled. The returned weight must be between 0 and 1. Default returns 0 always.

getROIWeight

public float getROIWeight(int distToROI,
                          float geometryPriority)

Deprecated.

Assigns a weight based on distance to ROI. May be overridden by the application. distToROI is the signed distance from the geometry ROI to a tile in data coordinates. < 0 means the tile is outside the ROI. > 0 means the tile is inside the ROI. = 0 means the tile intersects the ROI. The geometryPriority argument is the weight of the geometry considered. The returned weight must be between 0 and 1. Default returns 1 if the distance is >= 0, else 0.

combineParentWeight

public float combineParentWeight(float parentWeight,
                                 float weight)

Deprecated.

This function combines the current tile weight with its parent. The returned weight must be less than parentWeight. Default multiplies weights.

getVolumeGeomWeight

public float getVolumeGeomWeight(float distToGeom,
                                 float geometryPriority)

Deprecated.

Assigns a weight based on distance to a data set geometry. May be overridden by the application. distToGeom is the signed distance from the data set to the considered tile in data coordinates. < 0 means the tile is outside the data set. > 0 means the tile is inside the data set. = 0 means the tile intersects the data set. (the normal of a geometry plane is oriented towards increasing data (from voxel 0 to 1)) The geometryPriority argument is the weight of the geometry considered. The returned weight must be between 0 and 1. Default returns geometryPriority if the distance is null, else 0.

getScreenResCullWeight

public float getScreenResCullWeight(float voxelsize)

Deprecated.

Assigns a weight based on voxel size in pixel. May be overridden by the application. voxelsize parameter is the size of the biggest voxel dimension for a given tile in pixel. The returned weight must be between 0 and 1. Called only if screen resolution culling is enabled (see SoVolumeRendering, true by default).

getSurfaceGeomWeight

public float getSurfaceGeomWeight(float distToGeom,
                                  float geometryPriority)

Deprecated.

Assigns a weight based on distance to a surface geometry. May be overridden by the application. distToGeom is the signed distance from the surface to the considered tile in data coordinates. < 0 means the tile is behind or outside the geometry. > 0 means the tile is in front of or inside the geometry. = 0 means the tile intersects the geometry. (the normal of a geometry plane is oriented towards increasing data (from voxel 0 to 1)) The geometryPriority argument is the weight of the geometry considered. The returned weight must be between 0 and 1. Default returns geometryPriority if the distance is null, else 0.