One importable data set — a coherent combination of one or more files the user can load together (e.g. glTF alone, or `glTF

  • DataModel JSON` to pair geometry with semantics).

Adding a new data set is a matter of authoring a descriptor and registering it in IMPORT_DATA_SETS.

interface ImportDataSet {
    defaultBasisId?: string;
    description?: string;
    files: ImportDataSetFile[];
    id: string;
    label: string;
    loadsDataSemantics?: boolean;
    loadsSceneGeometry?: boolean;
    onLoad?: (studio: Studio) => void;
}

Properties

defaultBasisId?: string

Best-guess basis id (matching an entry in IMPORT_BASES) for files of this type. Used by the dialog as the default Basis when the user picks this data set. Falls back to "unknown" when omitted.

description?: string

Optional one-line description shown beneath the file rows. Used by file-less entries (e.g. the Sample Models picker) to explain what Load will do.

Files this data set consumes, loaded in declaration order.

id: string

Stable id, used as the dropdown's <option> value.

label: string

User-facing label shown in the dropdown.

loadsDataSemantics?: boolean

Whether this data set carries DataModel semantics. When false the dialog skips pre-creating an empty DataModel (which would otherwise pollute the Data graph and panels like the Explorer with empty entries). Defaults to true when omitted.

loadsSceneGeometry?: boolean

Whether this data set carries SceneModel geometry. The dialog disables the Source-coordinate-system section when false (basis / units / origin are meaningless for DataModel-only imports). Defaults to true when omitted.

onLoad?: (studio: Studio) => void

Optional override for the default file-based Load. When present, the dialog hides the file rows and routes the Load click here. Used to delegate to a separate picker — e.g. the Sample Models panel.