Class SoMultiDataSeparator
- java.lang.Object
-
- All Implemented Interfaces:
SafeDisposable
public class SoMultiDataSeparator extends SoSeparator
Separator for combining multiple data sets. TheSoMultiDataSeparator
node allows you to combine multiple data sets.This is the correct method for combining multiple data sets. Combining multiple data sets without inserting them under an
SoMultiDataSeparator
node may produce incorrect results and should be avoided.Each data set is represented by an
SoDataSet
node (typically anSoVolumeData
node). Combining is enabled by anSoDataCompositor
node for CPU combining or anSoVolumeShader
node for GPU combining. A common use of GPU combining is to implement co-blending of multiple volumes, in other words using a fragment shader to combine the color and/or intensity values of the voxels.Some rules must be followed when doing render or data compositing:
- Each
SoVolumeData
node must have a uniqueSoDataSet.dataSetId
.
- All the
SoVolumeData
nodes to be composited, as well as the compositing node (e.g.SoVolumeShader
for slices orSoVolumeRenderingQuality
for volumes) and the rendering node (e.g.SoVolumeRender
), must be under anSoMultiDataSeparator
node. - The
SoVolumeData
nodes to be composited must be all scalar data sets or all RGBA data sets. To composite scalar and RGBA data sets under the sameSoMultiDataSeparator
, set the usePalettedTexture field to false in the scalar dataset'sSoVolumeData
node to force the scalar data to be converted into RGBA data. - An
SoVolumeData
node used in a data compositing scheme must not be inserted multiple times in the scene graph. Use another volume data node pointing to the same file. - Each
SoVolumeData
node has its own resource settings (see fieldSoDataSet.ldmResourceParameters
). The resources required for the composition are the sum of the resources for all of theSoVolumeData
nodes involved.
- All transfer functions must have the same 'colorMapType' and must have the same number of entries in the colormap.
GPU combining must be implemented in a shader program written in the standard GLSL language. The shader program will be specified using an
SoVolumeShader
node. The shader source code is loaded using (for example) anSoFragmentShader
object. Uniform parameters for the shader may be specified using the subclasses ofSoShaderParameter
. SeeSoVolumeShader
for more information about the shader function library provided by VolumeViz.It is possible to compose datasets that have different dimensions, tile sizes and transformations.
In order to help fetch the correct data values in custom shaders, texture coordinates conversion functions are provided in the VolumeViz/vvizStructure.h shader include.
SeeSoVolumeShader
for more details.For each data set there will typically be an
SoDataRange
node and anSoTransferFunction
node to define the mapping from data values to color values. For eachSoVolumeData
a separate 3D texture will be generated and sent to the GPU. 3D textures can be generated with different precision (8-bit or 12-bit) according to theSoDataSet.texturePrecision
field. The texture unit used for each data set is determined by theSoDataSet.dataSetId
field. All colormaps are aggregated into a single 2D texture.A custom fragment shader can retrieve the voxel's data value from each 3D texture using the GLSL VolumeViz function:
VVIZ_DATATYPE value = VVizGetData( dataSetId, texCoord ); vec4 color = VVizTransferFunction( value, colorMapId ); VVizOutputColor( color ): EXAMPLE The following code shows how to do multidata rendering using an
SoVolumeShader
node to combine values for anSoVolumeRender
node. Given twoSoVolumeData
nodes ds1 and ds2:SoVolumeShader volumeShader = new SoVolumeShader(); SoVolumeData volumeData1 = new SoVolumeData(); volumeData1.dataSetId.setValue( 0 ); SoDataRange dataRange1 = new SoDataRange(); dataRange1.dataRangeId.setValue( 0 ); SoTransferFunction colorMap1 = new SoTransferFunction(); SoVolumeData volumeData2 = new SoVolumeData(); volumeData2.dataSetId.setValue( 1 ); SoDataRange dataRange2 = new SoDataRange(); dataRange2.dataRangeId.setValue( 1 ); SoTransferFunction colorMap2 = new SoTransferFunction(); SoVolumeRender volumeRender = new SoVolumeRender(); SoMultiDataSeparator multiDataSep = new SoMultiDataSeparator(); multiDataSep.addChild( volumeShader ); // Shader to combine volumes multiDataSep.addChild( volumeData1 ); multiDataSep.addChild( dataRange1 ); multiDataSep.addChild( colorMap1 ); multiDataSep.addChild( volumeData2 ); multiDataSep.addChild( dataRange2 ); multiDataSep.addChild( colorMap2 ); multiDataSep.addChild( volumeRender ); root.addChild(multiDataSep); - See Also:
SoDataSet
,SoVolumeData
,SoDataCompositor
,SoVolumeShader
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from class com.openinventor.inventor.nodes.SoSeparator
SoSeparator.Cachings, SoSeparator.FastEditings, SoSeparator.RenderUnitIds
-
Nested classes/interfaces inherited from class com.openinventor.inventor.nodes.SoNode
SoNode.RenderModes
-
Nested classes/interfaces inherited from class com.openinventor.inventor.Inventor
Inventor.ConstructorCommand
-
-
Field Summary
-
Fields inherited from class com.openinventor.inventor.nodes.SoSeparator
boundingBoxCaching, fastEditing, pickCulling, renderCaching, renderCulling, renderUnitId
-
Fields inherited from class com.openinventor.inventor.nodes.SoGroup
boundingBoxIgnoring
-
Fields inherited from class com.openinventor.inventor.Inventor
VERBOSE_LEVEL, ZeroHandle
-
-
Constructor Summary
Constructors Constructor Description SoMultiDataSeparator()
Constructor.
-
Method Summary
-
Methods inherited from class com.openinventor.inventor.nodes.SoGroup
addChild, findChild, getChild, getNumChildren, insertChild, removeAllChildren, removeChild, removeChild, replaceChild, replaceChild
-
Methods inherited from class com.openinventor.inventor.nodes.SoNode
affectsState, callback, copy, copy, distribute, doAction, getAlternateRep, getBoundingBox, getByName, getMatrix, getPrimitiveCount, getRenderEngineMode, getRenderUnitID, GLRender, GLRenderBelowPath, GLRenderInPath, GLRenderOffPath, grabEventsCleanup, grabEventsSetup, handleEvent, isBoundingBoxIgnoring, isOverride, pick, rayPick, search, setOverride, touch, write
-
Methods inherited from class com.openinventor.inventor.fields.SoFieldContainer
copyFieldValues, copyFieldValues, enableNotify, fieldsAreEqual, get, getAllFields, getEventIn, getEventOut, getField, getFieldName, hasDefaultValues, isNotifyEnabled, set, setToDefaults
-
Methods inherited from class com.openinventor.inventor.misc.SoBase
dispose, getName, isDisposable, isSynchronizable, setName, setSynchronizable
-
Methods inherited from class com.openinventor.inventor.Inventor
getNativeResourceHandle
-
-