Calling Compute with JavaScript

by Scott Davidson (Last updated:  Thursday, November 11, 2020)

By the end of this guide, you should have all the tools installed necessary for using the Rhino Compute through JavaScript.

The libraries will run on on all major browsers as well as node.js.

Setting up a Compute Project using JavaScript

There are a few client side tools which need to be referenced that are essential to communicate with the Compute server. These include:

  • rhino3dm.js - Is part of the Rhino3dm project. It is a Javascript wrapper and web assembly (WASM) for openNURBS which contains the functions to read and write Rhino Geometry Objects.

  • compute-rhino3d.js - This is a work in progress package which is meant to add classes available in RhinoCommon, but not available through rhino3dm.js. Compute-rhino3d makes calls into the McNeel Cloud Compute server for these functions. It handles all the transaction authorizations and JSON data conversion.

    <html>
  <!-- stuff -->
  <body>
    <script async type="text/javascript" src="https://files.mcneel.com/rhino3dm/js/latest/rhino3dm.js"></script>
    <script async type="text/javascript" src="https://files.mcneel.com/rhino3dm/js/latest/compute.rhino3d.js"></script>
    <!-- more stuff -->
  </body>
</html>

The first use of Compute

An example of using JavaScript to access compute can be found in the Javascript Sample repo

Next Steps

Congratulations! You have the tools to use Rhino Compute server. Now what?

  1. To see the transactional nature of Compute, read through compute.rhino3d.js
  2. See a list of the 2400+ API calls available for compute.rhino3d.com.
  3. Download the Compute Samples repo from GitHub.
  4. The libraries are still very new and changing rapidly. Give them a try or get involved. Ask any questions or share what you are working on the Compute Discussion Forum