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:

 File Description
RailClone Pro.  Shortcut to the RailClone web page
railclone_reference.html Shortcut to the online reference manual
install.log Installation log file
licenseMode.exe License mode setup wizard
licpanel.exe License manager
uninst.exe Uninstaller for RailClone
third-party-licenses.txt Licensing information for 3rd party content
UpdateManager.exe Application for managing updates and libraries
libeay32.dll Application extension
QtCore4.dll Application extension
QtGui4.dll Application extension
QtNetwork4.dll Application extension
quazip.dll Application extension
ssleay32.dll Application extension

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

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

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

Folder Path
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 library Max 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 descriptor Max 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 = 0 0 to use Stand-alone license, 1 for Network license
StyleEditorPath = C:\Program Files\Itoo Software\RailClone Location 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\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

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.