| SoDataSet Class |
Data set node.
Inheritance HierarchyOIV.InventorSoNetBase
OIV.InventorSoDisposable
OIV.Inventor.MiscSoBase
OIV.Inventor.FieldsSoFieldContainer
OIV.Inventor.NodesSoNode
OIV.LDM.NodesSoDataSet
OIV.VolumeViz.NodesSoVolumeData
Namespace: OIV.LDM.Nodes
Assembly: OIV.LDM (in OIV.LDM.dll) Version: 9.9.13.0 (9.9.13.0)
SyntaxThe SoDataSet type exposes the following members.
Methods| Name | Description | |
|---|---|---|
 | AffectsState | Returns true if a node has an effect on the state during traversal. |
| Callback | (Overrides SoNodeCallback(SoCallbackAction).) |
| Copy | Calls Copy(false). (Inherited from SoNode.) |
| Copy(Boolean) | Creates and returns an exact copy of the node. |
| CopyFieldValues(SoFieldContainer) | Calls CopyFieldValues(fc, false). (Inherited from SoFieldContainer.) |
| CopyFieldValues(SoFieldContainer, Boolean) | Copies the contents of fc's fields into this object's fields. |
 | DataSize | Returns the number of bytes per voxel of the specified data type. |
| Dispose |
Releases all resources used by SoDisposable.
(Inherited from SoDisposable.) |
| Distribute | (Inherited from SoNode.) |
| DoAction | (Inherited from SoNode.) |
| DrawTiles | Obsolete. |
| EditBoxes | Replace all voxels in the region defined by a list of boxes with the specified value. |
| EditSolidShape | Replace all voxels intersecting the given shape with the specified value. |
| EditSubVolume(SbBox3i32, SoBufferObject) | Replace the contents of a subvolume with the given data. |
| EditSubVolume(SbBox3i32, Double) | Replace the contents of a subvolume with the specified value. |
| EditSurfaceShape | Replace all voxels intersecting the polygons or lines defined by the surfaceShape and given thickness with the specified value. |
| EditTile(SoLDMTileID, SoBufferObject) | Replace the contents of a tile with the given data. |
| EditTile(SoLDMTileID, Double) | Replace the contents of a tile with the specified value. |
| EnableNotify | Notification at this Field Container is enabled (if flag == true) or disabled (if flag == false). |
| Equals | (Inherited from Object.) |
| FieldsAreEqual | Returns true if this object's fields are exactly equal to fc's fields. |
| FinishEditing | Terminate an editing transaction. |
| Get | Returns the values of the fields of this object in the Open Inventor ASCII file format in the given string. |
| GetAllFields | Returns a list of fields, including the eventIn's and eventOut's. |
| GetAlternateRep | This method is called by actions to allow the node to provide an "alternate representation" when appropriate (typically depending on the action type). |
| GetAppropriateElement | a SoDataSet must return the LDMelt defining the weights of the representations that are going to use it. |
| GetBoundingBox | (Overrides SoNodeGetBoundingBox(SoGetBoundingBoxAction).) |
| GetDataSize | Returns the number of bytes per voxel in VolumeViz. |
| GetDataType | Returns the data type. |
| GetDatumSize | Returns the number of bytes per voxel. |
| GetDimension | Returns the data set dimension. |
| GetEventIn | Returns a the eventIn with the given name. |
| GetEventOut | Returns the eventOut with the given name. |
| GetField | Returns a the field of this object whose name is fieldName. |
| GetFieldName | Returns the name of the given field in the fieldName argument. |
| GetFields | Appends references to all of this object's fields to resultList, and returns the number of fields appended. |
| GetHashCode |
Overrides GetHashCode().
(Inherited from SoNetBase.) |
| GetLdmDataAccess | Returns a reference to the SoLDMDataAccess object. |
| GetLdmManagerAccess | |
| GetLDMReader | Returns a pointer to the current data set reader object. |
| GetLdmResourceParameter | Obsolete. Returns a reference to the LDMResourceParameter. |
| GetMatrix | (Inherited from SoNode.) |
| GetMaxNumDataSets | Returns the maximum number of data sets that can be render composited on the current hardware (essentially the number of texture units - 1). |
| GetMinMax(Double, Double) | Returns min and max values of the data set. |
| GetMinMax(Int64, Int64) | Returns min and max values of the data set data. |
| GetName | Returns the name of an instance. |
| GetNodeFrontManager | Returns a pointer to the LDM node front manager. |
| GetNumTimeSteps | Obsolete. Returns the number of time steps. |
| GetOverlapping | Obsolete. Returns the tile border (overlap) in voxels. |
| GetPrimitiveCount | (Inherited from SoNode.) |
| GetReader | Obsolete. Returns the current data set reader object. |
| GetRenderUnitID | (Inherited from SoNode.) |
| GetStringName | (Inherited from SoBase.) |
| GetTileDimension | Returns the tile dimension. |
| GetTileManager | Returns a pointer to the LDM tile manager. |
| GetTileVisitor | Obsolete. Returns the current LDM tile visitor. |
| GetType | Gets the Type of the current instance. (Inherited from Object.) |
| GetVVizGeometry | Obsolete. Returns a pointer to the LDM geometry object. |
| GLRender | (Overrides SoNodeGLRender(SoGLRenderAction).) |
| GLRenderBelowPath | (Inherited from SoNode.) |
| GLRenderInPath | (Inherited from SoNode.) |
| GLRenderOffPath | (Inherited from SoNode.) |
| GrabEventsCleanup | (Inherited from SoNode.) |
| GrabEventsSetup | (Inherited from SoNode.) |
| HandleEvent | (Inherited from SoNode.) |
| HasDefaultValues | Returns true if all of the object's fields have their default values. |
| HasEditedTile | Returns true if DataSet has edited tiles. |
| IsBoundingBoxIgnoring | This method is used by getBoundingBox action traversal to know if the current node must be traversed or not, ie the bounding should be ignored. |
| IsDataFloat | Returns true if the given data type is a float data type. |
| IsDataSigned | Returns true if the given data type is a signed integer data type. |
| IsNotifyEnabled | Notification is the process of telling interested objects that this object has changed. |
| IsOverride | Returns the state of the override flag. |
| IsSynchronizable | Gets the ScaleViz synchronizable state of this object. |
| IsTimeDependent | Obsolete. |
| NumSigBits | Returns the number of significant bits. |
| Pick | (Overrides SoNodePick(SoPickAction).) |
| RayPick | (Inherited from SoNode.) |
| ReadTile(SoBufferObject, SoLDMTileID, Boolean) | Copies the specified tile into the provided buffer. |
| ReadTile(SoLDMTileID, SoBufferObject, Boolean) | Copies the specified tile into the provided buffer. |
| ReadTile(SoLDMTileID, Byte, Boolean) | Obsolete. |
| ReadTileLong | Obsolete. Copies the specified tile into the provided buffer. |
| RedoEditing | Redo all modifications associated with the specified transaction id. |
| ResetReader | reset previously set custom reader setup by setReader call. |
| SaveEditing |
Save modifications to a file.
|
| SaveEditing(Boolean) |
Save modifications to a file.
|
| SaveEditing(Boolean, IListString) |
Save modifications to a file.
|
| Search | (Inherited from SoNode.) |
| Set | Sets one or more fields in this object to the values specified in the given string, which should be a string in the Open Inventor file format. |
| SetLDM | Obsolete. Enable or disable LDM mode. |
| SetLDMDataTransformCB(SoDataSetLDMDataTransformCB) | Obsolete.
Use LDMDataTransformCallback property instead.
If set, the user-defined delegate is invoked after each tile is loaded.
This allows you to modify the original data (for example, attribute
calculation) before it's displayed.
|
| SetLDMDataTransformCB(SoDataSetLDMDataTransformUserDataCB, Object) | Obsolete.
Use LDMDataTransformCallback property instead.
|
| SetLDMReader | Sets the LDM volume reader object to use. |
| SetName | (Inherited from SoBase.) |
| SetOverride | Turns the override flag on or off. |
| SetReader(SoVolumeReader) | Obsolete. Calls SetReader(reader, false). |
| SetReader(SoVolumeReader, Boolean) | Obsolete. This method allows the data to be read directly from the disk using the specified subclass of SoVolumeReader. |
| SetSynchronizable | Sets this to be a ScaleViz synchronizable object. |
| SetTileVisitor | Obsolete. Sets a custom LDM tile visitor. |
| SetToDefaults | Sets all fields in this object to their default values. |
| StartEditing | Initiate an editing transaction. |
| ToString |
Converts this SoBase structure to a human readable string.
(Inherited from SoBase.) |
| Touch | Marks an instance as modified, simulating a change to it. |
| UndoEditing | Undo all modifications associated with the specified transaction id. |
| UseFakeData | Create fake data in buffer. |
| Write | (Overrides SoNodeWrite(SoWriteAction).) |
| WriteTile | Write the specified tile using the specified writer. |
Properties| Name | Description | |
|---|---|---|
 | allocateResourceOnRender | Indicates if resource allocation is done only on first render traversal or as soon as the node is created. |
| dataSetId | When using multiple SoDataSet nodes, the dataSetId field uniquely identifies each data set used in the compositing. |
| dataTransform | If set to an appropriate SoLDMDataTransform object, the object's transformFunction method is called after each tile is loaded, but before it is stored in main memory. |
| extent | The real size (extent) of the volume in modeling coordinates. |
| fileName | Indicates the file location containing the data set. |
| IsDisposable | ISafeDisposable interface implementation.
(Inherited from SoDisposable.) |
| LDMDataTransformCallback | Obsolete. If set, the user-defined function is called after each tile is loaded, but before it is stored in main memory. |
| ldmResourceParameters | Contains an SoLDMResourceParameters object which allows you to set LDM resource parameters. |
| Reader | Returns the current data set reader object. |
| texturePrecision | Specifies the color index texture storage size in bits. |
| useCompressedTexture | Controls use of the OpenGL lossy texture compression extension (if available). |
| UserData |
Gets or sets the user data to be contained by the field container.
(Inherited from SoFieldContainer.) |
RemarksThis class specifies the data set and its properties, and also provides utilities for extracting a subset of the data set and for resampling the data set. The data can be read from directly from a file or can be accessed via a user-defined volume reader. This class is the parent class of the VolumeViz data nodes SoVolumeData and SoMeshGeometry. These nodes provide the data for VolumeViz nodes (SoVolumeRender, SoOrthoSlice, SoObliqueSlice, etc.).
The data set can be specified by:
Setting the fileName field This implies that the data set is stored on disk, in one of the file formats for which LDM has a built-in reader. LDM will automatically select a reader based on the file extension, for example ".am" for the AmiraMesh file format.
Calling the setReader() method This is the most general method because an application can specify one of the standard LDM readers or implement a customized subclass of SoVolumeReader. LDM will get the data set properties (dimensions, size, data type, etc) and access the data through the specified reader object. This allows the application to completely control how, and from where, the data is loaded.
See Also