HDR Light Studio works with KeyShot version 3-6 on Windows only.
The connection between HDR Light Studio and KeyShot is built into KeyShot - so no additional plug-ins are required. However, you do need to set two environment variables HDRLS_HOME_V4 and HDRLS_HOME_V5 to point to the directory where HDR Light Studio has been installed.
Step 1: Install
Make sure KeyShot is not running.
Install HDR Light Studio main app using the installer provided
Step 2: Environment Variable
The current versions of KeyShot are hard coded to look for HDR Light Studio 4, and will not see the new installation of HDR Light Studio.
Therefore, we need to make a simple change to a Windows OS Setting that will tell KeyShot to start HDR Light Studio instead.
Open the Control Panel in Windows OS
Select System and Security
Select Advanced system settings
(You will need administrator privileges on your user account to do this, if you are unable to complete this step please ask your IT admin to help you)
Click the Environment Variables… button
Scroll down the System variables list until you can see the HDRLS_HOME_V5 entry.
Click on the HDRLS_HOME_V5 entry in the list and press the Edit… button
(Important: If you already have a HDRLS_HOME_V4 entry in the list too, please consult the last page of this document before continuing)
We are now going to copy the Variable value from HDRLS_HOME_V5
We will later paste this path into a HDRLS_HOME_V4 variable
The whole path will look something like this:
C:\Program Files\Lightmap\HDR Light Studio
Select all of the Variable value contents and copy this path by pressing CTRL + C and then press OK to close this window.
If you already have HDR Light Studio 4 installed, Click on the HDRLS_HOME_V4 entry in the list and press the Edit… button.
The current value will be something like this:
C:\Program Files\Lightmap\HDR Light Studio v4.0
If you do not have a HDRLS_HOME_V4 entry in the list, Press the New… button under the System variables list, and type: HDRLS_HOME_V4 into the Variable name field.
(Please note, this field is case sensitive and needs to exactly match)
Now we will replace or enter the Variable value by selecting all (CTRL + A) and pasting (CTRL + V) into the Variable value field
It should then look something like this, you will have a HDRLS_HOME_V4 variable pointing to the location of HDR Light Studio (C:\Program Files\Lightmap\HDR Light Studio)
Press OK to close the Edit System Variable window
Press OK to close the Environment Variables window
Press OK to close the System Properties Window
You can now start KeyShot, go to the Preferences Panel in KeyShot and enable the HDR Light Studio plugin. Restart KeyShot and press the ‘Edit’ button on the environment to launch HDR Light Studio.
Important Information if you already have a HDR Light Studio 4 installation on this computer
If there are other HDR Light Studio 4 plugins being used on this computer, as well as KeyShot, then making the changes to the environment variable to make KeyShot connect will mean all version 4 plugins on this computer will try and load HDR Light Studio, and not version 4.
So if you are only testing HDR Light Studio, please change the HDRLS_HOME_V4 variable value back to its original value to regain the use of your version 4 plugins after you have completed your trial.
If you reinstall the main HDR Light Studio 4 app, this will also change the environment variable back to its proper value. This is a simple way to reset the value.
The default value looks something like this:
HDRLS_HOME_V4 = C:\Program Files\Lightmap\HDR Light Studio v4.0
But can vary depending on your language, or if you installed in a custom location.
If you have purchased and upgraded to using HDR Light Studio on this computer, and want to use it with KeyShot and other 3D apps on this computer, please ensure you have purchased and installed the new connections for your other 3D software as they will no longer be able to open HDR Light Studio 4 on this machine with the v4 connections.