XGRIDSDokumentation

Häufige Fragen

1. Wasserzeichen und AppKey

Ursache: Ab SDK v0.5.0 wird standardmäßig ein Wasserzeichen unten links angezeigt.

Lösung: Kontaktiere das Vertriebsteam, um einen AppKey zu erhalten, und setze den appKey-Parameter in LCCRender.load(), um das Wasserzeichen zu entfernen.

2. SDK-Integration in Babel-Projekte verursacht Fehler

Ursache: Das SDK verwendet moderne Browser-Syntax. Babel kann diese in ältere Syntax kompilieren, was zu Laufzeitfehlern oder Kompilierungsfehlern führen kann.

Lösung:

  1. Konfiguriere Babel so, dass SDK-Dateien nicht kompiliert werden.
  2. Oder binde die SDK-Datei über ein <script>-Tag ein, um die Kompilierung zu umgehen:
<script src="./sdk.js"></script>

Nach dem Einbinden verwende LCC.LCCRender zum Laden.

3. LCC-Modell in der Three.js-Engine nicht sichtbar

Gehe die folgenden Schritte zur Fehlersuche durch:

  1. Prüfe die Browser-Konsole auf Fehlermeldungen (z.B. Datei nicht gefunden).
  2. Überprüfe, ob die Dateien in dataPath erreichbar und herunterladbar sind.
  3. Prüfe, ob der far-Wert der Kamera groß genug ist — das Modell könnte außerhalb des Kamera-Frustums liegen.
  4. Stelle sicher, dass LCCRender.update() in der Render-Schleife aufgerufen wird.

Falls keiner der obigen Schritte das Problem löst, wende dich an den technischen Support oder stelle eine Frage im Forum.

4. 3D-Tile-Modell wird in CesiumJS vom LCC-Modell verdeckt

Ursache: Standardmäßig schreibt das LCC-Modell in den Tiefenpuffer und die Tiefentestfunktion ist auf immer bestehen (ALWAYS) gesetzt. In der Pass.CESIUM_3D_TILE-Rendering-Warteschlange werden 3D Tiles, die vor dem LCC-Modell geladen wurden, vom Tiefenwert des LCC-Modells überschrieben.

Lösung:

  • Lade das 3D-Tile-Modell innerhalb des Erfolgs-Callbacks von LCCRender.load().
  • Oder rufe nach dem Laden beider Modelle lccObject.lowerToBottom() auf, um die Rendering-Reihenfolge des LCC-Modells an den Anfang zu verschieben.

5. Unterstützung älterer CesiumJS-Versionen

Ursache: Ab Cesium v1.102 wird standardmäßig WebGL2 unterstützt, während frühere Versionen standardmäßig WebGL1 verwenden. Das Web SDK unterstützt kein WebGL1, daher muss WebGL2 erzwungen werden.

Lösung: WebGL2 muss erzwungen werden. Die minimal unterstützte Version ist Cesium v1.67.

const viewer = new Cesium.Viewer("cesiumContainer", {
    orderIndependentTranslucency: false, // Ordnungsunabhängige Transparenz deaktivieren
    useDefaultRenderLoop: true,
    resolutionScale: window.devicePixelRatio,
    contextOptions: {
        webgl2: true, // WebGL 2.0 erzwingen
        requestWebgl2: true
    }
});

6. Viewer ist trotz guter Hardware langsam

Ursache: Bei Computern mit mehreren GPUs (z.B. Intel-integrierte GPU + NVIDIA-dedizierte GPU) kann Windows standardmäßig die integrierte GPU bevorzugen, was zu Rendering-Verzögerungen führt.

Lösung:

  1. Stelle den Energiemodus des Computers auf „Höchstleistung".
  2. Stelle in der NVIDIA-Systemsteuerung den Browser auf die dedizierte GPU ein.
  3. Unter Windows-Einstellungen → Anzeige → Grafik weise dem Browser die „Hohe Leistung"-GPU zu.

Nach Abschluss der Einstellungen muss der Browser neu gestartet werden, damit die neuen Einstellungen wirksam werden.

7. Rendering trotz ausreichender Hardware langsam

3DGS-Rendering hat hohe Ressourcenanforderungen. Schließe ressourcenintensive Anwendungen wie 3D-Editoren, LCC-Rekonstruktionsaufgaben, HD-Videowiedergabe, Highspeed-Downloads und Video-Streaming, um die notwendigen Rechenressourcen freizugeben.

8. Gleicher Laptop zeigt unterschiedliche Leistung

Wenn bei der Navigation in Szenen auf demselben Laptop zu verschiedenen Zeiten die Leistung schwankt (manchmal flüssig, manchmal ruckelnd), liegt die Ursache meist daran, ob eine externe Stromversorgung angeschlossen ist. Im Akkubetrieb nutzt der Laptop Energiesparmodi, die die CPU- und GPU-Leistung reduzieren, was zu Ruckeln führen kann. Beim Betrachten von 3DGS-Szenen wird die Verwendung einer externen Stromversorgung empfohlen.