SoLDMGlobalResourceParameters

java.lang.Object
- com.openinventor.inventor.Inventor
- - com.openinventor.ldm.SoLDMGlobalResourceParameters

```
public class SoLDMGlobalResourceParameters
extends Inventor
```
Global resource parameters for LDM. This class contains functions for controlling global resource parameters for the LDM module.
For extensions that use the LDM module, particularly VolumeViz, these parameters can have a significant effect on resource usage (primarily memory) and rendering performance.
Memory management
This class allows the application to specify how much CPU and GPU memory VolumeViz can use to load data and textures. By default the main memory and texture memory limits are set to a percentage of the total available system and GPU memory (see the setMaxMainMemory() and setMaxTexMemory() methods). Applications can use the SoCpuDevice and SoGLDevice classes to query the total and available memory on the CPU and GPU. There is an additional memory allocation for the BufferObject cache described below. How VolumeViz uses CPU memory depends on the data source (tiled or not tiled), the tile cache policy (see setTileCacheType() method) and the SoPreferences variable LDM_USE_IN_MEM_COMPRESSION.
Tiles:
VolumeViz uses a data manager called LDM to manage volume data. LDM manages volume data in chunks called "tiles". If the volume size is larger than the tile size, then there are two classes of tile: full-resolution tiles containing actual data values and low-resolution tiles containing sub-sampled data values. The application may have native data that is already tiled or the data may be pre-processed to create tiles and store them in the LDM file format. In an LDM format file the tiles may optionally be compressed to save disk space and memory, but in this case, the tiles must be expanded before sending to the GPU. If the data is not tiled, for example disk formats like DICOM and SEGY or an in-memory volume, then tiles must be created in memory at runtime.
Tile size:
Note that the default tile size is small and generally you wll get better performance with non-tiled data by explicitly setting a larger tile size (see the ldmResourceParameters field and SoLDMResourceParameters.tileDimension). If the volume size is 512^3 or less then the tile size may be set to the volume size to avoid the overhead of tiling. Do not set the tile size larger than 512 for a volume data set. However, if the volume is actually a large "image", i.e. the Z dimension is 1, then setting the tile size to 1024 may improve performance.
Caches:
LDM allocates CPU memory for the CPU Tile Cache and the secondary BufferObject cache. The CPU tile cache is normally as large as needed or other memory requirements allow. If the volume is larger than the available or allowed CPU memory, then LDM keeps the "most important" tiles in memory (importance is determined by various heuristics set in this class and in SoLDMResourceParameters). The BufferObject cache is normally small and is used to temporarily store tiles that are created by LDM at run-time.
- CPU Tile Cache (main memory)
  VolumeViz uses this amount of CPU memory as the primary cache for LDM data tiles. The main memory limit is set in megabytes using the setMaxMainMemory() method. If the data set is small enough to fit in system memory, then generally the memory limit should be set high enough to allow this. If the data set is larger than system memory, then the memory limit should be set as high as possible without impacting the application's other needs for memory. If the tile size is (for example) 64 and each voxel is a float value, then each tile requires approximately 1 MB of system memory. However since Open Inventor 8.5, the system memory requirement is reduced for compressed LDM tiles (stored compressed) and for uniform tiles (stored as a single value).
  
  When there are multiple LDM data sets, by default each data set receives getMaxMainMemory() divided by the number of datasets. Each time a new data set is created the per-dataset value is recomputed and some memory is taken away from existing data sets. Note: This default allocation of memory to multiple data sets is not optimal if the data sets have significantly different sizes. For example the memory required for a height field is normally much less than for a volume. In this case the application can explicitly allocate memory to each data set using the maxMainMemory field of the SoLDMResourceParameters object associated with the data set (see the SoDataSet.ldmResourceParameters field).
- GPU Tile Cache (texture memory)
  VolumeViz uses this amount of GPU memory to cache LDM data tiles on the GPU. The texture memory limit is set in megabytes using the setMaxTexMemory() method. This value can also be set separately for each data set using SoLDMResourceParameters.
  
  Warning Some systems combine GPU memory and CPU memory. If 4GB are allocated on CPU and 4GB on GPU, the system may see a total amount of 8GB of private memory used by the process, which can lead to out of memory errors or swapping issues. When dealing with such issues, it is best to ensure that the total amount of memory allocated on both CPU and GPU by the program is lower than the available CPU memory.
- BufferObject cache
  In some cases LDM needs to create tiles on-the-fly at runtime. To reduce memory usage and avoid duplicating application data, these created tiles are considered temporary and are stored in the BufferObject cache. This is a secondary cache that is separate from, and in addition to, the CPU tile cache (main memory). How the BufferObject cache is used depends on the data source (tiled or not) and the tile caching policy (see setTileCacheType()).
  
  For example when compressed tiles are loaded from an LDM format file, they are stored in the CPU tile cache still compressed (to reduce the memory requirement). When the tile data is needed to send data to the GPU, a temporary uncompressed tile is created and stored in the BufferObject cache. The BufferObject cache is also used to expand uniform tiles, which are stored in the LDM file and in memory as a single value.
  
  For non-tiled data (e.g. SEGY or DICOM or in-memory volume), depending on the tile cache policy, tiles are created from the source data when needed to send data to the GPU and temporarily stored in the BufferObject cache.
  
  The BufferObject cache size can only be set using the SoPreferences variable OIV_BUFFER_OBJECT_CACHE_SIZE. The size is set in number of tiles (not amount of memory) so the actual size of this cache depends on both the tile size and the data type size, i.e. it is larger for floating point data than for byte data. The default size is 50 tiles. The BufferObject cache size can only be set globally, not for each data set. The BufferObject cache was added in Open Inventor version 8.5.
See also:
SoDataSet, SoVolumeData, SoLDMResourceParameters

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static interface`	`SoLDMGlobalResourceParameters.LoadListener` Loading callback for LDM mode.
`static class`	`SoLDMGlobalResourceParameters.TileCacheTypes` Deprecated.
`static class`	`SoLDMGlobalResourceParameters.VisualFeedbackParams` Visual feedback modes.

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

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`ALL` Deprecated. Use `SoLDMGlobalResourceParameters.TileCacheTypes.ALL` instead.
`static int`	`DRAW_SLICES_TEX` Deprecated. Use `SoLDMGlobalResourceParameters.VisualFeedbackParams.DRAW_SLICES_TEX` instead.
`static int`	`DRAW_TILE_OUTLINE` Deprecated. Use `SoLDMGlobalResourceParameters.VisualFeedbackParams.DRAW_TILE_OUTLINE` instead.
`static int`	`DRAW_TILES` Deprecated. Use `SoLDMGlobalResourceParameters.VisualFeedbackParams.DRAW_TILES` instead.
`static int`	`DRAW_TOPOLOGY` Deprecated. Use `SoLDMGlobalResourceParameters.VisualFeedbackParams.DRAW_TOPOLOGY` instead.
`static int`	`FULLRES_ONLY` Deprecated. Use `SoLDMGlobalResourceParameters.TileCacheTypes.FULLRES_ONLY` instead.
`static int`	`LOWRES_ONLY` Deprecated. Use `SoLDMGlobalResourceParameters.TileCacheTypes.LOWRES_ONLY` instead.
`static int`	`NONE` Deprecated. Use `SoLDMGlobalResourceParameters.TileCacheTypes.NONE` instead.
`static int`	`SHOW_LOAD_UNLOAD_TILES` Deprecated. Use `SoLDMGlobalResourceParameters.VisualFeedbackParams.SHOW_LOAD_UNLOAD_TILES` instead.
`static int`	`SHOW_TILES_VALUATED` Deprecated. Use `SoLDMGlobalResourceParameters.VisualFeedbackParams.SHOW_TILES_VALUATED` instead.
`static int`	`USE_FAKE_DATA` Deprecated. Use `SoLDMGlobalResourceParameters.VisualFeedbackParams.USE_FAKE_DATA` instead.

Fields inherited from class com.openinventor.inventor.Inventor
VERBOSE_LEVEL, ZeroHandle

Method Summary

All Methods Static Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`static void`	`addLoadListener(SoLDMGlobalResourceParameters.LoadListener listener)` Sets a callback to be called with the loading state.
`static long`	`getDefaultMaxMainMem()` Returns the default maximum system (CPU) memory in MB.
`static long`	`getDefaultMaxTex2D()` Deprecated. As of Open Inventor 9500 See documentation for more details
`static long`	`getDefaultMaxTexMem()` Returns the default maximum GPU memory in MB.
`static boolean`	`getIgnoreFullyTransparentTiles()` Returns the IgnoreFullyTransparentTiles flag.
`static int`	`getLoadNotificationRate()` Returns the load notification rate.
`static long`	`getMax2DTexMemory()` Get the maximum number of 2D textures allowed to be loaded.
`static int`	`getMax2DTextures()` Deprecated. As of Open Inventor 9500 See documentation for more details
`static int`	`getMaxMainMemory()` Returns the maximum main memory in MB for all the VolumeViz data sets.
`static int`	`getMaxNumTriangles()` Deprecated. As of Open Inventor 9700 See documentation for more details
`static int`	`getMaxTexMemory()` Returns the maximum texture memory in MB for all the VolumeViz data sets.
`static boolean`	`getMoveLowResolution()` Deprecated. As of Open Inventor 9610 See documentation for more details
`static int`	`getNumIO()` Returns the current number of loading threads.
`static boolean`	`getScreenResolutionCulling()` Returns the screen resolution culling state.
`static boolean`	`getSliceEqualResolution()` Returns the slice equal resolution flag.
`static int`	`getTex2LoadRate()` Returns the maximum number of 2D textures allowed to be loaded into texture memory per frame for all the VolumeViz data sets.
`static int`	`getTex3LoadRate()` Returns the maximum number of tiles (3D textures) allowed to be downloaded into texture (GPU) memory per frame for all the VolumeViz data sets.
`static SoLDMGlobalResourceParameters.TileCacheTypes`	`getTileCacheType()` Deprecated. As of Open Inventor 9630 See documentation for more details
`static boolean`	`getViewCulling()` Returns the view culling flag.
`static boolean`	`getViewpointRefinement()` Returns the viewpoint refinement flag.
`static boolean`	`getVisualFeedbackParam(SoLDMGlobalResourceParameters.VisualFeedbackParams param)` Returns the state of the specified visual feedback parameter.
`static void`	`removeLoadListener(SoLDMGlobalResourceParameters.LoadListener listener)`
`static void`	`setIgnoreFullyTransparentTiles(boolean state)` Sets the IgnoreFullyTransparentTiles flag.
`static void`	`setLoadNotificationRate(int name_17513)` Sets the load notification rate (number of tiles).
`static void`	`setMax2DTexMemory(long maxMemory)` Sets the maximum 2D texture GPU memory in MB allowed to be loaded for all VolumeViz data sets.
`static void`	`setMax2DTextures(int numTextures)` Deprecated. As of Open Inventor 9500 See documentation for more details
`static void`	`setMaxMainMemory(int maxMainMemory)` Sets the maximum main (CPU) memory, in MB, to use for all VolumeViz data sets.
`static void`	`setMaxNumTriangles(int maxNumTriangles)` Deprecated. As of Open Inventor 9700 See documentation for more details
`static void`	`setMaxTexMemory(int maxTexMemory)` Sets the maximum texture (GPU) memory, in MB, for all VolumeViz data sets.
`static void`	`setMoveLowResolution(boolean state)` Deprecated. As of Open Inventor 9610 See documentation for more details
`static void`	`setNumIO(int numIO)` Sets how many simultaneous tile loading threads to use if multi I/O mode is on (it is on when LDM mode is on).
`static void`	`setScreenResolutionCulling(boolean flag)` Sets the screen resolution culling flag.
`static void`	`setSliceEqualResolution(boolean state)` Calls setSliceEqualResolution(state, true).
`static void`	`setSliceEqualResolution(boolean state, boolean forceRedraw)` Sets the slice equal resolution flag.
`static void`	`setTex2LoadRate(int loadRate)` Sets the maximum number of 2D textures allowed to be downloaded into texture (GPU) memory per frame (render traversal) for all the VolumeViz data sets.
`static void`	`setTex3LoadRate(int loadRate)` Sets the maximum number of 3D textures allowed to be downloaded into texture (GPU) memory, per frame (render traversal), for all VolumeViz data sets.
`static void`	`setTileCacheType(SoLDMGlobalResourceParameters.TileCacheTypes cacheType)` Deprecated. As of Open Inventor 9630 See documentation for more details
`static void`	`setViewCulling(boolean state)` Calls setViewCulling(state, true).
`static void`	`setViewCulling(boolean state, boolean forceRedraw)` Sets the view culling flag.
`static void`	`setViewpointRefinement(boolean state)` Sets the viewpoint refinement flag.
`static void`	`setVisualFeedbackParam(SoLDMGlobalResourceParameters.VisualFeedbackParams param, boolean state)` Sets the specified visual feedback parameter to true or false.

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

- Field Detail
  - DRAW_TILES
```
@Deprecated
public static final int DRAW_TILES
```
    Deprecated. Use SoLDMGlobalResourceParameters.VisualFeedbackParams.DRAW_TILES instead.
  - DRAW_SLICES_TEX
```
@Deprecated
public static final int DRAW_SLICES_TEX
```
    Deprecated. Use SoLDMGlobalResourceParameters.VisualFeedbackParams.DRAW_SLICES_TEX instead.
  - DRAW_TOPOLOGY
```
@Deprecated
public static final int DRAW_TOPOLOGY
```
    Deprecated. Use SoLDMGlobalResourceParameters.VisualFeedbackParams.DRAW_TOPOLOGY instead.
  - DRAW_TILE_OUTLINE
```
@Deprecated
public static final int DRAW_TILE_OUTLINE
```
    Deprecated. Use SoLDMGlobalResourceParameters.VisualFeedbackParams.DRAW_TILE_OUTLINE instead.
  - SHOW_TILES_VALUATED
```
@Deprecated
public static final int SHOW_TILES_VALUATED
```
    Deprecated. Use SoLDMGlobalResourceParameters.VisualFeedbackParams.SHOW_TILES_VALUATED instead.
  - SHOW_LOAD_UNLOAD_TILES
```
@Deprecated
public static final int SHOW_LOAD_UNLOAD_TILES
```
    Deprecated. Use SoLDMGlobalResourceParameters.VisualFeedbackParams.SHOW_LOAD_UNLOAD_TILES instead.
  - USE_FAKE_DATA
```
@Deprecated
public static final int USE_FAKE_DATA
```
    Deprecated. Use SoLDMGlobalResourceParameters.VisualFeedbackParams.USE_FAKE_DATA instead.
  - NONE
```
@Deprecated
public static final int NONE
```
    Deprecated. Use SoLDMGlobalResourceParameters.TileCacheTypes.NONE instead.
  - FULLRES_ONLY
```
@Deprecated
public static final int FULLRES_ONLY
```
    Deprecated. Use SoLDMGlobalResourceParameters.TileCacheTypes.FULLRES_ONLY instead.
  - ALL
```
@Deprecated
public static final int ALL
```
    Deprecated. Use SoLDMGlobalResourceParameters.TileCacheTypes.ALL instead.
  - LOWRES_ONLY
```
@Deprecated
public static final int LOWRES_ONLY
```
    Deprecated. Use SoLDMGlobalResourceParameters.TileCacheTypes.LOWRES_ONLY instead.
- Method Detail
  - addLoadListener
```
public static void addLoadListener(SoLDMGlobalResourceParameters.LoadListener listener)
```
    Sets a callback to be called with the loading state. The callback function is called with TRUE when the process starts loading, and with FALSE when loading is complete. NOTE: This feature is available with VolumeVizLDM only.
  - removeLoadListener
```
public static void removeLoadListener(SoLDMGlobalResourceParameters.LoadListener listener)
```
  - setViewCulling
```
public static void setViewCulling(boolean state)
```
    Calls setViewCulling(state, true).
  - setSliceEqualResolution
```
public static void setSliceEqualResolution(boolean state)
```
    Calls setSliceEqualResolution(state, true).
  - setMax2DTextures
```
@Deprecated
public static void setMax2DTextures(int numTextures)
```
    Deprecated. As of Open Inventor 9500 See documentation for more details
    
    Sets the maximum number of 2D textures allowed to be loaded for all VolumeViz data sets.
    The sum of each number of 2D textures allowed per data set (see SoLDMResourceParameters.max2DTextures field) must be less than or equal to this value. The total amount of GPU memory allowed is set using the setMaxTexMemory method. This method limits the amount of GPU memory that can be used by (for example) SoOrthoSlice and SoVolumeSkin nodes. This can be useful when combining slices and volume rendering because the 3D textures used by volume rendering require much more GPU memory. Default (since Open Inventor 8.1) is 5% of total GPU memory Deprecated. Use setMax2DTexMemory instead.Deprecated since Open Inventor 9500
    No longer used. Will be removed in OIV10.
  - setTex3LoadRate
```
public static void setTex3LoadRate(int loadRate)
```
    Sets the maximum number of 3D textures allowed to be downloaded into texture (GPU) memory, per frame (render traversal), for all VolumeViz data sets.
    You can set this parameter separately for each data set using field SoLDMResourceParameter.tex3LoadRate. Default is 10 3D textures (effectively 3 tiles) per render traversal.
    Each tile needed for volume rendering (SoVolumeRender) and volume geometry must be transfered to GPU memory as a 3D texture. So, for example, transfering 1000 tiles at the default loadRate (10) requires 100 frames. (How many seconds this takes depends on the frames per second possible, which in turn depends on many factors including the complexity of the scene graph.) Increasing the loadRate value reduces the number of frames required to reach maximum resolution. But the render traversal has to wait for the data transfer to finish, so each frame may take longer to render, increasing the total time to reach maximum resolution.
  - getMax2DTextures
```
@Deprecated
public static int getMax2DTextures()
```
    Deprecated. As of Open Inventor 9500 See documentation for more details
    
    Get the maximum number of 2D textures allowed to be loaded. Deprecated. Use getMax2DTexMemory instead. See #setMax2DTextures.Deprecated since Open Inventor 9500
    No longer used. Will be removed in OIV10.
  - getMaxTexMemory
```
public static int getMaxTexMemory()
```
    Returns the maximum texture memory in MB for all the VolumeViz data sets. See setMaxTexMemory.
  - setMax2DTexMemory
```
public static void setMax2DTexMemory(long maxMemory)
```
    Sets the maximum 2D texture GPU memory in MB allowed to be loaded for all VolumeViz data sets.
    The sum of 2D texture memory allowed per data set (see SoLDMResourceParameters.max2DTextures field) must be less than or equal to this value. The total amount of GPU memory allowed is set using the setMaxTexMemory method. This method limits the amount of GPU memory that can be used by (for example) SoOrthoSlice and SoVolumeSkin nodes. This can be useful when combining slices and volume rendering because the 3D textures used by volume rendering require much more GPU memory. Default is 5% of GPU memory available at application startup.
  - setTex2LoadRate
```
public static void setTex2LoadRate(int loadRate)
```
    Sets the maximum number of 2D textures allowed to be downloaded into texture (GPU) memory per frame (render traversal) for all the VolumeViz data sets.
    You can set this parameter separately for each data set using field SoLDMResourceParameter.tex2LoadRate. Default is 640 2D textures per frame.
    Each tile needed to render a slice (SoOrthoSlice, SoVolumeSkin, etc) must be loaded into GPU memory as a 2D texture. Increasing the loadRate value reduces the number of frames required to reach maximum resolution. But the render traversal has to wait for the data transfer to finish, so each frame may take longer to render, increasing the total time to reach maximum resolution.
  - getMax2DTexMemory
```
public static long getMax2DTexMemory()
```
    Get the maximum number of 2D textures allowed to be loaded. See setMax2DTexMemory.
  - getTex3LoadRate
```
public static int getTex3LoadRate()
```
    Returns the maximum number of tiles (3D textures) allowed to be downloaded into texture (GPU) memory per frame for all the VolumeViz data sets. See setTex3LoadRate().
  - getMoveLowResolution
```
@Deprecated
public static boolean getMoveLowResolution()
```
    Deprecated. As of Open Inventor 9610 See documentation for more details
    
    Returns the move low resolution flag. See setMoveLowResolution().Deprecated since Open Inventor 9610
    No longer used. Use SoLDMResourceParameters' LoadPolicy field instead.
  - setMaxMainMemory
```
public static void setMaxMainMemory(int maxMainMemory)
```
    Sets the maximum main (CPU) memory, in MB, to use for all VolumeViz data sets.
    You can also set the maximum main memory for each data set separately using the maxMainMemory field of the data set's SoLDMResourceParameters object (see SoDataSet.ldmResourceParameters). The sum of all per data set values must be less than or equal to the value set here.
    Default (since Open Inventor 8.1) is 50% of total CPU memory up to 70% of free memory. See SoCpuDevice to query available CPU memory.
  - setMaxNumTriangles
```
@Deprecated
public static void setMaxNumTriangles(int maxNumTriangles)
```
    Deprecated. As of Open Inventor 9700 See documentation for more details
    
    Sets the maximum number of triangles allowed to be rendered for all VolumeViz render nodes. The default value is zero, which means there is no limit.
    Note: Starting with Open Inventor version 9.4, the default height field rendering algorithm (SoHeightFieldRender) does not use this parameter. The number of triangles rendered is controlled by the current complexity setting (SoComplexity). The sum of the max triangles values per data set (see SoLDMResourceParameters.maxNumTriangles field) must be less or equal to this value. This is an approximate value because some nodes using this parameter draw indivisible chunks of triangles. Particularly useful for limiting the number of triangles generated by SoHeightFieldRender.Deprecated since Open Inventor 9700
    maxNumTriangles is no longer used by SoHeightFieldRender. Number of triangles is controlled by the node SoComplexity.
  - getMaxNumTriangles
```
@Deprecated
public static int getMaxNumTriangles()
```
    Deprecated. As of Open Inventor 9700 See documentation for more details
    
    Get the maximum number of triangles allowed to be rendered for all VolumeViz render nodes. See #setMaxNumTriangles.Deprecated since Open Inventor 9700
    maxNumTriangles is no longer used by SoHeightFieldRender. Number of triangles is controlled by the node SoComplexity.
  - getDefaultMaxTex2D
```
@Deprecated
public static long getDefaultMaxTex2D()
```
    Deprecated. As of Open Inventor 9500 See documentation for more details
    
    Returns the default maximum number of 2D textures. Deprecated since Open Inventor 9500
    No longer used. Will be removed in OIV10.
  - setMaxTexMemory
```
public static void setMaxTexMemory(int maxTexMemory)
```
    Sets the maximum texture (GPU) memory, in MB, for all VolumeViz data sets.
    You can also set the maximum texture memory for each data set separately using the maxTexMemory field of the data set's SoLDMResourceParameters object (see SoDataSet.ldmResourceParameters). The sum of all per data set values must be less than or equal to the value set here.
    Default is 75% of GPU memory available at application startup. See SoGLDevice to query available GPU memory.
  - setMoveLowResolution
```
@Deprecated
public static void setMoveLowResolution(boolean state)
```
    Deprecated. As of Open Inventor 9610 See documentation for more details
    
    Sets the low resolution when moving flag. Default is false. When true, lower resolution tiles are automatically used while the camera is moving (e.g. when user is panning and rotating.Deprecated since Open Inventor 9610
    No longer used. Use SoLDMResourceParameters' LoadPolicy field instead.
  - getMaxMainMemory
```
public static int getMaxMainMemory()
```
    Returns the maximum main memory in MB for all the VolumeViz data sets. See setMaxMainMemory.
  - setViewpointRefinement
```
public static void setViewpointRefinement(boolean state)
```
    Sets the viewpoint refinement flag. Default is true. When true, tile refinement depends on the viewpoint. In other words, tiles closer to the camera have higher priority and higher resolution data will be loaded for closer tiles first. This can be useful for large volumes that cannot be completely loaded in memory.
  - setViewCulling
```
public static void setViewCulling(boolean state,
                                  boolean forceRedraw)
```
    Sets the view culling flag. Default is true. When true, only tiles that are inside the view frustum (i.e. visible) will be loaded and conversely tiles that are outside the view frustum may be discarded.
  - getTileCacheType
```
@Deprecated
public static SoLDMGlobalResourceParameters.TileCacheTypes getTileCacheType()
```
    Deprecated. As of Open Inventor 9630 See documentation for more details
    
    Returns the LDM tile cache setting. See setTileCacheType().Deprecated since Open Inventor 9630
    Moved to SoLDMResourceParameters in OIV 10.
  - setTileCacheType
```
@Deprecated
public static void setTileCacheType(SoLDMGlobalResourceParameters.TileCacheTypes cacheType)
```
    Deprecated. As of Open Inventor 9630 See documentation for more details
    
    Specifies how LDM will cache tiles in memory.
    Default is FULLRES_ONLY. See the TileCacheType enum description and the Memory Management section for more information.
    This setting is global and affects all volume data sets.
    Setting the SoPreferences variable LDM_USE_IN_MEM_COMPRESSION to false (zero) effectively sets the tile cache type to mode ALL.
    Added in Open Inventor 8.5.Deprecated since Open Inventor 9630
    Moved to SoLDMResourceParameters in OIV 10.
  - getViewpointRefinement
```
public static boolean getViewpointRefinement()
```
    Returns the viewpoint refinement flag. See setViewpointRefinement().
  - setScreenResolutionCulling
```
public static void setScreenResolutionCulling(boolean flag)
```
    Sets the screen resolution culling flag. Default is false. When true, only tiles for which the projection of a voxel is greater than or equal to 1 pixel on screen will be loaded. This avoids unnecessary loading of high resolution data for large volumes. However if you "zoom out" from a volume, it does not force lower resolution tiles to be used (high resolution tiles already in memory will still be used). If necessary use the SoLDMResourceParameters.fixedResolution field to force use of lower resolution tiles.
  - getScreenResolutionCulling
```
public static boolean getScreenResolutionCulling()
```
    Returns the screen resolution culling state. See setScreenResolutionCulling().
  - setIgnoreFullyTransparentTiles
```
public static void setIgnoreFullyTransparentTiles(boolean state)
```
    Sets the IgnoreFullyTransparentTiles flag. Default is false. When true, tiles for which all voxels between their min and max values are fully transparent (alpha = 0) will not be refined. In other words a low resolution version will always be used. This can reduce memory requirements for volumes with significant "empty space".
  - getIgnoreFullyTransparentTiles
```
public static boolean getIgnoreFullyTransparentTiles()
```
    Returns the IgnoreFullyTransparentTiles flag. See setIgnoreFullyTransparentTiles().
  - getViewCulling
```
public static boolean getViewCulling()
```
    Returns the view culling flag. See setViewCulling().
  - setSliceEqualResolution
```
public static void setSliceEqualResolution(boolean state,
                                           boolean forceRedraw)
```
    Sets the slice equal resolution flag. Default is false. When true, slice primitives, e.g. SoOrthoSlice and SoObliqueSlice, are always rendered using a set of tiles at the same resolution level. This avoids potentially distracting visual effects caused by mixing tiles of different resolution on the same slice. But it means that the slice will be rendered at a lower resolution if it is not possible to load every tile needed for the higher resolution. When false and viewpoint refinement is enabled, higher resolution tiles will be loaded for portions of the slice closer to the camera even if it is not possible to load every high resolution tile.
    An alternative strategy is to enable the SoSlice.largeSliceSupport field. When large slice support is enabled, if all the required full resolution tiles have already been loaded, then the slice data is taken from LDM cache memory as usual. But if some required tiles are not currently in memory, the full resolution slice data will be loaded directly from the volume reader without loading the complete tiles. This reduces disk I/O and reduces the amount of system memory required to display the slice at full resolution, so larger (or more) slices can be displayed.
  - setNumIO
```
public static void setNumIO(int numIO)
```
    Sets how many simultaneous tile loading threads to use if multi I/O mode is on (it is on when LDM mode is on). The IVVR_NUM_LOADERS preference (see SoPreference) lets you choose the initial number of loading threads at launch. Changing this preference at runtime will not affect the actual number of loading threads, use this method instead. If this preference is not set, the default is 4.
    The IVVR_MAX_NUM_LOADERS preference lets you set a maximum number of tile loading threads. If this method is called with a larger number, the number of loading threads will be set to the maximum instead. If this preference is not set, the maximum is 20.
  - getLoadNotificationRate
```
public static int getLoadNotificationRate()
```
    Returns the load notification rate. See setLoadNotificationRate().
  - getDefaultMaxTexMem
```
public static long getDefaultMaxTexMem()
```
    Returns the default maximum GPU memory in MB.
  - getDefaultMaxMainMem
```
public static long getDefaultMaxMainMem()
```
    Returns the default maximum system (CPU) memory in MB.
  - getTex2LoadRate
```
public static int getTex2LoadRate()
```
    Returns the maximum number of 2D textures allowed to be loaded into texture memory per frame for all the VolumeViz data sets. See setTex2LoadRate().
  - getSliceEqualResolution
```
public static boolean getSliceEqualResolution()
```
    Returns the slice equal resolution flag. See setSliceEqualResolution().
  - getVisualFeedbackParam
```
public static boolean getVisualFeedbackParam(SoLDMGlobalResourceParameters.VisualFeedbackParams param)
```
    Returns the state of the specified visual feedback parameter.
  - setVisualFeedbackParam
```
public static void setVisualFeedbackParam(SoLDMGlobalResourceParameters.VisualFeedbackParams param,
                                          boolean state)
```
    Sets the specified visual feedback parameter to true or false.
  - getNumIO
```
public static int getNumIO()
```
    Returns the current number of loading threads. See setNumIO().
  - setLoadNotificationRate
```
public static void setLoadNotificationRate(int name_17513)
```
    Sets the load notification rate (number of tiles). When rate new tiles have been loaded in main memory, a redraw will be scheduled. This is useful because tiles are loaded asynchronously using multiple threads. The default is 50 tiles. Which means, for example, if each voxel is one byte and the tileSize is 64x64x64, a redraw will be scheduled whenever 13 MB of data has been loaded.

Class SoLDMGlobalResourceParameters

Nested Class Summary

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

Field Summary

Fields inherited from class com.openinventor.inventor.Inventor

Method Summary

Methods inherited from class com.openinventor.inventor.Inventor

Methods inherited from class java.lang.Object

Field Detail

DRAW_TILES

DRAW_SLICES_TEX

DRAW_TOPOLOGY

DRAW_TILE_OUTLINE

SHOW_TILES_VALUATED

SHOW_LOAD_UNLOAD_TILES

USE_FAKE_DATA

NONE

FULLRES_ONLY

ALL

LOWRES_ONLY

Method Detail

addLoadListener

removeLoadListener

setViewCulling

setSliceEqualResolution

setMax2DTextures

setTex3LoadRate

getMax2DTextures

getMaxTexMemory

setMax2DTexMemory

setTex2LoadRate

getMax2DTexMemory

getTex3LoadRate

getMoveLowResolution

setMaxMainMemory

setMaxNumTriangles

getMaxNumTriangles

getDefaultMaxTex2D

setMaxTexMemory

setMoveLowResolution

getMaxMainMemory

setViewpointRefinement

setViewCulling

getTileCacheType

setTileCacheType

getViewpointRefinement

setScreenResolutionCulling

getScreenResolutionCulling

setIgnoreFullyTransparentTiles

getIgnoreFullyTransparentTiles

getViewCulling

setSliceEqualResolution

setNumIO

getLoadNotificationRate

getDefaultMaxTexMem

getDefaultMaxMainMem

getTex2LoadRate

getSliceEqualResolution

getVisualFeedbackParam

setVisualFeedbackParam

getNumIO

setLoadNotificationRate