YafaRay4tS version 0.9.9

YafaRay4tSv0.9.9 was created to work in trueSpace7.61 'Workspace'
It does not work in trueSpace7.61 'Model'
Tested with the YafaRay v3.3.0 render engine

It is also fully incorporated into both "Unofficial" Updates for trueSpace7.61
"Unofficial" Updates for trueSpace7.61 Full Version
"Unofficial" Update for trueSpace 7.61 Standalone

YafaRay Installation

1.) Download the YafaRay v3.3.0 render engine from one of these sites:
YafaRay Standalone , YafaRay for Blender

Unzip the file and copy the yafaray_v3 folder:
Examples:
Standalone
C:\Program Files\yafaray_v3
C:\trueSpace761\tS\yafaray_v3
C:\trueSpace761Std\yafaray_v3

*For Blender users look at the Blender instructions below.

YafaRay4tS Installation

Prerequisites:

Optional:

The OptDetector.dll must be Installed and Loaded from the Workspace's Package Manager.
Note: If you want to use OptDetector for several installed versions of trueSpace7.61 you only need to install one OptDetector plugin, that can be shared.
Example: Install to your C: / drive. Then copy the 3 OptDetectors libraries to your trueSpace Rs Main Libraries folder.
Warning: After you Reset to Default Context from Workspace the OptDetectors plugin will require that the 3 OptDetectors libraries load again.

Next if you have previously installed YafaRay4tS before, Uninstall YafaRay4tS from the Add & Remove program in the Windows Control Panel first!

2.) Install and Load the Clinton3dPlugin.rxs plugin from Workspace's Package Manager and reboot trueSpace 7.61

3.) Install the C3DPersistentv2RsObj

4.) Extract the files from the YafaRay4tS.zip

5.) Open trueSpace7.61 and from the Workspace's File menu, Load the YafaRay4tS_Installer.RsObj from where you extracted the files.

WARNING: Do not Drag and Drop into trueSpace, only use Workspace's File menu!

6.) From the YafaRay4tS Installer panel select the 'Install' button.

You should see a Question message asking:
"Your existing YafaRay4tS Libraries will be replaced with updated versions."
"Would you like to continue?"

If not select your keyboard keys Alt + Tab to bring the message forward. Selecting "Yes" will start the installation and selecting "No" will cancel the installation.

7.) From Workspace in the Stack/Panel - YafaRay4tS/Setup aspect

Set the 'YafaRay Installation Path' to the yafaray-xml.exe file where you have installed YafaRay v3.3.0
Examples:
Standalone
C:\Program Files\yafaray_v3\bin\yafaray-xml.exe
C:\trueSpace761\tS\yafaray_v3\yafaray-xml.exe
C:\trueSpace761Std\yafaray_v3\yafaray-xml.exe
Blender
C:\Program Files\Blender Foundation\Blender\2.79\scripts\addons\yafaray_v3\bin\yafaray-xml.exe
BforArtists
C:\Program Files\Bforartists 1.0.0\2.79\scripts\addons\yafaray_v3\bin\yafaray-xml.exe

YafaRay4tS/Setup - YafaRay Installation Path

Installation Defaults:
If copied to the above examples, the 'YafaRay Installation Path' will be set automatically.
If copied to the trueSpace folder, any folder with yafaray in the name will be found so its
not limited to yafaray_v3 specifically.
Note: If you want to use YafaRay4tS for several installed versions of trueSpace7.61 you only need one 'YafaRay Installation Path' that can be shared. Install to C:\Program Files [Recommended]

8.) Set the 'Output - Render File' to where you want to render an image or images.
Examples:
C:\trueSpace761\tS\Image Folder\yaf_test.png
C:\trueSpace761Std\Image Folder\yaf_test.png
C:\Temp\yaf_test.png

9.) Select the 'Save Settings' button to save your directories into the default YafaRay4tS object.

10.) Position the YafaRay4tS toolbar and save your Layout.

Congratulations you've finished your YafaRay4tS setup!

*For Vray users look at the Vray instructions below.

YafaRay4tS Uninstall

If you have any content saved in the YafaRay libraries, they will be deleted, so save anything you want into a different library.

1.) Open trueSpace7.61 and from the Workspace's File menu, Load the YafaRay4tS_Installer.RsObj from where you extracted the YafaRay4tSv097 files

2.) Select the 'Uninstall' button.
You should see a tS761 Question message asking:
"Your existing YafaRay4tS Libraries will be deleted."
"Would you like to continue?"

If not Select your keyboard keys Alt + Tab to bring the message forward. Selecting "Yes" will uninstall the installation and selecting "No" will cancel the installation.

Developer notes:

New - If you 'Reset to Default Context' in trueSpace7.61 you will not have to reinstall YafaRay4tS v0.9.7

After a 'Reset to Default Context'

Right click any of the Offline Render icons to load the YafaRay4tS panel

* For Vray users look at the Vray instructions at the bottom.

The 'Update YafaRay Render Node' script found in the 'YafaRay4tS Setup' library can be used to update an existing scene.
It will not update the materials.

YafaRay sample scenes for trueSpace7.61 - YafaRay4tS v0.9.7 Scenes for trueSpace7.61

Vray:

If you have Vray Installed and Loaded and you want to switch to YafaRay4tS as the Renderer

1.) In the 'Offline renderers' panel select Yafaray as the Renderer
2.) Right click any of the Offline Render icons to load the YafaRay4tS panel

Blender:

version 2.79 or less

1.) To install for Blender copy the "yafaray" folder into the AddOns folder inside Blender
2.) Start Blender
3.) File > User Preferences
4.) Add-ons
5.) Find and activate yafaray via the checkbox
6.) Select the Save User Settings button

Note: The YafaRay site says YafaRay is no longer compatible with Windows XP, but it does work in trueSpace 7.61
They must be referring to running with Blender on Windows XP.

YafaRay User Guide