Open Inventor Redistribution

 

Once you have created an application program using Open Inventor on your development platform, you may want to package it for redistribution on other end-user computers. To do that, you'll need to bundle some of the Open Inventor files with your program. You will find below the description of the run-time files that can be redistributed for each platform and for each programming language.

 


Licensing

Windows

Linux

OS X

OS Independent

Java

.NET


Licensing

Your Open Inventor Development License entitles you to use the SDK to create and execute Open Inventor programs on the licensed machine and you may need an additional Run-Time license agreement with FEI allowing you to redistribute the Open Inventor run-time.

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.

Notice that runtime licenses cannot unlock Open Inventor SDK installations. Since Open Inventor version 8, runtime licenses fail to unlock Open Inventor based applications when :

  • an Open Inventor installer has been used
  • one of the Open Inventor directories doc, include, arch*\lib (Windows only) or src can be found on disk
  • using  Open Inventor debug dlls (Windows only)

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 on Windows. Unless otherwise indicated, all of these files must be supplied.

NOTE: You are not allowed to distribute debug DLLs, e.g., InventorD.DLL.

Inventor.DLL
InventorR.DLL
InventorBase.DLL
InventorGL.DLL
InventorImage.DLL
InventorGui.DLL
InventorWin.DLL
InventorAlgorithms.DLL
InventorDialogs.DLL
InventorCuda.DLL
InventorCudaAlgorithms.DLL
InventorCL.DLL
InventorCLAlgorithms.DLL
ScaleViz.DLL
ScaleVizRemote.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
RemoteVizServices.DLL
SolidViz.DLL
TerrainViz.DLL
TerrainVizWin.DLL
VolumeViz.DLL
LDM.DLL
MeshViz.DLL
MeshVizWin.DLL
MeshVizDataMapping.DLL
MeshVizExtractor.DLL
MeshVizImpl.DLL
ImageViz.DLL

version 9.4
version 9.4
version 9.4
version 9.4
version 9.4
version 9.4
version 9.4
version 9.4
version 9.4 (Only required if record feature is activated in viewer)
version 9.4 (Only required if using CUDA optimization module)
version 9.4 (Only required if using CUDA optimization module)
version 9.4 (Only required if using OpenCL optimization module)
version 9.4 (Only required if using OpenCL optimization module)
version 9.4
version 9.4
version 9.4
 (Only required if utilizing DirectViz application)
version 9.4 (Only required if application makes use of Cluster Mode)
version 9.4 (Only required if SoQt application makes use of Cluster Mode)
version 9.4 (Only required if application makes use of Cluster Mode)
version 9.4 (Only required if application makes use of Cluster Mode)
version 9.4 (Only required if application makes use of Cluster Mode)
version 9.4 (Only required if making use of IVF MBCS application)
version 9.4 (Only required if making use of IVF UNICODE application)
version 9.4 (Only required if utilizing DialogViz application)
version 9.4 (Only required if utilizing DialogViz application)
version 9.4 (Only required if utilizing DirectViz application, see below for more information)
version 9.4 (Only required if utilizing DirectViz application)
version 9.4 (Only required if utilizing DirectViz application)
version 9.4 (Only required if utilizing HardCopy application)
version 9.4 (Only required if utilizing HardCopy application)
version 9.4 (Only required if utilizing FXViz application)
version 9.4 (Only required if utilizing SoQt application)
version 9.4 (Only required if utilizing SoWx application)
version 9.4 (Only required if utilizing RemoteViz application)
version 9.4 (Only required if utilizing SolidViz application)
version 9.4 (Only required if utilizing TerrainViz application)
version 9.4 (Only required if utilizing TerrainViz application)
version 9.4 (Only required if utilizing VolumeViz application)
version 9.4 (Only required if utilizing VolumeViz application)
version 9.4 (Only required if utilizing MeshViz application)
version 9.4 (Only required if utilizing MeshViz application)
version 9.4 (Only required if utilizing MeshViz XLM application)
version 9.4 (Only required if utilizing MeshViz XLM application)
version 9.4 (Only required if utilizing MeshViz XLM application)
version 9.4 (Only required if utilizing ImageViz application) 

  IvTune DLLs  

Only required if you want access to IvTune from your application. IvTune requires the DLL (shared library) for FxViz, MeshViz XLM, ScaleViz, 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.

IvTune.DLL
IvTuneExtenderAPI.DLL
IvtDefault.DLL
qwt5.DLL
IvtTools.DLL
IvtToolsLDM.DLL

version 9.4
version 9.4
version 9.4
version 9.4
version 9.4 (Only required if utilizing Open Inventor extension for  IvTune)
version 9.4 (Only required if utilizing VolumeViz/LDM extension for IvTune)

Import file format DLLs

The following file must be redistributed if your application import one of the specific file format listed below. Notice that CATIA, STEP and IGES readers require a separate license.

IvAcisReader.DLL
IvDxfReader.DLL
IvFltReader.DLL
IvStlReader.DLL
IvGenericFileReader.DLL

CATIA, IGES, STEP import
DXF import
OpenFlight import
STL import
Raster images & VolumeViz formats import

Dynamically loaded DLLs

The DLLs prefixed with "IvDL" are dynamically loaded. The following files must be redistributed. 

IvDLBZlib.DLL
IvDLZlib.DLL
IvDLFreeType.DLL
IvDLJasper.DLL
IvDLJpeg.DLL

IvDLTiff.DLL
IvDLPng.DLL
IvDLLm.DLL
IvDLPdf.DLL
IvDLProj4.DLL
IvDLOpenAL32.DLL

IvDLALut.DLL
IvDLCSG.DLL

Compression library
Compression library
FreeType font support
JPEG 2000 support (import/export)
JPEG support (import/export)

TIFF support (import/export)
PNG support (import/export)
FLEXnet floating license support
PDF/U3D support
Cartographic projection support
Spatial sound management

Spatial sound management
CSG library

Your application can tell Open Inventor to load alternate versions of these DLLs using the following environment variables:

OIV_BZLIB_NAME
OIV_ZLIB_NAME
OIV_FREETYPE_NAME
OIV_LIBJASPER_NAME
OIV_LIBJPEG_NAME

OIV_LIBTIFF_NAME
OIV_LIBPNG_NAME
OIV_LIBPROJ4_NAME
OIV_OPENAL_NAME

OIV_ALUT_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%.

Qt DLLS

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

The following files must be redistributed if your application uses Qt features:

QtCore4.dll
QtGui4.dll
QtOpenGL4.dll
QtXml4.dll

 

Nvidia Complex Required DLL

The following file must be redistributed if your application uses ScaleViz in a multipipe quadroplex context.

complex1.6.dll

NVidia Complex library

TBB Required DLLs

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

IvTbb.dll
IvTbbmalloc.dll
IvTbbmalloc_proxy.dll

tbb kernel library
tbb malloc library
tbb malloc proxy library

Note: the TBB libraries and entry points have been renamed to avoid conflicts with other versions usedin customer applications.

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

ImageViz Required DLLS

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

fei.proxy.AccessVisilib_x64.dll
fei.proxy.Data_x64.dll
fei.proxy.LgSkeletonPolyg_x64.dll
fei.proxy.Reconstruction_x64.dll
fei.proxy.ServiceHandler_x64.dll
fei.proxy.VisilogAPI_x64.dll
fei.proxy.VisilogProxy_x64.dll
fei.proxy.VlgUtil_x64.dll
LaPack_3_2_2_x64_para.dll
log4cplus_x64.dll
MinPack_1999_x64_para.dll
LaPack_3_2_2_x64_para.dll
vlgboost_chrono-vc100-mt-1_51.dll
vlgboost_date_time-vc100-mt-1_51.dll
vlgboost_filesystem-vc100-mt-1_51.dll
vlgboost_system-vc100-mt-1_51.dll
vlgboost_thread-vc100-mt-1_51.dll
zlibwapi.dll
hxquant2plugin\fei.proxy.ippro51_x64.dll
hxquant2plugin\fei.proxy.porosity_x64.dll
hxquant2plugin\fei.proxy.UsrTwain_x64.dll
hxquant2plugin\fei.proxy.VlgPluginSample_x64.dll
hxquant2plugin\fei.proxy.VlgSerialComm_x64.dll
hxquant2plugin\file format\fei.proxy.Fits_x64.dll
hxquant2plugin\file format\fei.proxy.Gatan_x64.dll
hxquant2plugin\file format\fei.proxy.His_x64.dll
hxquant2plugin\file format\fei.proxy.Jpeg_x64.dll
hxquant2plugin\file format\fei.proxy.Oxford_x64.dll
hxquant2plugin\file format\fei.proxy.PostScript_x64.dll
hxquant2plugin\file format\fei.proxy.ShapeFile_x64.dll
hxquant2plugin\file format\fei.proxy.Targa_x64.dll
hxquant2plugin\file format\fei.proxy.Tiff_x64.dll

Other Required DLLs

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

    Visual Studio 2013
    MSVCR120.DLL
    MSVCP120.DLL
    VCOMP120.DLL
    MFC120.DLL


    Always required
    Always required
    Always required
    Only required if IVF application

    We recommend to install Microsoft Visual C++ 2013 Update 1 Redistributable. (vcredist_xXX.exe available in the directory arch-Windows-xXX-msvc12-Release\bin)

    Visual Studio 2012
    MSVCR110.DLL
    MSVCP110.DLL
    VCOMP110.DLL
    MFC110.DLL


    Always required
    Always required
    Always required
    Only required if IVF application

    We recommend to install Microsoft Visual C++ 2012 Update 3 Redistributable. (vcredist_xXX.exe available in the directory arch-Windows-xXX-msvc11-Release\bin)

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


    Always required
    Always required
    Always required
    Only required if IVF application

    We recommend to install Microsoft Visual C++ 2010 SP1 Redistributable. (vcredist_xXX.exe available in the directory arch-Windows-xXX-msvc10-Release\bin)

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


    Always required
    Always required
    Always required
    Only required if IVF application

    We recommend to install Microsoft Visual C++ 2008 SP1 Redistributable (9.1.30729.1). (vcredist_xXX.exe available in the directory arch-Windows-xXX-msvc9-Release\bin)

  • 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.

 

LINUX

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 Linux platform runtime distribution:

libInventor.so
libInventorGui.so
libInventorBase.so
libInventorImage.so
libInventorGL.so
libInventorXt.so
libInventorAlgorithms.so
libInventorDialogs.so
libInventorCuda.so
libInventorCudaAlgorithms.so
libInventorCL.so
libInventorCLAlgorithms.so
libScaleViz.so
libScaleVizRemote.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
RemoteVizServices.so
libSolidViz.so
libTerrainViz.so
libTerrainVizXt.so
libVolumeViz.so
libLDM.so
libMeshViz.so
libMeshVizXt.so
libMeshVizDataMapping.so
libMeshVizExtractor.so
libMeshVizImpl.so
 

version 9.4
version 9.4
version 9.4
version 9.4
version 9.4
version 9.4
version 9.4
version 9.4 (Only required if record feature is activated in viewer)
version 9.4 (Only required if using CUDA optimization module)
version 9.4 (Only required if using CUDA optimization module)
version 9.4 (Only required if using OpenCL optimization module)
version 9.4 (Only required if using OpenCL optimization module)
version 9.4
version 9.4
version 9.4 (Only required on Linux platform)
version 9.4 (Only required if DialogViz application)
version 9.4 (Only required if DialogViz application using Qt 4.x)
version 9.4 (Only required if DirectViz application, see below for more information)
version 9.4 (Only required if DirectViz application)
version 9.4 (Only required if DirectViz application)
version 9.4 (Only required if application makes use of Cluster Mode)
version 9.4 (Only required if application makes use of Cluster Mode)
version 9.4 (Only required if application makes use of Cluster Mode)
version 9.4 (Only required if application makes use of Cluster Mode)
version 9.4 (Only required if HardCopy application)
version 9.4 (Only required if HardCopy application)
version 9.4 (Only required if FXViz application)
version 9.4 (Only required if SoWx application)
version 9.4 (Only required if SoQt application using Qt 4.x)

version 9.4 (Only required if utilizing RemoteViz application)
version 9.4 (Only required if SolidViz application)
version 9.4 (Only required if TerrainViz application)
version 9.4 (Only required if TerrainViz application)
version 9.4 (Only required if VolumeViz application)
version 9.4 (Only required if VolumeViz application)
version 9.4 (Only required if MeshViz application)
version 9.4 (Only required if MeshViz application)
version 9.4 (Only required if MeshViz XLM application)
version 9.4 (Only required if MeshViz XLM application)
version 9.4 (Only required if MeshViz XLM application)
 

 

IvTune Libraries

Only required if you want access to IvTune from your application. IvTune requires the shared library for FxViz, MeshViz XLM, ScaleViz, 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.

libIvTune.so
libIvTuneExtenderAPI.so
libIvtDefault.so
libqwt.so.5.2.0
libIvtTools.so
libIvtToolsLDM.so

version 9.4
version 9.4
version 9.4
version 9.4
version 9.4 (Only required if utilizing Open Inventor extension for  IvTune)
version 9.4 (Only required if utilizing VolumeViz/LDM extension for IvTune)

Import file format Libraries

The following file must be redistributed if your application import one of the specific file format listed below. Notice that CATIA, STEP and IGES readers require a separate license.

libIvAcisReader.so
libIvDxfReader.so
libIvFltReader.so
libIvStlReader.so
libIvGenericFileReader.so

CATIA, IGES, STEP import
DXF import
OpenFlight import
STL import

Raster images & VolumeViz formats import

Dynamically loaded Libraries

The libraries prefixed with "IvDL" are dynamically loaded. The following files must be redistributed. 

libIvDLBZlib.so
libIvDLFreetype.so
libIvDLJasper.so
libIvDLJpeg.so
libIvDLLm.so
libIvDLPdf.so
libIvDLPng.so
libIvDLProj4.so
libIvDLTiff.so
libIvDLZlib.so
libIvDLCSG.so

Compression library
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

CSG library

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

 Your application can tell Open Inventor to load alternate libraries using the following environment variables:

OIV_BZLIB_NAME
OIV_FREETYPE_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.

 

Qt Libraries

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

The following files must be redistributed if your application uses Qt features:

libQtCore.so.4.6.3
libQtGui
.so.4.6.3
libQtOpenGL.so.4.6.3
libQtXml.so.4.6.3
 

 

NVidia Complex Required Library

The following files must be redistributed, if your application uses ScaleViz in a multipipe quadroplex context.

libcomplex.so

NVidia Complex library

TBB Required Libraries

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

libIvTbb.so
libIvTbbmalloc.so

tbb kernel library
tbb malloc library

Note: the TBB libraries and entry points have been renamed to avoid conflicts with other versions usedin customer applications.

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 X

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 Mac OS X platform runtime distribution:

libInventor.dylib
libInventorGui.dylib
libInventorBase.dylib
libInventorImage.dylib
libInventorGL.dylib

libInventorAlgorithms.dylib
libScaleViz.dylib
libScaleVizRemote.dylib
libDialogVizQt.dylib
libScaleVizQt.dylib
libClusterCom-base.dylib
libClusterCom-local.dylib
libHardCopy.dylib
libFXViz.dylib
libInventorQt4.dylib
libSolidViz.dylib
libTerrainViz.dylib
libVolumeViz.dylib
libLDM.dylib
libMeshViz.dylib
libMeshVizDataMapping.dylib
libMeshVizExtractor.dylib
libMeshVizImpl.dylib
 

 

version 9.4
version 9.4
version 9.4
version 9.4
version 9.4

version 9.4
version 9.4
version 9.4
version 9.4 (Only required if DialogViz application using Qt 4.x)
version 9.4 (Only required if application makes use of Cluster Mode)
version 9.4 (Only required if application makes use of Cluster Mode)
version 9.4 (Only required if application makes use of Cluster Mode)
version 9.4 (Only required if HardCopy application)
version 9.4 (Only required if FXViz application)
version 9.4 (Only required if SoQt application using Qt 4.x)
version 9.4 (Only required if SolidViz application)
version 9.4 (Only required if TerrainViz application)
version 9.4 (Only required if VolumeViz application)
version 9.4 (Only required if VolumeViz application)
version 9.4 (Only required if MeshViz application)
version 9.4 (Only required if MeshViz XLM application)
version 9.4 (Only required if MeshViz XLM application)
version 9.4 (Only required if MeshViz XLM application)
 

IvTune Libraries

Only required if you want access to IvTune from your application. IvTune requires the shared library for FxViz, MeshViz XLM, ScaleViz, 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.

libIvTune.dylib
libIvTuneExtenderAPI.dylib
libIvtDefault.dylib
libIvtTools.dylib
libIvtToolsLDM.dylib

version 9.4
version 9.4
version 9.4
version 9.4 (Only required if utilizing Open Inventor extension for  IvTune)
version 9.4 (Only required if utilizing VolumeViz/LDM extension for IvTune)

Import file format Libraries

The following file must be redistributed if your application import a specific file format.


libIvDxfReader.dylib
libIvFltReader.dylib
libIvStlReader.dylib
libIvGenericFileReader.dylib


DXF import
OpenFlight import
STL import

Raster images & VolumeViz formats import

Dynamically loaded Libraries

The libraries prefixed with "IvDL" are dynamically loaded. The following files must be redistributed. 

libIvDLBZlib.dylib
libIvDLFreetype.dylib
libIvDLJasper.dylib
libIvDLJpeg.dylib
libIvDLLm.dylib
libIvDLPng.dylib
libIvDLProj4.dylib
libIvDLTiff.dylib
libIvDLZlib.dylib
libIvDLCSG.dylib

Compression library
FreeType support
JPEG 2000 support (import/export)
JPEG support (import/export)
FLEXnet floating license support
PNG support (import/export)
Cartographic projection support
TIFF support (import/export)
Compression library

CSG library

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

 Your application can tell Open Inventor to load alternate libraries using the following environment variables:

OIV_BZLIB_NAME
OIV_FREETYPE_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.

 

Qt Libraries

The following files must be redistributed if your application uses Qt features:

libQtCore.4.7.2.dylib
libQtGui
.4.7.2.dylib
libQtOpenGL.4.7.2.dylib
libQtXml.4.7.2.dylib


TBB Required Libraries

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

libIvTbb.dylib
libIvTbbmalloc.dylib

tbb kernel library
tbb malloc library

OS Independent

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 disabling this feature when redistributing 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 libraires. You may also 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. 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.

Java

The Open Inventor Java run-time located in the jre folder contains several JAR files implementing the Java part of the API and a C++ run-time of the native part. The JAR files are portable across platforms like any other Java component but the C++ run-time is platform dependent. Thus redistributing Open Inventor Java requires to build separate installers for each platform.

The following packages are included in the Open Inventor Java run-time:

OpenInventor.jar
MeshViz_DataMapping.jar
MeshViz_Extraction.jar
MeshViz_MeshInterfaces.jar
Inventor.jar

Open Inventor java implementing the com.openinventor package
MeshViz Data Mapping package
MeshViz Extraction package
MeshViz Mesh interfaces package
Open Inventor java implementing the com.mc package (deprecated)

 

 

 

 

 

 

The jre folder can be copied as is for redistribution. However, If the com.mc package is not used, Inventor.jar and InventorJni.(dll/so) are not necessary. Conversely, If the com.openinventor package is not used, OpenInventor.jar and OpenInventorJni.(dll/so) are not necessary.

The property file located in the properties folder must also be redistributed.

.NET

The Open Inventor .NETrun-time located in the assemblies folder contains several assemblies implementing the .NET part of the API and a C++ run-time of the native part.

The following packages are included in the Open Inventor .NET run-time:

OIV.DirectViz
OIV.FxViz
OIV.HardCopy
OIV.Inventor.Algorithms
OIV.Inventor.Base
OIV.Inventor.Cuda
OIV.Inventor
OIV.Inventor.GL
OIV.Inventor.OpenCL
OIV.Inventor.SbLinear
OIV.Inventor.SbLinear.Compat
OIV.IvTune
OIV.LDM
OIV.MeshViz
OIV.ScaleViz
OIV.SolidViz
OIV.VolumeViz
 

 

DirectViz assembly
FxViz assembly
HardCopy assembly
Open Inventor Algorithms assembly
Open Inventor Base assembly
Open Inventor Cuda assembly
Open Inventor kernel assembly
Open Inventor GL assembly
Open Inventor OpenCL assembly
Open Inventor SbLinear assembly
Open Inventor SbLinear compatibility assembly
IvTune assembly
VolumeViz LDM assembly
MeshViz assembly
ScaleViz assembly
SolidViz assembly
VolumeViz assembly

 

 

 

 

 

 

 

 

 

 

 

 

 

 

The assemblies folder can be copied as is for redistribution.