Clone wiki

Coin / Redistribution

You are here: You are here: HomeDocumentationWindows information page → Redistribution


Distributing an application based on Coin3D

Which files do you need to distribute?

  • bin/coin2.dll - the main Coin library
  • bin/sowin1.dll - the Win32 GUI library
  • bin/simage1.dll - for texture support
  • msvcrt.dll - the MS CRT runtime library, usually found in %SystemRoot%\System32

You only need to distribute simage1.dll if your application uses textures. Coin looks for the simage1.dll at runtime, and will continue running (without texture support) if the DLL isn't found.

Where do you install the files?

It is recommended that you install all the Coin3D DLL files (coin2.dll, sowin1.dll, simage1.dll) in the same directory as your application executable, and not for instance in any of the system directories (i.e. %SystemRoot% or any of its subdirectories). This is to make sure that your application uses the correct version of the DLLs, in case there are other Coin3D DLLs on the system. Windows will always look for DLLs in the directory from which the application loaded before looking elsewhere (current directory, system directories, PATH).

Licensing issues

Please read the licensing information for the Coin3D libraries.

Some good advice

Always run your application through the "depends.exe" utility and verify that you are shipping all DLL files that the application depends on (except the system DLLs). The depends utility is a part of the Visual C++ toolset.