Szene

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.

Eigenschaft	Bezeichnung	Beschreibung
label	Label	Zeichenkette. Eine Bezeichnung, um die Szene einfacher identifizieren zu können.
hdriFileId	HDRI-Datei	Ganzzahl. ID der HDRI-Datei. Diese Datei wird zur Beleuchtung genutzt.
sceneConfiguration	Szenenkonfiguration	Zeichenkette. 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.

Eigenschaft

Bezeichnung

Beschreibung

camera

Kamera

Die 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.

lights

Beleuchtung

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