Materials and Textures

Material Issue

Cutaway Opacity maps on cutaway caps are not supported

Fade Animations are not supported with cutaway materials

Co-planar surfaces may produce artifacts with inherit/material caps

Details
If you have two co-planar parts where one is excluded form the cutaway and you use inherit caps or material caps.
Artefacts can occur on the surface of the excluded material.

Cutaway material may interfere with shadows on the environment ground

Details and workaround
If the cutaway object touches the environment ground it will cut that just as it cuts into regular parts.

Workaround: Add a groundplane (Edit > Add Geometry > Add Ground Plane) and exclude it from the cutaway.

When the Camera is inside the cutaway object, Color caps and Material caps are not working as intended
Details
When using material caps or color caps and the camera is positioned inside the the cutaway object, all objects in
the scene will be displayed with the cap material/color.

Excluded objects in cutaway have incorrect reflections

Details
Objects excluded by cutaway show reflections of the inside of the object being cut.

Bad shadows on excluded cutaway objects

Details
The shadows on excluded objects appear as if the cut objects are still visible.

Fade Animation is not supported when viewing through a Cutaway object.

Scattering Media and Cutaway materials in the same scene will sometimes lead to undesirable results.
Details
If there is overlap between the cutaway and the Scattering Medium, and the Scattering Medium object is set to
be excluded, the resulting image can have visual errors.
Cutaway material does not allow scattering medium to be seen through the cutaway material.

Manual, KeyShot 9
 Geometry nodes Some geometry may not show Flakes/Bubbles.
Details
Some CAD formats i.e. .3dm, .c4d may be imported as several triangle groups and then merged making the body
unfit for Flakes/Bubbles.

Workaround: Import with NURBS and Re-Tessellate.

Geometry nodes don't respect disabled state.

Displacement When applying Displacement to geometry with hard edges, these edges become split.
Details
Hard model edges become split. Left cube is
with hard edges, on the right the cube has a
small fillet on the edges.

Workaround: Applying blends in CAD usually

solves the issue.

Area Light ZSpheres transferred from ZBrush are not supported for Area Light

Multi-Layer Optics Multi-Layer Optics do not support nested dielectrics/liquid interfaces.

Scattering Medium Overlapping objects with Scattering Medium may have shading issues.

UV Mapped UV mapped textures applied to NURBS objects in Rhino are not mapped properly

Textures

Camera

Feature Issue

Depth of Field Panoramic Camera behavior is significantly different when "Use GPU (enable effects)" is disabled in Preferences

Manual, KeyShot 9
 Getting Started
How Easy is KeyShot? On this page
How Easy is KeyShot?
KeyShot's drag and drop based workflow will have you rendering images in minutes. With a simple interface providing many advanced features and
Step 1: Import Your 3D Model
instant real-time feedback, you save time while focusing on your design.
Step 2: Assign Your Materials
Step 3: Choose Your Environment
Step 4: Adjust Your Camera
Step 1: Import Your 3D Model Step 5: Enjoy the Perfect Image

Launch KeyShot. Import your 3D model via File, Import... KeyShot supports over 20 3D file formats, including SketchUp, SolidWorks, Solid Edge,
Pro/ENGINEER, PTC Creo, Rhinoceros, Maya, 3ds Max, IGES, STEP, OBJ, 3ds, Collada, and FBX. KeyShot also features many plugins with more
features, including KeyShot BIP export and LiveLinking. Learn More

Manual, KeyShot 9
 Step 2: Assign Your Materials
From the Library Window, select the Materials tab. Apply any of the 700+ scientifically accurate materials from the material library by simply
dragging and dropping them onto your model in the Real-time View. Changes appear on your model instantly with accurate color and lighting under
the current lighting conditions. Learn More

Step 3: Choose Your Environment

Now select the Environment tab. Drag and drop an Interior, Outdoor or Studio lighting environment (HDRI) into your scene. You will see the change
in the scientifically accurate, real world lighting immediately and how it affects the appearance of your colors, materials and finishes.

Manual, KeyShot 9
 Step 4: Adjust Your Camera
Use your mouse to adjust the camera. Additional settings are available in the Project, Camera tab. Adjust the angle and distance, control
perspective with focal length and field of view settings, and easily add depth of field to your scene. Learn More

Manual, KeyShot 9
 Step 5: Enjoy the Perfect Image
Hit Render on the main toolbar. Use the default setting or adjust the output options. Select the Render button to watch your image render right
before your eyes. Learn More

Manual, KeyShot 9
Manual, KeyShot 9
 Installation
System Requirements On this page
System Requirements
Before installation, confirm that your system meets the necessary hardware and operating system requirements. You can view the system
Installing KeyShot
requirements here.
Installing Your License
Node locked licenses
Transferring Your License
Installing KeyShot How to Transfer Your License

The KeyShot installer will guide you through the installation process.

On Windows, the installation process will ask you to consider the following

End-User Agreement
Install for everyone using the computer or just for the current user
Location of the KeyShot Installation folder
Location of the Resource folder - The resource folder contains an number of textures environments etc. which you can use with
KeyShot. It will also be the default destination folder when unpacking .ksp files. Learn more about the Resource folder.
Enabling access for KeyShot services in firewall settings

On Mac, KeyShot will be installed in the applications folder and the resources folder will be located in "Application Support"

Installing Your License

First time you launch KeyShot, you will be asked to register a license. This can be a node locked license or a floating license. The standard
node-locked license of KeyShot can only be active on one machine at a time. However, you can transfer your license repeatedly between up to
three machines of mixed platforms. With a Floating license your company can have a number of licenses that can be used by multiple computers. L
earn more about floating licenses here.

Node locked licenses

Automatic Install When you receive your keyshot9.lic file, save it to your computer. Next, start KeyShot, and select Install a license file
(*.lic) and browse to the keyshot9.lic file. If your license fails to install, check to ensure you have full permissions set on your KeyShot 9 res
ources folder.
Manual Install When you receive your keyshot9.lic file, you can manually copy it to the Keyshot 9 resources folder on PC or Mac.

Transferring Your License

During the license transfer process, an Internet connection is required. Once the license has been successfully transferred, KeyShot can run without
being connected to the Internet.

How to Transfer Your License

Manual, KeyShot 9
 To transfer your license, ensure you are connected to the Internet on the active machine.

Start KeyShot and go to Help, Deactivate License on this Computer...

Next, ensure the new machine is connected to the internet and KeyShot is installed. Start the software, fill out your information on the activation
screen, and press Next.

On the following screen you will be asked for your KeyShot serial code. Type in your information and press Next to finalize the activation.

Manual, KeyShot 9
 Migration Assistant
If you have KeyShot 8 installed on your PC/Mac, when installing KeyShot 9 for the first time, the Migration Assistant will help you transfer your
settings and resources to KeyShot 9. You can choose to migrate Settings, Resources or both. On this page
Migrating Settings
Migrating Settings Preferences
Workspaces
Swatches saved in Color Picker
Preferences License Information
Migrating Resources
Any alterations you have made to the default Preferences setup will be transferred. Library resources
Material Templates
Scripts
Workspaces

You won't have to re-create your favorite Workspaces.

Swatches saved in Color Picker

If you have added any color swatches to the the Color Picker, these will also be transferred.

License Information

Node Locked license: Information about name, company etc. will be prefilled in the Registration dialog.
Floating license: KeyShot 9 will connect to the same license server as you used in KeyShot 8. If there are no licenses for KeyShot 9 on
the server all your information will be prefilled in the Registration dialog.

Migrating Resources

Library resources

All non-stock resources will be copied into the respective KeyShot 9 libraries. Here they will be located in the Migrated folder.

If you have customized the folder settings all KeyShot 9 resources will be added to your custom folders.

Material Templates

Any Material Templates you have created will be copied to KeyShot 9.

Scripts

All custom scripts will be copied into your scripts list where they will be located in the Migrated folder.

Manual, KeyShot 9
 Resource Folder
KeyShot Resource Folder On this page
Your KeyShot installation contains a folder of preset KeyShot resources (or assets). Resources such as materials, environments, and textures are KeyShot Resource Folder
stored here. When you open a .bip file, KeyShot references the KeyShot resources folder location and loads any files that apply to the scene. You Animations
can specify the location of the KeyShot resources folder under the Folder Preferences tab. Backplates
Colors
On Windows, you will find Preferences in the Main Menu under Edit, Preferences and on Mac in the Main Menu under KeyShot, Preferences. Downloads
Environments
The KeyShot resources folder contains the following sub-folders: Favorites
Materials
Animations Material Templates
Models
Animations will be saved to this folder by default. At render time, other locations can be specified in the Render Options window. Renderings
Scenes
Scripts
Backplates Textures
PC Location
The KeyShot Library loads backplates from the this location and saves imported backplates to this folder by default. Setting Permissions
Mac Location
Colors Setting Permissions

The KeyShot Library loads color library files from the this location and saves imported color library files to this folder by default.

Downloads

Resources downloaded from the KeyShot Cloud will be saved to this location.

Environments

The KeyShot Library loads environments from this location and saves imported environments to this folder by default.

Favorites

This folder is empty until a favorite list of resources is created. Once created, the favorite list is saved to this location as a XML file.

Materials

The KeyShot Library loads materials this location and saves imported materials to this location by default.

Material Templates

This folder is empty until a material template is created. Once created, the material template is saved to this location.

Models

Manual, KeyShot 9
 This folder contains standard primitives that you can import into KeyShot and saves imported model library files to this folder by default.

Renderings

Renderings will be saved to this folder by default. At render time, other locations can be specified inside the Render Options window.

Scenes

This folder contains sample scenes that you can only open with KeyShot. These scenes are saved as BIP files.

Scripts

This folder contains sample scripts that you can use with KeyShot.

Textures

The KeyShot Library loads textures from this location and saves imported textures to this folder by default.

PC Location
After KeyShot 9 is installed, a “KeyShot 9 Resources”
shortcut will be created on your desktop. By default, this
shortcut points to: Documents/KeyShot 9.

Setting Permissions

You must have read and write permissions for your

KeyShot 9 folder in order to save renders, animations,
and more. Here’s how to set permissions:

Right click the KeyShot 9 resources folder and

select “Properties”.
Go to the Security tab and highlight your group
or user name.
Click the “Edit” button.
Set permissions to “Full Control.”
Click “Apply” and “OK.”

Manual, KeyShot 9
 Mac Location
On a Mac, your KeyShot 9 resources folder is saved
inside the “Application Support”: /Library/Application
Support/KeyShot9

Setting Permissions

You must have read and write permissions to your

KeyShot 9 folder in order to save renders, animations,
and more. Here’s how to set permissions:

1. Right click the KeyShot 9 resources folder and

select “Get Info.”
2. Expand “Sharing & Permissions” and unlock

Manual, KeyShot 9
 2.

access.
3. Change all privileges to “Read & Write.”
4. Click the settings button and select “Apply to
enclosed items…”
5. Click “OK” and close the window.

Manual, KeyShot 9
 Pro Floating Installation
Welcome to the KeyShot Pro Floating Installation Guide! This guide will walk you trough the installation process starting with the license manageme
nt application: Luxion License Server (Windows & Mac) or lmgrd (Linux). You will then install and configure the client application: KeyShot! We have In this section
also included a list of features and add-ons, a troubleshooting guide, and licensing terminology with definitions.
Pro Floating Quick Start Setup
Luxion License Server Installation
Server Setup License Server Installation (Linux)
KeyShot Pro Floating Installation
Pro Floating Troubleshooting
Luxion License Server Imgrd (Linux) Pro Floating Advanced Setup
Floating License Definitions
Luxion License Server is the license The lmgrd (Unix executable file) is the
management application for Mac and license management process for
Windows Linux.

Requires:
Windows Server 2008 and later.
Mac OS X 10.10 and later

You can also visit the Pro Floating Advanced Setup pages for help with manual setup.

All license management applications utilize the latest FlexNet licensing tools by Flexera Software LLC. KeyShot Pro Floating and Luxion License
Server are both provided by Luxion Inc.

Client Setup

KeyShot Pro Floating Installation

Amazing Rendering and Animation in real-time

Download KeyShot 9

Manual, KeyShot 9
 Pro Floating Quick Start Setup
KeyShot Pro Floating - Server Installation On this page
All license management applications utilize the latest FlexNet licensing tools by Flexera Software LLC. KeyShot Pro Floating and KeyShot License KeyShot Pro Floating - Server
Manager are both provided by Luxion Inc. Please follow the instructions below to install the license server and have your license file issued. Installation
Before You Begin
During license setup, you will install the server on a single computer in your network. This computer will host your license file and will be referred to
1. Download the license server
as the license server. Note: The server must be a local central server - a dedicated machine for the FlexNet server software to be installed on
software
and powered on and connected to the network at all times.
2. Install the license server
How to Restart a Windows Server
Before You Begin How to Restart a Mac Server
How to Restart a Linux Server
Your KeyShot Pro Floating license will be sent via email. If you have a previous installation, please save the license file to your license server folder How to move the license server
(e.g. C:\FlexLM on Windows) overwriting the previous file. If you changed the port number in the original file, please make sure your new license KeyShot Pro Floating - Client
reflects that. It is important to note that the latest client software installation requires the latest KeyShot license server software. Without the latest Installation
license server software, KeyShot will display an "unknown error". 1. Gather Server Information
2. Install KeyShot
1. Download the license server software 3. Enter Server Information

KeyShot License Server - Windows

KeyShot License Server - MacOS
KeyShot License Server - Linux

2. Install the license server

1. Download and unpack the server software on the machine that will host the licenses.
2. Start the server software.
3. The server software will automatically provide the Host Name and the Host ID.
4. Send the following information to license@luxion.com.
Company name
Serial code
Computer Host name
Computer MAC Address

How to Restart a Windows Server

1. Go to the server’s C:\FlexLM folder

2. Launch LMTools.exe
3. Go to the START/STOP/REREAD tab
4. Enable Force Server Shutdown
5. Click Stop Server and wait for the server to stop
6. After a minute, click Start Server

The service will restart. Client computers will be able to connect as usual.

How to Restart a Mac Server

1. Launch KeyShot License Manager.app

2. Make sure to select Install License File
3.

Manual, KeyShot 9
 3. Click Browse and browse to your new license file
4. Click Stop
5. Click Start/Restart

The service will restart. Client computers will be able to connect as usual.

How to Restart a Linux Server

Using the command line on a Windows system running the FlexLM license server:

1. Stop server: Enter

lmutil lmdown -c [path to license file]

2. Start server: Enter

lmutil lmgrd -c [path to license file]

The service will restart. Client computers will be able to connect as usual.

How to move the license server

Should you need to move the KeyShot Floating license server to a new computer, please follow the following instructions to ensure you are up and
running quickly.

1. Follow the steps above for installing the license server on the new machine.
2. Send the following information to license@luxion.com.
Old license file
New Computer Host name
New Computer MAC Address
Letter on company letterhead stating the old license server will be removed.

We will usually send your license file within 24 hours during business days (Mon-Fri). Should you have any questions please contact us at license@
luxion.com.

KeyShot Pro Floating - Client Installation

1. Gather Server Information

Before installing, make sure that the KeyShot Floating license server has been installed on a computer in the network and gather the following
information from that computer:

Computer Host name

Computer IP Address

2. Install KeyShot

Install the KeyShot Pro Floating (FL) client software on all the user's computers. You can download KeyShot here.

3. Enter Server Information

When first installed, the KeyShot Floating client application will ask you to Specify the License Server System.

Manual, KeyShot 9
 Windows - Enter the Computer Name at the first prompt
Mac - Enter [port number]@[server's IP address] (e.g. 27000@192.168.1.123)

KeyShot Pro Floating will remember the server location from now on. For more information please refer to the relevant section for your installation in
the Pro Floating Installation manual.

If you have any questions, please contact license@luxion.com.

Manual, KeyShot 9
 Luxion License Server Installation
The instructions below will walk you through a typical first-time license service setup. Our licensing team will provide you with a license file and the
appropriate software links. You may reach our licensing team at license@luxion.com. On this page
1. Install Server
1. Install Server 2. Request License
3. Install License
Install Luxion License Server. Our licensing team will provide software download links once your purchase has been processed. 4. Status - available/used licenses
5. Set Server Ports
6. License Folder

Also see:

KeyShot Pro Floating Installation

Changing Server Connection.

2. Request License

Click on the Request License tab to generate a

request-message for our licensing team.

1. Name: Enter your name

2. Company Name: Enter your company name
3. Serial: Enter the 20 character serial code that
was provided to you by our licensing team
4. Hostname Is pre-filled with your computers
information.
5. MAC address: Is pre-filled with your computers
information.
6. Message: The information entered above will be
combined into the message for our licensing
team.
7. Email: this will send the request by email to lice
nse@luxion.com
8. Copy to clipboard: allows you to easily copy the
entire message.

3. Install License

Click on the install License Tab to install the .lic file you
have received from out licensing team.

1. Click the Install License button.

2.

Manual, KeyShot 9
 2. Locate and select the .lic file in the
explorer/finder window.
3. The License info is displayed.
4. Check that the service is started.
5. The Luxion License Server window can now be
closed, it is not necessary to keep it open for
the floating licenses to be available, they can be
accessed as long as the server is online, and
the service is not stopped.

4. Status - available/used licenses

To monitor available/used licenses:

1. Click Status button to trigger the status window

2. The Status window will display the types of
licenses available and how they are in use.

Notice that "keyshot2" are Floating pro licenses and

"keyshot_vr" are the XR add-on licenses.

Manual, KeyShot 9
 5. Set Server Ports

If you have a Firewall or have other License servers running on the same machine you may need to change the Server Ports, this can be done by
clicking the Server Ports button.

FlexLM Port: Change this to avoid port conflicts If you have other License servers - the default is 27000
Deamon Port: This is only used for network setups with a Firewall. If a Firewall is used, both ports need to be set and opened in the
Firewall.

6. License Folder

The License Folder button is mainly present for support purposes, It leads to the License Folder where log files, etc. regarding the License Server
are stored.

Default locations for the License folder are.

Windows: C:\ProgramData\Luxion\License
Mac: /Applications/LuxionLicenseServer.app/Contents/License

Manual, KeyShot 9
 License Server Installation (Linux)
The instructions below will walk you through the typical first-time license service setup on Linux. Our licensing team will provide you with a license
file and the appropriate software links. You may reach our licensing team at license@luxion.com. On this page
License Server Setup Instructions
License Server Setup Instructions

If you are running RedHat Linux skip steps 3, 4 and 5.

1. Download and unzip the "KeyShot_Floating_License_Server_Linux.zip" file into the your home folder ("/home/<your username>" or "~/")

2. Open the terminal (usually Ctrl + Alt + T) and change your current directory to the luxion_flexlm folder ("~/luxion_flexlm")

cd luxion_flexlm/

If you are running RedHat Linux skip the next 3 steps.

Manual, KeyShot 9
 3. Run the following command:

ls -l /lib64/ld*

4. Take note of the return value before the arrow (highlighted in the picture).

5. Run the following command where <value from step three before the arrow> is the value from step 3 before the arrow.

sudo ln -s <value from step 3> /lib64/ld-lsb-x86-64.so.3

Manual, KeyShot 9
 6. Move your license file to your luxion_flexlm folder, where your file would have your computer name instead of MyCompany.

mv ~/Desktop/keyshot_floating_MyCompany.lic ~/luxion_flexlm/

Manual, KeyShot 9
 7. Run the following command to make sure everything is executable.

sudo chmod 766 *

8. Run the following command to star the service, where your file would have your computer name instead of MyCompany.

./lmgrd -C keyshot_floating_MyCompany.lic

Manual, KeyShot 9
 9. Run the following command to check the service status:

./lmstat -a

The lmstat output will confirm that the license server is up. The output message will also show you how many license seats are issued (available).

Manual, KeyShot 9
 KeyShot Pro Floating Installation
Now that your server is up and running, you are ready for the client setup on your computer. The instructions below will walk you through the
registration process for floating licenses. On this page
KeyShot Pro Floating Setup Instructions
KeyShot Pro Floating Setup Instructions

1. Download and install the KeyShot Pro Floating application. To download KeyShot, click here.

2. Launch KeyShot 9.

3. Select Floating License and click Continue

If you are currently in demo mode, open the registration wizard from

Windows: Help > Register License

Mac: KeyShot > Register License (Mac)

4. Enter the hostname of your license server. If the server uses another FlexLM port than the standard (27000) you need to specify the port number,

Manual, KeyShot 9
 followed by the “@” sign and the server’s hostname (for example, 27000@KeyShotServer.local). Click Connect.

You may also use the server’s IP Address (use the IP Address if your license server is a PC). For example, 27000@192.168.1.123. Click Connect.

Manual, KeyShot 9
 4. Review your license features, select the type of license you want to use and if you need KeyShot XR and Click Done.

Manual, KeyShot 9
 KeyShot Pro Floating will start. From now on, KeyShot will remember the server information. You will be able to check out the license as long as
your system can connect to the computer acting as the license server.

Technical Tip: If your service status window does not look similar to the above image or if you are getting an error message when you start the
server, you can use the troubleshooting guide for diagnosis. You may also contact Luxion Customer Support at support@luxion.com for
assistance.

Manual, KeyShot 9