A first processing using Simplygon Cloud
Below follows a quick guide on how to process an asset using Simplygon Cloud. Note that this should be seen as a basic example use case - a normal use case should entail implementing a proper, reusable pipeline.
Before you get started ...
There are a few things you have to get ready before you can get started with processing.
Simplygon Cloud on Azure Marketplace
The Simplygon Cloud service is available on the Azure Marketplace. To get started, you have to go the Azure Portal and acquire a Simplygon Cloud instance.
Of course, to utilize Simplygon Cloud you need a 3D asset. In this version of Simplygon Cloud (1.0), the following asset formats are supported:
- SSF (Simplygon Scene Format)
If you asset uses non-embedded textures or consists of multiple files (like for example GLTF), you will need to provide all files to Simplygon Cloud to be able to correctly process a file.
Azure Blob Storage
Simplygon Cloud relied on Azure Blob Storage to both read input assets and output processed assets. Therefore, you will also need an Azure Blob Storage setup and ready, and make sure to provide your Blob Storage Connection String to Simplygon. Get started with Azure Blob Storage here: Azure Blob Storage.
SPL file (Simplygon processing settings file)
The way you explain to Simplygon how an asset should be processed is done using a file format called SPL. SPL is short for Simplygon Processing Language. It is a JSON-based file format which contains all settings needed to do a single processing.
Simplygon Cloud uses the latest version of SPL, called SPL 9.0. This format allows you to have access to the latest and greatest of the Simplygon toolkit, but unfortunately being very new, these files can not be generated from the Simplygon UI application (available in the Offline/Connect SDK).
To generate SPL 9.0 files, use the Cloud C# SDK. It contains a C# library with everything you need to create SPL 9.0 files, along with a few examples to get you started.
Processing a single asset
Processing can be done either using the REST API or the Cloud C# SDK. This Step-by-Step guide will not assume which you you use; instead it will use agnostic terms as much as possible.
- Upload your SPL file to Blob Storage
- Upload your Asset file(s) to Blob Storage
- Tell Simplygon Cloud where your SPL and Asset files are (i.e. add a new Asset and SPL entry in the Simplygon Cloud database).
- Create a Job in Simplygon Cloud
- Start the Job.
- Poll for progress / Wait until the Job is complete.
- Download the results from Blob Storage.