SoConverterParameters

java.lang.Object
- com.openinventor.inventor.Inventor
- - com.openinventor.ldm.converters.SoConverterParameters

```
public class SoConverterParameters
extends Inventor
```
Container class for LDM converter parameters. This class provides a convenient way to specify parameters for the LDM converter.
See also:
SoConverter

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class SoConverterParameters.ParametersErrors

static class SoConverterParameters.SampleTypes
- Nested classes/interfaces inherited from class com.openinventor.inventor.Inventor
  Inventor.ConstructorCommand

Nested Classes
Modifier and Type	Class and Description
`static class`	`SoConverterParameters.ParametersErrors`
`static class`	`SoConverterParameters.SampleTypes`

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`AVERAGE` Deprecated. Use `SoConverterParameters.SampleTypes.AVERAGE` instead.
`static int`	`DECIMATION` Deprecated. Use `SoConverterParameters.SampleTypes.DECIMATION` instead.
`static int`	`PARAM_ERROR` Deprecated. Use `SoConverterParameters.ParametersErrors.PARAM_ERROR` instead.
`static int`	`PARAM_NO_ERROR` Deprecated. Use `SoConverterParameters.ParametersErrors.PARAM_NO_ERROR` instead.

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

Constructor Summary

Constructors
Constructor and Description

SoConverterParameters()
Default constructor.

Constructors
Constructor and Description
`SoConverterParameters()` Default constructor.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`static SoConverterParameters`	`create(int argc, java.lang.String[] argv)` Deprecated. As of Open Inventor 9.3, use `create(String[])` instead.
`static SoConverterParameters`	`create(java.lang.String[] argv)` Static method to build a parameters container from command line arguments.
`void`	`doUpdate(boolean value)` Only applies to input files in LDM format.
`void`	`enableHistogram(boolean flag)` Specify if the histogram must be computed or not.
`double`	`getBitSetThreshold()` Returns the bitset generation threshold value.
`int`	`getBorder()` Deprecated. As of Open Inventor 9000 See documentation for more details
`int`	`getCompressionLevel()`
`java.lang.String`	`getCompressionName()` Returns compression type.
`java.lang.String`	`getDataFileName()` Returns the complete data filename (i.e.
`java.lang.String`	`getDataSectionFileName()` Returns the data filename.
`java.lang.String`	`getHeaderFileName()` Returns header filename.
`java.lang.String`	`getInputFileName()` Returns input filename.
`double[]`	`getInputRangeMinMax()` Returns input data range.
`SoDataSet`	`getInputVolume()` Returns the the volume used as input.
`SoConverterParameters.SampleTypes`	`getLowResAlgorithm()` Returns algorithm used to build low resolution tiles.
`int`	`getMaxMemory()` Returns max memory available for converter.
`int`	`getNbArgs()` Returns the number of arguments set during init.
`SoDataSet.DataTypes`	`getOutputDataFormat()` Returns the output data format.
`boolean`	`getOutputHeaderOnly()` Returns header only setting.
`int`	`getPondCoef()` Retrieve the ponderation coefficient for low resolution tiles.
`int`	`getTargetWordFormat()` Returns word format property.
`SbVec3i32`	`getTileDim()` Returns tile dimension.
`double`	`getUndefinedValue()` Returns the undefined value.
`boolean`	`isCrcCheckDone()`
`boolean`	`isForUpdate()` Return true if converter is configured to perform a simple update.
`boolean`	`isHistogramEnabled()` Returns true if histogram will be computed.
`boolean`	`isInputDataRangeSpecified()` Return whether or not the input data range has been specified.
`boolean`	`isOutputDataTypeSpecified()` Return whether or not the output data type has been specified.
`boolean`	`isRGBAMode()` Returns true if RGBA mode.
`boolean`	`isSavedAsBitSet()` Returns true if output will be saved as a bitset (ie: 8 values per byte)
`boolean`	`isVerbose()` Returns verbose mode setting.
`void`	`saveAsBitSet(boolean flag)` Calls saveAsBitSet(flag, (double)0).
`void`	`saveAsBitSet(boolean flag, double bitsetThreshold)` Specify if dataset should be saved as a bitset (8 values per byte) or values.
`void`	`setBitSetThreshold(double bitsetThreshold)` Set the bitset threshold value.
`boolean`	`setBorder()` Deprecated.
`boolean`	`setBorder(int border)` Deprecated. As of Open Inventor 9000 See documentation for more details
`void`	`setCompressionLevel(int compressionLevel)` Set compression level.
`boolean`	`setCompressionName(java.lang.String compressionName)` Set compression name.
`void`	`setCrcCheck(boolean addCrcCheck)` Set CRC32 check on compression.
`void`	`setDataFileName(java.lang.String dataFileName)` Set data filename (i.e.
`void`	`setHeaderFileName(java.lang.String headerFileName)` Set header filename (i.e.
`void`	`setInputFileName(java.lang.String inputFileName)` Set the input filename.
`boolean`	`setInputRangeMinMax(double min, double max)` Set the input data range to map to the output data format.
`void`	`setInputVolume(SoDataSet inputVolume)` Define the volume used as input.
`boolean`	`setLowResAlgorithm(int lowResAlgorithm)` Set the algorithm used to build low resolution tiles.
`boolean`	`setMaxMemory(int maxMemory)` Set maximum memory available for the converter, in MB.
`boolean`	`setOutputDataFormat(SoDataSet.DataTypes dataType)` Set the output data format with an `SoDataSet.DataType`.
`boolean`	`setOutputDataFormat(java.lang.String dataFormat)` Set the output data format from a format string.
`void`	`setOutputHeaderOnly(boolean headerOnly)` Set the header only feature.
`void`	`setRGBAMode(boolean flag)` Set RGBA data mode (output will be unsigned int32 RGBA values).
`boolean`	`setTargetWordFormat(int wordFormat)` Set the target machine word format.
`void`	`setTileDim(int tileDim)` Set tile dimension.
`void`	`setTileDim(SbVec3i32 tileDim)` Set tile dimension.
`void`	`setUndefinedValue(double undefinedValue)` Set the undefined value.
`void`	`setVerbose(boolean isVerbose)` Set verbose mode.
`boolean`	`useDefaultCompLvl()`

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
  - DECIMATION
```
@Deprecated
public static final int DECIMATION
```
    Deprecated. Use SoConverterParameters.SampleTypes.DECIMATION instead.
  - AVERAGE
```
@Deprecated
public static final int AVERAGE
```
    Deprecated. Use SoConverterParameters.SampleTypes.AVERAGE instead.
  - PARAM_NO_ERROR
```
@Deprecated
public static final int PARAM_NO_ERROR
```
    Deprecated. Use SoConverterParameters.ParametersErrors.PARAM_NO_ERROR instead.
  - PARAM_ERROR
```
@Deprecated
public static final int PARAM_ERROR
```
    Deprecated. Use SoConverterParameters.ParametersErrors.PARAM_ERROR instead.
- Constructor Detail
  - SoConverterParameters
```
public SoConverterParameters()
```
    Default constructor.
- Method Detail
  - create
```
@Deprecated
public static SoConverterParameters create(int argc,
                                                        java.lang.String[] argv)
```
    Deprecated. As of Open Inventor 9.3, use create(String[]) instead.
    
    Static method to build a parameters container from command line arguments.
    The method returns NULL if an error is detected in the arguments. Otherwise, it returns a pointer to an instance of the class, initialized with given parameters. See SoConverter.converter for a list of command line arguments.
  - setBorder
```
@Deprecated
public boolean setBorder()
```
    Deprecated.
    
    Calls setBorder((int)0).
  - saveAsBitSet
```
public void saveAsBitSet(boolean flag)
```
    Calls saveAsBitSet(flag, (double)0).
  - doUpdate
```
public void doUpdate(boolean value)
```
    Only applies to input files in LDM format. If true the converter must just perform an update of the given file. This means that if no options are specified, the converter will retrieve information from the input file and apply its properties automatically to the generated file.
  - getHeaderFileName
```
public java.lang.String getHeaderFileName()
```
    Returns header filename.
  - isForUpdate
```
public boolean isForUpdate()
```
    Return true if converter is configured to perform a simple update. Return false otherwise
  - setHeaderFileName
```
public void setHeaderFileName(java.lang.String headerFileName)
```
    Set header filename (i.e. the .ldm filename).
    Like the -o command line argument. Default is input filename with extension .ldm.
  - getDataSectionFileName
```
public java.lang.String getDataSectionFileName()
```
    Returns the data filename.
  - getBitSetThreshold
```
public double getBitSetThreshold()
```
    Returns the bitset generation threshold value.
  - setBitSetThreshold
```
public void setBitSetThreshold(double bitsetThreshold)
```
    Set the bitset threshold value.
    Whichever was called last, saveAsBitSet or this method, determines the threshold value that will be used.
    
    Parameters:
    
    bitsetThreshold - For each value (V) of a dataset, if V > threshold the bitset is set to 1 for this bit, or to 0 otherwise. Default is 0.
  - setDataFileName
```
public void setDataFileName(java.lang.String dataFileName)
```
    Set data filename (i.e. the .dat filename).
    Like the -O command line argument. Default is the same as the header file, with .dat extension.
  - getTileDim
```
public SbVec3i32 getTileDim()
```
    Returns tile dimension.
  - isVerbose
```
public boolean isVerbose()
```
    Returns verbose mode setting.
  - create
```
public static SoConverterParameters create(java.lang.String[] argv)
```
    Static method to build a parameters container from command line arguments.
    The method returns NULL if an error is detected in the arguments. Otherwise, it returns a pointer to an instance of the class, initialized with given parameters. See SoConverter.converter for a list of command line arguments.
  - setVerbose
```
public void setVerbose(boolean isVerbose)
```
    Set verbose mode. Default value is Off.
  - setTileDim
```
public void setTileDim(SbVec3i32 tileDim)
```
    Set tile dimension.
    The default value is 64,64,64 and all values must a power of 2. This method can be used to set a different value for each tile dimension, for example for a "thin volume" or height field.
  - setBorder
```
@Deprecated
public boolean setBorder(int border)
```
    Deprecated. As of Open Inventor 9000 See documentation for more details
    
    Returns true if parameter is valid, else returns false. Deprecated since Open Inventor 9000
    No longer supported.
  - setTileDim
```
public void setTileDim(int tileDim)
```
    Set tile dimension.
    Like the -t command line argument. The default is 64 and the value must be a power of 2. The same value is used for all dimensions of the tile.
  - getBorder
```
@Deprecated
public int getBorder()
```
    Deprecated. As of Open Inventor 9000 See documentation for more details
    
    Returns 0 (no overlapping). Deprecated since Open Inventor 9000
    No longer supported.
  - saveAsBitSet
```
public void saveAsBitSet(boolean flag,
                         double bitsetThreshold)
```
    Specify if dataset should be saved as a bitset (8 values per byte) or values.
    
    Parameters:
    
    flag - Dataset is a bitset (true) or values (false)
    
    bitsetThreshold - For each value (V) of a dataset, if V > bitsetThreshold the bitset is set to 1 for this bit, or to 0 otherwise. Used only if flag parameter is set to true. Default is 0.
  - setTargetWordFormat
```
public boolean setTargetWordFormat(int wordFormat)
```
    Set the target machine word format.
    Like the -w command line argument. Default is the current machine word format. wordFormat parameter is 0 for Big Endian, and 1 for Little Endian. Returns true if parameter is valid, else returns false.
  - getLowResAlgorithm
```
public SoConverterParameters.SampleTypes getLowResAlgorithm()
```
    Returns algorithm used to build low resolution tiles.
  - getTargetWordFormat
```
public int getTargetWordFormat()
```
    Returns word format property.
  - setLowResAlgorithm
```
public boolean setLowResAlgorithm(int lowResAlgorithm)
```
    Set the algorithm used to build low resolution tiles.
    Available options are :
    - 0: To use decimation algorithm
    - n: To use average algorithm and give a ponderation coefficient of n to the selected voxel. The default is Decimation. Returns true if parameter is valid, else returns false.
  - getOutputDataFormat
```
public SoDataSet.DataTypes getOutputDataFormat()
```
    Returns the output data format.
  - setUndefinedValue
```
public void setUndefinedValue(double undefinedValue)
```
    Set the undefined value.
    Like the -u command line argument. The given value will be stored in the LDM file. Default is NaN (Not a Number). This is currently used by SoHeightFieldRender (vertices with undefined values are not rendered).
  - setOutputDataFormat
```
public boolean setOutputDataFormat(java.lang.String dataFormat)
```
    Set the output data format from a format string.
    Like the -f command line argument. The format is specified as "u*" for unsigned integer, "s*" for signed integer or "f" for float, where * = 8, 16 or 32. Default is no conversion. Returns true if parameter is valid, else returns false.
    Note that if the input reader does not support the requested conversion, the output data format will be the same as the input data format (no conversion).
  - getPondCoef
```
public int getPondCoef()
```
    Retrieve the ponderation coefficient for low resolution tiles.
    Only relevant when low resolution algorithm is set to AVERAGE.
  - setOutputDataFormat
```
public boolean setOutputDataFormat(SoDataSet.DataTypes dataType)
```
    Set the output data format with an SoDataSet.DataType.
    Note that if the input reader does not support the requested conversion, the output data format will be the same as the input data format (no conversion) Returns true if parameter is valid, else returns false.
  - getCompressionName
```
public java.lang.String getCompressionName()
```
    Returns compression type.
  - setCompressionName
```
public boolean setCompressionName(java.lang.String compressionName)
```
    Set compression name.
    Like the -c command line argument. See also setCompressionLevel(). The following compression types are currently supported:.
    - gzip:
      This is a lossless compression and can be used on any type of data. See SoGzipDataCompressor.
    - jpeg:
      This is a lossy compression. See SoJpegDataCompressor.
      Limitation: Can only be used on 8-bit scalar data sets.
    - jp3d:
      This is a wavelet compression that can be lossless or lossy. See SoJp3dDataCompressor.
      Limitation: 32 bit data values (float or integer) are always converted to 16 bit values.
    Returns true if parameter is valid, else returns false.
  - setCrcCheck
```
public void setCrcCheck(boolean addCrcCheck)
```
    Set CRC32 check on compression.
    Like -C command line argument. When compression is enabled using -c, adds a data integrity check value to all compressed tiles. If the environment variable LDM_COMPRESS_CHECK_CRC32 is set, data values will be checked each time they are read from disk. Default is false.
  - setCompressionLevel
```
public void setCompressionLevel(int compressionLevel)
```
    Set compression level.
    Like the -l command line argument. See also setCompressionName(). The meaning of this parameter depends on the type of compression used:
    - gzip
      Level must be between 0 and 9: 0 gives no compression, 9 gives best compression but slower speed. Default is 3.
    - jpeg:
      Level must be between 0 and 100: 0 gives best compression but most loss of data, 100 gives minimum compression and minimum data alteration. Default is 85.
    - jp3d:
      A level of 0 specifies the lossless mode, and any other value sets the target PSNR (Peak Signal to Noise Ratio). Typical values for PSNR are: 70dB for near lossless mode, and 40dB for visually lossless mode.
  - getCompressionLevel
```
public int getCompressionLevel()
```
  - setInputRangeMinMax
```
public boolean setInputRangeMinMax(double min,
                                   double max)
```
    Set the input data range to map to the output data format.
    Like the -r command line argument. If not specified, and input type is float and output type is integer, the values are simply cast into the output data type. Returns true if parameter is valid, else returns false.
  - useDefaultCompLvl
```
public boolean useDefaultCompLvl()
```
  - getInputRangeMinMax
```
public double[] getInputRangeMinMax()
```
    Returns input data range.
  - isCrcCheckDone
```
public boolean isCrcCheckDone()
```
  - setInputVolume
```
public void setInputVolume(SoDataSet inputVolume)
```
    Define the volume used as input. Allows to convert in-memory data to a LDM file. Alternative to setInputFileName().
  - enableHistogram
```
public void enableHistogram(boolean flag)
```
    Specify if the histogram must be computed or not. Default is true.
    Disabling Histogram generation will greatly speedup the conversion process, but some VolumeViz rendering features and optimizations won't be available.
    It also implies that the following information won't be computed:
    - dataset min and max values
    - per Tile min max values
    Note also that if RGBA mode is set then no histogram is computed.
  - getInputVolume
```
public SoDataSet getInputVolume()
```
    Returns the the volume used as input.
  - isRGBAMode
```
public boolean isRGBAMode()
```
    Returns true if RGBA mode.
  - getInputFileName
```
public java.lang.String getInputFileName()
```
    Returns input filename.
  - isSavedAsBitSet
```
public boolean isSavedAsBitSet()
```
    Returns true if output will be saved as a bitset (ie: 8 values per byte)
  - getDataFileName
```
public java.lang.String getDataFileName()
```
    Returns the complete data filename (i.e. : the whole path to .dat file).
  - isHistogramEnabled
```
public boolean isHistogramEnabled()
```
    Returns true if histogram will be computed.
  - setInputFileName
```
public void setInputFileName(java.lang.String inputFileName)
```
    Set the input filename. This is the file containing data to convert. Alternative to setInputVolume(). An input file must be specified. To get more information regarding possible limitation of any readers you may use, please see documentation of Readers.
  - getNbArgs
```
public int getNbArgs()
```
    Returns the number of arguments set during init.
  - setOutputHeaderOnly
```
public void setOutputHeaderOnly(boolean headerOnly)
```
    Set the header only feature.
    Like the -h command line argument. If set, the converter will only write the header file. No data will be generated. Default value is Off.
  - getUndefinedValue
```
public double getUndefinedValue()
```
    Returns the undefined value.
  - getOutputHeaderOnly
```
public boolean getOutputHeaderOnly()
```
    Returns header only setting.
  - isOutputDataTypeSpecified
```
public boolean isOutputDataTypeSpecified()
```
    Return whether or not the output data type has been specified.
  - setMaxMemory
```
public boolean setMaxMemory(int maxMemory)
```
    Set maximum memory available for the converter, in MB.
    Like the -m command line argument. Default value is 512 MB. Returns true if parameter is valid, else returns false.
  - setRGBAMode
```
public void setRGBAMode(boolean flag)
```
    Set RGBA data mode (output will be unsigned int32 RGBA values).
  - getMaxMemory
```
public int getMaxMemory()
```
    Returns max memory available for converter.
  - isInputDataRangeSpecified
```
public boolean isInputDataRangeSpecified()
```
    Return whether or not the input data range has been specified.

Class SoConverterParameters

Nested Class Summary

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

Field Summary

Fields inherited from class com.openinventor.inventor.Inventor

Constructor Summary

Method Summary

Methods inherited from class com.openinventor.inventor.Inventor

Methods inherited from class java.lang.Object

Field Detail

DECIMATION

AVERAGE

PARAM_NO_ERROR

PARAM_ERROR

Constructor Detail

SoConverterParameters

Method Detail

create

setBorder

saveAsBitSet

doUpdate

getHeaderFileName

isForUpdate

setHeaderFileName

getDataSectionFileName

getBitSetThreshold

setBitSetThreshold

setDataFileName

getTileDim

isVerbose

create

setVerbose

setTileDim

setBorder

setTileDim

getBorder

saveAsBitSet

setTargetWordFormat

getLowResAlgorithm

getTargetWordFormat

setLowResAlgorithm

getOutputDataFormat

setUndefinedValue

setOutputDataFormat

getPondCoef

setOutputDataFormat

getCompressionName

setCompressionName

setCrcCheck

setCompressionLevel

getCompressionLevel

setInputRangeMinMax

useDefaultCompLvl

getInputRangeMinMax

isCrcCheckDone

setInputVolume

enableHistogram

getInputVolume

isRGBAMode

getInputFileName

isSavedAsBitSet

getDataFileName

isHistogramEnabled

setInputFileName

getNbArgs

setOutputHeaderOnly

getUndefinedValue

getOutputHeaderOnly

isOutputDataTypeSpecified

setMaxMemory

setRGBAMode

getMaxMemory

isInputDataRangeSpecified