Scene setup

General considerations when setting up KeyShot scenes for VR.

General Setup

Number of polygons

A large polygon count in your scene may cause a drop in frame-rate which will have a negative effect on your experience in VR. Try to limit the Polygon count on the model.

The GPU rendering in KeyVR is polygon and fill-rate limited. I.e. for the best frame-rate limit the number of polygons to 2-3 million on high-end GPU's. KeyVR will accept any number of polygons that fit in GPU memory though. Easily 40 millions on a 4 GB graphics card.

How do I see how many polygons my scene has?
In Keyshot you can see the Polygon count (Number of triangles) of your scene, in the Real-time view's Heads-Up Display. This can be turned on from the Main menu > View > Heads-Up Display or with the "H" hotkey.

Can I limit the polygon count in KeyShot?
If your model contains NURBS data, the number of triangles can be limited inside KeyShot. Either by adjusting the tesselation factor when importing your models into KeyShot or by re-tesselating the entire model or specific parts after import. More about Re-Tessellating in KeyShot.

If your Model does not contain NURBS data, you will have to adjust the polygon count in the CAD application.


The geometry has to be triangle based, curve based geometry, zspheres and NURBS are not supported (NURBS can be re-tessellated in KeyShot).

Lighting Preset

KeyVR does not do global illumination or raytracing. This means that product renderings currently look considerably better than interior renderings in KeyVR.

More about Lighting Presets in KeyShot

Use of textures

You can use image textures on your model. Currently only one Mapping Type (Box, UV etc.) is supported per part (view supported Mapping types) and all Map Types (Diffuse, Bump etc.) have to have the identical parameters - i.e. they should be synced.

More about Mapping Type and Map Types in Keyshot

Scene Units

KeyVR uses the scene units that  The units of the KeyShot scene is directly used as units for the VR headset. If a scene unit has not been selected it is assumed to be in meters. I.e. a box of size 1x1x1 will be a box that looks like it is 1 x1x1 meters big in VR.

Scene elements


All models in a Model Set can be moved independently - so make sure that anything you want to handle as a group, is organized as a model in the Scene Tree. If you have locked objects, these cannot be moved in KeyVR, but they will still respond to a change of material.

It is a good idea to consider the scale of the objects you want to show, in relation to the VR experience. For instance if you want to examine a very small object in VR, it will be lying on the "floor" while the HMD will be positioned much higher than that - in this case it could make sense to position the item on a sort of pedestal, to get it within reach/visual range of the KeyVR user.

Model Sets

There can only be one Model Set visible at a time. If your scene has multiple Model Sets, the Switch Model Set option will be appear in the VR menu, and let you cycle through the Model Sets one by one. The exception to the rule is if a Model Set is set to Always Visible. in which case the Model Set will not be included in the cycle, but be visible all the time. Objects in an Always Visible Model Set can be manipulated just like any other unlocked object (with Move and Switch Material) .


In many cases you want a 3D environment that your object of interest is situated in. In order to not inadvertently move that environment it can be set to "locked" in the KeyShot Environment list and KeyVR will respect that.

If you want to "ground" your object without adding an actual ground plane, you can use the Flatten ground option, just as in KeyShot. But be aware that the fly mode will not be able to go below the object, if Flatten ground is turned on.


The HMD by default starts at the position of the active camera from KeyShot. It is a good idea to wear the headset while you launch the scene, otherwise the direction of the HMD will change when you put on on, and you may need to turn around to see the objects.

All cameras in the scene can be accessed in KeyVR - also animated cameras. The user can jump to an animated camera just like the regular cameras.


When playing/pausing animations in the KeyVR menu, it will affect all object/material animations, but not camera animations, these can be accessed via the Select Camera menu.

KeyVR will disregard any Switch Events you may have in the scene.