OpenDroneMap-WebODM/coreplugins/cesiumion

Cesium Ion WebODM Plugin

1. Introduction

Overview

The Cesium Ion WebODM plugin enables seamless integratIon to upload processed WebODM tasks to your Cesium Ion account. Using the Cesium Ion ecosystem, multi-gigabit models can be streamed to any device using Cesium clients to load 3D tiles.

Learn more at https://Cesium.com

Prerequisites

• WebODM versIon 2.5.0 or later
• Cesium Ion token with assets:list, assets:read, assets:write permissions
• Internet connection

2. Initial Setup

Enabling Plugin

1. Go to "AdministratIon -> Plugins" and enable Cesium ion.
2. Select the left Cesium Ion tab
3. Copy and paste your Cesium Ion token then Set Token.

3. Usage

Basic Usage

Example:

1. Create a new project in the WebODM dashboard.
2. Upload your images.
3. Edit the WebODM task options and make sure to enable texturing-single-material.
4. Start the WebODM processing (this will take a while to complete).
5. Once finished, select the Tile in CesiumIon dropdown button for a list of available asset uploads.
6. Click on a dropdown item to show the popup dialogue where you can rename the asset, add a description/attribute, or enable an Cesium Ion option before uploading.
7. Submit to start the upload to your Cesium Ion assets account.
8. You can view the progress of the upload by clicking the View Ion Tasks button.
9. Once complete you can then click on the View in Cesium dropdown button to open a new browser tab to view your Cesium Ion assets

NOTE: There are 2 phases to a Cesium task: uploading and processing. Uploading is the transfer of processed WebODM data to Cesium Ion. Processing is the tiling/rendering Cesium Ion does to generate streamable models.

4. New Feature: CesiumIon Plugin v1.3.0

KVX 2.0

Cesium Ion upgraded their streaming pipeline to automatically use their 1.1 tileset version. The new standardize tileset version comes with KTX2, a texture format compression option to create a smaller tilset for better streaming performance.

5. Troubleshooting

Common Issues

• Issue: texture model uploads to cesium ion but fails to process/render it.
• Solution: Ensure that you have enabled texturing-single-material before WebODM processing on a new project task as WebODM stores previously processed textured models in the same odm_textured data folder. (Cesium Ion only accepts single textured materials for a 3D_CAPTURE)

6. FAQ

Frequently Asked Questions

• Q: Can I use the plugin with older versions of WebODM?
• A: No, the updated plugin is compatible only with WebODM versIon 2.5.0 or later.