@itwin/reality-capture-conversion
v1.0.1
Published
Reality conversion sdk to run conversion jobs
Downloads
5
Keywords
Readme
@itwin/reality-capture-conversion
Copyright © Bentley Systems, Incorporated. All rights reserved. See LICENSE.md for license terms and full copyright notice.
Description
The @itwin/reality-capture-conversion package contains a sdk to send requests to the Reality Conversion API, part of the iTwin platform.
iTwin.js is an open source platform for creating, querying, modifying, and displaying Infrastructure Digital Twins. To learn more about the iTwin Platform and its APIs, visit the iTwin developer portal.
Documentation
For more information about Reality Conversion package, see Reality Conversion APi documentation
Requirements
A registered application in the iTwin Platform is needed for using the Reality Conversion Service. Documentation for registering an application can be found here. Make sure that your application has realityconversion:read realityconversion:modify
scopes enabled.
To use the Reality Conversion API you will need to have an access to a project. If you don't have one already, contact one of your Organization Administrators or take some time to go through the following tutorial: Create a Project.
To build and run the Reality Conversion service, you will need Node.js v18 (must be greater than 18.12.x).
Key Types and Methods
RealityConversionService
Serves a client wrapper to the Reality Analysis API. It contains all the necessary methods to fulfill any workflow related to create, submit and monitor Reality Analysis jobs.
getScopes
: returns the required scopescreateJob
: create a job from the given settingssubmitJob
: submit the given jobcancelJob
: cancel the given jobdeleteJob
: delete the given jobgetJobProgress
: get the progress of the given jobgetJobProperties
: get the properties of the given job, such as the settings, the creation date etc...getJobEstimatedCost
: get the estimation cost
RCJobType
Enumerates the current conversion types.
RCJobSettings
Describes a job : its inputs, outputs, and other parameters.
RCJobCostParameters
Parameters for estimating job cost before its processing.
RCJobProperties
Contains all the provided job properties, such as name, id, settings...
Usage example
An example is available to show how to create jobs and get its results. See Reality Conversion O2D example