Next (Exporting) Previous (Streaming Events)

Importing

This request will POST binary file data using the Content-Type multipart/form-data according to RFC1867.

Definition

Synchronous and Asynchronous

POST https://clara.io/api/scenes/{uuid}/import?async={0|1}

URL Parameters

  • uuid: the scene ID.
  • async: 0 or 1. whether to use the robust, but complex, asynchronous mode.

If you send an Accept: text/event-stream header, the output is an event stream of the job and its progress.

Supported formats:

3D Models and Scenes:

Images:

  • Radiance HDR (.hdr)
  • OpenEXR (.exr)
  • JPEG (.jpg)
  • Portable Network Graphics (.png)
  • TIFF (.tif/.tiff)
  • Targa (.tga)
  • GIF (.gif)
  • Microsoft BMP (.bmp)

Available Import Options:

  • inGroup: {true | false}
  • importInto”: string
  • fbxAnimations”: {true | false}
  • fbxThinningTolerance: number
  • fbxThinningType: {“None” | “Density” | “Simplification”}
  • fbxThinningFPS: number
  • fbxUnit”: {“Null” | “Meter” | “Centimeter”}
  • objSplitStyle”: number
  • objNormalTypes”: number
  • objSmoothAngle”: number
  • stlRemoveDuplicates”: {true | false}
  • stlDuplicatePrecision”: number
  • vrMatAsPhysical”: {true | false}
  • cadReductLvl”: number
  • cadClientView”: number
  • cadClientLvl”: number
  • cadServerView”: number
  • cadServerLvl”: number
  • cadChord”: number
  • cadAngle”: number
  • emAngle”: number
  • emAutoSize”: number
  • vrsMtlToStandard”: {true | false}
  • vrsViewOption”: number
  • cameraFrameAll: {true | false}
  • countPoly: {true | false}

Synchronous Example Request

This example demonstrates how to do a synchronous (blocking) import.

In BASH

curl "https://clara.io/api/scenes/de8891ef-6ee5-4a2c-8884-507e3648ea93/import" \
    -u username:c3be3060-fe81-467b-aa62-0ee42eea9c8b \
    -X POST \
    -F "file0=@butcherboy/butcherboy.obj" \
    -F "file1=@butcherboy/butcherboy.mtl" \
    -F "file2=@butcherboy/ButcherBoyDiffMap.jpg" \
    -F async=0

ASynchronous Example Request

See the Asynchronous Operations documentation for asynchronous examples in several languages.

Clara Node SDK

When using the Clara Node SDK:

$ clara scenes:import [options]

Next (Exporting) Previous (Streaming Events)