Version: 2022.3
Language : English
Materials tab
SpeedTree Import Settings window

SketchUp Import Settings window

Switch to Scripting

SketchUp is software that is commonly used for architecture modeling. Unity reads SketchUp files directly and supports the following SketchUp features:

  • Textures and Materials, which Unity imports according to the settings on the Materials tab.
  • Component Definitions and Groups, which are converted into meshes, instanced as GameObjectsThe fundamental object in Unity scenes, which can represent characters, props, scenery, cameras, waypoints, and more. A GameObject’s functionality is defined by the Components attached to it. More info
    See in Glossary
    which you can place in the sceneA Scene contains the environments and menus of your game. Think of each unique Scene file as a unique level. In each Scene, you place your environments, obstacles, and decorations, essentially designing and building your game in pieces. More info
    See in Glossary
    .
  • CameraA component which creates an image of a particular viewpoint in your scene. The output is either drawn to the screen or captured as a texture. More info
    See in Glossary
    data for each scene in the file.

Tip: For a list of known issues and limitations with importing from SketchUp, see the Limitations section below.

The SketchUp Import Settings window
The SketchUp Import Settings window

(A) You can switch between the Sketch Up tab and the Materials tab. SketchUp import settings for Materials work exactly the same way as for standard FBX Models. For reference documentation on properties on the Materials tab, see the Materials tab documentation.

(B) The SketchUp section provides settings that are specific to SketchUp Models.

(C) The Meshes section provides the same settings as those available for FBX Models.

(D) The Geometry section provides a subset of the settings available for FBX Models, dealing with indexing and UVs.

(E) Use the Revert button to cancel any changes you make on the SketchUp Import Settings window or Apply to accept the changes and continue.

SketchUp section

To import a SketchUp file directly into Unity, drag it into the Assets folder using the Finder (macOS) or the File Manager (Windows). Then select the Asset file from the Project view inside the Unity Editor.

The SketchUp properties section
The SketchUp properties section
Property: Function:
Generate Back Face Generate back-facing polygons in Unity. By default, Unity only imports the front-facing polygons to reduce polygon counts unless there is Material assigned to the back-facing polygons in SketchUp.
Merge Coplanar Faces Merge coplanar faces when generating meshes in Unity.
Unit Conversion Length measurement to unit conversion.
Unit drop-down box Choose the unit to use for the conversion. Defaults to Meters.
Value to convert This value determines how the Scale Factor is calculated (see Unit conversion below).
Longitude Read-only value from the Geo Coordinate system, used to identify a position on a geographic system.
Latitude Read-only value from the Geo Coordinate system, used to identify a position on a geographic system.
North Correction Read-only value from the Geo Coordinate system, used to describe the angle needed to rotate North to the Z axis.
Select Nodes Open a window where you can specify which nodes to import. A node represents an Entity, Group, or Component Instance in SketchUp. For example, if you have one file containing several couches, you can select the one you want to import. For more information, see Selecting SketchUpNodes below.
Import Cameras Import cameras from your .skp file. See Importing Cameras below for details.

Unit conversion

By default, Unity scales SketchUp models to 1 meter (0.0254 inches) to 1 unit length.

SketchUp file with a cube set to 1m in height
SketchUp file with a cube set to 1m in height

Changing the default Unit Conversion values affects the scale of the imported file:

 The green square is placed as reference where the size of the square is set to 1x1 unit length.
The green square is placed as reference where the size of the square is set to 1x1 unit length.

Selecting SketchUp Nodes

Unity supports the visibility setting in the SketchUp file for each node. If a node is hidden in the SketchUp file, Unity does not import the node by default. However, you can override this behavior by clicking the Select Nodes button to display the SketchUp node hierarchy in the SketchUp Node Selection Dialog window.

SketchUp Node Selection Dialog window
SketchUp Node Selection Dialog window

Each group and component instance in the file appears in the hierarchy as a node, which you can select or deselect. When you are finished selecting the nodes to include, click the OK button to import only the checked nodes.

Importing cameras

When Unity imports cameras from a .skp file, it converts these SketchUp camera types to the following:

SketchUp Camera type: Unity Camera:
Parallel Projection Camera in orthographic mode
Perspective Camera in perspective mode
Two Point Physical Camera with a non-zero lens shift

Meshes property section

The Meshes properties section
The Meshes properties section
Property Function
Mesh Compression Set the level of compression ratio to reduce the file size of the Mesh. When you increase the compression ratio lowers the precision of the Mesh by using the mesh bounds and a lower bit depth per component to compress the mesh data.

To optimize game size, turn Mesh Compression up as high as possible without the Mesh looking too different from the uncompressed version.
Off Don’t use compressionA method of storing data that reduces the amount of storage space it requires. See Texture Compression, Animation Compression, Audio Compression, Build Compression.
See in Glossary
.
Low Use a low compression ratio.
Medium Use a medium compression ratio.
High Use a high compression ratio.
Read/Write Enabled When you enable this option, Unity uploads the Mesh data to GPU-addressable memory, but also keeps it in CPU-addressable memory. This means that Unity can access the Mesh data at run time, and you can access it from your scripts. For example, you might want to do this if you’re generating a Mesh procedurally, or if you want to copy some data from a Mesh.

When this option is disabled, Unity uploads the Mesh data to GPU-addressable memory, and then removes it from CPU-addressable memory.

By default, this option is enabled. In most cases, to save runtime memory usage, disable this option. For information on when to enable Read/Write Enabled, see the Mesh.isReadable API documentation.
Optimize Mesh Determine the order in which triangles are listed in the MeshThe main graphics primitive of Unity. Meshes make up a large part of your 3D worlds. Unity supports triangulated or Quadrangulated polygon meshes. Nurbs, Nurms, Subdiv surfaces must be converted to polygons. More info
See in Glossary
for better GPU performance.
Nothing No optimization.
Everything Let Unity reorder the vertices and indices for both polygons and vertices. This is the default.
Polygon Order Reorder only the polygons.
Vertex Order Reorder only the vertices.
Generate Colliders Enable this option to import your Meshes with Mesh CollidersAn invisible shape that is used to handle physical collisions for an object. A collider doesn’t need to be exactly the same shape as the object’s mesh - a rough approximation is often more efficient and indistinguishable in gameplay. More info
See in Glossary
automatically attached. This is useful to quickly generate a collisionA collision occurs when the physics engine detects that the colliders of two GameObjects make contact or overlap, when at least one has a Rigidbody component and is in motion. More info
See in Glossary
Mesh for environment geometry, but is not suitable for geometry you are moving.

Geometry properties section

The Geometry properties section
The Geometry properties section
Property Function
Index Format Define the size of the Mesh index buffer.

Note: For bandwidth and memory storage size reasons, you generally want to keep 16-bit indices as default, and only use 32-bit when necessary, which is what the Auto option uses.
Auto Let Unity decide whether to use 16-bit or 32-bit indices, depending on the Mesh vertex count when it imports a Mesh. This is the default setting.
16 bit Use 16-bit indices when importing a Mesh. If the Mesh is larger, then it is split into <64k vertex chunks.
32 bit Use 32-bit indices when importing a Mesh. If you are using GPU-based rendering pipelines (for example with compute shader triangle culling), using 32-bit indices ensures that all Meshes use the same index format. This reduces shaderA program that runs on the GPU. More info
See in Glossary
complexity, because they only need to handle one format.
Swap UVs Swap UV channels in your Meshes. Use this option if your diffuse Texture uses UVs from the lightmapA pre-rendered texture that contains the effects of light sources on static objects in the scene. Lightmaps are overlaid on top of scene geometry to create the effect of lighting. More info
See in Glossary
. Unity supports up to eight UV channels but not all 3D modeling applications export more than two.
Generate Lightmap UVs Creates a second UV channel for Lightmapping. See Lightmapping for more information.

Limitations

  • SketchUp import is not supported on Linux.
  • Unity does not support GIF Textures.
  • Unity imports only limited data from SketchUp Scenes.
  • Unity does not support or import the following SketchUp features:
    • 2D Components (Text, dimensions)
    • Animation settings
    • Attributes
    • Drawing Styles
    • Dynamic components
    • Layers
    • Lines
    • Section Planes
    • Shadow settings

  • Camera import fully supported starting in 2019.1 NewIn20191

SketchUpImporter

Materials tab
SpeedTree Import Settings window