Versionen im Vergleich

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.

Es ist möglich Szenen für 3D-Model-Viewer zu erstellen. Diese Szenen werden genutzt, um diverse Parameter des Viewers anzupassen, wie z.B. die Positionierung der Kamera, wieviele Lichtquellen und wo sie platziert werden etc.
Diese Szenen werden durch die Entität ThreeDimensionalViewerScene realisiert.

Konfiguration

Eine Szene hat folgende Eigenschaften.

EigenschaftBezeichnungBeschreibung
labelLabelZeichenkette. Eine Bezeichnung, um die Szene einfacher identifizieren zu können.
hdriFileIdHDRI-DateiGanzzahl. ID der HDRI-Datei. Diese Datei wird zur Beleuchtung genutzt.
sceneConfigurationSzenenkonfigurationZeichenkette. Die Konfiguration der Szene im JSON-Format. Diese Konfiguration definiert die Szene. Die Möglichen Inhalte werden im Artikel aufgeschlüsselt.

Szenenkonfiguration

Um die verschiedenen Eigenschaften einer Szene zu manipulieren, können entsprechende Eigenschaften durch Objekte in der sceneConfiguration hinterlegt werden.

EigenschaftBezeichnungBeschreibung
cameraKameraDie Kamera steuert die Perspektive im Viewer.  Sie hat folgende Einstellungsmöglichkeiten:
  • fov: Ganzzahl. Vertikales Sichtfeld.
  • near: Ganzzahl.
  • far: Ganzzahl.
  • position: Bestimmt die Position der Kamera.
    • x: Ganzzahl. Positionierung auf der x-Achse.
    • y: Ganzzahl. Positionierung auf der y-Achse.
    • z: Ganzzahl. Positionierung auf der z-Achse.
  • lookAt: Bestimmt den Punkt, auf den die Kamera gerichtet ist.
    • x: Ganzzahl. Positionierung auf der x-Achse.
    • y: Ganzzahl. Positionierung auf der y-Achse.
    • z: Ganzzahl. Positionierung auf der z-Achse.
lightsBeleuchtung

Die Beleuchtung ist ein Array aus mehreren Lichtquellen. Eine Lichtquelle hat folgende Einstellungsmöglichkeiten:

  • x: Ganzzahl. Positionierung auf der x-Achse.
  • y: Ganzzahl. Positionierung auf der y-Achse.
  • z. Ganzzahl. Positionierung auf der z-Achse.
  • intensity: Ganzzahl. Gibt an wie stark das Licht scheinen soll.
  • color: Zeichenkette. Farbe des Lichts. Wird angegeben als Hex code mit 0x-Präfix (bspw. 0xffffff für die Farbe Weiß)
backgroundHintergrund

Der Hintergrund ist ein Objekt, welches folgende Einstellungsmöglichkeiten zulässt:

  • color: Zeichenkette. Hex-Wert der Hintergrundfarbe.
  • intensity: Gleitkommazahl. Ein Wert, der die Intensität der Farbe bestimmt.