====== Installation ======
The current release of SpeedTree Engine for Clarisse does not include an installer, so a few files must be copied manually.


<note important>
Please remember to remove the older SpeedTree files if you're installing a new version.
</note>


===== Quick & Dirty =====

==== Linux ====
  - Copy **libspeedtree_clarisse_v8.4.2r5.so** to [Clarisse Install Path]/Clarisse/module/.
  - Copy **libspeedtree_engine_v8.4.2r5.so** to [Clarisse Install Path]/Clarisse/.


==== Windows ====
  - Copy **speedtree_clarisse_v8.4.2r5.dll** to [Clarisse Install Path]\Clarisse\module\.
  - Copy **speedtree_engine_v8.4.2r5.dll** to [Clarisse Install Path]\Clarisse\. \\ (Under Windows, the default installation path is "C:\Program Files\Isotropix\Clarisse iFX 3.6 SP6\", for example)

===== Clean Approach =====

Copy the engine shared library file (libspeedtree_engine_v8.4.2r5.so / speedtree_engine_v8.4.2r5.dll) to your desired path and adjust your system's binary execution path to include the library file's path.

  * On Windows, add this path to the PATH environment variable.
  * On Linux, add this path to the LD_LOAD_LIBRARY environment variable.

Copy the plugin file (libspeedtree_clarisse_v8.4.2r5.so / speedtree_clarisse_v8.4.2r5.dll) to your desired path and invoke the Clarisse executable with the -module_path option. It takes multiple paths and must include both the Clarisse default module path and your custom path. For example, if your custom path is /home/user/my_clarisse_plugins/:

  ./clarisse -module_path "/usr/local/bin/Clarisse 5.0 SP6/Clarisse/module" "/home/user/my_clarisse_plugins/"
  
  
<note important>
**Windows Only:** SpeedTree requires the Microsoft Visual C++ 2010 Redistributable package to be installed. For convenience for manual installation, the necessary files are included in the SpeedTree for Clarisse ZIP file under bin/msft_redistributables/. They should be copied into the same location as the speedtree_engine DLL.
</note>