Open Inventor Redistribution

General

Licensing

Windows

Unix

OS Independent


General

Your Open Inventor Development License entitles you to use the SDK to create and execute Open Inventor programs on the licensed machine. Please refer to the actual text of the license, included with the SDK as LICENSE.TXT, for complete details.

Once you have created an Inventor application to distribute, it must be packaged with certain components from the SDK in order to run outside the development environment. In order to redistribute these components, you must have a separate Run-Time License by Visualization Sciences Group S.A.S..

Some installations of Open Inventor include the DLL or library for Qt (Nokia - qt.nokia.com). VSG is a licensed commercial Qt developer and this DLL is included to allow certain demo/example executables to run. This does not give you any rights (that you do not already have) to redistribute Qt.

 

Licensing

A run-time license is required for Open Inventor and each Open Inventor extension that is used by your application. The steps involved in setting up a run-time license are listed in the Licensing section.

NOTE: If you have a master password agreement, other policies and practices apply relative to the disclosure and distribution of passwords. This information is provided in the materials that you receive with your master password.

 

 Windows 

The Open Inventor run-time system is dependent on the operating system and the compiler version that Open Inventor was compiled with. Some of the required libraries are operating system dependent.

 

Open Inventor DLLs

 

The Run-Time License permits you to redistribute these files, which are necessary for an Open Inventor 8.6 for Win32 run-time distribution:

Inventor.DLL
InventorR.DLL
InventorBase.DLL
InventorGL.DLL
InventorImage.DLL
InventorGui.DLL
InventorWin.DLL
InventorAlgorithms.DLL
InventorCuda.DLL
InventorCudaAlgorithms.DLL
InventorOpenCL.DLL
InventorOpenCLAlgorithms.DLL
ScaleViz.DLL
DirectViz.dll
ScaleVizWin.DLL
ScaleVizQt.DLL
ClusterCom-base.DLL
ClusterCom-local.DLL
ClusterCom-mpi.DLL
Ivf.DLL
IvfU.DLL
DialogVizWin.DLL
DialogVizQt.DLL
DirectVizQt.DLL
DirectVizShaders.DLL
DirectVizWin.dll
HardCopy.DLL
HardCopyWin.DLL
FXViz.DLL
InventorQt4.DLL
InventorWx.DLL
SolidViz.DLL
TerrainViz.DLL
TerrainVizWin.DLL
VolumeViz.DLL
LDM.DLL
ReservoirViz.DLL
MeshViz.DLL
MeshVizWin.DLL
MeshVizDataMapping.DLL
MeshVizExtractor.DLL
MeshVizImpl.DLL
 
IvTune.DLL

version 8.6
version 8.6
version 8.6
version 8.6
version 8.6
version 8.6
version 8.6
version 8.6
version 8.6 (Only required if using CUDA optimization module)
version 8.6 (Only required if using CUDA optimization module)
version 8.6 (Only required if using OpenCL optimization module)
version 8.6 (Only required if using OpenCL optimization module)
version 8.6
version 8.6
version 8.6 (Only required if application makes use of Cluster Mode)
version 8.6 (Only required if SoQt application makes use of Cluster Mode)
version 8.6 (Only required if application makes use of Cluster Mode)
version 8.6 (Only required if application makes use of Cluster Mode)
version 8.6 (Only required if application makes use of Cluster Mode)
version 8.6 (Only required if making use of IVF MBCS application)
version 8.6 (Only required if making use of IVF UNICODE application)
version 8.6 (Only required if utilizing DialogViz application)
version 8.6 (Only required if utilizing DialogViz application)
version 8.6 (Only required if utilizing DirectViz application, see below for more information)
version 8.6 (Only required if utilizing DirectViz application)
version 8.6 (Only required if utilizing DirectViz application)
version 8.6 (Only required if utilizing HardCopy application)
version 8.6 (Only required if utilizing HardCopy application)
version 8.6 (Only required if utilizing FXViz application)
version 8.6 (Only required if utilizing SoQt application)
version 8.6 (Only required if utilizing SoWx application)
version 8.6 (Only required if utilizing SolidViz application)
version 8.6 (Only required if utilizing TerrainViz application)
version 8.6 (Only required if utilizing TerrainViz application)
version 8.6 (Only required if utilizing VolumeViz application)
version 8.6 (Only required if utilizing VolumeViz application)
version 8.6 (Only required if utilizing ReservoirViz or VolumeViz application)
version 8.6 (Only required if utilizing MeshViz application)
version 8.6 (Only required if utilizing MeshViz application)
version 8.6 (Only required if utilizing MeshViz Interface application)
version 8.6 (Only required if utilizing MeshViz Interface application)
version 8.6 (Only required if utilizing MeshViz Interface application)
 
version 8.6 (Only required if you want access to IvTune from your app.)
NOTE: IvTune requires the DLL (shared library) for FxViz, MeshViz XLM, ScaleViz, ReservoirViz, SolidViz, TerrainViz, and VolumeViz, as well as InvQt, InvGui and the Qt DLL for the version of Qt that was used to build IvTune. If you plan to allow IvTune to be launched from your application, then you must redistribute all of these files, even if they are not otherwise required by your application.

IvDLAcis.DLL
IvDLALut.DLL
IvDLBZlib.DLL
IvDLDxf.DLL
IvDLFlt.DLL
IvDLFreeType.DLL
IvDLJasper.DLL
IvDLJpeg.DLL
IvDLLm.DLL
IvDLPdf.DLL
IvDLPng.DLL
IvDLProj4.DLL
IvDLOpenAL32.DLL
IvDLTiff.DLL
IvDLZlib.DLL

CATIA, IGES, STEP import
Spatial sound management
Compression library
DXF import
OpenFlight import
FreeType support
JPEG 2000 support (import/export)
JPEG support (import/export)
FLEXnet floating license support
PDF/U3D support
PNG support (import/export)
Cartographic projection support
Spatial sound management
TIFF support (import/export)
Compression library

These files are normally installed in the <OIV_INSTALL_DIR>\Program directory. Unless otherwise indicated, all of these files must be supplied.

NOTE: You do not have the right to distribute debug DLLs, e.g., InventorD.DLL.

The DLLs prefixed with "IvDL" are dynamically loaded. Your application can tell Open Inventor to load alternate DLLs using the following environment variables:

OIV_ALUT_NAME
OIV_BZLIB_NAME
OIV_FREETYPE_NAME
OIV_LIBACIS_NAME
OIV_LIBDXF_NAME
OIV_LIBFLT_NAME
OIV_LIBJASPER_NAME
OIV_LIBJPEG_NAME
OIV_LIBPNG_NAME
OIV_LIBPROJ4_NAME
OIV_LIBTIFF_NAME
OIV_OPENAL_NAME
OIV_ZLIB_NAME

If you have chosen to use one or more alternate DLLs, be sure to distribute the alternate DLLs that your application needs.

In order for your user to use the Open Inventor DLLs, the directory containing these DLLs must be found in one of the following locations: the application directory, the current directory, the system directory, the Windows directory, %PATH%. The dynamically loaded DLLs are searched for in all the same places, plus %OIV_LD_LIBRARY_PATH%.

Nvidia Complex Required DLL

The following file must be redistributed:

complex1.6.dll

NVidia Complex library

TBB Required DLLs

The following files must be redistributed if your application uses MeshViz Interface:

tbb.dll
tbbmalloc.dll

tbb kernel library
tbb malloc library

OpenRTRT Required DLLs

The following files must be redistributed if your application uses DirectViz:

OpenRTClient.exe
libmmd.dll
libOpenRT.dll
libRTX.dll
pthreadVCE2.dll (32 bits )
pthreadVC.dll (64 bits )

OpenRT client
Intel Compiler 11 library
OpenRTRT kernel library
OpenRTRT shaders library
Threading library (32 bits)

Threading library (62 bits)

PDF 3D Export Required DLLS

The following files must be redistributed if your application uses PDF 3D export:

hpdf.dll
IFXCore.dll
Plugins\IFXExporting.dll
Plugins\IFXScheduling.dll

Other Required DLLs

  • The following Microsoft files are required by Open Inventor 8.6 depending on which version of Visual C++ you are using:

    Visual Studio 2005
    MFC80.DLL
    MSVCR80.DLL
    MSVCP80.DLL


    Only required if IVF application
    Always required
    Always required

    We recommend to install Microsoft Visual C++ 2005 SP1 Redistributable (8.0.50727.762).

    Visual Studio 2008
    MFC90.DLL
    MSVCR90.DLL
    MSVCP90.DLL
    VCOMP90.DLL


    Only required if IVF application
    Always required
    Always required
    Always required

    On Windows XP, we recommend to install Microsoft Visual C++ 2008 SP0 Redistributable (9.0.21022.8).
    On Windows Vista and Windows 7, we recommend to install Microsoft Visual C++ 2008 SP1 Redistributable (9.0.30729.1).

    Visual Studio 2010
    MFC100.DLL
    MSVCR100.DLL
    MSVCP100.DLL
    VCOMP100.DLL


    Only required if IVF application
    Always required
    Always required
    Always required

  • If you are distributing your application on non-English (US) based versions of Microsoft Windows, you may need to distribute:

    MSVCIRT.DLL

  • NOTE: You should always test your product distribution on a system that has Windows (and *only* Windows) installed. If software other than Windows (e.g., Microsoft Office) has been installed on the test system, there may be DLLs present on the system that would not otherwise be present. You could be misled into thinking that your distribution supplies all the necessary DLLs when in fact it doesn't.

    You can use the "depends" tool to determine what DLLs are required to run your appliation. A GUI version of this tool is included with Visual Studio, and a command-line version can be found on the internet.

 

UNIX

The Open Inventor run-time system is dependent on the compiler version and the operating system the Open Inventor release was compiled with. Some of required system libraries are operating system dependent.

Open Inventor Libraries

The Runtime License permits you to redistribute these files, which are necessary for an Open Inventor 8.6 UNIX platform runtime distribution:

libInventor.so
libInventorGui.so
libInventorBase.so
libInventorImage.so
libInventorGL.so
libInventorXt.so
libInventorAlgorithms.so
libInventorCuda.so
libInventorCudaAlgorithms.so
libInventorOpenCL.so
libInventorOpenCLAlgorithms.so
libScaleViz.so
libDirectViz.so
libDialogVizXt.so
libDialogVizQt.so
libDirectVizQt.so
libDirectVizShaders.so
libDirectVizXt.so
libScaleVizXt.so
libScaleVizQt.so
libClusterCom-base.so
libClusterCom-local.so
libHardCopy.so
libHardCopyXt.so
libFXViz.so
libInventorWx.so
libInventorQt4.so
libSolidViz.so
libTerrainViz.so
libTerrainVizXt.so
libVolumeViz.so
libLDM.so
libReservoirViz.so
libMeshViz.so
libMeshVizXt.so
libMeshVizDataMapping.so
libMeshVizExtractor.so
libMeshVizImpl.so
 
libIvTune.so

version 8.6
version 8.6
version 8.6
version 8.6
version 8.6
version 8.6
version 8.6
version 8.6 (Only required if using CUDA optimization module)
version 8.6 (Only required if using CUDA optimization module)
version 8.6 (Only required if using OpenCL optimization module)
version 8.6 (Only required if using OpenCL optimization module)
version 8.6
version 8.6 (Only required on Linux platform)
version 8.6 (Only required if DialogViz application)
version 8.6 (Only required if DialogViz application using Qt 4.x)
version 8.6 (Only required if DirectViz application, see below for more information)
version 8.6 (Only required if DirectViz application)
version 8.6 (Only required if DirectViz application)
version 8.6 (Only required if application makes use of Cluster Mode)
version 8.6 (Only required if application makes use of Cluster Mode)
version 8.6 (Only required if application makes use of Cluster Mode)
version 8.6 (Only required if application makes use of Cluster Mode)
version 8.6 (Only required if HardCopy application)
version 8.6 (Only required if HardCopy application)
version 8.6 (Only required if FXViz application)
version 8.6 (Only required if SoWx application)
version 8.6 (Only required if SoQt application using Qt 4.x)
version 8.6 (Only required if SolidViz application)
version 8.6 (Only required if TerrainViz application)
version 8.6 (Only required if TerrainViz application)
version 8.6 (Only required if VolumeViz application)
version 8.6 (Only required if ReservoirViz or VolumeViz application)
version 8.6 (Only required if ReservoirViz application)
version 8.6 (Only required if MeshViz application)
version 8.6 (Only required if MeshViz application)
version 8.6 (Only required if MeshViz Interface application)
version 8.6 (Only required if MeshViz Interface application)
version 8.6 (Only required if MeshViz Interface application)
 
version 8.6 (Only required if you want access to IvTune from your app.)
NOTE: IvTune requires the shared library for FxViz, MeshViz XLM, ScaleViz, ReservoirViz, SolidViz, TerrainViz, and VolumeViz, as well as libInventorQt, libInventorGui and the Qt shared library for the version of Qt that was used to build IvTune. If you plan to allow IvTune to be launched from your application, then you must redistribute all of these files, even if they are not otherwise required by your application.

libIvDLBZlib.so/sl
libIvDLDxf.so/sl
libIvDLFlt.so/sl
libIvDLFreetype.so/sl
libIvDLJasper.so/sl
libIvDLJpeg.so/sl
libIvDLLm.so/sl
libIvDLPdf.so/sl
libIvDLPng.so/sl
libIvDLProj4.so/sl
libIvDLTiff.so/sl
libIvDLZlib.so/sl

Compression library
DXF import
OpenFlight import
FreeType support
JPEG 2000 support (import/export)
JPEG support (import/export)
FLEXnet floating license support
PDF 3D support
PNG support (import/export)
Cartographic projection support
TIFF support (import/export)
Compression library

These files are normally installed in the <OIV_INSTALL_DIR>/lib directory. Unless otherwise indicated, all of these files must be supplied.

The libraries prefixed with "libIvDL" are dynamically loaded. Your application can tell Open Inventor to load alternate libraries using the following environment variables:

OIV_BZLIB_NAME
OIV_FREETYPE_NAME
OIV_LIBDXF_NAME
OIV_LIBFLT_NAME
OIV_LIBJASPER_NAME
OIV_LIBJPEG_NAME
OIV_LIBPNG_NAME
OIV_LIBPROJ4_NAME
OIV_LIBTIFF_NAME
OIV_ZLIB_NAME

If you have chosen to use one or more alternate libraries, be sure to distribute the alternate libraries that your application needs.

Note that in order for your user to use the Inventor libraries, they need to be in a directory whose path is in the LD_LIBRARY_PATH environment variable. The dynamically loaded libraries are searched for in the following locations: $LD_LIBRARY_PATH and $OIV_LD_LIBRARY_PATH.

NVidia Complex Required Library

The following files must be redistributed:

libcomplex.so

NVidia Complex library

TBB Required Libraries

The following files must be redistributed if your application uses MeshViz Interface:

libtbb.so
libtbbmalloc.so

tbb kernel library
tbb malloc library

OpenRTRT Required Libraries

The following files must be redistributed if your application uses DirectViz:

OpenRTClient
libOpenRT.so
libRTX.so

OpenRT client
OpenRTRT kernel library
OpenRTRT shaders library

PDF 3D Export Required Libraries

The following files must be redistributed if your application uses PDF 3D export:

libhpdf.so
libIFXCore.so
Plugins/IFXExporting.so
Plugins/IFXScheduling.so

Resource File for Viewers (Motif only)

The strings used for labeling GUI components and menu items in a standard Open Inventor viewer are supplied in the following Motif resource file:

<OIV_INSTALL_DIR>/app-defaults/Inventor

This file should be distributed with your application and placed where Motif will find it. Motif searches in /usr/lib/X11/app-defaults as well as in the directories specified by the XAPPLRESDIR environment variable. See Motif documentation for further details.

NOTE: If you forget to supply this resource file, the internal widget names will be used for the names; the strings will all start with the prefix "Iv".

 

OS Independant

Open Inventor and VolumeViz Shaders Files

If your application uses the Open Inventor or VolumeViz shaders files located in <OIV_INSTALL_DIR>/data/shaders, you may distribute the shaders files used by your application. Open Inventor looks for shaders files in the directory specified by environment variable OIV_FILE_SEARCH_PATHS.

VolumeViz Predefined Shaders

If your application uses VolumeViz, you will need to redistribute the predefined shader files from <OIV_INSTALL_DIR>/data/volumeviz/shaders. Open Inventor searches for predefined shaders in the current directory, then in the directory specified by environment variable IVVR_SHADERS_PATH. On Windows, it additionally searches in the directory that contains the VolumeViz DLL.

ScaleViz Files

If your application is a cluster-enabled application, you must distribute the following files:

  • The Open Inventor Render Unit (OIRU). Its file name is oiru.exe on Windows and oiru on UNIX.
  • The ScaleViz daemon/service program named scalevizd.exe on Windows and scalevizd on UNIX.
  • For each ScaleViz communication layer you want to provide, you should distribute the corresponding
    - launch-<name>.bat (windows) or launch-<name>.sh (UNIX)
    - ClusterCom-<name>.DLL (windows) or libClusterCom-<name>.so (UNIX) communication library file.
    Important note: If the communication layer library has other dependencies like MPI, do not forget to distribute them too (mpiexec, libmpi ...)

You will also need to distribute a selection of configuration files and appropriate instructions so that the user can select the one that is appropriate for his/her cluster configuration.

Note that whether your application is cluster-enabled or not, you will need to distribute the ScaleViz shared library as indicated previously.

WARNING: IvTune Access to Scene Graph

By default, a user can launch IvTune from any Open Inventor viewer with just a few keypresses (SHIFT+F12 by default). IvTune allows the user to view the scene graph contents and even modify them. To protect your application's scene graph, we recommend disallowing this feature when you distribute your application. The most secure method is to disable IvTune access programmatically, either by calling

SoDB::setIvTuneAllowed(FALSE);

or by calling

SoPreferences::setBool("OIV_NO_IVTUNE",TRUE);

Open Inventor Font Files

If your application uses the Open Inventor stroke fonts (<OIV_INSTALL_DIR>/data/fonts), you may distribute the font files used by your application. Open Inventor looks for stroke font files in the directory specified by environment variable OIV_STROKE_FONT_PATH.

Dragger Geometry Files

If your application uses draggers that you have customized by supplying modified dragger geometry files, you will need to supply these modified dragger geometry files to your customers. Open Inventor looks for dragger geometry files in the directory specified by environment variable SO_DRAGGER_DIR.

It is NOT necessary to distribute the standard dragger geometry files because the default dragger geometry is already compiled into the Open Inventor DLLs. You may choose to compile custom dragger geometry into your application.

Material Palette Files

If you anticipate that your customer will use the Material Palette (which is part of the standard Material Editor), you may wish to distribute the materials used by the Material Palette:

    <OIV_INSTALL_DIR>\data\materials

On Windows, Open Inventor searches for the materials in the directory specified by the following system registry item:

HKEY_LOCAL_MACHINE
  SOFTWARE
    Visualization Sciences Group S.A.S.
      Shared Resources
        MATERIALS_PATH

On UNIX, Open Inventor searches for the materials in the following locations:

  • /usr/share/data/material
  • the path specified by environment variable OIV_MATERIALS_PATH

Help File

The standard Open Inventor viewers have a "?" button on the right side used for accessing a help file. By default, it accesses the Open Inventor Reference Manual which contains information suitable for Open Inventor programmers. If you want to use this button to provide useful information to your end users, you will need to create a help file containing information specific to your application, and then tell the Inventor viewer to display your help file when the "?" button is pressed. See SoWinComponent or SoQtComponent for details. Be sure to include your custom help file when distributing your application.