This page is currently written for Linux.
As new versions of HtoA are released it is possible previous scenes will not work anymore if parameters or connections have changed.
If the errors are minor Houdini may display a warning and still open the file. However, if the errors are more severe then Houdini may crash, preventing access to older scenes.
$ terminate called after throwing an instance of 'std::out_of_range'
It is possible to fix these scenes to allow them to be opened. Note that any connections to altered parameters will not be relinked.
A script called hipfix.py is provided to update scenes to the latest version. It is located in the
scripts folder in the HtoA install directory
For each scene-breaking release, a set of definitions is used to alter the .hip file.
Before running the script you must define the HFS environment variable or source the Houdini environment.
- Navigate to your Houdini install directory
- Go to the Start menu
- Go to Programs
- Go to Side Effects Software
- Select the installed Houdini version
- Click on "Command Line Tools"
- Go to Applications on the main system drive (Macintosh HD)
- Go to the installed version of Houdini you wish to use
- Double click on the "Houdini Shell.terminal"
Here is a scene created with 0.9.2 which has a texture assigned to the Density parameter of a Spotlight's Gobo.
All the available parameters are visible on the gobo1 node.
Linkability to Gobo parameters was removed in Arnold 4.1.1 which is what HtoA 0.10.0 uses so the above scene crashes when opened in that version.
To convert the file navigate to the location of the scene to be fixed and run hipfix.py.
If the fix was successful you should get a result like below.
Now the scene should be able to be opened with any fixes applied. In this case, we can see that the Gobo's parameters have been updated and the image node has been disconnected.