| SoIvTune Class |
Opens an IvTune window.
Inheritance HierarchyNamespace: OIV.IvTune
Assembly: OIV.IvTune (in OIV.IvTune.dll) Version: 10.3.0.0 (10.3.0.0)
SyntaxThe SoIvTune type exposes the following members.
Methods| Name | Description | |
|---|---|---|
 | Equals | (Inherited from Object.) |
| GetHashCode |
Overrides GetHashCode().
(Inherited from SoNetBase.) |
 | GetShortcutValue | Retrieves the defined keyboard shortcut used to launch IvTune. |
| GetType | Gets the Type of the current instance. (Inherited from Object.) |
| IsInstance | Obsolete. Returns true if an IvTune window is currently open. |
| IsRunning | Returns true if IvTune is currently running. |
| ProcessEvents | Process Qt events (calls QCoreApplication.processEvents()). |
| SetInstance(Int32, String, SoNode) | Obsolete. Calls SetInstance(argc, argv, root, false). |
| SetInstance(Int32, String, SoNode, Boolean) | Obsolete. |
| SetShortcutValue | Defines the keyboard shortcut to use to launch IvTune. |
| Start(SoNode) |
Starts an IvTune session based on the specified scene graph,
for example a subset of the application scene graph.
|
| Start(SoRenderAreaCore) |
Starts an IvTune session based on the scene graph managed
by the given SoRenderAreaCore.
|
| Start(SoSceneManager) | Obsolete.
Starts an IvTune session based on the scene graph in an existing
SoSceneManager.
|
| Stop | Ends IvTune session. |
| ToString | Returns a string that represents the current object. (Inherited from Object.) |
RemarksIvTune is an editor and viewer for Open Inventor scene graphs.
If the hot key (Shift-F12 by default) is enabled, the user can start IvTune by pressing that key combination. Using the () method, the application can programmatically start and stop IvTune. This is useful if all key combinations are already in use by the application or just to provide an IvTune item in a menu. The IvTune hot key can be redefined using the environment variable OIV_IVTUNE_SHORTCUT (see OIV.Inventor.SoPreferences) or using the OIV.IvTune.SoIvTune.SetShortcutValue(OIV.Inventor.Events.SoKeyboardEvent.Keys) method.
Note: We recommend disabling the IvTune hot key when you distribute your application, especially if it is a commercial application. See the method OIV.Inventor.SoDB.SetIvTuneAllowed(System.Boolean). This will prevent users from viewing or changing the application scene graph. Even if the hot key is disabled, the application can still allow opening IvTune, if desired, for example from an "expert" menu using the methods in this class.
Note: In order to use the IvTune hot key feature with an Open Inventor .NET application, you must explicitly add the IvTune assembly (OIV.IvTune) to the project references.
When IvTune is started from an application, it opens a separate window. This window includes a Tree_View panel which displays the scene graph, a Node_Overview panel to display the fields of a node, and Field_Editor and Field_Watch panels to edit and track interesting fields.
For details of using IvTune, see the on-line documentation provided for the pre-built IvTune viewer supplied with the Open Inventor SDK in the program (Windows) or bin (Unix/Linux) directory. The IvTune viewer application can also be used to view Open Inventor scene graph files.
IvTune can also be extensively customized and extended using the IvTuneExtender API to create plugins. An IvTune plugin can modify the IvTune user interface, replace standard IvTune panels and even provide new panels that implement specialized operations such a color map editor for OIV.LDM.Nodes.SoTransferFunction nodes. Documentation and examples are provided in the source/IvTune subdirectory of the Open Inventor SDK (after installing the Demos package).
NOTE : Since Open Inventor 9.7, IvTune is built with Qt 5.x, which is not compatible with Qt 4.x. If your application is built with Qt 4.x, you will not be able to invoke IvTune.
See Also