Installation 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:

<railclonedir>  Contains the following files in the root directory:

 FileDescription
RailClone Pro. Shortcut to the RailClone web page
railclone_reference.htmlShortcut to the online reference manual
install.logInstallation log file
licenseMode.exeLicense mode setup wizard
licpanel.exeLicense manager
uninst.exeUninstaller for RailClone
third-party-licenses.txtLicensing information for 3rd party content
UpdateManager.exeApplication for managing updates and libraries
libeay32.dllApplication extension
QtCore4.dllApplication extension
QtGui4.dllApplication extension
QtNetwork4.dllApplication extension
quazip.dllApplication extension
ssleay32.dllApplication extension

The setup program  also creates the folder structure shown below in <railclonedir> :

 FolderPath
Library<railclonedir>\lib
Library Maps<railclonedir>\maps

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

FolderPath
Max plugin Lite<maxdir>\plugins\RailCloneLite.dlo
Max plugin Pro<maxdir>\plugins\RailClonePro.dlo
RailClone Editor<maxdir>\rcedit.dll.
Maxscripts<maxdir>\scripts\startup\railclone_utils.ms
User Interface Files

<maxdir>\QtCore_Itoo_4.dll
<maxdir>\QtGui_Itoo_4.dll
<maxdir>\QtXml_Itoo_4.dll
<maxdir>\QtSolutions_MFCMigrationFramework-Itoo.dll

Toolbar Icons

Max 2010- 2012:

<maxdir>\ui\Icons\rctoolbar16a.bmp
<maxdir>\ui\Icons\rctoolbar16i.bmp
<maxdir>\ui\Icons\rctoolbar24a.bmp
<maxdir>\ui\Icons\rctoolbar24i.bmp

Max 2013 - 2018:

<maxdir>\ui_In\Icons\rctoolbar16a.bmp
<maxdir>\ui_In\Icons\rctoolbar16i.bmp
<maxdir>\ui_In\Icons\rctoolbar24a.bmp
<maxdir>\ui_In\Icons\rctoolbar24i.bmp

<maxdir>\ui_In\Iconsdark\rctoolbar16a.bmp
<maxdir>\ui_In\Iconsdark\rctoolbar16i.bmp
<maxdir>\ui_In\Iconsdark\rctoolbar24a.bmp
<maxdir>\ui_In\Iconsdark\rctoolbar24i.bmp

VRay shaders

Several <maxdir>\RailcloneVRay???.dll.

Depending of the Max version, there are several files; one for each version of V-Ray supported.

MR shader libraryMax 2010 and before: <maxdir>\mentalray\shaders_autoload\shaders\RCShader.dll
Max 2011 and 2012: <maxdir>\mentalimages\shaders_autoload\mentalray\shaders\RCShader.dll
Max 2013 and newer: <maxdir>\nvidia\shaders_autoload\mentalray\shaders\RCShader.dll
MR shader descriptorMax 2010 and before: <maxdir>\mentalray\shaders_autoload\include\RCShader.mi
Max 2011 and 2012: <maxdir>\mentalimages\shaders_autoload\mentalray\include\RCShader.mi
Max 2011 and newer: <maxdir>\nvidia\shaders_autoload\mentalray\include\RCShader.mi

The following entries are created in the Windows Registry:

If the plug-in doesn't find the keys in HKEY_LOCAL_MACHINE, it searches the same values on HKEY_CURRENT_USER.

HKEY_LOCAL_MACHINE\SOFTWARE\Itoo Software\RailClone Pro
MainDir = C:\Program Files\Itoo Software\RailClone<railclonedir> is defined here
UseLicServer = 00 to use Stand-alone license, 1 for Network license
StyleEditorPath = C:\Program Files\Itoo Software\RailCloneLocation of the Style Editor (RCEdit.exe)
LibraryDir (key)One entry for each library path. By default C:\Program Files (x86)\Itoo Software\RailClone Pro\lib\default1
TexturePaths (key)Texture paths

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

HKEY_LOCAL_MACHINE\SOFTWARE\Itoo Software\Licenses
LicenseDir = C:\ProgramData\Itoo Software\LicensesThe licenses are stored here
HKEY_LOCAL_MACHINE\SOFTWARE\Itoo Software\Licenses\Products
RailClone Pro = 21One 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

Unattended Installation

The setup program supports unattended installations using the following parameters:

  • /? - See available parameters
  • /S - Enable silent installation
  • /LICMODE=[rendernode, network, stand-alone]
  • /LICHOST=<License server host>
  • /LICPORT=<License server TCP port>

From RailClone 2.4 and above, /MAXDIR and /MAXVER are optional. If not specified, the software is installed for all Max versions available in the computer.

Example of silent installation for Max 2013
RailClonePro.exe /S /MAXVER=max2013-64

Network Rendering

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

For a manual installation, you only need to:

  1. Copy the files listed on the plugin and shader 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.