LCCRender::load

Carica i dati LCC e restituisce un LCCObject.

Il Web SDK supporta i motori Three.js e CesiumJS. Passare i parametri del motore corrispondente per caricare un modello LCC.

Requisito di versione

SDK v0.2.0+

Supporto motore

Three.js / CesiumJS

API

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

Parametri

param (Three.js)

param (CesiumJS)

Funzioni di callback

Formato dataPath

dataPath supporta due formati:

Opzione 1: Percorso stringa (consigliato)

Passare direttamente una stringa che specifica il percorso dei dati LCC:

• Percorso completo del file .lcc, ad es. http://example.com/data/xxxx.lcc. SDK v0.4.1+ (consigliato)
• Percorso completo del file .lcc2, ad es. http://example.com/data/xxxx.lcc2. SDK v0.6.0+ (consigliato)
• Percorso del file meta.lcc con token e altri parametri per scenari di dati crittografati, ad es. https://example.com/data/meta.lcc?token=xxx&other=xxx
• Percorso directory che richiede un file meta.lcc nella directory, ad es. https://example.com/data (deprecato)

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

Opzione 2: Collezione di descrittori di percorso (SDK v0.5.0+)

Utilizzare un oggetto per personalizzare tutti i percorsi dei file con supporto alla crittografia, applicabile al formato LCC.

Formato del descrittore di percorso file:

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

Esempio:

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);

Valore di ritorno

LCCObject — Oggetto modello LCC con interfacce per raycasting, ritaglio, controllo del rendering e altro.

Note

• Il motore Three.js richiede la chiamata di LCCRender.update() nel ciclo di rendering.
• Il parametro param.useSH è deprecato; utilizzare il metodo LCCObject.useShcoef().
• Il parametro param.gpuAcceleration è deprecato.
• dataPath supporta il formato .lcc (SDK v0.4.1+) e il formato .lcc2 (SDK v0.6.0+).

API correlate

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