RailClone Reference
RailClone / Reference / Installation and Files

Installation and Files

This guide describes the files used by RailClone and how to customize it. We will use a default RailClone Pro installation, in RailClone ºLite some files may be different.

If <railclonedir> is the folder where you installed the software (C:\Program Files (x86)\Itoo Software\RailClone Pro by default) , and <maxdir> is your main Max directory, the setup program creates the folder structure shown below:

Folder Path
Maps <railclonedir>\maps
Library <railclonedir>\lib

The plugin and shaders for VRay and Mental Ray are copied here:

Folder Path
Max plugin <maxdir>\plugins\RailClonePro.dlo
VRay shaders <maxdir>\RailcloneVRay150sp2.dll, RailcloneVRay150sp3.dll and RailcloneVRay20.dll
Note: some files may not exist depending of the Max and the VRay version
MR shader library Max 2010 and before: <maxdir>\mentalray\shaders_autoload\shaders\RCShader.dll
Max 2011 and newer: <maxdir>\mentalimages\shaders_autoload\mentalray\shaders\RCShader.dll
MR shader descriptor Max 2010 and before: <maxdir>\mentalray\shaders_autoload\include\RCShader.mi
Max 2011 and newer: <maxdir>\mentalimages\shaders_autoload\mentalray\include\RCShader.mi

The following entries are created in the Windows Registry:

HKEY_LOCAL_MACHINE\SOFTWARE\Itoo Software\RailClone Pro
MainDir = C:\Program Files (x86)\Itoo Software\RailClone Pro <railclonedir> is defined here
UseLicServer = 0 0 to use Stand-alone license, 1 for Network license
CheckTexturePath = 1 Used to add the texture path to Max the first time that the plugin is loaded.

All commercial Itoo Software products use also additional keys for the licensing management:

HKEY_LOCAL_MACHINE\SOFTWARE\Itoo Software\Licenses
LicenseDir = C:\ProgramData\Itoo Software\Licenses
The licenses are stored here
HKEY_LOCAL_MACHINE\SOFTWARE\Itoo Software\Licenses\Products
RailClone Pro = 21 One entry for each Itoo Software product

Please note: If you use a Windows 64 bit version, these registry keys are duplicated in HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node

Network Rendering

You can install RailClone on your renderfarm computers using the setup program, or copying the files manually. In RailClone Pro select "Render slave node", in the Lite version use default installing options.

For a manual installation, you only need to:

  1. Copy the files listed on the plugin and shaders table to the slave computers. You may get the files from your main workstation where you have installed the software.
  2. Make the map files visible to the render nodes, copying them to any shared texture folder.

Customizing the Library

In RailClone Pro you can customize the Library using the included editor, or editing the XML description files. See here for details.

Note: The library of RailClone Lite cannot be modified. You can get unexpected results if you try to edit the XML files to customize it.