SketchUp

Overview

The NVIDIA Omniverse™ SketchUp Connector Plug-In offers a toolkit for SketchUp Users to send and live sync their model(s) to an Omniverse Nucleus Server. This not only gives SketchUp Connector access to a first class renderer through Omniverse Apps but also the ability to open, edit and sync with any of the NVIDIA Omniverse™ Connect applications. Now, depending on the use case, SketchUp users can choose the workflows and pipelines that work best for their needs while maintaining up to date revisions for all downstream consumers of their work.

Installing the Connector

Installing the Omnvierse SketchUp Connector is done via the Omniverse Launcher. Simply navigate to the Exchange Tab then select Connectors, then Omnvierse SketchUp Connector and finally, select Install. This will install the Omnvierse SketchUp Connector provided you have a valid installation the SketchUp application.

Please see Launcher Documentation for Installing Connectors.

Connecting to Omniverse View (Local)

To connect the Omnvierse SketchUp Connector Plugin to Omniverse View a user must locate their installation of Omniverse View and select it in the Omnvierse SketchUp Connector Plugin Settings.

  1. Select the Omniverse View Settings

    View Connection 1
  2. Enable Send to Locally Installed View toggle.

    Toolbar Setup 5
  3. Select either a past installation of Omniverse View or Use Current to use the most current installed version.

    ../_images/connect_sketchup_setup_4.png
  4. Press “save” in the resulting settings window to commit the changes.

User Interface

The Omnvierse SketchUp Connector brings SketchUp projects into the Omniverse Platform. The panel shown below contains all the tools necessary for day to day operations with the SketchUp Connector.

UI Overview

Send to View

Sends your file directly to Omniverse View. Simply click Send to View and Omniverse View will launch with your model loaded and ready to go.

Send to View

Note

You must be sure that Omniverse View is installed and that you can access it from a server for this feature to work. See the Connecting to VIEW® (Local) for more details.

Send to View from SketchUp (Video)

Export

Send to View

Exporting your project to your Omniverse Nucleus allows you to continue your work in other applications such as Omniverse Create, Omniverse Maya Connector, Omniverse 3ds Max Connector and other Omniverse tools.

Send to View

Element

Result

Refresh

Updates the Window with Latest Data

Left/Right

Moves Through the Current Directory Structure in a Step By Step Fashion

Create New Folder

Creates a New Directory at Current File Path

Left Pane

Lists Omniverse Nucleus Directories (If Logged-In) and Local Drives / Directories

Right Pane

Lists Files in Currently Selected Directory

File Name

File Name of Exported File

File Type

Allows Selection of File Export Type

Export Only Selected Items

Restricts the Export to Currently Selected Objects

Use Material Mapping


Use SketchUp Mapping


Use Component Mapping


Export

Starts the Export Procedure with Selected Option

Cancel

Stops the Export Process and Closes Export Dialogue

Note

When you export your file, you create a connection for Live Sync which is visible in the Live Sync Path dialogue.

Sign-In

Sign In 1

The sign in window allows users to connect to their Omniverse Nucleus Server for Exporting, using Live Sync and for Mounts. Enter the server name you wish to connect to and press Sign In. Once done, a browser window will appear. Enter your username and password to connect.

Setting

Result

Server

Address of Omniverse Nucleus Server

Sign-In

Begins the Connection

Cancel

Stops the Sign-In Process and Closes the Sign-In Window

Settings

Settings

The settings menu allows you to select a preferred Omniverse View install as your viewer.

Settings2

Setting

Result

Enable Cache

Enables and Disables File Caching, Enabled improves performance.

Auto Sign-In on Startup

Automatically sign into the last user during the Revit Launch processes.

Unset

No View Settings (This setting disables Send to View)

Send to Local

Omniverse View Launch Path

Automatic Local

Locates Omniverse View Installs Automatically, “Use Current” Always Uses Most Recent Install

Custom View Location

Allows Selections of View Installs not Found by Automatic

Send to Server

Omniverse View Launch Path on a Remote Server

Automatic Server

Automatically Finds Servers

Remote Launcher

AAllows for Selection of a Specified Remote Server

Render Size

Render Quality to Use in View when Launching Remotely

Save

Commits the Changes and Closes the WIndow

Cancel

Closes the Window and Discarding the Changes

Note

You will need to have Omniverse View installed and selected to use Send to View.

Help

About

Opens a dialogue and displays version information about the installed Omnvierse SketchUp Connector Plugin

About

Display

Value

Build

Build Version Number

Date

Date Plugin was Created

Live sync

Sign In

Live sync updates your models allowing other Omniverse Apps get your changes in real-time.

Sign In

Setting

Result

Live Sync On

Enables Live Syncing

Live Sync Off

Disables Live Syncing

OK

Confirms Selection and Closes Window

Cancel

Closes Window, Any Live-Sync Changes are Left Unaffected

Materials

When sending your materials to Omniverse® VIEW®, we replace the low quality textures and shaders associated with SketchUp and replace them with High Quality Custom Materials inside of Omniverse® VIEW®. This is done by material mapping and can be controlled via CSV.

CSV and Materials

The CSV Mapping File for SketchUp can be located in the following directory.

<Documents>/Omniverse/SketchUp/omniverseSketchUpMDLtable.csv

CSV File Structure

A CSV file is a Comma Separated Values table of data whose field’s end is defined by a comma ‘,’.

Using Spreadsheet Tools

These tables are a very common format and can be opened/edited inside of Excel (or other spreadsheet tools) and will have 5 columns in them when viewed.

Format

Column

Expected Value

Column A

Name of the material from the application.
Note: Any commas (,) are replaced with an asterisk (*)

Column B

Indicates if there is a parameter override | NONE: default, no special characteristics | COLOR: the 5th column (Column E) will have the parameter name in the MDL
GENERIC: keyword and last resort match in mapping (looks for the value in Column A
in the string of the material name we get from the application e.g. if Column A is
glass and the material from SketchUp was Special Glass then it would match)
EXCLUDE: materials found in the application but NOT mapped, user could convert these
to real mappings by setting to NONE and changing the values in Column C/D/E (potentially)

Column C

MDL name (no .MDL)

Column D

Path into the location in the Omniverse database (points to a Mount)

Column E

If necessary, the parameter override in MDL

Examples

1
2
3
4
Cardboard,NONE,Cardboard,/NVIDIA/AEC/Library/Materials/Wall_Board
Blue Paint,COLOR,Paint_Satin,/NVIDIA/AEC/Library/Materials/Miscellaneous,diffuse_tint
glass,GENERIC,Clear_Glass,/NVIDIA/AEC/Library/Materials/Glass
Some Material Name,EXCLUDE,WhiteMode,/NVIDIA/AEC/Library/Materials/Styles

code …

Release Notes

104.1.461

Features:

  • Export as prop

  • Update to Omni Client Library 1.13

  • Checkpoint support for SketchUp

  • Support version 2021

  • Support S3 URL’s in the Connectors

  • Component replacement support via omniverseSketchUpPlanttable.csv

  • Separate save options from publish dialog into settings dialog

  • Update to Omni Client Library 1.13

Fixes:

  • When A Bad Server Name Is Entered, Connectors Should Handle The Entry In A Way That Is User Friendly

  • Incorrect Version number is shown for the SketchUp connector

  • Properly scale the MDL’s created for SketchUp materials

  • Merged faces in the Coffee Shop

  • Omniverse panel doesn’t automatically appear after update

Connect 102.1.428

  • Support for Layers (Tags) from SketchUp

  • Fix for object separation - objects are no longer merged as one

  • Export options have been moved to Settings

  • Sent to View, Publish, Props all use the material options found in the Settings dialog

  • Send to View no longer shows the startup panel in View

Connect 101.1.419

  • Added support for SketchUp 2021

Connect 101.1.411

  • Updated Client Library to match version of Create/View

  • Component mapping during Publish is now optional

  • Component mapping is controlled by the <Documents>/Omniverse/SketchUp/omniverseSketchUpPlanttable.csv file
    • Column 1: EXCLUDE in the first column denotes components used in SketchUp files but not mapped GENERIC in the first column will do a simple search of the component name using the value in the second column <Anything Else> in the first column will do an exact match of the value in the second column for replacement - Column 2: Name of the component in SketchUp - Column 3: Scale value of the USD object, default is 1, meaning 100% - Column 4: Rotation value in degrees about the pivot point of the USD object, default is 0 - Column 5: Name of USD to substitute for the SketchUp component (no .usd in this name) - Column 6: Path to where the USD object lives in the Omniverse Nucleus server (note the / on the end of the path)

  • Publish Prop is now available in addition to Publish to Project. This allows a SketchUp model to be saved as just a USD without the project framework around it.

Connect 100.1

  • Move to Launcher

  • Support for new materials, vegetation on the mount

  • Support for components to be mapped as USD instances

2020.2 Hotfix

  • Client Library Updated
    • Fixed a bug that would sometimes (very rarely) cause data loss if you got a disconnect while uploading a file.

    • Fixed a bug that would fail to download a file if it was an exact multiple of 1MB

2020.2 Point Release

New Features

  • Integrate new Client Library in Omnvierse SketchUp Connector

Bug Fixes

  • Glass Shows Very Strangely When Moving Around Model

  • Exported model with a non-mapped texture will hang opening Omniverse View