Struct XRCameraFrame

Parameters of the Unity Camera that may be necessary/useful to the provider.

Namespace: UnityEngine.XR.ARSubsystems

Syntax

public struct XRCameraFrame : IEquatable<XRCameraFrame>

Properties

ambientSphericalHarmonics

The ambient spherical harmonic coefficients that represent lighting in the real-world.

Declaration

public readonly SphericalHarmonicsL2 ambientSphericalHarmonics { get; }

Property Value

Type	Description
SphericalHarmonicsL2	The ambient spherical harmonic coefficients that represent lighting in the real-world.

Remarks

See here for further details.

averageBrightness

The estimated brightness of the scene.

Declaration

public readonly float averageBrightness { get; }

Property Value

Type	Description
Single	The estimated brightness of the scene.

averageColorTemperature

The estimated color temperature of the scene.

Declaration

public readonly float averageColorTemperature { get; }

Property Value

Type	Description
Single	The estimated color temperature of the scene.

averageIntensityInLumens

The estimated intensity, in lumens, of the scene.

Declaration

public readonly float averageIntensityInLumens { get; }

Property Value

Type	Description
Single	The estimated intensity, in lumens, of the scene.

cameraGrain

A texture that simulates the camera's noise.

Declaration

public readonly XRTextureDescriptor cameraGrain { get; }

Property Value

Type	Description
XRTextureDescriptor	A texture that simulates the camera's noise.

colorCorrection

The estimated color correction value of the scene.

Declaration

public readonly Color colorCorrection { get; }

Property Value

Type	Description
Color	The estimated color correction value of the scene.

displayMatrix

The 4x4 display matrix for the camera frame.

Declaration

public readonly Matrix4x4 displayMatrix { get; }

Property Value

Type	Description
Matrix4x4	The 4x4 display matrix for the camera frame.

exposureDuration

The camera exposure duration, in seconds with sub-millisecond precision, of the scene.

Declaration

public readonly double exposureDuration { get; }

Property Value

Type	Description
Double	The camera exposure duration, in seconds with sub-millisecond precision, of the scene.

exposureOffset

The camera exposure offset of the scene for lighting scaling

Declaration

public readonly float exposureOffset { get; }

Property Value

Type	Description
Single	The camera exposure offset of the scene for lighting scaling

hasAmbientSphericalHarmonics

Whether the frame has the ambient spherical harmonics coefficients of the scene.

Declaration

public readonly bool hasAmbientSphericalHarmonics { get; }

Property Value

Type	Description
Boolean	Whether the frame has the ambient spherical harmonics coefficients of the scene.

hasAverageBrightness

Whether the frame has an average brightness.

Declaration

public readonly bool hasAverageBrightness { get; }

Property Value

Type	Description
Boolean	Whether the frame has an average brightness.

hasAverageColorTemperature

Whether the frame has an average color temperature.

Declaration

public readonly bool hasAverageColorTemperature { get; }

Property Value

Type	Description
Boolean	Whether the frame has an average color temperature.

hasAverageIntensityInLumens

Whether the frame has an average intensity in lumens.

Declaration

public readonly bool hasAverageIntensityInLumens { get; }

Property Value

Type	Description
Boolean	Whether the frame has an average intensity in lumens.

hasCameraGrain

Whether the frame has a camera grain texture.

Declaration

public readonly bool hasCameraGrain { get; }

Property Value

Type	Description
Boolean	Whether the frame has a camera grain texture.

hasColorCorrection

Whether the frame has a color correction value.

Declaration

public readonly bool hasColorCorrection { get; }

Property Value

Type	Description
Boolean	Whether the frame has a color correction value.

hasDisplayMatrix

Whether the frame has a display matrix.

Declaration

public readonly bool hasDisplayMatrix { get; }

Property Value

Type	Description
Boolean	Whether the frame has a display matrix.

hasExposureDuration

Whether the frame has an exposure duration in seconds with sub-millisecond precision.

Declaration

public readonly bool hasExposureDuration { get; }

Property Value

Type	Description
Boolean	Whether the frame has an exposure duration in seconds with sub-millisecond precision.

hasExposureOffset

Whether the frame has an exposure offset for scaling lighting.

Declaration

public readonly bool hasExposureOffset { get; }

Property Value

Type	Description
Boolean	Whether the frame has an exposure offset for scaling lighting.

hasMainLightColor

Whether the frame has the estimated main light color of the scene.

Declaration

public readonly bool hasMainLightColor { get; }

Property Value

Type	Description
Boolean	Whether the frame has the estimated main light color of the scene.

hasMainLightDirection

Whether the frame has the estimated main light direction of the scene.

Declaration

public readonly bool hasMainLightDirection { get; }

Property Value

Type	Description
Boolean	Whether the frame has the estimated main light direction of the scene.

hasMainLightIntensityLumens

Whether the frame has the estimated main light channel-wise intensity of the scene.

Declaration

public readonly bool hasMainLightIntensityLumens { get; }

Property Value

Type	Description
Boolean	Whether the frame has the estimated main light channel-wise intensity of the scene.

hasNoiseIntensity

Whether the frame has a camera grain noise.

Declaration

public readonly bool hasNoiseIntensity { get; }

Property Value

Type	Description
Boolean	Whether the frame has a camera grain noise.

hasProjectionMatrix

Whether the frame has a projection matrix.

Declaration

public readonly bool hasProjectionMatrix { get; }

Property Value

Type	Description
Boolean	Whether the frame has a projection matrix.

hasTimestamp

Whether the frame has a timestamp.

Declaration

public readonly bool hasTimestamp { get; }

Property Value

Type	Description
Boolean	Whether the frame has a timestamp.

mainLightColor

The estimated, color of the most influential, real-world light in the scene.

Declaration

public readonly Color mainLightColor { get; }

Property Value

Type	Description
Color	The estimated, color of the most influential, real-world light in the scene.

mainLightDirection

The estimated direction of the most influential, real-world light in the scene.

Declaration

public readonly Vector3 mainLightDirection { get; }

Property Value

Type	Description
Vector3	The estimated direction of the most influential, real-world light in the scene.

mainLightIntensityLumens

The estimated, intensity in lumens of the most influential, real-world light in the scene.

Declaration

public readonly float mainLightIntensityLumens { get; }

Property Value

Type	Description
Single	The estimated, intensity in lumens of the most influential, real-world light in the scene.

nativePtr

A native pointer associated with this frame. The data pointed to by this pointer is specific to provider implementation.

Declaration

public readonly IntPtr nativePtr { get; }

Property Value

Type	Description
IntPtr	The native pointer associated with this frame.

noiseIntensity

The level of intensity of camera grain noise in a scene.

Declaration

public readonly float noiseIntensity { get; }

Property Value

Type	Description
Single	The level of intensity of camera grain noise in a scene.

projectionMatrix

The 4x4 projection matrix for the camera frame.

Declaration

public readonly Matrix4x4 projectionMatrix { get; }

Property Value

Type	Description
Matrix4x4	The 4x4 projection matrix for the camera frame.

properties

The set of all flags indicating which properties are included in the frame.

Declaration

public readonly XRCameraFrameProperties properties { get; }

Property Value

Type	Description
XRCameraFrameProperties	The set of all flags indicating which properties are included in the frame.

timestampNs

The timestamp, in nanoseconds, associated with this frame.

Declaration

public readonly long timestampNs { get; }

Property Value

Type	Description
Int64	The timestamp, in nanoseconds, associated with this frame.

trackingState

The TrackingState associated with the camera.

Declaration

public readonly TrackingState trackingState { get; }

Property Value

Type	Description
TrackingState	The tracking state associated with the camera.

Methods

Equals(Object)

Compares for equality.

Declaration

public override bool Equals(object obj)

Parameters

Type	Name	Description
Object	obj	An object to compare against.

Returns

Type	Description
Boolean	true if obj is an XRCameraFrame and Equals(XRCameraFrame) is also true. Otherwise, false.

Overrides

ValueType.Equals(Object)

Equals(XRCameraFrame)

Compares for equality.

Declaration

public bool Equals(XRCameraFrame other)

Parameters

Type	Name	Description
XRCameraFrame	other	The other XRCameraFrame to compare against.

Returns

Type	Description
Boolean	true if the XRCameraFrame represents the same object.

GetHashCode()

Generates a hash code suitable for use in HashSet and Dictionary.

Declaration

public override int GetHashCode()

Returns

Type	Description
Int32	A hash of the XRCameraFrame.

Overrides

ValueType.GetHashCode()

ToString()

Generates a string representation of this XRCameraFrame suitable for debugging purposes.

Declaration

public override string ToString()

Returns

Type	Description
String	A string representation of this XRCameraFrame.

Overrides

ValueType.ToString()

TryGetAverageBrightness(out Single)

Provides brightness for the whole image as an average of all pixels' brightness.

Declaration

public bool TryGetAverageBrightness(out float averageBrightness)

Parameters

Type	Name	Description
Single	averageBrightness	An estimated average brightness for the environment.

Returns

Type	Description
Boolean	true if average brightness was provided. Otherwise, false.

TryGetAverageColorTemperature(out Single)

Provides color temperature for the whole image as an average of all pixels' color temperature.

Declaration

public bool TryGetAverageColorTemperature(out float averageColorTemperature)

Parameters

Type	Name	Description
Single	averageColorTemperature	An estimated color temperature.

Returns

Type	Description
Boolean	true if average color temperature was provided. Otherwise, false.

TryGetAverageIntensityInLumens(out Single)

Provides intensity, in lumens, for the environment.

Declaration

public bool TryGetAverageIntensityInLumens(out float averageIntensityInLumens)

Parameters

Type	Name	Description
Single	averageIntensityInLumens	An estimated average intensity, in lumens, for the environment.

Returns

Type	Description
Boolean	true if average intensity was provided. Otherwise, false.

TryGetDisplayMatrix(out Matrix4x4)

Provides display matrix defining how texture is being rendered on the screen.

Declaration

public bool TryGetDisplayMatrix(out Matrix4x4 displayMatrix)

Parameters

Type	Name	Description
Matrix4x4	displayMatrix	The display matrix for rendering.

Returns

Type	Description
Boolean	true if the display matrix was provided. Otherwise, false.

TryGetProjectionMatrix(out Matrix4x4)

Provides projection matrix for the camera frame.

Declaration

public bool TryGetProjectionMatrix(out Matrix4x4 projectionMatrix)

Parameters

Type	Name	Description
Matrix4x4	projectionMatrix	The projection matrix used by the XRCameraSubsystem.

Returns

Type	Description
Boolean	true if the projection matrix was provided. Otherwise, false.

TryGetTimestamp(out Int64)

Provides timestamp of the camera frame.

Declaration

public bool TryGetTimestamp(out long timestampNs)

Parameters

Type	Name	Description
Int64	timestampNs	The timestamp of the camera frame.

Returns

Type	Description
Boolean	true if the timestamp was provided. Otherwise, false.

Operators

Equality(XRCameraFrame, XRCameraFrame)

Compares lhs and rhs for equality using Equals(XRCameraFrame).

Declaration

public static bool operator ==(XRCameraFrame lhs, XRCameraFrame rhs)

Parameters

Type	Name	Description
XRCameraFrame	lhs	The left-hand-side XRCameraFrame of the comparison.
XRCameraFrame	rhs	The right-hand-side XRCameraFrame of the comparison.

Returns

Type	Description
Boolean	true if lhs compares equal to rhs, false otherwise.

Inequality(XRCameraFrame, XRCameraFrame)

Compares lhs and rhs for inequality using Equals(XRCameraFrame).

Declaration

public static bool operator !=(XRCameraFrame lhs, XRCameraFrame rhs)

Parameters

Type	Name	Description
XRCameraFrame	lhs	The left-hand-side XRCameraFrame of the comparison.
XRCameraFrame	rhs	The right-hand-side XRCameraFrame of the comparison.

Returns

Type	Description
Boolean	false if lhs compares equal to rhs, true otherwise.