LCCRender::load

Lädt LCC-Daten und gibt ein LCCObject zurück.

Das Web SDK unterstützt Three.js und CesiumJS Engines. Übergeben Sie die entsprechenden Engine-Parameter, um ein LCC-Modell zu laden.

Versionsanforderung

SDK v0.2.0+

Engine-Unterstützung

Three.js / CesiumJS

API

LCCRender::load(param: LoadOptions, successFunc: SuccessFunc, progressFunc: ProgressFunc, failureFunc: FailureFunc, preProcessFunc?: PreProcessFunc): LCCObject

Parameter

param (Three.js)

param (CesiumJS)

Callback-Funktionen

dataPath-Format

dataPath unterstützt zwei Formate:

Option 1: Zeichenkettenpfad (empfohlen)

Übergeben Sie direkt eine Zeichenkette mit dem LCC-Datenpfad:

• Vollständiger .lcc-Dateipfad, z. B. http://example.com/data/xxxx.lcc. SDK v0.4.1+ (empfohlen)
• Vollständiger .lcc2-Dateipfad, z. B. http://example.com/data/xxxx.lcc2. SDK v0.6.0+ (empfohlen)
• meta.lcc-Dateipfad mit Token und anderen Parametern für verschlüsselte Datenszenarien, z. B. https://example.com/data/meta.lcc?token=xxx&other=xxx
• Verzeichnispfad erfordert eine meta.lcc-Datei im Verzeichnis, z. B. https://example.com/data (veraltet)

const lccObject = LCCRender.load({
    // ...other params
    dataPath: 'http://example.com/data/xxxx.lcc',
}, successFunc, progressFunc, failureFunc);

Option 2: Pfad-Deskriptor-Sammlung (SDK v0.5.0+)

Verwenden Sie ein Objekt, um alle Dateipfade mit Verschlüsselungsunterstützung anzupassen, anwendbar auf das LCC-Format.

Dateipfad-Deskriptor-Format:

{
    "fileName": {
        "url": "xxxxxxxxxxxx",
        "header": { "field1": "xxx", "field2": "yyy" }  // Optional, added to HTTP request headers
    }
}

Beispiel:

const dataPath = {
    meta: { url: 'http://example.com/xxx/meta.lcc' },
    index: { url: 'http://example.com/xxx/index.bin' },
    data: { url: 'http://example.com/xxx/data.bin' },
    environment: { url: 'http://example.com/xxx/environment.bin' },
    collision: { url: 'http://example.com/xxx/collision.lci' },
    shcoef: { url: 'http://example.com/xxx/shcoef.bin' },
};

const lccObject = LCCRender.load({
    // ...other params
    dataPath: dataPath,
}, successFunc, progressFunc, failureFunc);

Rückgabewert

LCCObject — LCC-Modellobjekt mit Schnittstellen für Raycasting, Clipping, Rendersteuerung und mehr.

Hinweise

• Die Three.js Engine erfordert den Aufruf von LCCRender.update() in der Render-Schleife.
• Der Parameter param.useSH ist veraltet; verwenden Sie stattdessen die Methode LCCObject.useShcoef().
• Der Parameter param.gpuAcceleration ist veraltet.
• dataPath unterstützt das .lcc-Format (SDK v0.4.1+) und das .lcc2-Format (SDK v0.6.0+).

Verwandte APIs

• LCCRender::unload()
• LCCRender::update()
• LCCRender::dispose()