Skip to content

Latest commit

 

History

History
45 lines (30 loc) · 3.57 KB

INSTALL.md

File metadata and controls

45 lines (30 loc) · 3.57 KB
Raw

To install YafaRay into Blender:

** IMPORTANT **

The new YafaRay-v3 will NOT replace the existing YafaRay versions, and it can be installed in addition to them. So, YafaRay-v3 must be enabled in Blender user preferences, and in your current YafaRay scenes you have to switch to the renderer "YafaRay-v3" to use the new version.

If you have several YafaRay versions together, make sure that you enable in Blender first the old and later the new v3 in that order. If you have problems, disable both, restart Blender and enable them in that order.

YafaRay has only limited support for multiple YafaRay versions and forks installed at the same time. Having several versions could cause in some cases:

  • Black renders
  • Random crashes
  • Inability to enable the YafaRay plugin or all kinds of strange problems

If you have any of these problems, remove any other yafaray folders (or derived forks) from the Blender addons folder and try again. This typically solves most of the problems stated above.

In v3, support has been DROPPED for Windows XP and MacOSX v10.6

  • Important note *: Now by default YafaRay will save the images at the same time as rendering into Blender ("Secondary File Output"). This can be disabled.

Also, YafaRay, by default, ** will change the output folder/file name ** so the images are exported to a subfolder with the same name as the .blend file with suffix _render. This is for convenience and can be disabled, but if you leave the default it could cause you confusion especially when switching to other renderers.

Don't use the Blender from the distro repositories. Download the Blender official 2.79 builds from: https://download.blender.org/release/Blender2.79

Once Blender is installed, locate the folder where it was installed. The paths given below are just examples, but they will probably be different in your system.

Copy this entire folder "yafaray4" to (for example):

  • in Linux 64bit, for example: "$HOME/blender-2.79b-linux-glibc219-x86_64/2.79/scripts/addons" folder.
  • in Windows 64bit, for example: "C:\Program Files\Blender Foundation\Blender\2.79\scripts\addons" folder.

After it, start Blender, go to User Preferences, AddOns and try to enable Render:"YafaRay-v3". Once (hopefully) enabled you should see it in the list of renderers.

(Optional) In the User Preferences, AddOns, YafaRay-v3: select the YafaRay Computer Node number. If you have several computers and you want to render an image or animation using several computers (render farm), just select a different Computer Node number for each PC. This will allow the internal ImageFilm files to use different samples in the different computers, so later they can be combined into a combined render combining the ImageFilm files from each PC ("offline" multicomputer rendering)

  • Important: the YafaRay Linux 32bit build requires a processor with SSE/SSE2 instructions. Any non-ancient processor should have them...

If you have any issues:

  • Check that you have copied the "yafaray4" folder into the correct Blender addons folder.
  • Check that you have downloaded the appropiate YafaRay build for your Operating System and Blender build (32/64 bit)
  • Check that you are using the official Blender build from www.blender.org and it's a version supported by YafaRay (see CHANGELOG)
  • In extreme cases (black renders, crashes, etc) remove all older YafaRay versions and other YafaRay derived forks, and try again.
  • If you still have problems, please send us your bug reports (see README.md file, "BUG REPORTS / FEATURE REQUESTS" section)