Package com.openinventor.volumeviz.nodes
Class SoVolumeDataDrawStyle
- java.lang.Object
-
- com.openinventor.inventor.Inventor
-
- com.openinventor.inventor.misc.SoBase
-
- com.openinventor.inventor.fields.SoFieldContainer
-
- com.openinventor.inventor.nodes.SoNode
-
- com.openinventor.volumeviz.nodes.SoVolumeDataDrawStyle
-
- All Implemented Interfaces:
SafeDisposable
public class SoVolumeDataDrawStyle extends SoNode
Volume draw style. This node specifies the volume rendering style for a volume or for one of the voxel regions of a volume defined bySoVolumeMask
nodes. The available draw styles are hidden (not rendered), direct volume rendering, isosurface(s) rendering and the boundary surface rendering according to thestyle
field. Volume rendering always uses the current transfer function and material in the scene graph. Isosurfaces and boundary surfaces use the current material by default, but can optionally be rendered using materials specified in theisosurfacesMaterial
orboundaryMaterial
fields.Notes:
- Draw style only applies to
SoVolumeRender
nodes. - See
SoVolumeMask
for discussion of how draw styles are associated with mask regions. - When not using volume masks, the draw style node must be traversed before the
SoVolumeData
node. - The MASK_BOUNDARY style is ignored if not using volume masks.
- The ISOSURFACE style is functionally equivalent to using an
SoVolumeIsosurface
node, but provides more options. The benefit of using anSoVolumeDataDrawStyle
is the ability to combine different display styles (e.g. ISOSURFACE and MASK_BOUNDARY).
The isosurface displays the boundary between 2 different values, similar to the marching cubes algorithms. In other words, a voxel is part of the isosurface if the ray entry and exit values for the voxel are different and include the specified isosurface value in their range. If you render, for example, the isosurface 100 of a volume data containing the value 100 everywhere, nothing will be rendered.
File format/default:
VolumeMask {
style VOLUME_RENDER boundaryMaterial NULL isosurfacesMaterial NULL isovalues []
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
SoVolumeDataDrawStyle.DrawStyles
Volume rendering style.-
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 Modifier and Type Field Description SoSFMaterial
boundaryMaterial
Material used to render the mask boundary.SoSFMaterial
isosurfacesMaterial
Material used to render isosurfaces.SoMFFloat
isovalues
Values of isosurfaces to display.SoSFBitMask<SoVolumeDataDrawStyle.DrawStyles>
style
Set the draw style used for a volume or mask: .-
Fields inherited from class com.openinventor.inventor.Inventor
VERBOSE_LEVEL, ZeroHandle
-
-
Constructor Summary
Constructors Constructor Description SoVolumeDataDrawStyle()
Creates a volume draw style node with default settings.
-
Method Summary
-
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
-
-
-
-
Field Detail
-
style
public final SoSFBitMask<SoVolumeDataDrawStyle.DrawStyles> style
Set the draw style used for a volume or mask: . -NONE: Display nothing-VOLUME_RENDER: Display the volume using the associated transfer function. This is the default value.
-MASK_BOUNDARY: Display only the mask boundary, don't render the masked volume.
-ISOSURFACE: Display the set of isosurfaces defined in
isovalues
field.Modes can be combined.
-
boundaryMaterial
public final SoSFMaterial boundaryMaterial
Material used to render the mask boundary. Default is none.
-
isovalues
public final SoMFFloat isovalues
Values of isosurfaces to display. Default is none.
-
isosurfacesMaterial
public final SoSFMaterial isosurfacesMaterial
Material used to render isosurfaces.
If this field is empty, the current or defaultSoMaterial
is used.
-
-