Skip to content
07-848 2005

KeyShot Studio, Working With Models

Import models into KeyShot Studio

Import models into KeyShot Studio and choose how they appear in your scene.

On this page
  1. Quick import
  2. Import dialog
  3. 1. Scene (Pro only)
  4. 2. Position
  5. 3. Geometry
  6. 4. Environment and camera
  7. 5. Materials and structure
  8. 6. Enable Quick Import
  9. Additional options
  10. BIP import
  11. Scene
  12. Materials and structure

You can import models into KeyShot Studio using any of these methods:

  1. Select Import on the Toolbar.
  2. Drag and drop the model into the Real-time View.
  3. Press Ctrl+I/Cmd+I.
  4. Select Main Menu > File > Import….
  5. Select Main Menu > File > Import Dialog….

Quick import

The Import Dialog opens the first time you import a model in any of the supported formats. Select Enable Quick Import. in the bottom left corner to skip the dialog when using the first 4 methods. Main Menu > File > Import Dialog… always opens the dialog.

You can edit the Import Settings or turn off Quick Import in Preferences.

Import dialog

KeyShot Studio supports several 3D file formats. The options shown in the Import Dialog depend on the file type you import.

Import dialog obj

1. Scene (Pro only)

If your scene already contains content, the Import dialog offers these options:

  • Add to Scene imports the model into the current scene. You can also choose which Model Set to add it to:
    • New model Set creates a Model Set and imports the file into it.
    • Select Model Set(s) lets you choose which Model Sets contain the imported model. The active Model Sets are selected by default.
    • Import Metadata imports metadata from .asm files. You can view and edit it in the Object metadata viewer (Window>Object Metadata Viewer). To re-import or export metadata, go to General Tab.
  • Update Geometry is available if you have already imported the model. It updates the model without rebuilding your KeyShot Studio scene. Some dialog options are hidden when you select it. KeyShot Studio compares the imported geometry with the scene, then adds or removes the differences. Changes you make to geometry, such as through Tools, or part names in KeyShot Studio can affect geometry updates.
  • Add to Empty Scene clears the current scene before adding the imported model to a fresh scene.

2. Position

  • Center Geometry places the imported model at the centre of the environment and removes its original 3D coordinates. If you leave this option off, the model keeps its original position in 3D space.
  • Snap to Ground places the imported model directly on the ground plane. This removes its original 3d coordinate information.
  • Keep position relative to native origin positions the geometry relative to its original origin point. Use this when importing an assembly across multiple files that share a CAD origin.
  • Up Orientation sets the model's up-axis. Modelling applications use different up-axis settings, so you may need to change the default Y Up setting. KeyShot Studio recognises the up orientation of the 3D modelling software, but your model may use a different orientation. If it imports on its side, try another orientation.

3. Geometry

  • Geometry Unit sets the units used to model the geometry on the first import. If you select a different unit on the second import, KeyShot Studio adjusts the model's scale. This option is available only for .wire, .3ds, .obj and .stl files.
  • Tessellation Quality sets the geometry's tessellation quality using a slider or input box. Lower values import faster; higher values import slower. Use the recommended default of 0.2.
  • Accurate Tessellation optimises tessellation triangle size to improve performance. Enable it if your import format supports it.
  • Import NURBS Data (Pro) imports NURBS geometry for smooth curves without faceting.
  • Cached Geometry imports an assembly without its part files. This option is available only for SolidWorks and SolidEdge.
  • Calculate Normals is available only for .obj files. Try importing with it turned off first, as the file may already contain normals.

4. Environment and camera

  • Adjust Camera to Look at Geometry centres the camera to fit the imported geometry in the scene.
  • Adjust Environment to Fit Geometry resizes the environment to fit the imported geometry in the scene.
  • Import Cameras adds native CAD cameras to the KeyShot Studio camera list.

5. Materials and structure

  • Separate Materials by Part/Layer keeps linked materials within each part by adding the part name to the start of each material name.
  • Keep Individual Parts prevents objects from merging so you can troubleshoot them. Try importing with it turned off first to avoid separating surfaces unnecessarily. This option is available only for .wire, .dwg, .dxf, .igs, .obj and .skp files.
  • Retain Materials is available for Update and Add to Scene imports. It applies materials already assigned in the scene to the imported model when the native CAD material names match.
  • Import Layers as Groups uses the Layers set up in Maya to define the tree structure. This option is available only for .ma and .mb files.
  • Collapse Hierarchy flattens the tree structure to simplify the Scene Tree. This option is available only for .ma and .mb files.
  • Assign Materials from Library automatically assigns materials on import when native CAD material names match material names in the KeyShot Studio Library.
  • Use Material Template lets you apply an existing Material Template during import. Material Templates assign materials from the KeyShot Studio library to imported parts in bulk, based on each part's original material name. See Material Templates for details.
  • Structure Scene Tree hierarchy by sets the Scene Tree structure. The options in this drop-down depend on the file format.
    • Object (name) keeps the assembly structure and names for accuracy and flexibility.
    • Material (type) flattens the hierarchy by creating a single part for each material.
    • Layer keeps the assembly structure and names for accuracy and flexibility.
    • Shader flattens the hierarchy by creating a single part for each shader.

6. Enable Quick Import

Enable Quick Import to save the current Import dialog settings and apply them the next time you import a model in the same file format. You can turn off Quick Import or edit its settings under Import settings in Preferences.

Additional options

  • Animation offers Entire Animation, which imports all animation data in the file, and Specific Frame, which imports data such as deformations at a specified frame without adding animations to the Timeline. This option is available only for .abc, .ma, .fbx and .mb files.
  • Curve Import Options includes Curve Radius Modified, which adjusts the thickness of imported curves. This option is available only for .abc, .fbx, .ma and .mb files.

BIP import

Import dialog bip

You can also import a KeyShot Studio scene (BIP). KeyShot Studio asks whether you want to open the file or import it into the current scene.

  • Open file hides the remaining dialog options, closes your current scene and opens the new scene.
  • Import file shows the Import settings for adding the model to the current scene.

Along with some of the options in the Import dialog section, you can choose from the following:

Scene

  • Import lets you choose what to include from the .bip or .ksp file.

Materials and structure

  • Apply Materials from Scene to matching source names updates and links materials in the imported model when their names match materials in the In-project Library.
  • Apply Materials from Library to matching source names updates and links materials in the imported model when their names match materials in the Material Library.

If both options are enabled and the library and current scene contain different versions of a material, KeyShot Studio applies the scene's version to the imported geometry.

Procadsys customer support

Still need help?

Licences, renewals and billing

Our New Zealand team looks after your KeyShot licences, renewals and invoices.

Monday to Friday, 9:00 am to 4:30 pm NZ time, excluding New Zealand public holidays.

Technical problems

Installation errors, crashes and other technical problems with KeyShot are handled by KeyShot support.