Houdini plugin - Installation

The plug-in is installed with an installer wizard on Windows 32-bit, Windows 64-bit and Mac OSX 64-bit platforms, and a shell script on Linux 64-bit platform, so you will not have to manually copy files.

The plug-in is installed to the program folder by default, in subfolders named by the plug-in version number and Houdini version number. This has two benefits:

the Houdini install folder remains clean, no files are modified
more builds of the plug-in can be installed at the same time

To make the plug-in available in Houdini, the following environment variables have to be defined:

HOUDINI_PATH have to point to the plugin installation folder. Use the & symbol to include the default houdini paths. For example in the Windows command line:
```
set HOUDINI_PATH=^&;c:\Program Files (x86)\Next Limit\Maxwell for Houdini\v1.3.0\H12.1.125
```

PATH have to point to the bin folder of the plugin install. For example in the Windows command line:
```
set PATH=%PATH%;c:\Program Files (x86)\Next Limit\Maxwell for Houdini\v1.3.0\H12.1.125\bin
```

The installers set the environment variables automatically if you choose this option, or you can create a script which sets the variables and starts Houdini.

The plug-in consist of the following files:

Plug-in binary

houdini\dso\ROP_Maxwell.dll (.so on Linux, .dylib on OSX)

IPR binaries

bin\Maxwell_IPR (.exe on Windows)

Dialog windows

houdini\config\Applications\maxwell\maxwell_settings.ui
houdini\config\Applications\maxwell\maxwell_texture.ui

Icons

houdini\config\Icons\material\*
houdini\config\Icons\maxwell_camera.png
houdini\config\Icons\maxwell_grass.png
houdini\config\Icons\maxwell_render_hda.png
houdini\config\Icons\ROP_maxwell_render.png
houdini\config\Icons\SHOP_maxwell_bsdf.png
houdini\config\Icons\SHOP_maxwell_coating.png
houdini\config\Icons\SHOP_maxwell_displacement.png
houdini\config\Icons\SHOP_maxwell_emitter.png
houdini\config\Icons\SHOP_maxwell_layer.png
houdini\config\Icons\SHOP_maxwell_layers.png
houdini\config\Icons\SHOP_maxwell_material.png
houdini\config\Icons\SOP_maxwell_environment.png

Material gallery

houdini\gallery\maxwell_material.gal

Digital Assets

houdini\otls\OPmaxwellcam.otl
houdini\otls\OPmaxwellcamp.otl
houdini\otls\OPmaxwellenv.otl
houdini\otls\OPmaxwellgrass.otl
houdini\otls\OPmaxwellmaterial.otl
houdini\otls\OPmaxwellobjp.otl
houdini\otls\OPmaxwellrender.otl

Python scripts

houdini\soho\maxwell_render.py
houdini\python2.6libs\maxwell.py
houdini\python2.6libs\maxwell_ipr.py

Shelf

toolbar\maxwell
toolbar\MaxwellRenderTools

Menu extension

\houdini\MainMenuMaster

The plug-in built for the latest Houdini production builds. If you need a build for an older Houdini version, please contact the Maxwell Render support.

The installer mechanism has changed in version 1.3.0 and the plug-in conflicts with older releases. The installer automatically detects if an older version of the plug-in is installed and removes it before the installation starts.

Installer for Windows

The Windows installer wizard asks about the install location which is in the Program Files directory by default, the target Houdini version and the environment variable settings.

After a successful install you should see the „Maxwell Render” group in the obj network TAB menu and the Maxwell Render shelf. You can check the plug-in version by typing the maxwell_plugin_version hscript command, or get the Mawell ROP node info and check the path of the defining otl.

The plug-in can be uninstalled through the Add or Remove Programs in the Control Panel.

Installer for OSX

The Mac OSX build of the plug-in requires OSX version 10.5 or above. The installer copies the plug-in files to the /Applications/NextLimit/MaxwellForHoudini/[plugin_version]/[Houdini_version] folder by default and prompts to the admin password if needed. The folder can be changed in the installer. The installer sets the environment variables in the ~/.profile file.

After a successful install you should see the „Maxwell Render” group in the obj network TAB menu and the Maxwell Render shelf. You can check the plug-in version by typing the maxwell_plugin_version hscript command, or get the Mawell ROP node info and check the path of the defining otl.

If the plug-in is not recognized, you have to activate the environment variables with reloading the profile (source ~/.profile command or have to log out and log in again).

The plug-in can be uninstalled with the uninstall.sh script which is located in the plug-in installation folder. The uninstaller removes all installed files and restores the environment variables.

Installer for Linux

The plug-in ships with a shell script called install.sh which will copy the plug-in files to the /opt/NextLimit/MaxwellForHoudini/[plugin_version]/[Houdini_version] folder by default. To change the Houdini installation folder, you have to edit the script file. The installer asks about adding the environment variables to the ~/.profile file.

After a successful install you should see the „Maxwell Render” group in the obj network TAB menu and the Maxwell Render shelf. You can check the plug-in version by typing the maxwell_plugin_version hscript command, or get the Mawell ROP node info and check the path of the defining otl.

If the plug-in is not recognized, you have to activate the environment variables with reloading the profile (source ~/.profile command or have to log out and log in again).

The plug-in can be uninstalled with the uninstall.sh script which is located in the plug-in installation folder. The uninstaller removes all installed files and restores the environment variables.

The LD_LIBRARY_PATH should contain the /opt/hfs[version]/dsolib folder to run the IPR process properly. If it’s not set, you can create a wrapper to the IPR executable:

move Maxwell_IPR to Maxwell_IPR.bin

create Maxwell_IPR with this content:

#!/bin/sh
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$HDSO
$0.bin $@

.