Installation & Verification - C++ - Windows


Administrator privileges

Verify adequate disk space

Details on installers

Load Open Inventor from your installation media

Toolkit installation process

Documentation installation process

Using example programs

Essential MSVC++ settings

Configuring MSVC++

Uninstalling Open Inventor

Administrator privileges

Administrator privileges are required to install Open Inventor. If you do not have Administrator privileges on the machine where you are installing, Setup will not be able to create the Open Inventor program group or set up the Open Inventor environment variables at the System (all users) level.

User privileges are modified using the User Accounts.

Verify adequate disk space

See the System Requirements Overview topic for disk space requirements.

We recommend installing on an NTFS partition in order to take advantage of long file names. The Open Inventor libraries and DLLs have short names to facilitate redistribution, but the Open Inventor include files and example programs have long file names to convey extra information.

Details on installers

The complete installation contains two packages:

  • Open Inventor Toolkit :

    OpenInventorC++<product release>-Windows-Visual<compiler-release>-<architecture>.exe

    This package contains the include files, libraries, utilities, example programs, data files, and C++ reference manual in Windows help format.
    Example: OpenInventorC++940-Windows-Visual2012-x86_64.exe

  • Open Inventor Documentation :

    OpenInventorC++-<product release>-Documentation.exe

    This package contains the offline version of the "Open Inventor Developer Zone" documentation web site in HTML format including the full user's guide, reference manual, installation instructions and release notes.
    This package is optional and should be used only when no internet access is available. Some features are not available in the offline version, such as full indexed search. This package should be installed after the Open Inventor Toolkit package.

Load Open Inventor from your installation media

To install the Open Inventor SDK:

  • From a DVD:
    1. Insert the Open Inventor DVD.
    2. The DVD welcome screen appears. Click on the Install button to proceed.
    3. Follow the installation instructions.

      If the DVD welcome screen does not appear, you can run setup.exe as follows:

      • From a command line ("MS-DOS Prompt"),
      • By double clicking in the Windows Explorer, or
      • Selecting "Run" from the Task Bar's Start menu.
  • From downloaded files:
    Open Inventor downloaded files are installation programs that can be run directly.

    1. Download the file on the target system.
    2. Double-click on the file from the Windows Explorer.
    3. Follow the installation instructions.

Toolkit installation process

  1. Welcome dialog
  2. License Agreement dialog
  3. Components selection dialog
    You can choose to install or not the SDK, the runtime environment (debug or PDB files, release is mandatory), example programs (source code or binaries), and reference manual.

  4. Installation location dialog
    Setup will suggest a default location for the installation, e.g., C:\OpenInventor\9.4.0 C++ Visual2012 x64, and allows you to select a different location if desired. We recommend using a directory name that includes the version number.
    Avoid using the Windows operating systems C:\Program Files directory because it protects its content and you will not be able to edit and build example programs.
  5. Start Menu Folder dialog
    You can choose the Windows Start Menu folder. The default is to use the same name as for the installation folder.
  6. Install
    All Open Inventor files will be installed into the selected installation directory. With one exception (see MSVC++ below), the installer does not put any files in system directories, only in the selected installation directory.
  7. Copy License dialog
    At this step, the installer asks to locate the file containing the license strings necessary to unlock the product that you should have received from our licensing team. The environment variable OIV_LICENSE_FILE is set to the path of this file in the user's environment.
  8. Environment Variables
    Setup will set the following environment variables for all users (added to the System environment variables): OIVHOME, OIVARCH, OIV_LICENSE_FILE, and add to the PATH variable the path to the Open Inventor DLLs.

    NOTE: Environment variable changes do not affect running programs. To ensure that changes are applied, you may need to:
    • Log out and log in again,
    • Open the Control Panel, open the System applet, click on Advanced, click on Environment Variables, and click on OK.

  9. MSVC++ Customization
    The IVF AppWizard is an application similar to MSVC++'s MFC AppWizard for creating MFC-based Open Inventor applications. The IVF AppWizard can create an application with a simple drawing area, a basic viewer (e.g., Examiner Viewer), or a fully functional SceneViewer with the ability to select and edit objects.
    In versions prior to V9.1, the IVF Wizard was added to Visual Studio during the installation process. Now, the IVF application wizard is no longer installed during the installation process. It must be installed manually following the instructions given in the Configuring MSVC++ for Use with Open Inventor chapter.
  10. Program Group
    Setup will create the following icons in the Open Inventor group.
  • IvTune viewer: an application for viewing Open Inventor files.
  • Online documentation: a link to the Open Inventor Developer Zone containing the full documentation.
  • Samples browser: a program to browse and run the Open Inventor example programs.

For a complete list of installed files, see Open Inventor files.

  1. Completing the installation

The last installation dialog allows you to launch the Open Inventor Samples browser, to read the Readme file, and to access the online documentation.
To validate the installation, run the Samples browser and try to run some demonstration programs. See the Using example programs chapter for validation of the development environment.

Documentation installation process

The documentation installer contains a set of HTML pages extracted from the Open Inventor Developer Zone that can be used without internet access. However, some features of this documentation require Developer Zone access such as searching for names and for bugs.
Notice that the Open Inventor CHM help file is provided in the toolkit installer for faster access to the class help during appplication development.

  1. Welcome dialog
  2. License agreement dialog
  3. Installation location dialog
    Setup will suggest the same path where the toolkit was installed or a default location for the installation, e.g., C:\Open Inventor\9.4.0 C++ Documentation, and allows you to select a different location if desired. We recommend using a directory name that includes the version number.
  4. Start Menu Folder dialog
  5. Copy Files
    Setup will copy all documentation files into the selected installation directory. Setup does not put any files in system directories, only in the selected installation directory.
  6. Completing the installation
  7. Program Group
    Setup will create the following items in the Open Inventor\9.4.0 C++ Documentation group:
    1. Offline documentation
    2. Online documentation
    3. Open Inventor forum
    4. Reference manual

Using example programs

The Open Inventor toolkit comes with hundreds of example programs showing how to use the various features. The source code of these programs is located in the %OIVHOME%/src directory.
All example programs are already built and ready to be run after installation as soon as the environment variables are set.
The Samples Browser program can be used to browse these example programs, to run them, and to read their documentation (if it is available) and to access the source code directory.
Visual Studio projects are also available in each subdirectory for building and testing them. Each project can be reused or modified freely for experimenting. If you wish to generate your own Makefiles or project using CMake, please read the Build Examples section for more details.

Essential MSVC++ settings for an Open Inventor project

There are numerous ways to create an Open Inventor project in Visual C++. You can use the IVF AppWizard to create a new project complete with skeleton source files and project or makefile ready to build. You can also modify one of the provided Open Inventor make files or project files for your own project. You can also create simple projects from scratch or add Open Inventor support to an existing project. Here are some guidelines for Open Inventor projects.

  • Run-Time Library
    Open Inventor is compiled with (and absolutely requires) the runtime library option Multithreaded DLL (or Debug Multithreaded DLL). The IVF AppWizard selects this setting automatically.
    You must select this setting manually if your project was not created with the IVF AppWizard.

    Visual Studio

    1. In the Project menu, select Properties.
    2. In the left pane of the Property Pages dialog, open the C/C++ folder.
    3. In the left pane, click on Code Generation.
    4. In the right pane, click on Runtime Library, and from the list box, select Multi-threaded DLL (or Multi-threaded Debug DLL for the debug target).
  • Open Inventor Libraries
    The Open Inventor header files contain #pragma statements that automatically request the linker to search the necessary libraries.

    One exception is "UNIX style" programs (i.e., programs that have a main function), that are Windows applications, not console applications. These applications must include InventorU(D).LIB in the link string because they require a WinMain function, which is supplied by the InventorU library. Generally we recommend using a console application for this type of project.

    NOTE: For UNIX style programs that do have a main and that are Windows apps, we now recommend using SoWinApp.h in your application to simplify some of the housekeeping details. It has pragma statements to include the current version of InventorU.LIB and InventorUD.LIB. It also has the following statements so you no longer need to insert them directly in your code:

    		#ifdef _WIN32
    		#  define main ivMain

Configuring MSVC++ for use with Open Inventor

  1. Add include files and library files using Microsoft Visual Studio 2008.
    Pull down the Tools menu, and select Options...
    In the left pane, click on the Projects and Solutions folder, then select VC++ Directories.
    In the right pane, in the "Show Directories for" scrolling region, select Include files.
    Click the New button New button and enter the directory path of the Open Inventor include directory (e.g., %OIVHOME%\include).

    In "Show Directories for", select Library files.
    Click the New button and enter the directory path of the Open Inventor lib directory. You can add both release and debug paths (e.g., %OIVHOME%\arch-...-release\lib and %OIVHOME%\arch-...-debug\lib).

    Click OK to dismiss the Options... window.

  2. Add include files and library files using Microsoft Visual Studio 2010 and 2012.
    You can use property sheets to create project configurations that can be applied to multiple projects since project settings that are defined in .props files are inheritable, unlike project settings defined in Project Files (.vcxproj files). Therefore, a project configuration defined in a .vcxproj file can inherit project settings from one or more property sheets (.props files). For more information, see MSDN.
    In this file you can specify include path for Open Inventor include directory (e.g.,%OIVHOME%\include) and library path for libraries directories (e.g., %OIVHOME%\arch-...-release\lib and %OIVHOME%\arch-...-debug\lib).
  3. Installing the IVF AppWizard:

    1. Go to IvfWizard in the Open Inventor directory.
      For example, %OIVHOME%\tools\IvfWizard\
    2. Copy the contents of the vcprojects folder to the vcprojects folder in the directory where Visual Studio is installed. For example, C:\Program Files (x86)\Microsoft Visual Studio 9.0\VC\vcprojects\ or
      C:\Program Files (x86)\Microsoft Visual Studio 10.0\VC\vcprojects\ or C:\Program Files (x86)\Microsoft Visual Studio 11.0\VC\vcprojects\
    3. Copy the contents of the VCWizards folder to the VCWizards folder in the directory where Visual Studio is installed. For example, C:\Program Files (x86)\Microsoft Visual Studio 9.0\VC\VCWizards\ or
      C:\Program Files (x86)\Microsoft Visual Studio 10.0\VC\VCWizards\ or C:\Program Files (x86)\Microsoft Visual Studio 11.0\VC\VCWizards\

    The wizard will be available the next time that you select File, New Project in Visual C++ Projects, IVF AppWizard.

    NOTE: This wizard was installed by the product installer in versions prior to V9.1. This is no longer the case.

Uninstalling Open Inventor

According to Operating System you have different procedure to uninstall Open Inventor. For example for Windows 7, it can be removed with the Programs and Features in the Control Panel. Select Open Inventor C++ 9.4.0 Visual2012 x64 from the list and uninstall it.