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:
- Autodesk FBX (.fbx) Recommended for best results!
- Wavefront Object (.obj/.mlt) Recommended for best results!
- Collada (.dae) Recommended for best results!
- STereoLithography (.stl)
- ThreeJS (.json)
- Blender (.blend)
- 3D Studio (.3ds)
- STEP CAD (.stp/.step)
- IGES CAD (.igs/.iges)
- Stanford Poly (.ply)

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)