Once you’ve finished crafting your 3D scene, you’ll probably want to do something with it. For that you will need to use the Export feature.
Export is a paid upgrade that can be unlocked via in-app purchase in the ShapeScript iOS App. Export is not available in the free ShapesScript Viewer.
To export your scene, select the export menu in the top-right of the window to unlock the export functionality. Once unlocked, this menu will display the export options.
Note: If the
Export Image/Model menu is grayed-out, it is most likely because your scene is still loading. Wait for the loading spinner in the top-left of the ShapeScript window to finish before trying to export.
ShapeScript can export your scene in a variety of model file formats, selectable from the export menu:
|Extension||File Type||Supports All Features|
|scn / scnz||SceneKit Scene Document||Yes|
|usd / usdz||Universal Scene Description||No|
|ply||Polygon File Format||No|
Note: Not all formats support all features of ShapeScript scenes, so you may need to experiment. In general, DAE is the most reliable, widely-supported format to use.
Some model formats do not support embedding geometry and textures or materials in a single file; In this case, ShapeScript will export a folder containing the model and associated assets as separate files.
Exported models can be used in a variety of ways:
Models exported from ShapeScript are well-suited to use in realtime 3D because the
detail command gives you fine control over the triangle count. For realtime use you should generally set the detail level as low as you can get away with.
You can import DAE files into a game development tool like Unity, or use USD(Z) files with Apple’s SceneKit and RealityKit frameworks in Xcode.
ShapeScript can export models in Stereolithography (STL) format, used by many 3D printing applications.
When exporting for 3D printing, you will usually want to avoid having internal geometry inside the outer surface of your model. A good way to do this is to use the union command to combine all the parts of your model into a single shape, eliminating internal faces.
ShapeScript scenes use the “Y-up” convention, where the Y-axis points up and the Z-axis points out from the screen. Some popular 3D printing applications such as Cura use the “Z-up” convention instead. Check the “Convert to Z-Up” option in the export menu to export your model in this orientation.
In addition to 3D model formats, ShapeScript can also export 2D images. By default, images will be captured using the current camera, but you can select a different camera view from the export window.
The following image formats are supported:
|Extension||File Type||Supports Transparency|
|png||Portable Network Graphics||Yes|
|jpg / jpeg||Joint Photographic Experts Group||No|
If you aren’t sure which format to use, the PNG format is a good all-rounder, with lossless compression and transparency support.
The size of the exported image defaults to the current window size at the current display resolution. You can override this size in your script file by adding
height options to your custom camera, or by tapping on the size label in the export menu and selecting a different size:
Images are exported with a transparent background by default if the selected format supports it, or white otherwise. To change the background color or set a background image, you can use the background command.
When exporting an image (or exporting a model for non-realtime use), you may wish to use the
detail command to increase the detail level. A detail level of 100 should be good enough for even a very large or high-resolution image, but this may take a long time to generate for a complex model.
Note: Although ShapeScript can export images, for best results you should export as a 3D model and then import that into a ray tracing program that provides fine-grained control over scene lighting and camera placement.