| SoDataSetundefinedValue Property |
Specifies the data value that should be considered undefined and therefore not rendered.
Namespace: OIV.LDM.Nodes
By default, this field is set to NaN (Not a Number), meaning that no specific value is excluded. Otherwise, the value must match the data type.
Limitations: There are several limitations in order for the undefined value to work:
The texturePrecision must be at least equal to the number of significant bits of the data type.
The data type must be BYTE, SHORT (either SIGNED or UNSIGNED) or FLOAT
The field is ignored in the following classes : OIV.VolumeViz.Nodes.SoHeightFieldProperty, OIV.VolumeViz.Nodes.SoHeightFieldPropertyMask and OIV.VolumeViz.Nodes.SoVolumeMask. Setting this field has no effect in these cases.
Note: If the application uses custom shaders, particularly when overriding the VVizComputeFragmentColor() function:
Undefined values are handled in the GLSL function VVizTransferFunction().
If the voxel value is undefined, VVizTransferFunction() returns the RGBA value 0,0,0,0. You may return this value for your undefined value.
If the application's shader does not call VVizTransferFunction() (e.g. voxel color is computed without using a colormap), the application's shader must explicity check for undefined values. This can be done using the function VVizIsUndefined()
Field available since Open Inventor 10.11 |