YafaRay4tS version 0.9.0
YafaRay4tSv0.9.0 was created to work in trueSpace7.61 and trueSpace7.61Std 'Workspace'
It does not work in trueSpace7.61 'Model'
Tested with YafaRay v3.3.0

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

YafaRay Installation

1.) Download the YafaRay v3.3.0 render engine from one of these sites:
https://github.com/YafaRay/Blender-Exporter/releases
https://github.com/YafaRay/Core/releases

Unzip the file and copy the 'yafaray_v3' folder to the trueSpace folder:
Example: C:\trueSpace761\tS\yafaray_v3
Example: C:\trueSpace761Std\yafaray_v3

Or to your Program Files folder:
Example: C:\Program Files\yafaray_v3

For Blender users look at the Blender instructions below.

//////////////////////////////////////////////////////////////////////////////////////////////////////////////////

Prerequisites:
Clinton3dPlugin.rxs plugin - Installed and Loaded
http://clintons3d.com/plugins/downloads/Clintons3dPlugin.rsx

C3DPersistentv2 - Installed
http://clintons3d.com/plugins/truespace/utility/persistent.html

YafaRay4tS Installation

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

3.) Install the C3DPersistent

4.) Extract All the files from the YafaRay4tSv090.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 tS761 Question message asking:
"Your existing YafaRay4tS Libraries will be deleted and 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.

WARNING: If you have any content saved in any of these three libraries, they will be deleted, so save anything you want into a different library.

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.
Example: C:\Program Files\yafaray_v3\bin\yafaray-xml.exe
Example: C:\trueSpace761\tS\yafaray_v3
Example: C:\trueSpace761Std\yafaray_v3

Note: If copied to the above examples, the 'YafaRay Installation Path' will be set automatically.
Also if copied to the Blender 2.79 AddOns or BforArtists 1.0 AddOns folders.
If copied to the truespace folder, any folder with “yafaray” in the name will be found so it’s not limited to “yafaray_v3” specifically.

8.) Set the 'Output - Render File' to where you want to render an image or images.
Example: 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

1.) Open trueSpace7.61 and from the Workspace's File menu, Load the YafaRay4tS_Installer.RsObj from where you extracted the YafaRay4tSv090 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.

WARNING: If you have any content saved in any of these three libraries, they will be deleted, so save anything you want into a different library.


//////////////////////////////////////////////////////////////////////////////////////////////////////////////////

Developer notes:

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

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
http://clintons3d.com/plugins/truespace/rendering/yafaray.html

//////////////////////////////////////////////////////////////////////////////////////////////////////////////////
Beta Releases:

YafaRay4tS version: 0.9.0
Wed July 11, 2018

Uses YafaRay v3.3.0
Updated D3D preview to more closely match the rendered result
New integrated render buttons
Updated materials with texture maps for all compatible attributes
Added blend values for texture maps
Updated draw parameters 
New blend material
New procedural texture maps - clouds, marble, voronoi and wood
New yafaray camera
Updated ies lights
Now works with standard tS lights
Enhanced light color picker
New toolbar buttons for yafaray camera, smoothing, volume primitive
Sphere light exports scale instead of the size attributes
Constant default color matches tS default background color
New support for resizable OptDisplay window not limited by resolution or image aspect ratio
OptDisplay: http://rs.siprogs.sk/p/iOptDetectorsPage
New animation preview system
New option to turn off caustic photons and diffuse photons for each light source.
New background cast shadows option and background sun shadow option.
New smart blur value for image based lighting
New photon map saving and loading
Additional rays on materials
Russian roulette for path tracing 
New Denoise option

//////////////////////////////////////////////////////////////////////////////////////////////////////////////////

YafaRay4tS version: 0.8.0
Sun Jan 31, 2016

Partial save timer - save file while rendering to see progress
Tile rendering options - linear or random for bucket style renders

Custom text for the Draw Params option

New material options are at the bottom of the materials
Pass ID is used with the render passes
Visibility can be set to normal, shadow only, no shadows, invisible
Receive Shadows uncheck so material does not get shadows

Threads default to -1

Render Passes
Check "enable" to turn on render passes
Use the dropdown to select render passes
RenderPassList.txt contains a list of all possible passes that can be typed into any slot. The channel isn't limited to the dropdown list selections. The RenderPassList.txt can be found in the trueSpace directory.

The Multi-Layer option at the bottom only applies to the exr file format.

//////////////////////////////////////////////////////////////////////////////////////////////////////////////////

YafaRay4tS version: 0.7.5
Sunday, July 24, 2011

trueSpace 7.61 version required and is not backwards compatible.
Improved skeletal meshes/Actors with animation support.
Skeletal meshes and Characters, will export if you apply SDS to the mesh. The first Level of SDS is the preferred method unless the mesh is already subdivided.
Skeletal meshes will also export if you apply a morph to the character. Apply morph then right click to immediately exit the tool.
Support for multiple materials on one mesh.
Fixed mesh normals for better glass objects.
Spotlight and Omni light power exports the same as Blender with a export power = power*power/2.
Area and Sphere lights have a render option to make them visible.
Area light has a new mesh so when the mesh is at (0,0,0) the resulting light is also at (0,0,0).
Adjusted light attenuation parameters to make the preview more closely match the render.
Does not lose camera selection if the scene name changes.
Glass material absorption value was not connected so value was never used.
Added a strength control to the glass material to control the D3D transparency preview (no effect on the final render).
Bump map preview for materials.
Changed the default render parameters to match Blender's UI values.
YafaRay4tS materials default to the corresponding Blender material default values.
Added a global input gamma that is applied to colors, lights and textures to translate them to linear color space used by YafaRay.
Gamma value does not affect the display in trueSpace 3D viewport.
Added DarkTide's sun sky background option.
Added support for rendering to the OpenEXR file format (exr).
New aspects for each Lighting Method.
YafaRay4tS Settings button shows the YafaRa4tS panel's presently used Lighting Method aspect in the Stack.
YafaRay4tS Export and Render button no longer shows the YafaRa4tS panel in the Stack with the LMB.
YafaRay4tS Export and Render button shows the YafaRa4tS panel's presently used Lighting Method aspect in the Stack with the RMB.
Diffuse Reflect Map fixed in new improved Yaf Coated Glossy and Yaf Glossy materials.
New improved YafaRay4tS Spot light with Hotspot generator.
Updated YafaRay4tS Help file.
New tS7.61 YafaRay4tS Installer script.

Yafaray 0.1.2 Beta support:

Requires Yafaray version 0.1.2 beta to be setup with YafaRay4tSv0.7.5 and the Yafaray 0.1.2 xml format - beta checkbox enabled, located in the Setup aspect. Only one version of Yafaray can be installed at one time.

New file formats hdr, jpg, png and tif.
Save Alpha located in the Lighting Method aspects. - Exports an alpha file in addition to the rgb output file.
Z - Channel option works.
New Volume Region mesh: Uniform and Height Fog work with the YafarayVolume.RsObj
Support for normal map textures.
Rough Glass material.
Photon only and soft shadow parameters for the Spot light.
IES Light with preview.
SPPM lighting method (not working at this time for the xml renderer, YafaRay version 0.1.2-Beta2).

//////////////////////////////////////////////////////////////////////////////////////////////////////////////////

YafaRay4tS version: 0.7.0
Thursday, June 11, 2009

trueSpace 7.61 version required and is not backwards compatible.
Animation rendering is now supported. Support is included for sequential image batch rendering to occur in the background while you continue working inside trueSpace.
Hair takes on the same Material as the base mesh it grows from.
There are 2 options for preparing an Character or a Skeletal mesh for rendering with Yafaray:
1. Apply a Morph then right click to immediately exit the tool.
2. Apply SDS to the mesh. The first SDS (Level 1) is the preferred method unless the mesh is already subdivided.
The material texture map X Scale and Y Scale only works well for odd whole number values.

//////////////////////////////////////////////////////////////////////////////////////////////////////////////////

YafaRay4tS version: 0.6.1
Tuesday, May 5, 2009

Setup directories now handled correctly, and YafaRay4tS will guess YafaRay install location if not found at location specified.
Texture handling fixed. This fixes the mirror color texture bug for ShinyDiffuse material
TGA Viewer app added
Internal viewer panel added
Support for custom external viewer added.
Lights, Materials, setup objects moved into separate libraries.
Light objects changed to quadratic falloff and the export values adjusted accordingly.
Scripts added to Area and Sphere light objects to have size affect visual display brightness.
Gamma scripting for realtime texture display in materials now adjusts relative render target value.
Help file added.
Fixed a bug with Glass Material absorption toggle not working. Also added option for absorbtion dist. of 0.0 to set logarithmic absorption.

//////////////////////////////////////////////////////////////////////////////////////////////////////////////////

Yaf(a)Ray4tS version: 0.6.0
Saturday, February 14, 2009

Full geometry support with UV mapping 
Support for all Yafaray light types. 
HDRI, IBL, and background shader support 
Photonmapping, Caustics, GI, and Final Gather 
Fog 
Multi threaded rendering 
Mapped versions of the following Yafaray materials:
    Glossy 
    Coated_Glossy 
    Shiny Diffuse 
    Glass 
Rendering from View or Camera

Limitations:

This current version of Yaf(a)Ray4tS doesn't support Skinned (Actor/Skeleton) objects.
Fog currently is non-functional.
Animation is not supported.
Multiple materials on a single object are not supported at this time.

//////////////////////////////////////////////////////////////////////////////////////////////////////////////////

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:

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 official 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.
http://www.yafaray.org/
http://www.yafaray.org/documentation/userguide

//////////////////////////////////////////////////////////////////////////////////////////////////////////////////

trueSpace Unofficial Updates 

YafaRay4tSv0.9.0 is fully incorporated into trueSpace7.61 and trueSpace7.61Std
No installation is necessary if you apply these updates: 
"Unofficial" Updates for trueSpace7.61 Full Version
"Unofficial" Update for trueSpace 7.61 Standalone
Both versions can be found here:

https://united3dartists.com/forum/viewtopic.php?f=55&t=4247


