XRLightEstimate: Eigenschaft sphericalHarmonicsCoefficients

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Die schreibgeschützte Eigenschaft sphericalHarmonicsCoefficients der Schnittstelle XRLightEstimate gibt ein Float32Array zurück, das 9 Kugelharmonische-Koeffizienten enthält.

Sphärische harmonische Beleuchtung ist eine Technik, die Kugelfunktionen anstelle von Standardbeleuchtungsgleichungen verwendet. Weitere Informationen finden Sie auf Wikipedia.

Wert

Ein Float32Array, das 9 sphärische harmonische Koeffizienten enthält. Das Array enthält insgesamt 27 Elemente, wobei jeweils 3 Elemente rote, grüne und blaue Komponenten für jeden Koeffizienten definieren.

Die ersten 3 Elemente müssen eine gültige Beleuchtungsschätzungskomponente sein; die restlichen können aufgrund von Datenschutzeinstellungen oder Einschränkungen des Geräts, um mehr Daten bereitzustellen, 0 sein.

Beispiele

Innerhalb einer XRFrame-Schleife können Sie die sphericalHarmonicsCoefficients-Eigenschaft verwenden, um die Szene zu beleuchten.

js
const lightProbe = await xrSession.requestLightProbe();

// frame loop
function onXRFrame(time, xrFrame) {
  let lightEstimate = xrFrame.getLightEstimate(lightProbe);

  // Render lights using lightEstimate.sphericalHarmonicsCoefficients
}

Spezifikationen

Specification
WebXR Lighting Estimation API Level 1
# dom-xrlightestimate-sphericalharmonicscoefficients

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch