Hardware and Graphics Performance Recommendations

Browsers

Onshape currently supports these tested and approved browsers:

• Google Chrome
• Mozilla Firefox
• Safari (Mac OS only)
• Opera
• Microsoft Edge

Microsoft Internet Explorer is currently not supported.

Onshape suggests that you run the 64-bit version of browsers on operating systems that are able to run both 64-bit and 32-bit (i.e. Windows, Linux).

Vivaldi browsers will work with Onshape, however, you need to disable Allow Gestures in your browser Mouse settings as this setting conflicts with Onshape's mouse settings.

WebGL

Onshape requires WebGL. To ensure that you are taking advantage of the highest performing configuration, first update your graphics drivers to the most recent version from the manufacturer and make sure your preferred browser has WebGL enabled. Most modern browsers enable it by default, but certain hardware or graphics driver configurations will turn it off. If you see an error in Onshape (for example, It looks like your browser doesn’t have WebGL enabled, or Rats! WebGL hit a snag) or the browser compatibility check page says WebGL is disabled, try the following steps in your browser of choice.

Some graphics cards are blacklisted because of poor WebGL support. A list is available at https://www.khronos.org/webgl/wiki/BlacklistsAndWhitelists and steps are listed below to override the blacklist in Chrome and Firefox. Legacy operating systems, such as Windows XP, can lack modern driver and browser support, and hence may not run Onshape, even with these work-arounds.

If you make these changes while running Onshape, simply refresh your browser for the changes to take effect.

Mac High Power mode

If you are using a Mac, ensure High Power mode is turned on. See https://support.apple.com/en-us/HT212852.

Chrome

Ensure WebGL is on and hardware accelerated is checked first:

1. Open a chrome browser window, type chrome://settings/system in the URL field, and press Enter.
2. Ensure Use hardware acceleration when available is checked.
3. Relaunch Chrome to have this change take effect.

Check Onshape at this point. If it’s still not working, try to force WebGL hardware rendering via the following:

1. Go to chrome://flags.
2. Enable the flag called Override software rendering list.

Firefox

1. Go to about:config.
2. Search for webgl.disabled and ensure its value is false.
3. Go to about:support.
4. Inspect the WebGL Renderer row in the Graphics table:
   1. If the status contains a graphics card manufacturer, model and driver (eg: NVIDIA Corporation -- NVIDIA GeForce GT 650M OpenGL Engine), then WebGL is enabled.
   2. If the status is something like Blocked for your graphics card because of unresolved driver issues or Blocked for your graphics driver version, then your graphics card/driver is blacklisted.
5. If your graphics card/drivers are blacklisted, you may override the blacklist:
   1. Go to about:config.
   2. Search for webgl.force-enabled.
   3. Set to true.
6. Like Chrome, Firefox has a Use hardware acceleration when available checkbox:
   1. Go to Preferences > Advanced > General > Browsing.
   2. However, unlike Chrome, Firefox does not require this checkbox to be checked for WebGL to work.

Safari

1. Click Safari and select Preferences from the menu.
2. Click the Security tab.
3. Select Allow JavaScript.
4. Select Allow WebGL.

Opera

1. Go to opera://settings.
2. Navigate to Browser and scroll down to System.
3. Ensure that Use hardware acceleration when available is checked.
4. Restart your browser for changes to take effect.

More information for all of these browser settings is available at: https://superuser.com/questions/836832/how-can-i-enable-webgl-in-my-browser.

Graphics cards

The system check (explained above) also provides insight into the rendering performance of your computer as currently configured. This is expressed as triangles per second (TPS) and represents most of the work being done by your computer. The more TPS your computer can render, the faster a model will be rendered to the screen on open and the more smoothly it will rotate.

While it is hard to give numbers for recommended TPS, it is easy to say that for larger assemblies, the Onshape experience is better with a discrete (dedicated) graphics card.

To improve your TPS, you don't need an expensive graphics card, a low-end gamer card that supports WebGL will work, and generally improve performance significantly. More GPU RAM will enable more and larger datasets to be opened concurrently in Onshape. Without a dedicated graphics card, the rendering task is performed by the CPU and yields significantly lower numbers.

If you see the message shown below, take steps to either install a dedicated graphics card, or take steps to resolve an unrecognized graphics card, explained below.

Safari may not display the graphics card in use on the browser compatibility check page. This is not a cause for concern provided you are not experiencing any performance issues.

Many computers have more than one graphics card installed (GPU). Often, on Windows machines with NVIDIA graphics cards, Optimus technology is also involved, meant to optimize the workload between GPUs -- to assign the proper graphics card to applications needing a high performing graphics card and applications needing more battery life and lower performing graphics card. Your out-of-the-box system settings may be using the integrated chip by default to render Onshape in your web browser or when on battery power. To get the best performance, specify that the browser always use the discrete graphics card, or disable automatic graphics switching, depending on your device.

For information on how to force the browser to use the dedicated GPU, see: https://www.addictivetips.com/windows-tips/force-app-to-use-dedicated-gpu-windows/

If you do not have NVIDIA or NVIDIA with Optimus technology, you may skip this section.

To get the most out of your graphics cards:

• Make sure the graphics card you use is not on the WebGL blacklist, as some video graphics cards do not support WebGL.

  See https://www.khronos.org/webgl/wiki/BlacklistsAndWhitelists for more information.

• Onshape performs best when Optimus technology is not involved in the management of graphics cards. To ensure that Optimus technology, if present, does not interfere with the best performance of the graphics card when working with Onshape:

  Determine whether or not your computer uses Optimus technology:

  1. Open the NVIDIA control panel.

     Select System Information and then Components. If Optimus technology is present, it will be listed somewhere in the right column.

  2. If Optimus technology is present, make the NVIDIA graphics card the default card for Onshape (for the browser you use with Onshape), through the NVIDIA control panel.

To make the NVIDIA graphics card the default GPU for Onshape, or rather, the browser you want to use for Onshape:

1. Open the NVIDIA control panel.
2. Navigate to 3D Settings > Manage 3D Settings and then the Program Settings tab.
3. Locate the browser you use for Onshape.
4. Set Select the preferred graphics processor for this program option to High-performance NVIDIA processor.

If this method doesn't work, see below for more options.

Windows and NVIDIA

If your Windows system isn't recognizing the NVIDIA graphics card, check the following settings:

1. Open Windows settings.

2. Select Display settings.

3. Scroll to Graphics settings:

   

4. Turn on Hardware-accelerated GPU scheduling:

   

5. Under Desktop app, click Browse.

6. Search for and select NVIDIA.

7. Click Options and select Let Windows decide:

   

8. Restart your PC to apply the changes.

9. Open NVIDIA control panel.

10. Select Adjust image settings with preview:

    

11. Make sure that Let the 3D application decide is checked.

At this point, when using Onshape, the NVIDIA graphics card should be used for rendering graphics.

In a nutshell

You want to use your high performance GPU when an application (like Onshape) demands it. Having a management technology involved (like Optimus) doesn't always result in the performance you are hoping for.

If you don't know what your computer has by way of GPUs, you have the ability to download and use a utility such as Speccy (for Windows) or gfxCardStatus (for Mac) to discover what is installed on your machine.

You want to use the faster, discrete NVIDIA GPU (when available) for Onshape, always. For applications that do not require high performance graphics or require longer battery life, you have the option to use an integrated GPU such as Intel's integrated GPU. To this end, assign the appropriate GPU to a specific browser.

Alternative

As a last resort, you could try to go into the machine's BIOS settings and switch off Optimus technology completely and run using the discrete NVIDIA GPU all the time. This carries serious risk, however, so make sure you know what you're doing here, or seek help before attempting this solution.

Displaying memory-intensive models

Onshape uses a WebGL rendering context in order to display 3D data in the browser. There are occasions when a browser will take away the rendering context. For instance, when changing the display connected to your computer, the browser may need to update the context for the new display. Typically, the context is quickly restored after being taken away.

Occasionally a browser may take away the WebGL context and never return it. One known cause of this situation is when the GPU runs out of memory. This may occur if the GPU has relatively little video RAM to begin with (less than 1 GB), or if the loaded tab has sufficient complexity to exceed the limits of the GPU's RAM. If context loss issues persist, try loading the document on another device with more video RAM to see if the issue recurs there. Video RAM memory usage may be reduced by lowering tessellation quality for parts contained within the tab.

Speed of page loading and tessellation quality

In very large documents, Chrome may run out of memory before the tab (Part Studio or Assembly, for example) is fully loaded. This may occur due to the large number of entities and volume of display data involved.

One way Onshape speeds the loading of the tab is by deferring the loading of less important bodies, for example, parts that are out of view or too small to be used. These bodies are loaded when they become important enough for viewing as the need arises, for example, when hovering over the part, zooming in, or when hiding some parts so others are visible.

In order to stay under the browser memory threshold, Onshape may unload other unimportant bodies after loading more important ones. If this is necessary, small or invisible, memory intensive parts are unloaded first.

Unloaded parts will appear as semi-transparent boxes that take up the bounds of the part. Parts become 'important' as they come into view and take up a significant part of the screen. When this happens, the system automatically starts loading the part. Once it is loaded, the part resolves to its fully-loaded state, and all geometry is visible.

Onshape progressively pulls down finer tessellation for part data in Part Studios and Assemblies, when finer tessellation exists.

The mechanism works by sampling the Part Studio or Assembly to detect poor-quality parts after view manipulation is stopped. If poor quality parts are detected, Onshape requests better representations from the server.

This automatic tessellation refinement might be hindered under the following conditions:

1. The interactive frame rate becomes too slow (the current threshold is 20 FPS)

2. The amount of data exceeds the memory limit

In the case of exceeding the memory limit, Onshape compensates by swapping out older, unused body representations for refined representations of what is currently in view.

For more information on setting and viewing tessellation quality, see Performance Panel.

Troubleshooting the performance check

If the performance check was not executed due to a low refresh rate (less than 60hz), or the check resulted in an unexpectedly low triangle/line count, these troubleshooting steps may lead to better results:

• Ensure that the performance check page window is in focus throughout the test.
• Limit the amount of other activity going on in the test system. If another CPU/GPU-intensive program is running simultaneously, it could steal resources from the test and affect the results.
• In case of dual graphics systems, ensure that you are getting the expected GPU. On some systems the browser is limited to the integrated GPU, which may not perform as well as the discrete GPU. Consult the GPU documentation or the operating system help to ensure the browser is able to access the GPU of your choice.
• The performance test will not be run if the browser is not updating at (at least ) 60 frames per second. Certain combinations of displays, cables, and GPUs will result in a reduced refresh rate. Check your GPU specifications to ensure that the GPU can support a 60 hz refresh rate at the native resolution of your display. Also ensure that your display cable (e.g. HDMI) supports the given resolution and refresh rate. A reduced refresh rate does not affect the overall number of triangles Onshape can display, however you may experience some drop in interactive performance. You can use this site to test the refresh rate on your browser: https://www.testufo.com/refreshrate

Improving rendering performance

When browser frame rate has dropped below the Onshape threshold for more than three minutes, Onshape displays the message: Reduced rendering performance detected:

Before proceeding, it's best to check system compatibility to make sure you are using the best GPU on your system. Click the link in the message or here. Once you have determined that you're using the best GPU, you can also try the following to improve performance:

• Change render mode to Shaded without edges. For large assemblies that contain many components, edges can add a significant amount of time to the render loop. If edges are not needed, you can opt for the Shaded without edges rendering mode in the View cube dropdown. Remember that you can still select edges even when in Shaded without edges mode.
• Disable Match pixel density. If your computer has a high-DPI display, significant time can be spent matching the pixel density of the monitor. Improve performance by sacrificing some quality through disabling the Match pixel density option. See Environment profile settings in the Preferences help topic for more details.
• Disable tessellation overrides. When tessellation is being forced to a higher level of detail, it results in the GPU having to render more triangles and can affect performance. Consider removing the override to avoid this overhead, or force detail to the coarse setting, to lower the total triangle count. See the "Specifying tessellation quality" heading within the Customizing Parts: Appearance help topic for more details.
• Make sure your browser is up-to-date. Browser vendors, such as Chrome and Firefox, are continually updating their own code base in order to optimize performance and add functionality. If your browser has not been updated recently, you may be missing out on updates that can have real effects on Onshape performance.

The primary requirement for using Onshape is a reliable Internet connection. An intermittent connection results in a sub-optimal Onshape experience - you will be asked to refresh your browser tab with each dropped connection. However, no work or data is ever lost.

Keep in mind that because using Onshape is not like streaming a movie or using a screen sharing app, it does not require constant use of a high bit-rate (bandwidth).

Instead, as stated earlier, Onshape is conversational, meaning that short messages are sent only when an action is being performed. For an (idealized) example, the request to fillet an edge is replied to by a return message describing the facets (triangles) that have changed as a result of the fillet. All rendering, rotation. zooming, sectioning, and selection is handled by the GPU and requires ZERO bandwidth. Because the duration of the messages is small compared to the periods of silence, the bandwidth requirement for multiple users scales in a very non-linear way. Are there variations on this? Yes, but this example describes the principle by which multiple users can share even a modest connection. If you must have a metric: if your connection can support a single video stream, you can support a team using Onshape.

No CAD data (other than exported downloads) is transferred to the end user, eliminating the morning logger jam experienced by users of other CAD systems while trying simultaneously to check files out of a vault onto their local machines.

Due to Onshape's full-cloud architecture, increases in RAM provide only marginal gains in performance. However, additional RAM can improve the experience of running multiple browser tabs or other applications simultaneously.

When using Onshape on your mobile device, you also have access to the same help system as on the browser. Onshape Help offers device-specific help where appropriate. You can access Onshape Help through the browser and through Onshape mobile app (links to the apps below).

This means:

• You get all of the power, precision, functionality, and flexibility of Onshape no matter what platform you’re using
• You can sign in and work from anywhere—without ever having to worry about updates, new versions, installations, memory or storage
• You have access to all of your documents and project files at any time

Supported Android versions

• Lollipop (5.0, 5.1)
• Marshmallow (6.0)
• Nougat (7.0)
• Oreo (8.0)
• Pie (9.0)
• Android 10

Onshape minimally requires Lollipop (5.0).

To check what version of Android your device has installed, go to your settings and check the About or General section.

Graphics Performance

Devices with older GPUs and older implementations of OpenGL ES 2.0 sometimes lack the necessary capabilities to run Onshape's 3D graphics. This most often happens on devices with a Mali 400 GPU.

When using devices with older GPUs or implementations of OpenGL ES 2.0 an error message will alert you when you open a Part Studio or an Assembly. The error message offers a link to more information as well as a link to continue.

If you elect to proceed after receiving the error message, you will likely notice graphics glitches or a blank, white screen. Eventually, the app may crash.

Why doesn't it work?

The Onshape graphics library uses Vertex Array Objects (VAOs). VAOs are supported natively in OpenGL ES 3.0 and above, but are not supported in the OpenGL ES 2.0 library. Often, implementations of OpenGL ES 2.0 contain extensions that support VAOs, but the support of these extensions is not guaranteed by Android and depend on the service of the manufacturer.

By default, Onshape allows a device with OpenGL ES 2.0 or higher to install the application but it is not until the app is running on a device that it can detect if the device has the necessary capabilities or extensions.

How can I fix this?

Use a device that supports, at the very least, OpenGL ES 2.0 with Vertex Array Object extensions.

A device running the latest version of Android does not necessarily support OpenGL ES 3.0. We recommend that you avoid running Onshape on devices with a Mali 400 or Mali 450 GPU, as these are unable to render 3D graphics properly.

It is recommended that you use a device that runs OpenGL ES 3.

How do I find out what GPU I have?

The most direct way to find out what GPU your device uses is to search for your device and/or serial number on the Internet. For example; you might try browsing or searching for your device on a website such as gsmarena.com or phonearena.com.

Supported iOS versions

Onshape minimally requires the latest version of iOS 16 or iPadOS 16.

To check what version of iOS your device has installed, go to Settings > General > About > Version.

Supported iOS devices

• iPhone 8 and above

• iPhone SE (2nd generation and above)

• iPad Mini (5th generation and above)
• iPad Air (3rd generation and above)
• iPad Pro (1st generation and above)

If you'd like to bookmark Help pages on the iOS platform, you can use your app settings on your iOS device and set Open Help in browser to on. When you access the help via Onshape, it will then open in a browser, where you can create bookmarks of specific topics or pages.

Onshape supports keyboard shortcuts and mouse support when using peripherals.