Package com.openinventor.ivtune

IvTune is an extensible, interactive tool that allows the user to inspect and modify Open Inventor scene graphs, even in a running application program.

# Start IvTune IvTune can be accessed two ways:

  • From the delivered stand-alone program IvTuneViewer which allows you to view and edit scene graph (.iv) files.
  • From a running Open Inventor application, in which case, you can view and edit the application scene graph.

To manually invoke IvTune from an Open Inventor application, start the application, then type the IvTune shortcut (by default, SHIFT+F12) in the viewer window. IvTune will open a separate window allowing you to interact with the application scene graph. You can change the IvTune shortcut from its default of SHIFT+F12 using the environment variable OIV_IVTUNE_SHORTCUT. See SoPreferences for details. You can also change the shortcut programmatically using the SoIvTune.setShortCutValue() method.

To programmaticaly invoke IvTune from an Open Inventor application, use the SoIvTune.start() method. See the Reference Manual for details. This method is useful if the application is already using all the keyboard shortcuts for other actions and wants to expose IvTune through the application's user interface.

# Customizing IvTune If you want to customize IvTune you can use the IvTuneExtender which is an API that allows you to create plug-ins that extend IvTune's capabilities.

# Forbid IvTune start from shortcut We recommend doing this for applications that will be redistributed (especially for commercial applications. This will prevent users from viewing or changing the application scene graph. You can prevent users from starting IvTune in your application in several ways:

  • Call SoDB.setIvTuneAllowed(false) when the application starts. In this case the application could still allow IvTune to be started from the application user interface, e.g. in an "experts only" menu.
  • Set the environment variable OIV_NO_IVTUNE to 0.
  • Do not redistribute the IvTune DLL (Windows) or shared library (UNIX or Linux).